1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
4 Translation of GIT committish: 9352789b729682d683482c2852cc7b53e9dcdc70
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. For details, see the Contributors'
8 Guide, node Updating translation committishes..
13 @node Entrada y salida generales
14 @chapter Entrada y salida generales
15 @translationof General input and output
17 Esta sección trata de asuntos relacionados con la entrada y salida
18 generales de LilyPond, más que con la notación específica.
21 * Estructura del código de entrada::
22 * Títulos y encabezamientos::
23 * Trabajar sobre los archivos de entrada::
24 * Controlar la salida::
26 * Extraer información musical::
30 @node Estructura del código de entrada
31 @section Estructura del código de entrada
32 @translationof Input structure
34 El formato principal de entrada para LilyPond son archivos de texto.
35 Por convenio, el nombre de estos archivos termina en @file{.ly}.
38 * Estructura de una partitura::
39 * Varias partituras en un libro::
40 * Varios archivos de salida a partir de uno de entrada::
41 * Nombres de los archivos de salida::
42 * Estructura del archivo::
46 @node Estructura de una partitura
47 @subsection Estructura de una partitura
48 @translationof Structure of a score
52 Un bloque @code{\score} debe contener una expresión musical única
53 delimitada por un par de llaves:
62 @warning{Sólo puede haber @strong{una} expresión musical dentro del
63 bloque @code{\score}, y @strong{debe} estar encerrada entre llaves.}
65 Esta expresión musical única puede tener cualquier tamaño, y puede
66 contener otras expresiones musicales hasta cualquier grado de
67 complejidad. Todos los siguientes ejemplos son expresiones musicales:
73 @lilypond[verbatim,quote]
80 @lilypond[verbatim,quote]
82 \new Staff { c'4 c' c' c' }
83 \new Staff { d'4 d' d' d' }
91 \new Staff @{ \flute @}
92 \new Staff @{ \oboe @}
95 \new Staff @{ \violinI @}
96 \new Staff @{ \violinII @}
102 Los comentarios son una excepción a esta regla general (para ver otras
103 excepciones, consulte @ref{Estructura del archivo}). Tanto los comentarios de
104 una línea como los que están delimitados por @code{%@{ @dots{} %@}} se
105 pueden escribir en cualquier lugar dentro del archivo de entrada. Se
106 pueden escribir dentro o fuera del bloque @code{\score}, y dentro o
107 fuera de la expresión musical única dentro del bloque @code{\score}.
109 Recuerde que incluso dentro de un archivo que contenga solamente un
110 bloque @code{\score}, éste se encuentra incluido implícitamente dentro
111 de un bloque @code{\book}. Un bloque @code{\book} dentro de un
112 archivo fuente produce al menos un archivo de salida, y de forma
113 predeterminada el nombre del archivo de salida que se produce está
114 derivado del nombre del archivo de entrada, de forma que
115 @file{fandangoforelephants.ly} da como resultado
116 @file{fandangoforelephants.pdf}.
118 (Para ver más detalles acerca de los bloques @code{\book}, consulte
119 @ref{Varias partituras en un libro}, @ref{Varios archivos de salida a
120 partir de uno de entrada} y @ref{Estructura del archivo}.)
123 Manual de aprendizaje:
124 @rlearning{Trabajar sobre los archivos de entrada},
125 @rlearning{Explicación de las expresiones musicales},
126 @rlearning{La partitura es una (única) expresión musical compuesta}.
129 @node Varias partituras en un libro
130 @subsection Varias partituras en un libro
131 @translationof Multiple scores in a book
134 @cindex movimientos, varios
136 Un documento puede contener varias piezas de música y texto. Son
137 ejemplos un libro de estudios o una parte orquestal con varios
138 movimientos. Cada movimiento se introduce con un bloque
143 @var{@dots{}música@dots{}}
147 y los textos se introducen con un bloque @code{\markup}:
151 @var{@dots{}texto@dots{}}
157 Todos los movimientos y textos que aparecen en el mismo archivo
158 @file{.ly} se tipografían normalmente en la forma de un solo archivo
173 Una excepción importante se da dentro de los documentos de
174 lilypond-book, en los que tenemos que escribir explícitamente un
175 bloque @code{\book}, pues en caso contrario sólo aparecerá en la
176 salida el primer @code{\score} o @code{\markup}.
178 El encabezamiento de cada pieza se puede poner dentro del bloque
179 @code{\score}. Antes de cada movimiento, se imprime el nombre de la
180 pieza (@code{piece}) extraído del encabezamiento. El título del libro
181 entero se puede poner dentro del bloque @code{\book}, pero si no está
182 presente se inserta el encabezamiento @code{\header} que está al
183 principio del archivo.
187 title = "Ocho miniaturas"
188 composer = "Igor Stravinsky"
192 \header @{ piece = "Romanze" @}
195 @dots{}texto de la segunda estrofa@dots{}
198 @dots{}texto de la tercera estrofa@dots{}
202 \header @{ piece = "Menuetto" @}
208 Se pueden agrupar distintas piezas de música en partes de un libro
209 utilizando bloques @code{\bookpart}. Las partes de libro se separan
210 por medio de saltos de página, y pueden dar comienzo con un título,
211 como el libro propiamente dicho, mediante la especificación del bloque
217 title = "Título del libro"
218 subtitle = "Primera parte"
225 subtitle = "Segunda parte"
233 @node Varios archivos de salida a partir de uno de entrada
234 @subsection Varios archivos de salida a partir de uno de entrada
235 @translationof Multiple output files from one input file
237 Si queremos varios archivos de salida a partir del mismo archivo
238 @file{.ly}, podemos escribir varios bloques @code{\book}, donde cada
239 uno de estos bloques @code{\book} dará como resultado un archivo de
240 salida distinto. Si no especificamos ningún bloque @code{\book} en el
241 archivo, LilyPond trata implícitamente todo el archivo como un solo
242 bloque @code{\book}, véase @ref{Estructura del archivo}.
244 Al producir varios archivos a partir de un solo archivo fuente,
245 Lilypond se asegura de que ninguno de los archivos de salida de ningún
246 bloque @code{\book} sobreescribe el archivo de salida producido por un
247 @code{\book} anterior del mismo archivo de entrada.
249 Lo hace añadiendo un sufijo al nombre de la salida para cada libro
250 @code{\book} que utiliza el nombre del archivo de salida
251 predeterminado, derivado del archivo fuente de entrada.
253 El comportamiento predeterminado es añadir un sufijo con el número de
254 versión para cada nombre que pueda coincidir; así:
271 en el archivo fuente @file{eightminiatures.ly}, produce
275 @file{eightminiatures.pdf},
277 @file{eightminiatures-1.pdf} y
279 @file{eightminiatures-2.pdf}.
283 @node Nombres de los archivos de salida
284 @subsection Nombres de los archivos de salida
285 @translationof Output file names
287 @funindex \bookOutputSuffix
288 @funindex \bookOutputName
290 Lilypond le ofrece unos mecanismos que le permiten controlar los
291 nombres de archivo que se utilizan por parte de los diversos motores
292 finales al producir los archivos de salida.
294 En la sección anterior vimos cómo Lilypond evita las coincidencias de
295 nombres al producir varias salidas a partir de un único archivo fuente
296 de entrada. También podemos especificar nuestros propios sufijos para
297 cada bloque @code{\book}, de manera que podemos producir, por ejemplo,
298 archivos con los nombres @file{eightminiatures-Romanze.pdf},
299 @file{eightminiatures-Menuetto.pdf} y
300 @file{eightminiatures-Nocturne.pdf} añadiendo una declaración
301 @code{\bookOutputSuffix} dentro de cada bloque @code{\book}.
305 \bookOutputSuffix "Romanze"
310 \bookOutputSuffix "Menuetto"
315 \bookOutputSuffix "Nocturne"
321 También podemos especificar un nombre de archivo de salida diferente
322 para cada bloque @code{book}, mediante la utilización de declaraciones
323 @code{\bookOutputName}:
327 \bookOutputName "Romanze"
332 \bookOutputName "Menuetto"
337 \bookOutputName "Nocturne"
343 El código anterior produce los siguientes archivos de salida:
349 @file{Menuetto.pdf} y
355 @node Estructura del archivo
356 @subsection Estructura del archivo
357 @translationof File structure
367 Un archivo @file{.ly} puede contener cualquier número de expresiones
368 del nivel superior, donde una expresión del nivel superior es una de
369 las siguientes posibilidades:
373 Una definición de salida, como @code{\paper}, @code{\midi} y
374 @code{\layout}. Tal definición en el nivel más alto cambia los
375 ajustes predeterminados para todo el libro. Si se introduce más de
376 una de estas definiciones del mismo tipo en el nivel más alto, las
377 definiciones se combinan, pero en situaciones de conflicto las
378 definiciones más tardías tienen preferencia. Para ver los detalles
379 sobre cómo afecta al bloque @code{\layout}, consulte
380 @ref{El bloque \layout}.
383 Una expresión directa de Scheme, como
384 @code{#(set-default-paper-size "a7" 'landscape)} o
385 @code{#(ly:set-option 'point-and-click #f)}.
388 Un bloque @code{\header}. Esto establece el bloque de encabezamiento
389 global (es decir, al principio del archivo). Es el bloque que
390 contiene los ajustes predeterminados de los campos de encabezamientos
391 como el compositor, título, etc. para todos los libros que están
392 dentro del archivo (véase @ref{Explicación de los títulos}).
395 Un bloque @code{\score}. Esta partitura se reúne con otras partituras
396 del nivel superior, y se combina con ellas formando un @code{\book}
397 (libro) único. Este comportamiento se puede cambiar estableciendo el
398 valor de la variable @code{toplevel-score-handler} en el nivel
399 superior. El @emph{handler} predeterminado se define en el archivo de
400 inicio @file{../scm/lily.scm}.
403 Un bloque @code{\book} combina lógicamente varios movimientos (es
404 decir, varios bloques @code{\score}) en un solo documento. Si hay
405 varias partituras @code{\score}, se crea un solo archivo de salida
406 para cada bloque @code{\book}, en el que se concatenan todos los
407 movimientos correspondientes. La única razón para especificar
408 explícitamente bloques @code{\book} en un archivo de entrada
409 @file{.ly} es si queremos crear varios archivos de salida a partir de
410 un único archivo de entrada. Una excepción se da dentro de los
411 documentos de lilypond-book, en los que tenemos que escribir
412 explícitamente un bloque @code{\book} si queremos tener más de una
413 única partitura @code{\score} o marcado @code{\markup} en el mismo
414 ejemplo. Se puede cambiar este comportamiento estableciendo el valor
415 de la variable @code{toplevel-book-handler} en el nivel superior. El
416 @emph{handler} predeterminado se define en el archivo de inicio
417 @file{../scm/lily.scm}.
420 Un bloque @code{\bookpart}. Un libro puede dividirse en varias
421 partes, utilizando bloques @code{\bookpart}, con objeto de facilitar
422 la inserción de saltos de página o usar distintos ajustes de
423 @code{\paper} en las distintas partes.
426 Una expresión musical compuesta, como
431 Esto añade la pieza al @code{\score} y la conforma dentro de un libro
432 único junto a todas las demás partituras @code{\score} y expresiones
433 musicales del nivel superior. En otras palabras, un archivo que
434 contiene sólo la expresión musical anterior se traduce a
451 Se puede cambiar este comportamiento estableciendo el valor de la
452 variable @code{toplevel-music-handler} en el nivel más alto. El
453 @emph{handler} predeterminado se define en el archivo de inicio
454 @file{../scm/lily.scm}.
457 Un texto de marcado, por ejemplo una estrofa
460 2. Estrofa dos, línea uno
464 Los textos de marcado se colocan encima, en medio o debajo de las
465 partituras o expresiones musicales, según donde aparezcan escritos.
472 fulano = @{ c4 d e d @}
475 Esto se puede utilizar más tarde en el archivo escribiendo
476 @code{\fulano}. El nombre de las variables ha de ser exclusivamente
477 alfabético; sin números, guiones ni barras bajas.
481 El ejemplo siguiente muestra tres cosas que se pueden introducir en el
486 % No justificar la salida
497 En cualquier punto del archivo se pueden introducir cualquiera de las
498 instrucciones léxicas siguientes:
501 @item @code{\version}
502 @item @code{\include}
503 @item @code{\sourcefilename}
504 @item @code{\sourcefileline}
506 Un comentario de una línea, determinado por un símbolo @code{%} al principio.
509 Un comentario de varias líneas, delimitado por @code{%@{ @dots{} %@}}.
513 @cindex espacios en blanco
515 Por lo general se ignoran los espacios entre elementos del flujo de
516 entrada, y se pueden omitir o aumentar tranquilamente para mejorar la
517 legibilidad. Sin embargo, los espacios se deben utilizar siempre para
518 evitar errores, en las siguientes situaciones:
522 @item Alrededor de todas y cada una de las llaves curvas
523 de apertura y cierre.
525 @item A continuación de las instrucciones y variables, es decir,
526 todos los elementos que comienzan con un signo @code{\} de barra
529 @item A continuación de todo elemento que se deba interpretar
530 como expresión de Scheme, es decir, todo elemento que comience por
531 un signo@tie{}@code{#}.
533 @item Para separar los elementos de una expresión de Scheme.
535 @item Dentro de @code{lyricmode} antes y después de las instrucciones
536 @code{\set} y @code{\override}.
541 Manual de aprendizaje:
542 @rlearning{Cómo funcionan los archivos de entrada de LilyPond}.
544 Referencia de la notación:
545 @ref{Explicación de los títulos},
546 @ref{El bloque \layout}.
548 @node Títulos y encabezamientos
549 @section Títulos y encabezamientos
550 @translationof Titles and headers
552 Casi toda la música impresa tiene un título y el nombre del
553 compositor; ciertas piezas tienen mucha más información.
556 * Crear títulos encabezamientos y pies de página::
557 * Títulos encabezamientos y pies de página personalizados::
558 * Crear notas al pie::
559 * Referencia a números de página::
564 @node Crear títulos encabezamientos y pies de página
565 @subsection Crear títulos, encabezamientos y pies de página
566 @translationof Creating titles headers and footers
569 * Explicación de los títulos::
570 * Presentación predeterminada de los títulos de partes de libro y partitura::
571 * Disposición predeterminada de las cabeceras y pies de página::
575 @node Explicación de los títulos
576 @unnumberedsubsubsec Explicación de los títulos
577 @translationof Titles explained
579 Cada bloque @code{\book} de un solo archivo de entrada produce un
580 archivo de salida distinto, véase @ref{Estructura del archivo}.
581 Dentro de cada archivo de salida están disponibles tres tipos de zonas
582 para títulos: @emph{Títulos de libro} al principio de cada libro,
583 @emph{Títulos de parte de libro} al principio de cada
584 parte de un libro y @emph{Títulos de partitura} al comienzo de una
587 Los valores de los campos para encabezamientos tales como @code{title}
588 (para el título) y @code{composer} (para el autor) se establecen en
589 bloques @code{\header} (para ver la sintaxis de los bloques
590 @code{\header} y una lista completa de los campos disponibles de forma
591 predeterminada, consulte @ref{Presentación predeterminada de los
592 títulos de partes de libro y partitura}). Tanto los títulos de libro como
593 los títulos de parte de libro y los títulos de partitura pueden
595 campos, aunque de forma predeterminada los campos de los títulos de
596 partitura se limitan a @code{piece} (pieza) y @code{opus}.
598 Los bloques @code{\header} se pueden situar en cuatro lugares
599 distintos para formar una jerarquía descendente de bloques
605 Al principio del archivo de entrada, antes de cualquier otro bloque
606 @code{\book}, @code{\bookpart} o @code{\score}.
609 Dentro de un bloque @code{\book} pero fuera de los bloques
610 @code{\bookpart} y @code{\score} que están dentro de ese libro.
613 Dentro de un bloque @code{\bookpart} pero fuera de cualquier bloque
614 @code{\score} dentro de dicha parte de libro.
617 Después de la expresión musical de un bloque @code{\score}.
621 Los valores de los campos se fitran a través de esta jerarquía,
622 persistiendo aquellos que se establecen más arriba a no ser que se
623 sobreescriban por un valor establecido más abajo en la jerarquía, y
629 El título de un libro deriva de los campos establecidos al
630 principio del archivo de entrada, modificado por campos
631 establecidos en el bloque @code{\book}. Los campos resultantes se
632 usan para imprimir el título de libro para dicho libro, siempre y
633 cuando haya otro material que genere una página al comienzo del
634 libro, antes de la primera parte de libro. Es suficiente una sola
635 instrucción @code{\pageBreak}.
638 Un título de parte de libro se deriva de los campos fijados al
639 principio del archivo de entrada, modificado por los campos
640 establecidos dentro del bloque @code{\book}, y posteriormente
641 modificado por los campos que se fijan dentro del bloque
642 @code{\bookpart}. Los valores resultantes se usan para imprimir el
643 título de parte de libro para esa parte.
646 Un título de partitura se deriva de los campos que se fijan al
647 principio del archivo de entrada, modificados por los campos fijados
648 dentro del bloque @code{\book}, posteriormente modificados por los
649 campos que se fijan dentro del bloque @code{\bookpart} y finalmente
650 modificados por los campos establecidos dentro del bloque
651 @code{\score}. Los valores restulantes se utilizan para imprimir el
652 título de partitura. Observe, sin embargo, que de forma
653 predeterminada solamente se imprimen los campos @code{piece} y
654 @code{opus} en los títulos de partitura a no ser que la variable de
655 @code{\paper}, @code{print-all-headers}, tenga el valor @code{#t}.
659 @warning{Recuerde que al poner un bloque @bs{}@code{header} dentro de
660 un bloque @bs{}@code{score}, la expresión musical debe aparecer antes
661 del bloque @bs{}@code{header}.}
663 No es necesario aportar bloques @code{\header} en los cuatro lugares:
664 cualquiera de ellos o incluso todos pueden omitirse. De forma
665 similar, los archivos de entrada sencillos pueden omitir los bloques
666 @code{\book} y @code{\bookpart}, dejando que se creen de forma
669 Si el lobro solamente tiene una partitura, el bloque @code{\header}
670 debiera situarse normalmente al principio del archivo de forma que
671 solamente se produce una zona de título de parte de libro, haciendo
672 que estén disponibles para su uso todos los títulos de
675 Si el libro tiene varias partituras, son posibles distintas
676 combinaciones de bloques @code{\header}, según los distintos tipos de
677 publicaciones musicales. Por ejemplo, si la publicación contiene
678 varias piezas del mismo autor, un bloque @code{\header} colocado al
679 principio del archivo que especifique el título del libro y el autor,
680 con bloques @code{\header} en cada bloque @code{\score} que
681 especifique la @code{piece} y/o el @code{opus} sería lo más adecuado,
684 @lilypond[papersize=a5,quote,verbatim,noragged-right]
687 composer = "J. S. Bach."
691 \new Staff \relative g, {
694 \repeat unfold 2 { g16( d' b') a b d, b' d, } |
695 \repeat unfold 2 { g,16( e' c') b c e, c' e, } |
703 \new Staff \relative b {
707 <g, d' b'~>4 b'16 a( g fis) g( d e fis) g( a b c) |
708 d16( b g fis) g( e d c) b(c d e) fis( g a b) |
716 Son posibles disposiciones más complejas. Por ejemplo, los campos de
717 texto extraídos del bloque @code{\header} de un libro se pueden
718 imprimir en todos los títulos de partitura, con ciertos campos
719 sobreescritos y otros suprimidos manualmente:
721 @lilypond[papersize=a5,quote,verbatim,noragged-right]
724 print-all-headers = ##t
727 title = "DAS WOHLTEMPERIRTE CLAVIER"
729 % Do not display the tagline for this book
732 \markup { \vspace #1 }
736 \new Staff { \clef "bass" s1 }
739 title = "PRAELUDIUM I"
741 % Do not display the subtitle for this score
748 \new Staff { \clef "bass" s1 }
752 subsubtitle = "A 4 VOCI"
754 % Do not display the subtitle for this score
762 Referencia de la notación:
763 @ref{Estructura del archivo},
764 @ref{Presentación predeterminada de los títulos de partes de libro y partitura},
765 @ref{Personalización de los títulos}.
768 @node Presentación predeterminada de los títulos de partes de libro y partitura
769 @unnumberedsubsubsec Presentación predeterminada de los títulos de partes de libro y partitura
770 @translationof Default layout of bookpart and score titles
772 Este ejemplo muestra todas las variables de @code{\header}:
775 @lilypond[papersize=a6landscape,quote,verbatim,noragged-right]
778 % Los siguientes campos están centrados
779 dedication = "Dedication (dedicatoria)"
780 title = "Title (título)"
781 subtitle = "Subtitle (subtítulo)"
782 subsubtitle = "Subsubtitle (sub-subtítulo)"
783 % Los siguientes campos se distribuyen regularmente sobre una línea
784 % el campo "instrument" también aparece en las siguientes páginas
785 instrument = \markup \with-color #green "Instrument (instrumento)"
786 poet = "Poet (poeta)"
787 composer = "Composer (autor)"
788 % Los siguientes campos se sitúan en los extremos opuestos de la misma línea
789 meter = "Meter (metro)"
790 arranger = "Arranger (arreglista)"
791 % Los siguientes campos están centrados en la parte inferior
792 tagline = "la tagline o línea de etiqueta va al final de la úitlma página"
793 copyright = "el copyright va al final de la primera página"
798 % Los siguientes campos se colocan en los extremos de una línea
799 piece = "Piece (pieza) 1"
806 % Los siguientes campos se sitúan en los extremos de una línea
807 piece = "Piece (pieza) 2 en la misma página"
815 % Los siguientes campos se sitúan en los extremos de una línea
816 piece = "Piece (pieza) 3 en una página nueva"
827 El nombre de instrumento se repite en todas las páginas.
830 Solamente @code{piece} (la pieza) y @code{opus} se imprimen en una
831 @code{\score} cuando la variable de papel @code{print-all-headers} se
832 establece a @code{##f} (el valor predeterminado).
835 @c Is the bit about \null markups true? -mp
836 Los campos de texto que se dejan sin establecer dentro de un bloque
837 @code{\header} se sustituyen por elementos de marcado nulos
838 @code{\null} de manera que no ocupen espacio innecesariamente.
841 Los ajustes predeterminados para @code{scoreTitleMarkup} sitúan los
842 campos de texto @code{piece} y @code{opus} en extremos opuestos de la
847 Para cambiar la disposición predeterminada, véase
848 @ref{Personalización de los títulos}.
852 Si un bloque @code{\book} comienza inmediatamente con un bloque
853 @code{\bookpart}, no se imprime ningún título de libro, pues no
854 existe ninguna página en que imprimirlo. Si es necesario un
855 título de libro, inicie el bloque @code{\book} con algún material
856 de marcado o con una instrucción @code{\pageBreak}.
858 Utilice la variable @code{breakbefore} dentro de un bloque
859 @code{\header} que está propiamente dentro de un bloque @code{\score}
860 para hacer que los títulos del bloque @code{\header} del nivel
861 superior aparezcan ocupando toda la primera página, empezando la
862 música (definida en el bloque @code{\score}) en la página siguiente.
865 @lilypond[papersize=c7landscape,verbatim,noragged-right]
868 title = "Este es mi Title (título)"
869 subtitle = "Este es mi Subtitle (subtítulo)"
870 copyright = "Este es el final de la primera página"
873 \repeat unfold 4 { e'' e'' e'' e'' }
875 piece = "Esto es la música"
883 Manual de aprendizaje:
884 @rlearning{Cómo funcionan los archivos de entrada de LilyPond}
886 Referencia de la notación:
887 @ref{Personalización de los títulos},
888 @ref{Estructura del archivo}.
891 @file{ly/titling-init.ly}.
894 @node Disposición predeterminada de las cabeceras y pies de página
895 @unnumberedsubsubsec Disposición predeterminada de las cabeceras y pies de página
896 @translationof Default layout of headers and footers
898 Las @emph{cabeceras} y los @emph{pies} de página son líneas de texto
899 que aparecen en la parte más alta y en la más baja de las páginas
900 separadas del texto principal de un libro. Se controlan mediante las
901 siguientes variables de @code{\paper}:
904 @item @code{oddHeaderMarkup} (marcado de cabecera impar)
905 @item @code{evenHeaderMarkup} (marcado de cabecera par)
906 @item @code{oddFooterMarkup} (marcado de pie impar)
907 @item @code{evenFooterMarkup} (marcado de pie par)
910 Estas variables de marcado sólo pueden acceder a los campos de texto
911 extraídos de bloques @code{\header} del nivel superior (que se aplican
912 a todas las partituras del libro) y se definen en el archivo
913 @file{ly/titling-init.ly}. De forma predeterminada:
918 los números de página se sitúan automáticamente en el extremo superior
919 izquierdo (si es par) o superior derecho (si es impar), a partir de la
923 el campo de texto @code{instrument} se sitúa en el centro en cada
924 página, a partir de la segunda página.
927 el texto de @code{copyright} se centra en la parte baja de la primera
931 la línea @code{tagline} se centra al final de la última página, y
932 debajo del texto de @code{copyright} si sólo hay una página.
936 La línea de etiqueta tagline predeterminada se puede cambiar añadiendo un campo
937 @code{tagline} en el bloque @code{\header} del nivel superior.
939 @lilypond[papersize=a8landscape,verbatim]
942 tagline = "... music notation for Everyone"
952 Para eliminar la línea @code{tagline}, establezca su valor a
956 @node Títulos encabezamientos y pies de página personalizados
957 @subsection Títulos, encabezamientos y pies de página personalizados
958 @translationof Custom titles headers and footers
960 @c TODO: somewhere put a link to header spacing info
961 @c (you'll have to explain it more in NR 4).
964 * Formateo personalizado del texto de los títulos::
965 * Personalización de los títulos::
966 * Disposición personalizada de cabeceras y pies de página::
970 @node Formateo personalizado del texto de los títulos
971 @unnumberedsubsubsec Formateo personalizado del texto de los bloques de título
972 @translationof Custom text formatting for titles
974 Se pueden usar instrucciones @code{\markup} estándar para personalizar
975 el texto de cualquier cabecera, pie o título dentro del bloque
978 @lilypond[quote,verbatim,noragged-right]
982 piece = \markup { \fontsize #4 \bold "PRAELUDIUM I" }
983 opus = \markup { \italic "BWV 846" }
989 Referencia de la notación:
990 @ref{Formatear el texto}.
993 @node Personalización de los títulos
994 @unnumberedsubsubsec Personalización de los títulos
995 @translationof Custom layout for titles
997 @cindex bookTitleMarkup
998 @cindex scoreTitleMarkup
999 @funindex bookTitleMarkup
1000 @funindex scoreTitleMarkup
1002 Las instrucciones @code{\markup} dentro del bloque @code{\header} son
1003 útiles para dar un formato simple al texto, pero no permiten un
1004 control preciso sobre la colocación de los títulos. Para personalizar
1005 la colocación de los campos de texto, cambie una o las dos variables de
1006 @code{\paper} siguientes:
1009 @item @code{bookTitleMarkup} (marcado de título del libro)
1010 @item @code{scoreTitleMarkup} (marcado de título de la partitura)
1013 La colocación de los títulos cuando se utilizan los valores
1014 predeterminados de estas variables de @code{\markup} se muestra en los
1016 @ref{Presentación predeterminada de los títulos de partes de libro y partitura}.
1018 Los ajustes predeterminados para @code{scoreTitleMarkup} tal y como
1019 están definidos en el archivo @file{ly/titling-init.ly} son:
1022 scoreTitleMarkup = \markup @{ \column @{
1023 \on-the-fly \print-all-headers @{ \bookTitleMarkup \hspace #1 @}
1025 \fromproperty #'header:piece
1026 \fromproperty #'header:opus
1032 Esto sitúa los campos de texto @code{piece} y @code{opus} en extremos
1033 opuestos de la misma línea:
1035 @lilypond[quote,verbatim,noragged-right]
1039 piece = "PRAELUDIUM I"
1045 Este ejemplo redefine @code{scoreTitleMarkup} de manera que el campo
1046 de texto @code{piece} aparece centrado y en un tipo de letra grande y
1049 @lilypond[papersize=a5,quote,verbatim,noragged-right]
1053 scoreTitleMarkup = \markup {
1056 \fontsize #4 \bold \fromproperty #'header:piece
1057 \fromproperty #'header:opus
1061 \header { tagline = ##f }
1065 piece = "PRAELUDIUM I"
1072 Los campos de texto que normalmente no son efectivos
1073 dentro de los bloques @code{\header} de una partitura
1074 se pueden imprimir el la zona del Título de la partitura
1075 si se coloca @code{print-all-headers} dentro del bloque @code{\paper}.
1076 Una desventaja de la
1077 utilización de este método es que los campos de texto que están
1078 orientados específicamente para la zona del título de parte de libro
1079 han de suprimirse manualmente en cada uno de los bloques
1080 @code{\score}. Véase @ref{Explicación de los títulos}.
1082 Para evitarlo, añada el campo de texto deseado a la definición de
1083 @code{scoreTitleMarkup}. En el ejemplo siguiente, el campo de texto
1084 @code{composer} (asociado normalmente con @code{bookTitleMarkup}) se
1085 añade a @code{scoreTitleMarkup}, permitiendo que cada partitura
1086 muestre un compositor diferente:
1088 @lilypond[papersize=a5,quote,verbatim,noragged-right]
1092 scoreTitleMarkup = \markup {
1095 \fontsize #4 \bold \fromproperty #'header:piece
1096 \fromproperty #'header:composer
1100 \header { tagline = ##f }
1105 composer = "Christian Petzold"
1112 composer = "François Couperin"
1118 También podemos crear nuestros propios campos de texto personalizados,
1119 y referirnos a ellos en la definición del elemento de marcado.
1121 @lilypond[papersize=a5,quote,verbatim,noragged-right]
1125 scoreTitleMarkup = \markup {
1128 \override #`(direction . ,UP) {
1130 \center-align \fontsize #-1 \bold
1131 \fromproperty #'header:mycustomtext %% User-defined field
1132 \center-align \fontsize #4 \bold
1133 \fromproperty #'header:piece
1136 \fromproperty #'header:opus
1140 \header { tagline = ##f }
1145 mycustomtext = "A 4 VOCI" %% User-defined field
1153 Referencia de la notación:
1154 @ref{Explicación de los títulos}.
1157 @node Disposición personalizada de cabeceras y pies de página
1158 @unnumberedsubsubsec Disposición personalizada de cabeceras y pies de página
1159 @translationof Custom layout for headers and footers
1161 @c can make-header and make-footer be removed from
1162 @c paper-defaults-init.ly? -mp
1164 Las instrucciones @code{\markup} dentro del bloque @code{\header} son
1165 de utilidad para dar formato al texto de una manera sencilla, pero no
1166 permiten un control preciso sobre la colocación de las cabeceras y los
1167 pies de página. Para personalizar la colocación de los campos de
1168 texto, use una o más de las siguientes variables de @code{\paper}:
1171 @item @code{oddHeaderMarkup} (marcado de encabezamiento impar)
1172 @item @code{evenHeaderMarkup} (marcado de encabezamiento par)
1173 @item @code{oddFooterMarkup} (marcado de pie de página impar)
1174 @item @code{evenFooterMarkup} (marcado de pie de página par)
1177 @cindex marcado condicional
1179 @funindex \on-the-fly
1181 La instrucción de marcado @code{\on-the-fly} se puede utilizar para
1182 añadir elementos de forma condicional al texto de encabezamiento y pie
1183 de página definido dentro del bloque @code{\paper}, usando la sintaxis
1187 @code{variable} = @code{\markup} @{
1189 @code{\on-the-fly} \@var{procedimiento} @var{marcado}
1194 El @var{procedimiento} se llama cada vez que se evalúa la instrucción
1195 @code{\markup} en que ésta aparece. El @var{procedimiento} debería
1196 comprobar si se cumple una condición determinada e interpretar (es
1197 decir: imprimir) el argumento @var{marcado} si, y sólo si, la
1198 condición es verdadera.
1200 Se proveen un cierto número de procedimientos ya hechos para la
1201 comprobación de diversas condiciones:
1204 @multitable {print-page-number-check-first-----} {¿es el núm. de páginas en la parte de libro > 1?-----}
1206 @headitem Nombre del procedimiento @tab Condición que se comprueba
1208 @item print-page-number-check-first @tab ¿debería imprimirse esta página?
1209 @item create-page-number-stencil @tab ¿es print-page-numbers verdadero?
1210 @item print-all-headers @tab ¿es print-all-headers verdadero?
1211 @item first-page @tab ¿es la primera página del libro?
1212 @item (on-page nmbr) @tab ¿es el número de página = nmbr?
1213 @item last-page @tab ¿es la última página del libro?
1214 @item not-first-page @tab ¿no es la primera página del libro?
1215 @item part-first-page @tab ¿es la primera página de la parte de libro?
1216 @item part-last-page @tab ¿es la última página de la parte de libro?
1217 @item not-single-page @tab ¿es el núm. de páginas en la parte de libro > 1?
1222 El ejemplo siguiente centra los números de página en la parte baja de
1223 las páginas. En primer lugar, los ajustes predeterminados para
1224 @code{oddHeaderMarkup} y @code{evenHeaderMarkup} se eliminan
1225 definiéndolos como un marcado @emph{nulo}. Después de esto, se
1226 redefine @code{oddFooterMarkup} con el número de página centrado.
1227 Finalmente, @code{evenFooterMarkup} recibe la misma disposición
1228 definiéndola como @code{\oddFooterMarkup}:
1230 @lilypond[papersize=a8,quote,verbatim,noragged-right]
1233 print-page-number = ##t
1234 print-first-page-number = ##t
1235 oddHeaderMarkup = \markup \null
1236 evenHeaderMarkup = \markup \null
1237 oddFooterMarkup = \markup {
1239 \on-the-fly \print-page-number-check-first
1240 \fromproperty #'page:page-number-string
1243 evenFooterMarkup = \oddFooterMarkup
1246 \new Staff { s1 \break s1 \break s1 }
1251 Se pueden combinar varias condiciones de @code{\on-the-fly} con un
1252 operador @q{and}, por ejemplo:
1255 @code{\on-the-fly \first-page}
1256 @code{\on-the-fly \last-page}
1257 @code{@{ \markup @dots{} \fromproperty #'header: @dots{} @}}
1260 determina si la salida es una sola página.
1263 Referencia de la notación:
1264 @ref{Explicación de los títulos},
1265 @ref{Presentación predeterminada de los títulos de partes de libro y partitura}.
1267 Archivos instalados:
1268 @file{../ly/titling-init.ly}.
1271 @node Crear notas al pie
1272 @subsection Crear notas al pie
1273 @translationof Creating footnotes
1275 @cindex notas al pie
1277 Se pueden crear dos tipos de notas al pie: automáticas y manuales.
1280 * Notas al pie dentro de expresiones musicales::
1281 * Notas al pie en texto independiente::
1284 @node Notas al pie dentro de expresiones musicales
1285 @unnumberedsubsubsec Notas al pie dentro de expresiones musicales
1286 @translationof Footnotes in music expressions
1288 @cindex notas al pie dentro de expresiones musicales
1291 @subsubsubheading Panorámica de las notas al pie
1293 Las notas al pie dentro de expresiones musicales caen dentro de dos
1297 @item Notas al pie basadas en eventos
1298 Se adjuntan a un evento en particular. Son ejemplos de tales eventos
1299 las notas sueltas, las articulaciones (como indicaciones de digitación,
1300 acentos, indicaciones dinámicas) y los post-eventos (como las ligaduras de expresión
1301 y las barras de corchea manuales). La forma general de las notas
1302 al pie basadas en eventos es como sigue:
1305 [@var{dirección}] \footnote [@var{marca}] @var{desplazamiento} @var{texto-de-la-nota} @var{música}
1308 @item Notas al pie basadas en tiempo
1309 Se ligan a un punto temporal determinado, dentro de un contexto
1310 musical. Algunas instrucciones como @code{\time} y @code{\clef} en
1311 realidad no usan eventos para crear objetos como la indicación de
1312 compás y la clave. Un acorde tampoco crea un evento por sí mismo: su
1313 plica o corchete se crea al final de un paso de tiempo (nominalmente,
1314 a través de uno de los eventos de nota que contiene). Una nota al pie
1315 basada en tiempo permite anotar tales objetos de presentación sin
1316 referirse a ningún evento.
1318 Una nota al pie basada en tiempo permite que tales objetos de
1319 presentación se puedan anotar sin hacer referencia a un evento.
1320 La forma general para las notas al pie basadas en tiempo es:
1323 \footnote [@var{marca}] @var{desplazamiento} @var{texto-de-la-nota} [@var{Contexto}].@var{Nombre-del-Grob}
1328 Los elementos para las dos formas son como sigue:
1333 Si (y sólo si) el @code{\footnote} se está aplicando a un post-evento
1334 o articulación, debe ir precedida de un indicador de dirección
1335 (@code{-, _, ^}) con el objeto de adjuntar la @var{música} (con una
1336 marca de nota al pie) a la nota o silencio precedente.
1339 es un elemento de marcado o cadena de caracteres que especifica la
1340 marca de nota al pie que se usa para marcar tanto el punto de
1341 referencia como la propia nota al pie en la parte inferior de la
1342 página. Se puede omitir (o, de forma equivalente, sustituirse por
1343 @code{\default}) en cuyo caso se genera un número secuencialmente de
1344 forma automática. Tales secuencias numéricas se reinician en cada
1345 página que contiene una nota al pie.
1347 @item desplazamiento
1348 es una pareja de números tal como @samp{#(2 . 1)} que especifica los
1349 desplazamientos en X y en Y en unidades de espacios de pentagrama a
1350 partir del límite del objeto en que se desea situar la marca. Los
1351 valores de desplazamiento positivos se toman a partir del borde
1352 superior derecho, los valores negativos a partir del borde inferior
1353 izquierdo y cero implica que la marca se centra sobre el borde.
1356 es el contexto en que se crea el grob que recibe la nota al pie.
1357 Se puede omitir si el grob está en un contexto del nivel inferior,
1358 p.ej un contexto @code{Voice}.
1360 @item Nombre-del-Grob
1361 especifica un tipo de grob que marcar (como @samp{Flag} para el
1362 corchete). Si se da, la nota al pie no se adjunta a una expresión
1363 musical en particular, sino a todos los grobs del tipo
1364 especificado que ocurren en dicho momento de tiempo musical.
1366 @item texto-de-la-nota
1367 es el elemento de marccado o cadena de caracteres que especifica el
1368 texto de la nota al pie que utilizar en la parte baja de la página.
1371 es el evento musical, post-evento o articulación que se
1376 @subsubsubheading Notas al pie basadas en eventos
1378 @cindex Notas al pie, basadas en eventos
1380 Una nota al pie se adjunta a un objeto de presentación causado
1381 directamente por el evento que corresponde a @var{música}, con la
1385 \footnote [@var{marca}] @var{desplazamiento} @var{texto-de-la-nota} @var{música}
1389 @lilypond[quote,verbatim,papersize=a8landscape]
1391 \header { tagline = ##f }
1393 \footnote #'(-1 . 3) "Una nota" a4
1395 \footnote #'(2 . 2) "Un silencio" r4
1401 No es posible marcar un acrode @emph{completo} con una nota al pie
1402 basada en evento: un acorde, incluso aquel que contiene una sola
1403 nota, no produce un verdadero evento por sí mismo. Sin embargo,
1404 las notas individuales que están @emph{dentro} del acorde sí se
1408 @lilypond[quote,verbatim,papersize=a8landscape]
1410 \header { tagline = ##f }
1412 \footnote #'(2 . 3) "No funciona" <a-3>2
1413 <\footnote #'(-2 . -3) "Funciona" a-3>4
1414 <a-3 \footnote #'(3 . 1/2) "También funciona" c-5>4
1419 Si se desea que la nota al pie se adjunte a un post-evento o
1420 articulación, la instrucción @code{\footnote} @emph{debe} ir
1421 precedida por un indicador de dirección, @code{-, _, ^}, y seguida
1422 por el post-evento o articulación que se desea anotar como
1423 argumento @var{música}. En esta forma, la @code{\footnote} se
1424 puede considerar como una simple copia de su último argumento con
1425 una marca de nota al pie adjunta. La sintaxis es:
1428 @var{dirección} \footnote [@var{marca}] @var{desplazamiento} @var{texto-de-la-nota} @var{música}
1432 @lilypond[quote,verbatim,papersize=a8landscape]
1434 \header { tagline = ##f }
1436 a4_\footnote #'(0 . -1) "Ligadura forzada hacia abajo" (
1437 b8^\footnote #'(1 . 0.5) "Barra manual forzada hacia arriba" [
1440 c-\footnote #'(1 . 1) "Tenuto" --
1445 @subsubsubheading notas al pie basadas en tiempo
1447 @cindex notas al pie, basadas en tiempo
1449 Si el objeto de presentación que recibe la nota al pie está
1450 causado @emph{indirectamente} por un evento (como un objeto
1451 @code{Accidental}, alteración, o @code{Stem}, plica, causados por
1452 un evento @code{NoteHead}, cabeza de nota), el nombre del grob
1453 @var{GrobName} del objeto de presentación es necesario después del
1454 texto de la nota al pie, en lugar de @var{música}:
1457 @lilypond[quote,verbatim,papersize=a8landscape]
1459 \header { tagline = ##f }
1461 \footnote #'(-1 . -3) "Un bemol" Accidental
1463 \footnote #'(-1 . 0.5) "Otro bemol" Accidental
1465 \footnote #'(1 . -2) "Una plica" Stem
1471 Sin embargo, observe que cuando se especifica el nombre de un
1472 grob, se adjunta una nota al pie a todos los grobs de ese tipo
1473 dentro del instante de tiempo actual:
1476 @lilypond[quote,verbatim,papersize=a8landscape]
1478 \header { tagline = ##f }
1480 \footnote #'(-1 . 3) "Un bemol" Accidental
1482 \footnote #'(2 . 0.5) "Articulación" Script
1488 Una nota dentro de un acorde puede recibir una nota al pie
1489 individual, basada en evento. El único grob causado directamente
1490 por una nota de un acorde es @samp{NoteHead}, por lo que la
1491 instrucción de nota al pie basada en evento @emph{solamente} es
1492 apta para añadir una nota al pie a la @samp{NoteHead} dentro de un
1493 acorde. Todos los demás grobs de notas de acorde están causados
1494 indirectamente. La propia instrucción @code{\footnote} no ofrece
1495 ninguna sintaxis para especificar al mismo tiempo un tipo concreto
1496 de grob @emph{y también} un evento concreto al que adjuntar la
1497 nota. Sin embargo, se puede usat una instrucción @code{\footnote}
1498 basada en tiempo para especificar el tipo de grob, y luego añadir
1499 la instrucción @code{\single} como prefijo, con el objeto de que
1500 se aplique solamente al evento siguiente:
1503 @lilypond[quote,verbatim,papersize=a8landscape]
1505 \header { tagline = ##f }
1507 < \footnote #'(1 . -2) "An A" a
1508 \single \footnote #'(-1 . -1) "Un sostenido" Accidental
1510 \single \footnote #'(0.5 . 0.5) "Un bemol" Accidental
1517 @warning {Cuando las notas al pie se adjuntan a varios elementos musicales que
1518 están dentro del mismo momento musical, como ocurre en el ejemplo
1519 anterior, las notas al pie se numeran desde los elementos más
1520 altos a los más bajos tal y como aparecen en la salida impresa, no
1521 en el orden en que se escriben en el flujo de entrada.}
1523 Los objetos de presentación como las claves y las armaduras de
1524 cambio de tonalidad están, más bien, causadas por propiedades que
1525 cambian, y no por eventos. Otros, como las líneas divisorias y
1526 los números de compás, son una consecuencia directa del paso del
1527 tiempo. Por esta razón, las notas al pie sobre tales objetos
1528 tienen que basarse en su tiempo musical. Las notas al pie basadas
1529 en tiempo so preferibles también cuando se marcan cosas como las
1530 plicas y las barras de corchea en @emph{acordes}: dado que estas
1531 funcionalidades de cada acorde individual están asignadas
1532 normalmente a @emph{un solo} evento dentro del acorde, sería
1533 imprudente descansar en una elección particular.
1535 En las notas al pie basadas en tiempo, siempre se debe especificar
1536 explícitamente el objeto de presentación en cuestión, y si el grob
1537 se crea dentro de un contexto distinto al de nivel más bajo, debe
1538 especificarse el contexto apropiado.
1541 @lilypond[quote,verbatim,papersize=a8landscape]
1543 \header { tagline = ##f }
1546 \footnote #'(-0.5 . -1) "Cambio de compás" Staff.TimeSignature
1548 \footnote #'(1 . -1) "Plica de acorde" Stem
1550 \footnote #'(-0.5 . 1) "Línea divisoria" Staff.BarLine
1552 \footnote #'(0.5 . -1) "Cambio de tonalidad" Staff.KeySignature
1559 Se pueden usar marcas personalizadas como alternativas a las
1560 marcas numéricas, y se puede suprimir la línea de anotación que
1561 une el objeto marcado con su marca:
1564 @lilypond[quote,verbatim,papersize=a8landscape]
1566 \header { tagline = ##f }
1568 \footnote "*" #'(0.5 . -2) \markup { \italic "* La primera nota" } a'4
1570 \footnote \markup { \super "$" } #'(0.5 . 1)
1571 \markup { \super "$" \italic " La segunda nota" } e
1573 \once \override Score.FootnoteItem.annotation-line = ##f
1574 b-\footnote \markup \tiny "+" #'(0.1 . 0.1)
1575 \markup { \super "+" \italic " Editorial" } \p
1580 Se muestran más ejemplos de marcas personalizadas en
1581 @ref{Notas al pie en texto independiente}.
1584 @node Notas al pie en texto independiente
1585 @unnumberedsubsubsec Notas al pie en texto independiente
1586 @translationof Footnotes in stand-alone text
1588 @cindex notas al pie en texto independiente
1590 Se utilizan dentro de un elemento de marcado fuera de cualquier
1591 expresión musical. No se traza una líne hasta el punto de referencia:
1592 la marca simplemente sigue al elemento de marcado que se referencia.
1593 Se pueden insertar las marcas automáticamente, en cuyo caso son
1594 numéricas. De forma alternativa, se pueden aportar manualmente marcas
1597 Las notas al pie para texto independiente con marcas automáticas y
1598 personalizadas se crean de distintas formas.
1600 @subsubsubheading Notas al pie en texto independiente con marcas automáticas
1602 La sintaxis de una nota al pue sobre texto independiente con marcas
1606 \markup @{ @dots{} \auto-footnote @var{texto} @var{nota} @dots{} @}
1614 es el elemento de marcado o cadena de caracteres que se desea anotar.
1617 es el elemento de marcado o cadena de caracteres que especifica el
1618 texto de la nota al pie que utilizar en la parte baja de la página.
1624 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1626 \header { tagline = ##f }
1629 \auto-footnote "tune" \italic " By me"
1630 "is shown below. It is a"
1631 \auto-footnote "recent" \italic " Aug 2012"
1640 @subsubsubheading Notas al pie sobre texto independiente con marcas personalizadas
1642 La sintaxis de una nota al pie sobre texto independiente con marcas
1646 \markup @{ @dots{} \footnote @var{marca} @var{nota} @dots{} @}
1654 es un elemento de marcado o cadena de caracteres que especifica la
1655 marca que se usa para señalar el punto de referencia. Observe que
1656 esta marca @emph{no} se inserta automáticamente antes de la propia
1660 es el elemento de marcado o cadena de caracteres que especifica el
1661 texto de la nota que aparece en la parte baja de la página, precedida
1662 por la @var{marca} especificada.
1666 Se puede usar como marca un carácter fácil de teclear, como * ó +,
1667 según se muestra en @ref{Notas al pie dentro de expresiones musicales}.
1668 De forma alternativa, se pueden usar alias en ASCII (véase
1669 @ref{Alias de ASCII}):
1671 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1673 \paper { #(include-special-characters) }
1674 \header { tagline = ##f }
1677 \footnote "*" \italic "* By me"
1678 "is shown below. It is a recent"
1679 \footnote \super † \concat {
1680 \super † \italic " Aug 2012"
1690 También pueden utilizarse códigos de caracteres Unicode para
1691 especificar las marcas (véase @ref{Unicode}):
1693 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1695 \header { tagline = ##f }
1698 \footnote \super \char##x00a7 \concat {
1699 \super \char##x00a7 \italic " By me"
1701 "is shown below. It is a recent"
1702 \footnote \super \char##x00b6 \concat {
1703 \super \char##x00b6 \italic " Aug 2012"
1714 Manual de aprendizaje:
1715 @rlearning{Objetos e interfaces}.
1717 Referencia de la notación:
1718 @ref{ASCII aliases},
1719 @ref{Globos de ayuda},
1720 @ref{List of special characters},
1721 @ref{Indicaciones de texto},
1722 @ref{Guiones de texto},
1725 Referencia de funcionamiento interno:
1726 @rinternals{FootnoteEvent},
1727 @rinternals{FootnoteItem},
1728 @rinternals{FootnoteSpanner},
1729 @rinternals{Footnote_engraver}.
1732 Varias notas al pie en la misma página solo pueden ir apiladas unas
1733 sobre otras; no se pueden imprimir en la misma línea.
1735 Las notas al pie no se pueden adjuntar a @code{MultiMeasureRests}
1736 (silencios multicompás), a barras de corchea automáticas ni a la
1737 letra de las canciones.
1739 Las notas al pie pueden colisionar con las pautas, objetos
1740 @code{\markup}, otras marcas de notas al pie y líneas de
1744 @node Referencia a números de página
1745 @subsection Referencia a números de página
1746 @translationof Reference to page numbers
1748 Un lugar determinado de una partitura puede señalizarse usando la
1749 instrucción @code{\label} (etiqueta), ya sea en el nivel superior o
1750 dentro de la música. Podemos referirnos a esta etiqueta más tarde
1751 dentro de un elemento de marcado, para obtener el número de la página
1752 en la que se sitúa el punto señalizado, usando la instrucción de
1753 marcado @code{\page-ref}.
1756 @lilypond[verbatim,papersize=a8landscape]
1757 \header { tagline = ##f }
1763 \pageBreak \mark A \label #'markA
1767 \markup { La primera partitura comienza en la página \page-ref #'firstScore "0" "?" }
1768 \markup { La marca A está en la página \page-ref #'markA "0" "?" }
1772 La instrucción de marcado @code{\page-ref} toma tres argumentos:
1774 @item la etiqueta, un símbolo de scheme, p.ej. @code{#'firstScore};
1775 @item un elemento de marcado que se usará como medidor para estimar las dimensiones del marcado;
1776 @item un elemento de marcado que se utilizará en sustitución del número de página si la etiqueta es desconocida.
1779 El motivo de que se necesite un medidor es que en el momento en que se
1780 están interpretando los marcados, los saltos de página aún no se han
1781 producido y por tanto los números de página no se conocen todavía.
1782 Para sortear este inconveniente, la interpretación real del marcado se
1783 retrasa hasta un momento posterior; sin embargo, las dimensiones del
1784 marcado se tienen que conocer de antemano, así que se usa el medidor
1785 para decidir estas dimensiones. Si el libro tiene entre 10 y 99
1786 páginas, el medidor puede ser "00", es decir, un número de dos
1797 @node Índice general
1798 @subsection Índice general
1799 @translationof Table of contents
1801 Se puede insertar un índice general o tabla de contenidos utilizando
1802 la instrucción @code{\markuplist \table-of-contents}. Los elementos
1803 que deben aparecer en la tabla de contenidos se introducen con la
1804 instrucción @code{\tocItem}, que se puede usar en el nivel más alto de
1805 la jerarquía del código, o dentro de una expresión musical.
1808 \markuplist \table-of-contents
1811 \tocItem \markup "Primera partitura"
1815 \tocItem \markup "Un punto concreto dentro de la primera partitura"
1820 \tocItem \markup "Segunda partitura"
1828 Los elementos de marcado que se usan para dar formato al índice
1829 general se encuentran definidos dentro del bloque @code{\paper}. Los
1830 elementos predeterminados son @code{tocTitleMarkup}, para dar formato
1831 al título de la tabla, y @code{tocItemMarkup}, para aplicar formato a
1832 los elementos del índice, que consisten en el título del elemento y el
1833 número de página. Estas variables se pueden cambiar por parte del
1838 %% Traducir el título del índice al español:
1839 tocTitleMarkup = \markup \huge \column {
1840 \fill-line { \null "Índice general" \null }
1843 %% usar una fuente mayor
1844 tocItemMarkup = \markup \large \fill-line {
1845 \fromproperty #'toc:text \fromproperty #'toc:page
1850 Observe la forma en que nos referimos al texto y al número de página
1851 del elemento de índice, dentro de la definición @code{tocItemMarkup}.
1853 También se pueden definir nuevas instrucciones y elementos de
1854 marcado para crear índices generales más elaborados:
1856 @item en primer lugar, defina una variable de marcado nueva dentro del bloque @code{\paper}
1857 @item luego defina una función de música cuyo propósito es añadir un elemento al índice general
1858 utilizando esta variable de marcado del bloque @code{\paper}.
1861 En el ejemplo siguiente se define un estilo nuevo para introducir los
1862 nombres de los actos de una ópera en el índice general:
1866 tocActMarkup = \markup \large \column {
1868 \fill-line { \null \italic \fromproperty #'toc:text \null }
1874 #(define-music-function (parser location text) (markup?)
1875 (add-toc-item! 'tocActMarkup text))
1878 @lilypond[line-width=10.0\cm]
1879 \header { tagline = ##f }
1881 tocActMarkup = \markup \large \column {
1883 \fill-line { \null \italic \fromproperty #'toc:text \null }
1889 #(define-music-function (parser location text) (markup?)
1890 (add-toc-item! 'tocActMarkup text))
1893 \markuplist \table-of-contents
1894 \tocAct \markup { Atto Primo }
1895 \tocItem \markup { Coro. Viva il nostro Alcide }
1896 \tocItem \markup { Cesare. Presti omai l'Egizzia terra }
1897 \tocAct \markup { Atto Secondo }
1898 \tocItem \markup { Sinfonia }
1899 \tocItem \markup { Cleopatra. V'adoro, pupille, saette d'Amore }
1904 Se pueden añadir puntos de relleno entre un elemento y su número de página:
1906 @lilypond[verbatim,line-width=10.0\cm]
1907 \header { tagline = ##f }
1909 tocItemMarkup = \tocItemWithDotsMarkup
1913 \markuplist \table-of-contents
1914 \tocItem \markup { Allegro }
1915 \tocItem \markup { Largo }
1922 @file{ly/toc-init.ly}.
1925 @funindex \table-of-contents
1926 @code{\table-of-contents},
1932 @node Trabajar sobre los archivos de entrada
1933 @section Trabajar sobre los archivos de entrada
1934 @translationof Working with input files
1937 * Inclusión de archivos de LilyPond::
1938 * Distintas ediciones a partir de una misma fuente::
1939 * Caracteres especiales::
1943 @node Inclusión de archivos de LilyPond
1944 @subsection Inclusión de archivos de LilyPond
1945 @translationof Including LilyPond files
1948 @cindex including files
1950 Un proyecto grande se puede dividir en varios archivos. Para
1951 referirse a otro archivo, utilice
1954 \include "otroarchivo.ly"
1957 La línea @code{\include "otroarchivo.ly"} equivale a pegar todo el
1958 contenido de @file{otroarchivo.ly} en el archivo actual en el lugar en
1959 que aparece el @code{\include}. Por ejemplo, en un proyecto grande
1960 podríamos querer archivos distintos para cada parte instrumental y
1961 crear un archivo de @qq{partitura completa} que reúne los archivos
1962 individuales de los instrumentos. Normalmente el archivo incluido
1963 define un cierto número de variables que a partir de entonces quedan
1964 disponibles para poderlas utilizar en el archivo de la partitura
1965 completa. En los archivos incluidos se pueden marcar las secciones
1966 etiquetadas para ayudar a hacerlas utilizables en distintos lugares de
1967 la partitura, véase @ref{Distintas ediciones a partir de una misma fuente}.
1969 Los archivos que están en el directorio de trabajo actual se pueden
1970 referenciar simplemente especificando el nombre después de la
1971 instrucción @code{\include}. Los archivos en otros lugares se pueden
1972 incluir proporcionando una referencia de ruta completa o una ruta
1973 relativa (pero utilice la barra inclinada normal del UNIX, /, no la
1974 barra invertida de DOS/Windows, \, como separador de directorio). Por
1975 ejemplo, si @file{material.ly} está situado un directorio por encima
1976 del directorio de trabajo actual, utilice
1979 \include "../material.ly"
1983 o si los archivos de las partes orquestales incluidas están todos
1984 situados en un subdirectorio llamado @file{partes} dentro del
1985 directorio actual, use
1988 \include "partes/VI.ly"
1989 \include "partes/VII.ly"
1993 Los archivos de inclusión también pueden contener enunciados
1994 @code{\include} a su vez. De forma predeterminada, estos enunciados
1995 @code{\include} de segundo nivel no se interpretan hasta que se
1996 incorporan al archivo principal, por lo que los nombres de archivo que
1997 especifican deben ser relativos al directorio que contiene el archivo
1998 principal, no al directorio que contiene el archivo incluido. Sin
1999 embargo, este comportamiento se puede modificar globalmente pasando la
2000 opción @option{-drelative-includes} en la línea de órdenes (o mediante
2001 la adición de @code{#(ly:set-option 'relative-includes #t)} al
2002 principio del archivo principal de entrada).
2004 Cuando @code{relative-includes} está establecido al valor @code{#t},
2005 la ruta de cada instrucción @code{\include} se considera relativa al
2006 archivo que contiene dicha instrucción. Este comportamiento es el
2007 recomendado y se convertirá en el comportamiento predeterminado en una
2008 versión futura de lilypond.
2010 Tanto los archivos relativos al directorio principal como los archivos
2011 relativos a algún otro directorio se pueden @code{\include}ar mediante
2012 el establecimiento de @code{relative-includes} al valor @code{#t} o a
2013 @code{#f} en los lugares apropiados dentro de los archivos. Por
2014 ejemplo, si se ha creado una biblioteca genérica, libA, que a su vez
2015 utiliza sub-archivos que se @code{\include}an por medio del archivo de
2016 entrada de dicha biblioteca, esas instrucciones @code{\include}
2017 tendrán que venir precedidas por @code{#(ly:set-option
2018 #relative-includes #t)} de manera que se interpreten correctamente al
2019 construir el archivo de entrada @code{.ly} principal, de esta forma:
2030 entonces el archivo de entrada, @code{libA.ly}, contiene
2033 #(ly:set-option 'relative-includes #t)
2037 % vuelta al ajuste predeterminado
2038 #(ly:set-option 'relative-includes #f)
2041 Cualquier archivo @file{.ly} puede entonces incluir la biblioteca
2042 completa, simplemente con
2045 \include "~/libA/libA.ly"
2048 Se pueden usar estructuras de archivo más complejas instando los
2049 cambios en los lugares adecuados.
2051 También se pueden incluir archivos de un directorio que está en una
2052 ruta de búsqueda especificada como opción al invocar a LilyPond desde
2053 la línea de órdenes. Los archivos incluidos se especifican usando
2054 solamente su nombre de archivo. Por ejemplo, para compilar mediante
2055 este método un archivo @file{principal.ly} que incluye archivos
2056 situados en un subdirectorio llamado @file{partes}, cambie al
2057 directorio que contiene @file{principal.ly} e introduzca
2060 lilypond --include=partes principal.ly
2063 y en @file{principal.ly} escriba
2071 Los archivos que se incluyen en muchas partituras se pueden poner en
2072 el directorio de LilyPond @file{../ly} (la localización de este
2073 directorio depende de la instalación: véase
2074 @rlearning{Otras fuentes de información}). Estos archivos se pueden
2075 incluir sencillamente por su nombre en un enunciado @code{\include}.
2076 De esta forma se incluyen los archivos dependientes del idioma como
2079 LilyPond incluye de forma predeterminada ciertos archivos cuando se
2080 inicia el programa. Estas inclusiones no son visibles para el
2081 usuario, pero los archivos se pueden identificar ejecutando
2082 @code{lilypond --verbose} desde la línea de órdenes. Esto presentará
2083 una lista de rutas y archivos que utiliza LilyPond, junto a muchas
2084 otras indicaciones. De forma alternativa, pueden verse explicaciones
2085 sobre los archivos más importantes de este conjunto en
2086 @rlearning{Otras fuentes de información}. Estos archivos se pueden
2087 editar, pero los cambios realizados sobre ellos se perderán al
2088 instalar una nueva versión de LilyPond.
2090 Pueden verse ejemplos sencillos sobre el uso de @code{\include} en
2091 @rlearning{Partituras y particellas}.
2094 Manual de aprendizaje:
2095 @rlearning{Otras fuentes de información},
2096 @rlearning{Partituras y particellas}.
2099 Si un archivo incluido recibe un nombre igual al de uno de los
2100 archivos de instalación de LilyPond, el archivo que tiene prioridad es
2101 el de los archivos de instalación de LilyPond.
2104 @node Distintas ediciones a partir de una misma fuente
2105 @subsection Distintas ediciones a partir de una misma fuente
2106 @translationof Different editions from one source
2108 Se pueden usar varios métodos para generar la producción de distintas
2109 versiones de una partitura a partir de la misma fuente musical. Las
2110 variables son quizá el más útil para combinar secciones extensas de
2111 música y/o anotaciones. Las etiquetas son más útiles para seleccionar
2112 una sección de entre varias secciones de música alternativas, más
2113 cortas, y se pueden usar también para dividir piezas de música en
2116 Cualquiera que sea el método utilizado, la separación de la notación
2117 de la estructura de la partitura hará que sea más fácil cambiar la
2118 estructura dejando intacta la notación.
2121 * Uso de las variables::
2122 * Uso de etiquetas::
2123 * Uso de ajustes globales::
2126 @node Uso de las variables
2127 @unnumberedsubsubsec Uso de las variables
2128 @translationof Using variables
2130 @cindex variables, uso de las
2132 Si las secciones de la música se definen dentro de variables, se
2133 pueden reutilizar en distintas partes de la partitura, véase
2134 @rlearning{Organizar las piezas mediante variables}. Por ejemplo, una
2135 partitura vocal @notation{a cappella} con frecuencia incluye una
2136 reducción de piano de las partes para ensayar que es idéntica a la
2137 música vocal, por lo que ésta sólo se tiene que escribir una vez. Se
2138 puede combinar sobre un solo pentagrama la música de dos variables,
2139 véase @ref{Combinación automática de las partes}. He aquí un ejemplo:
2141 @lilypond[verbatim,quote]
2142 sopranoMusic = \relative c'' { a4 b c b8( a) }
2143 altoMusic = \relative g' { e4 e e f }
2144 tenorMusic = \relative c' { c4 b e d8( c) }
2145 bassMusic = \relative c' { a4 gis a d, }
2146 allLyrics = \lyricmode {King of glo -- ry }
2148 \new Staff = "Soprano" \sopranoMusic
2149 \new Lyrics \allLyrics
2150 \new Staff = "Alto" \altoMusic
2151 \new Lyrics \allLyrics
2152 \new Staff = "Tenor" {
2156 \new Lyrics \allLyrics
2157 \new Staff = "Bass" {
2161 \new Lyrics \allLyrics
2164 \set Staff.printPartCombineTexts = ##f
2170 \set Staff.printPartCombineTexts = ##f
2180 Se pueden producir partituras distintas que presenten sólo las partes
2181 vocales o sólo la parte de piano, cambiando solamente los enunciados
2182 estructurales, sin modificar la notación musical.
2184 Para partituras extensas, las definiciones de variable se pueden poner
2185 en archivos separados que se incluyen más tarde, véase @ref{Inclusión de archivos de LilyPond}.
2188 @node Uso de etiquetas
2189 @unnumberedsubsubsec Uso de etiquetas
2190 @translationof Using tags
2193 @funindex \keepWithTag
2194 @funindex \removeWithTag
2195 @funindex \pushToTag
2196 @funindex \appendToTag
2198 @cindex mantener música etiquetada
2199 @cindex quitar música etiquetada
2200 @cindex división en música etiquetada
2202 La instrucción @code{\tag #'@var{parteA}} marca una expresión musical
2203 con el nombre @var{parteA}. Las expresiones etiquetadas de esta
2204 manera se pueden seleccionar o filtrar más tarde por su nombre, usando
2205 bien @code{\keepWithTag #'@var{nombre}} o bien @code{\removeWithTag
2206 #'@var{nombre}}. El resultado de la aplicación de estos filtros a la
2207 música etiquetada es como sigue:
2209 @multitable @columnfractions .5 .5
2213 Música etiquetada precedida de @code{\keepWithTag #'@var{nombre}}
2214 o de @code{\keepWithTag #'(@var{nombre1} @var{nombre2}@dots{})}
2215 @tab Se incluye la música no etiquetada y la música etiquetada con
2216 el nombre o nombres de etiqueta dados; se excluye la música
2217 etiquetada con cualquier otro nombre de etiqueta.
2219 Música etiquetada precedida de
2220 @code{\removeWithTag #'@var{nombre}} o
2221 @code{\removeWithTag #'(@var{nombre1} @var{nombre2}@dots{})}
2223 Se incluye la música no etiquetada y la música que no está
2224 etiquetada con ninguno de los nombres de etiqueta dados; se
2225 excluye la música etiquetada con los nombres de etiqueta dados.
2227 Música etiquetada no precedida de @code{\keepWithTag} ni de
2228 @code{\removeWithTag}
2229 @tab Se incluye toda la música etiquetada y no etiquetada.
2232 Los argumentos de las instrucciones @code{\tag}, @code{\keepWithTag} y
2233 @code{\removeWithTag} deben ser un símbolo (como @code{#'partitura} o
2234 @code{#'parte}), seguido de una expresión musical.
2236 En el ejemplo siguiente vemos dos versiones de una pieza musical, una
2237 que muestra trinos con la notación usual y otra con los trinos
2238 expandidos explícitamente:
2240 @lilypond[verbatim,quote]
2241 music = \relative g' {
2243 \tag #'trills { d8.\trill }
2244 \tag #'expand { \repeat unfold 3 { e32 d } }
2249 \keepWithTag #'trills \music
2252 \keepWithTag #'expand \music
2257 De forma alternativa, a veces es más fácil excluir secciones de música:
2259 @lilypond[verbatim,quote]
2260 music = \relative g' {
2262 \tag #'trills { d8.\trill }
2263 \tag #'expand {\repeat unfold 3 { e32 d } }
2268 \removeWithTag #'expand
2272 \removeWithTag #'trills
2277 El filtrado con etiquetas se puede aplicar a articulaciones, textos,
2281 -\tag #'@var{mi-etiqueta}
2284 a una articulación. Por ejemplo, esto define una nota con una
2285 indicación opcional de digitación y una nota con una anotación
2290 c1-\tag #'warn ^"¡Ojo!"
2293 Se pueden poner varias etiquetas sobre expresiones con varias entradas
2294 de @code{\tag}, o combinando varias etiquetas en una lista de símbolos:
2296 @lilypond[quote,verbatim]
2297 music = \relative c'' {
2298 \tag #'a \tag #'both { a4 a a a }
2299 \tag #'(b both) { b4 b b b }
2302 \keepWithTag #'a \music
2303 \keepWithTag #'b \music
2304 \keepWithTag #'both \music
2308 Se pueden aplicar varios filtros @code{\removeWithTag} a una sola
2309 expresión musical para quitar varias secciones etiquetadas con
2310 nombres distintos. De forma alternativa, podemos usar una sola
2311 instrucción @code{\removeWithTag} con una lista de etiquetas.
2313 @lilypond[verbatim,quote]
2314 music = \relative c'' {
2315 \tag #'A { a4 a a a }
2316 \tag #'B { b4 b b b }
2317 \tag #'C { c4 c c c }
2318 \tag #'D { d4 d d d }
2324 \removeWithTag #'(B C)
2329 Dos o más filtros @code{\keepWithTag} aplicados a una sola
2330 expresión musical producen la eliminación de @emph{todas} las
2331 secciones etiquetadas, porque el primer filtro quita todas las
2332 secciones etiquetadas excepto la que se nombra, y el segundo
2333 filtro elimina incluso esa sección etiquetada. Por lo general,
2334 querrá usar una sola instrucción @code{\keepWithTag} con una lista
2335 de varias etiquetas: de esta forma solamente se suprimirán las
2336 secciones etiquetadas que no aparezcan en @emph{ninguna} de las
2339 A veces podemos desear dividir la música en un determinado lugar
2340 dentro de una expresión musical existente. Podemos usar
2341 @code{\pushToTag} y @code{\appendToTag} para añadir material
2342 delante o al final de los @code{elements} de una construcción
2343 musical existente. No toda construcción musical tiene la parte
2344 @code{elements}, pero las músicas secuenciaes y simultáneas son
2345 dos apuestas seguras:
2347 @lilypond[verbatim,quote]
2348 test = { \tag #'here { \tag #'here <<c''>> } }
2351 \pushToTag #'here c'
2352 \pushToTag #'here e'
2353 \pushToTag #'here g' \test
2354 \appendToTag #'here c'
2355 \appendToTag #'here e'
2356 \appendToTag #'here g' \test
2360 Las dos instrucciones admiten una etiqueta, el material que dividir en
2361 cada ocurrencia de la etiqueta, y la expresión etiquetada. Las
2362 instrucciones aseguran que se copia todo lo que cambian, de forma que
2363 el código original @code{\test} retiene su significado.
2366 Manual de aprendizaje:
2367 @rlearning{Organizar las piezas mediante variables}.
2369 Referencia de la notación:
2370 @ref{Combinación automática de las partes},
2371 @ref{Inclusión de archivos de LilyPond}.
2374 Al llamar a @code{\relative} sobre una expresión musical obtenida
2375 mediante el filtrado de música con las instrucciones
2376 @code{\keepWithTag} o @code{\removeWithTag}, podría ocurrir que
2377 cambiaran las relaciones de octava, dado que solo se tendrán en
2378 cuenta las alturas de las notas que efectivamente permanecen en la
2379 expresión filtrada. La aplicación de @code{\relative} en primer
2380 lugar, antes de @code{\keepWithTag} o de @code{\removeWithTag},
2381 evita este peligro porque en este caso @code{\relative} actúa
2382 sobre todas las notas tal y como se introducen.
2385 @node Uso de ajustes globales
2386 @unnumberedsubsubsec Uso de ajustes globales
2387 @translationof Using global settings
2389 @cindex include-settings
2391 Se pueden incluir ajustes globales a partir de un archivo distinto:
2394 lilypond -dinclude-settings=MIS_AJUSTES.ly MI_PARTITURA.ly
2397 En archivos diferentes se pueden almacenar grupos de ajustes como
2398 el tamaño de la página o las fuentes tipográficas. Ello permite
2399 hacer diferentes ediciones de la mism a partitura así como aplicar
2400 ajustes estándar a muchas partituras, simplemente por medio de la
2401 especificación del archivo de ajustes adecuado.
2403 Esta técnica también funciona bien con el uso de hojas de estilo,
2404 como se estudia en @rlearning{Hojas de estilo}.
2407 Manual de aprendizaje:
2408 @rlearning{Organizar las piezas mediante variables},
2409 @rlearning{Hojas de estilo}.
2411 Referencia de la notación:
2412 @ref{Inclusión de archivos de LilyPond}.
2415 @node Caracteres especiales
2416 @subsection Caracteres especiales
2417 @translationof Special characters
2419 @cindex caracteres especiales
2420 @cindex caracteres no ASCII
2423 * Codificación del texto::
2429 @node Codificación del texto
2430 @unnumberedsubsubsec Codificación del texto
2431 @translationof Text encoding
2435 LilyPond usa el conjunto de caracteres definido por el consorcio
2436 Unicode y la norma ISO/IEC 10646. Define un nombre único y un código
2437 para los conjuntos de caracteres que se utilizan en prácticamente
2438 todos los idiomas modernos y también en muchos otros. Unicode se
2439 puede implementar utilizando varios esquemas de codificación
2440 distintos. LilyPond usa la codificación UTF-8 (UTF son las siglas de
2441 @emph{Unicode Transformation Format}, o formato de transformación de
2442 Unicode) que representa todos los caracteres comunes de Latin en un
2443 solo byte, y representa otros caracteres usando un formato de longitud
2444 variable de hasta cuatro bytes.
2446 El aspecto visual real de los caracteres viene determinado por los
2447 glifos que se definen en las fuentes tipográficas concretas que se
2448 tengan disponibles: una fuente tipográfica define la asignación de un
2449 subconjunto de los códigos de Unicode a glifos. LilyPond usa la
2450 biblioteca Pango para representar y disponer tipográficamente textos
2453 LilyPond no realiza ninguna conversión en la codificación de la
2454 entrada. Esto significa que cualquier text, ya sea el título, la
2455 letra de la canción o una instrucción musical que contenga caracteres
2456 distintos a los del conjunto ASCII, se deben codificar en UTF-8. La
2457 forma más fácil de escribir dicho texto es utilizar un editor
2458 preparado para Unicode y guardar el archivo con la codificación UTF-8.
2459 Casi todos los editores modernos populares contemplan el UTF-8, por
2460 ejemplo lo hacen vim, Emacs, jEdit, y GEdit. Todos los sistemas MS
2461 Windows posteriores a NT usan Unicode como codificación de caracteres
2462 nativa, de manera que incluso el accesorio Bloc de Notas (Notepad)
2463 puede editar y guardar un archivo en el formato UTF-8. Una
2464 alternativa más funcional para Windows es BabelPad.
2466 Si un archivo de entrada que contiene un carácter que no es ASCII, no
2467 se guarda en el formato UTF-8, se genera el mensaje de error
2470 FT_Get_Glyph_Name () error: argumento inválido
2473 He aquí un ejemplo que muestra texto cirílico, hebreo y portugués:
2476 %c No verbatim here as the code does not display correctly in PDF
2478 bulgarian = \lyricmode {
2479 Жълтата дюля беше щастлива, че пухът, който цъфна, замръзна като гьон.
2483 hebrew = \lyricmode {
2484 זה כיף סתם לשמוע איך תנצח קרפד עץ טוב בגן.
2488 portuguese = \lyricmode {
2489 à vo -- cê uma can -- ção legal
2495 \addlyrics { \bulgarian }
2496 \addlyrics { \hebrew }
2497 \addlyrics { \portuguese }
2502 @unnumberedsubsubsec Unicode
2503 @translationof Unicode
2507 Para introducir un carácter aislado para el que se conoce el punto de
2508 código Unicode pero no está disponible en el editor que se está
2509 usando, use @code{\char ##xhhhh} o bien @code{\char #dddd} dentro de
2510 un bloque @code{\markup}, donde @code{hhhh} es el código hexadecimal
2511 del carácter en cuestión y @code{dddd} es su valor decimal
2512 correspondiente. Pueden omitirse los ceros iniciales, pero es
2513 costumbre indicar los cuatro caracteres en la representación
2514 hexadecimal (observe que @emph{no} debe utilizarse la codificación
2515 UTF-8 del punto de código Unicode después de @code{\char}, pues la
2516 codificación UTF-8 contiene bits adicionales que indican el número de
2517 octetos). Hay tablas de códigos Unicode y un índice de nombres de
2518 caracteres que da el punto de código en hexadecimal para cualquier
2519 carácter en el portal del Consorcio Unicode,
2520 @uref{http://www.unicode.org/}.
2522 Por ejemplo, tanto @code{\char ##x03BE} como @code{\char #958}
2523 insertan el carácter Unicode U+03BE, que tiene el nombre Unicode
2524 @qq{Letra griega Xi pequeña}.
2526 Se puede escribir de esta forma cualquier punto de código Unicode, y
2527 si todos los caracteres especiales se escriben en este formato no es
2528 necesario guardar el archivo de entrada en formato UTF-8. Por
2529 supuesto, debe estar instalada y estar disponible para LilyPond una
2530 fuente tipográfica que contenga codificados todos estos caracteres.
2532 El ejemplo siguiente muestra valores hexadecimales Unicode que se usan
2533 en cuatro lugares: en una llamada de ensayo, como texto de
2534 articulación, en la letra y como texto independiente bajo la
2537 @lilypond[quote,verbatim]
2540 c1 \mark \markup { \char ##x03EE }
2541 c1_\markup { \tiny { \char ##x03B1 " to " \char ##x03C9 } }
2543 \addlyrics { O \markup { \concat { Ph \char ##x0153 be! } } }
2545 \markup { "Copyright 2008--2012" \char ##x00A9 }
2548 @cindex copyright, símbolo de
2550 Para escribir el símbolo de copyright en la nota de créditos, utilice:
2554 copyright = \markup @{ \char ##x00A9 "2008" @}
2559 @node Alias de ASCII
2560 @unnumberedsubsubsec Alias de ASCII
2561 @translationof ASCII aliases
2563 Se puede incluir una lista de alias de ASCII para caracteres
2566 @lilypond[quote,verbatim]
2568 #(include-special-characters)
2571 \markup "&flqq; – &OE;uvre incomplète… &frqq;"
2574 \new Staff { \repeat unfold 9 a'4 }
2576 This is al -- so wor -- kin'~in ly -- rics: –_&OE;…
2581 "The replacement can be disabled:"
2582 "– &OE; …"
2583 \override #'(replacement-alist . ()) "– &OE; …"
2587 También podemos hacer nuestros propios alias, ya sea de forma global:
2589 @lilypond[quote,verbatim]
2591 #(add-text-replacements!
2592 '(("100" . "hundred")
2593 ("dpi" . "dots per inch")))
2595 \markup "A 100 dpi."
2600 @lilypond[quote,verbatim]
2601 \markup \replace #'(("100" . "hundred")
2602 ("dpi" . "dots per inch")) "A 100 dpi."
2606 Referencia de la notación:
2607 @ref{Lista de caracteres especiales}.
2609 Archivos instalados:
2610 @file{ly/text-replacements.ly}.
2613 @node Controlar la salida
2614 @section Controlar la salida
2615 @translationof Controlling output
2618 * Extracción de fragmentos de música::
2619 * Saltar la música corregida::
2620 * Formatos de salida alternativos::
2621 * Sustituir la tipografía de la notación::
2625 @node Extracción de fragmentos de música
2626 @subsection Extracción de fragmentos de música
2627 @translationof Extracting fragments of music
2629 Es posible citar pequeños fragmentos de una partitura grande
2630 directamente a partir de la salida. Puede compararse con la
2631 separación de una pieza de una partitura, recortándola con tijeras.
2633 Esto se hace definiendo los compases que se deben recortar. Por
2634 ejemplo, la inclusión de la siguiente definición
2641 (make-rhythmic-location 5 1 2)
2642 (make-rhythmic-location 7 3 4)))
2647 extrae un fragmento empezando por la mitad del quinto compás y
2648 finalizando en el séptimo compás. El significado de @code{5 1 2} es:
2649 después de una blanca (1/2) en el compás 5, y el de @code{7 3 4}
2650 después de tres negras del compás 7.
2652 Se pueden definir más zonas de recorte añadiendo más parejas de
2653 definición de tiempo rhythmic-location a la lista.
2655 Para poder utilizar esta funcionalidad, LilyPond se debe invocar con
2656 la opción @option{-dclip-systems}. Los recortes aparecen en la salida
2657 como archivos EPS, y se convierten en PDF y PNG si estos formatos
2658 también están activados.
2660 Para ver más información sobre los formatos de salida, consulte
2661 @rprogram{Invocar a LilyPond}.
2664 @node Saltar la música corregida
2665 @subsection Saltar la música corregida
2666 @translationof Skipping corrected music
2668 @funindex skipTypesetting
2669 @funindex showFirstLength
2670 @funindex showLastLength
2672 Al escribir o copiar música, normalmente sólo es interesante de ver y
2673 corregir la música cercana al final (donde estamos añadiendo las
2674 notas). Para acelerar este proceso de corrección, es posible saltar
2675 la composición tipográfica de todos excepto unos pocos de los últimos
2676 compases. Esto se consigue poniendo
2679 showLastLength = R1*5
2680 \score @{ @dots{} @}
2684 en nuestro archivo fuente. Esto hará que se tracen sólo los últimos
2685 cinco compases (suponiendo un compás de 4/4) de cada una de las
2686 partituras @code{\score} del archivo de entrada. Para piezas largas,
2687 el tipografiado de únicamente una parte pequeña es con frecuencia un
2688 orden de magnitud más rápido que el de la obra completa. Si estamos
2689 trabajando sobre el principio de una partitura que ya hemos
2690 tipografiado (p.ej., para añadir una parte instrumental nueva),
2691 también puede ser útil la propiedad @code{showFirstLength}.
2693 Este mecanismo de pasar por alto partes de un partitura se puede
2694 controlar con un grano más fino mediante la propiedad
2695 @code{Score.skipTypesetting}. Cuando su valor está establecido, no se
2696 lleva a cabo ningún tipografiado en absoluto.
2698 Esta propiedad se usa también para controlar la salida al archivo
2699 MIDI. Observe que pasa por alto todos los eventos, incluidos el tempo
2700 y los cambios de instrumento. Está usted advertido.
2702 @lilypond[quote,relative=2,ragged-right,verbatim]
2704 \set Score.skipTypesetting = ##t
2706 \set Score.skipTypesetting = ##f
2710 En música polifónica, @code{Score.skipTypesetting} afecta a todas las
2711 voces y pentagramas, ahorrando más tiempo incluso.
2714 @node Formatos de salida alternativos
2715 @subsection Formatos de salida alternativos
2716 @translationof Alternative output formats
2718 @cindex salida de gráficos de vector escalables
2720 @cindex salida de PostScript encapsulado
2722 @cindex PostScript encapsulado, salida de
2724 Los formatos de salida predeterminados para la partitura impresa son
2725 el formato de documento portátil (PDF) y PostScript (PS). Los
2726 formatos de salida Gráficos de vector escalables (SVG), PostScript
2727 encapsulado (EPS) y Gráficos de red portátiles (PNG) también están
2728 disponibles a través de opciones de la línea de órdenes, véase
2729 @rprogram{Opciones básicas de la línea de órdenes para LilyPond}.
2732 @node Sustituir la tipografía de la notación
2733 @subsection Sustituir la tipografía de la notación
2734 @translationof Replacing the notation font
2736 Gonville es una alternativa a la tipografía Feta que se utiliza en
2737 LilyPond y se puede descargar de:
2739 @uref{http://www.chiark.greenend.org.uk/~sgtatham/gonville/ ,http://www.chiark.greenend.org.uk/~sgtatham/gonville/}
2742 Aquí presentamos algunos compases de muestra tipografiados con la
2745 @c NOTE: these images are a bit big, but that's important
2746 @c for the font comparison. -gp
2747 @sourceimage{Gonville_after,15cm,,}
2749 Aquí hay unos compases de muestra tipografiados en la fuente Feta de
2752 @sourceimage{Gonville_before,15cm,,}
2754 @subsubheading Instrucciones de instalación para MacOS
2756 Descargue y extraiga el archivo zip. Copie la carpeta @code{lilyfonts}
2757 a @file{@var{SHARE_DIR}/lilypond/current}; para más información,
2758 consulte @rlearning{Otras fuentes de información}. Renombre la carpeta
2759 @code{fonts} existente a @code{fonts_orig} y la carpeta
2760 @code{lilyfonts} a @code{fonts}. Para volver a la fuente Feta,
2761 invierta el proceso.
2764 Manual de aprendizaje:
2765 @rlearning{Otras fuentes de información}.
2769 Gonville no se puede usar para tipografiar notación de @q{Música
2770 Antigua} y es probable que cualquier nuevo glifo en versiones
2771 posteriores de LilyPond no existan en la familia
2772 tipográfica Gonville. Diríjase a la página web del autor para obtener más
2773 información sobre éste y otros asuntos, entre ellos el régimen de
2774 licencias de Gonville.
2778 @section Salida MIDI
2779 @translationof MIDI output
2784 El MIDI (Musical Instrument Digital Interface, Interfase Digital para
2785 Instrumentos Musicales) es un estándar para interconectar y controlar
2786 instrumentos musicales electrónicos. Un archivo o secuencia MIDI es
2787 una serie de notas dentro de un conjunto de pistas. No es un archivo
2788 de sonidos reales; se necesita un programa reproductor especial para
2789 traducir la serie de notas en sonidos de verdad.
2791 Cualquier música se puede convertir a archivos MIDI, de manera que
2792 podamos escuchar lo que hayamos introducido. Esto es muy conveniente
2793 para comprobar la corrección de la música; las octavas equivocadas o
2794 las alteraciones erróneas se ponen de relieve muy claramente al
2795 escuchar la salida MIDI.
2797 La salida estándar de MIDI es un poco primitiva; de forma opcional, se
2798 encuentra disponible una salida MIDI mejorada y mucho más realista,
2799 por medio de @ref{El script Articulate}.
2801 La salida MIDI reserva un canal por cada pentagrama, y reserva
2802 el canal 10 para la percusión. Sólo hay 16 canales MIDI por cada
2803 dispositivo, por lo que si la partitura tiene más de 15 pautas, los
2804 canales MIDI se reutilizarán.
2807 * Crear archivos MIDI::
2808 * Instrumentos MIDI::
2810 * ¿Qué sale por el MIDI?::
2811 * Repeticiones y MIDI::
2812 * Control de los matices en el MIDI::
2813 * Percusión en MIDI::
2814 * El script Articulate::
2817 @node Crear archivos MIDI
2818 @subsection Crear archivos MIDI
2819 @translationof Creating MIDI files
2821 Para crear un MIDI a partir de una pieza de música, escriba un bloque
2822 @code{\midi} en la partitura, por ejemplo:
2826 @var{@dots{}música@dots{}}
2831 Si hay un bloque @code{\midi} dentro de un @code{\score} que no tenga
2832 ningún bloque @code{\layout}, solamente se producirá MIDI. Si se
2833 necesita una notación impresa, debe haber también un bloque
2838 @var{@dots{}música@dots{}}
2844 Se traducen correctamente a la salida MIDI la altura y duración de las
2845 notas, las ligaduras de unión, matices y cambios de tempo. Las
2846 indicaciones dinámicas, crescendi y decrescendi se traducen a niveles
2847 de volumen MIDI. Las marcas dinámicas se traducen a una fracción fija
2848 del rango de volumen MIDI disponible. Los crescendi y decrescendi
2849 hacen que el volumen varía linealmente entre sus dos extremos. El
2850 efecto de las indicaciones dinámicas sobre la salida MIDI se puede
2851 eliminar por completo, véase @ref{El bloque MIDI}.
2853 El tempo inicial y los cambios de tempo posteriores se pueden
2854 especificar utilizando la instrucción @code{\tempo} dentro de la
2855 propia notación musical. Se reflejan en cambios de tempo en la salida
2856 MIDI. Esta instrucción normalmente hace que se imprima la indicación
2857 metronómica, pero esto se puede eliminar, véase @ref{Indicaciones metronómicas}.
2858 Más abajo se describe una forma alternativa de especificar el tempo
2859 MIDI inicial o global, véase @ref{El bloque MIDI}.
2861 Debido a ciertas limitaciones de Windows, la extensión predeterminada
2862 para los archivos MIDI en Windows es @code{.mid}. Otros sistemas
2863 operativos utilizan la extensión @code{.midi}. Si prefiere una
2864 extensión diferente, inserte la siguiente línea en el nivel jerárquico
2865 superior del archivo de entrada, antes del inicio de cualquier bloque
2866 @code{\book}, @code{\bookpart} o @code{\score}:
2869 #(ly:set-option 'midi-extension "midi")
2872 La línea anterior establece la extensión predeterminada para los
2873 archivos MIDI a @code{.midi}.
2875 De forma alternativa, esta opción se puede también proporcionar en
2876 la línea de órdenes:
2879 lilypond … -dmidi-extension=midi archivoLily.ly
2885 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
2886 {changing-midi-output-to-one-channel-per-voice.ly}
2890 @c In 2.11 the following no longer seems to be a problem -td
2892 Unterminated (de)crescendos will not render properly in the midi file,
2893 resulting in silent passages of music. The workaround is to explicitly
2894 terminate the (de)crescendo. For example,
2901 will not work properly but
2904 @{ a4\< b c d\!\f @}
2911 Los cambios del volumen MIDI sólo tienen lugar al principio de la
2912 nota, por lo que los crescendi y decrescendi no pueden afectar al
2913 volumen de una sola nota.
2915 No todos los reproductores de MIDI manejan adecuadamente los
2916 cambios de tempo de la salida MIDI. Entre los reproductores que
2917 se sabe que funcionan se encuentran el Reproductor de Medios de MS
2918 Windows y @uref{http://@/timidity@/.sourceforge@/.net/,timidity}.
2920 @node Instrumentos MIDI
2921 @subsection Instrumentos MIDI
2922 @translationof MIDI Instruments
2924 @cindex instrumento, nombres de
2925 @funindex Staff.midiInstrument
2927 El instrumento MIDI que se quiere utilizar se establece fijando la
2928 propiedad @code{Staff.midiInstrument} al nombre del instrumento.
2929 El nombre se debe elegir de entre los que están en la lista que
2930 aparece en @ref{instrumentos MIDI}.
2934 \set Staff.midiInstrument = #"glockenspiel"
2935 @var{@dots{}notas@dots{}}
2940 \new Staff \with @{midiInstrument = #"cello"@} @{
2941 @var{@dots{}notas@dots{}}
2945 Si el instrumento elegido no coincide exactamente con uno de los
2946 instrumentos de la lista de instrumentos MIDI, se usará el
2947 instrumento Piano de Cola (@code{"acoustic grand"}).
2949 @node El bloque MIDI
2950 @subsection El bloque MIDI
2951 @translationof MIDI block
2955 Si se requiere una salida MIDI, debe aparecer un bloque @code{\midi}
2956 dentro de un bloque de partitura. Es análogo al bloque layout de
2957 diseño de página, pero algo más simple. Con frecuencia, el bloque
2958 @code{\midi} se deja vacío, pero puede contener reorganizaciones de
2959 contextos, definiciones de contexto nuevas o código para fijar valores
2960 de propiedades. Por ejemplo, en el ejemplo siguiente se establece el
2961 tempo inicial exportado al archivo MIDI sin hacer que se imprima una
2962 indicación de tempo:
2966 @var{@dots{}música@dots{}}
2973 En este ejemplo, el tempo se establece a 72 pulsos de negra por
2974 minuto. @code{\tempo} is actually a music command for
2975 setting properties during the interpretation of music: in the
2976 context of output definitions like a @code{\midi} block, as a matter of
2977 courtesy those are reinterpreted as if they were context modifications.
2979 @cindex MIDI, definiciones de contexto
2981 Las definiciones de contexto siguen con precisión la misma sintaxis
2982 que la de un bloque @code{\layout}. Los módulos de traducción para el
2983 sonido reciben el nombre de ejecutantes. Los contextos para la salida
2984 MIDI se definen en @file{../ly/performer-init.ly}, véase
2985 @rlearning{Otras fuentes de información}. Por ejemplo, para eliminar
2986 el efecto de los matices de la salida MIDI, inserte las líneas
2987 siguientes en el bloque @code{\midi@{ @}}.
2994 \remove "Dynamic_performer"
2999 La salida MIDI se crea sólo cuando se incluye un bloque @code{\midi}
3000 dentro de un bloque de partitura definido con una instrucción
3005 @{ @dots{}notas@dots{} @}
3011 @node ¿Qué sale por el MIDI?
3012 @subsection ¿Qué sale por el MIDI?
3013 @translationof What goes into the MIDI output?
3016 * Contemplado en el MIDI::
3017 * No contemplado en el MIDI::
3020 @node Contemplado en el MIDI
3021 @unnumberedsubsubsec Contemplado en el MIDI
3022 @translationof Supported in MIDI
3024 @cindex alturas en MIDI
3025 @cindex MIDI, alturas
3026 @cindex cuartos de tono en MIDI
3027 @cindex MIDI, cuartos de tono
3028 @cindex microtonos en MIDI
3029 @cindex MIDI, microtonos
3030 @cindex acordes, nombres de, en MIDI
3031 @cindex MIDI, nombres de
3032 @cindex duraciones en MIDI
3033 @cindex MIDI, duraciones
3034 @cindex Articlulate, scripts
3035 @cindex MIDI, articulaciones
3036 @cindex articulaciones en MIDI
3037 @cindex trinos en MIDI
3038 @cindex grupetos en MIDI
3039 @cindex rallentando en MIDI
3040 @cindex accelerando en MIDI
3043 Los siguientes elementos de notación se reflejan en la salida MIDI:
3047 @item Microtonos (véase @ref{Alteraciones accidentales}. La reproducción necesita un reproductor que contemple la curvatura de tono o @emph{pitch bend}.)
3048 @item Acordes escritos como nombres de acorde
3049 @item Ritmos escritos como duraciones de las notas, incluidos los grupos de valoración especial
3050 @item Trémolos escritos sin @q{@code{:}[@var{número}]}
3051 @item Ligaduras de unión
3052 @item Matices o indicaciones de dinámica
3053 @item Crescendi y decrescendi sobre varias notas
3054 @item Cambios de tempo insertados con una marca metronómica
3055 @item Letra de las canciones
3058 Utilizando @ref{El script Articulate}, a la lista anterior se añaden
3059 una serie de elementos:
3062 @item Articulaciones (ligaduras de expresión, picados, etc)
3063 @item Trinos, mordentes circulares
3064 @item Rallentando y accelerando
3068 @node No contemplado en el MIDI
3069 @unnumberedsubsubsec No contemplado en el MIDI
3070 @translationof Unsupported in MIDI
3072 @c TODO index as above
3074 Los siguientes elementos de notación no tienen ningún efecto sobre la
3075 salida MIDI, a no ser que utilicemos @ref{El script Articulate}:
3078 @item Duraciones escritas como anotaciones, p.ej. el swing
3079 @item Cambios de tempo escritos como anotaciones sin marca de tempo
3080 @item Staccato y otras articulaciones y ornamentos
3081 @item Ligaduras de expresión y de fraseo
3082 @item Crescendi y decrescendi sobre una nota única
3083 @item Trémolos introducidos con @q{@code{:}[@var{número}]}
3085 @item Acordes microtonales
3089 @node Repeticiones y MIDI
3090 @subsection Repeticiones y MIDI
3091 @translationof Repeats in MIDI
3093 @cindex repeticiones, expandir
3094 @funindex \unfoldRepeats
3096 Con un poco de trucaje, se puede hacer que cualquier tipo de
3097 repetición esté presente en la salida MIDI. Esto se consigue mediante
3098 la aplicación de la función musical @code{\unfoldRepeats}. Esta
3099 función cambia todas las repeticiones a repeticiones desplegadas.
3101 @lilypond[quote,verbatim]
3103 \repeat tremolo 8 { c'32 e' }
3104 \repeat percent 2 { c''8 d'' }
3105 \repeat volta 2 { c'4 d' e' f' }
3114 En partituras con varias voces, el desplegado de las repeticiones en
3115 la salida MIDI solo se produce correctamente si @emph{todas y cada
3116 una} de las voces incluye las repeticiones de manera completa y
3119 Al crear un archivo de partitura que use @code{\unfoldRepeats} para el
3120 MIDI, es necesario hacer dos bloques @code{\score}: uno para el MIDI
3121 (con repeticiones desplegadas) y otro para la notación impresa (con
3122 repeticiones de volta --primera y segunda vez--, tremolo --trémolo--,
3123 y percent --repetición de compases--). Por ejemplo,
3127 @var{@dots{}música@dots{}}
3128 \layout @{ @dots{} @}
3131 \unfoldRepeats @var{@dots{}música@dots{}}
3137 @node Control de los matices en el MIDI
3138 @subsection Control de los matices en el MIDI
3139 @translationof Controlling MIDI dynamics
3141 La dinámica en el MIDI está implementada por medio del intérprete
3142 Dynamic_performer que reside de forma predeterminada dentro del
3143 contexto Voice. Es posible controlar el volumen MIDI general, el
3144 volumen relativo de los matices dinámicos y el volumen relativo de los
3145 distintos instrumentos.
3148 * Indicaciones dinámicas::
3149 * Volumen maestro MIDI::
3150 * Balance entre instrumentos (i)::
3151 * Balance entre instrumentos (ii)::
3154 @node Indicaciones dinámicas
3155 @unnumberedsubsubsec Indicaciones dinámicas
3156 @translationof Dynamic marks
3158 Los matices o indicaciones de dinámica se traducen a una fracción
3159 fija del rango de volumen MIDI disponible. Las fracciones
3160 predeterminadas se extienden desde 0.25 para @notation{ppppp}
3161 hasta 0.95 para @notation{fffff}. El conjunto de indicaciones
3162 dinámicas y las fracciones asociadas pueden verse en
3163 @file{../scm/midi.scm}, véase @rlearning{Otras fuentes de
3164 información}. Este conjunto de fracciones se puede cambiar o
3165 extender proporcionando una función que toma como argumento una
3166 indicación dinámica y devuelve la fracción requerida, y
3167 estableciendo @code{Score.dynamicAbsoluteVolumeFunction} a esta
3170 Por ejemplo, si se requiere una indicación dinámica
3171 @notation{rinforzando}, @code{\rfz}, ésta no tiene ningún efecto
3172 predeterminado sobre el volumen MIDI, pues no está incluida en el
3173 conjunto predeterminado. De igual manera, si se define una
3174 indicación dinámica nueva con @code{make-dynamic-script}, ésta
3175 tampoco estará incluida en el conjunto predeterminado. El ejemplo
3176 siguiente muestra cómo hay que añadir el volumen MIDI para estas
3177 indicaciones dinámicas. La función Scheme establece la fracción a
3178 0.9 si se encuentra una indicación dinámica rfz, y en caso
3179 contrario llama a la función predeterminada.
3181 @lilypond[verbatim,quote]
3182 #(define (myDynamics dynamic)
3183 (if (equal? dynamic "rfz")
3185 (default-dynamic-absolute-volume dynamic)))
3189 \set Staff.midiInstrument = #"cello"
3190 \set Score.dynamicAbsoluteVolumeFunction = #myDynamics
3202 Como alternativa, si se necesitara redefinir la tabla completa de
3203 fracciones, sería mejor usar el procedimiento
3204 @notation{default-dynamic-absolute-volume} que aparece en
3205 @file{../scm/midi.scm} y la tabla asociada como modelo. El último
3206 ejemplo de esta sección muestra cómo se puede hacer esto.
3208 @node Volumen maestro MIDI
3209 @unnumberedsubsubsec Volumen maestro MIDI
3210 @translationof Overall MIDI volume
3212 El volumen general máximo y mínimo de las indicaciones dinámicas
3213 de MIDI se controla estableciendo valores para las propiedades
3214 @code{midiMinimumVolume} y @code{midiMaximumVolume} en el nivel de
3215 @code{Score}. Estas propiedades tienen efecto solamente al inicio
3216 de una voz y sobre las indicaciones dinámicas. La fracción que
3217 corresponde a cada indicación dinámica se modifica con esta
3221 midiMinimumVolume + (midiMaximumVolume - midiMinimumVolume) * fracción
3224 En el ejemplo siguiente, el rango de intensidad dinámica del
3225 volumen general MIDI está limitado al intervalo desde 0.2 hasta
3228 @lilypond[verbatim,quote]
3234 \set Staff.midiInstrument = #"flute"
3235 \new Voice \relative c''' {
3243 \set Staff.midiInstrument = #"clarinet"
3244 \new Voice \relative c'' {
3256 midiMinimumVolume = #0.2
3257 midiMaximumVolume = #0.5
3263 @node Balance entre instrumentos (i)
3264 @unnumberedsubsubsec Balance entre instrumentos (i)
3265 @translationof Equalizing different instruments (i)
3267 Si las propiedades de volumen MIDI máximo y mínimo están
3268 establecidas en el contexto @code{Staff} se pueden controlar los
3269 volúmenes relativos de los instrumentos MIDI. Esto proporciona un
3270 ecualizador de instrumentos básico que puede realzar
3271 significativamente la calidad de la salida MIDI.
3273 En este ejemplo se reduce el volumen del clarinete con relación al
3276 @lilypond[verbatim,quote]
3282 \set Staff.midiInstrument = #"flute"
3283 \set Staff.midiMinimumVolume = #0.7
3284 \set Staff.midiMaximumVolume = #0.9
3285 \new Voice \relative c''' {
3293 \set Staff.midiInstrument = #"clarinet"
3294 \set Staff.midiMinimumVolume = #0.3
3295 \set Staff.midiMaximumVolume = #0.6
3296 \new Voice \relative c'' {
3311 @node Balance entre instrumentos (ii)
3312 @unnumberedsubsubsec Balance entre instrumentos (ii)
3313 @translationof Equalizing different instruments (ii)
3315 Si las propiedades de volumen MIDI máximo y mínimo no están
3316 establecidas, de forma predeterminada LilyPond aplica un pequeño
3317 grado de ecualización a algunos instrumentos. Los instrumentos y
3318 la ecualización que se aplica se muestra en la tabla
3319 @notation{instrument-equalizer-alist} en @file{../scm/midi.scm}.
3321 El ecualizador básico predeterminado se puede sustituir
3322 estableciendo @code{instrumentEqualizer} en el contexto
3323 @code{Score} a un procedimiento Scheme nuevo que acepte el nombre
3324 de un instrumento MIDI como único argumento y devuelva un par de
3325 fracciones que dan los volúmenes máximo y mínimo que se aplican a
3326 dicho instrumento. Esta sustitución se hace de la misma forma que
3327 mostramos para restablecer la fracción de volumen absoluto
3328 @code{dynamicAbsoluteVolumeFunction} al comienzo de esta sección.
3329 El ecualizador predeterminado,
3330 @notation{default-instrument-equalizer}, en
3331 @file{../scm/midi.scm}, muestra cómo se puede escribir tal
3334 El ejemplo siguiente establece los volúmenes relativos de la
3335 flauta y del clarinete a los mismos valores que el ejemplo
3338 @lilypond[verbatim,quote]
3339 #(define my-instrument-equalizer-alist '())
3341 #(set! my-instrument-equalizer-alist
3344 ("flute" . (0.7 . 0.9))
3345 ("clarinet" . (0.3 . 0.6)))
3346 my-instrument-equalizer-alist))
3348 #(define (my-instrument-equalizer s)
3349 (let ((entry (assoc s my-instrument-equalizer-alist)))
3358 \set Score.instrumentEqualizer = #my-instrument-equalizer
3359 \set Staff.midiInstrument = #"flute"
3360 \new Voice \relative c''' {
3368 \set Staff.midiInstrument = #"clarinet"
3369 \new Voice \relative c'' {
3384 @c Delete when satisfied this is adequately covered elsewhere -td
3386 @n ode Microtones in MIDI
3387 @s ubsection Microtones in MIDI
3389 @cindex microtones in MIDI
3391 Microtones consisting of half sharps and half flats are exported
3392 to the MIDI file and render correctly in MIDI players which support
3393 pitch bending. See @ref{Nombres de las notas en otros idiomas}. Here is
3394 an example showing all the half sharps and half flats. It can be
3395 copied out and compiled to test microtones in your MIDI player.
3397 @lilypond[verbatim,quote]
3414 @node Percusión en MIDI
3415 @subsection Percusión en MIDI
3416 @translationof Percussion in MIDI
3418 La notación de los instrumentos de percusión se realiza
3419 normalmente en un contexto @code{DrumStaff} y cuando se hace de
3420 esta forma se les da salida correctamente por el canal
3421 MIDI@tie{}10, pero ciertos instrumentos de percusión de altura
3422 determinada, como el xilófono, marimba, vibráfono, timbales, etc.,
3423 se tratan como instrumentos @qq{normales} y la música para estos
3424 instrumentos se debe introducir en contextos de @code{Staff}
3425 normales, no en un contexto @code{DrumStaff}, para obtener la
3426 salida MIDI correcta.
3428 Ciertos sonidos de altura indeterminada que están incluidos en el
3429 estándar General MIDI, como el tom melódico, el tambor taiko, los
3430 tambores sintéticos, etc., no se pueden acceder a través del canal
3431 MIDI@tie{}10, por lo que la notación para dichos instrumentos se
3432 debe introducir también en un contexto normal de @code{Staff},
3433 utilizando las alturas normales adecuadas.
3435 Muchos instrumentos de percusión no están incluidos dentro del
3436 estándar General MIDI, p.ej. las castañuelas. El método más fácil
3437 (aunque no satisfactorio) de producir una salida MIDI al escribir
3438 para estos instrumentos es sustituirlos por el sonido más parecido
3439 del conjunto estándar.
3441 @c TODO Expand with examples, and any other issues
3445 Debido a que el estándar General MIDI no contiene golpes de aro
3446 (@emph{rim shots}), para este propósito se utiliza en su lugar el
3447 golpe lateral de baqueta (@emph{sidestick}).
3450 @node El script Articulate
3451 @subsection El script Articulate
3452 @translationof The Articulate script
3454 Es posible obtener una salida MIDI más real si se utiliza el
3455 script Articulate. Éste trata de tener en cuenta las
3456 articulaciones (ligaduras de expresión, picados, etc), mediante la
3457 sustitución de las notas con secuencias musicales de silencios y
3458 notas escaladas en el tiempo de forma apropiada. También trata de
3459 desplegar los trinos, grupetos circulares, etc. y responder a las
3460 indicaciones de rallentando y accelerando.
3462 Para utilizar el script Articulate, tenemos que incluirlo al
3463 principio de nuestro archivo de entrada:
3466 \include "articulate.ly"
3469 y en la sección @code{\score}, hacer lo siguiente:
3472 \unfoldRepeats \articulate <<
3473 resto de la partitura@dots{}
3477 Después de alterar el código de entrada de esta manera el
3478 resultado visual se altera profundamente, pero el bloque
3479 @code{\midi} estándar produce un archivo MIDI mejorado.
3481 Si bien no es esencial para que funcione el script Articulate,
3482 podemos insertar la instrucción @code{\unfoldRepeats} según
3483 aparece en el ejemplo anterior, dado que habilita la ejecución de
3484 abreviaturas tales como los @notation{trinos}.
3488 Articulate acorta los acordes, y ciertos fragmentos de música
3489 (especialmente la música de órgano) es posible que suene peor.
3492 @node Extraer información musical
3493 @section Extraer información musical
3494 @translationof Extracting musical information
3496 Además de crear un resultado visual y MIDI, LilyPond es capaz de
3497 presentar información musical en forma de texto.
3500 * Impresión del código de notación de LilyPond::
3501 * Impresión de las expresiones musicales de Scheme::
3502 * Guardar los eventos musicales en un archivo::
3506 @node Impresión del código de notación de LilyPond
3507 @subsection Displaying LilyPond notation
3508 @translationof Displaying LilyPond notation
3510 @funindex \displayLilyMusic
3511 La impresión textual de una expresión musical en notación de
3512 LilyPond puede hacerse con la función musical
3513 @code{\displayLilyMusic}. Para ver el resultado, lo más usual es
3514 llamar a LilyPond mediante la línea de órdenes. Por ejemplo,
3518 \displayLilyMusic \transpose c a, @{ c4 e g a bes @}
3522 imprime lo siguiente:
3525 @{ a,4 cis e fis g @}
3528 De forma predeterminada, LilyPond imprime estos mensajes en la
3529 consola junto al resto de los mensajes de la compilación de
3530 LilyPond. Para discernir entre estos mensajes y guardar el
3531 resultado de @code{\displayLilyMusic}, redireccione la salida
3535 lilypond archivo.ly >resultado.txt
3539 @node Impresión de las expresiones musicales de Scheme
3540 @subsection Impresión de las expresiones musicales de Scheme
3541 @translationof Displaying scheme music expressions
3543 Véase @rextend{Presentación de las expresiones musicales}.
3546 @node Guardar los eventos musicales en un archivo
3547 @subsection Guardar los eventos musicales en un archivo
3548 @translationof Saving music events to a file
3550 Los eventos musicales se pueden guardar en un archivo pentagrama a
3551 pentagrama mediante la inclusión de un archivo en nuestra
3552 partitura principal.
3555 \include "event-listener.ly"
3558 De esta forma se crean uno o más archivos llamados
3559 @file{FILENAME-STAFFNAME.notes} ó
3560 @file{FILENAME-unnamed-staff.notes} para cada pentagrama. Observe
3561 que si tiene más de un pentagrama sin nombre, los eventos de todos
3562 los pentagramas se mezclarán entre sí dentro del mismo archivo.
3563 El resultado tiene el aspecto siguiente:
3566 0.000 note 57 4 p-c 2 12
3568 0.250 note 62 4 p-c 7 12
3569 0.500 note 66 8 p-c 9 12
3570 0.625 note 69 8 p-c 14 12
3575 La sintaxis consiste en una línea delimitada por caracteres de
3576 tabulación, con dos campos fijos en cada línea seguidos de
3577 parámetros opcionales.
3580 @var{tiempo} @var{tipo} @var{@dots{}parámetros@dots{}}
3583 Esta información se puede leer fácilmente por parte de otros
3584 programas como guiones de Python, y pueden ser muy útiles para
3585 aquellos investigadores que desean realizar un análisis musical o
3586 hacer experimientos de reproducción con LilyPond.
3589 No todos los eventos musicales de lilypond están contemplados por
3590 @file{event-listener.ly}. Se pretende que sea una @qq{prueba de
3591 concepto} bien realizada. Si algunos eventos que quiere ver no
3592 aparecen incluidos, copie @file{event-listener.ly} en su carpeta
3593 de lilypond y modifique el archivo de forma que produzca la
3594 información que desea.