1 u@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
4 Translation of GIT committish: 9f651e1f5143787aeda825a4061f82eede4943a3
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. For details, see the Contributors'
8 Guide, node Updating translation committishes..
13 @node Entrada y salida generales
14 @chapter Entrada y salida generales
15 @translationof General input and output
17 Esta sección trata de asuntos relacionados con la entrada y salida
18 generales de LilyPond, más que con la notación específica.
21 * Estructura del código de entrada::
22 * Títulos y cabeceras::
23 * Trabajar sobre los archivos de entrada::
24 * Controlar la salida::
29 @node Estructura del código de entrada
30 @section Estructura del código de entrada
31 @translationof Input structure
33 El formato principal de entrada para LilyPond son archivos de texto.
34 Por convenio, el nombre de estos archivos termina en @file{.ly}.
37 * Estructura de una partitura::
38 * Varias partituras en un libro::
39 * Varios archivos de salida a partir de uno de entrada::
40 * Nombres de los archivos de salida::
41 * Estructura del archivo::
45 @node Estructura de una partitura
46 @subsection Estructura de una partitura
47 @translationof Structure of a score
51 Un bloque @code{\score} debe contener una expresión musical única
52 delimitada por un par de llaves:
61 @warning{Sólo puede haber @strong{una} expresión musical dentro del
62 bloque @code{\score}, y @strong{debe} estar encerrada entre llaves.}
64 Esta expresión musical única puede tener cualquier tamaño, y puede
65 contener otras expresiones musicales hasta cualquier grado de
66 complejidad. Todos los siguientes ejemplos son expresiones musicales:
72 @lilypond[verbatim,quote]
79 @lilypond[verbatim,quote]
81 \new Staff { c'4 c' c' c' }
82 \new Staff { d'4 d' d' d' }
90 \new Staff @{ \flute @}
91 \new Staff @{ \oboe @}
94 \new Staff @{ \violinI @}
95 \new Staff @{ \violinII @}
101 Los comentarios son una excepción a esta regla general (para ver otras
102 excepciones, consulte @ref{Estructura del archivo}). Tanto los comentarios de
103 una línea como los que están delimitados por @code{%@{ .. %@}} se
104 pueden escribir en cualquier lugar dentro del archivo de entrada. Se
105 pueden escribir dentro o fuera del bloque @code{\score}, y dentro o
106 fuera de la expresión musical única dentro del bloque @code{\score}.
108 Recuerde que incluso dentro de un archivo que contenga solamente un
109 bloque @code{\score}, éste se encuentra incluido implícitamente dentro
110 de un bloque @code{\book}. Un bloque @code{\book} dentro de un
111 archivo fuente produce al menos un archivo de salida, y de forma
112 predeterminada el nombre del archivo de salida que se produce está
113 derivado del nombre del archivo de entrada, de forma que
114 @file{fandangoforelephants.ly} da como resultado
115 @file{fandangoforelephants.pdf}.
117 (Para ver más detalles acerca de los bloques @code{\book}, consulte
118 @ref{Varias partituras en un libro}, @ref{Varios archivos de salida a
119 partir de uno de entrada} y @ref{Estructura del archivo}.)
122 Manual de aprendizaje:
123 @rlearning{Trabajar sobre los archivos de entrada},
124 @rlearning{Explicación de las expresiones musicales},
125 @rlearning{La partitura es una (única) expresión musical compuesta}.
128 @node Varias partituras en un libro
129 @subsection Varias partituras en un libro
130 @translationof Multiple scores in a book
133 @cindex movimientos, varios
135 Un documento puede contener varias piezas de música y texto. Son
136 ejemplos un libro de estudios o una parte orquestal con varios
137 movimientos. Cada movimiento se introduce con un bloque
146 y los textos se introducen con un bloque @code{\markup}:
156 Todos los movimientos y textos que aparecen en el mismo archivo
157 @file{.ly} se tipografían normalmente en la forma de un solo archivo
172 Una excepción importante se da dentro de los documentos de
173 lilypond-book, en los que tenemos que escribir explícitamente un
174 bloque @code{\book}, pues en caso contrario sólo aparecerá en la
175 salida el primer @code{\score} o @code{\markup}.
177 El encabezamiento de cada pieza se puede poner dentro del bloque
178 @code{\score}. Antes de cada movimiento, se imprime el nombre de la
179 pieza (@code{piece}) extraído del encabezamiento. El título del libro
180 entero se puede poner dentro del bloque @code{\book}, pero si no está
181 presente se inserta el encabezamiento @code{\header} que está al
182 principio del archivo.
186 title = "Ocho miniaturas"
187 composer = "Igor Stravinsky"
191 \header @{ piece = "Romanze" @}
194 ..texto de la segunda estrofa..
197 ..texto de la tercera estrofa..
201 \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"
232 @node Varios archivos de salida a partir de uno de entrada
233 @subsection Varios archivos de salida a partir de uno de entrada
234 @translationof Multiple output files from one input file
236 Si queremos varios archivos de salida a partir del mismo archivo
237 @file{.ly}, podemos escribir varios bloques @code{\book}, donde cada
238 uno de estos bloques @code{\book} dará como resultado un archivo de
239 salida distinto. Si no especificamos ningún bloque @code{\book} en el
240 archivo, LilyPond trata implícitamente todo el archivo como un solo
241 bloque @code{\book}, véase @ref{Estructura del archivo}.
243 Al producir varios archivos a partir de un solo archivo fuente,
244 Lilypond se asegura de que ninguno de los archivos de salida de ningún
245 bloque @code{\book} sobreescribe el archivo de salida producido por un
246 @code{\book} anterior del mismo archivo de entrada.
248 Lo hace añadiendo un sufijo al nombre de la salida para cada libro
249 @code{\book} que utiliza el nombre del archivo de salida
250 predeterminado, derivado del archivo fuente de entrada.
252 El comportamiento predeterminado es añadir un sufijo con el número de
253 versión para cada nombre que pueda coincidir; así:
258 \layout @{ @dots{} @}
262 \layout @{ @dots{} @}
266 \layout @{ @dots{} @}
270 en el archivo fuente @file{eightminiatures.ly}, produce
274 @file{eightminiatures.pdf},
276 @file{eightminiatures-1.pdf} y
278 @file{eightminiatures-2.pdf}.
281 @node Nombres de los archivos de salida
282 @subsection Nombres de los archivos de salida
283 @translationof Output file names
285 @funindex \bookOutputSuffix
286 @funindex \bookOutputName
288 Lilypond le ofrece unos mecanismos que le permiten controlar los
289 nombres de archivo que se utilizan por parte de los diversos motores
290 finales al producir los archivos de salida.
292 En la sección anterior vimos cómo Lilypond evita las coincidencias de
293 nombres al producir varias salidas a partir de un único archivo fuente
294 de entrada. También podemos especificar nuestros propios sufijos para
295 cada bloque @code{\book}, de manera que podemos producir, por ejemplo,
296 archivos con los nombres @file{eightminiatures-Romanze.pdf},
297 @file{eightminiatures-Menuetto.pdf} y
298 @file{eightminiatures-Nocturne.pdf} añadiendo una declaración
299 @code{\bookOutputSuffix} dentro de cada bloque @code{\book}.
303 \bookOutputSuffix "Romanze"
305 \layout @{ @dots{} @}
308 \bookOutputSuffix "Menuetto"
310 \layout @{ @dots{} @}
313 \bookOutputSuffix "Nocturne"
315 \layout @{ @dots{} @}
319 También podemos especificar un nombre de archivo de salida diferente
320 para cada bloque @code{book}, mediante la utilización de declaraciones
321 @code{\bookOutputName}:
325 \bookOutputName "Romanze"
327 \layout @{ @dots{} @}
330 \bookOutputName "Menuetto"
332 \layout @{ @dots{} @}
335 \bookOutputName "Nocturne"
337 \layout @{ @dots{} @}
341 El código anterior produce los siguientes archivos de salida:
347 @file{Menuetto.pdf} y
352 @node Estructura del archivo
353 @subsection Estructura del archivo
354 @translationof File structure
364 Un archivo @file{.ly} puede contener cualquier número de expresiones
365 del nivel superior, donde una expresión del nivel superior es una de
366 las siguientes posibilidades:
370 Una definición de salida, como @code{\paper}, @code{\midi} y
371 @code{\layout}. Tal definición en el nivel más alto cambia los
372 ajustes predeterminados para todo el libro. Si se introduce más de
373 una de estas definiciones del mismo tipo en el nivel más alto,
374 cualquier definición en una expresión posterior tiene prioridad.
377 Una expresión directa de Scheme, como
378 @code{#(set-default-paper-size "a7" 'landscape)} o
379 @code{#(ly:set-option 'point-and-click #f)}.
382 Un bloque @code{\header}. Esto establece el bloque de encabezamiento
383 global. Es el bloque que contiene las definiciones de los ajustes
384 para todo el libro, como el compositor, título, etc.
387 Un bloque @code{\score}. Esta partitura se reúne con otras partituras
388 del nivel superior, y se combina con ellas formando un @code{\book}
389 (libro) único. Este comportamiento se puede cambiar estableciendo el
390 valor de la variable @code{toplevel-score-handler} en el nivel
391 superior. El @emph{handler} predeterminado se define en el archivo de
392 inicio @file{../scm/lily.scm}.
395 Un bloque @code{\book} combina lógicamente varios movimientos (es
396 decir, varios bloques @code{\score}) en un solo documento. Si hay
397 varias partituras @code{\score}, se crea un solo archivo de salida
398 para cada bloque @code{\book}, en el que se concatenan todos los
399 movimientos correspondientes. La única razón para especificar
400 explícitamente bloques @code{\book} en un archivo de entrada
401 @file{.ly} es si queremos crear varios archivos de salida a partir de
402 un único archivo de entrada. Una excepción se da dentro de los
403 documentos de lilypond-book, en los que tenemos que escribir
404 explícitamente un bloque @code{\book} si queremos tener más de una
405 única partitura @code{\score} o marcado @code{\markup} en el mismo
406 ejemplo. Se puede cambiar este comportamiento estableciendo el valor
407 de la variable @code{toplevel-book-handler} en el nivel superior. El
408 @emph{handler} predeterminado se define en el archivo de inicio
409 @file{../scm/lily.scm}.
412 Un bloque @code{\bookpart}. Un libro puede dividirse en varias
413 partes, utilizando bloques @code{\bookpart}, con objeto de facilitar
414 la inserción de saltos de página o usar distintos ajustes de
415 @code{\paper} en las distintas partes.
418 Una expresión musical compuesta, como
423 Esto añade la pieza al @code{\score} y la conforma dentro de un libro
424 único junto a todas las demás partituras @code{\score} y expresiones
425 musicales del nivel superior. En otras palabras, un archivo que
426 contiene sólo la expresión musical anterior se traduce a
442 Se puede cambiar este comportamiento estableciendo el valor de la
443 variable @code{toplevel-music-handler} en el nivel más alto. El
444 @emph{handler} predeterminado se define en el archivo de inicio
445 @file{../scm/lily.scm}.
448 Un texto de marcado, por ejemplo una estrofa
451 2. Estrofa dos, línea uno
455 Los textos de marcado se colocan encima, en medio o debajo de las
456 partituras o expresiones musicales, según donde aparezcan escritos.
463 fulano = @{ c4 d e d @}
466 Esto se puede utilizar más tarde en el archivo escribiendo
467 @code{\fulano}. El nombre de las variables ha de ser exclusivamente
468 alfabético; sin números, guiones ni barras bajas.
472 El ejemplo siguiente muestra tres cosas que se pueden introducir en el
477 % No justificar la salida
488 En cualquier punto del archivo se pueden introducir cualquiera de las
489 instrucciones léxicas siguientes:
492 @item @code{\version}
493 @item @code{\include}
494 @item @code{\sourcefilename}
495 @item @code{\sourcefileline}
497 Un comentario de una línea, determinado por un símbolo @code{%} al principio.
500 Un comentario de varias líneas, delimitado por @code{%@{ .. %@}}.
504 @cindex espacios en blanco
506 Por lo general se ignoran los espacios entre elementos del flujo de
507 entrada, y se pueden omitir o aumentar tranquilamente para mejorar la
508 legibilidad. Sin embargo, los espacios se deben utilizar siempre para
509 evitar errores, en las siguientes situaciones:
512 @item Alrededor de todas y cada una de las llaves curvas de apertura y cierre.
513 @item A continuación de las instrucciones y variables, es decir, todos los elementos
514 que comienzan con un signo @code{\} de barra invertida.
515 @item A continuación de todo elemento que se deba interpretar como expresión
516 de Scheme, es decir, todo elemento que comience por un signo @code{#}.
517 @item Para separar los elementos de una expresión de Scheme.
518 @item Dentro de @code{lyricmode} para separar todos los términos de las instrucciones
519 @code{\override} y @code{\set}. Concretamente, hay que usar espacios
520 alrededor del punto y el signo igual en instrucciones como
521 @code{\override Score . LyricText #'font-size = #5} y antes y después
522 de la instrucción completa.
527 Manual de aprendizaje:
528 @rlearning{Cómo funcionan los archivos de entrada de LilyPond}.
531 @node Títulos y cabeceras
532 @section Títulos y cabeceras
533 @translationof Titles and headers
535 Casi toda la música impresa tiene un título y el nombre del
536 compositor; ciertas piezas tienen mucha más información.
540 * Encabezamientos pies y títulos personalizados::
541 * Referencias a números de página::
547 @subsection Crear títulos
548 @translationof Creating titles
550 Se crean títulos para cada uno de los bloques @code{\score} así como
551 para todo el archivo de entrada (o bloque @code{\book}, libro) y las
552 partes de libro (creadas mediante bloques @code{\bookpart}).
554 El contenido de cada título se extrae a partir de los bloques
555 @code{\header} (cabecera). El bloque de cabecera de un libro
556 contempla lo siguiente:
559 @funindex dedicatoria
561 El dedicatario de la música, centrado en lo alto de la primera página.
565 El título de la música, centrado justo debajo de la
570 Subtítulo, centrado debajo del título.
572 @funindex subsubtitle
574 Sub-subtítulo, centrado debajo del subtítulo.
578 Nombre del poeta, a la izquierda, debajo del subtítulo.
582 Nombre del compositor, a la derecha, debajo del subtítulo.
586 Texto de la medida, a la izquierda, debajo del poeta.
590 Nombre del Opus, a la derecha, debajo del compositor.
594 Nombre del arreglista, a la derecha, debajo del Opus.
598 Nombre del instrumento, centrado, debajo del arreglista. También
599 aparece centrado en lo alto de cada página (aparte de la primera).
603 Nombre de la pieza, a la izquierda, debajo del instrumento.
605 @cindex página, saltos, forzar
606 @funindex breakbefore
608 Esto fuerza que el título comience sobre una página nueva (establézcalo a ##t o a ##f).
612 Aviso de Copyright, centrado en la parte inferior de la primera
613 página. Para insertar el símbolo de copyright, consulte
614 @ref{Codificación del texto}.
618 Cartel de propósito general en el pie de página, centrado al final de la última.
622 A continuación presentamos una demostración de todos los campos que
623 están disponibles. Fíjese en que puede utilizar en la cabecera
624 cualquier instrucción de marcado de texto (Véase @ref{Formatear el texto}).
626 @lilypond[quote,verbatim,line-width=11.0\cm]
629 paper-height = 10.0\cm
634 dedication = "dedicated to me"
635 title = \markup \center-column { "Title first line" "Title second line,
637 subtitle = "the subtitle,"
638 subsubtitle = #(string-append "subsubtitle LilyPond version "
641 composer = \markup \center-column { "composer" \small "(1847-1973)" }
642 texttranslator = "Text Translator"
643 meter = \markup { \teeny "m" \tiny "e" \normalsize "t" \large "e" \huge
645 arranger = \markup { \fontsize #8.5 "a" \fontsize #2.5 "r" \fontsize
646 #-2.5 "r" \fontsize #-5.3 "a" \fontsize #7.5 "nger" }
647 instrument = \markup \bold \italic "instrument"
671 Como se mostró anteriormente, puede usar varios bloques
672 @code{\header}. Cuando los mismos campos aparecen en distintos
673 bloques, tiene validez el último en definirse. A continuación un
678 composer = "Compositor"
686 piece = "Otra pieza" % sobreescribe a la anterior
691 Si define la cabecera @code{\header} dentro del bloque @code{\score},
692 por lo general se imprimirán solamente las cabeceras @code{piece} y
693 @code{opus}. Fíjese en que la expresión musical debe aparecer antes
696 @lilypond[quote,verbatim,line-width=11.0\cm]
700 title = "title" % not printed
707 @funindex print-all-headers
709 Se puede cambiar este comportamiento (e imprimir todas las cabeceras
710 cuando la cabecera @code{\header} está definida dentro del bloque
711 @code{\score}) mediante la utilización de
715 print-all-headers = ##t
722 El pie de página por omisión se encuentra vacío, excepto para la
723 primera página, en la que se inserta el campo de @code{copyright}
724 extraído del @code{\header}, y para la última página, en la que se
725 escribe el cartel @code{tagline} sacado del bloque @code{\header}. La
726 línea por omisión para este cartel es @qq{Music engraving by LilyPond
727 (@var{version})}.@footnote{Las partituras bien tipografiadas son una
728 magnífica promoción para nosotros, así que por favor, si puede,
729 conserve intacta la línea del letrero.}
731 Las cabeceras se pueden quitar completamente estableciendo su valor a
742 @node Encabezamientos pies y títulos personalizados
743 @subsection Encabezamientos, pies y títulos personalizados
744 @translationof Custom headers footers and titles
746 Una opción más avanzada es cambiar las definiciones de las variables
747 siguientes dentro del bloque @code{\paper}. El archivo de inicio
748 @file{../ly/titling-init.ly} ofrece un listado de la
749 disposición predeterminada.
752 @funindex bookTitleMarkup
753 @item bookTitleMarkup
754 Es el título que se escribe en lo alto del documento de salida
755 completo. Normalmente contiene el compositor y el título de la pieza.
757 @funindex scoreTitleMarkup
758 @item scoreTitleMarkup
759 Es el título que se coloca por encima de un bloque @code{\score}.
760 normalmente contiene el nombre del movimiento (campo @code{piece}).
762 @funindex oddHeaderMarkup
763 @item oddHeaderMarkup
764 Es el encabezamiento de las páginas de numeración impar.
766 @funindex evenHeaderMarkup
767 @item evenHeaderMarkup
768 Es el encabezamiento de las páginas de numeración par. Si se deja
769 sin especificar, se usará el encabezamiento de las páginas impares.
771 De forma predeterminada, los encabezamientos se definen de tal forma
772 que el número de página está en el borde exterior, y el instrumento
775 @funindex oddFooterMarkup
776 @item oddFooterMarkup
777 Es el pie de las páginas de numeración impar.
779 @funindex evenFooterMarkup
780 @item evenFooterMarkup
781 Es el pie de las páginas de numeración par. Si se deja sin
782 especificar, se usará en su lugar el encabezamiento de las páginas
785 De forma predeterminada, el pie de página tiene el aviso de
786 copyright en la primera página, y el cartel @code{tagline} en la
792 @cindex encabezamiento
795 @cindex disposición de la página
798 La definición siguiente pone el título en el extremo izquierdo, y el
799 compositor en el extremo derecho sobre una única línea.
803 bookTitleMarkup = \markup @{
805 \fromproperty #'header:title
806 \fromproperty #'header:composer
812 El encabezamiento y el pie se crean por parte de las funciones
813 @code{make-header} y @code{make-footer}, definidas dentro de
814 @code{\paper}. Las implementaciones predeterminadas están en
815 @file{ly/paper-defaults-init.ly} y @file{ly/titling-init.ly}.
817 Este ejemplo centra los números de página en la parte de abajo de cada
822 print-page-number = ##t
823 print-first-page-number = ##t
824 oddHeaderMarkup = \markup \fill-line @{ " " @}
825 evenHeaderMarkup = \markup \fill-line @{ " " @}
826 oddFooterMarkup = \markup @{
829 \on-the-fly #print-page-number-check-first
830 \fromproperty #'page:page-number-string
833 evenFooterMarkup = \markup @{
836 \on-the-fly #print-page-number-check-first
837 \fromproperty #'page:page-number-string
844 @node Referencias a números de página
845 @subsection Referencias a números de página
846 @translationof Reference to page numbers
848 Se puede marcar un lugar determinado de una partitura utilizando la
849 instrucción @code{\label} (etiqueta), bien en lo alto de la estructura
850 o bien dentro de la música. Posteriormente se puede hacer referencia
851 a esta etiqueta dentro de un elemento de marcado, para obtener el
852 número de la página en que se encuentra la marca, usando la
853 instrucción de marcado @code{\page-ref}.
855 @lilypond[verbatim,line-width=11.0\cm]
856 \header { tagline = ##f }
862 \pageBreak \mark A \label #'markA
867 \markup { The first score begins on page \page-ref #'firstScore "0" "?" }
868 \markup { Mark A is on page \page-ref #'markA "0" "?" }
872 La instrucción de marcado @code{\page-ref} toma tres argumentos:
874 @item la etiqueta, un símbolo de scheme, p.ej. @code{#'firstScore};
875 @item un elemento de marcado que se usará como medidor para estimar las dimensiones del marcado;
876 @item un elemento de marcado que se utilizará en sustitución del número de página si la etiqueta es desconocida.
879 El motivo de que se necesite un medidor es que en el momento en que se
880 están interpretando los marcados, los saltos de página aún no se han
881 producido y por tanto los números de página no se conocen todavía.
882 Para sortear este inconveniente, la interpretación real del marcado se
883 retrasa hasta un momento posterior; sin embargo, las dimensiones del
884 marcado se tienen que conocer de antemano, así que se usa el medidor
885 para decidir estas dimensiones. Si el libro tiene entre 10 y 99
886 páginas, el medidor puede ser "00", es decir, un número de dos
899 @subsection Índice general
900 @translationof Table of contents
902 Se puede insertar un índice general o tabla de contenidos utilizando
903 la instrucción @code{\markuplines \table-of-contents}. Los elementos
904 que deben aparecer en la tabla de contenidos se introducen con la
905 instrucción @code{\tocItem}, que se puede usar en el nivel más alto de
906 la jerarquía del código, o dentro de una expresión musical.
909 \markuplines \table-of-contents
912 \tocItem \markup "Primera partitura"
916 \tocItem \markup "Un punto concreto dentro de la primera partitura"
921 \tocItem \markup "Segunda partitura"
929 Los elementos de marcado que se usan para dar formato al índice
930 general se encuentran definidos dentro del bloque @code{\paper}. Los
931 elementos predeterminados son @code{tocTitleMarkup}, para dar formato
932 al título de la tabla, y @code{tocItemMarkup}, para aplicar formato a
933 los elementos del índice, que consisten en el título del elemento y el
934 número de página. Estas variables se pueden cambiar por parte del
939 %% Traducir el título del índice al español:
940 tocTitleMarkup = \markup \huge \column {
941 \fill-line { \null "Índice general" \null }
944 %% usar una fuente mayor
945 tocItemMarkup = \markup \large \fill-line {
946 \fromproperty #'toc:text \fromproperty #'toc:page
951 Observe la forma en que nos referimos al texto y al número de página
952 del elemento de índice, dentro de la definición @code{tocItemMarkup}.
954 También se pueden definir nuevas instrucciones y elementos de
955 marcado para crear índices generales más elaborados:
957 @item en primer lugar, defina una variable de marcado nueva dentro del bloque @code{\paper}
958 @item luego defina una función de música cuyo propósito es añadir un elemento al índice general
959 utilizando esta variable de marcado del bloque @code{\paper}.
962 En el ejemplo siguiente se define un estilo nuevo para introducir los
963 nombres de los actos de una ópera en el índice general:
967 tocActMarkup = \markup \large \column {
969 \fill-line { \null \italic \fromproperty #'toc:text \null }
975 #(define-music-function (parser location text) (markup?)
976 (add-toc-item! 'tocActMarkup text))
979 @lilypond[line-width=11.0\cm]
980 \header { tagline = ##f }
982 tocActMarkup = \markup \large \column {
984 \fill-line { \null \italic \fromproperty #'toc:text \null }
990 #(define-music-function (parser location text) (markup?)
991 (add-toc-item! 'tocActMarkup text))
994 \markuplines \table-of-contents
995 \tocAct \markup { Atto Primo }
996 \tocItem \markup { Coro. Viva il nostro Alcide }
997 \tocItem \markup { Cesare. Presti omai l'Egizzia terra }
998 \tocAct \markup { Atto Secondo }
999 \tocItem \markup { Sinfonia }
1000 \tocItem \markup { Cleopatra. V'adoro, pupille, saette d'Amore }
1005 Se pueden añadir puntos de relleno entre un elemento y su número de página:
1007 @lilypond[verbatim,quote]
1008 \header { tagline = ##f }
1010 tocItemMarkup = \tocItemWithDotsMarkup
1014 \markuplines \table-of-contents
1015 \tocItem \markup { Allegro }
1016 \tocItem \markup { Largo }
1024 @file{../ly/toc-init.ly}.
1028 @funindex \table-of-contents
1029 @code{\table-of-contents},
1035 @node Trabajar sobre los archivos de entrada
1036 @section Trabajar sobre los archivos de entrada
1037 @translationof Working with input files
1040 * Inclusión de archivos de LilyPond::
1041 * Distintas ediciones a partir de una misma fuente::
1042 * Codificación del texto::
1043 * Presentar la notación de LilyPond::
1047 @node Inclusión de archivos de LilyPond
1048 @subsection Inclusión de archivos de LilyPond
1049 @translationof Including LilyPond files
1052 @cindex including files
1054 Un proyecto grande se puede dividir en varios archivos. Para
1055 referirse a otro archivo, utilice
1058 \include "otroarchivo.ly"
1061 La línea @code{\include "otroarchivo.ly"} equivale a pegar todo el
1062 contenido de @file{otroarchivo.ly} en el archivo actual en el lugar en
1063 que aparece el @code{\include}. Por ejemplo, en un proyecto grande
1064 podríamos querer archivos distintos para cada parte instrumental y
1065 crear un archivo de @qq{partitura completa} que reúne los archivos
1066 individuales de los instrumentos. Normalmente el archivo incluido
1067 define un cierto número de variables que a partir de entonces quedan
1068 disponibles para poderlas utilizar en el archivo de la partitura
1069 completa. En los archivos incluidos se pueden marcar las secciones
1070 etiquetadas para ayudar a hacerlas utilizables en distintos lugares de
1071 la partitura, véase @ref{Distintas ediciones a partir de una misma fuente}.
1073 Los archivos que están en el directorio de trabajo actual se pueden
1074 referenciar simplemente especificando el nombre después de la
1075 instrucción @code{\include}. Los archivos en otros lugares se pueden
1076 incluir proporcionando una referencia de ruta completa o una ruta
1077 relativa (pero utilice la barra inclinada normal del UNIX, /, no la
1078 barra invertida de DOS/Windows, \, como separador de directorio). Por
1079 ejemplo, si @file{material.ly} está situado un directorio por encima
1080 del directorio de trabajo actual, utilice
1083 \include "../material.ly"
1087 o si los archivos de las partes orquestales incluidas están todos
1088 situados en un subdirectorio llamado @file{partes} dentro del
1089 directorio actual, use
1092 \include "partes/VI.ly"
1093 \include "partes/VII.ly"
1097 Los archivos de inclusión también pueden contener enunciados
1098 @code{\include} a su vez. De forma predeterminada, estos enunciados
1099 @code{\include} de segundo nivel no se interpretan hasta que se
1100 incorporan al archivo principal, por lo que los nombres de archivo que
1101 especifican deben ser relativos al directorio que contiene el archivo
1102 principal, no al directorio que contiene el archivo incluido. Sin
1103 embargo, este comportamiento se puede modificar pasando la opción
1104 @code{-drelative-includes} en la línea de órdenes (o mediante la
1105 adición de @code{#(ly:set-option 'relative-includes #t)} al principio
1106 del archivo principal de entrada). Con el valor de
1107 @code{relative-includes} establecido, la ruta de cada instrucción
1108 @code{\include} se considera relativa al archivo que contiene dicha
1109 instrucción. Este comportamiento es el recomendado y se convertirá en
1110 el comportamiento predeterminado en una versión futura de lilypond.
1112 También se pueden incluir archivos de un directorio que está en una
1113 ruta de búsqueda especificada como opción al invocar a LilyPond desde
1114 la línea de órdenes. Los archivos incluidos se especifican usando
1115 solamente su nombre de archivo. Por ejemplo, para compilar mediante
1116 este método un archivo @file{principal.ly} que incluye archivos
1117 situados en un subdirectorio llamado @file{partes}, cambie al
1118 directorio que contiene @file{principal.ly} e introduzca
1121 lilypond --include=partes principal.ly
1124 y en @file{principal.ly} escriba
1132 Los archivos que se incluyen en muchas partituras se pueden poner en
1133 el directorio de LilyPond @file{../ly} (la localización de este
1134 directorio depende de la instalación: véase
1135 @rlearning{Otras fuentes de información}). Estos archivos se pueden
1136 incluir sencillamente por su nombre en un enunciado @code{\include}.
1137 De esta forma se incluyen los archivos dependientes del idioma como
1140 LilyPond incluye de forma predeterminada ciertos archivos cuando se
1141 inicia el programa. Estas inclusiones no son visibles para el
1142 usuario, pero los archivos se pueden identificar ejecutando
1143 @code{lilypond --verbose} desde la línea de órdenes. Esto presentará
1144 una lista de rutas y archivos que utiliza LilyPond, junto a muchas
1145 otras indicaciones. De forma alternativa, pueden verse explicaciones
1146 sobre los archivos más importantes de este conjunto en
1147 @rlearning{Otras fuentes de información}. Estos archivos se pueden
1148 editar, pero los cambios realizados sobre ellos se perderán al
1149 instalar una nueva versión de LilyPond.
1151 Pueden verse ejemplos sencillos sobre el uso de @code{\include} en
1152 @rlearning{Partituras y particellas}.
1156 Manual de aprendizaje:
1157 @rlearning{Otras fuentes de información},
1158 @rlearning{Partituras y particellas}.
1163 Si un archivo incluido recibe un nombre igual al de uno de los
1164 archivos de instalación de LilyPond, el archivo que tiene prioridad es
1165 el de los archivos de instalación de LilyPond.
1168 @node Distintas ediciones a partir de una misma fuente
1169 @subsection Distintas ediciones a partir de una misma fuente
1170 @translationof Different editions from one source
1172 Se encuentran disponibles varios mecanismos para facilitar la
1173 producción de distintas versiones de una partitura a partir de la
1174 misma fuente musical. Las variables son quizá más útiles para
1175 combinar secciones extensas de música y/o anotaciones de diversas
1176 formas, mientras que las etiquetas son más útiles para seleccionar una
1177 de entra varias secciones de música más cortas. Cualquiera que sea el
1178 método utilizado, la separación de la notación de la estructura de la
1179 partitura hará que sea más fácil cambiar la estructura dejando intacta
1183 * Uso de las variables::
1184 * Uso de etiquetas::
1185 * Uso de ajustes globales::
1188 @node Uso de las variables
1189 @unnumberedsubsubsec Uso de las variables
1190 @translationof Using variables
1192 @cindex variables, uso de las
1194 Si las secciones de la música se definen dentro de variables, se
1195 pueden reutilizar en distintas partes de la partitura, véase
1196 @rlearning{Organizar las piezas mediante variables}. Por ejemplo, una
1197 partitura vocal @notation{a cappella} con frecuencia incluye una
1198 reducción de piano de las partes para ensayar que es idéntica a la
1199 música vocal, por lo que ésta sólo se tiene que escribir una vez. Se
1200 puede combinar sobre un solo pentagrama la música de dos variables,
1201 véase @ref{Combinación automática de las partes}. He aquí un ejemplo:
1203 @lilypond[verbatim,quote]
1204 sopranoMusic = \relative c'' { a4 b c b8( a) }
1205 altoMusic = \relative g' { e4 e e f }
1206 tenorMusic = \relative c' { c4 b e d8( c) }
1207 bassMusic = \relative c' { a4 gis a d, }
1208 allLyrics = \lyricmode {King of glo -- ry }
1210 \new Staff = "Soprano" \sopranoMusic
1211 \new Lyrics \allLyrics
1212 \new Staff = "Alto" \altoMusic
1213 \new Lyrics \allLyrics
1214 \new Staff = "Tenor" {
1218 \new Lyrics \allLyrics
1219 \new Staff = "Bass" {
1223 \new Lyrics \allLyrics
1226 \set Staff.printPartCombineTexts = ##f
1232 \set Staff.printPartCombineTexts = ##f
1242 Se pueden producir partituras distintas que presenten sólo las partes
1243 vocales o sólo la parte de piano, cambiando solamente los enunciados
1244 estructurales, sin modificar la notación musical.
1246 Para partituras extensas, las definiciones de variable se pueden poner
1247 en archivos separados que se incluyen más tarde, véase @ref{Inclusión de archivos de LilyPond}.
1250 @node Uso de etiquetas
1251 @unnumberedsubsubsec Uso de etiquetas
1252 @translationof Using tags
1255 @funindex \keepWithTag
1256 @funindex \removeWithTag
1258 @cindex mantener música etiquetada
1259 @cindex quitar música etiquetada
1261 La instrucción @code{\tag #'@var{parteA}} marca una expresión musical
1262 con el nombre @var{parteA}. Las expresiones etiquetadas de esta
1263 manera se pueden seleccionar o filtrar más tarde por su nombre, usando
1264 bien @code{\keepWithTag #'@var{nombre}} o bien @code{\removeWithTag
1265 #'@var{nombre}}. El resultado de la aplicación de estos filtros a la
1266 música etiquetada es como sigue:
1268 @multitable @columnfractions .5 .5
1272 Música etiquetada precedida de @code{\keepWithTag #'@var{nombre}}
1274 Se incluye la música no etiquetada y la música etiquetada con
1275 @var{nombre}; se excluye la música etiquetada con cualquier otro
1278 Música etiquetada precedida de @code{\removeWithTag #'@var{nombre}}
1280 Se incluye la música no etiquetada y la música etiquetada con
1281 cualquier nombre de etiqueta distinto a @var{nombre}; se excluye la
1282 música etiquetada con @var{nombre}.
1284 Música etiquetada no precedida de @code{\keepWithTag} ni de
1285 @code{\removeWithTag}
1286 @tab Se incluye toda la música etiquetada y no etiquetada.
1289 Los argumentos de las instrucciones @code{\tag}, @code{\keepWithTag} y
1290 @code{\removeWithTag} deben ser un símbolo (como @code{#'partitura} o
1291 @code{#'parte}), seguido de una expresión musical.
1293 En el ejemplo siguiente vemos dos versiones de una pieza musical, una
1294 que muestra trinos con la notación usual y otra con los trinos
1295 expandidos explícitamente:
1297 @lilypond[verbatim,quote]
1298 music = \relative g' {
1300 \tag #'trills { d8.\trill }
1301 \tag #'expand { \repeat unfold 3 { e32 d } }
1306 \keepWithTag #'trills \music
1309 \keepWithTag #'expand \music
1314 De forma alternativa, a veces es más fácil excluir secciones de música:
1316 @lilypond[verbatim,quote]
1317 music = \relative g' {
1319 \tag #'trills { d8.\trill }
1320 \tag #'expand {\repeat unfold 3 { e32 d } }
1325 \removeWithTag #'expand
1329 \removeWithTag #'trills
1334 El filtrado con etiquetas se puede aplicar a articulaciones, textos,
1338 -\tag #'@var{mi-etiqueta}
1341 a una articulación. Por ejemplo, esto define una nota con una
1342 indicación opcional de digitación y una nota con una anotación
1347 c1-\tag #'warn ^"¡Ojo!"
1350 Se pueden poner varias etiquetas sobre expresiones con varias entradas
1353 @lilypond[quote,verbatim]
1354 music = \relative c'' {
1355 \tag #'a \tag #'both { a4 a a a }
1356 \tag #'b \tag #'both { b4 b b b }
1359 \keepWithTag #'a \music
1360 \keepWithTag #'b \music
1361 \keepWithTag #'both \music
1365 Se pueden aplicar varios filtros @code{\removeWithTag} a una sola
1366 expresión musical para quitar varias secciones etiquetadas con nombres
1369 @lilypond[verbatim,quote]
1370 music = \relative c'' {
1371 \tag #'A { a4 a a a }
1372 \tag #'B { b4 b b b }
1373 \tag #'C { c4 c c c }
1374 \tag #'D { d4 d d d }
1383 Dos o más filtros @code{\keepWithTag} aplicados a una sola expresión
1384 musical producen la eliminación de @emph{todas} las secciones
1385 etiquetadas, porque el primer filtro quita todas las secciones
1386 etiquetadas excepto la que se nombra, y el segundo filtro elimina
1387 incluso esa sección etiquetada.
1391 Manual de aprendizaje:
1392 @rlearning{Organizar las piezas mediante variables}.
1394 Referencia de la notación:
1395 @ref{Combinación automática de las partes},
1396 @ref{Inclusión de archivos de LilyPond}.
1400 @c This warning is more general than this placement implies.
1401 @c Rests are not merged whether or not they come from tagged sections.
1402 @c Should be deleted? -td
1407 Multiple rests are not merged if you create a score with more
1408 than one tagged section at the same place.
1412 @node Uso de ajustes globales
1413 @unnumberedsubsubsec Uso de ajustes globales
1414 @translationof Using global settings
1416 @cindex include-settings
1418 Se pueden incluir ajustes globales a partir de un archivo distinto:
1421 lilypond -dinclude-settings=MIS_AJUSTES.ly MI_PARTITURA.ly
1424 En archivos diferentes se pueden almacenar grupos de ajustes como
1425 el tamaño de la página o las fuentes tipográficas. Ello permite
1426 hacer diferentes ediciones de la mism a partitura así como aplicar
1427 ajustes estándar a muchas partituras, simplemente por medio de la
1428 especificación del archivo de ajustes adecuado.
1430 Esta técnica también funciona bien con el uso de hojas de estilo,
1431 como se estudia en @rlearning{Hojas de estilo}.
1434 Manual de aprendizaje:
1435 @rlearning{Organizar las piezas mediante variables},
1436 @rlearning{Hojas de estilo}.
1438 Referencia de la notación:
1439 @ref{Inclusión de archivos de LilyPond}.
1441 @node Codificación del texto
1442 @subsection Codificación del texto
1443 @translationof Text encoding
1447 @cindex caracteres no ASCII
1449 LilyPond usa el conjunto de caracteres definido por el consorcio
1450 Unicode y la norma ISO/IEC 10646. Define un nombre único y un código
1451 para los conjuntos de caracteres que se utilizan en prácticamente
1452 todos los idiomas modernos y también en muchos otros. Unicode se
1453 puede implementar utilizando varios esquemas de codificación
1454 distintos. LilyPond usa la codificación UTF-8 (UTF son las siglas de
1455 @emph{Unicode Transformation Format}, o formato de transformación de
1456 Unicode) que representa todos los caracteres comunes de Latin en un
1457 solo byte, y representa otros caracteres usando un formato de longitud
1458 variable de hasta cuatro bytes.
1460 El aspecto visual real de los caracteres viene determinado por los
1461 glifos que se definen en las fuentes tipográficas concretas que se
1462 tengan disponibles: una fuente tipográfica define la asignación de un
1463 subconjunto de los códigos de Unicode a glifos. LilyPond usa la
1464 biblioteca Pango para representar y disponer tipográficamente textos
1467 LilyPond no realiza ninguna conversión en la codificación de la
1468 entrada. Esto significa que cualquier text, ya sea el título, la
1469 letra de la canción o una instrucción musical que contenga caracteres
1470 distintos a los del conjunto ASCII, se deben codificar en UTF-8. La
1471 forma más fácil de escribir dicho texto es utilizar un editor
1472 preparado para Unicode y guardar el archivo con la codificación UTF-8.
1473 Casi todos los editores modernos populares contemplan el UTF-8, por
1474 ejemplo lo hacen vim, Emacs, jEdit, y GEdit. Todos los sistemas MS
1475 Windows posteriores a NT usan Unicode como codificación de caracteres
1476 nativa, de manera que incluso el accesorio Bloc de Notas (Notepad)
1477 puede editar y guardar un archivo en el formato UTF-8. Una
1478 alternativa más funcional para Windows es BabelPad.
1480 Si un archivo de entrada que contiene un carácter que no es ASCII, no
1481 se guarda en el formato UTF-8, se genera el mensaje de error
1484 FT_Get_Glyph_Name () error: argumento inválido
1487 He aquí un ejemplo que muestra texto cirílico, hebreo y portugués:
1490 %c No verbatim here as the code does not display correctly in PDF
1492 bulgarian = \lyricmode {
1493 Жълтата дюля беше щастлива, че пухът, който цъфна, замръзна като гьон.
1497 hebrew = \lyricmode {
1498 זה כיף סתם לשמוע איך תנצח קרפד עץ טוב בגן.
1502 portuguese = \lyricmode {
1503 à vo -- cê uma can -- ção legal
1509 \addlyrics { \bulgarian }
1510 \addlyrics { \hebrew }
1511 \addlyrics { \portuguese }
1514 Para introducir un carácter aislado para el que se conoce el punto de
1515 código Unicode pero no está disponible en el editor que se está
1516 usando, use @code{\char ##xhhhh} o bien @code{\char #dddd} dentro de
1517 un bloque @code{\markup}, donde @code{hhhh} es el código hexadecimal
1518 del carácter en cuestión y @code{dddd} es su valor decimal
1519 correspondiente. Pueden omitirse los ceros iniciales, pero es
1520 costumbre indicar los cuatro caracteres en la representación
1521 hexadecimal (observe que @emph{no} debe utilizarse la codificación
1522 UTF-8 del punto de código Unicode después de @code{\char}, pues la
1523 codificación UTF-8 contiene bits adicionales que indican el número de
1524 octetos). Hay tablas de códigos Unicode y un índice de nombres de
1525 caracteres que da el punto de código en hexadecimal para cualquier
1526 carácter en el portal del Consorcio Unicode,
1527 @uref{http://www.unicode.org/}.
1530 Por ejemplo, tanto @code{\char ##x03BE} como @code{\char #958}
1531 insertan el carácter Unicode U+03BE, que tiene el nombre Unicode
1532 @qq{Letra griega Xi pequeña}.
1534 Se puede escribir de esta forma cualquier punto de código Unicode, y
1535 si todos los caracteres especiales se escriben en este formato no es
1536 necesario guardar el archivo de entrada en formato UTF-8. Por
1537 supuesto, debe estar instalada y estar disponible para LilyPond una
1538 fuente tipográfica que contenga codificados todos estos caracteres.
1540 El ejemplo siguiente muestra valores hexadecimales Unicode que se usan
1541 en cuatro lugares: en una llamada de ensayo, como texto de
1542 articulación, en la letra y como texto independiente bajo la
1545 @lilypond[quote,verbatim]
1548 c1 \mark \markup { \char ##x03EE }
1549 c1_\markup { \tiny { \char ##x03B1 " to " \char ##x03C9 } }
1551 \addlyrics { O \markup { \concat { Ph \char ##x0153 be! } } }
1553 \markup { "Copyright 2008--2011" \char ##x00A9 }
1556 @cindex copyright, símbolo de
1558 Para escribir el símbolo de copyright en la nota de créditos, utilice:
1562 copyright = \markup @{ \char ##x00A9 "2008" @}
1567 @node Presentar la notación de LilyPond
1568 @subsection Presentar la notación de LilyPond
1569 @translationof Displaying LilyPond notation
1571 @funindex \displayLilyMusic
1572 La impresión textual de una expresión musical en notación de LilyPond
1573 puede hacerse con la función musical @code{\displayLilyMusic} pero solamente
1574 mediante la línea de órdenes. Por ejemplo,
1578 \displayLilyMusic \transpose c a, @{ c4 e g a bes @}
1585 @{ a,4 cis e fis g @}
1588 De forma predeterminada, LilyPond imprime estos mensajes en la consola
1589 junto al resto de los mensajes de la compilación de LilyPond.
1590 Para discernir entre estos mensajes y
1591 guardar el resultado de @code{\display@{MATERIAL@}}, redireccione la
1592 salida hacia un archivo.
1595 lilypond archivo.ly >resultado.txt
1600 @node Controlar la salida
1601 @section Controlar la salida
1602 @translationof Controlling output
1605 * Extracción de fragmentos de música::
1606 * Saltar la música corregida::
1607 * Formatos de salida alternativos::
1608 * Sustituir la tipografía de la notación::
1611 @node Extracción de fragmentos de música
1612 @subsection Extracción de fragmentos de música
1613 @translationof Extracting fragments of music
1615 Es posible citar pequeños fragmentos de una partitura grande
1616 directamente a partir de la salida. Puede compararse con la
1617 separación de una pieza de una partitura, recortándola con tijeras.
1619 Esto se hace definiendo los compases que se deben recortar. Por
1620 ejemplo, la inclusión de la siguiente definición
1627 (make-rhythmic-location 5 1 2)
1628 (make-rhythmic-location 7 3 4)))
1633 extrae un fragmento empezando por la mitad del quinto compás y
1634 finalizando en el séptimo compás. El significado de @code{5 1 2} es:
1635 después de una blanca (1/2) en el compás 5, y el de @code{7 3 4}
1636 después de tres negras del compás 7.
1638 Se pueden definir más zonas de recorte añadiendo más parejas de
1639 definición de tiempo rhythmic-location a la lista.
1641 Para poder utilizar esta funcionalidad, LilyPond se debe invocar con
1642 la opción @code{-dclip-systems}. Los recortes aparecen en la salida
1643 como archivos EPS, y se convierten en PDF y PNG si estos formatos
1644 también están activados.
1646 Para ver más información sobre los formatos de salida, consulte
1647 @rprogram{Invocar a LilyPond}.
1650 @node Saltar la música corregida
1651 @subsection Saltar la música corregida
1652 @translationof Skipping corrected music
1654 @funindex skipTypesetting
1655 @funindex showFirstLength
1656 @funindex showLastLength
1658 Al escribir o copiar música, normalmente sólo es interesante de ver y
1659 corregir la música cercana al final (donde estamos añadiendo las
1660 notas). Para acelerar este proceso de corrección, es posible saltar
1661 la composición tipográfica de todos excepto unos pocos de los últimos
1662 compases. Esto se consigue poniendo
1665 showLastLength = R1*5
1670 en nuestro archivo fuente. Esto hará que se tracen sólo los últimos
1671 cinco compases (suponiendo un compás de 4/4) de cada una de las
1672 partituras @code{\score} del archivo de entrada. Para piezas largas,
1673 el tipografiado de únicamente una parte pequeña es con frecuencia un
1674 orden de magnitud más rápido que el de la obra completa. Si estamos
1675 trabajando sobre el principio de una partitura que ya hemos
1676 tipografiado (p.ej., para añadir una parte instrumental nueva),
1677 también puede ser útil la propiedad @code{showFirstLength}.
1679 Este mecanismo de pasar por alto partes de un partitura se puede
1680 controlar con un grano más fino mediante la propiedad
1681 @code{Score.skipTypesetting}. Cuando su valor está establecido, no se
1682 lleva a cabo ningún tipografiado en absoluto.
1684 Esta propiedad se usa también para controlar la salida al archivo
1685 MIDI. Observe que pasa por alto todos los eventos, incluidos el tempo
1686 y los cambios de instrumento. Está usted advertido.
1688 @lilypond[quote,relative=2,ragged-right,verbatim]
1690 \set Score.skipTypesetting = ##t
1692 \set Score.skipTypesetting = ##f
1696 En música polifónica, @code{Score.skipTypesetting} afecta a todas las
1697 voces y pentagramas, ahorrando más tiempo incluso.
1699 @node Formatos de salida alternativos
1700 @subsection Formatos de salida alternativos
1701 @translationof Alternative output formats
1703 @cindex salida de gráficos de vector escalables
1705 @cindex salida de PostScript encapsulado
1707 @cindex PostScript encapsulado, salida de
1709 Los formatos de salida predeterminados para la partitura impresa son
1710 el formato de documento portátil (PDF) y PostScript (PS). Los
1711 formatos de salida Gráficos de vector escalables (SVG), PostScript
1712 encapsulado (EPS) y Gráficos de red portátiles (PNG) también están
1713 disponibles a través de opciones de la línea de órdenes, véase
1714 @rprogram{Opciones de la línea de órdenes para lilypond}.
1717 @node Sustituir la tipografía de la notación
1718 @subsection Sustituir la tipografía de la notación
1719 @translationof Replacing the notation font
1721 Gonville es una alternativa a la tipografía Feta que se utiliza en
1722 LilyPond y se puede descargar de:
1724 @uref{http://www.chiark.greenend.org.uk/~sgtatham/gonville/ ,http://www.chiark.greenend.org.uk/~sgtatham/gonville/}
1727 Aquí presentamos algunos compases de muestra tipografiados con la
1730 @c NOTE: these images are a bit big, but that's important
1731 @c for the font comparison. -gp
1732 @sourceimage{Gonville_after,,,}
1734 Aquí hay unos compases de muestra tipografiados en la fuente Feta de
1737 @sourceimage{Gonville_before,,,}
1739 @subsubheading Instrucciones de instalación para MacOS
1741 Descargue y extraiga el archivo zip. Copie la carpeta @code{lilyfonts}
1742 a @file{@var{SHARE_DIR}/lilypond/current}; para más información,
1743 consulte @rlearning{Otras fuentes de información}. Mueva la carpeta
1744 @code{fonts} existente a @code{fonts_orig} y mueva la carpeta
1745 @code{lilyfonts} a @code{fonts}. Sencillamente vuelva a mover
1746 @code{fonts_orig} a @code{fonts} para volver a la fuente Feta.
1749 Manual de aprendizaje:
1750 @rlearning{Otras fuentes de información}.
1754 Gonville no se puede usar para tipografiar notación de @q{Música
1755 Antigua}. Diríjase a la página web del autor para obtener más
1756 información sobre éste y otros asuntos, entre ellos el régimen de
1757 licencias de Gonville.
1761 @section Salida MIDI
1762 @translationof MIDI output
1767 El MIDI (Musical Instrument Digital Interface, Interfase Digital para
1768 Instrumentos Musicales) es un estándar para interconectar y controlar
1769 instrumentos musicales electrónicos. Un archivo o secuencia MIDI es
1770 una serie de notas dentro de un conjunto de pistas. No es un archivo
1771 de sonidos reales; se necesita un programa reproductor especial para
1772 traducir la serie de notas en sonidos de verdad.
1774 Cualquier música se puede convertir a archivos MIDI, de manera que
1775 podamos escuchar lo que hayamos introducido. Esto es muy conveniente
1776 para comprobar la corrección de la música; las octavas equivocadas o
1777 las alteraciones erróneas se ponen de relieve muy claramente al
1778 escuchar la salida MIDI.
1780 La salida estándar de MIDI es un poco primitiva; de forma opcional, se
1781 encuentra disponible una salida MIDI mejorada y mucho más realista,
1782 por medio de @ref{El script Articulate}.
1785 La salida MIDI reserva un canal por cada pentagrama, y otro para los
1786 ajustes globales. Por ello, el archivo MIDI no debe tener más de 15
1787 pautas (o 14 si no se usa la percusión). Otros pentagramas permanecen
1791 * Crear archivos MIDI::
1793 * ¿Qué sale por el MIDI?::
1794 * Repeticiones y MIDI::
1795 * Control de los matices en el MIDI::
1796 * Percusión en MIDI::
1797 * El script Articulate::
1800 @node Crear archivos MIDI
1801 @subsection Crear archivos MIDI
1802 @translationof Creating MIDI files
1804 Para crear un MIDI a partir de una pieza de música, escriba un bloque
1805 @code{\midi} en la partitura, por ejemplo:
1814 Si hay un bloque @code{\midi} dentro de un @code{\score} que no tenga
1815 ningún bloque @code{\layout}, solamente se producirá MIDI. Si se
1816 necesita una notación impresa, debe haber también un bloque
1827 Se traducen correctamente a la salida MIDI la altura y duración de las
1828 notas, las ligaduras de unión, matices y cambios de tempo. Las
1829 indicaciones dinámicas, crescendi y decrescendi se traducen a niveles
1830 de volumen MIDI. Las marcas dinámicas se traducen a una fracción fija
1831 del rango de volumen MIDI disponible. Los crescendi y decrescendi
1832 hacen que el volumen varía linealmente entre sus dos extremos. El
1833 efecto de las indicaciones dinámicas sobre la salida MIDI se puede
1834 eliminar por completo, véase @ref{El bloque MIDI}.
1836 El tempo inicial y los cambios de tempo posteriores se pueden
1837 especificar utilizando la instrucción @code{\tempo} dentro de la
1838 propia notación musical. Se reflejan en cambios de tempo en la salida
1839 MIDI. Esta instrucción normalmente hace que se imprima la indicación
1840 metronómica, pero esto se puede eliminar, véase @ref{Indicaciones metronómicas}.
1841 Más abajo se describe una forma alternativa de especificar el tempo
1842 MIDI inicial o global, véase @ref{El bloque MIDI}.
1844 Debido a ciertas limitaciones de Windows, la extensión predeterminada
1845 para los archivos MIDI en Windows es @code{.mid}. Otros sistemas
1846 operativos utilizan la extensión @code{.midi}. Si prefiere una
1847 extensión diferente, inserte la siguiente línea en el nivel jerárquico
1848 superior del archivo de entrada, antes del inicio de cualquier bloque
1849 @code{\book}, @code{\bookpart} o @code{\score}:
1852 #(ly:set-option 'midi-extension "midi")
1855 La línea anterior establece la extensión predeterminada para los
1856 archivos MIDI a @code{.midi}.
1858 De forma alternativa, esta opción se puede también proporcionar en la
1862 lilypond … -dmidi-extension=midi archivoLily.ly
1866 @unnumberedsubsubsec Nombres de instrumentos
1868 @cindex instrumento, nombres de
1869 @funindex Staff.midiInstrument
1871 El nombre del instrumento MIDI se establece mediante la propiedad
1872 @code{Staff.midiInstrument}. El nombre del instrumento se debe elegir
1873 de entre los que están en la lista que aparece en @ref{Instrumentos MIDI}.
1877 \set Staff.midiInstrument = #"glockenspiel"
1883 \new Staff \with @{midiInstrument = #"cello"@} @{
1888 Si el instrumento elegido no coincide exactamente con uno de los
1889 instrumentos de la lista de instrumentos MIDI, se usará el instrumento
1890 Piano de Cola (@code{"acoustic grand"}).
1894 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
1895 {changing-midi-output-to-one-channel-per-voice.ly}
1899 @c In 2.11 the following no longer seems to be a problem -td
1901 Unterminated (de)crescendos will not render properly in the midi file,
1902 resulting in silent passages of music. The workaround is to explicitly
1903 terminate the (de)crescendo. For example,
1910 will not work properly but
1913 @{ a4\< b c d\!\f @}
1920 Los cambios del volumen MIDI sólo tienen lugar al principio de la
1921 nota, por lo que los crescendi y decrescendi no pueden afectar al
1922 volumen de una sola nota.
1924 No todos los reproductores de MIDI manejar adecuadamente los cambios de
1925 tempo de la salida MIDI. Entre los reproductores que se sabe que
1926 funcionan se encuentran el Reproductor de Medios de MS Windows y
1927 @uref{http://@/timidity@/.sourceforge@/.net/,timidity}.
1930 @node El bloque MIDI
1931 @subsection El bloque MIDI
1932 @translationof MIDI block
1936 Si se requiere una salida MIDI, debe aparecer un bloque @code{\midi}
1937 dentro de un bloque de partitura. Es análogo al bloque layout de
1938 diseño de página, pero algo más simple. Con frecuencia, el bloque
1939 @code{\midi} se deja vacío, pero puede contener reorganizaciones de
1940 contextos, definiciones de contexto nuevas o código para fijar valores
1941 de propiedades. Por ejemplo, en el ejemplo siguiente se establece el
1942 tempo inicial exportado al archivo MIDI sin hacer que se imprima una
1943 indicación de tempo:
1951 tempoWholesPerMinute = #(ly:make-moment 72 4)
1957 En este ejemplo, el tempo se establece a 72 pulsos de negra por
1958 minuto. Esta clase de especificación de tempo no puede tomar como
1959 argumento una figura con puntillo. Si necesitamos una figura con
1960 puntillo, dividimos la nota con puntillo en figuras más pequeñas. Por
1961 ejemplo, un tempo de 90 negras con puntillo por minuto se puede
1962 especificar como 270 corcheas por minuto:
1965 tempoWholesPerMinute = #(ly:make-moment 270 8)
1968 @cindex MIDI, definiciones de contexto
1970 Las definiciones de contexto siguen con precisión la misma sintaxis
1971 que la de un bloque @code{\layout}. Los módulos de traducción para el
1972 sonido reciben el nombre de ejecutantes. Los contextos para la salida
1973 MIDI se definen en @file{../ly/performer-init.ly}, véase
1974 @rlearning{Otras fuentes de información}. Por ejemplo, para eliminar
1975 el efecto de los matices de la salida MIDI, inserte las líneas
1976 siguientes en el bloque @code{\midi@{ @}}.
1983 \remove "Dynamic_performer"
1988 La salida MIDI se crea sólo cuando se incluye un bloque @code{\midi}
1989 dentro de un bloque de partitura definido con una instrucción
1994 @{ @dots{}notas@dots{} @}
1999 @node ¿Qué sale por el MIDI?
2000 @subsection ¿Qué sale por el MIDI?
2001 @translationof What goes into the MIDI output?
2003 @unnumberedsubsubsec Contemplado en el MIDI
2005 @cindex alturas en MIDI
2006 @cindex MIDI, alturas
2007 @cindex cuartos de tono en MIDI
2008 @cindex MIDI, cuartos de tono
2009 @cindex microtonos en MIDI
2010 @cindex MIDI, microtonos
2011 @cindex acordes, nombres de, en MIDI
2012 @cindex MIDI, nombres de
2013 @cindex duraciones en MIDI
2014 @cindex MIDI, duraciones
2015 @cindex Articlulate, scripts
2016 @cindex MIDI, articulaciones
2017 @cindex articulaciones en MIDI
2018 @cindex trinos en MIDI
2019 @cindex grupetos en MIDI
2020 @cindex rallentando en MIDI
2021 @cindex accelerando en MIDI
2024 Los siguientes elementos de notación se reflejan en la salida MIDI:
2028 @item Microtonos (véase @ref{Alteraciones accidentales}. La reproducción necesita un reproductor que contemple la curvatura de tono o @emph{pitch bend}.)
2029 @item Acordes escritos como nombres de acorde
2030 @item Ritmos escritos como duraciones de las notas, incluidos los grupos de valoración especial
2031 @item Trémolos escritos sin @q{@code{:}[@var{número}]}
2032 @item Ligaduras de unión
2033 @item Matices o indicaciones de dinámica
2034 @item Crescendi y decrescendi sobre varias notas
2035 @item Cambios de tempo insertados con una marca metronómica
2036 @item Letra de las canciones
2039 Utilizando @ref{El script Articulate}, a la lista anterior se añaden
2040 una serie de elementos:
2043 @item Articulaciones (ligaduras de expresión, picados, etc)
2044 @item Trinos, mordentes circulares
2045 @item Rallentando y accelerando
2049 @unnumberedsubsubsec No contemplado en el MIDI
2051 @c TODO index as above
2053 Los siguientes elementos de notación no tienen ningún efecto sobre la
2054 salida MIDI, a no ser que utilicemos @ref{El script Articulate}:
2057 @item Duraciones escritas como anotaciones, p.ej. el swing
2058 @item Cambios de tempo escritos como anotaciones sin marca de tempo
2059 @item Staccato y otras articulaciones y ornamentos
2060 @item Ligaduras de expresión y de fraseo
2061 @item Crescendi y decrescendi sobre una nota única
2062 @item Trémolos introducidos con @q{@code{:}[@var{número}]}
2064 @item Acordes microtonales
2068 @node Repeticiones y MIDI
2069 @subsection Repeticiones y MIDI
2070 @translationof Repeats in MIDI
2072 @cindex repeticiones, expandir
2073 @funindex \unfoldRepeats
2075 Con un poco de trucaje, se puede hacer que cualquier tipo de
2076 repetición esté presente en la salida MIDI. Esto se consigue mediante
2077 la aplicación de la función musical @code{\unfoldRepeats}. Esta
2078 función cambia todas las repeticiones a repeticiones desplegadas.
2080 @lilypond[quote,verbatim]
2082 \repeat tremolo 8 { c'32 e' }
2083 \repeat percent 2 { c''8 d'' }
2084 \repeat volta 2 { c'4 d' e' f' }
2093 En partituras con varias voces, el desplegado de las repeticiones en
2094 la salida MIDI solo se produce correctamente si @emph{todas y cada
2095 una} de las voces incluye las repeticiones de manera completa y
2098 Al crear un archivo de partitura que use @code{\unfoldRepeats} para el
2099 MIDI, es necesario hacer dos bloques @code{\score}: uno para el MIDI
2100 (con repeticiones desplegadas) y otro para la notación impresa (con
2101 repeticiones de volta --primera y segunda vez--, tremolo --trémolo--,
2102 y percent --repetición de compases--). Por ejemplo,
2110 \unfoldRepeats @var{..música..}
2116 @node Control de los matices en el MIDI
2117 @subsection Control de los matices en el MIDI
2118 @translationof Controlling MIDI dynamics
2120 La dinámica en el MIDI está implementada por medio del intérprete
2121 Dynamic_performer que reside de forma predeterminada dentro del
2122 contexto Voice. Es posible controlar el volumen MIDI general, el
2123 volumen relativo de los matices dinámicos y el volumen relativo de los
2124 distintos instrumentos.
2126 @unnumberedsubsubsec Indicaciones dinámicas
2128 Los matices o indicaciones de dinámica se traducen a una fracción fija
2129 del rango de volumen MIDI disponible. Las fracciones predeterminadas
2130 se extienden desde 0.25 para @notation{ppppp} hasta 0.95 para
2131 @notation{fffff}. El conjunto de indicaciones dinámicas y las
2132 fracciones asociadas pueden verse en @file{../scm/midi.scm}, véase
2133 @rlearning{Otras fuentes de información}. Este conjunto de fracciones
2134 se puede cambiar o extender proporcionando una función que toma como
2135 argumento una indicación dinámica y devuelve la fracción requerida, y
2136 estableciendo @code{Score.dynamicAbsoluteVolumeFunction} a esta
2139 Por ejemplo, si se requiere una indicación dinámica
2140 @notation{rinforzando}, @code{\rfz}, ésta no tiene ningún efecto
2141 predeterminado sobre el volumen MIDI, pues no está incluida en el
2142 conjunto predeterminado. De igual manera, si se define una indicación
2143 dinámica nueva con @code{make-dynamic-script}, ésta tampoco estará
2144 incluida en el conjunto predeterminado. El ejemplo siguiente muestra
2145 cómo hay que añadir el volumen MIDI para estas indicaciones dinámicas.
2146 La función Scheme establece la fracción a 0.9 si se encuentra una
2147 indicación dinámica rfz, y en caso contrario llama a la función
2150 @lilypond[verbatim,quote]
2151 #(define (myDynamics dynamic)
2152 (if (equal? dynamic "rfz")
2154 (default-dynamic-absolute-volume dynamic)))
2158 \set Staff.midiInstrument = #"cello"
2159 \set Score.dynamicAbsoluteVolumeFunction = #myDynamics
2171 Como alternativa, si se necesitara redefinir la tabla completa de
2172 fracciones, sería mejor usar el procedimiento
2173 @notation{default-dynamic-absolute-volume} que aparece en
2174 @file{../scm/midi.scm} y la tabla asociada como modelo. El último
2175 ejemplo de esta sección muestra cómo se puede hacer esto.
2177 @unnumberedsubsubsec Volumen maestro MIDI
2179 El volumen general máximo y mínimo de las indicaciones dinámicas de
2180 MIDI se controla estableciendo valores para las propiedades
2181 @code{midiMinimumVolume} y @code{midiMaximumVolume} en el nivel de
2182 @code{Score}. Estas propiedades tienen efecto solamente sobre las
2183 indicaciones dinámicas, por ello si queremos que tengan validez desde
2184 el comienzo de la partitura, se debe colocar allí una indicación de
2185 dinámica. La fracción que corresponde a cada indicación dinámica se
2186 modifica con esta fórmula:
2189 midiMinimumVolume + (midiMaximumVolume - midiMinimumVolume) * fracción
2192 En el ejemplo siguiente, el rango de intensidad dinámica del volumen
2193 general MIDI está limitado al intervalo desde 0.2 hasta 0.5.
2195 @lilypond[verbatim,quote]
2201 \set Staff.midiInstrument = #"flute"
2202 \new Voice \relative c''' {
2210 \set Staff.midiInstrument = #"clarinet"
2211 \new Voice \relative c'' {
2222 tempoWholesPerMinute = #(ly:make-moment 72 2)
2223 midiMinimumVolume = #0.2
2224 midiMaximumVolume = #0.5
2230 @unnumberedsubsubsec Balance entre instrumentos (i)
2232 Si las propiedades de volumen MIDI máximo y mínimo están establecidas
2233 en el contexto @code{Staff} se pueden controlar los volúmenes
2234 relativos de los instrumentos MIDI. Esto proporciona un ecualizador
2235 de instrumentos básico que puede realzar significativamente la calidad
2238 En este ejemplo se reduce el volumen del clarinete con relación al de
2239 la flauta. Debe haber una indicación dinámica en la primera nota de
2240 cada instrumento para que esto funcione correctamente.
2242 @lilypond[verbatim,quote]
2248 \set Staff.midiInstrument = #"flute"
2249 \set Staff.midiMinimumVolume = #0.7
2250 \set Staff.midiMaximumVolume = #0.9
2251 \new Voice \relative c''' {
2259 \set Staff.midiInstrument = #"clarinet"
2260 \set Staff.midiMinimumVolume = #0.3
2261 \set Staff.midiMaximumVolume = #0.6
2262 \new Voice \relative c'' {
2273 tempoWholesPerMinute = #(ly:make-moment 72 2)
2279 @unnumberedsubsubsec Balance entre instrumentos (ii)
2281 Si las propiedades de volumen MIDI máximo y mínimo no están
2282 establecidas, de forma predeterminada LilyPond aplica un pequeño grado
2283 de ecualización a algunos instrumentos. Los instrumentos y la
2284 ecualización que se aplica se muestra en la tabla
2285 @notation{instrument-equalizer-alist} en @file{../scm/midi.scm}.
2287 El ecualizador básico predeterminado se puede sustituir estableciendo
2288 @code{instrumentEqualizer} en el contexto @code{Score} a un
2289 procedimiento Scheme nuevo que acepte el nombre de un instrumento MIDI
2290 como único argumento y devuelva un par de fracciones que dan los
2291 volúmenes máximo y mínimo que se aplican a dicho instrumento. Esta
2292 sustitución se hace de la misma forma que mostramos para restablecer
2293 la fracción de volumen absoluto @code{dynamicAbsoluteVolumeFunction}
2294 al comienzo de esta sección. El ecualizador predeterminado,
2295 @notation{default-instrument-equalizer}, en
2296 @file{../scm/midi.scm}, muestra cómo se puede escribir tal
2299 El ejemplo siguiente establece los volúmenes relativos de la flauta y
2300 del clarinete a los mismos valores que el ejemplo anterior.
2302 @lilypond[verbatim,quote]
2303 #(define my-instrument-equalizer-alist '())
2305 #(set! my-instrument-equalizer-alist
2308 ("flute" . (0.7 . 0.9))
2309 ("clarinet" . (0.3 . 0.6)))
2310 my-instrument-equalizer-alist))
2312 #(define (my-instrument-equalizer s)
2313 (let ((entry (assoc s my-instrument-equalizer-alist)))
2322 \set Score.instrumentEqualizer = #my-instrument-equalizer
2323 \set Staff.midiInstrument = #"flute"
2324 \new Voice \relative c''' {
2332 \set Staff.midiInstrument = #"clarinet"
2333 \new Voice \relative c'' {
2344 tempoWholesPerMinute = #(ly:make-moment 72 2)
2351 @c Delete when satisfied this is adequately covered elsewhere -td
2353 @n ode Microtones in MIDI
2354 @s ubsection Microtones in MIDI
2356 @cindex microtones in MIDI
2358 Microtones consisting of half sharps and half flats are exported
2359 to the MIDI file and render correctly in MIDI players which support
2360 pitch bending. See @ref{Nombres de las notas en otros idiomas}. Here is
2361 an example showing all the half sharps and half flats. It can be
2362 copied out and compiled to test microtones in your MIDI player.
2364 @lilypond[verbatim,quote]
2381 @node Percusión en MIDI
2382 @subsection Percusión en MIDI
2383 @translationof Percussion in MIDI
2385 La notación de los instrumentos de percusión se realiza normalmente en
2386 un contexto @code{DrumStaff} y cuando se hace de esta forma se les da
2387 salida correctamente por el canal MIDI@tie{}10, pero ciertos
2388 instrumentos de percusión de altura determinada, como el xilófono,
2389 marimba, vibráfono, timbales, etc., se tratan como instrumentos
2390 @qq{normales} y la música para estos instrumentos se debe introducir
2391 en contextos de @code{Staff} normales, no en un contexto
2392 @code{DrumStaff}, para obtener la salida MIDI correcta.
2394 Ciertos sonidos de altura indeterminada que están incluidos en el
2395 estándar General MIDI, como el tom melódico, el tambor taiko, los
2396 tambores sintéticos, etc., no se pueden acceder a través del canal
2397 MIDI@tie{}10, por lo que la notación para dichos instrumentos se debe
2398 introducir también en un contexto normal de @code{Staff}, utilizando
2399 las alturas normales adecuadas.
2401 Muchos instrumentos de percusión no están incluidos dentro del
2402 estándar General MIDI, p.ej. las castañuelas. El método más
2403 fácil (aunque no satisfactorio) de producir una salida MIDI al
2404 escribir para estos instrumentos es sustituirlos por el sonido más
2405 parecido del conjunto estándar.
2407 @c TODO Expand with examples, and any other issues
2411 Debido a que el estándar General MIDI no contiene golpes de aro
2412 (@emph{rim shots}), para este propósito se utiliza en su lugar el
2413 golpe lateral de baqueta (@emph{sidestick}).
2415 @node El script Articulate
2416 @subsection El script Articulate
2417 @translationof The Articulate script
2419 Es posible obtener una salida MIDI más real si se utiliza el script
2420 Articulate. Éste trata de tener en cuenta las articulaciones
2421 (ligaduras de expresión, picados, etc), mediante la sustitución de las
2422 notas con secuencias musicales de silencios y notas escaladas en el
2423 tiempo de forma apropiada. También trata de desplegar los trinos,
2424 grupetos circulares, etc. y responder a las indicaciones de
2425 rallentando y accelerando.
2427 Para utilizar el script Articulate, tenemos que incluirlo al principio
2428 de nuestro archivo de entrada:
2431 \include "articulate.ly"
2434 y en la sección @code{\score}, hacer lo siguiente:
2437 \unfoldRepeats \articulate <<
2438 resto de la partitura...
2442 Después de alterar el código de entrada de esta manera el resultado
2443 visual se altera profundamente, pero el bloque @code{\midi} estándar
2444 produce un archivo MIDI mejorado.
2446 Si bien no es esencial para que funcione el script Articulate, podemos
2447 insertar la instrucción @code{\unfoldRepeats} según aparece en el
2448 ejemplo anterior, dado que habilita la ejecución de abreviaturas tales
2449 como los @notation{trinos}.
2453 Articulate acorta los acordes, y ciertos fragmentos de música
2454 (especialmente la música de órgano) es posible que suene peor.