1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
4 Translation of GIT committish: 18f6f13f39b25f28679fe2073763151008ca3366
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,,El bloque @code{@bs{}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,,El bloque @code{@bs{}layout}}.
549 @node Títulos y encabezamientos
550 @section Títulos y encabezamientos
551 @translationof Titles and headers
553 Casi toda la música impresa tiene un título y el nombre del
554 compositor; ciertas piezas tienen mucha más información.
557 * Crear títulos encabezamientos y pies de página::
558 * Títulos encabezamientos y pies de página personalizados::
559 * Crear notas al pie::
560 * Referencia a números de página::
565 @node Crear títulos encabezamientos y pies de página
566 @subsection Crear títulos, encabezamientos y pies de página
567 @translationof Creating titles headers and footers
570 * Explicación de los títulos::
571 * Presentación predeterminada de los títulos de partes de libro y partitura::
572 * Disposición predeterminada de las cabeceras y pies de página::
576 @node Explicación de los títulos
577 @unnumberedsubsubsec Explicación de los títulos
578 @translationof Titles explained
580 Cada bloque @code{\book} de un solo archivo de entrada produce un
581 archivo de salida distinto, véase @ref{Estructura del archivo}.
582 Dentro de cada archivo de salida están disponibles tres tipos de zonas
583 para títulos: @emph{Títulos de libro} al principio de cada libro,
584 @emph{Títulos de parte de libro} al principio de cada
585 parte de un libro y @emph{Títulos de partitura} al comienzo de una
588 Los valores de los campos para encabezamientos tales como @code{title}
589 (para el título) y @code{composer} (para el autor) se establecen en
590 bloques @code{\header} (para ver la sintaxis de los bloques
591 @code{\header} y una lista completa de los campos disponibles de forma
592 predeterminada, consulte @ref{Presentación predeterminada de los
593 títulos de partes de libro y partitura}). Tanto los títulos de libro como
594 los títulos de parte de libro y los títulos de partitura pueden
596 campos, aunque de forma predeterminada los campos de los títulos de
597 partitura se limitan a @code{piece} (pieza) y @code{opus}.
599 Los bloques @code{\header} se pueden situar en cuatro lugares
600 distintos para formar una jerarquía descendente de bloques
606 Al principio del archivo de entrada, antes de cualquier otro bloque
607 @code{\book}, @code{\bookpart} o @code{\score}.
610 Dentro de un bloque @code{\book} pero fuera de los bloques
611 @code{\bookpart} y @code{\score} que están dentro de ese libro.
614 Dentro de un bloque @code{\bookpart} pero fuera de cualquier bloque
615 @code{\score} dentro de dicha parte de libro.
618 Después de la expresión musical de un bloque @code{\score}.
622 Los valores de los campos se fitran a través de esta jerarquía,
623 persistiendo aquellos que se establecen más arriba a no ser que se
624 sobreescriban por un valor establecido más abajo en la jerarquía, y
630 El título de un libro deriva de los campos establecidos al
631 principio del archivo de entrada, modificado por campos
632 establecidos en el bloque @code{\book}. Los campos resultantes se
633 usan para imprimir el título de libro para dicho libro, siempre y
634 cuando haya otro material que genere una página al comienzo del
635 libro, antes de la primera parte de libro. Es suficiente una sola
636 instrucción @code{\pageBreak}.
639 Un título de parte de libro se deriva de los campos fijados al
640 principio del archivo de entrada, modificado por los campos
641 establecidos dentro del bloque @code{\book}, y posteriormente
642 modificado por los campos que se fijan dentro del bloque
643 @code{\bookpart}. Los valores resultantes se usan para imprimir el
644 título de parte de libro para esa parte.
647 Un título de partitura se deriva de los campos que se fijan al
648 principio del archivo de entrada, modificados por los campos fijados
649 dentro del bloque @code{\book}, posteriormente modificados por los
650 campos que se fijan dentro del bloque @code{\bookpart} y finalmente
651 modificados por los campos establecidos dentro del bloque
652 @code{\score}. Los valores restulantes se utilizan para imprimir el
653 título de partitura. Observe, sin embargo, que de forma
654 predeterminada solamente se imprimen los campos @code{piece} y
655 @code{opus} en los títulos de partitura a no ser que la variable de
656 @code{\paper}, @code{print-all-headers}, tenga el valor @code{#t}.
660 @warning{Recuerde que al poner un bloque @bs{}@code{header} dentro de
661 un bloque @bs{}@code{score}, la expresión musical debe aparecer antes
662 del bloque @bs{}@code{header}.}
664 No es necesario aportar bloques @code{\header} en los cuatro lugares:
665 cualquiera de ellos o incluso todos pueden omitirse. De forma
666 similar, los archivos de entrada sencillos pueden omitir los bloques
667 @code{\book} y @code{\bookpart}, dejando que se creen de forma
670 Si el lobro solamente tiene una partitura, el bloque @code{\header}
671 debiera situarse normalmente al principio del archivo de forma que
672 solamente se produce una zona de título de parte de libro, haciendo
673 que estén disponibles para su uso todos los títulos de
676 Si el libro tiene varias partituras, son posibles distintas
677 combinaciones de bloques @code{\header}, según los distintos tipos de
678 publicaciones musicales. Por ejemplo, si la publicación contiene
679 varias piezas del mismo autor, un bloque @code{\header} colocado al
680 principio del archivo que especifique el título del libro y el autor,
681 con bloques @code{\header} en cada bloque @code{\score} que
682 especifique la @code{piece} y/o el @code{opus} sería lo más adecuado,
685 @lilypond[papersize=a5,quote,verbatim,noragged-right]
688 composer = "J. S. Bach."
692 \new Staff \relative g, {
695 \repeat unfold 2 { g16( d' b') a b d, b' d, } |
696 \repeat unfold 2 { g,16( e' c') b c e, c' e, } |
704 \new Staff \relative b {
708 <g, d' b'~>4 b'16 a( g fis) g( d e fis) g( a b c) |
709 d16( b g fis) g( e d c) b(c d e) fis( g a b) |
717 Son posibles disposiciones más complejas. Por ejemplo, los campos de
718 texto extraídos del bloque @code{\header} de un libro se pueden
719 imprimir en todos los títulos de partitura, con ciertos campos
720 sobreescritos y otros suprimidos manualmente:
722 @lilypond[papersize=a5,quote,verbatim,noragged-right]
725 print-all-headers = ##t
728 title = "DAS WOHLTEMPERIRTE CLAVIER"
730 % Do not display the tagline for this book
733 \markup { \vspace #1 }
737 \new Staff { \clef "bass" s1 }
740 title = "PRAELUDIUM I"
742 % Do not display the subtitle for this score
749 \new Staff { \clef "bass" s1 }
753 subsubtitle = "A 4 VOCI"
755 % Do not display the subtitle for this score
763 Referencia de la notación:
764 @ref{Estructura del archivo},
765 @ref{Presentación predeterminada de los títulos de partes de libro y partitura},
766 @ref{Personalización de los títulos}.
769 @node Presentación predeterminada de los títulos de partes de libro y partitura
770 @unnumberedsubsubsec Presentación predeterminada de los títulos de partes de libro y partitura
771 @translationof Default layout of bookpart and score titles
773 Este ejemplo muestra todas las variables de @code{\header}:
776 @lilypond[papersize=a6landscape,quote,verbatim,noragged-right]
779 % Los siguientes campos están centrados
780 dedication = "Dedication (dedicatoria)"
781 title = "Title (título)"
782 subtitle = "Subtitle (subtítulo)"
783 subsubtitle = "Subsubtitle (sub-subtítulo)"
784 % Los siguientes campos se distribuyen regularmente sobre una línea
785 % el campo "instrument" también aparece en las siguientes páginas
786 instrument = \markup \with-color #green "Instrument (instrumento)"
787 poet = "Poet (poeta)"
788 composer = "Composer (autor)"
789 % Los siguientes campos se sitúan en los extremos opuestos de la misma línea
790 meter = "Meter (metro)"
791 arranger = "Arranger (arreglista)"
792 % Los siguientes campos están centrados en la parte inferior
793 tagline = "la tagline o línea de etiqueta va al final de la úitlma página"
794 copyright = "el copyright va al final de la primera página"
799 % Los siguientes campos se colocan en los extremos de una línea
800 piece = "Piece (pieza) 1"
807 % Los siguientes campos se sitúan en los extremos de una línea
808 piece = "Piece (pieza) 2 en la misma página"
816 % Los siguientes campos se sitúan en los extremos de una línea
817 piece = "Piece (pieza) 3 en una página nueva"
828 El nombre de instrumento se repite en todas las páginas.
831 Solamente @code{piece} (la pieza) y @code{opus} se imprimen en una
832 @code{\score} cuando la variable de papel @code{print-all-headers} se
833 establece a @code{##f} (el valor predeterminado).
836 @c Is the bit about \null markups true? -mp
837 Los campos de texto que se dejan sin establecer dentro de un bloque
838 @code{\header} se sustituyen por elementos de marcado nulos
839 @code{\null} de manera que no ocupen espacio innecesariamente.
842 Los ajustes predeterminados para @code{scoreTitleMarkup} sitúan los
843 campos de texto @code{piece} y @code{opus} en extremos opuestos de la
848 Para cambiar la disposición predeterminada, véase
849 @ref{Personalización de los títulos}.
853 Si un bloque @code{\book} comienza inmediatamente con un bloque
854 @code{\bookpart}, no se imprime ningún título de libro, pues no
855 existe ninguna página en que imprimirlo. Si es necesario un
856 título de libro, inicie el bloque @code{\book} con algún material
857 de marcado o con una instrucción @code{\pageBreak}.
859 Utilice la variable @code{breakbefore} dentro de un bloque
860 @code{\header} que está propiamente dentro de un bloque @code{\score}
861 para hacer que los títulos del bloque @code{\header} del nivel
862 superior aparezcan ocupando toda la primera página, empezando la
863 música (definida en el bloque @code{\score}) en la página siguiente.
866 @lilypond[papersize=c7landscape,verbatim,noragged-right]
869 title = "Este es mi Title (título)"
870 subtitle = "Este es mi Subtitle (subtítulo)"
871 copyright = "Este es el final de la primera página"
874 \repeat unfold 4 { e'' e'' e'' e'' }
876 piece = "Esto es la música"
884 Manual de aprendizaje:
885 @rlearning{Cómo funcionan los archivos de entrada de LilyPond}
887 Referencia de la notación:
888 @ref{Personalización de los títulos},
889 @ref{Estructura del archivo}.
892 @file{ly/titling-init.ly}.
895 @node Disposición predeterminada de las cabeceras y pies de página
896 @unnumberedsubsubsec Disposición predeterminada de las cabeceras y pies de página
897 @translationof Default layout of headers and footers
899 Las @emph{cabeceras} y los @emph{pies} de página son líneas de texto
900 que aparecen en la parte más alta y en la más baja de las páginas
901 separadas del texto principal de un libro. Se controlan mediante las
902 siguientes variables de @code{\paper}:
905 @item @code{oddHeaderMarkup} (marcado de cabecera impar)
906 @item @code{evenHeaderMarkup} (marcado de cabecera par)
907 @item @code{oddFooterMarkup} (marcado de pie impar)
908 @item @code{evenFooterMarkup} (marcado de pie par)
911 Estas variables de marcado sólo pueden acceder a los campos de texto
912 extraídos de bloques @code{\header} del nivel superior (que se aplican
913 a todas las partituras del libro) y se definen en el archivo
914 @file{ly/titling-init.ly}. De forma predeterminada:
919 los números de página se sitúan automáticamente en el extremo superior
920 izquierdo (si es par) o superior derecho (si es impar), a partir de la
924 el campo de texto @code{instrument} se sitúa en el centro en cada
925 página, a partir de la segunda página.
928 el texto de @code{copyright} se centra en la parte baja de la primera
932 la línea @code{tagline} se centra al final de la última página, y
933 debajo del texto de @code{copyright} si sólo hay una página.
937 La línea de etiqueta tagline predeterminada se puede cambiar añadiendo un campo
938 @code{tagline} en el bloque @code{\header} del nivel superior.
940 @lilypond[papersize=a8landscape,verbatim]
943 tagline = "... music notation for Everyone"
953 Para eliminar la línea @code{tagline}, establezca su valor a
957 @node Títulos encabezamientos y pies de página personalizados
958 @subsection Títulos, encabezamientos y pies de página personalizados
959 @translationof Custom titles headers and footers
961 @c TODO: somewhere put a link to header spacing info
962 @c (you'll have to explain it more in NR 4).
965 * Formateo personalizado del texto de los títulos::
966 * Personalización de los títulos::
967 * Disposición personalizada de cabeceras y pies de página::
971 @node Formateo personalizado del texto de los títulos
972 @unnumberedsubsubsec Formateo personalizado del texto de los bloques de título
973 @translationof Custom text formatting for titles
975 Se pueden usar instrucciones @code{\markup} estándar para personalizar
976 el texto de cualquier cabecera, pie o título dentro del bloque
979 @lilypond[quote,verbatim,noragged-right]
983 piece = \markup { \fontsize #4 \bold "PRAELUDIUM I" }
984 opus = \markup { \italic "BWV 846" }
990 Referencia de la notación:
991 @ref{Formatear el texto}.
994 @node Personalización de los títulos
995 @unnumberedsubsubsec Personalización de los títulos
996 @translationof Custom layout for titles
998 @cindex bookTitleMarkup
999 @cindex scoreTitleMarkup
1000 @funindex bookTitleMarkup
1001 @funindex scoreTitleMarkup
1003 Las instrucciones @code{\markup} dentro del bloque @code{\header} son
1004 útiles para dar un formato simple al texto, pero no permiten un
1005 control preciso sobre la colocación de los títulos. Para personalizar
1006 la colocación de los campos de texto, cambie una o las dos variables de
1007 @code{\paper} siguientes:
1010 @item @code{bookTitleMarkup} (marcado de título del libro)
1011 @item @code{scoreTitleMarkup} (marcado de título de la partitura)
1014 La colocación de los títulos cuando se utilizan los valores
1015 predeterminados de estas variables de @code{\markup} se muestra en los
1017 @ref{Presentación predeterminada de los títulos de partes de libro y partitura}.
1019 Los ajustes predeterminados para @code{scoreTitleMarkup} tal y como
1020 están definidos en el archivo @file{ly/titling-init.ly} son:
1023 scoreTitleMarkup = \markup @{ \column @{
1024 \on-the-fly \print-all-headers @{ \bookTitleMarkup \hspace #1 @}
1026 \fromproperty #'header:piece
1027 \fromproperty #'header:opus
1033 Esto sitúa los campos de texto @code{piece} y @code{opus} en extremos
1034 opuestos de la misma línea:
1036 @lilypond[quote,verbatim,noragged-right]
1040 piece = "PRAELUDIUM I"
1046 Este ejemplo redefine @code{scoreTitleMarkup} de manera que el campo
1047 de texto @code{piece} aparece centrado y en un tipo de letra grande y
1050 @lilypond[papersize=a5,quote,verbatim,noragged-right]
1054 scoreTitleMarkup = \markup {
1057 \fontsize #4 \bold \fromproperty #'header:piece
1058 \fromproperty #'header:opus
1062 \header { tagline = ##f }
1066 piece = "PRAELUDIUM I"
1073 Los campos de texto que normalmente no son efectivos
1074 dentro de los bloques @code{\header} de una partitura
1075 se pueden imprimir el la zona del Título de la partitura
1076 si se coloca @code{print-all-headers} dentro del bloque @code{\paper}.
1077 Una desventaja de la
1078 utilización de este método es que los campos de texto que están
1079 orientados específicamente para la zona del título de parte de libro
1080 han de suprimirse manualmente en cada uno de los bloques
1081 @code{\score}. Véase @ref{Explicación de los títulos}.
1083 Para evitarlo, añada el campo de texto deseado a la definición de
1084 @code{scoreTitleMarkup}. En el ejemplo siguiente, el campo de texto
1085 @code{composer} (asociado normalmente con @code{bookTitleMarkup}) se
1086 añade a @code{scoreTitleMarkup}, permitiendo que cada partitura
1087 muestre un compositor diferente:
1089 @lilypond[papersize=a5,quote,verbatim,noragged-right]
1093 scoreTitleMarkup = \markup {
1096 \fontsize #4 \bold \fromproperty #'header:piece
1097 \fromproperty #'header:composer
1101 \header { tagline = ##f }
1106 composer = "Christian Petzold"
1113 composer = "François Couperin"
1119 También podemos crear nuestros propios campos de texto personalizados,
1120 y referirnos a ellos en la definición del elemento de marcado.
1122 @lilypond[papersize=a5,quote,verbatim,noragged-right]
1126 scoreTitleMarkup = \markup {
1129 \override #`(direction . ,UP) {
1131 \center-align \fontsize #-1 \bold
1132 \fromproperty #'header:mycustomtext %% User-defined field
1133 \center-align \fontsize #4 \bold
1134 \fromproperty #'header:piece
1137 \fromproperty #'header:opus
1141 \header { tagline = ##f }
1146 mycustomtext = "A 4 VOCI" %% User-defined field
1154 Referencia de la notación:
1155 @ref{Explicación de los títulos}.
1158 @node Disposición personalizada de cabeceras y pies de página
1159 @unnumberedsubsubsec Disposición personalizada de cabeceras y pies de página
1160 @translationof Custom layout for headers and footers
1162 @c can make-header and make-footer be removed from
1163 @c paper-defaults-init.ly? -mp
1165 Las instrucciones @code{\markup} dentro del bloque @code{\header} son
1166 de utilidad para dar formato al texto de una manera sencilla, pero no
1167 permiten un control preciso sobre la colocación de las cabeceras y los
1168 pies de página. Para personalizar la colocación de los campos de
1169 texto, use una o más de las siguientes variables de @code{\paper}:
1172 @item @code{oddHeaderMarkup} (marcado de encabezamiento impar)
1173 @item @code{evenHeaderMarkup} (marcado de encabezamiento par)
1174 @item @code{oddFooterMarkup} (marcado de pie de página impar)
1175 @item @code{evenFooterMarkup} (marcado de pie de página par)
1178 @cindex marcado condicional
1180 @funindex \on-the-fly
1182 La instrucción de marcado @code{\on-the-fly} se puede utilizar para
1183 añadir elementos de forma condicional al texto de encabezamiento y pie
1184 de página definido dentro del bloque @code{\paper}, usando la sintaxis
1188 @code{variable} = @code{\markup} @{
1190 @code{\on-the-fly} \@var{procedimiento} @var{marcado}
1195 El @var{procedimiento} se llama cada vez que se evalúa la instrucción
1196 @code{\markup} en que ésta aparece. El @var{procedimiento} debería
1197 comprobar si se cumple una condición determinada e interpretar (es
1198 decir: imprimir) el argumento @var{marcado} si, y sólo si, la
1199 condición es verdadera.
1201 Se proveen un cierto número de procedimientos ya hechos para la
1202 comprobación de diversas condiciones:
1205 @multitable {print-page-number-check-first-----} {¿es el núm. de páginas en la parte de libro > 1?-----}
1207 @headitem Nombre del procedimiento @tab Condición que se comprueba
1209 @item print-page-number-check-first @tab ¿debería imprimirse esta página?
1210 @item create-page-number-stencil @tab ¿es print-page-numbers verdadero?
1211 @item print-all-headers @tab ¿es print-all-headers verdadero?
1212 @item first-page @tab ¿es la primera página del libro?
1213 @item (on-page nmbr) @tab ¿es el número de página = nmbr?
1214 @item last-page @tab ¿es la última página del libro?
1215 @item not-first-page @tab ¿no es la primera página del libro?
1216 @item part-first-page @tab ¿es la primera página de la parte de libro?
1217 @item part-last-page @tab ¿es la última página de la parte de libro?
1218 @item not-single-page @tab ¿es el núm. de páginas en la parte de libro > 1?
1223 El ejemplo siguiente centra los números de página en la parte baja de
1224 las páginas. En primer lugar, los ajustes predeterminados para
1225 @code{oddHeaderMarkup} y @code{evenHeaderMarkup} se eliminan
1226 definiéndolos como un marcado @emph{nulo}. Después de esto, se
1227 redefine @code{oddFooterMarkup} con el número de página centrado.
1228 Finalmente, @code{evenFooterMarkup} recibe la misma disposición
1229 definiéndola como @code{\oddFooterMarkup}:
1231 @lilypond[papersize=a8,quote,verbatim,noragged-right]
1234 print-page-number = ##t
1235 print-first-page-number = ##t
1236 oddHeaderMarkup = \markup \null
1237 evenHeaderMarkup = \markup \null
1238 oddFooterMarkup = \markup {
1240 \on-the-fly \print-page-number-check-first
1241 \fromproperty #'page:page-number-string
1244 evenFooterMarkup = \oddFooterMarkup
1247 \new Staff { s1 \break s1 \break s1 }
1252 Se pueden combinar varias condiciones de @code{\on-the-fly} con un
1253 operador @q{and}, por ejemplo:
1256 @code{\on-the-fly \first-page}
1257 @code{\on-the-fly \last-page}
1258 @code{@{ \markup @dots{} \fromproperty #'header: @dots{} @}}
1261 determina si la salida es una sola página.
1264 Referencia de la notación:
1265 @ref{Explicación de los títulos},
1266 @ref{Presentación predeterminada de los títulos de partes de libro y partitura}.
1268 Archivos instalados:
1269 @file{../ly/titling-init.ly}.
1272 @node Crear notas al pie
1273 @subsection Crear notas al pie
1274 @translationof Creating footnotes
1276 @cindex notas al pie
1278 Se pueden crear dos tipos de notas al pie: automáticas y manuales.
1281 * Notas al pie dentro de expresiones musicales::
1282 * Notas al pie en texto independiente::
1285 @node Notas al pie dentro de expresiones musicales
1286 @unnumberedsubsubsec Notas al pie dentro de expresiones musicales
1287 @translationof Footnotes in music expressions
1289 @cindex notas al pie dentro de expresiones musicales
1292 @subsubsubheading Panorámica de las notas al pie
1294 Las notas al pie dentro de expresiones musicales caen dentro de dos
1298 @item Notas al pie basadas en eventos
1299 Se adjuntan a un evento en particular. Son ejemplos de tales eventos
1300 las notas sueltas, las articulaciones (como indicaciones de digitación,
1301 acentos, indicaciones dinámicas) y los post-eventos (como las ligaduras de expresión
1302 y las barras de corchea manuales). La forma general de las notas
1303 al pie basadas en eventos es como sigue:
1306 [@var{dirección}] \footnote [@var{marca}] @var{desplazamiento} @var{texto-de-la-nota} @var{música}
1309 @item Notas al pie basadas en tiempo
1310 Se ligan a un punto temporal determinado, dentro de un contexto
1311 musical. Algunas instrucciones como @code{\time} y @code{\clef} en
1312 realidad no usan eventos para crear objetos como la indicación de
1313 compás y la clave. Un acorde tampoco crea un evento por sí mismo: su
1314 plica o corchete se crea al final de un paso de tiempo (nominalmente,
1315 a través de uno de los eventos de nota que contiene). Una nota al pie
1316 basada en tiempo permite anotar tales objetos de presentación sin
1317 referirse a ningún evento.
1319 Una nota al pie basada en tiempo permite que tales objetos de
1320 presentación se puedan anotar sin hacer referencia a un evento.
1321 La forma general para las notas al pie basadas en tiempo es:
1324 \footnote [@var{marca}] @var{desplazamiento} @var{texto-de-la-nota} [@var{Contexto}].@var{Nombre-del-Grob}
1329 Los elementos para las dos formas son como sigue:
1334 Si (y sólo si) el @code{\footnote} se está aplicando a un post-evento
1335 o articulación, debe ir precedida de un indicador de dirección
1336 (@code{-, _, ^}) con el objeto de adjuntar la @var{música} (con una
1337 marca de nota al pie) a la nota o silencio precedente.
1340 es un elemento de marcado o cadena de caracteres que especifica la
1341 marca de nota al pie que se usa para marcar tanto el punto de
1342 referencia como la propia nota al pie en la parte inferior de la
1343 página. Se puede omitir (o, de forma equivalente, sustituirse por
1344 @code{\default}) en cuyo caso se genera un número secuencialmente de
1345 forma automática. Tales secuencias numéricas se reinician en cada
1346 página que contiene una nota al pie.
1348 @item desplazamiento
1349 es una pareja de números tal como @samp{#(2 . 1)} que especifica los
1350 desplazamientos en X y en Y en unidades de espacios de pentagrama a
1351 partir del límite del objeto en que se desea situar la marca. Los
1352 valores de desplazamiento positivos se toman a partir del borde
1353 superior derecho, los valores negativos a partir del borde inferior
1354 izquierdo y cero implica que la marca se centra sobre el borde.
1357 es el contexto en que se crea el grob que recibe la nota al pie.
1358 Se puede omitir si el grob está en un contexto del nivel inferior,
1359 p.ej un contexto @code{Voice}.
1361 @item Nombre-del-Grob
1362 especifica un tipo de grob que marcar (como @samp{Flag} para el
1363 corchete). Si se da, la nota al pie no se adjunta a una expresión
1364 musical en particular, sino a todos los grobs del tipo
1365 especificado que ocurren en dicho momento de tiempo musical.
1367 @item texto-de-la-nota
1368 es el elemento de marccado o cadena de caracteres que especifica el
1369 texto de la nota al pie que utilizar en la parte baja de la página.
1372 es el evento musical, post-evento o articulación que se
1377 @subsubsubheading Notas al pie basadas en eventos
1379 @cindex Notas al pie, basadas en eventos
1381 Una nota al pie se adjunta a un objeto de presentación causado
1382 directamente por el evento que corresponde a @var{música}, con la
1386 \footnote [@var{marca}] @var{desplazamiento} @var{texto-de-la-nota} @var{música}
1390 @lilypond[quote,verbatim,papersize=a8landscape]
1392 \header { tagline = ##f }
1394 \footnote #'(-1 . 3) "Una nota" a4
1396 \footnote #'(2 . 2) "Un silencio" r4
1402 No es posible marcar un acrode @emph{completo} con una nota al pie
1403 basada en evento: un acorde, incluso aquel que contiene una sola
1404 nota, no produce un verdadero evento por sí mismo. Sin embargo,
1405 las notas individuales que están @emph{dentro} del acorde sí se
1409 @lilypond[quote,verbatim,papersize=a8landscape]
1411 \header { tagline = ##f }
1413 \footnote #'(2 . 3) "No funciona" <a-3>2
1414 <\footnote #'(-2 . -3) "Funciona" a-3>4
1415 <a-3 \footnote #'(3 . 1/2) "También funciona" c-5>4
1420 Si se desea que la nota al pie se adjunte a un post-evento o
1421 articulación, la instrucción @code{\footnote} @emph{debe} ir
1422 precedida por un indicador de dirección, @code{-, _, ^}, y seguida
1423 por el post-evento o articulación que se desea anotar como
1424 argumento @var{música}. En esta forma, la @code{\footnote} se
1425 puede considerar como una simple copia de su último argumento con
1426 una marca de nota al pie adjunta. La sintaxis es:
1429 @var{dirección} \footnote [@var{marca}] @var{desplazamiento} @var{texto-de-la-nota} @var{música}
1433 @lilypond[quote,verbatim,papersize=a8landscape]
1435 \header { tagline = ##f }
1437 a4_\footnote #'(0 . -1) "Ligadura forzada hacia abajo" (
1438 b8^\footnote #'(1 . 0.5) "Barra manual forzada hacia arriba" [
1441 c-\footnote #'(1 . 1) "Tenuto" --
1446 @subsubsubheading notas al pie basadas en tiempo
1448 @cindex notas al pie, basadas en tiempo
1450 Si el objeto de presentación que recibe la nota al pie está
1451 causado @emph{indirectamente} por un evento (como un objeto
1452 @code{Accidental}, alteración, o @code{Stem}, plica, causados por
1453 un evento @code{NoteHead}, cabeza de nota), el nombre del grob
1454 @var{GrobName} del objeto de presentación es necesario después del
1455 texto de la nota al pie, en lugar de @var{música}:
1458 @lilypond[quote,verbatim,papersize=a8landscape]
1460 \header { tagline = ##f }
1462 \footnote #'(-1 . -3) "Un bemol" Accidental
1464 \footnote #'(-1 . 0.5) "Otro bemol" Accidental
1466 \footnote #'(1 . -2) "Una plica" Stem
1472 Sin embargo, observe que cuando se especifica el nombre de un
1473 grob, se adjunta una nota al pie a todos los grobs de ese tipo
1474 dentro del instante de tiempo actual:
1477 @lilypond[quote,verbatim,papersize=a8landscape]
1479 \header { tagline = ##f }
1481 \footnote #'(-1 . 3) "Un bemol" Accidental
1483 \footnote #'(2 . 0.5) "Articulación" Script
1489 Una nota dentro de un acorde puede recibir una nota al pie
1490 individual, basada en evento. El único grob causado directamente
1491 por una nota de un acorde es @samp{NoteHead}, por lo que la
1492 instrucción de nota al pie basada en evento @emph{solamente} es
1493 apta para añadir una nota al pie a la @samp{NoteHead} dentro de un
1494 acorde. Todos los demás grobs de notas de acorde están causados
1495 indirectamente. La propia instrucción @code{\footnote} no ofrece
1496 ninguna sintaxis para especificar al mismo tiempo un tipo concreto
1497 de grob @emph{y también} un evento concreto al que adjuntar la
1498 nota. Sin embargo, se puede usat una instrucción @code{\footnote}
1499 basada en tiempo para especificar el tipo de grob, y luego añadir
1500 la instrucción @code{\single} como prefijo, con el objeto de que
1501 se aplique solamente al evento siguiente:
1504 @lilypond[quote,verbatim,papersize=a8landscape]
1506 \header { tagline = ##f }
1508 < \footnote #'(1 . -2) "An A" a
1509 \single \footnote #'(-1 . -1) "Un sostenido" Accidental
1511 \single \footnote #'(0.5 . 0.5) "Un bemol" Accidental
1518 @warning {Cuando las notas al pie se adjuntan a varios elementos musicales que
1519 están dentro del mismo momento musical, como ocurre en el ejemplo
1520 anterior, las notas al pie se numeran desde los elementos más
1521 altos a los más bajos tal y como aparecen en la salida impresa, no
1522 en el orden en que se escriben en el flujo de entrada.}
1524 Los objetos de presentación como las claves y las armaduras de
1525 cambio de tonalidad están, más bien, causadas por propiedades que
1526 cambian, y no por eventos. Otros, como las líneas divisorias y
1527 los números de compás, son una consecuencia directa del paso del
1528 tiempo. Por esta razón, las notas al pie sobre tales objetos
1529 tienen que basarse en su tiempo musical. Las notas al pie basadas
1530 en tiempo so preferibles también cuando se marcan cosas como las
1531 plicas y las barras de corchea en @emph{acordes}: dado que estas
1532 funcionalidades de cada acorde individual están asignadas
1533 normalmente a @emph{un solo} evento dentro del acorde, sería
1534 imprudente descansar en una elección particular.
1536 En las notas al pie basadas en tiempo, siempre se debe especificar
1537 explícitamente el objeto de presentación en cuestión, y si el grob
1538 se crea dentro de un contexto distinto al de nivel más bajo, debe
1539 especificarse el contexto apropiado.
1542 @lilypond[quote,verbatim,papersize=a8landscape]
1544 \header { tagline = ##f }
1547 \footnote #'(-0.5 . -1) "Cambio de compás" Staff.TimeSignature
1549 \footnote #'(1 . -1) "Plica de acorde" Stem
1551 \footnote #'(-0.5 . 1) "Línea divisoria" Staff.BarLine
1553 \footnote #'(0.5 . -1) "Cambio de tonalidad" Staff.KeySignature
1560 Se pueden usar marcas personalizadas como alternativas a las
1561 marcas numéricas, y se puede suprimir la línea de anotación que
1562 une el objeto marcado con su marca:
1565 @lilypond[quote,verbatim,papersize=a8landscape]
1567 \header { tagline = ##f }
1569 \footnote "*" #'(0.5 . -2) \markup { \italic "* La primera nota" } a'4
1571 \footnote \markup { \super "$" } #'(0.5 . 1)
1572 \markup { \super "$" \italic " La segunda nota" } e
1574 \once \override Score.FootnoteItem.annotation-line = ##f
1575 b-\footnote \markup \tiny "+" #'(0.1 . 0.1)
1576 \markup { \super "+" \italic " Editorial" } \p
1581 Se muestran más ejemplos de marcas personalizadas en
1582 @ref{Notas al pie en texto independiente}.
1585 @node Notas al pie en texto independiente
1586 @unnumberedsubsubsec Notas al pie en texto independiente
1587 @translationof Footnotes in stand-alone text
1589 @cindex notas al pie en texto independiente
1591 Se utilizan dentro de un elemento de marcado fuera de cualquier
1592 expresión musical. No se traza una líne hasta el punto de referencia:
1593 la marca simplemente sigue al elemento de marcado que se referencia.
1594 Se pueden insertar las marcas automáticamente, en cuyo caso son
1595 numéricas. De forma alternativa, se pueden aportar manualmente marcas
1598 Las notas al pie para texto independiente con marcas automáticas y
1599 personalizadas se crean de distintas formas.
1601 @subsubsubheading Notas al pie en texto independiente con marcas automáticas
1603 La sintaxis de una nota al pue sobre texto independiente con marcas
1607 \markup @{ @dots{} \auto-footnote @var{texto} @var{nota} @dots{} @}
1615 es el elemento de marcado o cadena de caracteres que se desea anotar.
1618 es el elemento de marcado o cadena de caracteres que especifica el
1619 texto de la nota al pie que utilizar en la parte baja de la página.
1625 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1627 \header { tagline = ##f }
1630 \auto-footnote "tune" \italic " By me"
1631 "is shown below. It is a"
1632 \auto-footnote "recent" \italic " Aug 2012"
1641 @subsubsubheading Notas al pie sobre texto independiente con marcas personalizadas
1643 La sintaxis de una nota al pie sobre texto independiente con marcas
1647 \markup @{ @dots{} \footnote @var{marca} @var{nota} @dots{} @}
1655 es un elemento de marcado o cadena de caracteres que especifica la
1656 marca que se usa para señalar el punto de referencia. Observe que
1657 esta marca @emph{no} se inserta automáticamente antes de la propia
1661 es el elemento de marcado o cadena de caracteres que especifica el
1662 texto de la nota que aparece en la parte baja de la página, precedida
1663 por la @var{marca} especificada.
1667 Se puede usar como marca un carácter fácil de teclear, como * ó +,
1668 según se muestra en @ref{Notas al pie dentro de expresiones musicales}.
1669 De forma alternativa, se pueden usar alias en ASCII (véase
1670 @ref{Alias de ASCII}):
1672 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1674 \paper { #(include-special-characters) }
1675 \header { tagline = ##f }
1678 \footnote "*" \italic "* By me"
1679 "is shown below. It is a recent"
1680 \footnote \super † \concat {
1681 \super † \italic " Aug 2012"
1691 También pueden utilizarse códigos de caracteres Unicode para
1692 especificar las marcas (véase @ref{Unicode}):
1694 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1696 \header { tagline = ##f }
1699 \footnote \super \char##x00a7 \concat {
1700 \super \char##x00a7 \italic " By me"
1702 "is shown below. It is a recent"
1703 \footnote \super \char##x00b6 \concat {
1704 \super \char##x00b6 \italic " Aug 2012"
1715 Manual de aprendizaje:
1716 @rlearning{Objetos e interfaces}.
1718 Referencia de la notación:
1719 @ref{ASCII aliases},
1720 @ref{Globos de ayuda},
1721 @ref{List of special characters},
1722 @ref{Indicaciones de texto},
1723 @ref{Guiones de texto},
1726 Referencia de funcionamiento interno:
1727 @rinternals{FootnoteEvent},
1728 @rinternals{FootnoteItem},
1729 @rinternals{FootnoteSpanner},
1730 @rinternals{Footnote_engraver}.
1733 Varias notas al pie en la misma página solo pueden ir apiladas unas
1734 sobre otras; no se pueden imprimir en la misma línea.
1736 Las notas al pie no se pueden adjuntar a @code{MultiMeasureRests}
1737 (silencios multicompás), a barras de corchea automáticas ni a la
1738 letra de las canciones.
1740 Las notas al pie pueden colisionar con las pautas, objetos
1741 @code{\markup}, otras marcas de notas al pie y líneas de
1745 @node Referencia a números de página
1746 @subsection Referencia a números de página
1747 @translationof Reference to page numbers
1749 Un lugar determinado de una partitura puede señalizarse usando la
1750 instrucción @code{\label} (etiqueta), ya sea en el nivel superior o
1751 dentro de la música. Podemos referirnos a esta etiqueta más tarde
1752 dentro de un elemento de marcado, para obtener el número de la página
1753 en la que se sitúa el punto señalizado, usando la instrucción de
1754 marcado @code{\page-ref}.
1757 @lilypond[verbatim,papersize=a8landscape]
1758 \header { tagline = ##f }
1764 \pageBreak \mark A \label #'markA
1768 \markup { La primera partitura comienza en la página \page-ref #'firstScore "0" "?" }
1769 \markup { La marca A está en la página \page-ref #'markA "0" "?" }
1773 La instrucción de marcado @code{\page-ref} toma tres argumentos:
1775 @item la etiqueta, un símbolo de scheme, p.ej. @code{#'firstScore};
1776 @item un elemento de marcado que se usará como medidor para estimar las dimensiones del marcado;
1777 @item un elemento de marcado que se utilizará en sustitución del número de página si la etiqueta es desconocida.
1780 El motivo de que se necesite un medidor es que en el momento en que se
1781 están interpretando los marcados, los saltos de página aún no se han
1782 producido y por tanto los números de página no se conocen todavía.
1783 Para sortear este inconveniente, la interpretación real del marcado se
1784 retrasa hasta un momento posterior; sin embargo, las dimensiones del
1785 marcado se tienen que conocer de antemano, así que se usa el medidor
1786 para decidir estas dimensiones. Si el libro tiene entre 10 y 99
1787 páginas, el medidor puede ser "00", es decir, un número de dos
1798 @node Índice general
1799 @subsection Índice general
1800 @translationof Table of contents
1802 Se puede insertar un índice general o tabla de contenidos utilizando
1803 la instrucción @code{\markuplist \table-of-contents}. Los elementos
1804 que deben aparecer en la tabla de contenidos se introducen con la
1805 instrucción @code{\tocItem}, que se puede usar en el nivel más alto de
1806 la jerarquía del código, o dentro de una expresión musical.
1809 \markuplist \table-of-contents
1812 \tocItem \markup "Primera partitura"
1816 \tocItem \markup "Un punto concreto dentro de la primera partitura"
1821 \tocItem \markup "Segunda partitura"
1829 Los elementos de marcado que se usan para dar formato al índice
1830 general se encuentran definidos dentro del bloque @code{\paper}. Los
1831 elementos predeterminados son @code{tocTitleMarkup}, para dar formato
1832 al título de la tabla, y @code{tocItemMarkup}, para aplicar formato a
1833 los elementos del índice, que consisten en el título del elemento y el
1834 número de página. Estas variables se pueden cambiar por parte del
1839 %% Traducir el título del índice al español:
1840 tocTitleMarkup = \markup \huge \column {
1841 \fill-line { \null "Índice general" \null }
1844 %% usar una fuente mayor
1845 tocItemMarkup = \markup \large \fill-line {
1846 \fromproperty #'toc:text \fromproperty #'toc:page
1851 Observe la forma en que nos referimos al texto y al número de página
1852 del elemento de índice, dentro de la definición @code{tocItemMarkup}.
1854 También se pueden definir nuevas instrucciones y elementos de
1855 marcado para crear índices generales más elaborados:
1857 @item en primer lugar, defina una variable de marcado nueva dentro del bloque @code{\paper}
1858 @item luego defina una función de música cuyo propósito es añadir un elemento al índice general
1859 utilizando esta variable de marcado del bloque @code{\paper}.
1862 En el ejemplo siguiente se define un estilo nuevo para introducir los
1863 nombres de los actos de una ópera en el índice general:
1867 tocActMarkup = \markup \large \column {
1869 \fill-line { \null \italic \fromproperty #'toc:text \null }
1875 #(define-music-function (parser location text) (markup?)
1876 (add-toc-item! 'tocActMarkup text))
1879 @lilypond[line-width=10.0\cm]
1880 \header { tagline = ##f }
1882 tocActMarkup = \markup \large \column {
1884 \fill-line { \null \italic \fromproperty #'toc:text \null }
1890 #(define-music-function (parser location text) (markup?)
1891 (add-toc-item! 'tocActMarkup text))
1894 \markuplist \table-of-contents
1895 \tocAct \markup { Atto Primo }
1896 \tocItem \markup { Coro. Viva il nostro Alcide }
1897 \tocItem \markup { Cesare. Presti omai l'Egizzia terra }
1898 \tocAct \markup { Atto Secondo }
1899 \tocItem \markup { Sinfonia }
1900 \tocItem \markup { Cleopatra. V'adoro, pupille, saette d'Amore }
1905 Se pueden añadir puntos de relleno entre un elemento y su número de página:
1907 @lilypond[verbatim,line-width=10.0\cm]
1908 \header { tagline = ##f }
1910 tocItemMarkup = \tocItemWithDotsMarkup
1914 \markuplist \table-of-contents
1915 \tocItem \markup { Allegro }
1916 \tocItem \markup { Largo }
1923 @file{ly/toc-init.ly}.
1926 @funindex \table-of-contents
1927 @code{\table-of-contents},
1933 @node Trabajar sobre los archivos de entrada
1934 @section Trabajar sobre los archivos de entrada
1935 @translationof Working with input files
1938 * Inclusión de archivos de LilyPond::
1939 * Distintas ediciones a partir de una misma fuente::
1940 * Caracteres especiales::
1944 @node Inclusión de archivos de LilyPond
1945 @subsection Inclusión de archivos de LilyPond
1946 @translationof Including LilyPond files
1949 @cindex including files
1951 Un proyecto grande se puede dividir en varios archivos. Para
1952 referirse a otro archivo, utilice
1955 \include "otroarchivo.ly"
1958 La línea @code{\include "otroarchivo.ly"} equivale a pegar todo el
1959 contenido de @file{otroarchivo.ly} en el archivo actual en el lugar en
1960 que aparece el @code{\include}. Por ejemplo, en un proyecto grande
1961 podríamos querer archivos distintos para cada parte instrumental y
1962 crear un archivo de @qq{partitura completa} que reúne los archivos
1963 individuales de los instrumentos. Normalmente el archivo incluido
1964 define un cierto número de variables que a partir de entonces quedan
1965 disponibles para poderlas utilizar en el archivo de la partitura
1966 completa. En los archivos incluidos se pueden marcar las secciones
1967 etiquetadas para ayudar a hacerlas utilizables en distintos lugares de
1968 la partitura, véase @ref{Distintas ediciones a partir de una misma fuente}.
1970 Los archivos que están en el directorio de trabajo actual se pueden
1971 referenciar simplemente especificando el nombre después de la
1972 instrucción @code{\include}. Los archivos en otros lugares se pueden
1973 incluir proporcionando una referencia de ruta completa o una ruta
1974 relativa (pero utilice la barra inclinada normal del UNIX, /, no la
1975 barra invertida de DOS/Windows, \, como separador de directorio). Por
1976 ejemplo, si @file{material.ly} está situado un directorio por encima
1977 del directorio de trabajo actual, utilice
1980 \include "../material.ly"
1984 o si los archivos de las partes orquestales incluidas están todos
1985 situados en un subdirectorio llamado @file{partes} dentro del
1986 directorio actual, use
1989 \include "partes/VI.ly"
1990 \include "partes/VII.ly"
1994 Los archivos de inclusión también pueden contener enunciados
1995 @code{\include} a su vez. De forma predeterminada, estos enunciados
1996 @code{\include} de segundo nivel no se interpretan hasta que se
1997 incorporan al archivo principal, por lo que los nombres de archivo que
1998 especifican deben ser relativos al directorio que contiene el archivo
1999 principal, no al directorio que contiene el archivo incluido. Sin
2000 embargo, este comportamiento se puede modificar globalmente pasando la
2001 opción @option{-drelative-includes} en la línea de órdenes (o mediante
2002 la adición de @code{#(ly:set-option 'relative-includes #t)} al
2003 principio del archivo principal de entrada).
2005 Cuando @code{relative-includes} está establecido al valor @code{#t},
2006 la ruta de cada instrucción @code{\include} se considera relativa al
2007 archivo que contiene dicha instrucción. Este comportamiento es el
2008 recomendado y se convertirá en el comportamiento predeterminado en una
2009 versión futura de lilypond.
2011 Tanto los archivos relativos al directorio principal como los archivos
2012 relativos a algún otro directorio se pueden @code{\include}ar mediante
2013 el establecimiento de @code{relative-includes} al valor @code{#t} o a
2014 @code{#f} en los lugares apropiados dentro de los archivos. Por
2015 ejemplo, si se ha creado una biblioteca genérica, libA, que a su vez
2016 utiliza sub-archivos que se @code{\include}an por medio del archivo de
2017 entrada de dicha biblioteca, esas instrucciones @code{\include}
2018 tendrán que venir precedidas por @code{#(ly:set-option
2019 #relative-includes #t)} de manera que se interpreten correctamente al
2020 construir el archivo de entrada @code{.ly} principal, de esta forma:
2031 entonces el archivo de entrada, @code{libA.ly}, contiene
2034 #(ly:set-option 'relative-includes #t)
2038 % vuelta al ajuste predeterminado
2039 #(ly:set-option 'relative-includes #f)
2042 Cualquier archivo @file{.ly} puede entonces incluir la biblioteca
2043 completa, simplemente con
2046 \include "~/libA/libA.ly"
2049 Se pueden usar estructuras de archivo más complejas instando los
2050 cambios en los lugares adecuados.
2052 También se pueden incluir archivos de un directorio que está en una
2053 ruta de búsqueda especificada como opción al invocar a LilyPond desde
2054 la línea de órdenes. Los archivos incluidos se especifican usando
2055 solamente su nombre de archivo. Por ejemplo, para compilar mediante
2056 este método un archivo @file{principal.ly} que incluye archivos
2057 situados en un subdirectorio llamado @file{partes}, cambie al
2058 directorio que contiene @file{principal.ly} e introduzca
2061 lilypond --include=partes principal.ly
2064 y en @file{principal.ly} escriba
2072 Los archivos que se incluyen en muchas partituras se pueden poner en
2073 el directorio de LilyPond @file{../ly} (la localización de este
2074 directorio depende de la instalación: véase
2075 @rlearning{Otras fuentes de información}). Estos archivos se pueden
2076 incluir sencillamente por su nombre en un enunciado @code{\include}.
2077 De esta forma se incluyen los archivos dependientes del idioma como
2080 LilyPond incluye de forma predeterminada ciertos archivos cuando se
2081 inicia el programa. Estas inclusiones no son visibles para el
2082 usuario, pero los archivos se pueden identificar ejecutando
2083 @code{lilypond --verbose} desde la línea de órdenes. Esto presentará
2084 una lista de rutas y archivos que utiliza LilyPond, junto a muchas
2085 otras indicaciones. De forma alternativa, pueden verse explicaciones
2086 sobre los archivos más importantes de este conjunto en
2087 @rlearning{Otras fuentes de información}. Estos archivos se pueden
2088 editar, pero los cambios realizados sobre ellos se perderán al
2089 instalar una nueva versión de LilyPond.
2091 Pueden verse ejemplos sencillos sobre el uso de @code{\include} en
2092 @rlearning{Partituras y particellas}.
2095 Manual de aprendizaje:
2096 @rlearning{Otras fuentes de información},
2097 @rlearning{Partituras y particellas}.
2100 Si un archivo incluido recibe un nombre igual al de uno de los
2101 archivos de instalación de LilyPond, el archivo que tiene prioridad es
2102 el de los archivos de instalación de LilyPond.
2105 @node Distintas ediciones a partir de una misma fuente
2106 @subsection Distintas ediciones a partir de una misma fuente
2107 @translationof Different editions from one source
2109 Se pueden usar varios métodos para generar la producción de distintas
2110 versiones de una partitura a partir de la misma fuente musical. Las
2111 variables son quizá el más útil para combinar secciones extensas de
2112 música y/o anotaciones. Las etiquetas son más útiles para seleccionar
2113 una sección de entre varias secciones de música alternativas, más
2114 cortas, y se pueden usar también para dividir piezas de música en
2117 Cualquiera que sea el método utilizado, la separación de la notación
2118 de la estructura de la partitura hará que sea más fácil cambiar la
2119 estructura dejando intacta la notación.
2122 * Uso de las variables::
2123 * Uso de etiquetas::
2124 * Uso de ajustes globales::
2127 @node Uso de las variables
2128 @unnumberedsubsubsec Uso de las variables
2129 @translationof Using variables
2131 @cindex variables, uso de las
2133 Si las secciones de la música se definen dentro de variables, se
2134 pueden reutilizar en distintas partes de la partitura, véase
2135 @rlearning{Organizar las piezas mediante variables}. Por ejemplo, una
2136 partitura vocal @notation{a cappella} con frecuencia incluye una
2137 reducción de piano de las partes para ensayar que es idéntica a la
2138 música vocal, por lo que ésta sólo se tiene que escribir una vez. Se
2139 puede combinar sobre un solo pentagrama la música de dos variables,
2140 véase @ref{Combinación automática de las partes}. He aquí un ejemplo:
2142 @lilypond[verbatim,quote]
2143 sopranoMusic = \relative c'' { a4 b c b8( a) }
2144 altoMusic = \relative g' { e4 e e f }
2145 tenorMusic = \relative c' { c4 b e d8( c) }
2146 bassMusic = \relative c' { a4 gis a d, }
2147 allLyrics = \lyricmode {King of glo -- ry }
2149 \new Staff = "Soprano" \sopranoMusic
2150 \new Lyrics \allLyrics
2151 \new Staff = "Alto" \altoMusic
2152 \new Lyrics \allLyrics
2153 \new Staff = "Tenor" {
2157 \new Lyrics \allLyrics
2158 \new Staff = "Bass" {
2162 \new Lyrics \allLyrics
2165 \set Staff.printPartCombineTexts = ##f
2171 \set Staff.printPartCombineTexts = ##f
2181 Se pueden producir partituras distintas que presenten sólo las partes
2182 vocales o sólo la parte de piano, cambiando solamente los enunciados
2183 estructurales, sin modificar la notación musical.
2185 Para partituras extensas, las definiciones de variable se pueden poner
2186 en archivos separados que se incluyen más tarde, véase @ref{Inclusión de archivos de LilyPond}.
2189 @node Uso de etiquetas
2190 @unnumberedsubsubsec Uso de etiquetas
2191 @translationof Using tags
2194 @funindex \keepWithTag
2195 @funindex \removeWithTag
2196 @funindex \pushToTag
2197 @funindex \appendToTag
2199 @cindex mantener música etiquetada
2200 @cindex quitar música etiquetada
2201 @cindex división en música etiquetada
2203 La instrucción @code{\tag #'@var{parteA}} marca una expresión musical
2204 con el nombre @var{parteA}. Las expresiones etiquetadas de esta
2205 manera se pueden seleccionar o filtrar más tarde por su nombre, usando
2206 bien @code{\keepWithTag #'@var{nombre}} o bien @code{\removeWithTag
2207 #'@var{nombre}}. El resultado de la aplicación de estos filtros a la
2208 música etiquetada es como sigue:
2210 @multitable @columnfractions .5 .5
2214 Música etiquetada precedida de @code{\keepWithTag #'@var{nombre}}
2215 o de @code{\keepWithTag #'(@var{nombre1} @var{nombre2}@dots{})}
2216 @tab Se incluye la música no etiquetada y la música etiquetada con
2217 el nombre o nombres de etiqueta dados; se excluye la música
2218 etiquetada con cualquier otro nombre de etiqueta.
2220 Música etiquetada precedida de
2221 @code{\removeWithTag #'@var{nombre}} o
2222 @code{\removeWithTag #'(@var{nombre1} @var{nombre2}@dots{})}
2224 Se incluye la música no etiquetada y la música que no está
2225 etiquetada con ninguno de los nombres de etiqueta dados; se
2226 excluye la música etiquetada con los nombres de etiqueta dados.
2228 Música etiquetada no precedida de @code{\keepWithTag} ni de
2229 @code{\removeWithTag}
2230 @tab Se incluye toda la música etiquetada y no etiquetada.
2233 Los argumentos de las instrucciones @code{\tag}, @code{\keepWithTag} y
2234 @code{\removeWithTag} deben ser un símbolo (como @code{#'partitura} o
2235 @code{#'parte}), seguido de una expresión musical.
2237 En el ejemplo siguiente vemos dos versiones de una pieza musical, una
2238 que muestra trinos con la notación usual y otra con los trinos
2239 expandidos explícitamente:
2241 @lilypond[verbatim,quote]
2242 music = \relative g' {
2244 \tag #'trills { d8.\trill }
2245 \tag #'expand { \repeat unfold 3 { e32 d } }
2250 \keepWithTag #'trills \music
2253 \keepWithTag #'expand \music
2258 De forma alternativa, a veces es más fácil excluir secciones de música:
2260 @lilypond[verbatim,quote]
2261 music = \relative g' {
2263 \tag #'trills { d8.\trill }
2264 \tag #'expand {\repeat unfold 3 { e32 d } }
2269 \removeWithTag #'expand
2273 \removeWithTag #'trills
2278 El filtrado con etiquetas se puede aplicar a articulaciones, textos,
2282 -\tag #'@var{mi-etiqueta}
2285 a una articulación. Por ejemplo, esto define una nota con una
2286 indicación opcional de digitación y una nota con una anotación
2291 c1-\tag #'warn ^"¡Ojo!"
2294 Se pueden poner varias etiquetas sobre expresiones con varias entradas
2295 de @code{\tag}, o combinando varias etiquetas en una lista de símbolos:
2297 @lilypond[quote,verbatim]
2298 music = \relative c'' {
2299 \tag #'a \tag #'both { a4 a a a }
2300 \tag #'(b both) { b4 b b b }
2303 \keepWithTag #'a \music
2304 \keepWithTag #'b \music
2305 \keepWithTag #'both \music
2309 Se pueden aplicar varios filtros @code{\removeWithTag} a una sola
2310 expresión musical para quitar varias secciones etiquetadas con
2311 nombres distintos. De forma alternativa, podemos usar una sola
2312 instrucción @code{\removeWithTag} con una lista de etiquetas.
2314 @lilypond[verbatim,quote]
2315 music = \relative c'' {
2316 \tag #'A { a4 a a a }
2317 \tag #'B { b4 b b b }
2318 \tag #'C { c4 c c c }
2319 \tag #'D { d4 d d d }
2325 \removeWithTag #'(B C)
2330 Dos o más filtros @code{\keepWithTag} aplicados a una sola
2331 expresión musical producen la eliminación de @emph{todas} las
2332 secciones etiquetadas, porque el primer filtro quita todas las
2333 secciones etiquetadas excepto la que se nombra, y el segundo
2334 filtro elimina incluso esa sección etiquetada. Por lo general,
2335 querrá usar una sola instrucción @code{\keepWithTag} con una lista
2336 de varias etiquetas: de esta forma solamente se suprimirán las
2337 secciones etiquetadas que no aparezcan en @emph{ninguna} de las
2340 A veces podemos desear dividir la música en un determinado lugar
2341 dentro de una expresión musical existente. Podemos usar
2342 @code{\pushToTag} y @code{\appendToTag} para añadir material
2343 delante o al final de los @code{elements} de una construcción
2344 musical existente. No toda construcción musical tiene la parte
2345 @code{elements}, pero las músicas secuenciaes y simultáneas son
2346 dos apuestas seguras:
2348 @lilypond[verbatim,quote]
2349 test = { \tag #'here { \tag #'here <<c''>> } }
2352 \pushToTag #'here c'
2353 \pushToTag #'here e'
2354 \pushToTag #'here g' \test
2355 \appendToTag #'here c'
2356 \appendToTag #'here e'
2357 \appendToTag #'here g' \test
2361 Las dos instrucciones admiten una etiqueta, el material que dividir en
2362 cada ocurrencia de la etiqueta, y la expresión etiquetada. Las
2363 instrucciones aseguran que se copia todo lo que cambian, de forma que
2364 el código original @code{\test} retiene su significado.
2367 Manual de aprendizaje:
2368 @rlearning{Organizar las piezas mediante variables}.
2370 Referencia de la notación:
2371 @ref{Combinación automática de las partes},
2372 @ref{Inclusión de archivos de LilyPond}.
2375 Al llamar a @code{\relative} sobre una expresión musical obtenida
2376 mediante el filtrado de música con las instrucciones
2377 @code{\keepWithTag} o @code{\removeWithTag}, podría ocurrir que
2378 cambiaran las relaciones de octava, dado que solo se tendrán en
2379 cuenta las alturas de las notas que efectivamente permanecen en la
2380 expresión filtrada. La aplicación de @code{\relative} en primer
2381 lugar, antes de @code{\keepWithTag} o de @code{\removeWithTag},
2382 evita este peligro porque en este caso @code{\relative} actúa
2383 sobre todas las notas tal y como se introducen.
2386 @node Uso de ajustes globales
2387 @unnumberedsubsubsec Uso de ajustes globales
2388 @translationof Using global settings
2390 @cindex include-settings
2392 Se pueden incluir ajustes globales a partir de un archivo distinto:
2395 lilypond -dinclude-settings=MIS_AJUSTES.ly MI_PARTITURA.ly
2398 En archivos diferentes se pueden almacenar grupos de ajustes como
2399 el tamaño de la página o las fuentes tipográficas. Ello permite
2400 hacer diferentes ediciones de la mism a partitura así como aplicar
2401 ajustes estándar a muchas partituras, simplemente por medio de la
2402 especificación del archivo de ajustes adecuado.
2404 Esta técnica también funciona bien con el uso de hojas de estilo,
2405 como se estudia en @rlearning{Hojas de estilo}.
2408 Manual de aprendizaje:
2409 @rlearning{Organizar las piezas mediante variables},
2410 @rlearning{Hojas de estilo}.
2412 Referencia de la notación:
2413 @ref{Inclusión de archivos de LilyPond}.
2416 @node Caracteres especiales
2417 @subsection Caracteres especiales
2418 @translationof Special characters
2420 @cindex caracteres especiales
2421 @cindex caracteres no ASCII
2424 * Codificación del texto::
2430 @node Codificación del texto
2431 @unnumberedsubsubsec Codificación del texto
2432 @translationof Text encoding
2436 LilyPond usa el conjunto de caracteres definido por el consorcio
2437 Unicode y la norma ISO/IEC 10646. Define un nombre único y un código
2438 para los conjuntos de caracteres que se utilizan en prácticamente
2439 todos los idiomas modernos y también en muchos otros. Unicode se
2440 puede implementar utilizando varios esquemas de codificación
2441 distintos. LilyPond usa la codificación UTF-8 (UTF son las siglas de
2442 @emph{Unicode Transformation Format}, o formato de transformación de
2443 Unicode) que representa todos los caracteres comunes de Latin en un
2444 solo byte, y representa otros caracteres usando un formato de longitud
2445 variable de hasta cuatro bytes.
2447 El aspecto visual real de los caracteres viene determinado por los
2448 glifos que se definen en las fuentes tipográficas concretas que se
2449 tengan disponibles: una fuente tipográfica define la asignación de un
2450 subconjunto de los códigos de Unicode a glifos. LilyPond usa la
2451 biblioteca Pango para representar y disponer tipográficamente textos
2454 LilyPond no realiza ninguna conversión en la codificación de la
2455 entrada. Esto significa que cualquier text, ya sea el título, la
2456 letra de la canción o una instrucción musical que contenga caracteres
2457 distintos a los del conjunto ASCII, se deben codificar en UTF-8. La
2458 forma más fácil de escribir dicho texto es utilizar un editor
2459 preparado para Unicode y guardar el archivo con la codificación UTF-8.
2460 Casi todos los editores modernos populares contemplan el UTF-8, por
2461 ejemplo lo hacen vim, Emacs, jEdit, y GEdit. Todos los sistemas MS
2462 Windows posteriores a NT usan Unicode como codificación de caracteres
2463 nativa, de manera que incluso el accesorio Bloc de Notas (Notepad)
2464 puede editar y guardar un archivo en el formato UTF-8. Una
2465 alternativa más funcional para Windows es BabelPad.
2467 Si un archivo de entrada que contiene un carácter que no es ASCII, no
2468 se guarda en el formato UTF-8, se genera el mensaje de error
2471 FT_Get_Glyph_Name () error: argumento inválido
2474 He aquí un ejemplo que muestra texto cirílico, hebreo y portugués:
2477 %c No verbatim here as the code does not display correctly in PDF
2479 bulgarian = \lyricmode {
2480 Жълтата дюля беше щастлива, че пухът, който цъфна, замръзна като гьон.
2484 hebrew = \lyricmode {
2485 זה כיף סתם לשמוע איך תנצח קרפד עץ טוב בגן.
2489 portuguese = \lyricmode {
2490 à vo -- cê uma can -- ção legal
2496 \addlyrics { \bulgarian }
2497 \addlyrics { \hebrew }
2498 \addlyrics { \portuguese }
2503 @unnumberedsubsubsec Unicode
2504 @translationof Unicode
2508 Para introducir un carácter aislado para el que se conoce el punto de
2509 código Unicode pero no está disponible en el editor que se está
2510 usando, use @code{\char ##xhhhh} o bien @code{\char #dddd} dentro de
2511 un bloque @code{\markup}, donde @code{hhhh} es el código hexadecimal
2512 del carácter en cuestión y @code{dddd} es su valor decimal
2513 correspondiente. Pueden omitirse los ceros iniciales, pero es
2514 costumbre indicar los cuatro caracteres en la representación
2515 hexadecimal (observe que @emph{no} debe utilizarse la codificación
2516 UTF-8 del punto de código Unicode después de @code{\char}, pues la
2517 codificación UTF-8 contiene bits adicionales que indican el número de
2518 octetos). Hay tablas de códigos Unicode y un índice de nombres de
2519 caracteres que da el punto de código en hexadecimal para cualquier
2520 carácter en el portal del Consorcio Unicode,
2521 @uref{http://www.unicode.org/}.
2523 Por ejemplo, tanto @code{\char ##x03BE} como @code{\char #958}
2524 insertan el carácter Unicode U+03BE, que tiene el nombre Unicode
2525 @qq{Letra griega Xi pequeña}.
2527 Se puede escribir de esta forma cualquier punto de código Unicode, y
2528 si todos los caracteres especiales se escriben en este formato no es
2529 necesario guardar el archivo de entrada en formato UTF-8. Por
2530 supuesto, debe estar instalada y estar disponible para LilyPond una
2531 fuente tipográfica que contenga codificados todos estos caracteres.
2533 El ejemplo siguiente muestra valores hexadecimales Unicode que se usan
2534 en cuatro lugares: en una llamada de ensayo, como texto de
2535 articulación, en la letra y como texto independiente bajo la
2538 @lilypond[quote,verbatim]
2541 c1 \mark \markup { \char ##x03EE }
2542 c1_\markup { \tiny { \char ##x03B1 " to " \char ##x03C9 } }
2544 \addlyrics { O \markup { \concat { Ph \char ##x0153 be! } } }
2546 \markup { "Copyright 2008--2012" \char ##x00A9 }
2549 @cindex copyright, símbolo de
2551 Para escribir el símbolo de copyright en la nota de créditos, utilice:
2555 copyright = \markup @{ \char ##x00A9 "2008" @}
2560 @node Alias de ASCII
2561 @unnumberedsubsubsec Alias de ASCII
2562 @translationof ASCII aliases
2564 Se puede incluir una lista de alias de ASCII para caracteres
2567 @lilypond[quote,verbatim]
2569 #(include-special-characters)
2572 \markup "&flqq; – &OE;uvre incomplète… &frqq;"
2575 \new Staff { \repeat unfold 9 a'4 }
2577 This is al -- so wor -- kin'~in ly -- rics: –_&OE;…
2582 "The replacement can be disabled:"
2583 "– &OE; …"
2584 \override #'(replacement-alist . ()) "– &OE; …"
2588 También podemos hacer nuestros propios alias, ya sea de forma global:
2590 @lilypond[quote,verbatim]
2592 #(add-text-replacements!
2593 '(("100" . "hundred")
2594 ("dpi" . "dots per inch")))
2596 \markup "A 100 dpi."
2601 @lilypond[quote,verbatim]
2602 \markup \replace #'(("100" . "hundred")
2603 ("dpi" . "dots per inch")) "A 100 dpi."
2607 Referencia de la notación:
2608 @ref{Lista de caracteres especiales}.
2610 Archivos instalados:
2611 @file{ly/text-replacements.ly}.
2614 @node Controlar la salida
2615 @section Controlar la salida
2616 @translationof Controlling output
2619 * Extracción de fragmentos de música::
2620 * Saltar la música corregida::
2621 * Formatos de salida alternativos::
2622 * Sustituir la tipografía de la notación::
2626 @node Extracción de fragmentos de música
2627 @subsection Extracción de fragmentos de música
2628 @translationof Extracting fragments of music
2630 Es posible citar pequeños fragmentos de una partitura grande
2631 directamente a partir de la salida. Puede compararse con la
2632 separación de una pieza de una partitura, recortándola con tijeras.
2634 Esto se hace definiendo los compases que se deben recortar. Por
2635 ejemplo, la inclusión de la siguiente definición
2642 (make-rhythmic-location 5 1 2)
2643 (make-rhythmic-location 7 3 4)))
2648 extrae un fragmento empezando por la mitad del quinto compás y
2649 finalizando en el séptimo compás. El significado de @code{5 1 2} es:
2650 después de una blanca (1/2) en el compás 5, y el de @code{7 3 4}
2651 después de tres negras del compás 7.
2653 Se pueden definir más zonas de recorte añadiendo más parejas de
2654 definición de tiempo rhythmic-location a la lista.
2656 Para poder utilizar esta funcionalidad, LilyPond se debe invocar con
2657 la opción @option{-dclip-systems}. Los recortes aparecen en la salida
2658 como archivos EPS, y se convierten en PDF y PNG si estos formatos
2659 también están activados.
2661 Para ver más información sobre los formatos de salida, consulte
2662 @rprogram{Invocar a LilyPond}.
2665 @node Saltar la música corregida
2666 @subsection Saltar la música corregida
2667 @translationof Skipping corrected music
2669 @funindex skipTypesetting
2670 @funindex showFirstLength
2671 @funindex showLastLength
2673 Al escribir o copiar música, normalmente sólo es interesante de ver y
2674 corregir la música cercana al final (donde estamos añadiendo las
2675 notas). Para acelerar este proceso de corrección, es posible saltar
2676 la composición tipográfica de todos excepto unos pocos de los últimos
2677 compases. Esto se consigue poniendo
2680 showLastLength = R1*5
2681 \score @{ @dots{} @}
2685 en nuestro archivo fuente. Esto hará que se tracen sólo los últimos
2686 cinco compases (suponiendo un compás de 4/4) de cada una de las
2687 partituras @code{\score} del archivo de entrada. Para piezas largas,
2688 el tipografiado de únicamente una parte pequeña es con frecuencia un
2689 orden de magnitud más rápido que el de la obra completa. Si estamos
2690 trabajando sobre el principio de una partitura que ya hemos
2691 tipografiado (p.ej., para añadir una parte instrumental nueva),
2692 también puede ser útil la propiedad @code{showFirstLength}.
2694 Este mecanismo de pasar por alto partes de un partitura se puede
2695 controlar con un grano más fino mediante la propiedad
2696 @code{Score.skipTypesetting}. Cuando su valor está establecido, no se
2697 lleva a cabo ningún tipografiado en absoluto.
2699 Esta propiedad se usa también para controlar la salida al archivo
2700 MIDI. Observe que pasa por alto todos los eventos, incluidos el tempo
2701 y los cambios de instrumento. Está usted advertido.
2703 @lilypond[quote,relative=2,ragged-right,verbatim]
2705 \set Score.skipTypesetting = ##t
2707 \set Score.skipTypesetting = ##f
2711 En música polifónica, @code{Score.skipTypesetting} afecta a todas las
2712 voces y pentagramas, ahorrando más tiempo incluso.
2715 @node Formatos de salida alternativos
2716 @subsection Formatos de salida alternativos
2717 @translationof Alternative output formats
2719 @cindex salida de gráficos de vector escalables
2721 @cindex salida de PostScript encapsulado
2723 @cindex PostScript encapsulado, salida de
2725 Los formatos de salida predeterminados para la partitura impresa son
2726 el formato de documento portátil (PDF) y PostScript (PS). Los
2727 formatos de salida Gráficos de vector escalables (SVG), PostScript
2728 encapsulado (EPS) y Gráficos de red portátiles (PNG) también están
2729 disponibles a través de opciones de la línea de órdenes, véase
2730 @rprogram{Opciones básicas de la línea de órdenes para LilyPond}.
2733 @node Sustituir la tipografía de la notación
2734 @subsection Sustituir la tipografía de la notación
2735 @translationof Replacing the notation font
2737 Gonville es una alternativa a la tipografía Feta que se utiliza en
2738 LilyPond y se puede descargar de:
2740 @uref{http://www.chiark.greenend.org.uk/~sgtatham/gonville/ ,http://www.chiark.greenend.org.uk/~sgtatham/gonville/}
2743 Aquí presentamos algunos compases de muestra tipografiados con la
2746 @c NOTE: these images are a bit big, but that's important
2747 @c for the font comparison. -gp
2748 @sourceimage{Gonville_after,15cm,,}
2750 Aquí hay unos compases de muestra tipografiados en la fuente Feta de
2753 @sourceimage{Gonville_before,15cm,,}
2755 @subsubheading Instrucciones de instalación para MacOS
2757 Descargue y extraiga el archivo zip. Copie la carpeta @code{lilyfonts}
2758 a @file{@var{SHARE_DIR}/lilypond/current}; para más información,
2759 consulte @rlearning{Otras fuentes de información}. Renombre la carpeta
2760 @code{fonts} existente a @code{fonts_orig} y la carpeta
2761 @code{lilyfonts} a @code{fonts}. Para volver a la fuente Feta,
2762 invierta el proceso.
2765 Manual de aprendizaje:
2766 @rlearning{Otras fuentes de información}.
2770 Gonville no se puede usar para tipografiar notación de @q{Música
2771 Antigua} y es probable que cualquier nuevo glifo en versiones
2772 posteriores de LilyPond no existan en la familia
2773 tipográfica Gonville. Diríjase a la página web del autor para obtener más
2774 información sobre éste y otros asuntos, entre ellos el régimen de
2775 licencias de Gonville.
2779 @section Salida MIDI
2780 @translationof MIDI output
2785 El MIDI (Musical Instrument Digital Interface, Interfase Digital para
2786 Instrumentos Musicales) es un estándar para interconectar y controlar
2787 instrumentos musicales electrónicos. Un archivo o secuencia MIDI es
2788 una serie de notas dentro de un conjunto de pistas. No es un archivo
2789 de sonidos reales; se necesita un programa reproductor especial para
2790 traducir la serie de notas en sonidos de verdad.
2792 Cualquier música se puede convertir a archivos MIDI, de manera que
2793 podamos escuchar lo que hayamos introducido. Esto es muy conveniente
2794 para comprobar la corrección de la música; las octavas equivocadas o
2795 las alteraciones erróneas se ponen de relieve muy claramente al
2796 escuchar la salida MIDI.
2798 La salida estándar de MIDI es un poco primitiva; de forma opcional, se
2799 encuentra disponible una salida MIDI mejorada y mucho más realista,
2800 por medio de @ref{El script Articulate}.
2802 La salida MIDI reserva un canal por cada pentagrama, y reserva
2803 el canal 10 para la percusión. Sólo hay 16 canales MIDI por cada
2804 dispositivo, por lo que si la partitura tiene más de 15 pautas, los
2805 canales MIDI se reutilizarán.
2808 * Crear archivos MIDI::
2809 * 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 @cindex MIDI, bloque
2822 Para crear un MIDI a partir de un archivo de LilyPond, inserte un
2823 bloque @code{\midi} dentro de un bloque @code{\score};
2827 @var{@dots{}música@dots{}}
2833 Si hay @emph{solamente} un bloque @code{\midi} dentro de un
2834 @code{\score} (es decir, sin ningún bloque @code{\layout}),
2835 entonces @emph{solamente} se producirá MIDI. No se produce
2836 ninguna salida impresa de notación musical.
2840 @var{@dots{}música@dots{}}
2845 Se traducen correctamente a la salida MIDI la altura y duración de
2846 las notas, las ligaduras de unión, matices y cambios de tempo. Las
2847 @q{marcas} dinámicas se traducen a niveles de volumen con una
2848 @q{fracción fija} del rango de volumen MIDI disponible; Los
2849 crescendi y decrescendi hacen que el volumen varíe linealmente
2850 entre sus dos extremos.
2852 Se reflejan en la salida de MIDI todas las indicaciones de
2853 @code{\tempo}, incluidos todos los cambios de tempo siguientes,
2854 especificados dentro de la notación musical.
2856 Por lo general basta con dejar vacío el bloque @code{\midi}, pero
2857 puede contener disposiciones distintas de los contextos,
2858 definiciones de contexto nuevas o código que establezca valores
2859 para propiedades. En el ejemplo que aparece a continuación se
2860 fija el tempo a 72 negras por minuto, pero @emph{solamente} para
2861 la reproducción de audio a través de MIDI.
2865 @var{@dots{}music@dots{}}
2872 Observe que @code{\tempo} es en realidad una instrucción para
2873 establecer valores para propiedades durante la interpretación de
2874 la música, y en el contexto de las definiciones de salida, como un
2875 bloque @code{\midi}, se reinterpreta como si fuese una
2876 modificación de contexto.
2878 @cindex MIDI, definiciones de contexto
2880 Las definiciones de contexto siguen la misma sintaxis que las de
2881 un bloque @code{\layout};
2885 @var{@dots{}música@dots{}}
2889 \remove "Dynamic_performer"
2895 elimina de la salida MIDI el efecto de los matices dinámicos. Los
2896 módulos de traducción para el sonido se llaman @q{performers}
2901 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
2902 {changing-midi-output-to-one-channel-per-voice.ly}
2906 Algunos sistemas operativos requieren una extensión de archivo
2907 @emph{específica} para los archivos MIDI. Si se prefiere una
2908 extensión distinta, inserte la línea siguiente en el nivel
2909 superior del archivo de entrada, antes del comienzo de cualquier
2910 bloque @code{\book}, @code{\bookpart} o @code{\score};
2913 #(ly:set-option 'midi-extension "mid")
2916 De esta manera quedará establecida la extensión predeterminada
2917 para los archivos MIDI a @code{.mid}.
2919 De forma alternativa, se puede proporcionar una opción en la línea
2920 de órdenes de la consola:
2923 lilypond -dmidi-extension=mid MiArchivo.ly
2926 Los cambios del volumen MIDI sólo tienen lugar al principio de la
2927 nota, por lo que los crescendi y decrescendi no pueden afectar al
2928 volumen de una sola nota.
2930 Puede que algunos propgramas reproductores de MIDI no siempre
2931 manejen correctamente los cambios de tempo en la salida MIDI.
2934 Archivos instalados:
2935 @file{../ly/performer-init.ly}.
2937 Manual de aprendizaje:
2938 @rlearning{Otras fuentes de información}.
2941 @node Instrumentos MIDI
2942 @subsection Instrumentos MIDI
2943 @translationof MIDI Instruments
2945 @cindex instrumento, nombres de
2946 @funindex Staff.midiInstrument
2948 El instrumento MIDI que se quiere utilizar se establece fijando la
2949 propiedad @code{Staff.midiInstrument} al nombre del instrumento.
2950 El nombre se debe elegir de entre los que están en la lista que
2951 aparece en @ref{instrumentos MIDI}.
2955 \set Staff.midiInstrument = #"glockenspiel"
2956 @var{@dots{}notas@dots{}}
2961 \new Staff \with @{midiInstrument = #"cello"@} @{
2962 @var{@dots{}notas@dots{}}
2966 Si el instrumento elegido no coincide exactamente con uno de los
2967 instrumentos de la lista de instrumentos MIDI, se usará el
2968 instrumento Piano de Cola (@code{"acoustic grand"}).
2971 @node ¿Qué sale por el MIDI?
2972 @subsection ¿Qué sale por el MIDI?
2973 @translationof What goes into the MIDI output?
2976 * Contemplado en el MIDI::
2977 * No contemplado en el MIDI::
2980 @node Contemplado en el MIDI
2981 @unnumberedsubsubsec Contemplado en el MIDI
2982 @translationof Supported in MIDI
2984 @cindex alturas en MIDI
2985 @cindex MIDI, alturas
2986 @cindex cuartos de tono en MIDI
2987 @cindex MIDI, cuartos de tono
2988 @cindex microtonos en MIDI
2989 @cindex MIDI, microtonos
2990 @cindex acordes, nombres de, en MIDI
2991 @cindex MIDI, nombres de
2992 @cindex duraciones en MIDI
2993 @cindex MIDI, duraciones
2994 @cindex Articlulate, scripts
2995 @cindex MIDI, articulaciones
2996 @cindex articulaciones en MIDI
2997 @cindex trinos en MIDI
2998 @cindex grupetos en MIDI
2999 @cindex rallentando en MIDI
3000 @cindex accelerando en MIDI
3003 Los siguientes elementos de notación se reflejan en la salida MIDI:
3007 @item Microtonos (véase @ref{Alteraciones accidentales}. La reproducción necesita un reproductor que contemple la curvatura de tono o @emph{pitch bend}.)
3008 @item Acordes escritos como nombres de acorde
3009 @item Ritmos escritos como duraciones de las notas, incluidos los grupos de valoración especial
3010 @item Trémolos escritos sin @q{@code{:}[@var{número}]}
3011 @item Ligaduras de unión
3012 @item Matices o indicaciones de dinámica
3013 @item Crescendi y decrescendi sobre varias notas
3014 @item Cambios de tempo insertados con una marca metronómica
3015 @item Letra de las canciones
3018 Utilizando @ref{El script Articulate}, a la lista anterior se añaden
3019 una serie de elementos:
3022 @item Articulaciones (ligaduras de expresión, picados, etc)
3023 @item Trinos, mordentes circulares
3024 @item Rallentando y accelerando
3028 @node No contemplado en el MIDI
3029 @unnumberedsubsubsec No contemplado en el MIDI
3030 @translationof Unsupported in MIDI
3032 @c TODO index as above
3034 Los siguientes elementos de notación no tienen ningún efecto sobre la
3035 salida MIDI, a no ser que utilicemos @ref{El script Articulate}:
3038 @item Duraciones escritas como anotaciones, p.ej. el swing
3039 @item Cambios de tempo escritos como anotaciones sin marca de tempo
3040 @item Staccato y otras articulaciones y ornamentos
3041 @item Ligaduras de expresión y de fraseo
3042 @item Crescendi y decrescendi sobre una nota única
3043 @item Trémolos introducidos con @q{@code{:}[@var{número}]}
3045 @item Acordes microtonales
3049 @node Repeticiones y MIDI
3050 @subsection Repeticiones y MIDI
3051 @translationof Repeats in MIDI
3053 @cindex repeticiones, expandir
3054 @funindex \unfoldRepeats
3056 Con un poco de trucaje, se puede hacer que cualquier tipo de
3057 repetición esté presente en la salida MIDI. Esto se consigue mediante
3058 la aplicación de la función musical @code{\unfoldRepeats}. Esta
3059 función cambia todas las repeticiones a repeticiones desplegadas.
3061 @lilypond[quote,verbatim]
3063 \repeat tremolo 8 { c'32 e' }
3064 \repeat percent 2 { c''8 d'' }
3065 \repeat volta 2 { c'4 d' e' f' }
3074 En partituras con varias voces, el desplegado de las repeticiones en
3075 la salida MIDI solo se produce correctamente si @emph{todas y cada
3076 una} de las voces incluye las repeticiones de manera completa y
3079 Al crear un archivo de partitura que use @code{\unfoldRepeats} para el
3080 MIDI, es necesario hacer dos bloques @code{\score}: uno para el MIDI
3081 (con repeticiones desplegadas) y otro para la notación impresa (con
3082 repeticiones de volta --primera y segunda vez--, tremolo --trémolo--,
3083 y percent --repetición de compases--). Por ejemplo,
3087 @var{@dots{}música@dots{}}
3088 \layout @{ @dots{} @}
3091 \unfoldRepeats @var{@dots{}música@dots{}}
3097 @node Control de los matices en el MIDI
3098 @subsection Control de los matices en el MIDI
3099 @translationof Controlling MIDI dynamics
3101 La dinámica en el MIDI está implementada por medio del intérprete
3102 Dynamic_performer que reside de forma predeterminada dentro del
3103 contexto Voice. Es posible controlar el volumen MIDI general, el
3104 volumen relativo de los matices dinámicos y el volumen relativo de los
3105 distintos instrumentos.
3108 * Indicaciones dinámicas::
3109 * Volumen maestro MIDI::
3110 * Balance entre instrumentos (i)::
3111 * Balance entre instrumentos (ii)::
3114 @node Indicaciones dinámicas
3115 @unnumberedsubsubsec Indicaciones dinámicas
3116 @translationof Dynamic marks
3118 Los matices o indicaciones de dinámica se traducen a una fracción
3119 fija del rango de volumen MIDI disponible. Las fracciones
3120 predeterminadas se extienden desde 0.25 para @notation{ppppp}
3121 hasta 0.95 para @notation{fffff}. El conjunto de indicaciones
3122 dinámicas y las fracciones asociadas pueden verse en
3123 @file{../scm/midi.scm}, véase @rlearning{Otras fuentes de
3124 información}. Este conjunto de fracciones se puede cambiar o
3125 extender proporcionando una función que toma como argumento una
3126 indicación dinámica y devuelve la fracción requerida, y
3127 estableciendo @code{Score.dynamicAbsoluteVolumeFunction} a esta
3130 Por ejemplo, si se requiere una indicación dinámica
3131 @notation{rinforzando}, @code{\rfz}, ésta no tiene ningún efecto
3132 predeterminado sobre el volumen MIDI, pues no está incluida en el
3133 conjunto predeterminado. De igual manera, si se define una
3134 indicación dinámica nueva con @code{make-dynamic-script}, ésta
3135 tampoco estará incluida en el conjunto predeterminado. El ejemplo
3136 siguiente muestra cómo hay que añadir el volumen MIDI para estas
3137 indicaciones dinámicas. La función Scheme establece la fracción a
3138 0.9 si se encuentra una indicación dinámica rfz, y en caso
3139 contrario llama a la función predeterminada.
3141 @lilypond[verbatim,quote]
3142 #(define (myDynamics dynamic)
3143 (if (equal? dynamic "rfz")
3145 (default-dynamic-absolute-volume dynamic)))
3149 \set Staff.midiInstrument = #"cello"
3150 \set Score.dynamicAbsoluteVolumeFunction = #myDynamics
3162 Como alternativa, si se necesitara redefinir la tabla completa de
3163 fracciones, sería mejor usar el procedimiento
3164 @notation{default-dynamic-absolute-volume} que aparece en
3165 @file{../scm/midi.scm} y la tabla asociada como modelo. El último
3166 ejemplo de esta sección muestra cómo se puede hacer esto.
3168 @node Volumen maestro MIDI
3169 @unnumberedsubsubsec Volumen maestro MIDI
3170 @translationof Overall MIDI volume
3172 El volumen general máximo y mínimo de las indicaciones dinámicas
3173 de MIDI se controla estableciendo valores para las propiedades
3174 @code{midiMinimumVolume} y @code{midiMaximumVolume} en el nivel de
3175 @code{Score}. Estas propiedades tienen efecto solamente al inicio
3176 de una voz y sobre las indicaciones dinámicas. La fracción que
3177 corresponde a cada indicación dinámica se modifica con esta
3181 midiMinimumVolume + (midiMaximumVolume - midiMinimumVolume) * fracción
3184 En el ejemplo siguiente, el rango de intensidad dinámica del
3185 volumen general MIDI está limitado al intervalo desde 0.2 hasta
3188 @lilypond[verbatim,quote]
3194 \set Staff.midiInstrument = #"flute"
3195 \new Voice \relative c''' {
3203 \set Staff.midiInstrument = #"clarinet"
3204 \new Voice \relative c'' {
3216 midiMinimumVolume = #0.2
3217 midiMaximumVolume = #0.5
3223 @node Balance entre instrumentos (i)
3224 @unnumberedsubsubsec Balance entre instrumentos (i)
3225 @translationof Equalizing different instruments (i)
3227 Si las propiedades de volumen MIDI máximo y mínimo están
3228 establecidas en el contexto @code{Staff} se pueden controlar los
3229 volúmenes relativos de los instrumentos MIDI. Esto proporciona un
3230 ecualizador de instrumentos básico que puede realzar
3231 significativamente la calidad de la salida MIDI.
3233 En este ejemplo se reduce el volumen del clarinete con relación al
3236 @lilypond[verbatim,quote]
3242 \set Staff.midiInstrument = #"flute"
3243 \set Staff.midiMinimumVolume = #0.7
3244 \set Staff.midiMaximumVolume = #0.9
3245 \new Voice \relative c''' {
3253 \set Staff.midiInstrument = #"clarinet"
3254 \set Staff.midiMinimumVolume = #0.3
3255 \set Staff.midiMaximumVolume = #0.6
3256 \new Voice \relative c'' {
3271 @node Balance entre instrumentos (ii)
3272 @unnumberedsubsubsec Balance entre instrumentos (ii)
3273 @translationof Equalizing different instruments (ii)
3275 Si las propiedades de volumen MIDI máximo y mínimo no están
3276 establecidas, de forma predeterminada LilyPond aplica un pequeño
3277 grado de ecualización a algunos instrumentos. Los instrumentos y
3278 la ecualización que se aplica se muestra en la tabla
3279 @notation{instrument-equalizer-alist} en @file{../scm/midi.scm}.
3281 El ecualizador básico predeterminado se puede sustituir
3282 estableciendo @code{instrumentEqualizer} en el contexto
3283 @code{Score} a un procedimiento Scheme nuevo que acepte el nombre
3284 de un instrumento MIDI como único argumento y devuelva un par de
3285 fracciones que dan los volúmenes máximo y mínimo que se aplican a
3286 dicho instrumento. Esta sustitución se hace de la misma forma que
3287 mostramos para restablecer la fracción de volumen absoluto
3288 @code{dynamicAbsoluteVolumeFunction} al comienzo de esta sección.
3289 El ecualizador predeterminado,
3290 @notation{default-instrument-equalizer}, en
3291 @file{../scm/midi.scm}, muestra cómo se puede escribir tal
3294 El ejemplo siguiente establece los volúmenes relativos de la
3295 flauta y del clarinete a los mismos valores que el ejemplo
3298 @lilypond[verbatim,quote]
3299 #(define my-instrument-equalizer-alist '())
3301 #(set! my-instrument-equalizer-alist
3304 ("flute" . (0.7 . 0.9))
3305 ("clarinet" . (0.3 . 0.6)))
3306 my-instrument-equalizer-alist))
3308 #(define (my-instrument-equalizer s)
3309 (let ((entry (assoc s my-instrument-equalizer-alist)))
3318 \set Score.instrumentEqualizer = #my-instrument-equalizer
3319 \set Staff.midiInstrument = #"flute"
3320 \new Voice \relative c''' {
3328 \set Staff.midiInstrument = #"clarinet"
3329 \new Voice \relative c'' {
3344 @c Delete when satisfied this is adequately covered elsewhere -td
3346 @n ode Microtones in MIDI
3347 @s ubsection Microtones in MIDI
3349 @cindex microtones in MIDI
3351 Microtones consisting of half sharps and half flats are exported
3352 to the MIDI file and render correctly in MIDI players which support
3353 pitch bending. See @ref{Nombres de las notas en otros idiomas}. Here is
3354 an example showing all the half sharps and half flats. It can be
3355 copied out and compiled to test microtones in your MIDI player.
3357 @lilypond[verbatim,quote]
3374 @node Percusión en MIDI
3375 @subsection Percusión en MIDI
3376 @translationof Percussion in MIDI
3378 La notación de los instrumentos de percusión se realiza
3379 normalmente en un contexto @code{DrumStaff} y cuando se hace de
3380 esta forma se les da salida correctamente por el canal
3381 MIDI@tie{}10, pero ciertos instrumentos de percusión de altura
3382 determinada, como el xilófono, marimba, vibráfono, timbales, etc.,
3383 se tratan como instrumentos @qq{normales} y la música para estos
3384 instrumentos se debe introducir en contextos de @code{Staff}
3385 normales, no en un contexto @code{DrumStaff}, para obtener la
3386 salida MIDI correcta.
3388 Ciertos sonidos de altura indeterminada que están incluidos en el
3389 estándar General MIDI, como el tom melódico, el tambor taiko, los
3390 tambores sintéticos, etc., no se pueden acceder a través del canal
3391 MIDI@tie{}10, por lo que la notación para dichos instrumentos se
3392 debe introducir también en un contexto normal de @code{Staff},
3393 utilizando las alturas normales adecuadas.
3395 Muchos instrumentos de percusión no están incluidos dentro del
3396 estándar General MIDI, p.ej. las castañuelas. El método más fácil
3397 (aunque no satisfactorio) de producir una salida MIDI al escribir
3398 para estos instrumentos es sustituirlos por el sonido más parecido
3399 del conjunto estándar.
3401 @c TODO Expand with examples, and any other issues
3405 Debido a que el estándar General MIDI no contiene golpes de aro
3406 (@emph{rim shots}), para este propósito se utiliza en su lugar el
3407 golpe lateral de baqueta (@emph{sidestick}).
3410 @node El script Articulate
3411 @subsection El script Articulate
3412 @translationof The Articulate script
3414 Es posible obtener una salida MIDI más real si se utiliza el
3415 script Articulate. Éste trata de tener en cuenta las
3416 articulaciones (ligaduras de expresión, picados, etc), mediante la
3417 sustitución de las notas con secuencias musicales de silencios y
3418 notas escaladas en el tiempo de forma apropiada. También trata de
3419 desplegar los trinos, grupetos circulares, etc. y responder a las
3420 indicaciones de rallentando y accelerando.
3422 Para utilizar el script Articulate, tenemos que incluirlo al
3423 principio de nuestro archivo de entrada:
3426 \include "articulate.ly"
3429 y en la sección @code{\score}, hacer lo siguiente:
3432 \unfoldRepeats \articulate <<
3433 resto de la partitura@dots{}
3437 Después de alterar el código de entrada de esta manera el
3438 resultado visual se altera profundamente, pero el bloque
3439 @code{\midi} estándar produce un archivo MIDI mejorado.
3441 Si bien no es esencial para que funcione el script Articulate,
3442 podemos insertar la instrucción @code{\unfoldRepeats} según
3443 aparece en el ejemplo anterior, dado que habilita la ejecución de
3444 abreviaturas tales como los @notation{trinos}.
3448 Articulate acorta los acordes, y ciertos fragmentos de música
3449 (especialmente la música de órgano) es posible que suene peor.
3452 @node Extraer información musical
3453 @section Extraer información musical
3454 @translationof Extracting musical information
3456 Además de crear un resultado visual y MIDI, LilyPond es capaz de
3457 presentar información musical en forma de texto.
3460 * Impresión del código de notación de LilyPond::
3461 * Impresión de las expresiones musicales de Scheme::
3462 * Guardar los eventos musicales en un archivo::
3466 @node Impresión del código de notación de LilyPond
3467 @subsection Displaying LilyPond notation
3468 @translationof Displaying LilyPond notation
3470 @funindex \displayLilyMusic
3471 La impresión textual de una expresión musical en notación de
3472 LilyPond puede hacerse con la función musical
3473 @code{\displayLilyMusic}. Para ver el resultado, lo más usual es
3474 llamar a LilyPond mediante la línea de órdenes. Por ejemplo,
3478 \displayLilyMusic \transpose c a, @{ c4 e g a bes @}
3482 imprime lo siguiente:
3485 @{ a,4 cis e fis g @}
3488 De forma predeterminada, LilyPond imprime estos mensajes en la
3489 consola junto al resto de los mensajes de la compilación de
3490 LilyPond. Para discernir entre estos mensajes y guardar el
3491 resultado de @code{\displayLilyMusic}, redireccione la salida
3495 lilypond archivo.ly >resultado.txt
3499 @node Impresión de las expresiones musicales de Scheme
3500 @subsection Impresión de las expresiones musicales de Scheme
3501 @translationof Displaying scheme music expressions
3503 Véase @rextend{Presentación de las expresiones musicales}.
3506 @node Guardar los eventos musicales en un archivo
3507 @subsection Guardar los eventos musicales en un archivo
3508 @translationof Saving music events to a file
3510 Los eventos musicales se pueden guardar en un archivo pentagrama a
3511 pentagrama mediante la inclusión de un archivo en nuestra
3512 partitura principal.
3515 \include "event-listener.ly"
3518 De esta forma se crean uno o más archivos llamados
3519 @file{FILENAME-STAFFNAME.notes} ó
3520 @file{FILENAME-unnamed-staff.notes} para cada pentagrama. Observe
3521 que si tiene más de un pentagrama sin nombre, los eventos de todos
3522 los pentagramas se mezclarán entre sí dentro del mismo archivo.
3523 El resultado tiene el aspecto siguiente:
3526 0.000 note 57 4 p-c 2 12
3528 0.250 note 62 4 p-c 7 12
3529 0.500 note 66 8 p-c 9 12
3530 0.625 note 69 8 p-c 14 12
3535 La sintaxis consiste en una línea delimitada por caracteres de
3536 tabulación, con dos campos fijos en cada línea seguidos de
3537 parámetros opcionales.
3540 @var{tiempo} @var{tipo} @var{@dots{}parámetros@dots{}}
3543 Esta información se puede leer fácilmente por parte de otros
3544 programas como guiones de Python, y pueden ser muy útiles para
3545 aquellos investigadores que desean realizar un análisis musical o
3546 hacer experimientos de reproducción con LilyPond.
3549 No todos los eventos musicales de lilypond están contemplados por
3550 @file{event-listener.ly}. Se pretende que sea una @qq{prueba de
3551 concepto} bien realizada. Si algunos eventos que quiere ver no
3552 aparecen incluidos, copie @file{event-listener.ly} en su carpeta
3553 de lilypond y modifique el archivo de forma que produzca la
3554 información que desea.