1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
4 Translation of GIT committish: 4c2851d28c0a94a30cc7652b9b0052ce7f0ade7e
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. For details, see the Contributors'
8 Guide, node Updating translation committishes..
13 @node Entrada y salida generales
14 @chapter Entrada y salida generales
15 @translationof General input and output
17 Esta sección trata de asuntos relacionados con la entrada y salida
18 generales de LilyPond, más que con la notación específica.
21 * Estructura del código de entrada::
22 * Títulos y cabeceras::
23 * Trabajar sobre los archivos de entrada::
24 * Controlar la salida::
26 * Extraer información musical::
30 @node Estructura del código de entrada
31 @section Estructura del código de entrada
32 @translationof Input structure
34 El formato principal de entrada para LilyPond son archivos de texto.
35 Por convenio, el nombre de estos archivos termina en @file{.ly}.
38 * Estructura de una partitura::
39 * Varias partituras en un libro::
40 * Varios archivos de salida a partir de uno de entrada::
41 * Nombres de los archivos de salida::
42 * Estructura del archivo::
46 @node Estructura de una partitura
47 @subsection Estructura de una partitura
48 @translationof Structure of a score
52 Un bloque @code{\score} debe contener una expresión musical única
53 delimitada por un par de llaves:
62 @warning{Sólo puede haber @strong{una} expresión musical dentro del
63 bloque @code{\score}, y @strong{debe} estar encerrada entre llaves.}
65 Esta expresión musical única puede tener cualquier tamaño, y puede
66 contener otras expresiones musicales hasta cualquier grado de
67 complejidad. Todos los siguientes ejemplos son expresiones musicales:
73 @lilypond[verbatim,quote]
80 @lilypond[verbatim,quote]
82 \new Staff { c'4 c' c' c' }
83 \new Staff { d'4 d' d' d' }
91 \new Staff @{ \flute @}
92 \new Staff @{ \oboe @}
95 \new Staff @{ \violinI @}
96 \new Staff @{ \violinII @}
102 Los comentarios son una excepción a esta regla general (para ver otras
103 excepciones, consulte @ref{Estructura del archivo}). Tanto los comentarios de
104 una línea como los que están delimitados por @code{%@{ .. %@}} se
105 pueden escribir en cualquier lugar dentro del archivo de entrada. Se
106 pueden escribir dentro o fuera del bloque @code{\score}, y dentro o
107 fuera de la expresión musical única dentro del bloque @code{\score}.
109 Recuerde que incluso dentro de un archivo que contenga solamente un
110 bloque @code{\score}, éste se encuentra incluido implícitamente dentro
111 de un bloque @code{\book}. Un bloque @code{\book} dentro de un
112 archivo fuente produce al menos un archivo de salida, y de forma
113 predeterminada el nombre del archivo de salida que se produce está
114 derivado del nombre del archivo de entrada, de forma que
115 @file{fandangoforelephants.ly} da como resultado
116 @file{fandangoforelephants.pdf}.
118 (Para ver más detalles acerca de los bloques @code{\book}, consulte
119 @ref{Varias partituras en un libro}, @ref{Varios archivos de salida a
120 partir de uno de entrada} y @ref{Estructura del archivo}.)
123 Manual de aprendizaje:
124 @rlearning{Trabajar sobre los archivos de entrada},
125 @rlearning{Explicación de las expresiones musicales},
126 @rlearning{La partitura es una (única) expresión musical compuesta}.
129 @node Varias partituras en un libro
130 @subsection Varias partituras en un libro
131 @translationof Multiple scores in a book
134 @cindex movimientos, varios
136 Un documento puede contener varias piezas de música y texto. Son
137 ejemplos un libro de estudios o una parte orquestal con varios
138 movimientos. Cada movimiento se introduce con un bloque
147 y los textos se introducen con un bloque @code{\markup}:
157 Todos los movimientos y textos que aparecen en el mismo archivo
158 @file{.ly} se tipografían normalmente en la forma de un solo archivo
173 Una excepción importante se da dentro de los documentos de
174 lilypond-book, en los que tenemos que escribir explícitamente un
175 bloque @code{\book}, pues en caso contrario sólo aparecerá en la
176 salida el primer @code{\score} o @code{\markup}.
178 El encabezamiento de cada pieza se puede poner dentro del bloque
179 @code{\score}. Antes de cada movimiento, se imprime el nombre de la
180 pieza (@code{piece}) extraído del encabezamiento. El título del libro
181 entero se puede poner dentro del bloque @code{\book}, pero si no está
182 presente se inserta el encabezamiento @code{\header} que está al
183 principio del archivo.
187 title = "Ocho miniaturas"
188 composer = "Igor Stravinsky"
192 \header @{ piece = "Romanze" @}
195 ..texto de la segunda estrofa..
198 ..texto de la tercera estrofa..
202 \header @{ piece = "Menuetto" @}
208 Se pueden agrupar distintas piezas de música en partes de un libro
209 utilizando bloques @code{\bookpart}. Las partes de libro se separan
210 por medio de saltos de página, y pueden dar comienzo con un título,
211 como el libro propiamente dicho, mediante la especificación del bloque
217 title = "Título del libro"
218 subtitle = "Primera parte"
225 subtitle = "Segunda parte"
233 @node Varios archivos de salida a partir de uno de entrada
234 @subsection Varios archivos de salida a partir de uno de entrada
235 @translationof Multiple output files from one input file
237 Si queremos varios archivos de salida a partir del mismo archivo
238 @file{.ly}, podemos escribir varios bloques @code{\book}, donde cada
239 uno de estos bloques @code{\book} dará como resultado un archivo de
240 salida distinto. Si no especificamos ningún bloque @code{\book} en el
241 archivo, LilyPond trata implícitamente todo el archivo como un solo
242 bloque @code{\book}, véase @ref{Estructura del archivo}.
244 Al producir varios archivos a partir de un solo archivo fuente,
245 Lilypond se asegura de que ninguno de los archivos de salida de ningún
246 bloque @code{\book} sobreescribe el archivo de salida producido por un
247 @code{\book} anterior del mismo archivo de entrada.
249 Lo hace añadiendo un sufijo al nombre de la salida para cada libro
250 @code{\book} que utiliza el nombre del archivo de salida
251 predeterminado, derivado del archivo fuente de entrada.
253 El comportamiento predeterminado es añadir un sufijo con el número de
254 versión para cada nombre que pueda coincidir; así:
259 \layout @{ @dots{} @}
263 \layout @{ @dots{} @}
267 \layout @{ @dots{} @}
271 en el archivo fuente @file{eightminiatures.ly}, produce
275 @file{eightminiatures.pdf},
277 @file{eightminiatures-1.pdf} y
279 @file{eightminiatures-2.pdf}.
283 @node Nombres de los archivos de salida
284 @subsection Nombres de los archivos de salida
285 @translationof Output file names
287 @funindex \bookOutputSuffix
288 @funindex \bookOutputName
290 Lilypond le ofrece unos mecanismos que le permiten controlar los
291 nombres de archivo que se utilizan por parte de los diversos motores
292 finales al producir los archivos de salida.
294 En la sección anterior vimos cómo Lilypond evita las coincidencias de
295 nombres al producir varias salidas a partir de un único archivo fuente
296 de entrada. También podemos especificar nuestros propios sufijos para
297 cada bloque @code{\book}, de manera que podemos producir, por ejemplo,
298 archivos con los nombres @file{eightminiatures-Romanze.pdf},
299 @file{eightminiatures-Menuetto.pdf} y
300 @file{eightminiatures-Nocturne.pdf} añadiendo una declaración
301 @code{\bookOutputSuffix} dentro de cada bloque @code{\book}.
305 \bookOutputSuffix "Romanze"
307 \layout @{ @dots{} @}
310 \bookOutputSuffix "Menuetto"
312 \layout @{ @dots{} @}
315 \bookOutputSuffix "Nocturne"
317 \layout @{ @dots{} @}
321 También podemos especificar un nombre de archivo de salida diferente
322 para cada bloque @code{book}, mediante la utilización de declaraciones
323 @code{\bookOutputName}:
327 \bookOutputName "Romanze"
329 \layout @{ @dots{} @}
332 \bookOutputName "Menuetto"
334 \layout @{ @dots{} @}
337 \bookOutputName "Nocturne"
339 \layout @{ @dots{} @}
343 El código anterior produce los siguientes archivos de salida:
349 @file{Menuetto.pdf} y
355 @node Estructura del archivo
356 @subsection Estructura del archivo
357 @translationof File structure
367 Un archivo @file{.ly} puede contener cualquier número de expresiones
368 del nivel superior, donde una expresión del nivel superior es una de
369 las siguientes posibilidades:
373 Una definición de salida, como @code{\paper}, @code{\midi} y
374 @code{\layout}. Tal definición en el nivel más alto cambia los
375 ajustes predeterminados para todo el libro. Si se introduce más de
376 una de estas definiciones del mismo tipo en el nivel más alto, las
377 definiciones se combinan, pero en situaciones de conflicto las
378 definiciones más tardías tienen preferencia. Para ver los detalles
379 sobre cómo afecta al bloque @code{\layout}, consulte
380 @ref{El bloque \layout}.
383 Una expresión directa de Scheme, como
384 @code{#(set-default-paper-size "a7" 'landscape)} o
385 @code{#(ly:set-option 'point-and-click #f)}.
388 Un bloque @code{\header}. Esto establece el bloque de encabezamiento
389 global. Es el bloque que contiene las definiciones de los ajustes
390 para todo el libro, como el compositor, título, etc.
393 Un bloque @code{\score}. Esta partitura se reúne con otras partituras
394 del nivel superior, y se combina con ellas formando un @code{\book}
395 (libro) único. Este comportamiento se puede cambiar estableciendo el
396 valor de la variable @code{toplevel-score-handler} en el nivel
397 superior. El @emph{handler} predeterminado se define en el archivo de
398 inicio @file{../scm/lily.scm}.
401 Un bloque @code{\book} combina lógicamente varios movimientos (es
402 decir, varios bloques @code{\score}) en un solo documento. Si hay
403 varias partituras @code{\score}, se crea un solo archivo de salida
404 para cada bloque @code{\book}, en el que se concatenan todos los
405 movimientos correspondientes. La única razón para especificar
406 explícitamente bloques @code{\book} en un archivo de entrada
407 @file{.ly} es si queremos crear varios archivos de salida a partir de
408 un único archivo de entrada. Una excepción se da dentro de los
409 documentos de lilypond-book, en los que tenemos que escribir
410 explícitamente un bloque @code{\book} si queremos tener más de una
411 única partitura @code{\score} o marcado @code{\markup} en el mismo
412 ejemplo. Se puede cambiar este comportamiento estableciendo el valor
413 de la variable @code{toplevel-book-handler} en el nivel superior. El
414 @emph{handler} predeterminado se define en el archivo de inicio
415 @file{../scm/lily.scm}.
418 Un bloque @code{\bookpart}. Un libro puede dividirse en varias
419 partes, utilizando bloques @code{\bookpart}, con objeto de facilitar
420 la inserción de saltos de página o usar distintos ajustes de
421 @code{\paper} en las distintas partes.
424 Una expresión musical compuesta, como
429 Esto añade la pieza al @code{\score} y la conforma dentro de un libro
430 único junto a todas las demás partituras @code{\score} y expresiones
431 musicales del nivel superior. En otras palabras, un archivo que
432 contiene sólo la expresión musical anterior se traduce a
449 Se puede cambiar este comportamiento estableciendo el valor de la
450 variable @code{toplevel-music-handler} en el nivel más alto. El
451 @emph{handler} predeterminado se define en el archivo de inicio
452 @file{../scm/lily.scm}.
455 Un texto de marcado, por ejemplo una estrofa
458 2. Estrofa dos, línea uno
462 Los textos de marcado se colocan encima, en medio o debajo de las
463 partituras o expresiones musicales, según donde aparezcan escritos.
470 fulano = @{ c4 d e d @}
473 Esto se puede utilizar más tarde en el archivo escribiendo
474 @code{\fulano}. El nombre de las variables ha de ser exclusivamente
475 alfabético; sin números, guiones ni barras bajas.
479 El ejemplo siguiente muestra tres cosas que se pueden introducir en el
484 % No justificar la salida
495 En cualquier punto del archivo se pueden introducir cualquiera de las
496 instrucciones léxicas siguientes:
499 @item @code{\version}
500 @item @code{\include}
501 @item @code{\sourcefilename}
502 @item @code{\sourcefileline}
504 Un comentario de una línea, determinado por un símbolo @code{%} al principio.
507 Un comentario de varias líneas, delimitado por @code{%@{ .. %@}}.
511 @cindex espacios en blanco
513 Por lo general se ignoran los espacios entre elementos del flujo de
514 entrada, y se pueden omitir o aumentar tranquilamente para mejorar la
515 legibilidad. Sin embargo, los espacios se deben utilizar siempre para
516 evitar errores, en las siguientes situaciones:
519 @item Alrededor de todas y cada una de las llaves curvas de apertura y cierre.
520 @item A continuación de las instrucciones y variables, es decir, todos los elementos
521 que comienzan con un signo @code{\} de barra invertida.
522 @item A continuación de todo elemento que se deba interpretar como expresión
523 de Scheme, es decir, todo elemento que comience por un signo@tie{}@code{#}.
524 @item Para separar los elementos de una expresión de Scheme.
525 @item Dentro de @code{lyricmode} para separar todos los términos de las instrucciones
526 @code{\override} y @code{\set}. Concretamente, hay que usar espacios
527 alrededor del punto y el signo igual en instrucciones como
528 @code{\override Score . LyricText #'font-size = #5} y antes y después
529 de la instrucción completa.
534 Manual de aprendizaje:
535 @rlearning{Cómo funcionan los archivos de entrada de LilyPond}.
537 Referencia de la notación:
538 @ref{El bloque \layout}.
540 @node Títulos y cabeceras
541 @section Títulos y cabeceras
542 @translationof Titles and headers
544 Casi toda la música impresa tiene un título y el nombre del
545 compositor; ciertas piezas tienen mucha más información.
548 * Crear títulos cabeceras y pies de página::
549 * Cabeceras pies y títulos personalizados::
550 * Crear notas al pie::
551 * Referencia a números de página::
556 @node Crear títulos cabeceras y pies de página
557 @subsection Crear títulos, cabeceras y pies de página
558 @translationof Creating titles headers and footers
561 * Explicación de los bloques de títulos::
562 * Presentación predeterminada de los bloques de título del libro y la partitura::
563 * Disposición predeterminada de las cabeceras y pies de página::
567 @node Explicación de los bloques de títulos
568 @unnumberedsubsubsec Explicación de los bloques de títulos
569 @translationof Title blocks explained
571 @c TODO: figure out how \bookpart titles work
573 Existen dos clases de bloques de títulos: el bloque principal de
574 títulos que aparece encima del primer bloque @code{\score} de un
575 libro, y los bloques individuales de título que aparecen dentro de
576 cada bloque @code{\score}. Los campos de texto para los dos tipos de
577 bloque se introducen mediante un bloque @code{\header}.
579 Si el libro tiene una única partitura, el bloque @code{\header} se
580 puede situar dentro o fuera del bloque @code{\score}.
582 @warning{Recuerde que al añadir un bloque @bs{}@code{header} dentro de
583 un bloque @bs{}@code{score}, la expresión musical debe aparecer antes
584 del bloque @bs{}@code{header}.}
586 @lilypond[papersize=a5,quote,verbatim,noragged-right]
589 composer = "J. S. Bach."
593 \new Staff \relative g, {
596 \repeat unfold 2 { g16( d' b') a b d, b' d, } |
597 \repeat unfold 2 { g,16( e' c') b c e, c' e, } |
605 \new Staff \relative b {
609 <g, d' b'~>4 b'16 a( g fis) g( d e fis) g( a b c) |
610 d16( b g fis) g( e d c) b(c d e) fis( g a b) |
618 Los campos de texto extraídos del bloque prinicipal de título de un
619 libro se pueden imprimir en todos los bloques @code{\score}, o
620 suprimirse manualmente:
622 @lilypond[papersize=a5,quote,verbatim,noragged-right]
625 print-all-headers = ##t
628 title = "DAS WOHLTEMPERIRTE CLAVIER"
630 % Do not display the tagline for this book
633 \markup { \vspace #1 }
637 \new Staff { \clef "bass" s1 }
640 title = "PRAELUDIUM I"
642 % Do not display the subtitle for this score
649 \new Staff { \clef "bass" s1 }
653 subsubtitle = "A 4 VOCI"
655 % Do not display the subtitle for this score
663 Referencia de la notación:
664 @ref{Estructura del archivo},
665 @ref{Personalización de los bloques de título}.
668 @node Presentación predeterminada de los bloques de título del libro y la partitura
669 @unnumberedsubsubsec Presentación predeterminada de los bloques de título del libro y la partitura
670 @translationof Default layout of book and score title blocks
672 Este ejemplo muestra todas las variables de @code{\header}:
675 @lilypond[papersize=a7,quote,verbatim,noragged-right]
678 % Los siguientes campos están centrados
679 dedication = "Dedication (dedicatoria)"
680 title = "Title (título)"
681 subtitle = "Subtitle (subtítulo)"
682 subsubtitle = "Subsubtitle (sub-subtítulo)"
683 % Los siguientes campos se distribuyen regularmente sobre una línea
684 % el campo "instrument" también aparece en las siguientes páginas
685 instrument = \markup \with-color #green "Instrument (instrumento)"
686 poet = "Poet (poeta)"
687 composer = "Composer (autor)"
688 % Los siguientes campos se sitúan en los extremos opuestos de la misma línea
689 meter = "Meter (metro)"
690 arranger = "Arranger (arreglista)"
691 % Los siguientes campos están centrados en la parte inferior
692 tagline = "la tagline o línea de etiqueta va al final de la úitlma página"
693 copyright = "el copyright va al final de la primera página"
698 % Los siguientes campos se colocan en los extremos de una línea
699 piece = "Piece (pieza) 1"
706 % Los siguientes campos se sitúan en los extremos de una línea
707 piece = "Piece (pieza) 2 en la misma página"
715 % Los siguientes campos se sitúan en los extremos de una línea
716 piece = "Piece (pieza) 3 en una página nueva"
727 El nombre de instrumento se repite en todas las páginas.
730 Solamente @code{piece} (la pieza) y @code{opus} se imprimen en una
731 @code{\score} cuando la variable de papel @code{print-all-headers} se
732 establece a @code{##f} (el valor predeterminado).
735 @c Is the bit about \null markups true? -mp
736 Los campos de texto que se dejan sin establecer dentro de un bloque
737 @code{\header} se sustituyen por elementos de marcado nulos
738 @code{\null} de manera que no ocupen espacio innecesariamente.
741 Los ajustes predeterminados para @code{scoreTitleMarkup} sitúan los
742 campos de texto @code{piece} y @code{opus} en extremos opuestos de la
747 Para cambiar la disposición predeterminada, véase
748 @ref{Personalización de los bloques de título}.
752 Utilice la variable @code{breakbefore} dentro de un bloque
753 @code{\header} que está propiamente dentro de un bloque @code{\score}
754 para hacer que los títulos del bloque @code{\header} del nivel
755 superior aparezcan ocupando toda la primera página, empezando la
756 música (definida en el bloque @code{\score}) en la página siguiente.
759 @lilypond[papersize=a8landscape,verbatim,noragged-right]
762 title = "Este es mi Title (título)"
763 subtitle = "Este es mi Subtitle (subtítulo)"
764 copyright = "Este es el final de la primera página"
767 \repeat unfold 4 { e'' e'' e'' e'' }
769 piece = "Esto es la música"
777 Manual de aprendizaje:
778 @rlearning{Cómo funcionan los archivos de entrada de LilyPond}
780 Referencia de la notación:
781 @ref{Personalización de los bloques de título},
782 @ref{Estructura del archivo}.
785 @file{ly/titling-init.ly}.
788 @node Disposición predeterminada de las cabeceras y pies de página
789 @unnumberedsubsubsec Disposición predeterminada de las cabeceras y pies de página
790 @translationof Default layout of headers and footers
792 Las @emph{cabeceras} y los @emph{pies} de página son líneas de texto
793 que aparecen en la parte más alta y en la más baja de las páginas
794 separadas del texto principal de un libro. Se controlan mediante las
795 siguientes variables de @code{\paper}:
798 @item @code{oddHeaderMarkup} (marcado de cabecera impar)
799 @item @code{evenHeaderMarkup} (marcado de cabecera par)
800 @item @code{oddFooterMarkup} (marcado de pie impar)
801 @item @code{evenFooterMarkup} (marcado de pie par)
804 Estas variables de marcado sólo pueden acceder a los campos de texto
805 extraídos de bloques @code{\header} del nivel superior (que se aplican
806 a todas las partituras del libro) y se definen en el archivo
807 @file{ly/titling-init.ly}. De forma predeterminada:
812 los números de página se sitúan automáticamente en el extremo superior
813 izquierdo (si es par) o superior derecho (si es impar), a partir de la
817 el campo de texto @code{instrument} se sitúa en el centro en cada
818 página, a partir de la segunda página.
821 el texto de @code{copyright} se centra en la parte baja de la primera
825 la línea @code{tagline} se centra al final de la última página, y
826 debajo del texto de @code{copyright} si sólo hay una página.
830 @lilypond[papersize=a8landscape]
840 La línea de etiqueta tagline predeterminada se puede cambiar añadiendo un campo
841 @code{tagline} en el bloque @code{\header} del nivel superior.
843 @lilypond[papersize=a8landscape,verbatim]
846 tagline = "... music notation for Everyone"
856 Para eliminar la línea @code{tagline}, establezca su valor a
860 @node Cabeceras pies y títulos personalizados
861 @subsection Cabeceras, pies y títulos personalizados
862 @translationof Custom headers footers and titles
864 @c TODO: somewhere put a link to header spacing info
865 @c (you'll have to explain it more in NR 4).
868 * Formateo personalizado del texto de los bloques de título::
869 * Personalización de los bloques de título::
870 * Disposición personalizada de cabeceras y pies de página::
874 @node Formateo personalizado del texto de los bloques de título
875 @unnumberedsubsubsec Formateo personalizado del texto de los bloques de título
876 @translationof Custom text formatting for title blocks
878 Se pueden usar instrucciones @code{\markup} estándar para personalizar
879 el texto de cualquier cabecera, pie o título dentro del bloque
882 @lilypond[quote,verbatim,noragged-right]
886 piece = \markup { \fontsize #4 \bold "PRAELUDIUM I" }
887 subtitle = \markup { \italic "(Excerpt)" }
893 Referencia de la notación:
894 @ref{Formatear el texto}.
897 @node Personalización de los bloques de título
898 @unnumberedsubsubsec Personalización de los bloques de título
899 @translationof Custom layout for title blocks
901 @cindex bookTitleMarkup
902 @cindex scoreTitleMarkup
903 @funindex bookTitleMarkup
904 @funindex scoreTitleMarkup
906 Las instrucciones @code{\markup} dentro del bloque @code{\header} son
907 útiles para dar un formato simple al texto, pero no permiten un
908 control preciso sobre la colocación de los títulos. Para personalizar
909 la colocación de los campos de texto, cambie una o las dos variables de
910 @code{\paper} siguientes:
913 @item @code{bookTitleMarkup} (marcado de título del libro)
914 @item @code{scoreTitleMarkup} (marcado de título de la partitura)
917 La colocación de los títulos cuando se utilizan los valores
918 predeterminados de estas variables de @code{\markup} se muestra en los
920 @ref{Presentación predeterminada de los bloques de título del libro y la partitura}.
922 Los ajustes predeterminados para @code{scoreTitleMarkup} tal y como
923 están definidos en el archivo @file{ly/titling-init.ly} son:
926 scoreTitleMarkup = \markup @{ \column @{
927 \on-the-fly #print-all-headers @{ \bookTitleMarkup \hspace #1 @}
929 \fromproperty #'header:piece
930 \fromproperty #'header:opus
936 Esto sitúa los campos de texto @code{piece} y @code{opus} en extremos
937 opuestos de la misma línea:
939 @lilypond[quote,verbatim,noragged-right]
943 piece = "PRAELUDIUM I"
949 Este ejemplo redefine @code{scoreTitleMarkup} de manera que el campo
950 de texto @code{piece} aparece centrado y en un tipo de letra grande y
953 @lilypond[papersize=a5,quote,verbatim,noragged-right]
957 scoreTitleMarkup = \markup {
960 \fontsize #4 \bold \fromproperty #'header:piece
961 \fromproperty #'header:opus
965 \header { tagline = ##f }
969 piece = "PRAELUDIUM I"
976 Los campos de texto reservados normalmente para el bloque principal de
977 título se pueden insertar dentro de los bloques de título de las
978 partituras individuales con la variable @code{print-all-headers}
979 establecida dentro del bloque @code{\paper}. Una desventaja de la
980 utilización de este método es que los campos de texto que están
981 orientados específicamente para el bloque @code{\header} del nivel
982 superior han de suprimirse manualmente en cada uno de los bloques
983 @code{\score}. Véase @ref{Explicación de los bloques de títulos}.
985 Para evitarlo, añada el campo de texto deseado a la definición de
986 @code{scoreTitleMarkup}. En el ejemplo siguiente, el campo de texto
987 @code{composer} (asociado normalmente con @code{bookTitleMarkup}) se
988 añade a @code{scoreTitleMarkup}, permitiendo que cada partitura
989 muestre un compositor diferente:
991 @lilypond[papersize=a5,quote,verbatim,noragged-right]
995 scoreTitleMarkup = \markup {
998 \fontsize #4 \bold \fromproperty #'header:piece
999 \fromproperty #'header:composer
1003 \header { tagline = ##f }
1008 composer = "Christian Petzold"
1015 composer = "François Couperin"
1021 También podemos crear nuestros propios campos de texto personalizados,
1022 y referirnos a ellos en la definición del elemento de marcado.
1024 @lilypond[papersize=a5,quote,verbatim,noragged-right]
1028 scoreTitleMarkup = \markup {
1031 \override #`(direction . ,UP) {
1033 \center-align \fontsize #-1 \bold
1034 \fromproperty #'header:mycustomtext %% User-defined field
1035 \center-align \fontsize #4 \bold
1036 \fromproperty #'header:piece
1039 \fromproperty #'header:opus
1043 \header { tagline = ##f }
1048 mycustomtext = "A 4 VOCI" %% User-defined field
1056 Referencia de la notación:
1057 @ref{Explicación de los bloques de títulos}.
1060 @node Disposición personalizada de cabeceras y pies de página
1061 @unnumberedsubsubsec Disposición personalizada de cabeceras y pies de página
1062 @translationof Custom layout for headers and footers
1064 @c can make-header and make-footer be removed from
1065 @c paper-defaults-init.ly? -mp
1067 Las instrucciones @code{\markup} dentro del bloque @code{\header} son
1068 de utilidad para dar formato al texto de una manera sencilla, pero no
1069 permiten un control preciso sobre la colocación de las cabeceras y los
1070 pies de página. Para personalizar la colocación de los campos de
1071 texto, use una o más de las siguientes variables de @code{\paper}:
1074 @item @code{oddHeaderMarkup} (marcado de encabezamiento impar)
1075 @item @code{evenHeaderMarkup} (marcado de encabezamiento par)
1076 @item @code{oddFooterMarkup} (marcado de pie de página impar)
1077 @item @code{evenFooterMarkup} (marcado de pie de página par)
1080 @cindex marcado condicional
1082 @funindex \on-the-fly
1084 La instrucción de marcado @code{\on-the-fly} se puede utilizar para
1085 añadir elementos de forma condicional al texto de encabezamiento y pie
1086 de página definido dentro del bloque @code{\paper}, usando la sintaxis
1090 @code{variable} = @code{\markup} @{
1092 @code{\on-the-fly} #@var{procedimiento} @var{marcado}
1097 El @var{procedimiento} se llama cada vez que se evalúa la instrucción
1098 @code{\markup} en que ésta aparece. El @var{procedimiento} debería
1099 comprobar si se cumple una condición determinada e interpretar (es
1100 decir: imprimir) el argumento @var{marcado} si, y sólo si, la
1101 condición es verdadera.
1103 Se proveen un cierto número de procedimientos ya hechos para la
1104 comprobación de diversas condiciones:
1107 @multitable {print-page-number-check-first-----} {¿es el núm. de páginas en la parte de libro > 1?-----}
1109 @headitem Nombre del procedimiento @tab Condición que se comprueba
1111 @item print-page-number-check-first @tab ¿debería imprimirse esta página?
1112 @item create-page-number-stencil @tab ¿es 'print-page-numbers verdadero?
1113 @item print-all-headers @tab ¿es 'print-all-headers verdadero?
1114 @item first-page @tab ¿es la primera página del libro?
1115 @item (on-page nmbr) @tab ¿es el número de página = nmbr?
1116 @item last-page @tab ¿es la última página del libro?
1117 @item not-first-page @tab ¿no es la primera página del libro?
1118 @item part-first-page @tab ¿es la primera página de la parte de libro?
1119 @item part-last-page @tab ¿es la última página de la parte de libro?
1120 @item not-single-page @tab ¿es el núm. de páginas en la parte de libro > 1?
1125 El ejemplo siguiente centra los números de página en la parte baja de
1126 las páginas. En primer lugar, los ajustes predeterminados para
1127 @code{oddHeaderMarkup} y @code{evenHeaderMarkup} se eliminan
1128 definiéndolos como un marcado @emph{nulo}. Después de esto, se
1129 redefine @code{oddFooterMarkup} con el número de página centrado.
1130 Finalmente, @code{evenFooterMarkup} recibe la misma disposición
1131 definiéndola como @code{\oddFooterMarkup}:
1133 @lilypond[papersize=a8,quote,verbatim,noragged-right]
1136 print-page-number = ##t
1137 print-first-page-number = ##t
1138 oddHeaderMarkup = \markup \null
1139 evenHeaderMarkup = \markup \null
1140 oddFooterMarkup = \markup {
1142 \on-the-fly #print-page-number-check-first
1143 \fromproperty #'page:page-number-string
1146 evenFooterMarkup = \oddFooterMarkup
1149 \new Staff { s1 \break s1 \break s1 }
1154 Se pueden combinar varias condiciones de @code{\on-the-fly} con un
1155 operador @q{and}, por ejemplo:
1158 @code{\on-the-fly #first-page}
1159 @code{\on-the-fly #last-page}
1160 @code{@{ \markup ... \fromproperty #'header: ... @}}
1163 determina si la salida es una sola página.
1166 Referencia de la notación:
1167 @ref{Explicación de los bloques de títulos},
1168 @ref{Presentación predeterminada de los bloques de título del libro y la partitura}.
1170 Archivos instalados:
1171 @file{../ly/titling-init.ly}.
1174 @node Crear notas al pie
1175 @subsection Crear notas al pie
1176 @translationof Creating footnotes
1178 Se pueden crear dos tipos de notas al pie: automáticas y manuales.
1181 * Panorámica de las notas al pie::
1182 * Notas al pie automáticas::
1183 * Notas al pie manuales::
1186 @node Panorámica de las notas al pie
1187 @unnumberedsubsubsec Panorámica de las notas al pie
1188 @translationof Footnotes overview
1190 Las notas al pie automáticas crean indicadores numéricos crecientes;
1191 en cambio las notas al pie manuales permiten crear un indicador
1192 personalizado. Normalmente, las notas al pie se aplican como
1193 @code{\tweak}s y por ello se pueden colocar directamente sobre los
1194 grobs (objetos gráficos) creados por la mayor parte de los elementos y
1195 post-eventos musicales. En los casos en que esto no funciona así
1196 (como con las líneas divisorias y los cambios de compás, donde los
1197 grobs se producen como consecuencia de cambios en propiedades), las
1198 notas al pie se pueden también especificar como un evento musical
1199 independiente que afecta a todos los grobs de un tipo dado en un punto
1202 La forma completa de una instrucción de nota al pie es
1205 \footnote @var{marca} @var{desplazamiento} @var{grob} @var{nota}
1209 Los elementos son como sigue:
1213 es un elemento de marcado o cadena que especifica la nmarca de nota al
1214 pie que se usa tanto para señalar el punto de referencia como la nota
1215 en sí en la parte inferior de la página. Se puede omitir (o, de forma
1216 equivalente, sustituirse con @code{\default}) en cuyo caso se genera
1217 un número en secuencia.
1218 @item desplazamiento
1219 es una pareja de números como @samp{#(2 . 1)} que especifica los
1220 desplazamientos X e Y a partir del punto de referencia en que se
1223 especifica, por su nombre, un tipo de objeto gráfico o grob que marcar
1224 (como @samp{#'Flag} para el corchete de una nota). Si se da, el grob
1225 respectivo se usa como punto de referencia incluso en el caso de que
1226 su @q{causa} no sea la propia @var{música} referenciada sino un grob
1227 creado a partir de ella. Se puede omitit (o sustituirse por
1228 @code{\default}), y entonces sólo se anotará un grob creado
1231 Esta cadena o elemento de marcado especifica el texto de la nota que
1232 utilizar en la parte inferior de la página.
1234 Éste es el elemento, evento musical o componente de un acorde o
1235 post-evento, que se está anotando. Aunque no puede omitirse, @emph{sí
1236 puede} sustituirse por @code{\default} en cuyo caso la nota al pie no
1237 se adjunta a una expresión musical dada, sino a un momento de tiempo.
1238 Es obligatorio en este caso utilizar el argumento @var{grob} para
1239 seleccionar un tipo de grob afectado, como @samp{#'TimeSignature}
1240 (indicación de compás).
1243 Como ocurre con @code{\tweak}, si nuestra @code{\footnote} se aplica a
1244 un post-evento o articulación, tendrá que ser ella misma precedida de
1245 @code{-} para que el analizador sintáctico adjunte el resultado a la
1246 nota o silencio precedente.
1249 @node Notas al pie automáticas
1250 @unnumberedsubsubsec Notas al pie automáticas
1251 @translationof Automatic footnotes
1253 Las notas al pie automáticas toman cuatro argumentos: la posición
1254 @samp{(x . y)} del indicador, el nombre opcional del @var{grob} que
1255 especifica el objeto de presentación que se anota, el elemento de
1256 marcado de la porpia @var{nota} que aparecerá en la parte inferior de
1257 la página, y por supuesto la @var{música} a que adjuntar la nota al
1260 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1262 \header { tagline = ##f }
1264 \footnote #'(0.5 . -2)
1265 \markup { The first note }
1267 \footnote #'(0.5 . 1) #'Flag
1268 \markup { The third note }
1274 Las notas en acorde no ofrecen ninguna dificultad especial:
1276 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1278 \header { tagline = ##f }
1281 \footnote #'(1 . -1.25) "Here is a C" c
1282 \footnote #'(2 . -0.25) \markup { \italic "An E-flat" } es
1283 \footnote #'(2 . 3) \markup { \bold "This is a G" } g
1289 @warning{Cuando las notas al pie tienen la misma posición vertical, se
1290 imprimen en orden de descendencia: cuando más alta es la nota al pie,
1291 más arriba está en la lista.}
1293 He aquí unos ejemplos más de grobs con notas al pie, que
1294 muestran también la posición relativa de las notas respecto de la
1295 línea informativa y la línea de copyright.
1297 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1299 \header { copyright = \markup { "Copyright 1970" } }
1301 a'4-\footnote #'(-3 . 0) \markup { \bold Forte } \f
1302 -\footnote #'(0 . 1.5) \markup { A slur } (
1303 b8)-\footnote #'(0 . -2) \markup { Beam } [ e]
1304 \footnote #'(1 . -1) #'Stem
1305 \markup { \teeny { This is a stem } }
1307 \footnote #'(0 . 0.5) #'AccidentalCautionary
1308 \markup \italic { A cautionary accidental }
1309 \footnote #'(1 . 1) "The note itself"
1310 dis?4-\footnote #'(0.5 . -0.5) \markup \italic { Slow Down }
1316 Para los elementos @code{\markup} del nivel superior, se requiere el
1317 uso de la instrucción @code{\auto-footnote}:
1319 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1321 \header { tagline = ##f }
1322 \markup { \auto-footnote "A simple tune" \italic "By me" }
1330 @node Notas al pie manuales
1331 @unnumberedsubsubsec Notas al pie manuales
1332 @translationof Manual footnotes
1334 @cindex notas al pie manuales
1336 Las notas al pie marcadas manualmente toman un primer argumento
1337 adicional de marcado, @var{marca} para construir la marca de
1338 referencia. A diferencia de las marcas de notas al pie generadas
1339 automáticamente, no aparecen antes del elemento de marcado @var{nota}
1340 en la parte inferior de la página: el establecimiento de la conexión
1341 visual se deja para el usuario. LilyPond sólo asegura que el marcado
1342 correspondiente aparece en la parte inferior de la misma página.
1344 Aparte de esto, su uso es idéntico al de las notas al pie numeradas
1347 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1349 \header { tagline = ##f }
1353 \markup { \italic "1. The first note" }
1357 \markup { \bold "2" } #'(0.5 . 1)
1358 "2. The second note"
1361 d-\footnote "3" #'(0.5 . -1) "3. Piano" \p
1366 Para anotar notas de acordes con notas al pie manuales:
1368 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1370 \header { tagline = ##f }
1373 \footnote "1" #'(1 . -1.25) "1. C" c
1375 \markup { \bold "b" } #'(2 . -0.25) "b. E-flat" es
1376 \footnote "3" #'(2 . 3) \markup { \italic "iii. G" } g
1382 @warning {Cuando las notas al pie tienen la misma posición vertical, las
1383 anotaciones se imprimen en orden de descendencia; cuanto más alta es
1384 la nota al pie, más arriba está en la lista.}
1386 He aquí algunos ejemplos de grobs anotados manualmente, mostrando
1387 también la posición relativa de las notas al pie respecto a la línea
1388 informativa a la de copyright:
1390 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1392 \header { tagline = ##f }
1395 \markup { \teeny 1 } #'(-3 . 0)
1396 \markup { 1. \bold Forte } \f
1398 \markup { \teeny b } #'(0 . 1.5)
1399 \markup { b. A slur } (
1401 \markup { \teeny 3 } #'(0 . -2)
1402 \markup { 3. Beam } [
1405 \markup { 4 } #'(1 . -1) #'Stem
1406 \markup { \bold 4. { This is a stem } }
1409 \markup \concat \teeny { "sharp (v)" }
1410 #'(0 . 0.5) #'AccidentalCautionary
1411 \markup \italic { v. A cautionary accidental }
1413 \markup \concat \teeny { "a" } #'(0.5 . -0.5)
1414 \markup \italic { a. Slow Down } _"rit."
1416 \markup { \teeny \musicglyph #"rests.4" }
1418 \markup { \null } \breathe
1423 Para anotar manualmente un elemento @code{\markup} del nivel superior:
1425 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1427 \header { tagline = ##f }
1428 \markup { "A simple tune" \footnote "*" \italic "* By me" }
1436 Manual de aprendizaje:
1437 @rlearning{Objetos e interfaces}.
1439 Referencia de la notación:
1440 @ref{Globos de ayuda},
1441 @ref{Disposición de la página},
1442 @ref{Indicaciones de texto},
1443 @ref{Guiones de texto},
1444 @ref{Títulos y cabeceras}.
1446 Referencia de funcionamiento interno:
1447 @rinternals{FootnoteEvent},
1448 @rinternals{FootnoteItem},
1449 @rinternals{FootnoteSpanner},
1450 @rinternals{Footnote_engraver}.
1453 Varias notas al pie en la misma página solo pueden ir apiladas unas
1454 sobre otras, y no se pueden imprimir en la misma línea. Las notas al
1455 pie no se pueden adjuntar a elementos de silencio multicompás
1456 @code{MultiMeasureRests}, y pueden colisionar con el objeto
1457 @code{Staff}, objetos de @code{\markup} y otras anotaciones
1458 @code{footnote}. Cuando use una cualquiera de las instrucciones
1459 @code{footnote} se requiere un bloque @code{\paper} que contenga
1460 @code{footnote-auto-number = ##f}.
1463 @node Referencia a números de página
1464 @subsection Referencia a números de página
1465 @translationof Reference to page numbers
1467 Un lugar determinado de una partitura puede señalizarse usando la
1468 instrucción @code{\label} (etiqueta), ya sea en el nivel superior o
1469 dentro de la música. Podemos referirnos a esta etiqueta más tarde
1470 dentro de un elemento de marcado, para obtener el número de la página
1471 en la que se sitúa el punto señalizado, usando la instrucción de
1472 marcado @code{\page-ref}.
1474 @lilypond[verbatim,papersize=a8landscape]
1475 \header { tagline = ##f }
1481 \pageBreak \mark A \label #'markA
1485 \markup { The first score begins on page \page-ref #'firstScore "0" "?" }
1486 \markup { Mark A is on page \page-ref #'markA "0" "?" }
1490 La instrucción de marcado @code{\page-ref} toma tres argumentos:
1492 @item la etiqueta, un símbolo de scheme, p.ej. @code{#'firstScore};
1493 @item un elemento de marcado que se usará como medidor para estimar las dimensiones del marcado;
1494 @item un elemento de marcado que se utilizará en sustitución del número de página si la etiqueta es desconocida.
1497 El motivo de que se necesite un medidor es que en el momento en que se
1498 están interpretando los marcados, los saltos de página aún no se han
1499 producido y por tanto los números de página no se conocen todavía.
1500 Para sortear este inconveniente, la interpretación real del marcado se
1501 retrasa hasta un momento posterior; sin embargo, las dimensiones del
1502 marcado se tienen que conocer de antemano, así que se usa el medidor
1503 para decidir estas dimensiones. Si el libro tiene entre 10 y 99
1504 páginas, el medidor puede ser "00", es decir, un número de dos
1515 @node Índice general
1516 @subsection Índice general
1517 @translationof Table of contents
1519 Se puede insertar un índice general o tabla de contenidos utilizando
1520 la instrucción @code{\markuplist \table-of-contents}. Los elementos
1521 que deben aparecer en la tabla de contenidos se introducen con la
1522 instrucción @code{\tocItem}, que se puede usar en el nivel más alto de
1523 la jerarquía del código, o dentro de una expresión musical.
1526 \markuplist \table-of-contents
1529 \tocItem \markup "Primera partitura"
1533 \tocItem \markup "Un punto concreto dentro de la primera partitura"
1538 \tocItem \markup "Segunda partitura"
1546 Los elementos de marcado que se usan para dar formato al índice
1547 general se encuentran definidos dentro del bloque @code{\paper}. Los
1548 elementos predeterminados son @code{tocTitleMarkup}, para dar formato
1549 al título de la tabla, y @code{tocItemMarkup}, para aplicar formato a
1550 los elementos del índice, que consisten en el título del elemento y el
1551 número de página. Estas variables se pueden cambiar por parte del
1556 %% Traducir el título del índice al español:
1557 tocTitleMarkup = \markup \huge \column {
1558 \fill-line { \null "Índice general" \null }
1561 %% usar una fuente mayor
1562 tocItemMarkup = \markup \large \fill-line {
1563 \fromproperty #'toc:text \fromproperty #'toc:page
1568 Observe la forma en que nos referimos al texto y al número de página
1569 del elemento de índice, dentro de la definición @code{tocItemMarkup}.
1571 También se pueden definir nuevas instrucciones y elementos de
1572 marcado para crear índices generales más elaborados:
1574 @item en primer lugar, defina una variable de marcado nueva dentro del bloque @code{\paper}
1575 @item luego defina una función de música cuyo propósito es añadir un elemento al índice general
1576 utilizando esta variable de marcado del bloque @code{\paper}.
1579 En el ejemplo siguiente se define un estilo nuevo para introducir los
1580 nombres de los actos de una ópera en el índice general:
1584 tocActMarkup = \markup \large \column {
1586 \fill-line { \null \italic \fromproperty #'toc:text \null }
1592 #(define-music-function (parser location text) (markup?)
1593 (add-toc-item! 'tocActMarkup text))
1596 @lilypond[line-width=10.0\cm]
1597 \header { tagline = ##f }
1599 tocActMarkup = \markup \large \column {
1601 \fill-line { \null \italic \fromproperty #'toc:text \null }
1607 #(define-music-function (parser location text) (markup?)
1608 (add-toc-item! 'tocActMarkup text))
1611 \markuplist \table-of-contents
1612 \tocAct \markup { Atto Primo }
1613 \tocItem \markup { Coro. Viva il nostro Alcide }
1614 \tocItem \markup { Cesare. Presti omai l'Egizzia terra }
1615 \tocAct \markup { Atto Secondo }
1616 \tocItem \markup { Sinfonia }
1617 \tocItem \markup { Cleopatra. V'adoro, pupille, saette d'Amore }
1622 Se pueden añadir puntos de relleno entre un elemento y su número de página:
1624 @lilypond[verbatim,line-width=10.0\cm]
1625 \header { tagline = ##f }
1627 tocItemMarkup = \tocItemWithDotsMarkup
1631 \markuplist \table-of-contents
1632 \tocItem \markup { Allegro }
1633 \tocItem \markup { Largo }
1640 @file{ly/toc-init.ly}.
1643 @funindex \table-of-contents
1644 @code{\table-of-contents},
1650 @node Trabajar sobre los archivos de entrada
1651 @section Trabajar sobre los archivos de entrada
1652 @translationof Working with input files
1655 * Inclusión de archivos de LilyPond::
1656 * Distintas ediciones a partir de una misma fuente::
1657 * Caracteres especiales::
1661 @node Inclusión de archivos de LilyPond
1662 @subsection Inclusión de archivos de LilyPond
1663 @translationof Including LilyPond files
1666 @cindex including files
1668 Un proyecto grande se puede dividir en varios archivos. Para
1669 referirse a otro archivo, utilice
1672 \include "otroarchivo.ly"
1675 La línea @code{\include "otroarchivo.ly"} equivale a pegar todo el
1676 contenido de @file{otroarchivo.ly} en el archivo actual en el lugar en
1677 que aparece el @code{\include}. Por ejemplo, en un proyecto grande
1678 podríamos querer archivos distintos para cada parte instrumental y
1679 crear un archivo de @qq{partitura completa} que reúne los archivos
1680 individuales de los instrumentos. Normalmente el archivo incluido
1681 define un cierto número de variables que a partir de entonces quedan
1682 disponibles para poderlas utilizar en el archivo de la partitura
1683 completa. En los archivos incluidos se pueden marcar las secciones
1684 etiquetadas para ayudar a hacerlas utilizables en distintos lugares de
1685 la partitura, véase @ref{Distintas ediciones a partir de una misma fuente}.
1687 Los archivos que están en el directorio de trabajo actual se pueden
1688 referenciar simplemente especificando el nombre después de la
1689 instrucción @code{\include}. Los archivos en otros lugares se pueden
1690 incluir proporcionando una referencia de ruta completa o una ruta
1691 relativa (pero utilice la barra inclinada normal del UNIX, /, no la
1692 barra invertida de DOS/Windows, \, como separador de directorio). Por
1693 ejemplo, si @file{material.ly} está situado un directorio por encima
1694 del directorio de trabajo actual, utilice
1697 \include "../material.ly"
1701 o si los archivos de las partes orquestales incluidas están todos
1702 situados en un subdirectorio llamado @file{partes} dentro del
1703 directorio actual, use
1706 \include "partes/VI.ly"
1707 \include "partes/VII.ly"
1711 Los archivos de inclusión también pueden contener enunciados
1712 @code{\include} a su vez. De forma predeterminada, estos enunciados
1713 @code{\include} de segundo nivel no se interpretan hasta que se
1714 incorporan al archivo principal, por lo que los nombres de archivo que
1715 especifican deben ser relativos al directorio que contiene el archivo
1716 principal, no al directorio que contiene el archivo incluido. Sin
1717 embargo, este comportamiento se puede modificar pasando la opción
1718 @option{-drelative-includes} en la línea de órdenes (o mediante la
1719 adición de @code{#(ly:set-option 'relative-includes #t)} al principio
1720 del archivo principal de entrada). Con el valor de
1721 @code{relative-includes} establecido, la ruta de cada instrucción
1722 @code{\include} se considera relativa al archivo que contiene dicha
1723 instrucción. Este comportamiento es el recomendado y se convertirá en
1724 el comportamiento predeterminado en una versión futura de lilypond.
1726 También se pueden incluir archivos de un directorio que está en una
1727 ruta de búsqueda especificada como opción al invocar a LilyPond desde
1728 la línea de órdenes. Los archivos incluidos se especifican usando
1729 solamente su nombre de archivo. Por ejemplo, para compilar mediante
1730 este método un archivo @file{principal.ly} que incluye archivos
1731 situados en un subdirectorio llamado @file{partes}, cambie al
1732 directorio que contiene @file{principal.ly} e introduzca
1735 lilypond --include=partes principal.ly
1738 y en @file{principal.ly} escriba
1746 Los archivos que se incluyen en muchas partituras se pueden poner en
1747 el directorio de LilyPond @file{../ly} (la localización de este
1748 directorio depende de la instalación: véase
1749 @rlearning{Otras fuentes de información}). Estos archivos se pueden
1750 incluir sencillamente por su nombre en un enunciado @code{\include}.
1751 De esta forma se incluyen los archivos dependientes del idioma como
1754 LilyPond incluye de forma predeterminada ciertos archivos cuando se
1755 inicia el programa. Estas inclusiones no son visibles para el
1756 usuario, pero los archivos se pueden identificar ejecutando
1757 @code{lilypond --verbose} desde la línea de órdenes. Esto presentará
1758 una lista de rutas y archivos que utiliza LilyPond, junto a muchas
1759 otras indicaciones. De forma alternativa, pueden verse explicaciones
1760 sobre los archivos más importantes de este conjunto en
1761 @rlearning{Otras fuentes de información}. Estos archivos se pueden
1762 editar, pero los cambios realizados sobre ellos se perderán al
1763 instalar una nueva versión de LilyPond.
1765 Pueden verse ejemplos sencillos sobre el uso de @code{\include} en
1766 @rlearning{Partituras y particellas}.
1769 Manual de aprendizaje:
1770 @rlearning{Otras fuentes de información},
1771 @rlearning{Partituras y particellas}.
1774 Si un archivo incluido recibe un nombre igual al de uno de los
1775 archivos de instalación de LilyPond, el archivo que tiene prioridad es
1776 el de los archivos de instalación de LilyPond.
1779 @node Distintas ediciones a partir de una misma fuente
1780 @subsection Distintas ediciones a partir de una misma fuente
1781 @translationof Different editions from one source
1783 Se pueden usar varios métodos para generar la producción de distintas
1784 versiones de una partitura a partir de la misma fuente musical. Las
1785 variables son quizá el más útil para combinar secciones extensas de
1786 música y/o anotaciones. Las etiquetas son más útiles para seleccionar
1787 una sección de entre varias secciones de música alternativas, más
1788 cortas, y se pueden usar también para dividir piezas de música en
1791 Cualquiera que sea el método utilizado, la separación de la notación
1792 de la estructura de la partitura hará que sea más fácil cambiar la
1793 estructura dejando intacta la notación.
1796 * Uso de las variables::
1797 * Uso de etiquetas::
1798 * Uso de ajustes globales::
1801 @node Uso de las variables
1802 @unnumberedsubsubsec Uso de las variables
1803 @translationof Using variables
1805 @cindex variables, uso de las
1807 Si las secciones de la música se definen dentro de variables, se
1808 pueden reutilizar en distintas partes de la partitura, véase
1809 @rlearning{Organizar las piezas mediante variables}. Por ejemplo, una
1810 partitura vocal @notation{a cappella} con frecuencia incluye una
1811 reducción de piano de las partes para ensayar que es idéntica a la
1812 música vocal, por lo que ésta sólo se tiene que escribir una vez. Se
1813 puede combinar sobre un solo pentagrama la música de dos variables,
1814 véase @ref{Combinación automática de las partes}. He aquí un ejemplo:
1816 @lilypond[verbatim,quote]
1817 sopranoMusic = \relative c'' { a4 b c b8( a) }
1818 altoMusic = \relative g' { e4 e e f }
1819 tenorMusic = \relative c' { c4 b e d8( c) }
1820 bassMusic = \relative c' { a4 gis a d, }
1821 allLyrics = \lyricmode {King of glo -- ry }
1823 \new Staff = "Soprano" \sopranoMusic
1824 \new Lyrics \allLyrics
1825 \new Staff = "Alto" \altoMusic
1826 \new Lyrics \allLyrics
1827 \new Staff = "Tenor" {
1831 \new Lyrics \allLyrics
1832 \new Staff = "Bass" {
1836 \new Lyrics \allLyrics
1839 \set Staff.printPartCombineTexts = ##f
1845 \set Staff.printPartCombineTexts = ##f
1855 Se pueden producir partituras distintas que presenten sólo las partes
1856 vocales o sólo la parte de piano, cambiando solamente los enunciados
1857 estructurales, sin modificar la notación musical.
1859 Para partituras extensas, las definiciones de variable se pueden poner
1860 en archivos separados que se incluyen más tarde, véase @ref{Inclusión de archivos de LilyPond}.
1863 @node Uso de etiquetas
1864 @unnumberedsubsubsec Uso de etiquetas
1865 @translationof Using tags
1868 @funindex \keepWithTag
1869 @funindex \removeWithTag
1870 @funindex \pushToTag
1871 @funindex \appendToTag
1873 @cindex mantener música etiquetada
1874 @cindex quitar música etiquetada
1875 @cindex división en música etiquetada
1877 La instrucción @code{\tag #'@var{parteA}} marca una expresión musical
1878 con el nombre @var{parteA}. Las expresiones etiquetadas de esta
1879 manera se pueden seleccionar o filtrar más tarde por su nombre, usando
1880 bien @code{\keepWithTag #'@var{nombre}} o bien @code{\removeWithTag
1881 #'@var{nombre}}. El resultado de la aplicación de estos filtros a la
1882 música etiquetada es como sigue:
1884 @multitable @columnfractions .5 .5
1888 Música etiquetada precedida de @code{\keepWithTag #'@var{nombre}}
1890 Se incluye la música no etiquetada y la música etiquetada con
1891 @var{nombre}; se excluye la música etiquetada con cualquier otro
1894 Música etiquetada precedida de @code{\removeWithTag #'@var{nombre}}
1896 Se incluye la música no etiquetada y la música etiquetada con
1897 cualquier nombre de etiqueta distinto a @var{nombre}; se excluye la
1898 música etiquetada con @var{nombre}.
1900 Música etiquetada no precedida de @code{\keepWithTag} ni de
1901 @code{\removeWithTag}
1902 @tab Se incluye toda la música etiquetada y no etiquetada.
1905 Los argumentos de las instrucciones @code{\tag}, @code{\keepWithTag} y
1906 @code{\removeWithTag} deben ser un símbolo (como @code{#'partitura} o
1907 @code{#'parte}), seguido de una expresión musical.
1909 En el ejemplo siguiente vemos dos versiones de una pieza musical, una
1910 que muestra trinos con la notación usual y otra con los trinos
1911 expandidos explícitamente:
1913 @lilypond[verbatim,quote]
1914 music = \relative g' {
1916 \tag #'trills { d8.\trill }
1917 \tag #'expand { \repeat unfold 3 { e32 d } }
1922 \keepWithTag #'trills \music
1925 \keepWithTag #'expand \music
1930 De forma alternativa, a veces es más fácil excluir secciones de música:
1932 @lilypond[verbatim,quote]
1933 music = \relative g' {
1935 \tag #'trills { d8.\trill }
1936 \tag #'expand {\repeat unfold 3 { e32 d } }
1941 \removeWithTag #'expand
1945 \removeWithTag #'trills
1950 El filtrado con etiquetas se puede aplicar a articulaciones, textos,
1954 -\tag #'@var{mi-etiqueta}
1957 a una articulación. Por ejemplo, esto define una nota con una
1958 indicación opcional de digitación y una nota con una anotación
1963 c1-\tag #'warn ^"¡Ojo!"
1966 Se pueden poner varias etiquetas sobre expresiones con varias entradas
1969 @lilypond[quote,verbatim]
1970 music = \relative c'' {
1971 \tag #'a \tag #'both { a4 a a a }
1972 \tag #'b \tag #'both { b4 b b b }
1975 \keepWithTag #'a \music
1976 \keepWithTag #'b \music
1977 \keepWithTag #'both \music
1981 Se pueden aplicar varios filtros @code{\removeWithTag} a una sola
1982 expresión musical para quitar varias secciones etiquetadas con nombres
1985 @lilypond[verbatim,quote]
1986 music = \relative c'' {
1987 \tag #'A { a4 a a a }
1988 \tag #'B { b4 b b b }
1989 \tag #'C { c4 c c c }
1990 \tag #'D { d4 d d d }
1999 Dos o más filtros @code{\keepWithTag} aplicados a una sola expresión
2000 musical producen la eliminación de @emph{todas} las secciones
2001 etiquetadas, porque el primer filtro quita todas las secciones
2002 etiquetadas excepto la que se nombra, y el segundo filtro elimina
2003 incluso esa sección etiquetada.
2005 A vecespodemos desear dividir la música en un determinado lugar dentro
2006 de una expresión musical existente. Podemos usar @code{\pushToTag} y
2007 @code{\appendToTag} para añadir material delante o al final de los
2008 @code{elements} de una construcción musical existente. No toda
2009 construcción musical tiene la parte @code{elements}, pero las músicas
2010 secuenciaes y simultáneas son dos apuestas seguras:
2012 @lilypond[verbatim,quote]
2013 test = { \tag #'here { \tag #'here <<c''>> } }
2016 \pushToTag #'here c'
2017 \pushToTag #'here e'
2018 \pushToTag #'here g' \test
2019 \appendToTag #'here c'
2020 \appendToTag #'here e'
2021 \appendToTag #'here g' \test
2025 Las dos instrucciones admiten una etiqueta, el material que dividir en
2026 cada ocurrencia de la etiqueta, y la expresión etiquetada. Las
2027 instrucciones aseguran que se copia todo lo que cambian, de forma que
2028 el código original @code{\test} retiene su significado.
2031 Manual de aprendizaje:
2032 @rlearning{Organizar las piezas mediante variables}.
2034 Referencia de la notación:
2035 @ref{Combinación automática de las partes},
2036 @ref{Inclusión de archivos de LilyPond}.
2039 @c This warning is more general than this placement implies.
2040 @c Rests are not merged whether or not they come from tagged sections.
2041 @c Should be deleted? -td
2044 Multiple rests are not merged if you create a score with more
2045 than one tagged section at the same place.
2049 @node Uso de ajustes globales
2050 @unnumberedsubsubsec Uso de ajustes globales
2051 @translationof Using global settings
2053 @cindex include-settings
2055 Se pueden incluir ajustes globales a partir de un archivo distinto:
2058 lilypond -dinclude-settings=MIS_AJUSTES.ly MI_PARTITURA.ly
2061 En archivos diferentes se pueden almacenar grupos de ajustes como
2062 el tamaño de la página o las fuentes tipográficas. Ello permite
2063 hacer diferentes ediciones de la mism a partitura así como aplicar
2064 ajustes estándar a muchas partituras, simplemente por medio de la
2065 especificación del archivo de ajustes adecuado.
2067 Esta técnica también funciona bien con el uso de hojas de estilo,
2068 como se estudia en @rlearning{Hojas de estilo}.
2071 Manual de aprendizaje:
2072 @rlearning{Organizar las piezas mediante variables},
2073 @rlearning{Hojas de estilo}.
2075 Referencia de la notación:
2076 @ref{Inclusión de archivos de LilyPond}.
2079 @node Caracteres especiales
2080 @subsection Caracteres especiales
2081 @translationof Special characters
2083 @cindex caracteres especiales
2084 @cindex caracteres no ASCII
2087 * Codificación del texto::
2093 @node Codificación del texto
2094 @unnumberedsubsubsec Codificación del texto
2095 @translationof Text encoding
2099 LilyPond usa el conjunto de caracteres definido por el consorcio
2100 Unicode y la norma ISO/IEC 10646. Define un nombre único y un código
2101 para los conjuntos de caracteres que se utilizan en prácticamente
2102 todos los idiomas modernos y también en muchos otros. Unicode se
2103 puede implementar utilizando varios esquemas de codificación
2104 distintos. LilyPond usa la codificación UTF-8 (UTF son las siglas de
2105 @emph{Unicode Transformation Format}, o formato de transformación de
2106 Unicode) que representa todos los caracteres comunes de Latin en un
2107 solo byte, y representa otros caracteres usando un formato de longitud
2108 variable de hasta cuatro bytes.
2110 El aspecto visual real de los caracteres viene determinado por los
2111 glifos que se definen en las fuentes tipográficas concretas que se
2112 tengan disponibles: una fuente tipográfica define la asignación de un
2113 subconjunto de los códigos de Unicode a glifos. LilyPond usa la
2114 biblioteca Pango para representar y disponer tipográficamente textos
2117 LilyPond no realiza ninguna conversión en la codificación de la
2118 entrada. Esto significa que cualquier text, ya sea el título, la
2119 letra de la canción o una instrucción musical que contenga caracteres
2120 distintos a los del conjunto ASCII, se deben codificar en UTF-8. La
2121 forma más fácil de escribir dicho texto es utilizar un editor
2122 preparado para Unicode y guardar el archivo con la codificación UTF-8.
2123 Casi todos los editores modernos populares contemplan el UTF-8, por
2124 ejemplo lo hacen vim, Emacs, jEdit, y GEdit. Todos los sistemas MS
2125 Windows posteriores a NT usan Unicode como codificación de caracteres
2126 nativa, de manera que incluso el accesorio Bloc de Notas (Notepad)
2127 puede editar y guardar un archivo en el formato UTF-8. Una
2128 alternativa más funcional para Windows es BabelPad.
2130 Si un archivo de entrada que contiene un carácter que no es ASCII, no
2131 se guarda en el formato UTF-8, se genera el mensaje de error
2134 FT_Get_Glyph_Name () error: argumento inválido
2137 He aquí un ejemplo que muestra texto cirílico, hebreo y portugués:
2140 %c No verbatim here as the code does not display correctly in PDF
2142 bulgarian = \lyricmode {
2143 Жълтата дюля беше щастлива, че пухът, който цъфна, замръзна като гьон.
2147 hebrew = \lyricmode {
2148 זה כיף סתם לשמוע איך תנצח קרפד עץ טוב בגן.
2152 portuguese = \lyricmode {
2153 à vo -- cê uma can -- ção legal
2159 \addlyrics { \bulgarian }
2160 \addlyrics { \hebrew }
2161 \addlyrics { \portuguese }
2166 @unnumberedsubsubsec Unicode
2170 Para introducir un carácter aislado para el que se conoce el punto de
2171 código Unicode pero no está disponible en el editor que se está
2172 usando, use @code{\char ##xhhhh} o bien @code{\char #dddd} dentro de
2173 un bloque @code{\markup}, donde @code{hhhh} es el código hexadecimal
2174 del carácter en cuestión y @code{dddd} es su valor decimal
2175 correspondiente. Pueden omitirse los ceros iniciales, pero es
2176 costumbre indicar los cuatro caracteres en la representación
2177 hexadecimal (observe que @emph{no} debe utilizarse la codificación
2178 UTF-8 del punto de código Unicode después de @code{\char}, pues la
2179 codificación UTF-8 contiene bits adicionales que indican el número de
2180 octetos). Hay tablas de códigos Unicode y un índice de nombres de
2181 caracteres que da el punto de código en hexadecimal para cualquier
2182 carácter en el portal del Consorcio Unicode,
2183 @uref{http://www.unicode.org/}.
2185 Por ejemplo, tanto @code{\char ##x03BE} como @code{\char #958}
2186 insertan el carácter Unicode U+03BE, que tiene el nombre Unicode
2187 @qq{Letra griega Xi pequeña}.
2189 Se puede escribir de esta forma cualquier punto de código Unicode, y
2190 si todos los caracteres especiales se escriben en este formato no es
2191 necesario guardar el archivo de entrada en formato UTF-8. Por
2192 supuesto, debe estar instalada y estar disponible para LilyPond una
2193 fuente tipográfica que contenga codificados todos estos caracteres.
2195 El ejemplo siguiente muestra valores hexadecimales Unicode que se usan
2196 en cuatro lugares: en una llamada de ensayo, como texto de
2197 articulación, en la letra y como texto independiente bajo la
2200 @lilypond[quote,verbatim]
2203 c1 \mark \markup { \char ##x03EE }
2204 c1_\markup { \tiny { \char ##x03B1 " to " \char ##x03C9 } }
2206 \addlyrics { O \markup { \concat { Ph \char ##x0153 be! } } }
2208 \markup { "Copyright 2008--2012" \char ##x00A9 }
2211 @cindex copyright, símbolo de
2213 Para escribir el símbolo de copyright en la nota de créditos, utilice:
2217 copyright = \markup @{ \char ##x00A9 "2008" @}
2222 @node Alias de ASCII
2223 @unnumberedsubsubsec Alias de ASCII
2224 @translationof ASCII aliases
2226 Se puede incluir una lista de alias de ASCII para caracteres
2229 @lilypond[quote,verbatim]
2231 #(include-special-characters)
2234 \markup "&flqq; – &OE;uvre incomplète… &frqq;"
2237 \new Staff { \repeat unfold 9 a'4 }
2239 This is al -- so wor -- kin'~in ly -- rics: –_&OE;…
2244 "The replacement can be disabled:"
2245 "– &OE; …"
2246 \override #'(replacement-alist . ()) "– &OE; …"
2250 También podemos hacer nuestros propios alias, ya sea de forma global:
2252 @lilypond[quote,verbatim]
2254 #(add-text-replacements!
2255 '(("100" . "hundred")
2256 ("dpi" . "dots per inch")))
2258 \markup "A 100 dpi."
2263 @lilypond[quote,verbatim]
2264 \markup \replace #'(("100" . "hundred")
2265 ("dpi" . "dots per inch")) "A 100 dpi."
2269 Referencia de la notación:
2270 @ref{Lista de caracteres especiales}.
2272 Archivos instalados:
2273 @file{ly/text-replacements.ly}.
2276 @node Controlar la salida
2277 @section Controlar la salida
2278 @translationof Controlling output
2281 * Extracción de fragmentos de música::
2282 * Saltar la música corregida::
2283 * Formatos de salida alternativos::
2284 * Sustituir la tipografía de la notación::
2288 @node Extracción de fragmentos de música
2289 @subsection Extracción de fragmentos de música
2290 @translationof Extracting fragments of music
2292 Es posible citar pequeños fragmentos de una partitura grande
2293 directamente a partir de la salida. Puede compararse con la
2294 separación de una pieza de una partitura, recortándola con tijeras.
2296 Esto se hace definiendo los compases que se deben recortar. Por
2297 ejemplo, la inclusión de la siguiente definición
2304 (make-rhythmic-location 5 1 2)
2305 (make-rhythmic-location 7 3 4)))
2310 extrae un fragmento empezando por la mitad del quinto compás y
2311 finalizando en el séptimo compás. El significado de @code{5 1 2} es:
2312 después de una blanca (1/2) en el compás 5, y el de @code{7 3 4}
2313 después de tres negras del compás 7.
2315 Se pueden definir más zonas de recorte añadiendo más parejas de
2316 definición de tiempo rhythmic-location a la lista.
2318 Para poder utilizar esta funcionalidad, LilyPond se debe invocar con
2319 la opción @option{-dclip-systems}. Los recortes aparecen en la salida
2320 como archivos EPS, y se convierten en PDF y PNG si estos formatos
2321 también están activados.
2323 Para ver más información sobre los formatos de salida, consulte
2324 @rprogram{Invocar a LilyPond}.
2327 @node Saltar la música corregida
2328 @subsection Saltar la música corregida
2329 @translationof Skipping corrected music
2331 @funindex skipTypesetting
2332 @funindex showFirstLength
2333 @funindex showLastLength
2335 Al escribir o copiar música, normalmente sólo es interesante de ver y
2336 corregir la música cercana al final (donde estamos añadiendo las
2337 notas). Para acelerar este proceso de corrección, es posible saltar
2338 la composición tipográfica de todos excepto unos pocos de los últimos
2339 compases. Esto se consigue poniendo
2342 showLastLength = R1*5
2347 en nuestro archivo fuente. Esto hará que se tracen sólo los últimos
2348 cinco compases (suponiendo un compás de 4/4) de cada una de las
2349 partituras @code{\score} del archivo de entrada. Para piezas largas,
2350 el tipografiado de únicamente una parte pequeña es con frecuencia un
2351 orden de magnitud más rápido que el de la obra completa. Si estamos
2352 trabajando sobre el principio de una partitura que ya hemos
2353 tipografiado (p.ej., para añadir una parte instrumental nueva),
2354 también puede ser útil la propiedad @code{showFirstLength}.
2356 Este mecanismo de pasar por alto partes de un partitura se puede
2357 controlar con un grano más fino mediante la propiedad
2358 @code{Score.skipTypesetting}. Cuando su valor está establecido, no se
2359 lleva a cabo ningún tipografiado en absoluto.
2361 Esta propiedad se usa también para controlar la salida al archivo
2362 MIDI. Observe que pasa por alto todos los eventos, incluidos el tempo
2363 y los cambios de instrumento. Está usted advertido.
2365 @lilypond[quote,relative=2,ragged-right,verbatim]
2367 \set Score.skipTypesetting = ##t
2369 \set Score.skipTypesetting = ##f
2373 En música polifónica, @code{Score.skipTypesetting} afecta a todas las
2374 voces y pentagramas, ahorrando más tiempo incluso.
2377 @node Formatos de salida alternativos
2378 @subsection Formatos de salida alternativos
2379 @translationof Alternative output formats
2381 @cindex salida de gráficos de vector escalables
2383 @cindex salida de PostScript encapsulado
2385 @cindex PostScript encapsulado, salida de
2387 Los formatos de salida predeterminados para la partitura impresa son
2388 el formato de documento portátil (PDF) y PostScript (PS). Los
2389 formatos de salida Gráficos de vector escalables (SVG), PostScript
2390 encapsulado (EPS) y Gráficos de red portátiles (PNG) también están
2391 disponibles a través de opciones de la línea de órdenes, véase
2392 @rprogram{Opciones básicas de la línea de órdenes para LilyPond}.
2395 @node Sustituir la tipografía de la notación
2396 @subsection Sustituir la tipografía de la notación
2397 @translationof Replacing the notation font
2399 Gonville es una alternativa a la tipografía Feta que se utiliza en
2400 LilyPond y se puede descargar de:
2402 @uref{http://www.chiark.greenend.org.uk/~sgtatham/gonville/ ,http://www.chiark.greenend.org.uk/~sgtatham/gonville/}
2405 Aquí presentamos algunos compases de muestra tipografiados con la
2408 @c NOTE: these images are a bit big, but that's important
2409 @c for the font comparison. -gp
2410 @sourceimage{Gonville_after,,,}
2412 Aquí hay unos compases de muestra tipografiados en la fuente Feta de
2415 @sourceimage{Gonville_before,,,}
2417 @subsubheading Instrucciones de instalación para MacOS
2419 Descargue y extraiga el archivo zip. Copie la carpeta @code{lilyfonts}
2420 a @file{@var{SHARE_DIR}/lilypond/current}; para más información,
2421 consulte @rlearning{Otras fuentes de información}. Renombre la carpeta
2422 @code{fonts} existente a @code{fonts_orig} y la carpeta
2423 @code{lilyfonts} a @code{fonts}. Para volver a la fuente Feta,
2424 invierta el proceso.
2427 Manual de aprendizaje:
2428 @rlearning{Otras fuentes de información}.
2432 Gonville no se puede usar para tipografiar notación de @q{Música
2433 Antigua} y es probable que cualquier nuevo glifo en versiones
2434 posteriores de LilyPond no existan en la familia
2435 tipográfica Gonville. Diríjase a la página web del autor para obtener más
2436 información sobre éste y otros asuntos, entre ellos el régimen de
2437 licencias de Gonville.
2441 @section Salida MIDI
2442 @translationof MIDI output
2447 El MIDI (Musical Instrument Digital Interface, Interfase Digital para
2448 Instrumentos Musicales) es un estándar para interconectar y controlar
2449 instrumentos musicales electrónicos. Un archivo o secuencia MIDI es
2450 una serie de notas dentro de un conjunto de pistas. No es un archivo
2451 de sonidos reales; se necesita un programa reproductor especial para
2452 traducir la serie de notas en sonidos de verdad.
2454 Cualquier música se puede convertir a archivos MIDI, de manera que
2455 podamos escuchar lo que hayamos introducido. Esto es muy conveniente
2456 para comprobar la corrección de la música; las octavas equivocadas o
2457 las alteraciones erróneas se ponen de relieve muy claramente al
2458 escuchar la salida MIDI.
2460 La salida estándar de MIDI es un poco primitiva; de forma opcional, se
2461 encuentra disponible una salida MIDI mejorada y mucho más realista,
2462 por medio de @ref{El script Articulate}.
2464 La salida MIDI reserva un canal por cada pentagrama, y reserva
2465 el canal 10 para la percusión. Sólo hay 16 canales MIDI por cada
2466 dispositivo, por lo que si la partitura tiene más de 15 pautas, los
2467 canales MIDI se reutilizarán.
2470 * Crear archivos MIDI::
2472 * ¿Qué sale por el MIDI?::
2473 * Repeticiones y MIDI::
2474 * Control de los matices en el MIDI::
2475 * Percusión en MIDI::
2476 * El script Articulate::
2480 @node Crear archivos MIDI
2481 @subsection Crear archivos MIDI
2482 @translationof Creating MIDI files
2484 Para crear un MIDI a partir de una pieza de música, escriba un bloque
2485 @code{\midi} en la partitura, por ejemplo:
2494 Si hay un bloque @code{\midi} dentro de un @code{\score} que no tenga
2495 ningún bloque @code{\layout}, solamente se producirá MIDI. Si se
2496 necesita una notación impresa, debe haber también un bloque
2507 Se traducen correctamente a la salida MIDI la altura y duración de las
2508 notas, las ligaduras de unión, matices y cambios de tempo. Las
2509 indicaciones dinámicas, crescendi y decrescendi se traducen a niveles
2510 de volumen MIDI. Las marcas dinámicas se traducen a una fracción fija
2511 del rango de volumen MIDI disponible. Los crescendi y decrescendi
2512 hacen que el volumen varía linealmente entre sus dos extremos. El
2513 efecto de las indicaciones dinámicas sobre la salida MIDI se puede
2514 eliminar por completo, véase @ref{El bloque MIDI}.
2516 El tempo inicial y los cambios de tempo posteriores se pueden
2517 especificar utilizando la instrucción @code{\tempo} dentro de la
2518 propia notación musical. Se reflejan en cambios de tempo en la salida
2519 MIDI. Esta instrucción normalmente hace que se imprima la indicación
2520 metronómica, pero esto se puede eliminar, véase @ref{Indicaciones metronómicas}.
2521 Más abajo se describe una forma alternativa de especificar el tempo
2522 MIDI inicial o global, véase @ref{El bloque MIDI}.
2524 Debido a ciertas limitaciones de Windows, la extensión predeterminada
2525 para los archivos MIDI en Windows es @code{.mid}. Otros sistemas
2526 operativos utilizan la extensión @code{.midi}. Si prefiere una
2527 extensión diferente, inserte la siguiente línea en el nivel jerárquico
2528 superior del archivo de entrada, antes del inicio de cualquier bloque
2529 @code{\book}, @code{\bookpart} o @code{\score}:
2532 #(ly:set-option 'midi-extension "midi")
2535 La línea anterior establece la extensión predeterminada para los
2536 archivos MIDI a @code{.midi}.
2538 De forma alternativa, esta opción se puede también proporcionar en la
2542 lilypond … -dmidi-extension=midi archivoLily.ly
2546 @unnumberedsubsubsec Nombres de instrumentos
2548 @cindex instrumento, nombres de
2549 @funindex Staff.midiInstrument
2551 El nombre del instrumento MIDI se establece mediante la propiedad
2552 @code{Staff.midiInstrument}. El nombre del instrumento se debe elegir
2553 de entre los que están en la lista que aparece en @ref{Instrumentos MIDI}.
2557 \set Staff.midiInstrument = #"glockenspiel"
2563 \new Staff \with @{midiInstrument = #"cello"@} @{
2568 Si el instrumento elegido no coincide exactamente con uno de los
2569 instrumentos de la lista de instrumentos MIDI, se usará el instrumento
2570 Piano de Cola (@code{"acoustic grand"}).
2574 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
2575 {changing-midi-output-to-one-channel-per-voice.ly}
2579 @c In 2.11 the following no longer seems to be a problem -td
2581 Unterminated (de)crescendos will not render properly in the midi file,
2582 resulting in silent passages of music. The workaround is to explicitly
2583 terminate the (de)crescendo. For example,
2590 will not work properly but
2593 @{ a4\< b c d\!\f @}
2600 Los cambios del volumen MIDI sólo tienen lugar al principio de la
2601 nota, por lo que los crescendi y decrescendi no pueden afectar al
2602 volumen de una sola nota.
2604 No todos los reproductores de MIDI manejar adecuadamente los cambios de
2605 tempo de la salida MIDI. Entre los reproductores que se sabe que
2606 funcionan se encuentran el Reproductor de Medios de MS Windows y
2607 @uref{http://@/timidity@/.sourceforge@/.net/,timidity}.
2610 @node El bloque MIDI
2611 @subsection El bloque MIDI
2612 @translationof MIDI block
2616 Si se requiere una salida MIDI, debe aparecer un bloque @code{\midi}
2617 dentro de un bloque de partitura. Es análogo al bloque layout de
2618 diseño de página, pero algo más simple. Con frecuencia, el bloque
2619 @code{\midi} se deja vacío, pero puede contener reorganizaciones de
2620 contextos, definiciones de contexto nuevas o código para fijar valores
2621 de propiedades. Por ejemplo, en el ejemplo siguiente se establece el
2622 tempo inicial exportado al archivo MIDI sin hacer que se imprima una
2623 indicación de tempo:
2634 En este ejemplo, el tempo se establece a 72 pulsos de negra por
2635 minuto. @code{\tempo} is actually a music command for
2636 setting properties during the interpretation of music: in the
2637 context of output definitions like a @code{\midi} block, as a matter of
2638 courtesy those are reinterpreted as if they were context modifications.
2640 @cindex MIDI, definiciones de contexto
2642 Las definiciones de contexto siguen con precisión la misma sintaxis
2643 que la de un bloque @code{\layout}. Los módulos de traducción para el
2644 sonido reciben el nombre de ejecutantes. Los contextos para la salida
2645 MIDI se definen en @file{../ly/performer-init.ly}, véase
2646 @rlearning{Otras fuentes de información}. Por ejemplo, para eliminar
2647 el efecto de los matices de la salida MIDI, inserte las líneas
2648 siguientes en el bloque @code{\midi@{ @}}.
2655 \remove "Dynamic_performer"
2660 La salida MIDI se crea sólo cuando se incluye un bloque @code{\midi}
2661 dentro de un bloque de partitura definido con una instrucción
2666 @{ @dots{}notas@dots{} @}
2672 @node ¿Qué sale por el MIDI?
2673 @subsection ¿Qué sale por el MIDI?
2674 @translationof What goes into the MIDI output?
2676 @unnumberedsubsubsec Contemplado en el MIDI
2678 @cindex alturas en MIDI
2679 @cindex MIDI, alturas
2680 @cindex cuartos de tono en MIDI
2681 @cindex MIDI, cuartos de tono
2682 @cindex microtonos en MIDI
2683 @cindex MIDI, microtonos
2684 @cindex acordes, nombres de, en MIDI
2685 @cindex MIDI, nombres de
2686 @cindex duraciones en MIDI
2687 @cindex MIDI, duraciones
2688 @cindex Articlulate, scripts
2689 @cindex MIDI, articulaciones
2690 @cindex articulaciones en MIDI
2691 @cindex trinos en MIDI
2692 @cindex grupetos en MIDI
2693 @cindex rallentando en MIDI
2694 @cindex accelerando en MIDI
2697 Los siguientes elementos de notación se reflejan en la salida MIDI:
2701 @item Microtonos (véase @ref{Alteraciones accidentales}. La reproducción necesita un reproductor que contemple la curvatura de tono o @emph{pitch bend}.)
2702 @item Acordes escritos como nombres de acorde
2703 @item Ritmos escritos como duraciones de las notas, incluidos los grupos de valoración especial
2704 @item Trémolos escritos sin @q{@code{:}[@var{número}]}
2705 @item Ligaduras de unión
2706 @item Matices o indicaciones de dinámica
2707 @item Crescendi y decrescendi sobre varias notas
2708 @item Cambios de tempo insertados con una marca metronómica
2709 @item Letra de las canciones
2712 Utilizando @ref{El script Articulate}, a la lista anterior se añaden
2713 una serie de elementos:
2716 @item Articulaciones (ligaduras de expresión, picados, etc)
2717 @item Trinos, mordentes circulares
2718 @item Rallentando y accelerando
2722 @unnumberedsubsubsec No contemplado en el MIDI
2724 @c TODO index as above
2726 Los siguientes elementos de notación no tienen ningún efecto sobre la
2727 salida MIDI, a no ser que utilicemos @ref{El script Articulate}:
2730 @item Duraciones escritas como anotaciones, p.ej. el swing
2731 @item Cambios de tempo escritos como anotaciones sin marca de tempo
2732 @item Staccato y otras articulaciones y ornamentos
2733 @item Ligaduras de expresión y de fraseo
2734 @item Crescendi y decrescendi sobre una nota única
2735 @item Trémolos introducidos con @q{@code{:}[@var{número}]}
2737 @item Acordes microtonales
2741 @node Repeticiones y MIDI
2742 @subsection Repeticiones y MIDI
2743 @translationof Repeats in MIDI
2745 @cindex repeticiones, expandir
2746 @funindex \unfoldRepeats
2748 Con un poco de trucaje, se puede hacer que cualquier tipo de
2749 repetición esté presente en la salida MIDI. Esto se consigue mediante
2750 la aplicación de la función musical @code{\unfoldRepeats}. Esta
2751 función cambia todas las repeticiones a repeticiones desplegadas.
2753 @lilypond[quote,verbatim]
2755 \repeat tremolo 8 { c'32 e' }
2756 \repeat percent 2 { c''8 d'' }
2757 \repeat volta 2 { c'4 d' e' f' }
2766 En partituras con varias voces, el desplegado de las repeticiones en
2767 la salida MIDI solo se produce correctamente si @emph{todas y cada
2768 una} de las voces incluye las repeticiones de manera completa y
2771 Al crear un archivo de partitura que use @code{\unfoldRepeats} para el
2772 MIDI, es necesario hacer dos bloques @code{\score}: uno para el MIDI
2773 (con repeticiones desplegadas) y otro para la notación impresa (con
2774 repeticiones de volta --primera y segunda vez--, tremolo --trémolo--,
2775 y percent --repetición de compases--). Por ejemplo,
2783 \unfoldRepeats @var{..música..}
2789 @node Control de los matices en el MIDI
2790 @subsection Control de los matices en el MIDI
2791 @translationof Controlling MIDI dynamics
2793 La dinámica en el MIDI está implementada por medio del intérprete
2794 Dynamic_performer que reside de forma predeterminada dentro del
2795 contexto Voice. Es posible controlar el volumen MIDI general, el
2796 volumen relativo de los matices dinámicos y el volumen relativo de los
2797 distintos instrumentos.
2799 @unnumberedsubsubsec Indicaciones dinámicas
2801 Los matices o indicaciones de dinámica se traducen a una fracción fija
2802 del rango de volumen MIDI disponible. Las fracciones predeterminadas
2803 se extienden desde 0.25 para @notation{ppppp} hasta 0.95 para
2804 @notation{fffff}. El conjunto de indicaciones dinámicas y las
2805 fracciones asociadas pueden verse en @file{../scm/midi.scm}, véase
2806 @rlearning{Otras fuentes de información}. Este conjunto de fracciones
2807 se puede cambiar o extender proporcionando una función que toma como
2808 argumento una indicación dinámica y devuelve la fracción requerida, y
2809 estableciendo @code{Score.dynamicAbsoluteVolumeFunction} a esta
2812 Por ejemplo, si se requiere una indicación dinámica
2813 @notation{rinforzando}, @code{\rfz}, ésta no tiene ningún efecto
2814 predeterminado sobre el volumen MIDI, pues no está incluida en el
2815 conjunto predeterminado. De igual manera, si se define una indicación
2816 dinámica nueva con @code{make-dynamic-script}, ésta tampoco estará
2817 incluida en el conjunto predeterminado. El ejemplo siguiente muestra
2818 cómo hay que añadir el volumen MIDI para estas indicaciones dinámicas.
2819 La función Scheme establece la fracción a 0.9 si se encuentra una
2820 indicación dinámica rfz, y en caso contrario llama a la función
2823 @lilypond[verbatim,quote]
2824 #(define (myDynamics dynamic)
2825 (if (equal? dynamic "rfz")
2827 (default-dynamic-absolute-volume dynamic)))
2831 \set Staff.midiInstrument = #"cello"
2832 \set Score.dynamicAbsoluteVolumeFunction = #myDynamics
2844 Como alternativa, si se necesitara redefinir la tabla completa de
2845 fracciones, sería mejor usar el procedimiento
2846 @notation{default-dynamic-absolute-volume} que aparece en
2847 @file{../scm/midi.scm} y la tabla asociada como modelo. El último
2848 ejemplo de esta sección muestra cómo se puede hacer esto.
2850 @unnumberedsubsubsec Volumen maestro MIDI
2852 El volumen general máximo y mínimo de las indicaciones dinámicas de
2853 MIDI se controla estableciendo valores para las propiedades
2854 @code{midiMinimumVolume} y @code{midiMaximumVolume} en el nivel de
2855 @code{Score}. Estas propiedades tienen efecto solamente sobre las
2856 indicaciones dinámicas, por ello si queremos que tengan validez desde
2857 el comienzo de la partitura, se debe colocar allí una indicación de
2858 dinámica. La fracción que corresponde a cada indicación dinámica se
2859 modifica con esta fórmula:
2862 midiMinimumVolume + (midiMaximumVolume - midiMinimumVolume) * fracción
2865 En el ejemplo siguiente, el rango de intensidad dinámica del volumen
2866 general MIDI está limitado al intervalo desde 0.2 hasta 0.5.
2868 @lilypond[verbatim,quote]
2874 \set Staff.midiInstrument = #"flute"
2875 \new Voice \relative c''' {
2883 \set Staff.midiInstrument = #"clarinet"
2884 \new Voice \relative c'' {
2896 midiMinimumVolume = #0.2
2897 midiMaximumVolume = #0.5
2903 @unnumberedsubsubsec Balance entre instrumentos (i)
2905 Si las propiedades de volumen MIDI máximo y mínimo están establecidas
2906 en el contexto @code{Staff} se pueden controlar los volúmenes
2907 relativos de los instrumentos MIDI. Esto proporciona un ecualizador
2908 de instrumentos básico que puede realzar significativamente la calidad
2911 En este ejemplo se reduce el volumen del clarinete con relación al de
2912 la flauta. Debe haber una indicación dinámica en la primera nota de
2913 cada instrumento para que esto funcione correctamente.
2915 @lilypond[verbatim,quote]
2921 \set Staff.midiInstrument = #"flute"
2922 \set Staff.midiMinimumVolume = #0.7
2923 \set Staff.midiMaximumVolume = #0.9
2924 \new Voice \relative c''' {
2932 \set Staff.midiInstrument = #"clarinet"
2933 \set Staff.midiMinimumVolume = #0.3
2934 \set Staff.midiMaximumVolume = #0.6
2935 \new Voice \relative c'' {
2949 @unnumberedsubsubsec Balance entre instrumentos (ii)
2951 Si las propiedades de volumen MIDI máximo y mínimo no están
2952 establecidas, de forma predeterminada LilyPond aplica un pequeño grado
2953 de ecualización a algunos instrumentos. Los instrumentos y la
2954 ecualización que se aplica se muestra en la tabla
2955 @notation{instrument-equalizer-alist} en @file{../scm/midi.scm}.
2957 El ecualizador básico predeterminado se puede sustituir estableciendo
2958 @code{instrumentEqualizer} en el contexto @code{Score} a un
2959 procedimiento Scheme nuevo que acepte el nombre de un instrumento MIDI
2960 como único argumento y devuelva un par de fracciones que dan los
2961 volúmenes máximo y mínimo que se aplican a dicho instrumento. Esta
2962 sustitución se hace de la misma forma que mostramos para restablecer
2963 la fracción de volumen absoluto @code{dynamicAbsoluteVolumeFunction}
2964 al comienzo de esta sección. El ecualizador predeterminado,
2965 @notation{default-instrument-equalizer}, en
2966 @file{../scm/midi.scm}, muestra cómo se puede escribir tal
2969 El ejemplo siguiente establece los volúmenes relativos de la flauta y
2970 del clarinete a los mismos valores que el ejemplo anterior.
2972 @lilypond[verbatim,quote]
2973 #(define my-instrument-equalizer-alist '())
2975 #(set! my-instrument-equalizer-alist
2978 ("flute" . (0.7 . 0.9))
2979 ("clarinet" . (0.3 . 0.6)))
2980 my-instrument-equalizer-alist))
2982 #(define (my-instrument-equalizer s)
2983 (let ((entry (assoc s my-instrument-equalizer-alist)))
2992 \set Score.instrumentEqualizer = #my-instrument-equalizer
2993 \set Staff.midiInstrument = #"flute"
2994 \new Voice \relative c''' {
3002 \set Staff.midiInstrument = #"clarinet"
3003 \new Voice \relative c'' {
3018 @c Delete when satisfied this is adequately covered elsewhere -td
3020 @n ode Microtones in MIDI
3021 @s ubsection Microtones in MIDI
3023 @cindex microtones in MIDI
3025 Microtones consisting of half sharps and half flats are exported
3026 to the MIDI file and render correctly in MIDI players which support
3027 pitch bending. See @ref{Nombres de las notas en otros idiomas}. Here is
3028 an example showing all the half sharps and half flats. It can be
3029 copied out and compiled to test microtones in your MIDI player.
3031 @lilypond[verbatim,quote]
3048 @node Percusión en MIDI
3049 @subsection Percusión en MIDI
3050 @translationof Percussion in MIDI
3052 La notación de los instrumentos de percusión se realiza normalmente en
3053 un contexto @code{DrumStaff} y cuando se hace de esta forma se les da
3054 salida correctamente por el canal MIDI@tie{}10, pero ciertos
3055 instrumentos de percusión de altura determinada, como el xilófono,
3056 marimba, vibráfono, timbales, etc., se tratan como instrumentos
3057 @qq{normales} y la música para estos instrumentos se debe introducir
3058 en contextos de @code{Staff} normales, no en un contexto
3059 @code{DrumStaff}, para obtener la salida MIDI correcta.
3061 Ciertos sonidos de altura indeterminada que están incluidos en el
3062 estándar General MIDI, como el tom melódico, el tambor taiko, los
3063 tambores sintéticos, etc., no se pueden acceder a través del canal
3064 MIDI@tie{}10, por lo que la notación para dichos instrumentos se debe
3065 introducir también en un contexto normal de @code{Staff}, utilizando
3066 las alturas normales adecuadas.
3068 Muchos instrumentos de percusión no están incluidos dentro del
3069 estándar General MIDI, p.ej. las castañuelas. El método más
3070 fácil (aunque no satisfactorio) de producir una salida MIDI al
3071 escribir para estos instrumentos es sustituirlos por el sonido más
3072 parecido del conjunto estándar.
3074 @c TODO Expand with examples, and any other issues
3078 Debido a que el estándar General MIDI no contiene golpes de aro
3079 (@emph{rim shots}), para este propósito se utiliza en su lugar el
3080 golpe lateral de baqueta (@emph{sidestick}).
3083 @node El script Articulate
3084 @subsection El script Articulate
3085 @translationof The Articulate script
3087 Es posible obtener una salida MIDI más real si se utiliza el script
3088 Articulate. Éste trata de tener en cuenta las articulaciones
3089 (ligaduras de expresión, picados, etc), mediante la sustitución de las
3090 notas con secuencias musicales de silencios y notas escaladas en el
3091 tiempo de forma apropiada. También trata de desplegar los trinos,
3092 grupetos circulares, etc. y responder a las indicaciones de
3093 rallentando y accelerando.
3095 Para utilizar el script Articulate, tenemos que incluirlo al principio
3096 de nuestro archivo de entrada:
3099 \include "articulate.ly"
3102 y en la sección @code{\score}, hacer lo siguiente:
3105 \unfoldRepeats \articulate <<
3106 resto de la partitura...
3110 Después de alterar el código de entrada de esta manera el resultado
3111 visual se altera profundamente, pero el bloque @code{\midi} estándar
3112 produce un archivo MIDI mejorado.
3114 Si bien no es esencial para que funcione el script Articulate, podemos
3115 insertar la instrucción @code{\unfoldRepeats} según aparece en el
3116 ejemplo anterior, dado que habilita la ejecución de abreviaturas tales
3117 como los @notation{trinos}.
3121 Articulate acorta los acordes, y ciertos fragmentos de música
3122 (especialmente la música de órgano) es posible que suene peor.
3125 @node Extraer información musical
3126 @section Extraer información musical
3127 @translationof Extracting musical information
3129 Además de crear un resultado visual y MIDI,
3130 LilyPond es capaz de presentar información
3131 musical en forma de texto.
3134 * Impresión del código de notación de LilyPond::
3135 * Impresión de las expresiones musicales de Scheme::
3136 * Guardar los eventos musicales en un archivo::
3140 @node Impresión del código de notación de LilyPond
3141 @subsection Displaying LilyPond notation
3142 @translationof Displaying LilyPond notation
3144 @funindex \displayLilyMusic
3145 La impresión textual de una expresión musical en notación de LilyPond
3146 puede hacerse con la función musical @code{\displayLilyMusic}.
3147 Para ver el resultado, lo más usual es llamar a LilyPond
3148 mediante la línea de órdenes. Por ejemplo,
3152 \displayLilyMusic \transpose c a, @{ c4 e g a bes @}
3156 imprime lo siguiente:
3159 @{ a,4 cis e fis g @}
3162 De forma predeterminada, LilyPond imprime estos mensajes en la consola
3163 junto al resto de los mensajes de la compilación de LilyPond.
3164 Para discernir entre estos mensajes y
3165 guardar el resultado de @code{\display@{MATERIAL@}}, redireccione la
3166 salida hacia un archivo.
3169 lilypond archivo.ly >resultado.txt
3173 @node Impresión de las expresiones musicales de Scheme
3174 @subsection Impresión de las expresiones musicales de Scheme
3175 @translationof Displaying scheme music expressions
3177 Véase @rextend{Presentación de las expresiones musicales}.
3180 @node Guardar los eventos musicales en un archivo
3181 @subsection Guardar los eventos musicales en un archivo
3182 @translationof Saving music events to a file
3184 Los eventos musicales se pueden guardar en un archivo pentagrama a
3185 pentagrama mediante la inclusión de un archivo en nuestra partitura
3189 \include "event-listener.ly"
3192 De esta forma se crean uno o más archivos llamados
3193 @file{FILENAME-STAFFNAME.notes} ó @file{FILENAME-unnamed-staff.notes}
3194 para cada pentagrama. Observe que si tiene más de un pentagrama sin
3195 nombre, los eventos de todos los pentagramas se mezclarán entre sí
3196 dentro del mismo archivo. El resultado tiene el aspecto siguiente:
3199 0.000 note 57 4 p-c 2 12
3201 0.250 note 62 4 p-c 7 12
3202 0.500 note 66 8 p-c 9 12
3203 0.625 note 69 8 p-c 14 12
3208 La sintaxis consiste en una línea delimitada por caracteres de
3209 tabulación, con dos campos fijos en cada línea seguidos de parámetros
3213 @var{tiempo} @var{tipo} @var{...parámetros...}
3216 Esta información se puede leer fácilmente por parte de otros programas
3217 como guiones de Python, y pueden ser muy útiles para aquellos
3218 investigadores que desean realizar un análisis musical o hacer
3219 experimientos de reproducción con LilyPond.
3222 No todos los eventos musicales de lilypond están contemplados por
3223 @file{event-listener.ly}. Se pretende que sea una @qq{prueba de
3224 concepto} bien realizada. Si algunos eventos que quiere ver no
3225 aparecen incluidos, copie @file{event-listener.ly} en su carpeta de
3226 lilypond y modifique el archivo de forma que produzca la información