1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
4 Translation of GIT committish: 8016f31ef2a25bf9492a6ba65dc627622beac4af
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
18 salida 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::
25 * Creación de salida MIDI::
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
35 texto. Por convenio, el nombre de estos archivos termina en
39 * Estructura de una partitura::
40 * Varias partituras en un libro::
41 * Varios archivos de salida a partir de uno de entrada::
42 * Nombres de los archivos de salida::
43 * Estructura del archivo::
47 @node Estructura de una partitura
48 @subsection Estructura de una partitura
49 @translationof Structure of a score
53 Un bloque @code{\score} debe contener una expresión musical única
54 delimitada por un par de llaves:
63 @warning{Sólo puede haber @strong{una} expresión musical dentro del
64 bloque @code{\score}, y @strong{debe} estar encerrada entre llaves.}
66 Esta expresión musical única puede tener cualquier tamaño, y
67 puede contener otras expresiones musicales hasta cualquier grado
68 de complejidad. Todos los siguientes ejemplos son expresiones
75 @lilypond[verbatim,quote]
82 @lilypond[verbatim,quote]
84 \new Staff { c'4 c' c' c' }
85 \new Staff { d'4 d' d' d' }
93 \new Staff @{ \flute @}
94 \new Staff @{ \oboe @}
97 \new Staff @{ \violinI @}
98 \new Staff @{ \violinII @}
104 Los comentarios son una excepción a esta regla general (para ver
105 otras excepciones, consulte @ref{Estructura del archivo}). Tanto
106 los comentarios de una línea como los que están delimitados por
107 @code{%@{ @dots{} %@}} se pueden escribir en cualquier lugar
108 dentro del archivo de entrada. Se pueden escribir dentro o fuera
109 del bloque @code{\score}, y dentro o fuera de la expresión
110 musical única dentro del bloque @code{\score}.
112 Recuerde que incluso dentro de un archivo que contenga solamente
113 un bloque @code{\score}, éste se encuentra incluido
114 implícitamente dentro de un bloque @code{\book}. Un bloque
115 @code{\book} dentro de un archivo fuente produce al menos un
116 archivo de salida, y de forma predeterminada el nombre del
117 archivo de salida que se produce está derivado del nombre del
118 archivo de entrada, de forma que @file{fandangoforelephants.ly}
119 da como resultado @file{fandangoforelephants.pdf}.
121 (Para ver más detalles acerca de los bloques @code{\book},
122 consulte @ref{Varias partituras en un libro},
123 @ref{Varios archivos de salida a partir de uno de entrada} y
124 @ref{Estructura del archivo}.)
127 Manual de aprendizaje:
128 @rlearning{Trabajar sobre los archivos de entrada},
129 @rlearning{Explicación de las expresiones musicales},
130 @rlearning{La partitura es una (única) expresión musical compuesta}.
133 @node Varias partituras en un libro
134 @subsection Varias partituras en un libro
135 @translationof Multiple scores in a book
138 @cindex movimientos, varios
140 Un documento puede contener varias piezas de música y texto. Son
141 ejemplos un libro de estudios o una parte orquestal con varios
142 movimientos. Cada movimiento se introduce con un bloque
147 @var{@dots{}música@dots{}}
151 y los textos se introducen con un bloque @code{\markup}:
155 @var{@dots{}texto@dots{}}
161 Todos los movimientos y textos que aparecen en el mismo archivo
162 @file{.ly} se tipografían normalmente en la forma de un solo
177 Una excepción importante se da dentro de los documentos de
178 lilypond-book, en los que tenemos que escribir explícitamente un
179 bloque @code{\book}, pues en caso contrario sólo aparecerá en la
180 salida el primer @code{\score} o @code{\markup}.
182 El encabezamiento de cada pieza se puede poner dentro del bloque
183 @code{\score}. Antes de cada movimiento, se imprime el nombre de
184 la pieza (@code{piece}) extraído del encabezamiento. El título
185 del libro entero se puede poner dentro del bloque @code{\book},
186 pero si no está presente se inserta el encabezamiento
187 @code{\header} que está al principio del archivo.
191 title = "Ocho miniaturas"
192 composer = "Igor Stravinsky"
196 \header @{ piece = "Romanze" @}
199 @dots{}texto de la segunda estrofa@dots{}
202 @dots{}texto de la tercera estrofa@dots{}
206 \header @{ piece = "Menuetto" @}
212 Se pueden agrupar distintas piezas de música en partes de un
213 libro utilizando bloques @code{\bookpart}. Las partes de libro
214 se separan por medio de saltos de página, y pueden dar comienzo
215 con un título, como el libro propiamente dicho, mediante la
216 especificación del bloque @code{\header}.
221 title = "Título del libro"
222 subtitle = "Primera parte"
229 subtitle = "Segunda parte"
237 @node Varios archivos de salida a partir de uno de entrada
238 @subsection Varios archivos de salida a partir de uno de entrada
239 @translationof Multiple output files from one input file
241 Si queremos varios archivos de salida a partir del mismo archivo
242 @file{.ly}, podemos escribir varios bloques @code{\book}, donde
243 cada uno de estos bloques @code{\book} dará como resultado un
244 archivo de salida distinto. Si no especificamos ningún bloque
245 @code{\book} en el archivo, LilyPond trata implícitamente todo el
246 archivo como un solo bloque @code{\book}, véase @ref{Estructura
249 Al producir varios archivos a partir de un solo archivo fuente,
250 Lilypond se asegura de que ninguno de los archivos de salida de
251 ningún bloque @code{\book} sobreescribe el archivo de salida
252 producido por un @code{\book} anterior del mismo archivo de
255 Lo hace añadiendo un sufijo al nombre de la salida para cada
256 libro @code{\book} que utiliza el nombre del archivo de salida
257 predeterminado, derivado del archivo fuente de entrada.
259 El comportamiento predeterminado es añadir un sufijo con el
260 número de versión para cada nombre que pueda coincidir; así:
277 en el archivo fuente @file{eightminiatures.ly}, produce
281 @file{eightminiatures.pdf},
283 @file{eightminiatures-1.pdf} y
285 @file{eightminiatures-2.pdf}.
289 @node Nombres de los archivos de salida
290 @subsection Nombres de los archivos de salida
291 @translationof Output file names
293 @funindex \bookOutputSuffix
294 @funindex \bookOutputName
296 Lilypond le ofrece unos mecanismos que le permiten controlar los
297 nombres de archivo que se utilizan por parte de los diversos
298 motores finales al producir los archivos de salida.
300 En la sección anterior vimos cómo Lilypond evita las
301 coincidencias de nombres al producir varias salidas a partir de
302 un único archivo fuente de entrada. También podemos especificar
303 nuestros propios sufijos para cada bloque @code{\book}, de manera
304 que podemos producir, por ejemplo, archivos con los nombres
305 @file{eightminiatures-Romanze.pdf},
306 @file{eightminiatures-Menuetto.pdf} y
307 @file{eightminiatures-Nocturne.pdf} añadiendo una declaración
308 @code{\bookOutputSuffix} dentro de cada bloque @code{\book}.
312 \bookOutputSuffix "Romanze"
317 \bookOutputSuffix "Menuetto"
322 \bookOutputSuffix "Nocturne"
328 También podemos especificar un nombre de archivo de salida
329 diferente para cada bloque @code{book}, mediante la utilización
330 de declaraciones @code{\bookOutputName}:
334 \bookOutputName "Romanze"
339 \bookOutputName "Menuetto"
344 \bookOutputName "Nocturne"
350 El código anterior produce los siguientes archivos de salida:
356 @file{Menuetto.pdf} y
362 @node Estructura del archivo
363 @subsection Estructura del archivo
364 @translationof File structure
374 Un archivo @file{.ly} puede contener cualquier número de
375 expresiones del nivel superior, donde una expresión del nivel
376 superior es una de las siguientes posibilidades:
380 Una definición de salida, como @code{\paper}, @code{\midi} y
381 @code{\layout}. Tal definición en el nivel más alto cambia los
382 ajustes predeterminados para todo el libro. Si se introduce más
383 de una de estas definiciones del mismo tipo en el nivel más alto,
384 las definiciones se combinan, pero en situaciones de conflicto
385 las definiciones más tardías tienen preferencia. Para ver los
386 detalles sobre cómo afecta al bloque @code{\layout}, consulte
387 @ref{El bloque layout,,El bloque @code{@bs{}layout}}.
390 Una expresión directa de Scheme, como
391 @code{#(set-default-paper-size "a7" 'landscape)} o
392 @code{#(ly:set-option 'point-and-click #f)}.
395 Un bloque @code{\header}. Esto establece el bloque de
396 encabezamiento global (es decir, al principio del archivo). Es
397 el bloque que contiene los ajustes predeterminados de los campos
398 de encabezamientos como el compositor, título, etc. para todos
399 los libros que están dentro del archivo (véase
400 @ref{Explicación de los títulos}).
403 Un bloque @code{\score}. Esta partitura se reúne con otras
404 partituras del nivel superior, y se combina con ellas formando un
405 @code{\book} (libro) único. Este comportamiento se puede cambiar
406 estableciendo el valor de la variable
407 @code{toplevel-score-handler} en el nivel superior. El
408 @emph{handler} predeterminado se define en el archivo de inicio
409 @file{../scm/lily.scm}.
412 Un bloque @code{\book} combina lógicamente varios movimientos (es
413 decir, varios bloques @code{\score}) en un solo documento. Si
414 hay varias partituras @code{\score}, se crea un solo archivo de
415 salida para cada bloque @code{\book}, en el que se concatenan
416 todos los movimientos correspondientes. La única razón para
417 especificar explícitamente bloques @code{\book} en un archivo de
418 entrada @file{.ly} es si queremos crear varios archivos de salida
419 a partir de un único archivo de entrada. Una excepción se da
420 dentro de los documentos de lilypond-book, en los que tenemos que
421 escribir explícitamente un bloque @code{\book} si queremos tener
422 más de una única partitura @code{\score} o marcado @code{\markup}
423 en el mismo ejemplo. Se puede cambiar este comportamiento
424 estableciendo el valor de la variable
425 @code{toplevel-book-handler} en el nivel superior. El
426 @emph{handler} predeterminado se define en el archivo de inicio
427 @file{../scm/lily.scm}.
430 Un bloque @code{\bookpart}. Un libro puede dividirse en varias
431 partes, utilizando bloques @code{\bookpart}, con objeto de
432 facilitar la inserción de saltos de página o usar distintos
433 ajustes de @code{\paper} en las distintas partes.
436 Una expresión musical compuesta, como
441 Esto añade la pieza al @code{\score} y la conforma dentro de un
442 libro único junto a todas las demás partituras @code{\score} y
443 expresiones musicales del nivel superior. En otras palabras, un
444 archivo que contiene sólo la expresión musical anterior se
462 Se puede cambiar este comportamiento estableciendo el valor de la
463 variable @code{toplevel-music-handler} en el nivel más alto. El
464 @emph{handler} predeterminado se define en el archivo de inicio
465 @file{../scm/lily.scm}.
468 Un texto de marcado, por ejemplo una estrofa
471 2. Estrofa dos, línea uno
475 Los textos de marcado se colocan encima, en medio o debajo de las
476 partituras o expresiones musicales, según donde aparezcan
484 fulano = @{ c4 d e d @}
487 Esto se puede utilizar más tarde en el archivo escribiendo
488 @code{\fulano}. El nombre de las variables ha de ser
489 exclusivamente alfabético; sin números, guiones ni barras bajas.
493 El ejemplo siguiente muestra tres cosas que se pueden introducir
494 en el nivel superior:
498 % No justificar la salida
509 En cualquier punto del archivo se pueden introducir cualquiera de
510 las instrucciones léxicas siguientes:
513 @item @code{\version}
514 @item @code{\include}
515 @item @code{\sourcefilename}
516 @item @code{\sourcefileline}
517 @item Un comentario de una línea, determinado por un símbolo @code{%}
521 Un comentario de varias líneas, delimitado por @code{%@{ @dots{}
526 @cindex espacios en blanco
528 Por lo general se ignoran los espacios entre elementos del flujo
529 de entrada, y se pueden omitir o aumentar tranquilamente para
530 mejorar la legibilidad. Sin embargo, los espacios se deben
531 utilizar siempre para evitar errores, en las siguientes
536 @item Alrededor de todas y cada una de las llaves curvas
537 de apertura y cierre.
539 @item A continuación de las instrucciones y variables, es decir,
540 todos los elementos que comienzan con un signo @code{\} de barra
543 @item A continuación de todo elemento que se deba interpretar
544 como expresión de Scheme, es decir, todo elemento que comience
545 por un signo@tie{}@code{#}.
547 @item Para separar los elementos de una expresión de Scheme.
549 @item Dentro de @code{lyricmode} antes y después de las instrucciones
550 @code{\set} y @code{\override}.
555 Manual de aprendizaje:
556 @rlearning{Cómo funcionan los archivos de entrada de LilyPond}.
558 Referencia de la notación:
559 @ref{Explicación de los títulos},
560 @ref{El bloque layout,,El bloque @code{@bs{}layout}}.
563 @node Títulos y encabezamientos
564 @section Títulos y encabezamientos
565 @translationof Titles and headers
568 @cindex encabezamientos
569 @cindex pies de página
571 Casi toda la música impresa tiene un título y el nombre del
572 compositor; ciertas piezas tienen mucha más información.
575 * Crear títulos encabezamientos y pies de página::
576 * Títulos encabezamientos y pies de página personalizados::
577 * Creación de metadatos de PDF::
578 * Crear notas al pie::
579 * Referencia a números de página::
584 @node Crear títulos encabezamientos y pies de página
585 @subsection Crear títulos, encabezamientos y pies de página
586 @translationof Creating titles headers and footers
589 * Explicación de los títulos::
590 * Presentación predeterminada de los títulos de partes de libro y partitura::
591 * Disposición predeterminada de las cabeceras y pies de página::
595 @node Explicación de los títulos
596 @unnumberedsubsubsec Explicación de los títulos
597 @translationof Titles explained
599 Cada bloque @code{\book} de un solo archivo de entrada produce un
600 archivo de salida distinto, véase @ref{Estructura del archivo}.
601 Dentro de cada archivo de salida están disponibles tres tipos de
602 zonas para títulos: @emph{Títulos de libro} al principio de cada
603 libro, @emph{Títulos de parte de libro} al principio de cada
604 parte de un libro y @emph{Títulos de partitura} al comienzo de
607 Los valores de los campos para encabezamientos tales como
608 @code{title} (para el título) y @code{composer} (para el autor)
609 se establecen en bloques @code{\header} (para ver la sintaxis de
610 los bloques @code{\header} y una lista completa de los campos
611 disponibles de forma predeterminada, consulte @ref{Presentación
612 predeterminada de los títulos de partes de libro y partitura}).
613 Tanto los títulos de libro como los títulos de parte de libro y
614 los títulos de partitura pueden contener los mismos campos,
615 aunque de forma predeterminada los campos de los títulos de
616 partitura se limitan a @code{piece} (pieza) y @code{opus}.
618 Los bloques @code{\header} se pueden situar en cuatro lugares
619 distintos para formar una jerarquía descendente de bloques
625 Al principio del archivo de entrada, antes de cualquier otro bloque
626 @code{\book}, @code{\bookpart} o @code{\score}.
629 Dentro de un bloque @code{\book} pero fuera de los bloques
630 @code{\bookpart} y @code{\score} que están dentro de ese libro.
633 Dentro de un bloque @code{\bookpart} pero fuera de cualquier bloque
634 @code{\score} dentro de dicha parte de libro.
637 Después de la expresión musical de un bloque @code{\score}.
641 Los valores de los campos se filtran a través de esta jerarquía,
642 persistiendo aquellos que se establecen más arriba a no ser que
643 se sobreescriban por un valor establecido más abajo en la
649 El título de un libro deriva de los campos establecidos al
650 principio del archivo de entrada, modificado por campos
651 establecidos en el bloque @code{\book}. Los campos resultantes
652 se usan para imprimir el título de libro para dicho libro,
653 siempre y cuando haya otro material que genere una página al
654 comienzo del libro, antes de la primera parte de libro. Es
655 suficiente una sola instrucción @code{\pageBreak}.
658 Un título de parte de libro se deriva de los campos fijados al
659 principio del archivo de entrada, modificado por los campos
660 establecidos dentro del bloque @code{\book}, y posteriormente
661 modificado por los campos que se fijan dentro del bloque
662 @code{\bookpart}. Los valores resultantes se usan para imprimir
663 el título de parte de libro para esa parte.
666 Un título de partitura se deriva de los campos que se fijan al
667 principio del archivo de entrada, modificados por los campos
668 fijados dentro del bloque @code{\book}, posteriormente
669 modificados por los campos que se fijan dentro del bloque
670 @code{\bookpart} y finalmente modificados por los campos
671 establecidos dentro del bloque @code{\score}. Los valores
672 resultantes se utilizan para imprimir el título de partitura.
673 Observe, sin embargo, que de forma predeterminada solamente se
674 imprimen los campos @code{piece} y @code{opus} en los títulos de
675 partitura a no ser que la variable de @code{\paper},
676 @code{print-all-headers}, tenga el valor @code{#t}.
680 @warning{Recuerde que al poner un bloque @bs{}@code{header}
681 dentro de un bloque @bs{}@code{score}, la expresión musical debe
682 aparecer antes del bloque @bs{}@code{header}.}
684 No es necesario aportar bloques @code{\header} en los cuatro
685 lugares: cualquiera de ellos o incluso todos pueden omitirse. De
686 forma similar, los archivos de entrada sencillos pueden omitir
687 los bloques @code{\book} y @code{\bookpart}, dejando que se creen
690 Si el libro solamente tiene una partitura, el bloque
691 @code{\header} debiera situarse normalmente al principio del
692 archivo de forma que solamente se produce una zona de título de
693 parte de libro, haciendo que estén disponibles para su uso todos
694 los títulos de encabezamientos.
696 Si el libro tiene varias partituras, son posibles distintas
697 combinaciones de bloques @code{\header}, según los distintos
698 tipos de publicaciones musicales. Por ejemplo, si la publicación
699 contiene varias piezas del mismo autor, un bloque @code{\header}
700 colocado al principio del archivo que especifique el título del
701 libro y el autor, con bloques @code{\header} en cada bloque
702 @code{\score} que especifique la @code{piece} y/o el @code{opus}
703 sería lo más adecuado, como aquí:
705 @lilypond[papersize=a5,quote,verbatim,noragged-right]
708 composer = "J. S. Bach."
712 \new Staff \relative {
715 \repeat unfold 2 { g,16( d' b') a b d, b' d, } |
716 \repeat unfold 2 { g,16( e' c') b c e, c' e, } |
724 \new Staff \relative {
728 <g, d' b'~>4 b'16 a( g fis) g( d e fis) g( a b c) |
729 d16( b g fis) g( e d c) b(c d e) fis( g a b) |
737 Son posibles disposiciones más complejas. Por ejemplo, los
738 campos de texto extraídos del bloque @code{\header} de un libro
739 se pueden imprimir en todos los títulos de partitura, con ciertos
740 campos sobreescritos y otros suprimidos manualmente:
742 @lilypond[papersize=a5,quote,verbatim,noragged-right]
745 print-all-headers = ##t
748 title = "DAS WOHLTEMPERIRTE CLAVIER"
750 % Do not display the default LilyPond footer for this book
753 \markup { \vspace #1 }
757 \new Staff { \clef "bass" s1 }
760 title = "PRAELUDIUM I"
762 % Do not display the subtitle for this score
769 \new Staff { \clef "bass" s1 }
773 subsubtitle = "A 4 VOCI"
775 % Do not display the subtitle for this score
783 Referencia de la notación:
784 @ref{Estructura del archivo},
785 @ref{Presentación predeterminada de los títulos de partes de libro y partitura},
786 @ref{Personalización de los títulos}.
789 @node Presentación predeterminada de los títulos de partes de libro y partitura
790 @unnumberedsubsubsec Presentación predeterminada de los títulos de partes de libro y partitura
791 @translationof Default layout of bookpart and score titles
793 Este ejemplo muestra todas las variables impresas de @code{\header}:
796 @lilypond[papersize=a6landscape,quote,verbatim,noragged-right]
799 % Los siguientes campos están centrados
800 dedication = "Dedication (dedicatoria)"
801 title = "Title (título)"
802 subtitle = "Subtitle (subtítulo)"
803 subsubtitle = "Subsubtitle (sub-subtítulo)"
804 % Los siguientes campos se distribuyen regularmente sobre una línea
805 % el campo "instrument" también aparece en las siguientes páginas
806 instrument = \markup \with-color #green "Instrument (instrumento)"
807 poet = "Poet (poeta)"
808 composer = "Composer (autor)"
809 % Los siguientes campos se sitúan en los extremos opuestos de la misma línea
810 meter = "Meter (metro)"
811 arranger = "Arranger (arreglista)"
812 % Los siguientes campos están centrados en la parte inferior
813 tagline = "La tagline o línea de etiqueta va al final de la última página"
814 copyright = "El copyright va al final de la primera página"
819 % Los siguientes campos se colocan en los extremos de una línea
820 piece = "Piece (pieza) 1"
827 % Los siguientes campos se sitúan en los extremos de una línea
828 piece = "Piece (pieza) 2 en la misma página"
836 % Los siguientes campos se sitúan en los extremos de una línea
837 piece = "Piece (pieza) 3 en una página nueva"
848 El nombre de instrumento se repite en todas las páginas.
851 Solamente @code{piece} (la pieza) y @code{opus} se imprimen en
852 una @code{\score} cuando la variable de papel
853 @code{print-all-headers} se establece a @code{##f} (el valor
857 @c Is the bit about \null markups true? -mp
858 Los campos de texto que se dejan sin establecer dentro de un
859 bloque @code{\header} se sustituyen por elementos de marcado
860 nulos @code{\null} de manera que no ocupen espacio
864 Los ajustes predeterminados para @code{scoreTitleMarkup} sitúan
865 los campos de texto @code{piece} y @code{opus} en extremos
866 opuestos de la misma línea.
870 Para cambiar la disposición predeterminada, véase
871 @ref{Personalización de los títulos}.
875 Si un bloque @code{\book} comienza inmediatamente con un bloque
876 @code{\bookpart}, no se imprime ningún título de libro, pues no
877 existe ninguna página en que imprimirlo. Si es necesario un
878 título de libro, inicie el bloque @code{\book} con algún material
879 de marcado o con una instrucción @code{\pageBreak}.
881 Utilice la variable @code{breakbefore} dentro de un bloque
882 @code{\header} que está propiamente dentro de un bloque
883 @code{\score} para hacer que los títulos del bloque
884 @code{\header} del nivel superior aparezcan ocupando toda la
885 primera página, empezando la música (definida en el bloque
886 @code{\score}) en la página siguiente.
889 @lilypond[papersize=c7landscape,verbatim,noragged-right]
892 title = "Este es mi Title (título)"
893 subtitle = "Este es mi Subtitle (subtítulo)"
894 copyright = "Este es el final de la primera página"
897 \repeat unfold 4 { e'' e'' e'' e'' }
899 piece = "Esto es la música"
907 Manual de aprendizaje:
908 @rlearning{Cómo funcionan los archivos de entrada de LilyPond}
910 Referencia de la notación:
911 @ref{Personalización de los títulos},
912 @ref{Estructura del archivo}.
915 @file{ly/titling-init.ly}.
918 @node Disposición predeterminada de las cabeceras y pies de página
919 @unnumberedsubsubsec Disposición predeterminada de las cabeceras y pies de página
920 @translationof Default layout of headers and footers
922 Las @emph{cabeceras} y los @emph{pies} de página son líneas de
923 texto que aparecen en la parte más alta y en la más baja de las
924 páginas separadas del texto principal de un libro. Se controlan
925 mediante las siguientes variables de @code{\paper}:
928 @item @code{oddHeaderMarkup} (marcado de cabecera impar)
929 @item @code{evenHeaderMarkup} (marcado de cabecera par)
930 @item @code{oddFooterMarkup} (marcado de pie impar)
931 @item @code{evenFooterMarkup} (marcado de pie par)
934 Estas variables de marcado sólo pueden acceder a los campos de
935 texto extraídos de bloques @code{\header} del nivel superior (que
936 se aplican a todas las partituras del libro) y se definen en el
937 archivo @file{ly/titling-init.ly}. De forma predeterminada:
942 los números de página se sitúan automáticamente en el extremo
943 superior izquierdo (si es par) o superior derecho (si es impar),
944 a partir de la segunda página.
947 el campo de texto @code{instrument} se sitúa en el centro en cada
948 página, a partir de la segunda página.
951 el texto de @code{copyright} se centra en la parte baja de la
955 la línea @code{tagline} se centra al final de la última página, y
956 debajo del texto de @code{copyright} si sólo hay una página.
960 La línea predeterminada de pie de página de LilyPond se puede
961 cambiar añadiendo un campo @code{tagline} en el bloque
962 @code{\header} del nivel superior.
964 @lilypond[papersize=a8landscape,verbatim]
967 tagline = "... music notation for Everyone"
977 Para eliminar la línea de pie de página predeterminada de
978 LilyPond, establezca el valor de @code{tagline} a @code{##f}.
981 @node Títulos encabezamientos y pies de página personalizados
982 @subsection Títulos, encabezamientos y pies de página personalizados
983 @translationof Custom titles headers and footers
985 @c TODO: somewhere put a link to header spacing info
986 @c (you'll have to explain it more in NR 4).
989 * Formateo personalizado del texto de los títulos::
990 * Personalización de los títulos::
991 * Disposición personalizada de cabeceras y pies de página::
995 @node Formateo personalizado del texto de los títulos
996 @unnumberedsubsubsec Formateo personalizado del texto de los bloques de título
997 @translationof Custom text formatting for titles
999 Se pueden usar instrucciones @code{\markup} estándar para
1000 personalizar el texto de cualquier cabecera, pie o título dentro
1001 del bloque @code{\header}.
1003 @lilypond[quote,verbatim,noragged-right]
1007 piece = \markup { \fontsize #4 \bold "PRAELUDIUM I" }
1008 opus = \markup { \italic "BWV 846" }
1014 Referencia de la notación:
1015 @ref{Formatear el texto}.
1018 @node Personalización de los títulos
1019 @unnumberedsubsubsec Personalización de los títulos
1020 @translationof Custom layout for titles
1022 @cindex bookTitleMarkup
1023 @cindex scoreTitleMarkup
1024 @funindex bookTitleMarkup
1025 @funindex scoreTitleMarkup
1027 Las instrucciones @code{\markup} dentro del bloque @code{\header}
1028 son útiles para dar un formato simple al texto, pero no permiten
1029 un control preciso sobre la colocación de los títulos. Para
1030 personalizar la colocación de los campos de texto, cambie una o
1031 las dos variables de @code{\paper} siguientes:
1034 @item @code{bookTitleMarkup} (marcado de título del libro)
1035 @item @code{scoreTitleMarkup} (marcado de título de la partitura)
1038 La colocación de los títulos cuando se utilizan los valores
1039 predeterminados de estas variables de @code{\markup} se muestra
1041 @ref{Presentación predeterminada de los títulos de partes de libro y partitura}.
1043 Los ajustes predeterminados para @code{scoreTitleMarkup} tal y
1044 como están definidos en el archivo @file{ly/titling-init.ly} son:
1047 scoreTitleMarkup = \markup @{ \column @{
1048 \on-the-fly \print-all-headers @{ \bookTitleMarkup \hspace #1 @}
1050 \fromproperty #'header:piece
1051 \fromproperty #'header:opus
1057 Esto sitúa los campos de texto @code{piece} y @code{opus} en extremos
1058 opuestos de la misma línea:
1060 @lilypond[quote,verbatim,noragged-right]
1064 piece = "PRAELUDIUM I"
1070 Este ejemplo redefine @code{scoreTitleMarkup} de manera que el
1071 campo de texto @code{piece} aparece centrado y en un tipo de
1072 letra grande y en negrita.
1074 @lilypond[papersize=a5,quote,verbatim,noragged-right]
1078 scoreTitleMarkup = \markup {
1081 \fontsize #4 \bold \fromproperty #'header:piece
1082 \fromproperty #'header:opus
1086 \header { tagline = ##f }
1090 piece = "PRAELUDIUM I"
1097 Los campos de texto que normalmente no son efectivos dentro de
1098 los bloques @code{\header} de una partitura se pueden imprimir el
1099 la zona del Título de la partitura si se coloca
1100 @code{print-all-headers} dentro del bloque @code{\paper}. Una
1101 desventaja de la utilización de este método es que los campos de
1102 texto que están orientados específicamente para la zona del
1103 título de parte de libro han de suprimirse manualmente en cada
1104 uno de los bloques @code{\score}. Véase @ref{Explicación de los
1107 Para evitarlo, añada el campo de texto deseado a la definición de
1108 @code{scoreTitleMarkup}. En el ejemplo siguiente, el campo de
1109 texto @code{composer} (asociado normalmente con
1110 @code{bookTitleMarkup}) se añade a @code{scoreTitleMarkup},
1111 permitiendo que cada partitura muestre un compositor diferente:
1113 @lilypond[papersize=a5,quote,verbatim,noragged-right]
1117 scoreTitleMarkup = \markup {
1120 \fontsize #4 \bold \fromproperty #'header:piece
1121 \fromproperty #'header:composer
1125 \header { tagline = ##f }
1130 composer = "Christian Petzold"
1137 composer = "François Couperin"
1143 También podemos crear nuestros propios campos de texto
1144 personalizados, y referirnos a ellos en la definición del
1145 elemento de marcado.
1147 @lilypond[papersize=a5,quote,verbatim,noragged-right]
1151 scoreTitleMarkup = \markup {
1154 \override #`(direction . ,UP) {
1156 \center-align \fontsize #-1 \bold
1157 \fromproperty #'header:mycustomtext %% User-defined field
1158 \center-align \fontsize #4 \bold
1159 \fromproperty #'header:piece
1162 \fromproperty #'header:opus
1166 \header { tagline = ##f }
1171 mycustomtext = "A 4 VOCI" %% User-defined field
1179 Referencia de la notación:
1180 @ref{Explicación de los títulos}.
1183 @node Disposición personalizada de cabeceras y pies de página
1184 @unnumberedsubsubsec Disposición personalizada de cabeceras y pies de página
1185 @translationof Custom layout for headers and footers
1187 @c can make-header and make-footer be removed from
1188 @c paper-defaults-init.ly? -mp
1190 Las instrucciones @code{\markup} dentro del bloque @code{\header}
1191 son de utilidad para dar formato al texto de una manera sencilla,
1192 pero no permiten un control preciso sobre la colocación de las
1193 cabeceras y los pies de página. Para personalizar la colocación
1194 de los campos de texto, use una o más de las siguientes variables
1198 @item @code{oddHeaderMarkup} (marcado de encabezamiento impar)
1199 @item @code{evenHeaderMarkup} (marcado de encabezamiento par)
1200 @item @code{oddFooterMarkup} (marcado de pie de página impar)
1201 @item @code{evenFooterMarkup} (marcado de pie de página par)
1204 @cindex marcado condicional
1206 @funindex \on-the-fly
1208 La instrucción de marcado @code{\on-the-fly} se puede utilizar
1209 para añadir elementos de forma condicional al texto de
1210 encabezamiento y pie de página definido dentro del bloque
1211 @code{\paper}, usando la sintaxis siguiente:
1214 @code{variable} = @code{\markup} @{
1216 @code{\on-the-fly} \@var{procedimiento} @var{marcado}
1221 El @var{procedimiento} se llama cada vez que se evalúa la
1222 instrucción @code{\markup} en que ésta aparece. El
1223 @var{procedimiento} debería comprobar si se cumple una condición
1224 determinada e interpretar (es decir: imprimir) el argumento
1225 @var{marcado} si, y sólo si, la condición es verdadera.
1227 Se proveen un cierto número de procedimientos ya hechos para la
1228 comprobación de diversas condiciones:
1231 @multitable {print-page-number-check-first-----} {¿es el núm. de páginas en la parte de libro > 1?-----}
1233 @headitem Nombre del procedimiento @tab Condición que se comprueba
1235 @item print-page-number-check-first @tab ¿debería imprimirse esta página?
1236 @item create-page-number-stencil @tab ¿es print-page-numbers verdadero?
1237 @item print-all-headers @tab ¿es print-all-headers verdadero?
1238 @item first-page @tab ¿es la primera página del libro?
1239 @item (on-page nmbr) @tab ¿es el número de página = nmbr?
1240 @item last-page @tab ¿es la última página del libro?
1241 @item not-first-page @tab ¿no es la primera página del libro?
1242 @item part-first-page @tab ¿es la primera página de la parte de libro?
1243 @item part-last-page @tab ¿es la última página de la parte de libro?
1244 @item not-single-page @tab ¿es el núm. de páginas en la parte de libro > 1?
1249 El ejemplo siguiente centra los números de página en la parte
1250 baja de las páginas. En primer lugar, los ajustes
1251 predeterminados para @code{oddHeaderMarkup} y
1252 @code{evenHeaderMarkup} se eliminan definiéndolos como un marcado
1253 @emph{nulo}. Después de esto, se redefine @code{oddFooterMarkup}
1254 con el número de página centrado. Finalmente,
1255 @code{evenFooterMarkup} recibe la misma disposición definiéndola
1256 como @code{\oddFooterMarkup}:
1258 @lilypond[papersize=a8,quote,verbatim,noragged-right]
1261 print-page-number = ##t
1262 print-first-page-number = ##t
1263 oddHeaderMarkup = \markup \null
1264 evenHeaderMarkup = \markup \null
1265 oddFooterMarkup = \markup {
1267 \on-the-fly \print-page-number-check-first
1268 \fromproperty #'page:page-number-string
1271 evenFooterMarkup = \oddFooterMarkup
1274 \new Staff { s1 \break s1 \break s1 }
1279 Se pueden combinar varias condiciones de @code{\on-the-fly} con
1280 un operador @q{and}, por ejemplo:
1283 @code{\on-the-fly \first-page}
1284 @code{\on-the-fly \last-page}
1285 @code{@{ \markup @dots{} \fromproperty #'header: @dots{} @}}
1288 determina si la salida es una sola página.
1291 Referencia de la notación:
1292 @ref{Explicación de los títulos},
1293 @ref{Presentación predeterminada de los títulos de partes de libro y partitura}.
1295 Archivos instalados:
1296 @file{../ly/titling-init.ly}.
1298 @node Creación de metadatos de PDF
1299 @subsection Creación de metadatos de PDF
1300 @translationof Creating PDF metadata
1302 @cindex metadatos de PDF
1304 Además de mostrarse en la salida impresa, las variables de
1305 encabezamiento de @code{\header} se usan para establecer los
1306 metadatos de PDF (la información que muestran los lectores de PDF
1307 como @code{propiedades} del archivo). Por ejemplo, si se
1308 establece la propiedad @code{title} del bloque @code{header} como
1309 @q{Sinfonía núm. 1}, el documento PDF llevará también este
1314 @code{title = "Sinfonía núm. 1"}
1318 Si quiere fijar el título de la salida impresa con un texto pero
1319 quiere que la propiedad de título del PDF tenga un texto
1320 diferente, puede usar @code{pdftitle} como se muestra a
1325 @code{title = "Sinfonía núm. 1"}
1326 @code{pdftitle = "Sinfonía núm. 1 de Beethoven"}
1330 Todas las variables @code{title}, @code{subject},
1331 @code{keywords}, @code{subtitle}, @code{composer},
1332 @code{arranger}, @code{poet}, @code{author} y @code{copyright}
1333 establecen propiedades del PDF y pueden hacerse preceder de
1334 @q{pdf} para fijar una propiedad del archivo PDF a un valor
1335 distinto del de la salida impresa.
1337 La propiedad de PDF @code{Creator} se fija automáticamente a
1338 @q{LilyPond} más la versión actual de LilyPond, y las variables
1339 @code{CreationDate} y @code{ModDate} se fijan a la fecha y hora
1340 actuales. Se puede sobreescribir @code{ModDate} mediante el
1341 establecimiento de un valor para la variable de cabecera
1342 @code{moddate} (o @code{pdfmoddate}) a una cadena de fecha de PDF
1345 @node Crear notas al pie
1346 @subsection Crear notas al pie
1347 @translationof Creating footnotes
1349 @cindex notas al pie
1351 Se pueden crear dos tipos de notas al pie: automáticas y manuales.
1354 * Notas al pie dentro de expresiones musicales::
1355 * Notas al pie en texto independiente::
1358 @node Notas al pie dentro de expresiones musicales
1359 @unnumberedsubsubsec Notas al pie dentro de expresiones musicales
1360 @translationof Footnotes in music expressions
1362 @cindex notas al pie dentro de expresiones musicales
1365 @subsubsubheading Panorámica de las notas al pie
1367 Las notas al pie dentro de expresiones musicales caen dentro de
1371 @item Notas al pie basadas en eventos
1372 Se adjuntan a un evento en particular. Son ejemplos de tales
1373 eventos las notas sueltas, las articulaciones (como indicaciones
1374 de digitación, acentos, indicaciones dinámicas) y los
1375 post-eventos (como las ligaduras de expresión y las barras de
1376 corchea manuales). La forma general de las notas al pie basadas
1377 en eventos es como sigue:
1380 [@var{dirección}] \footnote [@var{marca}] @var{desplazamiento} @var{texto-de-la-nota} @var{música}
1383 @item Notas al pie basadas en tiempo
1384 Se ligan a un punto temporal determinado, dentro de un contexto
1385 musical. Algunas instrucciones como @code{\time} y @code{\clef}
1386 en realidad no usan eventos para crear objetos como la indicación
1387 de compás y la clave. Un acorde tampoco crea un evento por sí
1388 mismo: su plica o corchete se crea al final de un paso de tiempo
1389 (nominalmente, a través de uno de los eventos de nota que
1390 contiene). Una nota al pie basada en tiempo permite anotar tales
1391 objetos de presentación sin referirse a ningún evento.
1393 Una nota al pie basada en tiempo permite que tales objetos de
1394 presentación se puedan anotar sin hacer referencia a un evento.
1395 La forma general para las notas al pie basadas en tiempo es:
1398 \footnote [@var{marca}] @var{desplazamiento} @var{texto-de-la-nota} [@var{Contexto}].@var{Nombre-del-Grob}
1403 Los elementos para las dos formas son como sigue:
1408 Si (y sólo si) el @code{\footnote} se está aplicando a un
1409 post-evento o articulación, debe ir precedida de un indicador de
1410 dirección (@code{-, _, ^}) con el objeto de adjuntar la
1411 @var{música} (con una marca de nota al pie) a la nota o silencio
1415 es un elemento de marcado o cadena de caracteres que especifica
1416 la marca de nota al pie que se usa para marcar tanto el punto de
1417 referencia como la propia nota al pie en la parte inferior de la
1418 página. Se puede omitir (o, de forma equivalente, sustituirse
1419 por @code{\default}) en cuyo caso se genera un número
1420 secuencialmente de forma automática. Tales secuencias numéricas
1421 se reinician en cada página que contiene una nota al pie.
1423 @item desplazamiento
1424 es una pareja de números tal como @samp{#(2 . 1)} que especifica
1425 los desplazamientos en X y en Y en unidades de espacios de
1426 pentagrama a partir del límite del objeto en que se desea situar
1427 la marca. Los valores de desplazamiento positivos se toman a
1428 partir del borde superior derecho, los valores negativos a partir
1429 del borde inferior izquierdo y cero implica que la marca se
1430 centra sobre el borde.
1433 es el contexto en que se crea el grob que recibe la nota al pie.
1434 Se puede omitir si el grob está en un contexto del nivel inferior,
1435 p. ej. un contexto @code{Voice}.
1437 @item Nombre-del-Grob
1438 especifica un tipo de grob que marcar (como @samp{Flag} para el
1439 corchete). Si se da, la nota al pie no se adjunta a una
1440 expresión musical en particular, sino a todos los grobs del tipo
1441 especificado que ocurren en dicho momento de tiempo musical.
1443 @item texto-de-la-nota
1444 es el elemento de marcado o cadena de caracteres que especifica
1445 el texto de la nota al pie que utilizar en la parte baja de la
1449 es el evento musical, post-evento o articulación que se
1454 @subsubsubheading Notas al pie basadas en eventos
1456 @cindex Notas al pie, basadas en eventos
1458 Una nota al pie se adjunta a un objeto de presentación causado
1459 directamente por el evento que corresponde a @var{música}, con la
1463 \footnote [@var{marca}] @var{desplazamiento} @var{texto-de-la-nota} @var{música}
1467 @lilypond[quote,verbatim,papersize=a8landscape]
1469 \header { tagline = ##f }
1471 \footnote #'(-1 . 3) "Una nota" a4
1473 \footnote #'(2 . 2) "Un silencio" r4
1479 No es posible marcar un acorde @emph{completo} con una nota al
1480 pie basada en evento: un acorde, incluso aquel que contiene una
1481 sola nota, no produce un verdadero evento por sí mismo. Sin
1482 embargo, las notas individuales que están @emph{dentro} del
1483 acorde sí se pueden marcar:
1486 @lilypond[quote,verbatim,papersize=a8landscape]
1488 \header { tagline = ##f }
1490 \footnote #'(2 . 3) "No funciona" <a-3>2
1491 <\footnote #'(-2 . -3) "Funciona" a-3>4
1492 <a-3 \footnote #'(3 . 1/2) "También funciona" c-5>4
1497 Si se desea que la nota al pie se adjunte a un post-evento o
1498 articulación, la instrucción @code{\footnote} @emph{debe} ir
1499 precedida por un indicador de dirección, @code{-, _, ^}, y
1500 seguida por el post-evento o articulación que se desea anotar
1501 como argumento @var{música}. En esta forma, la @code{\footnote}
1502 se puede considerar como una simple copia de su último argumento
1503 con una marca de nota al pie adjunta. La sintaxis es:
1506 @var{dirección} \footnote [@var{marca}] @var{desplazamiento} @var{texto-de-la-nota} @var{música}
1510 @lilypond[quote,verbatim,papersize=a8landscape]
1512 \header { tagline = ##f }
1514 a'4_\footnote #'(0 . -1) "Ligadura forzada hacia abajo" (
1515 b8^\footnote #'(1 . 0.5) "Barra manual forzada hacia arriba" [
1518 c-\footnote #'(1 . 1) "Tenuto" --
1523 @subsubsubheading notas al pie basadas en tiempo
1525 @cindex notas al pie, basadas en tiempo
1527 Si el objeto de presentación que recibe la nota al pie está
1528 causado @emph{indirectamente} por un evento (como un objeto
1529 @code{Accidental}, alteración, o @code{Stem}, plica, causados por
1530 un evento @code{NoteHead}, cabeza de nota), el nombre del grob
1531 @var{GrobName} del objeto de presentación es necesario después
1532 del texto de la nota al pie, en lugar de @var{música}:
1535 @lilypond[quote,verbatim,papersize=a8landscape]
1537 \header { tagline = ##f }
1539 \footnote #'(-1 . -3) "Un bemol" Accidental
1541 \footnote #'(-1 . 0.5) "Otro bemol" Accidental
1543 \footnote #'(1 . -2) "Una plica" Stem
1549 Sin embargo, observe que cuando se especifica el nombre de un
1550 grob, se adjunta una nota al pie a todos los grobs de ese tipo
1551 dentro del instante de tiempo actual:
1554 @lilypond[quote,verbatim,papersize=a8landscape]
1556 \header { tagline = ##f }
1558 \footnote #'(-1 . 3) "Un bemol" Accidental
1560 \footnote #'(2 . 0.5) "Articulación" Script
1566 Una nota dentro de un acorde puede recibir una nota al pie
1567 individual, basada en evento. El único grob causado directamente
1568 por una nota de un acorde es @samp{NoteHead}, por lo que la
1569 instrucción de nota al pie basada en evento @emph{solamente} es
1570 apta para añadir una nota al pie a la @samp{NoteHead} dentro de
1571 un acorde. Todos los demás grobs de notas de acorde están
1572 causados indirectamente. La propia instrucción @code{\footnote}
1573 no ofrece ninguna sintaxis para especificar al mismo tiempo un
1574 tipo concreto de grob @emph{y también} un evento concreto al que
1575 adjuntar la nota. Sin embargo, se puede usar una instrucción
1576 @code{\footnote} basada en tiempo para especificar el tipo de
1577 grob, y luego añadir la instrucción @code{\single} como prefijo,
1578 con el objeto de que se aplique solamente al evento siguiente:
1581 @lilypond[quote,verbatim,papersize=a8landscape]
1583 \header { tagline = ##f }
1585 < \footnote #'(1 . -2) "Un La" a
1586 \single \footnote #'(-1 . -1) "Un sostenido" Accidental
1588 \single \footnote #'(0.5 . 0.5) "Un bemol" Accidental
1595 @warning{Cuando las notas al pie se adjuntan a varios elementos musicales
1596 que están dentro del mismo momento musical, como ocurre en el
1597 ejemplo anterior, las notas al pie se numeran desde los elementos
1598 más altos a los más bajos tal y como aparecen en la salida
1599 impresa, no en el orden en que se escriben en el flujo de
1602 Los objetos de presentación como las claves y las armaduras de
1603 cambio de tonalidad están, más bien, causadas por propiedades que
1604 cambian, y no por eventos. Otros, como las líneas divisorias y
1605 los números de compás, son una consecuencia directa del paso del
1606 tiempo. Por esta razón, las notas al pie sobre tales objetos
1607 tienen que basarse en su tiempo musical. Las notas al pie
1608 basadas en tiempo so preferibles también cuando se marcan cosas
1609 como las plicas y las barras de corchea en @emph{acordes}: dado
1610 que estas funcionalidades de cada acorde individual están
1611 asignadas normalmente a @emph{un solo} evento dentro del acorde,
1612 sería imprudente descansar en una elección particular.
1614 En las notas al pie basadas en tiempo, siempre se debe
1615 especificar explícitamente el objeto de presentación en cuestión,
1616 y si el grob se crea dentro de un contexto distinto al de nivel
1617 más bajo, debe especificarse el contexto apropiado.
1620 @lilypond[quote,verbatim,papersize=a8landscape]
1622 \header { tagline = ##f }
1625 \footnote #'(-0.5 . -1) "Cambio de compás" Staff.TimeSignature
1627 \footnote #'(1 . -1) "Plica de acorde" Stem
1629 \footnote #'(-0.5 . 1) "Línea divisoria" Staff.BarLine
1631 \footnote #'(0.5 . -1) "Cambio de tonalidad" Staff.KeySignature
1638 Se pueden usar marcas personalizadas como alternativas a las
1639 marcas numéricas, y se puede suprimir la línea de anotación que
1640 une el objeto marcado con su marca:
1643 @lilypond[quote,verbatim,papersize=a8landscape]
1645 \header { tagline = ##f }
1647 \footnote "*" #'(0.5 . -2) \markup { \italic "* La primera nota" } a'4
1649 \footnote \markup { \super "$" } #'(0.5 . 1)
1650 \markup { \super "$" \italic " La segunda nota" } e
1652 \once \override Score.FootnoteItem.annotation-line = ##f
1653 b-\footnote \markup \tiny "+" #'(0.1 . 0.1)
1654 \markup { \super "+" \italic " Editorial" } \p
1659 Se muestran más ejemplos de marcas personalizadas en
1660 @ref{Notas al pie en texto independiente}.
1663 @node Notas al pie en texto independiente
1664 @unnumberedsubsubsec Notas al pie en texto independiente
1665 @translationof Footnotes in stand-alone text
1667 @cindex notas al pie en texto independiente
1669 Se utilizan dentro de un elemento de marcado fuera de cualquier
1670 expresión musical. No se traza una línea hasta el punto de
1671 referencia: la marca simplemente sigue al elemento de marcado que
1672 se referencia. Se pueden insertar las marcas automáticamente, en
1673 cuyo caso son numéricas. De forma alternativa, se pueden aportar
1674 manualmente marcas personalizadas.
1676 Las notas al pie para texto independiente con marcas automáticas
1677 y personalizadas se crean de distintas formas.
1679 @subsubsubheading Notas al pie en texto independiente con marcas automáticas
1681 La sintaxis de una nota al pie sobre texto independiente con
1682 marcas automáticas es
1685 \markup @{ @dots{} \auto-footnote @var{texto} @var{nota} @dots{} @}
1693 es el elemento de marcado o cadena de caracteres que se desea
1697 es el elemento de marcado o cadena de caracteres que especifica
1698 el texto de la nota al pie que utilizar en la parte baja de la
1705 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1707 \header { tagline = ##f }
1710 \auto-footnote "tune" \italic " By me"
1711 "is shown below. It is a"
1712 \auto-footnote "recent" \italic " Aug 2012"
1721 @subsubsubheading Notas al pie sobre texto independiente con marcas personalizadas
1723 La sintaxis de una nota al pie sobre texto independiente con
1724 marcas personalizadas es
1727 \markup @{ @dots{} \footnote @var{marca} @var{nota} @dots{} @}
1735 es un elemento de marcado o cadena de caracteres que especifica
1736 la marca que se usa para señalar el punto de referencia. Observe
1737 que esta marca @emph{no} se inserta automáticamente antes de la
1741 es el elemento de marcado o cadena de caracteres que especifica
1742 el texto de la nota que aparece en la parte baja de la página,
1743 precedida por la @var{marca} especificada.
1747 Se puede usar como marca un carácter fácil de teclear, como * ó +,
1748 según se muestra en @ref{Notas al pie dentro de expresiones musicales}.
1749 De forma alternativa, se pueden usar alias en ASCII (véase
1750 @ref{Alias de ASCII}):
1752 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1754 \paper { #(include-special-characters) }
1755 \header { tagline = ##f }
1758 \footnote "*" \italic "* By me"
1759 "is shown below. It is a recent"
1760 \footnote \super † \concat {
1761 \super † \italic " Aug 2012"
1771 También pueden utilizarse códigos de caracteres Unicode para
1772 especificar las marcas (véase @ref{Unicode}):
1774 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1776 \header { tagline = ##f }
1779 \footnote \super \char##x00a7 \concat {
1780 \super \char##x00a7 \italic " By me"
1782 "is shown below. It is a recent"
1783 \footnote \super \char##x00b6 \concat {
1784 \super \char##x00b6 \italic " Aug 2012"
1795 Manual de aprendizaje:
1796 @rlearning{Objetos e interfaces}.
1798 Referencia de la notación:
1799 @ref{ASCII aliases},
1800 @ref{Globos de ayuda},
1801 @ref{Lista de caracteres especiales},
1802 @ref{Indicaciones de texto},
1803 @ref{Guiones de texto},
1806 Referencia de funcionamiento interno:
1807 @rinternals{FootnoteEvent},
1808 @rinternals{FootnoteItem},
1809 @rinternals{FootnoteSpanner},
1810 @rinternals{Footnote_engraver}.
1813 Varias notas al pie en la misma página solo pueden ir apiladas
1814 unas sobre otras; no se pueden imprimir en la misma línea.
1816 Las notas al pie no se pueden adjuntar a @code{MultiMeasureRests}
1817 (silencios multicompás), a barras de corchea automáticas ni a la
1818 letra de las canciones.
1820 Las notas al pie pueden colisionar con las pautas, objetos
1821 @code{\markup}, otras marcas de notas al pie y líneas de
1825 @node Referencia a números de página
1826 @subsection Referencia a números de página
1827 @translationof Reference to page numbers
1829 Un lugar determinado de una partitura puede señalizarse usando la
1830 instrucción @code{\label} (etiqueta), ya sea en el nivel superior
1831 o dentro de la música. Podemos referirnos a esta etiqueta más
1832 tarde dentro de un elemento de marcado, para obtener el número de
1833 la página en la que se sitúa el punto señalizado, usando la
1834 instrucción de marcado @code{\page-ref}.
1837 @lilypond[verbatim,papersize=a8landscape]
1838 \header { tagline = ##f }
1844 \pageBreak \mark A \label #'markA
1848 \markup { La primera partitura comienza en la página \page-ref #'firstScore "0" "?" }
1849 \markup { La marca A está en la página \page-ref #'markA "0" "?" }
1853 La instrucción de marcado @code{\page-ref} toma tres argumentos:
1855 @item la etiqueta, un símbolo de Scheme, p.ej. @code{#'firstScore};
1856 @item un elemento de marcado que se usará como medidor para estimar las dimensiones del marcado;
1857 @item un elemento de marcado que se utilizará en sustitución del número de página si la etiqueta es desconocida.
1860 El motivo de que se necesite un medidor es que en el momento en
1861 que se están interpretando los marcados, los saltos de página aún
1862 no se han producido y por tanto los números de página no se
1863 conocen todavía. Para sortear este inconveniente, la
1864 interpretación real del marcado se retrasa hasta un momento
1865 posterior; sin embargo, las dimensiones del marcado se tienen que
1866 conocer de antemano, así que se usa el medidor para decidir estas
1867 dimensiones. Si el libro tiene entre 10 y 99 páginas, el medidor
1868 puede ser "00", es decir, un número de dos dígitos.
1878 @node Índice general
1879 @subsection Índice general
1880 @translationof Table of contents
1882 Se puede insertar un índice general o tabla de contenidos
1883 utilizando la instrucción @code{\markuplist \table-of-contents}.
1884 Los elementos que deben aparecer en la tabla de contenidos se
1885 introducen con la instrucción @code{\tocItem}, que se puede usar
1886 en el nivel más alto de la jerarquía del código, o dentro de una
1890 \markuplist \table-of-contents
1893 \tocItem \markup "Primera partitura"
1897 \tocItem \markup "Un punto concreto dentro de la primera partitura"
1902 \tocItem \markup "Segunda partitura"
1910 Los elementos de marcado que se usan para dar formato al índice
1911 general o tabla de contenidos se encuentran definidos dentro del
1912 bloque @code{\paper}. Hay dos elementos de marcado
1913 @q{predefinidos} disponibles:
1918 @code{tocTitleMarkup}
1921 Utilizado para dar formato al título del índice general.
1924 tocTitleMarkup = \markup \huge \column {
1925 \fill-line { \null "Índice general" \null }
1931 @code{tocItemMarkup}
1934 Usado para dar formato a los elementos del índice general.
1937 tocItemMarkup = \markup \fill-line {
1938 \fromproperty #'toc:text \fromproperty #'toc:page
1945 Ambas variables pueden modificarse.
1947 He aquí un ejemplo que modifica el título del índice general para
1948 que aparezca en francés:
1952 tocTitleMarkup = \markup \huge \column {
1953 \fill-line { \null "Table des matières" \null }
1958 A continuación aparece un ejemplo que modifica el tamaño de
1959 fuente tipográfica de los elementos del índice general:
1962 tocItemMarkup = \markup \large \fill-line {
1963 \fromproperty #'toc:text \fromproperty #'toc:page
1967 Observe la forma en que nos referimos al texto y al número de
1968 página del elemento de índice, dentro de la definición
1969 @code{tocItemMarkup}.
1971 La instrucción @code{\tocItemWithDotsMarkup} se puede incluir
1972 dentro de @code{tocItemMarkup} para llenar la línea con puntos
1973 entre un elemento del índice general y su número de página
1976 @lilypond[verbatim,line-width=10.0\cm]
1977 \header { tagline = ##f }
1979 tocItemMarkup = \tocItemWithDotsMarkup
1983 \markuplist \table-of-contents
1984 \tocItem \markup { Allegro }
1985 \tocItem \markup { Largo }
1990 Las instrucciones predefinidas con sus propios marcados pueden
1991 definirse también para que construyan un índice general más
1992 complejo. En el ejemplo siguiente se define un estilo nuevo para
1993 introducir los nombres de los actos de una ópera en el índice
1997 Una nueva variable de marcado (llamada @code{tocActMarkup}) se
1998 define en el bloque @code{\paper}:
2002 tocActMarkup = \markup \large \column {
2004 \fill-line { \null \italic \fromproperty #'toc:text \null }
2011 A continuación se crea una función musical personalizada
2012 (@code{tocAct}), que usa la nueva definición de marcado
2013 @code{tocActMarkup}.
2017 #(define-music-function (text) (markup?)
2018 (add-toc-item! 'tocActMarkup text))
2022 Un archivo de entrada de LilyPond que use estas definiciones
2023 personalizadas tendría el aspecto siguiente:
2025 @lilypond[line-width=10.0\cm]
2026 \header { tagline = ##f }
2028 tocActMarkup = \markup \large \column {
2030 \fill-line { \null \italic \fromproperty #'toc:text \null }
2036 #(define-music-function (text) (markup?)
2037 (add-toc-item! 'tocActMarkup text))
2040 \markuplist \table-of-contents
2041 \tocAct \markup { Atto Primo }
2042 \tocItem \markup { Coro. Viva il nostro Alcide }
2043 \tocItem \markup { Cesare. Presti omai l'Egizzia terra }
2044 \tocAct \markup { Atto Secondo }
2045 \tocItem \markup { Sinfonia }
2046 \tocItem \markup { Cleopatra. V'adoro, pupille, saette d'Amore }
2052 He aquí un ejemplo de la instrucción @code{\fill-with-pattern}
2053 usada dentro del contexto de un índice general:
2057 tocItemMarkup = \markup { \fill-line {
2058 \override #'(line-width . 70)
2059 \fill-with-pattern #1.5 #CENTER . \fromproperty #'toc:text \fromproperty #'toc:page
2067 @file{ly/toc-init.ly}.
2070 @funindex \table-of-contents
2071 @code{\table-of-contents},
2077 @node Trabajar sobre los archivos de entrada
2078 @section Trabajar sobre los archivos de entrada
2079 @translationof Working with input files
2082 * Inclusión de archivos de LilyPond::
2083 * Distintas ediciones a partir de una misma fuente::
2084 * Caracteres especiales::
2088 @node Inclusión de archivos de LilyPond
2089 @subsection Inclusión de archivos de LilyPond
2090 @translationof Including LilyPond files
2093 @cindex including files
2095 Un proyecto grande se puede dividir en varios archivos. Para
2096 referirse a otro archivo, utilice
2099 \include "otroarchivo.ly"
2102 La línea @code{\include "otroarchivo.ly"} equivale a pegar todo
2103 el contenido de @file{otroarchivo.ly} en el archivo actual en el
2104 lugar en que aparece el @code{\include}. Por ejemplo, en un
2105 proyecto grande podríamos querer archivos distintos para cada
2106 parte instrumental y crear un archivo de @qq{partitura completa}
2107 que reúne los archivos individuales de los instrumentos.
2108 Normalmente el archivo incluido define un cierto número de
2109 variables que a partir de entonces quedan disponibles para
2110 poderlas utilizar en el archivo de la partitura completa. En los
2111 archivos incluidos se pueden marcar las secciones etiquetadas
2112 para ayudar a hacerlas utilizables en distintos lugares de la
2113 partitura, véase @ref{Distintas ediciones a partir de una misma
2116 Los archivos que están en el directorio de trabajo actual se
2117 pueden referenciar simplemente especificando el nombre después de
2118 la instrucción @code{\include}. Los archivos en otros lugares se
2119 pueden incluir proporcionando una referencia de ruta completa o
2120 una ruta relativa (pero utilice la barra inclinada normal del
2121 UNIX, /, no la barra invertida de DOS/Windows, \, como separador
2122 de directorio). Por ejemplo, si @file{material.ly} está situado
2123 un directorio por encima del directorio de trabajo actual,
2127 \include "../material.ly"
2131 o si los archivos de las partes orquestales incluidas están todos
2132 situados en un subdirectorio llamado @file{partes} dentro del
2133 directorio actual, use
2136 \include "partes/VI.ly"
2137 \include "partes/VII.ly"
2141 Los archivos de inclusión también pueden contener enunciados
2142 @code{\include} a su vez. De forma predeterminada, estos
2143 enunciados @code{\include} de segundo nivel no se interpretan
2144 hasta que se incorporan al archivo principal, por lo que los
2145 nombres de archivo que especifican deben ser relativos al
2146 directorio que contiene el archivo principal, no al directorio
2147 que contiene el archivo incluido. Sin embargo, este
2148 comportamiento se puede modificar globalmente pasando la opción
2149 @option{-drelative-includes} en la línea de órdenes (o mediante
2150 la adición de @code{#(ly:set-option 'relative-includes #t)} al
2151 principio del archivo principal de entrada).
2153 Cuando @code{relative-includes} está establecido al valor
2154 @code{#t}, la ruta de cada instrucción @code{\include} se
2155 considera relativa al archivo que contiene dicha instrucción.
2156 Este comportamiento es el recomendado y se convertirá en el
2157 comportamiento predeterminado en una versión futura de lilypond.
2159 Tanto los archivos relativos al directorio principal como los
2160 archivos relativos a algún otro directorio se pueden
2161 @code{\include}ar mediante el establecimiento de
2162 @code{relative-includes} al valor @code{#t} o a @code{#f} en los
2163 lugares apropiados dentro de los archivos. Por ejemplo, si se ha
2164 creado una biblioteca genérica, libA, que a su vez utiliza
2165 sub-archivos que se @code{\include}an por medio del archivo de
2166 entrada de dicha biblioteca, esas instrucciones @code{\include}
2167 tendrán que venir precedidas por @code{#(ly:set-option
2168 #relative-includes #t)} de manera que se interpreten
2169 correctamente al construir el archivo de entrada @code{.ly}
2170 principal, de esta forma:
2181 entonces el archivo de entrada, @code{libA.ly}, contiene
2184 #(ly:set-option 'relative-includes #t)
2188 % vuelta al ajuste predeterminado
2189 #(ly:set-option 'relative-includes #f)
2192 Cualquier archivo @file{.ly} puede entonces incluir la biblioteca
2193 completa, simplemente con
2196 \include "~/libA/libA.ly"
2199 Se pueden usar estructuras de archivo más complejas instando los
2200 cambios en los lugares adecuados.
2202 También se pueden incluir archivos de un directorio que está en
2203 una ruta de búsqueda especificada como opción al invocar a
2204 LilyPond desde la línea de órdenes. Los archivos incluidos se
2205 especifican usando solamente su nombre de archivo. Por ejemplo,
2206 para compilar mediante este método un archivo @file{principal.ly}
2207 que incluye archivos situados en un subdirectorio llamado
2208 @file{partes}, cambie al directorio que contiene
2209 @file{principal.ly} e introduzca
2212 lilypond --include=partes principal.ly
2215 y en @file{principal.ly} escriba
2223 Los archivos que se incluyen en muchas partituras se pueden poner
2224 en el directorio de LilyPond @file{../ly} (la localización de
2225 este directorio depende de la instalación: véase @rlearning{Otras
2226 fuentes de información}). Estos archivos se pueden incluir
2227 sencillamente por su nombre en un enunciado @code{\include}. De
2228 esta forma se incluyen los archivos dependientes del idioma como
2231 LilyPond incluye de forma predeterminada ciertos archivos cuando
2232 se inicia el programa. Estas inclusiones no son visibles para el
2233 usuario, pero los archivos se pueden identificar ejecutando
2234 @code{lilypond --verbose} desde la línea de órdenes. Esto
2235 presentará una lista de rutas y archivos que utiliza LilyPond,
2236 junto a muchas otras indicaciones. De forma alternativa, pueden
2237 verse explicaciones sobre los archivos más importantes de este
2238 conjunto en @rlearning{Otras fuentes de información}. Estos
2239 archivos se pueden editar, pero los cambios realizados sobre
2240 ellos se perderán al instalar una nueva versión de LilyPond.
2242 Pueden verse ejemplos sencillos sobre el uso de @code{\include}
2243 en @rlearning{Partituras y particellas}.
2246 Manual de aprendizaje:
2247 @rlearning{Otras fuentes de información},
2248 @rlearning{Partituras y particellas}.
2251 Si un archivo incluido recibe un nombre igual al de uno de los
2252 archivos de instalación de LilyPond, el archivo que tiene
2253 prioridad es el de los archivos de instalación de LilyPond.
2256 @node Distintas ediciones a partir de una misma fuente
2257 @subsection Distintas ediciones a partir de una misma fuente
2258 @translationof Different editions from one source
2260 Se pueden usar varios métodos para generar la producción de
2261 distintas versiones de una partitura a partir de la misma fuente
2262 musical. Las variables son quizá el más útil para combinar
2263 secciones extensas de música y/o anotaciones. Las etiquetas son
2264 más útiles para seleccionar una sección de entre varias secciones
2265 de música alternativas, más cortas, y se pueden usar también para
2266 dividir piezas de música en distintos trozos.
2268 Cualquiera que sea el método utilizado, la separación de la
2269 notación de la estructura de la partitura hará que sea más fácil
2270 cambiar la estructura dejando intacta la notación.
2273 * Uso de las variables::
2274 * Uso de etiquetas::
2275 * Uso de ajustes globales::
2278 @node Uso de las variables
2279 @unnumberedsubsubsec Uso de las variables
2280 @translationof Using variables
2282 @cindex variables, uso de las
2284 Si las secciones de la música se definen dentro de variables, se
2285 pueden reutilizar en distintas partes de la partitura, véase
2286 @rlearning{Organizar las piezas mediante variables}. Por
2287 ejemplo, una partitura vocal @notation{a cappella} con frecuencia
2288 incluye una reducción de piano de las partes para ensayar que es
2289 idéntica a la música vocal, por lo que ésta sólo se tiene que
2290 escribir una vez. Se puede combinar sobre un solo pentagrama la
2291 música de dos variables, véase @ref{Combinación automática de las
2292 partes}. He aquí un ejemplo:
2294 @lilypond[verbatim,quote]
2295 sopranoMusic = \relative { a'4 b c b8( a) }
2296 altoMusic = \relative { e'4 e e f }
2297 tenorMusic = \relative { c'4 b e d8( c) }
2298 bassMusic = \relative { a4 gis a d, }
2299 allLyrics = \lyricmode {King of glo -- ry }
2301 \new Staff = "Soprano" \sopranoMusic
2302 \new Lyrics \allLyrics
2303 \new Staff = "Alto" \altoMusic
2304 \new Lyrics \allLyrics
2305 \new Staff = "Tenor" {
2309 \new Lyrics \allLyrics
2310 \new Staff = "Bass" {
2314 \new Lyrics \allLyrics
2317 \set Staff.printPartCombineTexts = ##f
2323 \set Staff.printPartCombineTexts = ##f
2333 Se pueden producir partituras distintas que presenten sólo las
2334 partes vocales o sólo la parte de piano, cambiando solamente los
2335 enunciados estructurales, sin modificar la notación musical.
2337 Para partituras extensas, las definiciones de variable se pueden
2338 poner en archivos separados que se incluyen más tarde, véase
2339 @ref{Inclusión de archivos de LilyPond}.
2342 @node Uso de etiquetas
2343 @unnumberedsubsubsec Uso de etiquetas
2344 @translationof Using tags
2347 @funindex \keepWithTag
2348 @funindex \removeWithTag
2350 @cindex mantener música etiquetada
2351 @cindex quitar música etiquetada
2353 La instrucción @code{\tag #'@var{parteA}} marca una expresión
2354 musical con el nombre @var{parteA}. Las expresiones etiquetadas
2355 de esta manera se pueden seleccionar o filtrar más tarde por su
2356 nombre, usando bien @code{\keepWithTag #'@var{nombre}} o bien
2357 @code{\removeWithTag #'@var{nombre}}. El resultado de la
2358 aplicación de estos filtros a la música etiquetada es como sigue:
2360 @multitable @columnfractions .5 .5
2364 Música etiquetada precedida de @code{\keepWithTag #'@var{nombre}}
2365 o de @code{\keepWithTag #'(@var{nombre1} @var{nombre2}@dots{})}
2366 @tab Se incluye la música no etiquetada y la música etiquetada con
2367 el nombre o nombres de etiqueta dados; se excluye la música
2368 etiquetada con cualquier otro nombre de etiqueta.
2370 Música etiquetada precedida de
2371 @code{\removeWithTag #'@var{nombre}} o
2372 @code{\removeWithTag #'(@var{nombre1} @var{nombre2}@dots{})}
2374 Se incluye la música no etiquetada y la música que no está
2375 etiquetada con ninguno de los nombres de etiqueta dados; se
2376 excluye la música etiquetada con los nombres de etiqueta dados.
2378 Música etiquetada no precedida de @code{\keepWithTag} ni de
2379 @code{\removeWithTag}
2380 @tab Se incluye toda la música etiquetada y no etiquetada.
2383 Los argumentos de las instrucciones @code{\tag},
2384 @code{\keepWithTag} y @code{\removeWithTag} deben ser un símbolo
2385 o lista de símbolos (como @code{#'score} o @code{#'(violinI
2386 violinII}), seguida de una expresión musical. Si @emph{y solo
2387 si} los símbolos son identificadores de LilyPond válidos
2388 (caracteres alfabéticos solamente, sin números, guiones bajos ni
2389 guiones normales) que no puedan confundirse con notas, la porción
2390 @code{#'} se puede omitir y, como abreviatura, una lista de
2391 símbolos puede usar el separador de punto, es decir: @code{\tag
2392 #'(violinI violinII)} se puede escribir como @code{\tag
2393 violinI.violinII}. Lo mismo vale para @code{\keepWithTag} y
2394 @code{\removeWithTag}.
2396 En el ejemplo siguiente vemos dos versiones de una pieza musical,
2397 una que muestra trinos con la notación usual y otra con los
2398 trinos expandidos explícitamente:
2400 @lilypond[verbatim,quote]
2403 \tag #'trills { d8.\trill }
2404 \tag #'expand { \repeat unfold 3 { e32 d } }
2409 \keepWithTag #'trills \music
2412 \keepWithTag #'expand \music
2417 De forma alternativa, a veces es más fácil excluir secciones de música:
2419 @lilypond[verbatim,quote]
2422 \tag #'trills { d8.\trill }
2423 \tag #'expand {\repeat unfold 3 { e32 d } }
2428 \removeWithTag #'expand
2432 \removeWithTag #'trills
2437 El filtrado con etiquetas se puede aplicar a articulaciones, textos,
2441 -\tag #'@var{mi-etiqueta}
2444 a una articulación. Por ejemplo, esto define una nota con una
2445 indicación opcional de digitación y una nota con una anotación
2450 c1-\tag #'warn ^"¡Ojo!"
2453 Se pueden poner varias etiquetas sobre expresiones con varias
2454 entradas de @code{\tag}, o combinando varias etiquetas en una
2457 @lilypond[quote,verbatim]
2458 music = \relative c'' {
2459 \tag #'a \tag #'both { a4 a a a }
2460 \tag #'(b both) { b4 b b b }
2463 \keepWithTag #'a \music
2464 \keepWithTag #'b \music
2465 \keepWithTag #'both \music
2469 Se pueden aplicar varios filtros @code{\removeWithTag} a una sola
2470 expresión musical para quitar varias secciones etiquetadas con
2471 nombres distintos. De forma alternativa, podemos usar una sola
2472 instrucción @code{\removeWithTag} con una lista de etiquetas.
2474 @lilypond[verbatim,quote]
2475 music = \relative c'' {
2476 \tag #'A { a4 a a a }
2477 \tag #'B { b4 b b b }
2478 \tag #'C { c4 c c c }
2479 \tag #'D { d4 d d d }
2485 \removeWithTag #'(B C)
2490 Dos o más filtros @code{\keepWithTag} aplicados a una sola
2491 expresión musical producen la eliminación de @emph{todas} las
2492 secciones etiquetadas, porque el primer filtro quita todas las
2493 secciones etiquetadas excepto la que se nombra, y el segundo
2494 filtro elimina incluso esa sección etiquetada. Por lo general,
2495 querrá usar una sola instrucción @code{\keepWithTag} con una
2496 lista de varias etiquetas: de esta forma solamente se suprimirán
2497 las secciones etiquetadas que no aparezcan en @emph{ninguna} de
2500 @cindex grupos de etiquetas
2502 Aunque @code{\keepWithTag} es útil para el manejo de @emph{un
2503 solo} conjunto de alternativas, la eliminación de música
2504 etiquetada con otras etiquetas @emph{no relacionadas} es
2505 problemática si se utilizan para más de un propósito. Por tal
2506 motivo pueden declararse @q{grupos de etiquetas} relacionadas:
2509 \tagGroup #'(violinI violinII viola cello)
2512 declara las etiquetas respectivas como pertenecientes a un grupo
2516 \keepWithTag #'violinI @dots{}
2519 se ocupará solamente de las etiquetas del grupo @code{violinI}:
2520 cualquier elemento de la música incluida que lleve una o más
2521 etiquetas de este conjunto pero @emph{no} con la etiqueta
2522 @code{violinI} resultará suprimida.
2524 Para cualquier instrucción @code{\keepWithTag}, solamente son
2525 visibles las etiquetas de los grupos de aquellas etiquetas dadas
2526 en la propia instrucción.
2528 Las etiquetas no pueden ser miembros de más de un grupo de
2531 @funindex \pushToTag
2532 @funindex \appendToTag
2533 @cindex dividir en música etiquetada
2535 A veces podemos desear dividir la música en un determinado lugar
2536 dentro de una expresión musical existente. Podemos usar
2537 @code{\pushToTag} y @code{\appendToTag} para añadir material
2538 delante o al final de los @code{elements} de una construcción
2539 musical existente. No toda construcción musical tiene la parte
2540 @code{elements}, pero las músicas secuenciales y simultáneas son
2541 dos apuestas seguras:
2543 @lilypond[verbatim,quote]
2544 test = { \tag #'here { \tag #'here <<c''>> } }
2547 \pushToTag #'here c'
2548 \pushToTag #'here e'
2549 \pushToTag #'here g' \test
2550 \appendToTag #'here c'
2551 \appendToTag #'here e'
2552 \appendToTag #'here g' \test
2556 Las dos instrucciones admiten una etiqueta, el material que
2557 dividir en cada ocurrencia de la etiqueta, y la expresión
2561 Manual de aprendizaje:
2562 @rlearning{Organizar las piezas mediante variables}.
2564 Referencia de la notación:
2565 @ref{Combinación automática de las partes},
2566 @ref{Inclusión de archivos de LilyPond}.
2569 Al llamar a @code{\relative} sobre una expresión musical obtenida
2570 mediante el filtrado de música con las instrucciones
2571 @code{\keepWithTag} o @code{\removeWithTag}, podría ocurrir que
2572 cambiaran las relaciones de octava, dado que solo se tendrán en
2573 cuenta las alturas de las notas que efectivamente permanecen en
2574 la expresión filtrada. La aplicación de @code{\relative} en
2575 primer lugar, antes de @code{\keepWithTag} o de
2576 @code{\removeWithTag}, evita este peligro porque en este caso
2577 @code{\relative} actúa sobre todas las notas tal y como se
2581 @node Uso de ajustes globales
2582 @unnumberedsubsubsec Uso de ajustes globales
2583 @translationof Using global settings
2585 @cindex include-settings
2587 Se pueden incluir ajustes globales a partir de un archivo
2591 lilypond -dinclude-settings=MIS_AJUSTES.ly MI_PARTITURA.ly
2594 En archivos diferentes se pueden almacenar grupos de ajustes como
2595 el tamaño de la página o las fuentes tipográficas. Ello permite
2596 hacer diferentes ediciones de la misma partitura así como aplicar
2597 ajustes estándar a muchas partituras, simplemente por medio de la
2598 especificación del archivo de ajustes adecuado.
2600 Esta técnica también funciona bien con el uso de hojas de estilo,
2601 como se estudia en @rlearning{Hojas de estilo}.
2604 Manual de aprendizaje:
2605 @rlearning{Organizar las piezas mediante variables},
2606 @rlearning{Hojas de estilo}.
2608 Referencia de la notación:
2609 @ref{Inclusión de archivos de LilyPond}.
2612 @node Caracteres especiales
2613 @subsection Caracteres especiales
2614 @translationof Special characters
2616 @cindex caracteres especiales
2617 @cindex caracteres no ASCII
2620 * Codificación del texto::
2626 @node Codificación del texto
2627 @unnumberedsubsubsec Codificación del texto
2628 @translationof Text encoding
2632 LilyPond usa el conjunto de caracteres definido por el consorcio
2633 Unicode y la norma ISO/IEC 10646. Define un nombre único y un
2634 código para los conjuntos de caracteres que se utilizan en
2635 prácticamente todos los idiomas modernos y también en muchos
2636 otros. Unicode se puede implementar utilizando varios esquemas
2637 de codificación distintos. LilyPond usa la codificación UTF-8
2638 (UTF son las siglas de @emph{Unicode Transformation Format}, o
2639 formato de transformación de Unicode) que representa todos los
2640 caracteres comunes de la codificación Latin en un solo byte, y
2641 representa otros caracteres usando un formato de longitud
2642 variable de hasta cuatro bytes.
2644 El aspecto visual real de los caracteres viene determinado por
2645 los glifos que se definen en las fuentes tipográficas concretas
2646 que se tengan disponibles: una fuente tipográfica define la
2647 asignación de un subconjunto de los códigos de Unicode a glifos.
2648 LilyPond usa la biblioteca Pango para representar y disponer
2649 tipográficamente textos multilingües.
2651 LilyPond no realiza ninguna conversión en la codificación de la
2652 entrada. Esto significa que cualquier text, ya sea el título, la
2653 letra de la canción o una instrucción musical que contenga
2654 caracteres distintos a los del conjunto ASCII, se deben codificar
2655 en UTF-8. La forma más fácil de escribir dicho texto es utilizar
2656 un editor preparado para Unicode y guardar el archivo con la
2657 codificación UTF-8. Casi todos los editores modernos populares
2658 contemplan el UTF-8, por ejemplo lo hacen vim, Emacs, jEdit, y
2659 GEdit. Todos los sistemas MS Windows posteriores a NT usan
2660 Unicode como codificación de caracteres nativa, de manera que
2661 incluso el accesorio Bloc de Notas (Notepad) puede editar y
2662 guardar un archivo en el formato UTF-8. Una alternativa más
2663 funcional para Windows es BabelPad.
2665 Si un archivo de entrada que contiene un carácter que no es
2666 ASCII, no se guarda en el formato UTF-8, se genera el mensaje de
2670 FT_Get_Glyph_Name () error: argumento inválido
2673 He aquí un ejemplo que muestra texto cirílico, hebreo y portugués:
2676 %c No verbatim here as the code does not display correctly in PDF
2677 % Font settings for Cyrillic and Hebrew
2678 % Linux Libertine fonts contain Cyrillic and Hebrew glyphs.
2682 #:roman "Linux Libertine O,serif"
2683 #:sans "Linux Biolinum O,sans-serif"
2684 #:typewriter "Linux Libertine Mono O,monospace"
2689 bulgarian = \lyricmode {
2690 Жълтата дюля беше щастлива, че пухът, който цъфна, замръзна като гьон.
2694 hebrew = \lyricmode {
2695 זה כיף סתם לשמוע איך תנצח קרפד עץ טוב בגן.
2699 portuguese = \lyricmode {
2700 à vo -- cê uma can -- ção legal
2706 \addlyrics { \bulgarian }
2707 \addlyrics { \hebrew }
2708 \addlyrics { \portuguese }
2713 @unnumberedsubsubsec Unicode
2714 @translationof Unicode
2718 Para introducir un carácter aislado para el que se conoce el
2719 punto de código Unicode pero no está disponible en el editor que
2720 se está usando, use @code{\char ##xhhhh} o bien @code{\char
2721 #dddd} dentro de un bloque @code{\markup}, donde @code{hhhh} es
2722 el código hexadecimal del carácter en cuestión y @code{dddd} es
2723 su valor decimal correspondiente. Pueden omitirse los ceros
2724 iniciales, pero es costumbre indicar los cuatro caracteres en la
2725 representación hexadecimal (observe que @emph{no} debe utilizarse
2726 la codificación UTF-8 del punto de código Unicode después de
2727 @code{\char}, pues la codificación UTF-8 contiene bits
2728 adicionales que indican el número de octetos). Hay tablas de
2729 códigos Unicode y un índice de nombres de caracteres que da el
2730 punto de código en hexadecimal para cualquier carácter en el
2731 portal del Consorcio Unicode, @uref{http://www.unicode.org/}.
2733 Por ejemplo, tanto @code{\char ##x03BE} como @code{\char #958}
2734 insertan el carácter Unicode U+03BE, que tiene el nombre Unicode
2735 @qq{Letra griega Xi pequeña}.
2737 Se puede escribir de esta forma cualquier punto de código
2738 Unicode, y si todos los caracteres especiales se escriben en este
2739 formato no es necesario guardar el archivo de entrada en formato
2740 UTF-8. Por supuesto, debe estar instalada y estar disponible
2741 para LilyPond una fuente tipográfica que contenga codificados
2742 todos estos caracteres.
2744 El ejemplo siguiente muestra valores hexadecimales Unicode que se
2745 usan en cuatro lugares: en una llamada de ensayo, como texto de
2746 articulación, en la letra y como texto independiente bajo la
2749 @lilypond[quote,verbatim]
2752 c''1 \mark \markup { \char ##x03EE }
2753 c1_\markup { \tiny { \char ##x03B1 " to " \char ##x03C9 } }
2755 \addlyrics { O \markup { \concat { Ph \char ##x0153 be! } } }
2757 \markup { "Copyright 2008--2015" \char ##x00A9 }
2760 @cindex copyright, símbolo de
2762 Para escribir el símbolo de copyright en la nota de créditos, utilice:
2766 copyright = \markup @{ \char ##x00A9 "2008" @}
2771 @node Alias de ASCII
2772 @unnumberedsubsubsec Alias de ASCII
2773 @translationof ASCII aliases
2775 Se puede incluir una lista de alias de ASCII para caracteres
2778 @lilypond[quote,verbatim]
2780 #(include-special-characters)
2783 \markup "&flqq; – &OE;uvre incomplète… &frqq;"
2786 \new Staff { \repeat unfold 9 a'4 }
2788 This is al -- so wor -- kin'~in ly -- rics: –_&OE;…
2793 "The replacement can be disabled:"
2794 "– &OE; …"
2795 \override #'(replacement-alist . ()) "– &OE; …"
2799 También podemos hacer nuestros propios alias, ya sea de forma global,
2801 @lilypond[quote,verbatim]
2803 #(add-text-replacements!
2804 '(("100" . "hundred")
2805 ("dpi" . "dots per inch")))
2807 \markup "A 100 dpi."
2812 @lilypond[quote,verbatim]
2813 \markup \replace #'(("100" . "hundred")
2814 ("dpi" . "dots per inch")) "A 100 dpi."
2818 Referencia de la notación:
2819 @ref{Lista de caracteres especiales}.
2821 Archivos instalados:
2822 @file{ly/text-replacements.ly}.
2825 @node Controlar la salida
2826 @section Controlar la salida
2827 @translationof Controlling output
2830 * Extracción de fragmentos de música::
2831 * Saltar la música corregida::
2832 * Formatos de salida alternativos::
2833 * Sustituir la tipografía de la notación::
2836 @funindex clip-regions
2837 @cindex fragmentos de música
2838 @cindex música, fragmentos
2840 @node Extracción de fragmentos de música
2841 @subsection Extracción de fragmentos de música
2842 @translationof Extracting fragments of music
2844 Es posible producir en la salida uno o más fragmentos de una
2845 partitura mediante la definición de la situación explícita de la
2846 música que se quiere extraer dentro del bloque @code{\layout} del
2847 archivo de entrada, utilizando la función @code{clip-regions}, y
2848 a continuación ejecutando LilyPond con la opción
2849 @option{-dclip-systems}.
2856 (make-rhythmic-location 5 1 2)
2857 (make-rhythmic-location 7 3 4)))
2862 Este ejemplo extrae un solo fragmento del archivo de entrada
2863 @emph{comenzando} después de la duración de una blanca en el
2864 quinto compás (@code{5 1 2}) y @emph{terminando} después de la
2865 tercera negra del compás séptimo (@code{7 3 4}).
2867 Se pueden extraer fragmentos adicionales añadiendo más pares de
2868 entradas de @code{make-rhythmic-location} a la lista
2869 @code{clip-regions} dentro del bloque @code{\layout}.
2871 De forma predeterminada, cada fragmento de música se obtendrá en
2872 la salida como un archivo @code{EPS} distinto, pero también se
2873 pueden crear otros formatos como @code{PDF} o @code{PNG} si es
2874 necesario. La música extraída se obtiene en la salida como si
2875 hubiera sido literalmente @q{cortada} de la partitura original
2876 impresa, de forma que si un fragmento se extiende sobre una o más
2877 líneas, se genera un archivo de salida distinto por cada línea
2881 Referencia de la notación:
2882 @ref{El bloque layout}.
2884 Manual de utilización:
2885 @rprogram{Utilización desde la línea de órdenes}.
2889 @node Saltar la música corregida
2890 @subsection Saltar la música corregida
2891 @translationof Skipping corrected music
2893 @funindex skipTypesetting
2894 @funindex showFirstLength
2895 @funindex showLastLength
2897 Al escribir o copiar música, normalmente sólo es interesante de
2898 ver y corregir la música cercana al final (donde estamos
2899 añadiendo las notas). Para acelerar este proceso de corrección,
2900 es posible saltar la composición tipográfica de todos excepto
2901 unos pocos de los últimos compases. Esto se consigue poniendo
2904 showLastLength = R1*5
2905 \score @{ @dots{} @}
2909 en nuestro archivo fuente. Esto hará que se tracen sólo los
2910 últimos cinco compases (suponiendo un compás de 4/4) de cada una
2911 de las partituras @code{\score} del archivo de entrada. Para
2912 piezas largas, el tipografiado de únicamente una parte pequeña es
2913 con frecuencia un orden de magnitud más rápido que el de la obra
2914 completa. Si estamos trabajando sobre el principio de una
2915 partitura que ya hemos tipografiado (p.ej., para añadir una parte
2916 instrumental nueva), también puede ser útil la propiedad
2917 @code{showFirstLength}.
2919 Este mecanismo de pasar por alto partes de un partitura se puede
2920 controlar con un grano más fino mediante la propiedad
2921 @code{Score.skipTypesetting}. Cuando su valor está establecido,
2922 no se lleva a cabo ningún tipografiado en absoluto.
2924 Esta propiedad se usa también para controlar la salida hacia el
2925 archivo MIDI. Observe que pasa por alto todos los eventos,
2926 incluidos el tempo y los cambios de instrumento. Está usted
2929 @lilypond[quote,ragged-right,verbatim]
2932 \set Score.skipTypesetting = ##t
2935 \set Score.skipTypesetting = ##f
2940 En música polifónica, @code{Score.skipTypesetting} afecta a todas
2941 las voces y pentagramas, ahorrando más tiempo incluso.
2944 @node Formatos de salida alternativos
2945 @subsection Formatos de salida alternativos
2946 @translationof Alternative output formats
2948 @cindex salida de gráficos de vector escalables
2950 @cindex salida de PostScript encapsulado
2952 @cindex PostScript encapsulado, salida de
2954 Los formatos de salida predeterminados para la partitura impresa
2955 son el formato de documento portátil (PDF) y PostScript (PS).
2956 Los formatos de salida Gráficos de vector escalables (SVG),
2957 PostScript encapsulado (EPS) y Gráficos de red portátiles (PNG)
2958 también están disponibles a través de opciones de la línea de
2959 órdenes, véase @rprogram{Opciones básicas de la línea de órdenes
2963 @node Sustituir la tipografía de la notación
2964 @subsection Sustituir la tipografía de la notación
2965 @translationof Replacing the notation font
2967 Gonville es una alternativa a la tipografía Feta que se utiliza
2968 en LilyPond y se puede descargar de:
2970 @uref{http://www.chiark.greenend.org.uk/~sgtatham/gonville/ ,http://www.chiark.greenend.org.uk/~sgtatham/gonville/}
2973 Aquí presentamos algunos compases de muestra tipografiados con la
2976 @c NOTE: these images are a bit big, but that's important
2977 @c for the font comparison. -gp
2978 @sourceimage{Gonville_after,15cm,,}
2980 Aquí hay unos compases de muestra tipografiados en la fuente Feta
2983 @sourceimage{Gonville_before,15cm,,}
2985 @subsubheading Instrucciones de instalación para MacOS
2987 Descargue y extraiga el archivo zip. Copie la carpeta
2988 @code{lilyfonts} a @file{@var{SHARE_DIR}/lilypond/current}; para
2989 más información, consulte @rlearning{Otras fuentes de
2990 información}. Renombre la carpeta @code{fonts} existente a
2991 @code{fonts_orig} y la carpeta @code{lilyfonts} a @code{fonts}.
2992 Para volver a la fuente Feta, invierta el proceso.
2995 Manual de aprendizaje:
2996 @rlearning{Otras fuentes de información}.
2999 Gonville no se puede usar para tipografiar notación de @q{Música
3000 Antigua} y es probable que cualquier nuevo glifo en versiones
3001 posteriores de LilyPond no existan en la familia tipográfica
3002 Gonville. Diríjase a la página web del autor para obtener más
3003 información sobre éste y otros asuntos, entre ellos el régimen de
3004 licencias de Gonville.
3007 @node Creación de salida MIDI
3008 @section Creación de salida MIDI
3009 @translationof Creating MIDI output
3014 LilyPond puede producir archivos que siguen el estándar MIDI
3015 (Musical Instrument Digital Interface; interfaz digital para
3016 instrumentos musicales) y permitir así comprobar la música por el
3017 oído (con la ayuda de alguna aplicación o dispositivo que
3018 entienda el MIDI). La escucha de la salida MIDI también puede
3019 ser de ayuda en la localización de errores tales como notas que
3020 se han introducido incorrectamente, alteraciones omitidas y otros
3021 casos por el estilo.
3023 Los archivos MIDI no contienen sonido (como los archivos AAC, MP3
3024 o Vorbis) pero requieren software adicional para producir el
3025 sonido a partir de ellos.
3028 * Notación contemplada por el MIDI::
3029 * Notación no contemplada en el MIDI::
3031 * Control de las dinámicas del MIDI::
3032 * Uso de los instrumentos MIDI::
3033 * Uso de las repeticiones con el MIDI::
3034 * Asignación de canales MIDI::
3035 * Propiedades de contexto para efectos MIDI::
3036 * Enriquecimiento de la salida MIDI::
3037 * El script Articulate::
3040 @cindex MIDI, notación contemplada
3042 @node Notación contemplada por el MIDI
3043 @subsection Notación contemplada por el MIDI
3044 @translationof Supported notation for MIDI
3046 Se puede usar la notación musical siguiente con las posibilidades
3047 predeterminadas de LilyPond para producir salida MIDI:
3050 @item Marcas de respiración
3051 @item Acordes introducidos como nombres de acorde
3052 @item Crescendos y decrescendos sobre más de una nota. El volumen se altera de forma lineal entre los dos extremos
3053 @item Indicadores dinámicos desde @code{ppppp} hasta @code{fffff}, incluyendo @code{mp}, @code{mf} y @code{sf}
3054 @item Microtonos, pero @emph{no} acordes microtonales. Se necesita también un reproductor de MIDI capaz de ejecutar eventos de rueda de tono.
3055 @item Letra de las canciones
3056 @item Altura de las notas
3057 @item Ritmo introducido como duraciones de las notas, incluidos los grupos de valoración especial como los tresillos
3058 @item Articulaciones @q{sencillas}; picado, staccato, acento, marcato y portato
3059 @item Cambios de tempo introducidos con la función @code{\tempo}
3060 @item Ligaduras de unión
3061 @item Trémolos que @emph{not} se hayan introducido como un valor del tipo @q{@code{:}[@var{número}]}
3064 También se pueden controlar el panorama, el balance, la expresión
3065 y los efectos de reverberación y chorus mediante el
3066 establecimiento de propiedades de contexto, véase
3067 @ref{Propiedades de contexto para efectos MIDI}.
3069 Si se combina con el script @file{articulate}, es posible
3070 producir la salida por el MIDI de los siguientes elementos
3071 adicionales de notación musical:
3074 @item Appogiaturas (apoyaturas). Se les da la mitad de la duración de la nota siguiente (sin tener en cuenta los puntillos). Por ejemplo:
3077 \appoggiatura c8 d2.
3081 El Do toma la duración de una negra.
3083 @item Notas y grupos de adorno (mordentes de una nota, trinos, grupetos circulares, etc.)
3084 @item Rallentando, accelerando, ritardando y a tempo
3085 @item Ligaduras de expresión y de fraseo
3090 Véase @ref{Enriquecimiento de la salida MIDI}.
3092 @cindex MIDI, notación no contemplada
3094 @node Notación no contemplada en el MIDI
3095 @subsection Notación no contemplada en el MIDI
3096 @translationof Unsupported notation for MIDI
3098 Los siguientes elementos de notación musical no se pueden hacer
3102 @item Articulaciones distintas al picado, staccato, acento, marcato y portato
3103 @item Crescendos y decrescendos sobre una @emph{sola} nota
3107 @item Caídas y elevaciones
3108 @item Acordes microtonales
3109 @item Duraciones introducidas como anotaciones, p.ej. el swing
3110 @item Cambios de tempo sin @code{\tempo} (p.ej., introducidas como anotaciones)
3111 @item Trémolos que @emph{se introducen} con la notación de la forma @q{@code{:}[@var{número}]}
3115 @node El bloque MIDI
3116 @subsection El bloque MIDI
3117 @translationof The MIDI block
3121 Para crear un archivo de salida MIDI a partir de un archivo de
3122 entrada de LilyPond, introduzca un bloque @code{\midi}, que puede
3123 estar vacío, dentro del bloque @code{\score}:
3127 @var{@dots{} música @dots{}}
3133 @warning{ Un bloque @code{@bs{}score} que, además de la música,
3134 contiene solamente un bloque @code{@bs{}midi} (o sea, @emph{sin}
3135 el bloque @code{@bs{}layout}), solo produce archivos de salida
3136 MIDI; no se imprime ninguna notación musical.}
3138 La extensión predeterminada para los archivos de salida
3139 (@code{.midi}) se puede cambiar usando la opción
3140 @code{-dmidi-extension} con la instrucción @code{lilypond}:
3143 lilypond -dmidi-extension=mid Archivo.ly
3146 Como alternativa, puede añadirse la siguiente expresión de Scheme
3147 antes del comienzo de uno de los bloques @code{\book},
3148 @code{\bookpart} o @code{\score}. Véase @ref{Estructura del archivo}.
3151 #(ly:set-option 'midi-extension "mid")
3155 Referencia de la notación:
3156 @ref{Estructura del archivo}.
3158 Archivos instalados:
3159 @file{scm/midi.scm}.
3162 Están disponibles 15 canales MIDI y un canal adicional (el número
3163 10) para la percusión. Los pentagramas se asignan a los canales
3164 por orden, de forma que una partitura que contenga más de 15
3165 pentagramas da como resultado que los pentagramas adicionales
3166 comparten (pero no sobreescriben) el mismo canal MIDI. Esto
3167 puede ser problemático si los pentagramas que comparten canal
3168 tienen establecidas propiedades MIDI, basadas en canal, en mutuo
3169 conflicto (como distintos instrumentos MIDI).
3172 @node Control de las dinámicas del MIDI
3173 @subsection Control de las dinámicas del MIDI
3174 @translationof Controlling MIDI dynamics
3176 Es posible controlar el volumen MIDI general, el volumen relativo
3177 de las indicaciones de matiz dinámico y el volumen relativo de
3178 los distintos instrumentos.
3180 Las indicaciones matiz dinámico se traducen automáticamente a
3181 niveles de volumen dentro del rango de volúmenes MIDI disponible
3182 mientras que los crescendos y decrescendos varían el volumen
3183 linealmente entre sus dos extremos. Es posible controlar el
3184 volumen relativo de las indicaciones de matiz dinámico, y el
3185 volumen general de los diferentes instrumentos.
3188 * Indicaciones de matiz dinámico en el MIDI::
3189 * Establecimiento del volumen MIDI::
3190 * Establecimiento de las propiedades del bloque MIDI::
3193 @cindex MIDI, volumen
3194 @cindex MIDI, ecualización
3195 @cindex MIDI, matices dinámicos
3196 @cindex dinámica del MIDI
3199 @node Indicaciones de matiz dinámico en el MIDI
3200 @unnumberedsubsubsec Indicaciones de matiz dinámico en el MIDI
3201 @translationof Dynamic marks in MIDI
3203 Solo las marcas de dinámica desde @code{ppppp} hasta
3204 @code{fffff}, incluidos @code{mp}, @code{mf} y @code{sf} tienen
3205 valores asignados. Este valor se aplica a continuación al valor
3206 del rango de volumen MIDI general para obtener el volumen final
3207 que se incluye en la salida MIDI para esa indicación de matiz
3208 dinámico en particular. Las fracciones predeterminadas varían
3209 desde 0.25 para el @notation{ppppp} hasta 0.95 para el
3210 @notation{fffff}. El conjunto completo de las indicaciones de
3211 matiz dinámico pueden verse en el archivo @file{scm/midi.scm}.
3215 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
3216 {creating-custom-dynamics-in-midi-output.ly}
3218 Archivos instalados:
3219 @file{ly/script-init.ly}
3220 @file{scm/midi.scm}.
3222 Fragmentos de código:
3225 Referencia de funcionamiento interno:
3226 @rinternals{Dynamic_performer}.
3229 @node Establecimiento del volumen MIDI
3230 @unnumberedsubsubsec Establecimiento del volumen MIDI
3231 @translationof Setting MIDI volume
3233 Los volúmenes generales mínimo y máximo de las indicaciones de
3234 matiz dinámico MIDI se controlan estableciendo las propiedades
3235 @code{midiMinimumVolume} y @code{midiMaximumVolume} en el nivel
3236 del bloque @code{Score}. Estas propiedades tienen efecto
3237 solamente al comienzo de una vos y sobre las indicaciones
3238 dinámicas. La fracción que corresponde a cada indicación
3239 dinámica se modifica con esta fórmula:
3242 midiMinimumVolume + (midiMaximumVolume - midiMinimumVolume) * fracción
3245 En el ejemplo siguiente, el rango dinámico del volumen MIDI
3246 general se limita al intervalo entre @code{0.2} y @code{0.5}.
3252 \set Staff.midiInstrument = #"flute"
3253 @var{@dots{} music @dots{}}
3256 \set Staff.midiInstrument = #"clarinet"
3257 @var{@dots{} music @dots{}}
3263 midiMinimumVolume = #0.2
3264 midiMaximumVolume = #0.5
3270 Se puede obtener una ecualización sencilla de instrumentos MIDI
3271 estableciendo las propiedades @code{midiMinimumVolume} y
3272 @code{midiMaximumVolume} dentro del contexto @code{Staff}.
3277 \set Staff.midiInstrument = #"flute"
3278 \set Staff.midiMinimumVolume = #0.7
3279 \set Staff.midiMaximumVolume = #0.9
3280 @var{@dots{} music @dots{}}
3286 Para partituras con más de un pentagrama y más de un instrumento
3287 MIDI, se pueden fijar individualmente los volúmenes relativos de
3294 \set Staff.midiInstrument = #"flute"
3295 \set Staff.midiMinimumVolume = #0.7
3296 \set Staff.midiMaximumVolume = #0.9
3297 @var{@dots{} music @dots{}}
3300 \set Staff.midiInstrument = #"clarinet"
3301 \set Staff.midiMinimumVolume = #0.3
3302 \set Staff.midiMaximumVolume = #0.6
3303 @var{@dots{} music @dots{}}
3310 En este ejemplo el volumen del clarinete se reduce de forma
3311 relativa al volumen de la flauta.
3313 Si no se establecen estas propiedades de volumen, LilyPond aún
3314 aplica un @q{pequeño grado} de ecualización a ciertos
3315 instrumentos. Véase @file{scm/midi.scm}.
3317 Archivos instalados:
3318 @file{scm/midi.scm}.
3321 Referencia de la notación:
3322 @ref{Disposición de la partitura}.
3324 Referencia de funcionamiento interno:
3325 @rinternals{Dynamic_performer}.
3328 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
3329 {replacing-default-midi-instrument-equalization.ly}
3332 Los cambios en el volumen del MIDI solamente tienen lugar en el
3333 comienzo de una nota, por lo que los crescendos y decrescendos no
3334 afectan al volumen de una sola nota.
3336 @node Establecimiento de las propiedades del bloque MIDI
3337 @unnumberedsubsubsec Establecimiento de las propiedades del bloque MIDI
3338 @translationof Setting MIDI block properties
3340 El bloque @code{\midi} puede contener distintas disposiciones de
3341 los contextos, definiciones de contexto nuevas o código que fija
3342 los valores de ciertas propiedades.
3346 @var{@dots{} music @dots{}}
3353 Aquí, el tempo se establece a 72 pulsos de negra por minuto. La
3354 indicación de tempo dentro del bloque @code{\midi} no aparece en
3355 la partitura impresa. Aunque cualquier otra indicación de
3356 @code{\tempo} que se especifique dentro del bloque @code{\score}
3357 también se reflejará en la salida MIDI.
3359 Dentro de un bloque @code{\midi}, la instrucción @code{\tempo}
3360 está estableciendo propiedades durante la interpretación de la
3361 música y en el contexto de las definiciones de salida; así, se
3362 interpreta @emph{como si} fuera una modificación de contesto.
3364 @cindex MIDI, definiciones de contexto
3365 @cindex contexto, definiciones con MIDI
3367 Las definiciones de contexto siguen la misma sintaxis que las del
3368 bloque @code{\layout}:
3372 @var{@dots{} music @dots{}}
3376 \remove "Dynamic_performer"
3382 Este ejemplo suprime el efecto de las indicaciones dinámicas
3383 sobre la salida MIDI. Nota: los módulos de traducción de
3384 LilyPond usados para el sonido se llaman @q{performers}.
3387 Manual de aprendizaje:
3388 @rlearning{Otras fuentes de información}.
3390 Referencia de la notación:
3392 @ref{Disposición de la partitura}.
3394 Archivos instalados:
3395 @file{ly/performer-init.ly}.
3397 Fragmentos de código:
3400 Referencia de funcionamiento interno:
3401 @rinternals{Dynamic_performer}.
3404 Ciertos reproductores de MIDI no siempre maneja correctamente los
3405 cambios de tempo en la salida MIDI.
3407 Los cambios efectuados al @code{midiInstrument}, así como ciertas
3408 opciones MIDI, al @emph{comienzo} de un pentagrama pueden
3409 aparecer dos veces en la salida MIDI.
3413 @node Uso de los instrumentos MIDI
3414 @subsection Uso de los instrumentos MIDI
3415 @translationof Using MIDI instruments
3417 Los instrumentos MIDI se establecen usando la propiedad
3418 @code{midiInstrument} dentro de un contexto @code{Staff}.
3423 \set Staff.midiInstrument = #"glockenspiel"
3424 @var{@dots{} music @dots{}}
3434 \new Staff \with @{midiInstrument = #"cello"@} @{
3435 @var{@dots{} music @dots{}}
3441 Si el instrumento elegido no coincide exactamente con uno de los
3442 instrumentos de la lista de la sección @q{instrumentos MIDI}, se
3443 usará el instrumento Piano de Cola (@code{"acoustic grand"}).
3444 Véase @ref{Instrumentos MIDI}.
3447 Manual de aprendizaje:
3448 @rlearning{Otras fuentes de información}.
3450 Referencia de la notación:
3451 @ref{Instrumentos MIDI},
3452 @ref{Disposición de la partitura}.
3454 Archivos instalados:
3455 @file{scm/midi.scm}.
3458 Los instrumentos de percusión cuya notación está en un contexto
3459 @code{DrumStaff} se encontrará a la salida, correctamente, sobre
3460 el canal MIDI número@tie{}10 pero ciertos instrumentos de
3461 percusión afinada como el xilófono, el vibráfono o los timbales,
3462 se tratan como instrumentos @qq{normales}, de forma que la música
3463 de éstos se debe introducir en un contexto @code{Staff} (no
3464 @code{DrumStaff}) para obtener una salida MIDI correcta. Hay una
3465 lista completa de entradas de los @code{sets de percusión del
3466 canal 10} en el archivo @file{scm/midi.scm}. Véase
3467 @rlearning{Otras fuentes de información}.
3470 @node Uso de las repeticiones con el MIDI
3471 @subsection Uso de las repeticiones con el MIDI
3472 @translationof Using repeats with MIDI
3474 @cindex repeticiones en MIDI
3475 @cindex MIDI con repeticiones
3476 @funindex \unfoldRepeats
3478 Las repeticiones se pueden representar en la salida MIDI
3479 aplicando la instrucción @code{\unfoldRepeats}.
3484 \repeat tremolo 8 @{ c'32 e' @}
3485 \repeat percent 2 @{ c''8 d'' @}
3486 \repeat volta 2 @{ c'4 d' e' f' @}
3496 Para restringir el efecto de @code{\unfoldRepeats} a la salida
3497 MIDI únicamente, y al mismo tiempo genera partituras imprimibles,
3498 es necesario hacer @emph{dos} bloques @code{\score}: uno para el
3499 MIDI (con las repeticiones desplegadas) y otro para la notación
3500 (con repeticiones de primera y segunda vez, trémolos y del tipo
3505 @var{@dots{} music @dots{}}
3510 @var{@dots{} music @dots{}}
3516 Si se usan varias voces, cada una de ellas debe contener las
3517 repeticiones completamente desplegadas para poder obtener una
3518 salida MIDI correcta.
3521 Referencia de la notación:
3525 @node Asignación de canales MIDI
3526 @subsection Asignación de canales MIDI
3527 @translationof MIDI channel mapping
3529 @cindex MIDI, canales
3530 @cindex MIDI, pistas
3531 @funindex midiChannelMapping
3533 Cuando se está generando un archivo MIDI de una partitura,
3534 LilyPond asigna cada nota de la partitura automáticamente a un
3535 canal MIDI, aquel en que se tocaría cuando se envía hacia un
3536 dispositivo MIDI. Un canal MIDI tiene una cierta cantidad de
3537 controles disponibles para seleccionar, por ejemplo, el
3538 instrumento que usar para reproducir las notas en ese canal, u
3539 ordenar al dispositivo MIDI que aplique diversos efectos al
3540 sonido producido sobre el canal. En todo momento, cada control
3541 de un canal MIDI solo puede tener asignado un valor único (que
3542 sin embargo se puede modificar, por ejemplo, para cambiar a otro
3543 instrumento en mitad de una partitura).
3545 El estándar MIDI contempla solamente 16 canales por dispositivo
3546 MIDI. Este límite en el número de canales limita también el
3547 número de instrumentos diferentes que pueden estar tocando al
3550 LilyPond crea pistas MIDI separadas para cada pentagrama (o
3551 instrumento o voz, según el valor de
3552 @code{Score.midiChannelMapping}), y también para cada contexto de
3553 letra. No hay un límite para el número de pistas.
3555 Para solventar el número limitado de canales MIDI, LilyPond
3556 contempla algunos modos diferentes para la asignación de canales
3557 MIDI, que se seleccionan usando la propiedad de contexto
3558 @code{Score.midiChannelMapping}. En cada caso, si se necesitan
3559 más canales MIDI que el límite, los números de canal asignados
3560 vuelven a contar desde cero, causando posiblemente una asignación
3561 incorrecta de instrumento a algunas notas. Esta propiedad de
3562 contexto se puede fijar a uno de los siguientes valores:
3568 Reservar un canal MIDI distinto para cada uno de los pentagramas
3569 de la partitura (es el ajuste predeterminado). Todas las notas
3570 de todas las voces comparten el canal MIDI del pentagrama que las
3571 encierra, y todas se codifican dentro de la misma pista MIDI.
3573 El límite de 16 canales se aplica al número total de contextos de
3574 pentagrama y de letra, incluso aunque las letras del MIDI no
3575 consumen un canal MIDI.
3577 @item @code{'instrument}
3579 Reservar un canal MIDI distinto a cada uno de los instrumentos
3580 diferentes especificados en la partitura. Esto significa que
3581 todas las notas reproducidas con el mismo instrumento MIDI
3582 comparten el mismo canal MIDI (y la misma pista), incluso aunque
3583 las notas provengan de diferentes voces o pentagramas.
3585 En este caso los contextos de letra no cuentan para el límite de
3586 16 canales MIDI (ya que no se asignan a un instrumento MIDI), de
3587 forma que este ajuste puede permitir una mejor distribución de
3588 los canales MIDI cuando el número de contextos de pentagrama y de
3589 letra en la partitura excede la cantidad de 16.
3593 Reservar un canal MIDI distinto a cada voz de la partitura que
3594 tenga un nombre único entre las voces de su pentagrama
3595 circundante. Las voces de los distintos pentagramas siempre se
3596 asignan a distintos canales MIDI pero dos voces cualesquiera
3597 contenidas dentro del mismo pentagrama comparten el mismo canal
3598 MIDI sin tienen el mismo nombre. A causa de que
3599 @code{midiInstrument} y los diversos controles MIDI para los
3600 efectos son propiedades del contexto de pentagrama, no se pueden
3601 fijar independientemente para cada voz. La primera voz se
3602 reproduce con el instrumento y los efectos especificados para el
3603 pentagrama, y las voces con un nombre distinto de la primera
3604 recibirán el instrumento y los efectos predeterminados.
3606 Nota: se pueden asignar distintos instrumentos y/o efectos a
3607 varias voces dentro del mismo pentagrama moviendo el
3608 @code{Staff_performer} del contexto @code{Staff} al contexto
3609 @code{Voice}, y dejando que @code{midiChannelMapping} conserve su
3610 valor predeterminado de @code{'staff} o se fije al valor
3611 @code{'instrument}; véase el fragmento de código siguiente.
3615 Por ejemplo, la asignación predeterminada de canal MIDI de una
3616 partitura puede cambiarse al ajuste @code{'instrument} como se
3617 muestra a continuación:
3625 midiChannelMapping = #'instrument
3632 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
3633 {changing-midi-output-to-one-channel-per-voice.ly}
3636 @node Propiedades de contexto para efectos MIDI
3637 @subsection Propiedades de contexto para efectos MIDI
3638 @translationof Context properties for MIDI effects
3640 @cindex Efectos en MIDI
3641 @cindex Panorama en MIDI
3642 @cindex Balance en MIDI
3643 @cindex Estéreo, balance en MIDI
3644 @cindex Expresión en MIDI
3645 @cindex Reverberación en MIDI
3646 @cindex Chorus en MIDI
3647 @funindex midiPanPosition
3648 @funindex midiBalance
3649 @funindex midiExpression
3650 @funindex midiReverbLevel
3651 @funindex midiChorusLevel
3653 Se pueden usar las siguientes propiedades de contexto para
3654 aplicar diversos efectos MIDI a las notas que se reproducen sobre
3655 el canal MIDI asociado con el pentagrama, instrumento MIDI o voz
3656 actual (dependiendo del valor de la propiedad de contexto
3657 @code{Score.midiChannelMapping} y del contexto en que está
3658 situado el @code{Staff_performer}; véase @ref{Asignación de
3661 Los cambios en estas propiedades de contexto afectan a todas las
3662 notas que se reproducen sobre el canal después del cambio, aunque
3663 algunos de los efectos se pueden incluso aplicar también a notas
3664 que están ya sonando en ese momento (dependiendo de la
3665 implementación del dispositivo de salida MIDI).
3667 Se contemplan las siguientes propiedades de contexto:
3671 @item @code{Staff.midiPanPosition}
3673 La posición de panorama controla cómo se distribuye el sonido de
3674 un canal MIDI entre las salidas estéreo izquierda y derecha. La
3675 propiedad de contexto acepta un número entre -1.0 (@code{#LEFT})
3676 y 1.0 (@code{#RIGHT}); el valor -1.0 pone toda la potencia de
3677 sonido en la salida estéreo izquierda (dejando la salida derecha
3678 en completo silencio), el valor 0.0 (@code{#CENTER}) distribuye
3679 el sonido por igual entre las salidas estéreo izquierda y
3680 derecha, y el valor 1.0 mueve todo el sonido a la salida estéreo
3681 derecha. Los valores entre -1.0 y 1.0 se pueden usar para
3682 obtener distribuciones mezcladas entre las salidas estéreo
3683 izquierda y derecha.
3685 @item @code{Staff.midiBalance}
3687 Equilibrio estéreo de un canal MIDI. De forma similar a la
3688 posición de panorama esta propiedad de contexto acepta un número
3689 entre -1.0 (@code{#LEFT}) y 1.0 (@code{#RIGHT}). Varía el
3690 volumen relativo que se envía a los dos altavoces estéreo sin
3691 afectar a la distribución de las propias señales estéreo.
3693 @item @code{Staff.midiExpression}
3695 Nivel de expresión (como una fracción del nivel máximo
3696 disponible) que se aplica a un canal MIDI. Un dispositivo MIDI
3697 combina el nivel de expresión del canal MIDI con el nivel actual
3698 de dinámica de una voz (controlado mediante las instrucciones de
3699 dinámica como @code{\p} o @code{\ff}) para obtener el volumen
3700 total de cada nota dentro de la voz. El control de expresión se
3701 puede usar, por ejemplo, para implementar efectos de crescendo y
3702 decrescendo sobre notas mantenidas (algo que LilyPond no
3703 contempla de forma automática).
3705 @c Issue 4059 contains an attached snippet which shows how this might
3706 @c be done, but this is too large and complex for the NR, even as a
3707 @c referenced snippet. It could be added to the LSR.
3709 El rango de los niveles de expresión se extiende desde 0.0
3710 (ninguna expresión, lo que significa un volumen nulo) hasta 1.0
3711 (expresión al máximo).
3713 @item @code{Staff.midiReverbLevel}
3715 El nivel de reverberación (cono una fracción del máximo nivel
3716 disponible) que se aplica a un canal MIDI. Esta propiedad acepta
3717 números entre 0.0 (sin reverberación) y 1.0 (efecto máximo).
3719 @item @code{Staff.midiChorusLevel}
3721 Nivel del efecto Chorus (como una fracción del máximo nivel
3722 disponible) que se aplica a un canal MIDI. Esta propiedad acepta
3723 números entre 0.0 (sin efecto de chorus) y 1.0 (efecto al
3731 Dado que los archivos MIDI no contienen en realidad ninguna
3732 información sonora, los cambios en estas propiedades de contexto
3733 solamente se convierten en peticiones para que cambien los
3734 controles de canal MIDI dentro de los archivos MIDI emitidos. Si
3735 un dispositivo MIDI determinado (como un reproductor MIDI por
3736 software) puede de hecho manejar cualquiera de estas solicitudes
3737 de un archivo MIDI, es algo que depende totalmente de la
3738 implementación del mismo: un dispositivo podría optar por ignorar
3739 algunas o todas estas solicitudes. Asimismo, la forma en que un
3740 dispositivo MIDI interpreta los diferentes valores de estos
3741 controles (generalmente, el estándar MIDI determina el
3742 comportamiento solamente en los puntos extremos del rango de
3743 valores disponibles para cada control), y el hecho de si un
3744 cambio en el valor de un control afecta a las notas que ya se
3745 están reproduciendo sobre ese canal MIDI o no, también son
3746 aspectos específicos de la implementación del dispositivo MIDI.
3748 Al generar archivos MIDI, LilyPond sencillamente convierte de
3749 forma lineal los valores fraccionarios dentro de cada rango (7
3750 bits, o 14 bits para los controles de canal MIDI que admiten
3751 resolución fina) en valores enteros dentro del rango
3752 correspondiente (de 0 a 127 o de 0 a 32767, respectivamente),
3753 redondeando los valores fraccionarios hacia el entero más próximo
3754 en dirección opuesta al cero. Los valores enteros convertidos se
3755 almacenan tal cual en el archivo MIDI generado. Consulte la
3756 documentación de su dispositivo MIDI para ver información acerca
3757 de cómo interpreta estos valores.
3760 @node Enriquecimiento de la salida MIDI
3761 @subsection Enriquecimiento de la salida MIDI
3762 @translationof Enhancing MIDI output
3765 * El script Articulate::
3768 La salida MIDI predeterminada es muy básica, pero se puede
3769 mejorar mediante la selección de los instrumentos MIDI las
3770 propiedades del bloque @code{\midi} y/o usando el script
3773 @cindex instrumentos, nombres
3774 @cindex MIDI, instrumentos
3775 @cindex articulate, script
3776 @cindex articulate.ly
3777 @funindex Staff.midiInstrument
3780 @node El script Articulate
3781 @subsection El script Articulate
3782 @translationof The Articulate script
3784 Para utilizar el script Articulate, tenemos que incluirlo al
3785 principio de nuestro archivo de entrada:
3788 \include "articulate.ly"
3791 El script crea una salida MIDI en que las notas tienen una
3792 duración ajustada en el tiempo de forma que se correspondan con
3793 una serie de indicaciones de articulación y de tempo. Sin
3794 embargo, la salida tipografiada también se altera para reflejar
3795 literalmente el contenido de la salida MIDI.
3800 @var{@dots{} music @dots{}}
3806 La instrucción @code{\articulate} habilita el procesado de las
3807 abreviaturas como trinos y mordentes de varias notas. En el
3808 propio script puede verse una lista completa de los elementos que
3809 están previstos. Véase @file{ly/articulate.ly}.
3812 Manual de aprendizaje:
3813 @rlearning{Otras fuentes de información}.
3815 Referencia de la notación:
3818 Archivos instalados:
3819 @file{ly/articulate.ly}.
3821 @warning{El script @file{articulate} puede acortar los acordes,
3822 lo que podría no ser adecuado para algunos tipos de instrumento,
3823 como el órgano. Las notas que no tienen ninguna articulación
3824 también se pueden acortar; así, para moderar este efecto limite
3825 el uso de de la función @code{\articulate} a segmentos de música
3826 más breves o modifique los valores de las variables definidas
3827 dentro del script @file{articulate}.}
3831 @node Extraer información musical
3832 @section Extraer información musical
3833 @translationof Extracting musical information
3835 Además de crear un resultado visual y MIDI, LilyPond es capaz de
3836 presentar información musical en forma de texto.
3839 * Impresión del código de notación de LilyPond::
3840 * Impresión de las expresiones musicales de Scheme::
3841 * Guardar los eventos musicales en un archivo::
3845 @node Impresión del código de notación de LilyPond
3846 @subsection Displaying LilyPond notation
3847 @translationof Displaying LilyPond notation
3849 @funindex \displayLilyMusic
3850 La impresión textual de una expresión musical en notación de
3851 LilyPond puede hacerse con la función musical
3852 @code{\displayLilyMusic}. Para ver el resultado, lo más usual es
3853 llamar a LilyPond mediante la línea de órdenes. Por ejemplo,
3857 \displayLilyMusic \transpose c a, @{ c4 e g a bes @}
3861 imprime lo siguiente:
3864 @{ a,4 cis e fis g @}
3867 De forma predeterminada, LilyPond imprime estos mensajes en la
3868 consola junto al resto de los mensajes de la compilación de
3869 LilyPond. Para discernir entre estos mensajes y guardar el
3870 resultado de @code{\displayLilyMusic}, redireccione la salida
3874 lilypond archivo.ly >resultado.txt
3878 Observe que Lilypond no se limita a mostrar la expresión musical,
3879 sino que también la interpreta (porque @code{\displayLilyMusic}
3880 la devuelve además de mostrarla). La conveniencia de esto es que
3881 podemos simplemente insertar @code{\displayLilyMusic} dentro de
3882 una música existente con el objeto de obtener información sobre
3883 ella. Si no queremos que Lilypond, además de mostrar la música,
3884 la interprete, podemos hacer que la ignore usando @code{\void}:
3888 \void \displayLilyMusic \transpose c a, @{ c4 e g a bes @}
3893 @node Impresión de las expresiones musicales de Scheme
3894 @subsection Impresión de las expresiones musicales de Scheme
3895 @translationof Displaying scheme music expressions
3897 Véase @rextend{Presentación de las expresiones musicales}.
3900 @node Guardar los eventos musicales en un archivo
3901 @subsection Guardar los eventos musicales en un archivo
3902 @translationof Saving music events to a file
3904 Los eventos musicales se pueden guardar en un archivo pentagrama
3905 a pentagrama mediante la inclusión de un archivo en nuestra
3906 partitura principal.
3909 \include "event-listener.ly"
3912 De esta forma se crean uno o más archivos llamados
3913 @file{FILENAME-STAFFNAME.notes} ó
3914 @file{FILENAME-unnamed-staff.notes} para cada pentagrama.
3915 Observe que si tiene más de un pentagrama sin nombre, los eventos
3916 de todos los pentagramas se mezclarán entre sí dentro del mismo
3917 archivo. El resultado tiene el aspecto siguiente:
3920 0.000 note 57 4 p-c 2 12
3922 0.250 note 62 4 p-c 7 12
3923 0.500 note 66 8 p-c 9 12
3924 0.625 note 69 8 p-c 14 12
3929 La sintaxis consiste en una línea delimitada por caracteres de
3930 tabulación, con dos campos fijos en cada línea seguidos de
3931 parámetros opcionales.
3934 @var{tiempo} @var{tipo} @var{@dots{}parámetros@dots{}}
3937 Esta información se puede leer fácilmente por parte de otros
3938 programas como guiones de Python, y pueden ser muy útiles para
3939 aquellos investigadores que desean realizar un análisis musical o
3940 hacer experimentos de reproducción con LilyPond.
3943 No todos los eventos musicales de lilypond están contemplados por
3944 @file{event-listener.ly}. Se pretende que sea una @qq{prueba de
3945 concepto} bien realizada. Si algunos eventos que quiere ver no
3946 aparecen incluidos, copie @file{event-listener.ly} en su carpeta
3947 de lilypond y modifique el archivo de forma que produzca la
3948 información que desea.