1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
4 Translation of GIT committish: ba92a1755026936bebe14a6c8ff6d2cfc704eeb1
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. For details, see the Contributors'
8 Guide, node Updating translation committishes..
13 @node Entrada y salida generales
14 @chapter Entrada y salida generales
15 @translationof General input and output
17 Esta sección trata de asuntos relacionados con la entrada y salida
18 generales de LilyPond, más que con la notación específica.
21 * Estructura del código de entrada::
22 * Títulos y encabezamientos::
23 * Trabajar sobre los archivos de entrada::
24 * Controlar la salida::
26 * Extraer información musical::
30 @node Estructura del código de entrada
31 @section Estructura del código de entrada
32 @translationof Input structure
34 El formato principal de entrada para LilyPond son archivos de texto.
35 Por convenio, el nombre de estos archivos termina en @file{.ly}.
38 * Estructura de una partitura::
39 * Varias partituras en un libro::
40 * Varios archivos de salida a partir de uno de entrada::
41 * Nombres de los archivos de salida::
42 * Estructura del archivo::
46 @node Estructura de una partitura
47 @subsection Estructura de una partitura
48 @translationof Structure of a score
52 Un bloque @code{\score} debe contener una expresión musical única
53 delimitada por un par de llaves:
62 @warning{Sólo puede haber @strong{una} expresión musical dentro del
63 bloque @code{\score}, y @strong{debe} estar encerrada entre llaves.}
65 Esta expresión musical única puede tener cualquier tamaño, y puede
66 contener otras expresiones musicales hasta cualquier grado de
67 complejidad. Todos los siguientes ejemplos son expresiones musicales:
73 @lilypond[verbatim,quote]
80 @lilypond[verbatim,quote]
82 \new Staff { c'4 c' c' c' }
83 \new Staff { d'4 d' d' d' }
91 \new Staff @{ \flute @}
92 \new Staff @{ \oboe @}
95 \new Staff @{ \violinI @}
96 \new Staff @{ \violinII @}
102 Los comentarios son una excepción a esta regla general (para ver otras
103 excepciones, consulte @ref{Estructura del archivo}). Tanto los comentarios de
104 una línea como los que están delimitados por @code{%@{ .. %@}} 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 decir, al principio del archivo). Es el bloque que
390 contiene los ajustes predeterminados de los campos de encabezamientos
391 como el compositor, título, etc. para todos los libros que están
392 dentro del archivo (véase @ref{Explicación de los títulos}).
395 Un bloque @code{\score}. Esta partitura se reúne con otras partituras
396 del nivel superior, y se combina con ellas formando un @code{\book}
397 (libro) único. Este comportamiento se puede cambiar estableciendo el
398 valor de la variable @code{toplevel-score-handler} en el nivel
399 superior. El @emph{handler} predeterminado se define en el archivo de
400 inicio @file{../scm/lily.scm}.
403 Un bloque @code{\book} combina lógicamente varios movimientos (es
404 decir, varios bloques @code{\score}) en un solo documento. Si hay
405 varias partituras @code{\score}, se crea un solo archivo de salida
406 para cada bloque @code{\book}, en el que se concatenan todos los
407 movimientos correspondientes. La única razón para especificar
408 explícitamente bloques @code{\book} en un archivo de entrada
409 @file{.ly} es si queremos crear varios archivos de salida a partir de
410 un único archivo de entrada. Una excepción se da dentro de los
411 documentos de lilypond-book, en los que tenemos que escribir
412 explícitamente un bloque @code{\book} si queremos tener más de una
413 única partitura @code{\score} o marcado @code{\markup} en el mismo
414 ejemplo. Se puede cambiar este comportamiento estableciendo el valor
415 de la variable @code{toplevel-book-handler} en el nivel superior. El
416 @emph{handler} predeterminado se define en el archivo de inicio
417 @file{../scm/lily.scm}.
420 Un bloque @code{\bookpart}. Un libro puede dividirse en varias
421 partes, utilizando bloques @code{\bookpart}, con objeto de facilitar
422 la inserción de saltos de página o usar distintos ajustes de
423 @code{\paper} en las distintas partes.
426 Una expresión musical compuesta, como
431 Esto añade la pieza al @code{\score} y la conforma dentro de un libro
432 único junto a todas las demás partituras @code{\score} y expresiones
433 musicales del nivel superior. En otras palabras, un archivo que
434 contiene sólo la expresión musical anterior se traduce a
451 Se puede cambiar este comportamiento estableciendo el valor de la
452 variable @code{toplevel-music-handler} en el nivel más alto. El
453 @emph{handler} predeterminado se define en el archivo de inicio
454 @file{../scm/lily.scm}.
457 Un texto de marcado, por ejemplo una estrofa
460 2. Estrofa dos, línea uno
464 Los textos de marcado se colocan encima, en medio o debajo de las
465 partituras o expresiones musicales, según donde aparezcan escritos.
472 fulano = @{ c4 d e d @}
475 Esto se puede utilizar más tarde en el archivo escribiendo
476 @code{\fulano}. El nombre de las variables ha de ser exclusivamente
477 alfabético; sin números, guiones ni barras bajas.
481 El ejemplo siguiente muestra tres cosas que se pueden introducir en el
486 % No justificar la salida
497 En cualquier punto del archivo se pueden introducir cualquiera de las
498 instrucciones léxicas siguientes:
501 @item @code{\version}
502 @item @code{\include}
503 @item @code{\sourcefilename}
504 @item @code{\sourcefileline}
506 Un comentario de una línea, determinado por un símbolo @code{%} al principio.
509 Un comentario de varias líneas, delimitado por @code{%@{ .. %@}}.
513 @cindex espacios en blanco
515 Por lo general se ignoran los espacios entre elementos del flujo de
516 entrada, y se pueden omitir o aumentar tranquilamente para mejorar la
517 legibilidad. Sin embargo, los espacios se deben utilizar siempre para
518 evitar errores, en las siguientes situaciones:
521 @item Alrededor de todas y cada una de las llaves curvas de apertura y cierre.
522 @item A continuación de las instrucciones y variables, es decir, todos los elementos
523 que comienzan con un signo @code{\} de barra invertida.
524 @item A continuación de todo elemento que se deba interpretar como expresión
525 de Scheme, es decir, todo elemento que comience por un signo@tie{}@code{#}.
526 @item Para separar los elementos de una expresión de Scheme.
527 @item Dentro de @code{lyricmode} para separar todos los términos de las instrucciones
528 @code{\override} y @code{\set}. Concretamente, hay que usar espacios
529 alrededor del punto y el signo igual en instrucciones como
530 @code{\override Score . LyricText #'font-size = #5} y antes y después
531 de la instrucción completa.
536 Manual de aprendizaje:
537 @rlearning{Cómo funcionan los archivos de entrada de LilyPond}.
539 Referencia de la notación:
540 @ref{Explicación de los títulos},
541 @ref{El bloque \layout}.
543 @node Títulos y encabezamientos
544 @section Títulos y encabezamientos
545 @translationof Titles and headers
547 Casi toda la música impresa tiene un título y el nombre del
548 compositor; ciertas piezas tienen mucha más información.
551 * Crear títulos encabezamientos y pies de página::
552 * Títulos encabezamientos y pies de página personalizados::
553 * Crear notas al pie::
554 * Referencia a números de página::
559 @node Crear títulos encabezamientos y pies de página
560 @subsection Crear títulos, encabezamientos y pies de página
561 @translationof Creating titles headers and footers
564 * Explicación de los títulos::
565 * Presentación predeterminada de los títulos de partes de libro y partitura::
566 * Disposición predeterminada de las cabeceras y pies de página::
570 @node Explicación de los títulos
571 @unnumberedsubsubsec Explicación de los títulos
572 @translationof Titles explained
574 Cada bloque @code{\book} de un solo archivo de entrada produce un
575 archivo de salida distinto, véase @ref{Estructura del archivo}.
576 Dentro de cada archivo de salida están disponibles dos tipos de zonas
577 para títulos: @emph{Títulos de parte de libro} al principio de cada
578 parte de un libro y @emph{Títulos de partitura} al comienzo de una
581 Los valores de los campos para encabezamientos tales como @code{title}
582 (para el título) y @code{composer} (para el autor) se establecen en
583 bloques @code{\header} (para ver la sintaxis de los bloques
584 @code{\header} y una lista completa de los campos disponibles de forma
585 predeterminada, consulte @ref{Presentación predeterminada de los
586 títulos de partes de libro y partitura}). Tanto los títulos de parte
587 de libro como los títulos de partitura pueden contener los mismos
588 campos, aunque de forma predeterminada los campos de los títulos de
589 partitura se limitan a @code{piece} (pieza) y @code{opus}.
591 Los bloques @code{\header} se pueden situar en cuatro lugares
592 distintos para formar una jerarquía descendente de bloques
598 Al principio del archivo de entrada, antes de cualquier otro bloque
599 @code{\book}, @code{\bookpart} o @code{\score}.
602 Dentro de un bloque @code{\book} pero fuera de los bloques
603 @code{\bookpart} y @code{\score} que están dentro de ese libro.
606 Dentro de un bloque @code{\bookpart} pero fuera de cualquier bloque
607 @code{\score} dentro de dicha parte de libro.
610 Después de la expresión musical de un bloque @code{\score}.
614 Los valores de los campos se fitran a través de esta jerarquía,
615 persistiendo aquellos que se establecen más arriba a no ser que se
616 sobreescriban por un valor establecido más abajo en la jerarquía, y
622 Un título de parte de libro se deriva de los campos fijados al
623 principio del archivo de entrada, modificado por los campos
624 establecidos dentro del bloque @code{\book}, y posteriormente
625 modificado por los campos que se fijan dentro del bloque
626 @code{\bookpart}. Los valores resultantes se usan para imprimir el
627 título de parte de libro para esa parte.
630 Un título de partitura se deriva de los campos que se fijan al
631 principio del archivo de entrada, modificados por los campos fijados
632 dentro del bloque @code{\book}, posteriormente modificados por los
633 campos que se fijan dentro del bloque @code{\bookpart} y finalmente
634 modificados por los campos establecidos dentro del bloque
635 @code{\score}. Los valores restulantes se utilizan para imprimir el
636 título de partitura. Observe, sin embargo, que de forma
637 predeterminada solamente se imprimen los campos @code{piece} y
638 @code{opus} en los títulos de partitura a no ser que la variable de
639 @code{\paper}, @code{print-all-headers}, tenga el valor @code{#t}.
643 @warning{Recuerde que al poner un bloque @bs{}@code{header} dentro de
644 un bloque @bs{}@code{score}, la expresión musical debe aparecer antes
645 del bloque @bs{}@code{header}.}
647 No es necesario aportar bloques @code{\header} en los cuatro lugares:
648 cualquiera de ellos o incluso todos pueden omitirse. De forma
649 similar, los archivos de entrada sencillos pueden omitir los bloques
650 @code{\book} y @code{\bookpart}, dejando que se creen de forma
653 Si el lobro solamente tiene una partitura, el bloque @code{\header}
654 debiera situarse normalmente al principio del archivo de forma que
655 solamente se produce una zona de título de parte de libro, haciendo
656 que estén disponibles para su uso todos los títulos de
659 Si el libro tiene varias partituras, son posibles distintas
660 combinaciones de bloques @code{\header}, según los distintos tipos de
661 publicaciones musicales. Por ejemplo, si la publicación contiene
662 varias piezas del mismo autor, un bloque @code{\header} colocado al
663 principio del archivo que especifique el título del libro y el autor,
664 con bloques @code{\header} en cada bloque @code{\score} que
665 especifique la @code{piece} y/o el @code{opus} sería lo más adecuado,
668 @lilypond[papersize=a5,quote,verbatim,noragged-right]
671 composer = "J. S. Bach."
675 \new Staff \relative g, {
678 \repeat unfold 2 { g16( d' b') a b d, b' d, } |
679 \repeat unfold 2 { g,16( e' c') b c e, c' e, } |
687 \new Staff \relative b {
691 <g, d' b'~>4 b'16 a( g fis) g( d e fis) g( a b c) |
692 d16( b g fis) g( e d c) b(c d e) fis( g a b) |
700 Son posibles disposiciones más complejas. Por ejemplo, los campos de
701 texto extraídos del bloque @code{\header} de un libro se pueden
702 imprimir en todos los títulos de partitura, con ciertos campos
703 sobreescritos y otros suprimidos manualmente:
705 @lilypond[papersize=a5,quote,verbatim,noragged-right]
708 print-all-headers = ##t
711 title = "DAS WOHLTEMPERIRTE CLAVIER"
713 % Do not display the tagline for this book
716 \markup { \vspace #1 }
720 \new Staff { \clef "bass" s1 }
723 title = "PRAELUDIUM I"
725 % Do not display the subtitle for this score
732 \new Staff { \clef "bass" s1 }
736 subsubtitle = "A 4 VOCI"
738 % Do not display the subtitle for this score
746 Referencia de la notación:
747 @ref{Estructura del archivo},
748 @ref{Presentación predeterminada de los títulos de partes de libro y partitura},
749 @ref{Personalización de los títulos}.
752 @node Presentación predeterminada de los títulos de partes de libro y partitura
753 @unnumberedsubsubsec Presentación predeterminada de los títulos de partes de libro y partitura
754 @translationof Default layout of bookpart and score titles
756 Este ejemplo muestra todas las variables de @code{\header}:
759 @lilypond[papersize=a7,quote,verbatim,noragged-right]
762 % Los siguientes campos están centrados
763 dedication = "Dedication (dedicatoria)"
764 title = "Title (título)"
765 subtitle = "Subtitle (subtítulo)"
766 subsubtitle = "Subsubtitle (sub-subtítulo)"
767 % Los siguientes campos se distribuyen regularmente sobre una línea
768 % el campo "instrument" también aparece en las siguientes páginas
769 instrument = \markup \with-color #green "Instrument (instrumento)"
770 poet = "Poet (poeta)"
771 composer = "Composer (autor)"
772 % Los siguientes campos se sitúan en los extremos opuestos de la misma línea
773 meter = "Meter (metro)"
774 arranger = "Arranger (arreglista)"
775 % Los siguientes campos están centrados en la parte inferior
776 tagline = "la tagline o línea de etiqueta va al final de la úitlma página"
777 copyright = "el copyright va al final de la primera página"
782 % Los siguientes campos se colocan en los extremos de una línea
783 piece = "Piece (pieza) 1"
790 % Los siguientes campos se sitúan en los extremos de una línea
791 piece = "Piece (pieza) 2 en la misma página"
799 % Los siguientes campos se sitúan en los extremos de una línea
800 piece = "Piece (pieza) 3 en una página nueva"
811 El nombre de instrumento se repite en todas las páginas.
814 Solamente @code{piece} (la pieza) y @code{opus} se imprimen en una
815 @code{\score} cuando la variable de papel @code{print-all-headers} se
816 establece a @code{##f} (el valor predeterminado).
819 @c Is the bit about \null markups true? -mp
820 Los campos de texto que se dejan sin establecer dentro de un bloque
821 @code{\header} se sustituyen por elementos de marcado nulos
822 @code{\null} de manera que no ocupen espacio innecesariamente.
825 Los ajustes predeterminados para @code{scoreTitleMarkup} sitúan los
826 campos de texto @code{piece} y @code{opus} en extremos opuestos de la
831 Para cambiar la disposición predeterminada, véase
832 @ref{Personalización de los títulos}.
836 Utilice la variable @code{breakbefore} dentro de un bloque
837 @code{\header} que está propiamente dentro de un bloque @code{\score}
838 para hacer que los títulos del bloque @code{\header} del nivel
839 superior aparezcan ocupando toda la primera página, empezando la
840 música (definida en el bloque @code{\score}) en la página siguiente.
843 @lilypond[papersize=a8landscape,verbatim,noragged-right]
846 title = "Este es mi Title (título)"
847 subtitle = "Este es mi Subtitle (subtítulo)"
848 copyright = "Este es el final de la primera página"
851 \repeat unfold 4 { e'' e'' e'' e'' }
853 piece = "Esto es la música"
861 Manual de aprendizaje:
862 @rlearning{Cómo funcionan los archivos de entrada de LilyPond}
864 Referencia de la notación:
865 @ref{Personalización de los títulos},
866 @ref{Estructura del archivo}.
869 @file{ly/titling-init.ly}.
872 @node Disposición predeterminada de las cabeceras y pies de página
873 @unnumberedsubsubsec Disposición predeterminada de las cabeceras y pies de página
874 @translationof Default layout of headers and footers
876 Las @emph{cabeceras} y los @emph{pies} de página son líneas de texto
877 que aparecen en la parte más alta y en la más baja de las páginas
878 separadas del texto principal de un libro. Se controlan mediante las
879 siguientes variables de @code{\paper}:
882 @item @code{oddHeaderMarkup} (marcado de cabecera impar)
883 @item @code{evenHeaderMarkup} (marcado de cabecera par)
884 @item @code{oddFooterMarkup} (marcado de pie impar)
885 @item @code{evenFooterMarkup} (marcado de pie par)
888 Estas variables de marcado sólo pueden acceder a los campos de texto
889 extraídos de bloques @code{\header} del nivel superior (que se aplican
890 a todas las partituras del libro) y se definen en el archivo
891 @file{ly/titling-init.ly}. De forma predeterminada:
896 los números de página se sitúan automáticamente en el extremo superior
897 izquierdo (si es par) o superior derecho (si es impar), a partir de la
901 el campo de texto @code{instrument} se sitúa en el centro en cada
902 página, a partir de la segunda página.
905 el texto de @code{copyright} se centra en la parte baja de la primera
909 la línea @code{tagline} se centra al final de la última página, y
910 debajo del texto de @code{copyright} si sólo hay una página.
914 @lilypond[papersize=a8landscape]
924 La línea de etiqueta tagline predeterminada se puede cambiar añadiendo un campo
925 @code{tagline} en el bloque @code{\header} del nivel superior.
927 @lilypond[papersize=a8landscape,verbatim]
930 tagline = "... music notation for Everyone"
940 Para eliminar la línea @code{tagline}, establezca su valor a
944 @node Títulos encabezamientos y pies de página personalizados
945 @subsection Títulos, encabezamientos y pies de página personalizados
946 @translationof Custom titles headers and footers
948 @c TODO: somewhere put a link to header spacing info
949 @c (you'll have to explain it more in NR 4).
952 * Formateo personalizado del texto de los títulos::
953 * Personalización de los títulos::
954 * Disposición personalizada de cabeceras y pies de página::
958 @node Formateo personalizado del texto de los títulos
959 @unnumberedsubsubsec Formateo personalizado del texto de los bloques de título
960 @translationof Custom text formatting for titles
962 Se pueden usar instrucciones @code{\markup} estándar para personalizar
963 el texto de cualquier cabecera, pie o título dentro del bloque
966 @lilypond[quote,verbatim,noragged-right]
970 piece = \markup { \fontsize #4 \bold "PRAELUDIUM I" }
971 subtitle = \markup { \italic "(Excerpt)" }
977 Referencia de la notación:
978 @ref{Formatear el texto}.
981 @node Personalización de los títulos
982 @unnumberedsubsubsec Personalización de los títulos
983 @translationof Custom layout for titles
985 @cindex bookTitleMarkup
986 @cindex scoreTitleMarkup
987 @funindex bookTitleMarkup
988 @funindex scoreTitleMarkup
990 Las instrucciones @code{\markup} dentro del bloque @code{\header} son
991 útiles para dar un formato simple al texto, pero no permiten un
992 control preciso sobre la colocación de los títulos. Para personalizar
993 la colocación de los campos de texto, cambie una o las dos variables de
994 @code{\paper} siguientes:
997 @item @code{bookTitleMarkup} (marcado de título del libro)
998 @item @code{scoreTitleMarkup} (marcado de título de la partitura)
1001 La colocación de los títulos cuando se utilizan los valores
1002 predeterminados de estas variables de @code{\markup} se muestra en los
1004 @ref{Presentación predeterminada de los títulos de partes de libro y partitura}.
1006 Los ajustes predeterminados para @code{scoreTitleMarkup} tal y como
1007 están definidos en el archivo @file{ly/titling-init.ly} son:
1010 scoreTitleMarkup = \markup @{ \column @{
1011 \on-the-fly #print-all-headers @{ \bookTitleMarkup \hspace #1 @}
1013 \fromproperty #'header:piece
1014 \fromproperty #'header:opus
1020 Esto sitúa los campos de texto @code{piece} y @code{opus} en extremos
1021 opuestos de la misma línea:
1023 @lilypond[quote,verbatim,noragged-right]
1027 piece = "PRAELUDIUM I"
1033 Este ejemplo redefine @code{scoreTitleMarkup} de manera que el campo
1034 de texto @code{piece} aparece centrado y en un tipo de letra grande y
1037 @lilypond[papersize=a5,quote,verbatim,noragged-right]
1041 scoreTitleMarkup = \markup {
1044 \fontsize #4 \bold \fromproperty #'header:piece
1045 \fromproperty #'header:opus
1049 \header { tagline = ##f }
1053 piece = "PRAELUDIUM I"
1060 Los campos de texto que normalmente no son efectivos
1061 dentro de los bloques @code{\header} de una partitura
1062 se pueden imprimir el la zona del Título de la partitura
1063 si se coloca @code{print-all-headers} dentro del bloque @code{\paper}.
1064 Una desventaja de la
1065 utilización de este método es que los campos de texto que están
1066 orientados específicamente para la zona del título de parte de libro
1067 han de suprimirse manualmente en cada uno de los bloques
1068 @code{\score}. Véase @ref{Explicación de los títulos}.
1070 Para evitarlo, añada el campo de texto deseado a la definición de
1071 @code{scoreTitleMarkup}. En el ejemplo siguiente, el campo de texto
1072 @code{composer} (asociado normalmente con @code{bookTitleMarkup}) se
1073 añade a @code{scoreTitleMarkup}, permitiendo que cada partitura
1074 muestre un compositor diferente:
1076 @lilypond[papersize=a5,quote,verbatim,noragged-right]
1080 scoreTitleMarkup = \markup {
1083 \fontsize #4 \bold \fromproperty #'header:piece
1084 \fromproperty #'header:composer
1088 \header { tagline = ##f }
1093 composer = "Christian Petzold"
1100 composer = "François Couperin"
1106 También podemos crear nuestros propios campos de texto personalizados,
1107 y referirnos a ellos en la definición del elemento de marcado.
1109 @lilypond[papersize=a5,quote,verbatim,noragged-right]
1113 scoreTitleMarkup = \markup {
1116 \override #`(direction . ,UP) {
1118 \center-align \fontsize #-1 \bold
1119 \fromproperty #'header:mycustomtext %% User-defined field
1120 \center-align \fontsize #4 \bold
1121 \fromproperty #'header:piece
1124 \fromproperty #'header:opus
1128 \header { tagline = ##f }
1133 mycustomtext = "A 4 VOCI" %% User-defined field
1141 Referencia de la notación:
1142 @ref{Explicación de los títulos}.
1145 @node Disposición personalizada de cabeceras y pies de página
1146 @unnumberedsubsubsec Disposición personalizada de cabeceras y pies de página
1147 @translationof Custom layout for headers and footers
1149 @c can make-header and make-footer be removed from
1150 @c paper-defaults-init.ly? -mp
1152 Las instrucciones @code{\markup} dentro del bloque @code{\header} son
1153 de utilidad para dar formato al texto de una manera sencilla, pero no
1154 permiten un control preciso sobre la colocación de las cabeceras y los
1155 pies de página. Para personalizar la colocación de los campos de
1156 texto, use una o más de las siguientes variables de @code{\paper}:
1159 @item @code{oddHeaderMarkup} (marcado de encabezamiento impar)
1160 @item @code{evenHeaderMarkup} (marcado de encabezamiento par)
1161 @item @code{oddFooterMarkup} (marcado de pie de página impar)
1162 @item @code{evenFooterMarkup} (marcado de pie de página par)
1165 @cindex marcado condicional
1167 @funindex \on-the-fly
1169 La instrucción de marcado @code{\on-the-fly} se puede utilizar para
1170 añadir elementos de forma condicional al texto de encabezamiento y pie
1171 de página definido dentro del bloque @code{\paper}, usando la sintaxis
1175 @code{variable} = @code{\markup} @{
1177 @code{\on-the-fly} #@var{procedimiento} @var{marcado}
1182 El @var{procedimiento} se llama cada vez que se evalúa la instrucción
1183 @code{\markup} en que ésta aparece. El @var{procedimiento} debería
1184 comprobar si se cumple una condición determinada e interpretar (es
1185 decir: imprimir) el argumento @var{marcado} si, y sólo si, la
1186 condición es verdadera.
1188 Se proveen un cierto número de procedimientos ya hechos para la
1189 comprobación de diversas condiciones:
1192 @multitable {print-page-number-check-first-----} {¿es el núm. de páginas en la parte de libro > 1?-----}
1194 @headitem Nombre del procedimiento @tab Condición que se comprueba
1196 @item print-page-number-check-first @tab ¿debería imprimirse esta página?
1197 @item create-page-number-stencil @tab ¿es 'print-page-numbers verdadero?
1198 @item print-all-headers @tab ¿es 'print-all-headers verdadero?
1199 @item first-page @tab ¿es la primera página del libro?
1200 @item (on-page nmbr) @tab ¿es el número de página = nmbr?
1201 @item last-page @tab ¿es la última página del libro?
1202 @item not-first-page @tab ¿no es la primera página del libro?
1203 @item part-first-page @tab ¿es la primera página de la parte de libro?
1204 @item part-last-page @tab ¿es la última página de la parte de libro?
1205 @item not-single-page @tab ¿es el núm. de páginas en la parte de libro > 1?
1210 El ejemplo siguiente centra los números de página en la parte baja de
1211 las páginas. En primer lugar, los ajustes predeterminados para
1212 @code{oddHeaderMarkup} y @code{evenHeaderMarkup} se eliminan
1213 definiéndolos como un marcado @emph{nulo}. Después de esto, se
1214 redefine @code{oddFooterMarkup} con el número de página centrado.
1215 Finalmente, @code{evenFooterMarkup} recibe la misma disposición
1216 definiéndola como @code{\oddFooterMarkup}:
1218 @lilypond[papersize=a8,quote,verbatim,noragged-right]
1221 print-page-number = ##t
1222 print-first-page-number = ##t
1223 oddHeaderMarkup = \markup \null
1224 evenHeaderMarkup = \markup \null
1225 oddFooterMarkup = \markup {
1227 \on-the-fly #print-page-number-check-first
1228 \fromproperty #'page:page-number-string
1231 evenFooterMarkup = \oddFooterMarkup
1234 \new Staff { s1 \break s1 \break s1 }
1239 Se pueden combinar varias condiciones de @code{\on-the-fly} con un
1240 operador @q{and}, por ejemplo:
1243 @code{\on-the-fly #first-page}
1244 @code{\on-the-fly #last-page}
1245 @code{@{ \markup ... \fromproperty #'header: ... @}}
1248 determina si la salida es una sola página.
1251 Referencia de la notación:
1252 @ref{Explicación de los títulos},
1253 @ref{Presentación predeterminada de los títulos de partes de libro y partitura}.
1255 Archivos instalados:
1256 @file{../ly/titling-init.ly}.
1259 @node Crear notas al pie
1260 @subsection Crear notas al pie
1261 @translationof Creating footnotes
1263 @cindex notas al pie
1265 Se pueden crear dos tipos de notas al pie: automáticas y manuales.
1268 * Notas al pie dentro de expresiones musicales::
1269 * Notas al pie en texto independiente::
1272 @node Notas al pie dentro de expresiones musicales
1273 @unnumberedsubsubsec Notas al pie dentro de expresiones musicales
1274 @translationof Footnotes in music expressions
1276 @cindex notas al pie dentro de expresiones musicales
1279 @subsubsubheading Panorámica de las notas al pie
1281 Las notas al pie dentro de expresiones musicales caen dentro de dos
1285 @item Notas al pie basadas en eventos
1286 Se adjuntan a un evento en particular. Son ejemplos de tales eventos
1287 las notas sueltas, notas dentro de un acorde, articulaciones (como
1288 barras, ligaduras de expresión, indicaciones de digitación, acentos,
1289 indicaciones dinámicas) y letra de las canciones.
1291 @item Notas al pie basadas en tiempo
1292 Se ligan a un punto temporal determinado, dentro de un contexto
1293 musical. Algunas instrucciones como @code{\time} y @code{\clef} en
1294 realidad no usan eventos para crear objetos como la indicación de
1295 compás y la clave. Un acorde tampoco crea un evento por sí mismo: su
1296 plica o corchete se crea al final de un paso de tiempo (nominalmente,
1297 a través de uno de los eventos de nota que contiene). Una nota al pie
1298 basada en tiempo permite anotar tales objetos de presentación sin
1299 referirse a ningún evento.
1303 La forma completa de una instrucción de nota al pie tanto para las
1304 notas al pie basadas en eventos como para las basadas en tiempo, es:
1307 [@var{dirección}] \footnote [@var{marca}] @var{desplazamiento} [@var{nombre-del-grob}] @var{texto-de-la-nota} @var{música}
1310 Los elementos son como sigue:
1315 Si (y sólo si) el @code{\footnote} se está aplicando a un post-evento
1316 o articulación, debe ir precedida de un indicador de dirección
1317 (@code{-, _, ^}) con el objeto de adjuntar la @var{música} (con una
1318 marca de nota al pie) a la nota o silencio precedente.
1321 es un elemento de marcado o cadena de caracteres que especifica la
1322 marca de nota al pie que se usa para marcar tanto el punto de
1323 referencia como la propia nota al pie en la parte inferior de la
1324 página. Se puede omitir (o, de forma equivalente, sustituirse por
1325 @code{\default}) en cuyo caso se genera un número secuencialmente de
1326 forma automática. Tales secuencias numéricas se reinician en cada
1327 página que contiene una nota al pie.
1329 @item desplazamiento
1330 es una pareja de números tal como @samp{#(2 . 1)} que especifica los
1331 desplazamientos en X y en Y en unidades de espacios de pentagrama a
1332 partir del límite del objeto en que se desea situar la marca. Los
1333 valores de desplazamiento positivos se toman a partir del borde
1334 superior derecho, los valores negativos a partir del borde inferior
1335 izquierdo y cero implica que la marca se centra sobre el borde.
1337 @item nombre-del-grob
1338 especifica un tipo de grob que marcar (como @samp{#'Flag} para el
1339 corchete). Si se da, se usa como punto de referencia un grob de ese
1340 tipo asociado con la @var{música} referenciada. Se puede omitir (o
1341 sustituirse con @code{\default}) si se desea que la marca de nota al
1342 pie se adjunte al grob directamente creado dentro de @var{música}.
1344 @item texto-de-la-nota
1345 es el elemento de marccado o cadena de caracteres que especifica el
1346 texto de la nota al pie que utilizar en la parte baja de la página.
1349 es el evento musical o componente de un acorde o post-evento que se
1350 está anotando. Aunque no se puede omitir, se puede sustituir por
1351 @code{\default} en cuyo caso la nota al pie no se adjunta a ninguna
1352 expresión en particular, sino más bien a un momento de tiempo. Es
1353 obligatorio en este caso utilizar el argumento @var{nombre-del-grob}
1354 para seleccionar un tipo de grob afectado, como por ejemplo
1355 @samp{#'TimeSignature}.
1359 @subsubsubheading Notas al pie basadas en eventos
1361 @cindex Notas al pie, basadas en eventos
1363 La forma más simple de una nota al pie basada en eventos es
1367 \footnote @var{desplazamiento} @var{texto-de-la-nota} @var{música}
1370 Este tipo de nota al pie se adjunta a un objeto de presentación
1371 causado directamente por el evento que corresponde a @var{música}.
1373 @lilypond[quote,verbatim,papersize=a8landscape]
1375 \header { tagline = ##f }
1377 \footnote #'(-1 . 3) "A note" a4
1379 \footnote #'(2 . 2) "A rest" r4
1385 Si se desea que la nota al pie se adjunte a un post-evento o
1386 articulación, la instrucción @code{\footnote} debe ir precedida por un
1387 indicador de dirección, @code{-, _, ^}, y seguida por el post-evento o
1388 articulación que se desea anotar como argumento @var{música}. En esta
1389 forma, la @code{\footnote} se puede considerar como una simple copia
1390 de su último argumento con una marca de nota al pie adjunta.
1392 @lilypond[quote,verbatim,papersize=a8landscape]
1394 \header { tagline = ##f }
1396 a4_\footnote #'(0 . -1) "A slur forced down" (
1397 b8^\footnote #'(1 . 0.5) "A manual beam forced up" [
1400 c-\footnote #'(1 . 1) "Tenuto" --
1405 Se pueden usar marcas personalizadas como altenativas a las marcas
1406 numéricas, y la línea de anotación que une el objeto marcado con la
1407 marca puede suprimirse:
1409 @lilypond[quote,verbatim,papersize=a8landscape]
1411 \header { tagline = ##f }
1413 \footnote "*" #'(0.5 . -2) \markup { \italic "* The first note" }
1415 \footnote \markup { \super "$" } #'(0.5 . 1)
1416 \markup { \super "$" \italic " The second note" }
1418 \once \override Score.FootnoteItem #'annotation-line = ##f
1419 b-\footnote \markup \tiny "+" #'(0.1 . 0.1)
1420 \markup { \super "+" \italic " Editorial" } \p
1425 Se pueden ver más ejemplos de marcas personalizadas en
1426 @ref{Notas al pie en texto independiente}.
1428 No es posible hacer un acorde completo de esta forma porque un acorde
1429 no produce un evento distinto al de las notas que lo componen, pero
1430 las propias notas que lo componen sí se pueden marcar.
1432 Si el objeto de presentación que se está anotando está causado
1433 @emph{indirectly} por un evento (como una alteración accidental o una
1434 plica causados por una cabeza de nota), se requiere un argumento
1435 adicional de símbolo, el @var{nombre-del-grob}, antes del texto de la
1438 @lilypond[quote,verbatim,papersize=a8landscape]
1440 \header { tagline = ##f }
1442 % footnotes may be added to chord constituents
1443 < \single\footnote #'(-1 . -3) "Another flat" Accidental aes
1445 \single\footnote #'(-1 . 0.5) "A flat" Accidental ees
1447 \single\footnote #'(-1 . 2) "A stem" Stem ees2
1452 @warning {Cuando las notas al pie se adjuntan a varios elementos musicales que
1453 están dentro del mismo momento musical, las notas al pie se numeran
1454 desde los elementos más altos a los más bajos tal y como aparecen en
1455 la salida impresa, no en el orden en que se escriben en el flujo de
1458 @subsubsubheading Notas al pie basadas en tiempo
1460 @cindex Notas al pie, basadas en tiempo
1462 Los objetos de presentación como las claves y las armaduras de
1463 tonalidad están producidas mayormente como consecuencia de propiedades
1464 cambiadas, más que como verdaderos eventos. Otros, como las líneas
1465 divisorias y los números de compás, son una consecuencia directa de la
1466 cuenta de tiempo. Por este motivo, las notas al pie basadas en estos
1467 objetos tienen que estar basadas en su cuenta de tiempo musical. Las
1468 notas al pie basadas en tiempo son preferibles también cuando se están
1469 creando funcionalidades como plicas y barras dentro de @emph{acordes}:
1470 mientras que tales funcionalidades por cada acorde se asignan
1471 normalmente a @emph{un} evento dentro del acorde, confiar en una
1472 elección en particular sería imprudente.
1474 Una nota al pie basada en tiempo se escribe de la misma manera que con
1475 una nota al pie basada en evento, excepto que se usa @code{\default}
1476 en lugar de la música que indica un evento. El objeto de presentación
1477 en cuestión debería siempre especificarse explícitamente para las
1478 notas al pie basadas en tiempo para evitar acabar teniendo marcas en
1479 los objetos más inesperados.
1481 @lilypond[quote,verbatim,papersize=a8landscape]
1483 \header { tagline = ##f }
1486 \footnote #'(-0.5 . -1) "Meter change" Staff.TimeSignature
1488 \footnote #'(1 . -1) "Chord stem" Stem
1490 \footnote #'(-0.5 . 1) "Bar line" Staff.BarLine
1492 \footnote #'(0.5 . -1) "Key change" Staff.KeySignature
1500 @node Notas al pie en texto independiente
1501 @unnumberedsubsubsec Notas al pie en texto independiente
1502 @translationof Footnotes in stand-alone text
1504 @cindex notas al pie en texto independiente
1506 Se utilizan dentro de un elemento de marcado fuera de cualquier
1507 expresión musical. No se traza una líne hasta el punto de referencia:
1508 la marca simplemente sigue al elemento de marcado que se referencia.
1509 Se pueden insertar las marcas automáticamente, en cuyo caso son
1510 numéricas. De forma alternativa, se pueden aportar manualmente marcas
1513 Las notas al pie para texto independiente con marcas automáticas y
1514 personalizadas se crean de distintas formas.
1516 @subsubsubheading Notas al pie en texto independiente con marcas automáticas
1518 La sintaxis de una nota al pue sobre texto independiente con marcas
1522 \markup @{ ... \auto-footnote @var{texto} @var{nota} ... @}
1530 es el elemento de marcado o cadena de caracteres que se desea anotar.
1533 es el elemento de marcado o cadena de caracteres que especifica el
1534 texto de la nota al pie que utilizar en la parte baja de la página.
1540 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1542 \header { tagline = ##f }
1545 \auto-footnote "tune" \italic " By me"
1546 "is shown below. It is a"
1547 \auto-footnote "recent" \italic " Aug 2012"
1556 @subsubsubheading Notas al pie sobre texto independiente con marcas personalizadas
1558 La sintaxis de una nota al pie sobre texto independiente con marcas
1562 \markup @{ ... \footnote @var{marca} @var{nota} ... @}
1570 es un elemento de marcado o cadena de caracteres que especifica la
1571 marca que se usa para señalar el punto de referencia. Observe que
1572 esta marca @emph{no} se inserta automáticamente antes de la propia
1576 es el elemento de marcado o cadena de caracteres que especifica el
1577 texto de la nota que aparece en la parte baja de la página, precedida
1578 por la @var{marca} especificada.
1582 Se puede usar como marca un carácter fácil de teclear, como * ó +,
1583 según se muestra en @ref{Notas al pie dentro de expresiones musicales}.
1584 De forma alternativa, se pueden usar alias en ASCII (véase
1585 @ref{Alias de ASCII}):
1587 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1589 \paper { #(include-special-characters) }
1590 \header { tagline = ##f }
1593 \footnote "*" \italic "* By me"
1594 "is shown below. It is a recent"
1595 \footnote \super † \concat {
1596 \super † \italic " Aug 2012"
1606 También pueden utilizarse códigos de caracteres Unicode para
1607 especificar las marcas (véase @ref{Unicode}):
1609 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1611 \header { tagline = ##f }
1614 \footnote \super \char##x00a7 \concat {
1615 \super \char##x00a7 \italic " By me"
1617 "is shown below. It is a recent"
1618 \footnote \super \char##x00b6 \concat {
1619 \super \char##x00b6 \italic " Aug 2012"
1630 Manual de aprendizaje:
1631 @rlearning{Objetos e interfaces}.
1633 Referencia de la notación:
1634 @ref{ASCII aliases},
1635 @ref{Globos de ayuda},
1636 @ref{List of special characters},
1637 @ref{Indicaciones de texto},
1638 @ref{Guiones de texto},
1641 Referencia de funcionamiento interno:
1642 @rinternals{FootnoteEvent},
1643 @rinternals{FootnoteItem},
1644 @rinternals{FootnoteSpanner},
1645 @rinternals{Footnote_engraver}.
1648 Varias notas al pie en la misma página solo pueden ir apiladas unas
1649 sobre otras; no se pueden imprimir en la misma línea.
1651 Las notas al pie no se pueden adjuntar a @code{MultiMeasureRests}
1652 (silencios multicompás) o a barras de corchea automáticas y las notas
1653 al pie pueden colisionar con las pautas, objetos @code{\markup}, otras
1654 marcas de notas al pie y líneas de anotación.
1657 @node Referencia a números de página
1658 @subsection Referencia a números de página
1659 @translationof Reference to page numbers
1661 Un lugar determinado de una partitura puede señalizarse usando la
1662 instrucción @code{\label} (etiqueta), ya sea en el nivel superior o
1663 dentro de la música. Podemos referirnos a esta etiqueta más tarde
1664 dentro de un elemento de marcado, para obtener el número de la página
1665 en la que se sitúa el punto señalizado, usando la instrucción de
1666 marcado @code{\page-ref}.
1668 @lilypond[verbatim,papersize=a8landscape]
1669 \header { tagline = ##f }
1675 \pageBreak \mark A \label #'markA
1679 \markup { The first score begins on page \page-ref #'firstScore "0" "?" }
1680 \markup { Mark A is on page \page-ref #'markA "0" "?" }
1684 La instrucción de marcado @code{\page-ref} toma tres argumentos:
1686 @item la etiqueta, un símbolo de scheme, p.ej. @code{#'firstScore};
1687 @item un elemento de marcado que se usará como medidor para estimar las dimensiones del marcado;
1688 @item un elemento de marcado que se utilizará en sustitución del número de página si la etiqueta es desconocida.
1691 El motivo de que se necesite un medidor es que en el momento en que se
1692 están interpretando los marcados, los saltos de página aún no se han
1693 producido y por tanto los números de página no se conocen todavía.
1694 Para sortear este inconveniente, la interpretación real del marcado se
1695 retrasa hasta un momento posterior; sin embargo, las dimensiones del
1696 marcado se tienen que conocer de antemano, así que se usa el medidor
1697 para decidir estas dimensiones. Si el libro tiene entre 10 y 99
1698 páginas, el medidor puede ser "00", es decir, un número de dos
1709 @node Índice general
1710 @subsection Índice general
1711 @translationof Table of contents
1713 Se puede insertar un índice general o tabla de contenidos utilizando
1714 la instrucción @code{\markuplist \table-of-contents}. Los elementos
1715 que deben aparecer en la tabla de contenidos se introducen con la
1716 instrucción @code{\tocItem}, que se puede usar en el nivel más alto de
1717 la jerarquía del código, o dentro de una expresión musical.
1720 \markuplist \table-of-contents
1723 \tocItem \markup "Primera partitura"
1727 \tocItem \markup "Un punto concreto dentro de la primera partitura"
1732 \tocItem \markup "Segunda partitura"
1740 Los elementos de marcado que se usan para dar formato al índice
1741 general se encuentran definidos dentro del bloque @code{\paper}. Los
1742 elementos predeterminados son @code{tocTitleMarkup}, para dar formato
1743 al título de la tabla, y @code{tocItemMarkup}, para aplicar formato a
1744 los elementos del índice, que consisten en el título del elemento y el
1745 número de página. Estas variables se pueden cambiar por parte del
1750 %% Traducir el título del índice al español:
1751 tocTitleMarkup = \markup \huge \column {
1752 \fill-line { \null "Índice general" \null }
1755 %% usar una fuente mayor
1756 tocItemMarkup = \markup \large \fill-line {
1757 \fromproperty #'toc:text \fromproperty #'toc:page
1762 Observe la forma en que nos referimos al texto y al número de página
1763 del elemento de índice, dentro de la definición @code{tocItemMarkup}.
1765 También se pueden definir nuevas instrucciones y elementos de
1766 marcado para crear índices generales más elaborados:
1768 @item en primer lugar, defina una variable de marcado nueva dentro del bloque @code{\paper}
1769 @item luego defina una función de música cuyo propósito es añadir un elemento al índice general
1770 utilizando esta variable de marcado del bloque @code{\paper}.
1773 En el ejemplo siguiente se define un estilo nuevo para introducir los
1774 nombres de los actos de una ópera en el índice general:
1778 tocActMarkup = \markup \large \column {
1780 \fill-line { \null \italic \fromproperty #'toc:text \null }
1786 #(define-music-function (parser location text) (markup?)
1787 (add-toc-item! 'tocActMarkup text))
1790 @lilypond[line-width=10.0\cm]
1791 \header { tagline = ##f }
1793 tocActMarkup = \markup \large \column {
1795 \fill-line { \null \italic \fromproperty #'toc:text \null }
1801 #(define-music-function (parser location text) (markup?)
1802 (add-toc-item! 'tocActMarkup text))
1805 \markuplist \table-of-contents
1806 \tocAct \markup { Atto Primo }
1807 \tocItem \markup { Coro. Viva il nostro Alcide }
1808 \tocItem \markup { Cesare. Presti omai l'Egizzia terra }
1809 \tocAct \markup { Atto Secondo }
1810 \tocItem \markup { Sinfonia }
1811 \tocItem \markup { Cleopatra. V'adoro, pupille, saette d'Amore }
1816 Se pueden añadir puntos de relleno entre un elemento y su número de página:
1818 @lilypond[verbatim,line-width=10.0\cm]
1819 \header { tagline = ##f }
1821 tocItemMarkup = \tocItemWithDotsMarkup
1825 \markuplist \table-of-contents
1826 \tocItem \markup { Allegro }
1827 \tocItem \markup { Largo }
1834 @file{ly/toc-init.ly}.
1837 @funindex \table-of-contents
1838 @code{\table-of-contents},
1844 @node Trabajar sobre los archivos de entrada
1845 @section Trabajar sobre los archivos de entrada
1846 @translationof Working with input files
1849 * Inclusión de archivos de LilyPond::
1850 * Distintas ediciones a partir de una misma fuente::
1851 * Caracteres especiales::
1855 @node Inclusión de archivos de LilyPond
1856 @subsection Inclusión de archivos de LilyPond
1857 @translationof Including LilyPond files
1860 @cindex including files
1862 Un proyecto grande se puede dividir en varios archivos. Para
1863 referirse a otro archivo, utilice
1866 \include "otroarchivo.ly"
1869 La línea @code{\include "otroarchivo.ly"} equivale a pegar todo el
1870 contenido de @file{otroarchivo.ly} en el archivo actual en el lugar en
1871 que aparece el @code{\include}. Por ejemplo, en un proyecto grande
1872 podríamos querer archivos distintos para cada parte instrumental y
1873 crear un archivo de @qq{partitura completa} que reúne los archivos
1874 individuales de los instrumentos. Normalmente el archivo incluido
1875 define un cierto número de variables que a partir de entonces quedan
1876 disponibles para poderlas utilizar en el archivo de la partitura
1877 completa. En los archivos incluidos se pueden marcar las secciones
1878 etiquetadas para ayudar a hacerlas utilizables en distintos lugares de
1879 la partitura, véase @ref{Distintas ediciones a partir de una misma fuente}.
1881 Los archivos que están en el directorio de trabajo actual se pueden
1882 referenciar simplemente especificando el nombre después de la
1883 instrucción @code{\include}. Los archivos en otros lugares se pueden
1884 incluir proporcionando una referencia de ruta completa o una ruta
1885 relativa (pero utilice la barra inclinada normal del UNIX, /, no la
1886 barra invertida de DOS/Windows, \, como separador de directorio). Por
1887 ejemplo, si @file{material.ly} está situado un directorio por encima
1888 del directorio de trabajo actual, utilice
1891 \include "../material.ly"
1895 o si los archivos de las partes orquestales incluidas están todos
1896 situados en un subdirectorio llamado @file{partes} dentro del
1897 directorio actual, use
1900 \include "partes/VI.ly"
1901 \include "partes/VII.ly"
1905 Los archivos de inclusión también pueden contener enunciados
1906 @code{\include} a su vez. De forma predeterminada, estos enunciados
1907 @code{\include} de segundo nivel no se interpretan hasta que se
1908 incorporan al archivo principal, por lo que los nombres de archivo que
1909 especifican deben ser relativos al directorio que contiene el archivo
1910 principal, no al directorio que contiene el archivo incluido. Sin
1911 embargo, este comportamiento se puede modificar globalmente pasando la
1912 opción @option{-drelative-includes} en la línea de órdenes (o mediante
1913 la adición de @code{#(ly:set-option 'relative-includes #t)} al
1914 principio del archivo principal de entrada).
1916 Cuando @code{relative-includes} está establecido al valor @code{#t},
1917 la ruta de cada instrucción @code{\include} se considera relativa al
1918 archivo que contiene dicha instrucción. Este comportamiento es el
1919 recomendado y se convertirá en el comportamiento predeterminado en una
1920 versión futura de lilypond.
1922 Tanto los archivos relativos al directorio principal como los archivos
1923 relativos a algún otro directorio se pueden @code{\include}ar mediante
1924 el establecimiento de @code{relative-includes} al valor @code{#t} o a
1925 @code{#f} en los lugares apropiados dentro de los archivos. Por
1926 ejemplo, si se ha creado una biblioteca genérica, libA, que a su vez
1927 utiliza sub-archivos que se @code{\include}an por medio del archivo de
1928 entrada de dicha biblioteca, esas instrucciones @code{\include}
1929 tendrán que venir precedidas por @code{#(ly:set-option
1930 #relative-includes #t)} de manera que se interpreten correctamente al
1931 construir el archivo de entrada @code{.ly} principal, de esta forma:
1942 entonces el archivo de entrada, @code{libA.ly}, contiene
1945 #(ly:set-option 'relative-includes #t)
1949 % vuelta al ajuste predeterminado
1950 #(ly:set-option 'relative-includes #f)
1953 Cualquier archivo @file{.ly} puede entonces incluir la biblioteca
1954 completa, simplemente con
1957 \include "~/libA/libA.ly"
1960 Se pueden usar estructuras de archivo más complejas instando los
1961 cambios en los lugares adecuados.
1963 También se pueden incluir archivos de un directorio que está en una
1964 ruta de búsqueda especificada como opción al invocar a LilyPond desde
1965 la línea de órdenes. Los archivos incluidos se especifican usando
1966 solamente su nombre de archivo. Por ejemplo, para compilar mediante
1967 este método un archivo @file{principal.ly} que incluye archivos
1968 situados en un subdirectorio llamado @file{partes}, cambie al
1969 directorio que contiene @file{principal.ly} e introduzca
1972 lilypond --include=partes principal.ly
1975 y en @file{principal.ly} escriba
1983 Los archivos que se incluyen en muchas partituras se pueden poner en
1984 el directorio de LilyPond @file{../ly} (la localización de este
1985 directorio depende de la instalación: véase
1986 @rlearning{Otras fuentes de información}). Estos archivos se pueden
1987 incluir sencillamente por su nombre en un enunciado @code{\include}.
1988 De esta forma se incluyen los archivos dependientes del idioma como
1991 LilyPond incluye de forma predeterminada ciertos archivos cuando se
1992 inicia el programa. Estas inclusiones no son visibles para el
1993 usuario, pero los archivos se pueden identificar ejecutando
1994 @code{lilypond --verbose} desde la línea de órdenes. Esto presentará
1995 una lista de rutas y archivos que utiliza LilyPond, junto a muchas
1996 otras indicaciones. De forma alternativa, pueden verse explicaciones
1997 sobre los archivos más importantes de este conjunto en
1998 @rlearning{Otras fuentes de información}. Estos archivos se pueden
1999 editar, pero los cambios realizados sobre ellos se perderán al
2000 instalar una nueva versión de LilyPond.
2002 Pueden verse ejemplos sencillos sobre el uso de @code{\include} en
2003 @rlearning{Partituras y particellas}.
2006 Manual de aprendizaje:
2007 @rlearning{Otras fuentes de información},
2008 @rlearning{Partituras y particellas}.
2011 Si un archivo incluido recibe un nombre igual al de uno de los
2012 archivos de instalación de LilyPond, el archivo que tiene prioridad es
2013 el de los archivos de instalación de LilyPond.
2016 @node Distintas ediciones a partir de una misma fuente
2017 @subsection Distintas ediciones a partir de una misma fuente
2018 @translationof Different editions from one source
2020 Se pueden usar varios métodos para generar la producción de distintas
2021 versiones de una partitura a partir de la misma fuente musical. Las
2022 variables son quizá el más útil para combinar secciones extensas de
2023 música y/o anotaciones. Las etiquetas son más útiles para seleccionar
2024 una sección de entre varias secciones de música alternativas, más
2025 cortas, y se pueden usar también para dividir piezas de música en
2028 Cualquiera que sea el método utilizado, la separación de la notación
2029 de la estructura de la partitura hará que sea más fácil cambiar la
2030 estructura dejando intacta la notación.
2033 * Uso de las variables::
2034 * Uso de etiquetas::
2035 * Uso de ajustes globales::
2038 @node Uso de las variables
2039 @unnumberedsubsubsec Uso de las variables
2040 @translationof Using variables
2042 @cindex variables, uso de las
2044 Si las secciones de la música se definen dentro de variables, se
2045 pueden reutilizar en distintas partes de la partitura, véase
2046 @rlearning{Organizar las piezas mediante variables}. Por ejemplo, una
2047 partitura vocal @notation{a cappella} con frecuencia incluye una
2048 reducción de piano de las partes para ensayar que es idéntica a la
2049 música vocal, por lo que ésta sólo se tiene que escribir una vez. Se
2050 puede combinar sobre un solo pentagrama la música de dos variables,
2051 véase @ref{Combinación automática de las partes}. He aquí un ejemplo:
2053 @lilypond[verbatim,quote]
2054 sopranoMusic = \relative c'' { a4 b c b8( a) }
2055 altoMusic = \relative g' { e4 e e f }
2056 tenorMusic = \relative c' { c4 b e d8( c) }
2057 bassMusic = \relative c' { a4 gis a d, }
2058 allLyrics = \lyricmode {King of glo -- ry }
2060 \new Staff = "Soprano" \sopranoMusic
2061 \new Lyrics \allLyrics
2062 \new Staff = "Alto" \altoMusic
2063 \new Lyrics \allLyrics
2064 \new Staff = "Tenor" {
2068 \new Lyrics \allLyrics
2069 \new Staff = "Bass" {
2073 \new Lyrics \allLyrics
2076 \set Staff.printPartCombineTexts = ##f
2082 \set Staff.printPartCombineTexts = ##f
2092 Se pueden producir partituras distintas que presenten sólo las partes
2093 vocales o sólo la parte de piano, cambiando solamente los enunciados
2094 estructurales, sin modificar la notación musical.
2096 Para partituras extensas, las definiciones de variable se pueden poner
2097 en archivos separados que se incluyen más tarde, véase @ref{Inclusión de archivos de LilyPond}.
2100 @node Uso de etiquetas
2101 @unnumberedsubsubsec Uso de etiquetas
2102 @translationof Using tags
2105 @funindex \keepWithTag
2106 @funindex \removeWithTag
2107 @funindex \pushToTag
2108 @funindex \appendToTag
2110 @cindex mantener música etiquetada
2111 @cindex quitar música etiquetada
2112 @cindex división en música etiquetada
2114 La instrucción @code{\tag #'@var{parteA}} marca una expresión musical
2115 con el nombre @var{parteA}. Las expresiones etiquetadas de esta
2116 manera se pueden seleccionar o filtrar más tarde por su nombre, usando
2117 bien @code{\keepWithTag #'@var{nombre}} o bien @code{\removeWithTag
2118 #'@var{nombre}}. El resultado de la aplicación de estos filtros a la
2119 música etiquetada es como sigue:
2121 @multitable @columnfractions .5 .5
2125 Música etiquetada precedida de @code{\keepWithTag #'@var{nombre}}
2127 Se incluye la música no etiquetada y la música etiquetada con
2128 @var{nombre}; se excluye la música etiquetada con cualquier otro
2131 Música etiquetada precedida de @code{\removeWithTag #'@var{nombre}}
2133 Se incluye la música no etiquetada y la música etiquetada con
2134 cualquier nombre de etiqueta distinto a @var{nombre}; se excluye la
2135 música etiquetada con @var{nombre}.
2137 Música etiquetada no precedida de @code{\keepWithTag} ni de
2138 @code{\removeWithTag}
2139 @tab Se incluye toda la música etiquetada y no etiquetada.
2142 Los argumentos de las instrucciones @code{\tag}, @code{\keepWithTag} y
2143 @code{\removeWithTag} deben ser un símbolo (como @code{#'partitura} o
2144 @code{#'parte}), seguido de una expresión musical.
2146 En el ejemplo siguiente vemos dos versiones de una pieza musical, una
2147 que muestra trinos con la notación usual y otra con los trinos
2148 expandidos explícitamente:
2150 @lilypond[verbatim,quote]
2151 music = \relative g' {
2153 \tag #'trills { d8.\trill }
2154 \tag #'expand { \repeat unfold 3 { e32 d } }
2159 \keepWithTag #'trills \music
2162 \keepWithTag #'expand \music
2167 De forma alternativa, a veces es más fácil excluir secciones de música:
2169 @lilypond[verbatim,quote]
2170 music = \relative g' {
2172 \tag #'trills { d8.\trill }
2173 \tag #'expand {\repeat unfold 3 { e32 d } }
2178 \removeWithTag #'expand
2182 \removeWithTag #'trills
2187 El filtrado con etiquetas se puede aplicar a articulaciones, textos,
2191 -\tag #'@var{mi-etiqueta}
2194 a una articulación. Por ejemplo, esto define una nota con una
2195 indicación opcional de digitación y una nota con una anotación
2200 c1-\tag #'warn ^"¡Ojo!"
2203 Se pueden poner varias etiquetas sobre expresiones con varias entradas
2206 @lilypond[quote,verbatim]
2207 music = \relative c'' {
2208 \tag #'a \tag #'both { a4 a a a }
2209 \tag #'b \tag #'both { b4 b b b }
2212 \keepWithTag #'a \music
2213 \keepWithTag #'b \music
2214 \keepWithTag #'both \music
2218 Se pueden aplicar varios filtros @code{\removeWithTag} a una sola
2219 expresión musical para quitar varias secciones etiquetadas con nombres
2222 @lilypond[verbatim,quote]
2223 music = \relative c'' {
2224 \tag #'A { a4 a a a }
2225 \tag #'B { b4 b b b }
2226 \tag #'C { c4 c c c }
2227 \tag #'D { d4 d d d }
2236 Dos o más filtros @code{\keepWithTag} aplicados a una sola expresión
2237 musical producen la eliminación de @emph{todas} las secciones
2238 etiquetadas, porque el primer filtro quita todas las secciones
2239 etiquetadas excepto la que se nombra, y el segundo filtro elimina
2240 incluso esa sección etiquetada.
2242 A vecespodemos desear dividir la música en un determinado lugar dentro
2243 de una expresión musical existente. Podemos usar @code{\pushToTag} y
2244 @code{\appendToTag} para añadir material delante o al final de los
2245 @code{elements} de una construcción musical existente. No toda
2246 construcción musical tiene la parte @code{elements}, pero las músicas
2247 secuenciaes y simultáneas son dos apuestas seguras:
2249 @lilypond[verbatim,quote]
2250 test = { \tag #'here { \tag #'here <<c''>> } }
2253 \pushToTag #'here c'
2254 \pushToTag #'here e'
2255 \pushToTag #'here g' \test
2256 \appendToTag #'here c'
2257 \appendToTag #'here e'
2258 \appendToTag #'here g' \test
2262 Las dos instrucciones admiten una etiqueta, el material que dividir en
2263 cada ocurrencia de la etiqueta, y la expresión etiquetada. Las
2264 instrucciones aseguran que se copia todo lo que cambian, de forma que
2265 el código original @code{\test} retiene su significado.
2268 Manual de aprendizaje:
2269 @rlearning{Organizar las piezas mediante variables}.
2271 Referencia de la notación:
2272 @ref{Combinación automática de las partes},
2273 @ref{Inclusión de archivos de LilyPond}.
2276 @c This warning is more general than this placement implies.
2277 @c Rests are not merged whether or not they come from tagged sections.
2278 @c Should be deleted? -td
2281 Multiple rests are not merged if you create a score with more
2282 than one tagged section at the same place.
2286 @node Uso de ajustes globales
2287 @unnumberedsubsubsec Uso de ajustes globales
2288 @translationof Using global settings
2290 @cindex include-settings
2292 Se pueden incluir ajustes globales a partir de un archivo distinto:
2295 lilypond -dinclude-settings=MIS_AJUSTES.ly MI_PARTITURA.ly
2298 En archivos diferentes se pueden almacenar grupos de ajustes como
2299 el tamaño de la página o las fuentes tipográficas. Ello permite
2300 hacer diferentes ediciones de la mism a partitura así como aplicar
2301 ajustes estándar a muchas partituras, simplemente por medio de la
2302 especificación del archivo de ajustes adecuado.
2304 Esta técnica también funciona bien con el uso de hojas de estilo,
2305 como se estudia en @rlearning{Hojas de estilo}.
2308 Manual de aprendizaje:
2309 @rlearning{Organizar las piezas mediante variables},
2310 @rlearning{Hojas de estilo}.
2312 Referencia de la notación:
2313 @ref{Inclusión de archivos de LilyPond}.
2316 @node Caracteres especiales
2317 @subsection Caracteres especiales
2318 @translationof Special characters
2320 @cindex caracteres especiales
2321 @cindex caracteres no ASCII
2324 * Codificación del texto::
2330 @node Codificación del texto
2331 @unnumberedsubsubsec Codificación del texto
2332 @translationof Text encoding
2336 LilyPond usa el conjunto de caracteres definido por el consorcio
2337 Unicode y la norma ISO/IEC 10646. Define un nombre único y un código
2338 para los conjuntos de caracteres que se utilizan en prácticamente
2339 todos los idiomas modernos y también en muchos otros. Unicode se
2340 puede implementar utilizando varios esquemas de codificación
2341 distintos. LilyPond usa la codificación UTF-8 (UTF son las siglas de
2342 @emph{Unicode Transformation Format}, o formato de transformación de
2343 Unicode) que representa todos los caracteres comunes de Latin en un
2344 solo byte, y representa otros caracteres usando un formato de longitud
2345 variable de hasta cuatro bytes.
2347 El aspecto visual real de los caracteres viene determinado por los
2348 glifos que se definen en las fuentes tipográficas concretas que se
2349 tengan disponibles: una fuente tipográfica define la asignación de un
2350 subconjunto de los códigos de Unicode a glifos. LilyPond usa la
2351 biblioteca Pango para representar y disponer tipográficamente textos
2354 LilyPond no realiza ninguna conversión en la codificación de la
2355 entrada. Esto significa que cualquier text, ya sea el título, la
2356 letra de la canción o una instrucción musical que contenga caracteres
2357 distintos a los del conjunto ASCII, se deben codificar en UTF-8. La
2358 forma más fácil de escribir dicho texto es utilizar un editor
2359 preparado para Unicode y guardar el archivo con la codificación UTF-8.
2360 Casi todos los editores modernos populares contemplan el UTF-8, por
2361 ejemplo lo hacen vim, Emacs, jEdit, y GEdit. Todos los sistemas MS
2362 Windows posteriores a NT usan Unicode como codificación de caracteres
2363 nativa, de manera que incluso el accesorio Bloc de Notas (Notepad)
2364 puede editar y guardar un archivo en el formato UTF-8. Una
2365 alternativa más funcional para Windows es BabelPad.
2367 Si un archivo de entrada que contiene un carácter que no es ASCII, no
2368 se guarda en el formato UTF-8, se genera el mensaje de error
2371 FT_Get_Glyph_Name () error: argumento inválido
2374 He aquí un ejemplo que muestra texto cirílico, hebreo y portugués:
2377 %c No verbatim here as the code does not display correctly in PDF
2379 bulgarian = \lyricmode {
2380 Жълтата дюля беше щастлива, че пухът, който цъфна, замръзна като гьон.
2384 hebrew = \lyricmode {
2385 זה כיף סתם לשמוע איך תנצח קרפד עץ טוב בגן.
2389 portuguese = \lyricmode {
2390 à vo -- cê uma can -- ção legal
2396 \addlyrics { \bulgarian }
2397 \addlyrics { \hebrew }
2398 \addlyrics { \portuguese }
2403 @unnumberedsubsubsec Unicode
2404 @translationof Unicode
2408 Para introducir un carácter aislado para el que se conoce el punto de
2409 código Unicode pero no está disponible en el editor que se está
2410 usando, use @code{\char ##xhhhh} o bien @code{\char #dddd} dentro de
2411 un bloque @code{\markup}, donde @code{hhhh} es el código hexadecimal
2412 del carácter en cuestión y @code{dddd} es su valor decimal
2413 correspondiente. Pueden omitirse los ceros iniciales, pero es
2414 costumbre indicar los cuatro caracteres en la representación
2415 hexadecimal (observe que @emph{no} debe utilizarse la codificación
2416 UTF-8 del punto de código Unicode después de @code{\char}, pues la
2417 codificación UTF-8 contiene bits adicionales que indican el número de
2418 octetos). Hay tablas de códigos Unicode y un índice de nombres de
2419 caracteres que da el punto de código en hexadecimal para cualquier
2420 carácter en el portal del Consorcio Unicode,
2421 @uref{http://www.unicode.org/}.
2423 Por ejemplo, tanto @code{\char ##x03BE} como @code{\char #958}
2424 insertan el carácter Unicode U+03BE, que tiene el nombre Unicode
2425 @qq{Letra griega Xi pequeña}.
2427 Se puede escribir de esta forma cualquier punto de código Unicode, y
2428 si todos los caracteres especiales se escriben en este formato no es
2429 necesario guardar el archivo de entrada en formato UTF-8. Por
2430 supuesto, debe estar instalada y estar disponible para LilyPond una
2431 fuente tipográfica que contenga codificados todos estos caracteres.
2433 El ejemplo siguiente muestra valores hexadecimales Unicode que se usan
2434 en cuatro lugares: en una llamada de ensayo, como texto de
2435 articulación, en la letra y como texto independiente bajo la
2438 @lilypond[quote,verbatim]
2441 c1 \mark \markup { \char ##x03EE }
2442 c1_\markup { \tiny { \char ##x03B1 " to " \char ##x03C9 } }
2444 \addlyrics { O \markup { \concat { Ph \char ##x0153 be! } } }
2446 \markup { "Copyright 2008--2012" \char ##x00A9 }
2449 @cindex copyright, símbolo de
2451 Para escribir el símbolo de copyright en la nota de créditos, utilice:
2455 copyright = \markup @{ \char ##x00A9 "2008" @}
2460 @node Alias de ASCII
2461 @unnumberedsubsubsec Alias de ASCII
2462 @translationof ASCII aliases
2464 Se puede incluir una lista de alias de ASCII para caracteres
2467 @lilypond[quote,verbatim]
2469 #(include-special-characters)
2472 \markup "&flqq; – &OE;uvre incomplète… &frqq;"
2475 \new Staff { \repeat unfold 9 a'4 }
2477 This is al -- so wor -- kin'~in ly -- rics: –_&OE;…
2482 "The replacement can be disabled:"
2483 "– &OE; …"
2484 \override #'(replacement-alist . ()) "– &OE; …"
2488 También podemos hacer nuestros propios alias, ya sea de forma global:
2490 @lilypond[quote,verbatim]
2492 #(add-text-replacements!
2493 '(("100" . "hundred")
2494 ("dpi" . "dots per inch")))
2496 \markup "A 100 dpi."
2501 @lilypond[quote,verbatim]
2502 \markup \replace #'(("100" . "hundred")
2503 ("dpi" . "dots per inch")) "A 100 dpi."
2507 Referencia de la notación:
2508 @ref{Lista de caracteres especiales}.
2510 Archivos instalados:
2511 @file{ly/text-replacements.ly}.
2514 @node Controlar la salida
2515 @section Controlar la salida
2516 @translationof Controlling output
2519 * Extracción de fragmentos de música::
2520 * Saltar la música corregida::
2521 * Formatos de salida alternativos::
2522 * Sustituir la tipografía de la notación::
2526 @node Extracción de fragmentos de música
2527 @subsection Extracción de fragmentos de música
2528 @translationof Extracting fragments of music
2530 Es posible citar pequeños fragmentos de una partitura grande
2531 directamente a partir de la salida. Puede compararse con la
2532 separación de una pieza de una partitura, recortándola con tijeras.
2534 Esto se hace definiendo los compases que se deben recortar. Por
2535 ejemplo, la inclusión de la siguiente definición
2542 (make-rhythmic-location 5 1 2)
2543 (make-rhythmic-location 7 3 4)))
2548 extrae un fragmento empezando por la mitad del quinto compás y
2549 finalizando en el séptimo compás. El significado de @code{5 1 2} es:
2550 después de una blanca (1/2) en el compás 5, y el de @code{7 3 4}
2551 después de tres negras del compás 7.
2553 Se pueden definir más zonas de recorte añadiendo más parejas de
2554 definición de tiempo rhythmic-location a la lista.
2556 Para poder utilizar esta funcionalidad, LilyPond se debe invocar con
2557 la opción @option{-dclip-systems}. Los recortes aparecen en la salida
2558 como archivos EPS, y se convierten en PDF y PNG si estos formatos
2559 también están activados.
2561 Para ver más información sobre los formatos de salida, consulte
2562 @rprogram{Invocar a LilyPond}.
2565 @node Saltar la música corregida
2566 @subsection Saltar la música corregida
2567 @translationof Skipping corrected music
2569 @funindex skipTypesetting
2570 @funindex showFirstLength
2571 @funindex showLastLength
2573 Al escribir o copiar música, normalmente sólo es interesante de ver y
2574 corregir la música cercana al final (donde estamos añadiendo las
2575 notas). Para acelerar este proceso de corrección, es posible saltar
2576 la composición tipográfica de todos excepto unos pocos de los últimos
2577 compases. Esto se consigue poniendo
2580 showLastLength = R1*5
2585 en nuestro archivo fuente. Esto hará que se tracen sólo los últimos
2586 cinco compases (suponiendo un compás de 4/4) de cada una de las
2587 partituras @code{\score} del archivo de entrada. Para piezas largas,
2588 el tipografiado de únicamente una parte pequeña es con frecuencia un
2589 orden de magnitud más rápido que el de la obra completa. Si estamos
2590 trabajando sobre el principio de una partitura que ya hemos
2591 tipografiado (p.ej., para añadir una parte instrumental nueva),
2592 también puede ser útil la propiedad @code{showFirstLength}.
2594 Este mecanismo de pasar por alto partes de un partitura se puede
2595 controlar con un grano más fino mediante la propiedad
2596 @code{Score.skipTypesetting}. Cuando su valor está establecido, no se
2597 lleva a cabo ningún tipografiado en absoluto.
2599 Esta propiedad se usa también para controlar la salida al archivo
2600 MIDI. Observe que pasa por alto todos los eventos, incluidos el tempo
2601 y los cambios de instrumento. Está usted advertido.
2603 @lilypond[quote,relative=2,ragged-right,verbatim]
2605 \set Score.skipTypesetting = ##t
2607 \set Score.skipTypesetting = ##f
2611 En música polifónica, @code{Score.skipTypesetting} afecta a todas las
2612 voces y pentagramas, ahorrando más tiempo incluso.
2615 @node Formatos de salida alternativos
2616 @subsection Formatos de salida alternativos
2617 @translationof Alternative output formats
2619 @cindex salida de gráficos de vector escalables
2621 @cindex salida de PostScript encapsulado
2623 @cindex PostScript encapsulado, salida de
2625 Los formatos de salida predeterminados para la partitura impresa son
2626 el formato de documento portátil (PDF) y PostScript (PS). Los
2627 formatos de salida Gráficos de vector escalables (SVG), PostScript
2628 encapsulado (EPS) y Gráficos de red portátiles (PNG) también están
2629 disponibles a través de opciones de la línea de órdenes, véase
2630 @rprogram{Opciones básicas de la línea de órdenes para LilyPond}.
2633 @node Sustituir la tipografía de la notación
2634 @subsection Sustituir la tipografía de la notación
2635 @translationof Replacing the notation font
2637 Gonville es una alternativa a la tipografía Feta que se utiliza en
2638 LilyPond y se puede descargar de:
2640 @uref{http://www.chiark.greenend.org.uk/~sgtatham/gonville/ ,http://www.chiark.greenend.org.uk/~sgtatham/gonville/}
2643 Aquí presentamos algunos compases de muestra tipografiados con la
2646 @c NOTE: these images are a bit big, but that's important
2647 @c for the font comparison. -gp
2648 @sourceimage{Gonville_after,,,}
2650 Aquí hay unos compases de muestra tipografiados en la fuente Feta de
2653 @sourceimage{Gonville_before,,,}
2655 @subsubheading Instrucciones de instalación para MacOS
2657 Descargue y extraiga el archivo zip. Copie la carpeta @code{lilyfonts}
2658 a @file{@var{SHARE_DIR}/lilypond/current}; para más información,
2659 consulte @rlearning{Otras fuentes de información}. Renombre la carpeta
2660 @code{fonts} existente a @code{fonts_orig} y la carpeta
2661 @code{lilyfonts} a @code{fonts}. Para volver a la fuente Feta,
2662 invierta el proceso.
2665 Manual de aprendizaje:
2666 @rlearning{Otras fuentes de información}.
2670 Gonville no se puede usar para tipografiar notación de @q{Música
2671 Antigua} y es probable que cualquier nuevo glifo en versiones
2672 posteriores de LilyPond no existan en la familia
2673 tipográfica Gonville. Diríjase a la página web del autor para obtener más
2674 información sobre éste y otros asuntos, entre ellos el régimen de
2675 licencias de Gonville.
2679 @section Salida MIDI
2680 @translationof MIDI output
2685 El MIDI (Musical Instrument Digital Interface, Interfase Digital para
2686 Instrumentos Musicales) es un estándar para interconectar y controlar
2687 instrumentos musicales electrónicos. Un archivo o secuencia MIDI es
2688 una serie de notas dentro de un conjunto de pistas. No es un archivo
2689 de sonidos reales; se necesita un programa reproductor especial para
2690 traducir la serie de notas en sonidos de verdad.
2692 Cualquier música se puede convertir a archivos MIDI, de manera que
2693 podamos escuchar lo que hayamos introducido. Esto es muy conveniente
2694 para comprobar la corrección de la música; las octavas equivocadas o
2695 las alteraciones erróneas se ponen de relieve muy claramente al
2696 escuchar la salida MIDI.
2698 La salida estándar de MIDI es un poco primitiva; de forma opcional, se
2699 encuentra disponible una salida MIDI mejorada y mucho más realista,
2700 por medio de @ref{El script Articulate}.
2702 La salida MIDI reserva un canal por cada pentagrama, y reserva
2703 el canal 10 para la percusión. Sólo hay 16 canales MIDI por cada
2704 dispositivo, por lo que si la partitura tiene más de 15 pautas, los
2705 canales MIDI se reutilizarán.
2708 * Crear archivos MIDI::
2710 * ¿Qué sale por el MIDI?::
2711 * Repeticiones y MIDI::
2712 * Control de los matices en el MIDI::
2713 * Percusión en MIDI::
2714 * El script Articulate::
2718 @node Crear archivos MIDI
2719 @subsection Crear archivos MIDI
2720 @translationof Creating MIDI files
2722 Para crear un MIDI a partir de una pieza de música, escriba un bloque
2723 @code{\midi} en la partitura, por ejemplo:
2732 Si hay un bloque @code{\midi} dentro de un @code{\score} que no tenga
2733 ningún bloque @code{\layout}, solamente se producirá MIDI. Si se
2734 necesita una notación impresa, debe haber también un bloque
2745 Se traducen correctamente a la salida MIDI la altura y duración de las
2746 notas, las ligaduras de unión, matices y cambios de tempo. Las
2747 indicaciones dinámicas, crescendi y decrescendi se traducen a niveles
2748 de volumen MIDI. Las marcas dinámicas se traducen a una fracción fija
2749 del rango de volumen MIDI disponible. Los crescendi y decrescendi
2750 hacen que el volumen varía linealmente entre sus dos extremos. El
2751 efecto de las indicaciones dinámicas sobre la salida MIDI se puede
2752 eliminar por completo, véase @ref{El bloque MIDI}.
2754 El tempo inicial y los cambios de tempo posteriores se pueden
2755 especificar utilizando la instrucción @code{\tempo} dentro de la
2756 propia notación musical. Se reflejan en cambios de tempo en la salida
2757 MIDI. Esta instrucción normalmente hace que se imprima la indicación
2758 metronómica, pero esto se puede eliminar, véase @ref{Indicaciones metronómicas}.
2759 Más abajo se describe una forma alternativa de especificar el tempo
2760 MIDI inicial o global, véase @ref{El bloque MIDI}.
2762 Debido a ciertas limitaciones de Windows, la extensión predeterminada
2763 para los archivos MIDI en Windows es @code{.mid}. Otros sistemas
2764 operativos utilizan la extensión @code{.midi}. Si prefiere una
2765 extensión diferente, inserte la siguiente línea en el nivel jerárquico
2766 superior del archivo de entrada, antes del inicio de cualquier bloque
2767 @code{\book}, @code{\bookpart} o @code{\score}:
2770 #(ly:set-option 'midi-extension "midi")
2773 La línea anterior establece la extensión predeterminada para los
2774 archivos MIDI a @code{.midi}.
2776 De forma alternativa, esta opción se puede también proporcionar en la
2780 lilypond … -dmidi-extension=midi archivoLily.ly
2784 @unnumberedsubsubsec Nombres de instrumentos
2786 @cindex instrumento, nombres de
2787 @funindex Staff.midiInstrument
2789 El nombre del instrumento MIDI se establece mediante la propiedad
2790 @code{Staff.midiInstrument}. El nombre del instrumento se debe elegir
2791 de entre los que están en la lista que aparece en @ref{Instrumentos MIDI}.
2795 \set Staff.midiInstrument = #"glockenspiel"
2801 \new Staff \with @{midiInstrument = #"cello"@} @{
2806 Si el instrumento elegido no coincide exactamente con uno de los
2807 instrumentos de la lista de instrumentos MIDI, se usará el instrumento
2808 Piano de Cola (@code{"acoustic grand"}).
2812 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
2813 {changing-midi-output-to-one-channel-per-voice.ly}
2817 @c In 2.11 the following no longer seems to be a problem -td
2819 Unterminated (de)crescendos will not render properly in the midi file,
2820 resulting in silent passages of music. The workaround is to explicitly
2821 terminate the (de)crescendo. For example,
2828 will not work properly but
2831 @{ a4\< b c d\!\f @}
2838 Los cambios del volumen MIDI sólo tienen lugar al principio de la
2839 nota, por lo que los crescendi y decrescendi no pueden afectar al
2840 volumen de una sola nota.
2842 No todos los reproductores de MIDI manejar adecuadamente los cambios de
2843 tempo de la salida MIDI. Entre los reproductores que se sabe que
2844 funcionan se encuentran el Reproductor de Medios de MS Windows y
2845 @uref{http://@/timidity@/.sourceforge@/.net/,timidity}.
2848 @node El bloque MIDI
2849 @subsection El bloque MIDI
2850 @translationof MIDI block
2854 Si se requiere una salida MIDI, debe aparecer un bloque @code{\midi}
2855 dentro de un bloque de partitura. Es análogo al bloque layout de
2856 diseño de página, pero algo más simple. Con frecuencia, el bloque
2857 @code{\midi} se deja vacío, pero puede contener reorganizaciones de
2858 contextos, definiciones de contexto nuevas o código para fijar valores
2859 de propiedades. Por ejemplo, en el ejemplo siguiente se establece el
2860 tempo inicial exportado al archivo MIDI sin hacer que se imprima una
2861 indicación de tempo:
2872 En este ejemplo, el tempo se establece a 72 pulsos de negra por
2873 minuto. @code{\tempo} is actually a music command for
2874 setting properties during the interpretation of music: in the
2875 context of output definitions like a @code{\midi} block, as a matter of
2876 courtesy those are reinterpreted as if they were context modifications.
2878 @cindex MIDI, definiciones de contexto
2880 Las definiciones de contexto siguen con precisión la misma sintaxis
2881 que la de un bloque @code{\layout}. Los módulos de traducción para el
2882 sonido reciben el nombre de ejecutantes. Los contextos para la salida
2883 MIDI se definen en @file{../ly/performer-init.ly}, véase
2884 @rlearning{Otras fuentes de información}. Por ejemplo, para eliminar
2885 el efecto de los matices de la salida MIDI, inserte las líneas
2886 siguientes en el bloque @code{\midi@{ @}}.
2893 \remove "Dynamic_performer"
2898 La salida MIDI se crea sólo cuando se incluye un bloque @code{\midi}
2899 dentro de un bloque de partitura definido con una instrucción
2904 @{ @dots{}notas@dots{} @}
2910 @node ¿Qué sale por el MIDI?
2911 @subsection ¿Qué sale por el MIDI?
2912 @translationof What goes into the MIDI output?
2914 @unnumberedsubsubsec Contemplado en el MIDI
2916 @cindex alturas en MIDI
2917 @cindex MIDI, alturas
2918 @cindex cuartos de tono en MIDI
2919 @cindex MIDI, cuartos de tono
2920 @cindex microtonos en MIDI
2921 @cindex MIDI, microtonos
2922 @cindex acordes, nombres de, en MIDI
2923 @cindex MIDI, nombres de
2924 @cindex duraciones en MIDI
2925 @cindex MIDI, duraciones
2926 @cindex Articlulate, scripts
2927 @cindex MIDI, articulaciones
2928 @cindex articulaciones en MIDI
2929 @cindex trinos en MIDI
2930 @cindex grupetos en MIDI
2931 @cindex rallentando en MIDI
2932 @cindex accelerando en MIDI
2935 Los siguientes elementos de notación se reflejan en la salida MIDI:
2939 @item Microtonos (véase @ref{Alteraciones accidentales}. La reproducción necesita un reproductor que contemple la curvatura de tono o @emph{pitch bend}.)
2940 @item Acordes escritos como nombres de acorde
2941 @item Ritmos escritos como duraciones de las notas, incluidos los grupos de valoración especial
2942 @item Trémolos escritos sin @q{@code{:}[@var{número}]}
2943 @item Ligaduras de unión
2944 @item Matices o indicaciones de dinámica
2945 @item Crescendi y decrescendi sobre varias notas
2946 @item Cambios de tempo insertados con una marca metronómica
2947 @item Letra de las canciones
2950 Utilizando @ref{El script Articulate}, a la lista anterior se añaden
2951 una serie de elementos:
2954 @item Articulaciones (ligaduras de expresión, picados, etc)
2955 @item Trinos, mordentes circulares
2956 @item Rallentando y accelerando
2960 @unnumberedsubsubsec No contemplado en el MIDI
2962 @c TODO index as above
2964 Los siguientes elementos de notación no tienen ningún efecto sobre la
2965 salida MIDI, a no ser que utilicemos @ref{El script Articulate}:
2968 @item Duraciones escritas como anotaciones, p.ej. el swing
2969 @item Cambios de tempo escritos como anotaciones sin marca de tempo
2970 @item Staccato y otras articulaciones y ornamentos
2971 @item Ligaduras de expresión y de fraseo
2972 @item Crescendi y decrescendi sobre una nota única
2973 @item Trémolos introducidos con @q{@code{:}[@var{número}]}
2975 @item Acordes microtonales
2979 @node Repeticiones y MIDI
2980 @subsection Repeticiones y MIDI
2981 @translationof Repeats in MIDI
2983 @cindex repeticiones, expandir
2984 @funindex \unfoldRepeats
2986 Con un poco de trucaje, se puede hacer que cualquier tipo de
2987 repetición esté presente en la salida MIDI. Esto se consigue mediante
2988 la aplicación de la función musical @code{\unfoldRepeats}. Esta
2989 función cambia todas las repeticiones a repeticiones desplegadas.
2991 @lilypond[quote,verbatim]
2993 \repeat tremolo 8 { c'32 e' }
2994 \repeat percent 2 { c''8 d'' }
2995 \repeat volta 2 { c'4 d' e' f' }
3004 En partituras con varias voces, el desplegado de las repeticiones en
3005 la salida MIDI solo se produce correctamente si @emph{todas y cada
3006 una} de las voces incluye las repeticiones de manera completa y
3009 Al crear un archivo de partitura que use @code{\unfoldRepeats} para el
3010 MIDI, es necesario hacer dos bloques @code{\score}: uno para el MIDI
3011 (con repeticiones desplegadas) y otro para la notación impresa (con
3012 repeticiones de volta --primera y segunda vez--, tremolo --trémolo--,
3013 y percent --repetición de compases--). Por ejemplo,
3021 \unfoldRepeats @var{..música..}
3027 @node Control de los matices en el MIDI
3028 @subsection Control de los matices en el MIDI
3029 @translationof Controlling MIDI dynamics
3031 La dinámica en el MIDI está implementada por medio del intérprete
3032 Dynamic_performer que reside de forma predeterminada dentro del
3033 contexto Voice. Es posible controlar el volumen MIDI general, el
3034 volumen relativo de los matices dinámicos y el volumen relativo de los
3035 distintos instrumentos.
3037 @unnumberedsubsubsec Indicaciones dinámicas
3039 Los matices o indicaciones de dinámica se traducen a una fracción fija
3040 del rango de volumen MIDI disponible. Las fracciones predeterminadas
3041 se extienden desde 0.25 para @notation{ppppp} hasta 0.95 para
3042 @notation{fffff}. El conjunto de indicaciones dinámicas y las
3043 fracciones asociadas pueden verse en @file{../scm/midi.scm}, véase
3044 @rlearning{Otras fuentes de información}. Este conjunto de fracciones
3045 se puede cambiar o extender proporcionando una función que toma como
3046 argumento una indicación dinámica y devuelve la fracción requerida, y
3047 estableciendo @code{Score.dynamicAbsoluteVolumeFunction} a esta
3050 Por ejemplo, si se requiere una indicación dinámica
3051 @notation{rinforzando}, @code{\rfz}, ésta no tiene ningún efecto
3052 predeterminado sobre el volumen MIDI, pues no está incluida en el
3053 conjunto predeterminado. De igual manera, si se define una indicación
3054 dinámica nueva con @code{make-dynamic-script}, ésta tampoco estará
3055 incluida en el conjunto predeterminado. El ejemplo siguiente muestra
3056 cómo hay que añadir el volumen MIDI para estas indicaciones dinámicas.
3057 La función Scheme establece la fracción a 0.9 si se encuentra una
3058 indicación dinámica rfz, y en caso contrario llama a la función
3061 @lilypond[verbatim,quote]
3062 #(define (myDynamics dynamic)
3063 (if (equal? dynamic "rfz")
3065 (default-dynamic-absolute-volume dynamic)))
3069 \set Staff.midiInstrument = #"cello"
3070 \set Score.dynamicAbsoluteVolumeFunction = #myDynamics
3082 Como alternativa, si se necesitara redefinir la tabla completa de
3083 fracciones, sería mejor usar el procedimiento
3084 @notation{default-dynamic-absolute-volume} que aparece en
3085 @file{../scm/midi.scm} y la tabla asociada como modelo. El último
3086 ejemplo de esta sección muestra cómo se puede hacer esto.
3088 @unnumberedsubsubsec Volumen maestro MIDI
3090 El volumen general máximo y mínimo de las indicaciones dinámicas de
3091 MIDI se controla estableciendo valores para las propiedades
3092 @code{midiMinimumVolume} y @code{midiMaximumVolume} en el nivel de
3093 @code{Score}. Estas propiedades tienen efecto solamente sobre las
3094 indicaciones dinámicas, por ello si queremos que tengan validez desde
3095 el comienzo de la partitura, se debe colocar allí una indicación de
3096 dinámica. La fracción que corresponde a cada indicación dinámica se
3097 modifica con esta fórmula:
3100 midiMinimumVolume + (midiMaximumVolume - midiMinimumVolume) * fracción
3103 En el ejemplo siguiente, el rango de intensidad dinámica del volumen
3104 general MIDI está limitado al intervalo desde 0.2 hasta 0.5.
3106 @lilypond[verbatim,quote]
3112 \set Staff.midiInstrument = #"flute"
3113 \new Voice \relative c''' {
3121 \set Staff.midiInstrument = #"clarinet"
3122 \new Voice \relative c'' {
3134 midiMinimumVolume = #0.2
3135 midiMaximumVolume = #0.5
3141 @unnumberedsubsubsec Balance entre instrumentos (i)
3143 Si las propiedades de volumen MIDI máximo y mínimo están establecidas
3144 en el contexto @code{Staff} se pueden controlar los volúmenes
3145 relativos de los instrumentos MIDI. Esto proporciona un ecualizador
3146 de instrumentos básico que puede realzar significativamente la calidad
3149 En este ejemplo se reduce el volumen del clarinete con relación al de
3150 la flauta. Debe haber una indicación dinámica en la primera nota de
3151 cada instrumento para que esto funcione correctamente.
3153 @lilypond[verbatim,quote]
3159 \set Staff.midiInstrument = #"flute"
3160 \set Staff.midiMinimumVolume = #0.7
3161 \set Staff.midiMaximumVolume = #0.9
3162 \new Voice \relative c''' {
3170 \set Staff.midiInstrument = #"clarinet"
3171 \set Staff.midiMinimumVolume = #0.3
3172 \set Staff.midiMaximumVolume = #0.6
3173 \new Voice \relative c'' {
3187 @unnumberedsubsubsec Balance entre instrumentos (ii)
3189 Si las propiedades de volumen MIDI máximo y mínimo no están
3190 establecidas, de forma predeterminada LilyPond aplica un pequeño grado
3191 de ecualización a algunos instrumentos. Los instrumentos y la
3192 ecualización que se aplica se muestra en la tabla
3193 @notation{instrument-equalizer-alist} en @file{../scm/midi.scm}.
3195 El ecualizador básico predeterminado se puede sustituir estableciendo
3196 @code{instrumentEqualizer} en el contexto @code{Score} a un
3197 procedimiento Scheme nuevo que acepte el nombre de un instrumento MIDI
3198 como único argumento y devuelva un par de fracciones que dan los
3199 volúmenes máximo y mínimo que se aplican a dicho instrumento. Esta
3200 sustitución se hace de la misma forma que mostramos para restablecer
3201 la fracción de volumen absoluto @code{dynamicAbsoluteVolumeFunction}
3202 al comienzo de esta sección. El ecualizador predeterminado,
3203 @notation{default-instrument-equalizer}, en
3204 @file{../scm/midi.scm}, muestra cómo se puede escribir tal
3207 El ejemplo siguiente establece los volúmenes relativos de la flauta y
3208 del clarinete a los mismos valores que el ejemplo anterior.
3210 @lilypond[verbatim,quote]
3211 #(define my-instrument-equalizer-alist '())
3213 #(set! my-instrument-equalizer-alist
3216 ("flute" . (0.7 . 0.9))
3217 ("clarinet" . (0.3 . 0.6)))
3218 my-instrument-equalizer-alist))
3220 #(define (my-instrument-equalizer s)
3221 (let ((entry (assoc s my-instrument-equalizer-alist)))
3230 \set Score.instrumentEqualizer = #my-instrument-equalizer
3231 \set Staff.midiInstrument = #"flute"
3232 \new Voice \relative c''' {
3240 \set Staff.midiInstrument = #"clarinet"
3241 \new Voice \relative c'' {
3256 @c Delete when satisfied this is adequately covered elsewhere -td
3258 @n ode Microtones in MIDI
3259 @s ubsection Microtones in MIDI
3261 @cindex microtones in MIDI
3263 Microtones consisting of half sharps and half flats are exported
3264 to the MIDI file and render correctly in MIDI players which support
3265 pitch bending. See @ref{Nombres de las notas en otros idiomas}. Here is
3266 an example showing all the half sharps and half flats. It can be
3267 copied out and compiled to test microtones in your MIDI player.
3269 @lilypond[verbatim,quote]
3286 @node Percusión en MIDI
3287 @subsection Percusión en MIDI
3288 @translationof Percussion in MIDI
3290 La notación de los instrumentos de percusión se realiza normalmente en
3291 un contexto @code{DrumStaff} y cuando se hace de esta forma se les da
3292 salida correctamente por el canal MIDI@tie{}10, pero ciertos
3293 instrumentos de percusión de altura determinada, como el xilófono,
3294 marimba, vibráfono, timbales, etc., se tratan como instrumentos
3295 @qq{normales} y la música para estos instrumentos se debe introducir
3296 en contextos de @code{Staff} normales, no en un contexto
3297 @code{DrumStaff}, para obtener la salida MIDI correcta.
3299 Ciertos sonidos de altura indeterminada que están incluidos en el
3300 estándar General MIDI, como el tom melódico, el tambor taiko, los
3301 tambores sintéticos, etc., no se pueden acceder a través del canal
3302 MIDI@tie{}10, por lo que la notación para dichos instrumentos se debe
3303 introducir también en un contexto normal de @code{Staff}, utilizando
3304 las alturas normales adecuadas.
3306 Muchos instrumentos de percusión no están incluidos dentro del
3307 estándar General MIDI, p.ej. las castañuelas. El método más
3308 fácil (aunque no satisfactorio) de producir una salida MIDI al
3309 escribir para estos instrumentos es sustituirlos por el sonido más
3310 parecido del conjunto estándar.
3312 @c TODO Expand with examples, and any other issues
3316 Debido a que el estándar General MIDI no contiene golpes de aro
3317 (@emph{rim shots}), para este propósito se utiliza en su lugar el
3318 golpe lateral de baqueta (@emph{sidestick}).
3321 @node El script Articulate
3322 @subsection El script Articulate
3323 @translationof The Articulate script
3325 Es posible obtener una salida MIDI más real si se utiliza el script
3326 Articulate. Éste trata de tener en cuenta las articulaciones
3327 (ligaduras de expresión, picados, etc), mediante la sustitución de las
3328 notas con secuencias musicales de silencios y notas escaladas en el
3329 tiempo de forma apropiada. También trata de desplegar los trinos,
3330 grupetos circulares, etc. y responder a las indicaciones de
3331 rallentando y accelerando.
3333 Para utilizar el script Articulate, tenemos que incluirlo al principio
3334 de nuestro archivo de entrada:
3337 \include "articulate.ly"
3340 y en la sección @code{\score}, hacer lo siguiente:
3343 \unfoldRepeats \articulate <<
3344 resto de la partitura...
3348 Después de alterar el código de entrada de esta manera el resultado
3349 visual se altera profundamente, pero el bloque @code{\midi} estándar
3350 produce un archivo MIDI mejorado.
3352 Si bien no es esencial para que funcione el script Articulate, podemos
3353 insertar la instrucción @code{\unfoldRepeats} según aparece en el
3354 ejemplo anterior, dado que habilita la ejecución de abreviaturas tales
3355 como los @notation{trinos}.
3359 Articulate acorta los acordes, y ciertos fragmentos de música
3360 (especialmente la música de órgano) es posible que suene peor.
3363 @node Extraer información musical
3364 @section Extraer información musical
3365 @translationof Extracting musical information
3367 Además de crear un resultado visual y MIDI,
3368 LilyPond es capaz de presentar información
3369 musical en forma de texto.
3372 * Impresión del código de notación de LilyPond::
3373 * Impresión de las expresiones musicales de Scheme::
3374 * Guardar los eventos musicales en un archivo::
3378 @node Impresión del código de notación de LilyPond
3379 @subsection Displaying LilyPond notation
3380 @translationof Displaying LilyPond notation
3382 @funindex \displayLilyMusic
3383 La impresión textual de una expresión musical en notación de LilyPond
3384 puede hacerse con la función musical @code{\displayLilyMusic}.
3385 Para ver el resultado, lo más usual es llamar a LilyPond
3386 mediante la línea de órdenes. Por ejemplo,
3390 \displayLilyMusic \transpose c a, @{ c4 e g a bes @}
3394 imprime lo siguiente:
3397 @{ a,4 cis e fis g @}
3400 De forma predeterminada, LilyPond imprime estos mensajes en la consola
3401 junto al resto de los mensajes de la compilación de LilyPond.
3402 Para discernir entre estos mensajes y
3403 guardar el resultado de @code{\display@{MATERIAL@}}, redireccione la
3404 salida hacia un archivo.
3407 lilypond archivo.ly >resultado.txt
3411 @node Impresión de las expresiones musicales de Scheme
3412 @subsection Impresión de las expresiones musicales de Scheme
3413 @translationof Displaying scheme music expressions
3415 Véase @rextend{Presentación de las expresiones musicales}.
3418 @node Guardar los eventos musicales en un archivo
3419 @subsection Guardar los eventos musicales en un archivo
3420 @translationof Saving music events to a file
3422 Los eventos musicales se pueden guardar en un archivo pentagrama a
3423 pentagrama mediante la inclusión de un archivo en nuestra partitura
3427 \include "event-listener.ly"
3430 De esta forma se crean uno o más archivos llamados
3431 @file{FILENAME-STAFFNAME.notes} ó @file{FILENAME-unnamed-staff.notes}
3432 para cada pentagrama. Observe que si tiene más de un pentagrama sin
3433 nombre, los eventos de todos los pentagramas se mezclarán entre sí
3434 dentro del mismo archivo. El resultado tiene el aspecto siguiente:
3437 0.000 note 57 4 p-c 2 12
3439 0.250 note 62 4 p-c 7 12
3440 0.500 note 66 8 p-c 9 12
3441 0.625 note 69 8 p-c 14 12
3446 La sintaxis consiste en una línea delimitada por caracteres de
3447 tabulación, con dos campos fijos en cada línea seguidos de parámetros
3451 @var{tiempo} @var{tipo} @var{...parámetros...}
3454 Esta información se puede leer fácilmente por parte de otros programas
3455 como guiones de Python, y pueden ser muy útiles para aquellos
3456 investigadores que desean realizar un análisis musical o hacer
3457 experimientos de reproducción con LilyPond.
3460 No todos los eventos musicales de lilypond están contemplados por
3461 @file{event-listener.ly}. Se pretende que sea una @qq{prueba de
3462 concepto} bien realizada. Si algunos eventos que quiere ver no
3463 aparecen incluidos, copie @file{event-listener.ly} en su carpeta de
3464 lilypond y modifique el archivo de forma que produzca la información