@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
@ignore
- Translation of GIT committish: 18cfd801fa7fcd698e924f3b530862714f3e3013
+ Translation of GIT committish: 4c31c117565b1c7dd78e606fceb7cba354f2859a
When revising a translation, copy the HEAD committish of the
version that you are working on. For details, see the Contributors'
Guide, node Updating translation committishes..
@end ignore
-@c \version "2.15.32"
+@c \version "2.19.22"
@node Entrada y salida generales
@chapter Entrada y salida generales
@translationof General input and output
-Esta sección trata de asuntos relacionados con la entrada y salida
-generales de LilyPond, más que con la notación específica.
+Esta sección trata de asuntos relacionados con la entrada y
+salida generales de LilyPond, más que con la notación específica.
@menu
* Estructura del código de entrada::
-* Títulos y cabeceras::
+* Títulos y encabezamientos::
* Trabajar sobre los archivos de entrada::
* Controlar la salida::
-* Salida MIDI::
+* Creación de salida MIDI::
* Extraer información musical::
@end menu
@section Estructura del código de entrada
@translationof Input structure
-El formato principal de entrada para LilyPond son archivos de texto.
-Por convenio, el nombre de estos archivos termina en @file{.ly}.
+El formato principal de entrada para LilyPond son archivos de
+texto. Por convenio, el nombre de estos archivos termina en
+@file{.ly}.
@menu
* Estructura de una partitura::
@example
\score @{
-...
+ @dots{}
@}
@end example
@warning{Sólo puede haber @strong{una} expresión musical dentro del
bloque @code{\score}, y @strong{debe} estar encerrada entre llaves.}
-Esta expresión musical única puede tener cualquier tamaño, y puede
-contener otras expresiones musicales hasta cualquier grado de
-complejidad. Todos los siguientes ejemplos son expresiones musicales:
+Esta expresión musical única puede tener cualquier tamaño, y
+puede contener otras expresiones musicales hasta cualquier grado
+de complejidad. Todos los siguientes ejemplos son expresiones
+musicales:
@example
@{ c'4 c' c' c' @}
@}
@end example
-Los comentarios son una excepción a esta regla general (para ver otras
-excepciones, consulte @ref{Estructura del archivo}). Tanto los comentarios de
-una línea como los que están delimitados por @code{%@{ .. %@}} se
-pueden escribir en cualquier lugar dentro del archivo de entrada. Se
-pueden escribir dentro o fuera del bloque @code{\score}, y dentro o
-fuera de la expresión musical única dentro del bloque @code{\score}.
-
-Recuerde que incluso dentro de un archivo que contenga solamente un
-bloque @code{\score}, éste se encuentra incluido implícitamente dentro
-de un bloque @code{\book}. Un bloque @code{\book} dentro de un
-archivo fuente produce al menos un archivo de salida, y de forma
-predeterminada el nombre del archivo de salida que se produce está
-derivado del nombre del archivo de entrada, de forma que
-@file{fandangoforelephants.ly} da como resultado
-@file{fandangoforelephants.pdf}.
-
-(Para ver más detalles acerca de los bloques @code{\book}, consulte
-@ref{Varias partituras en un libro}, @ref{Varios archivos de salida a
-partir de uno de entrada} y @ref{Estructura del archivo}.)
+Los comentarios son una excepción a esta regla general (para ver
+otras excepciones, consulte @ref{Estructura del archivo}). Tanto
+los comentarios de una línea como los que están delimitados por
+@code{%@{ @dots{} %@}} se pueden escribir en cualquier lugar
+dentro del archivo de entrada. Se pueden escribir dentro o fuera
+del bloque @code{\score}, y dentro o fuera de la expresión
+musical única dentro del bloque @code{\score}.
+
+Recuerde que incluso dentro de un archivo que contenga solamente
+un bloque @code{\score}, éste se encuentra incluido
+implícitamente dentro de un bloque @code{\book}. Un bloque
+@code{\book} dentro de un archivo fuente produce al menos un
+archivo de salida, y de forma predeterminada el nombre del
+archivo de salida que se produce está derivado del nombre del
+archivo de entrada, de forma que @file{fandangoforelephants.ly}
+da como resultado @file{fandangoforelephants.pdf}.
+
+(Para ver más detalles acerca de los bloques @code{\book},
+consulte @ref{Varias partituras en un libro},
+@ref{Varios archivos de salida a partir de uno de entrada} y
+@ref{Estructura del archivo}.)
@seealso
Manual de aprendizaje:
@example
\score @{
- @var{..música..}
+ @var{@dots{}música@dots{}}
@}
@end example
@example
\markup @{
- @var{..texto..}
+ @var{@dots{}texto@dots{}}
@}
@end example
@funindex \book
Todos los movimientos y textos que aparecen en el mismo archivo
-@file{.ly} se tipografían normalmente en la forma de un solo archivo
-de salida.
+@file{.ly} se tipografían normalmente en la forma de un solo
+archivo de salida.
@example
\score @{
- @var{..}
+ @var{@dots{}}
@}
\markup @{
- @var{..}
+ @var{@dots{}}
@}
\score @{
- @var{..}
+ @var{@dots{}}
@}
@end example
salida el primer @code{\score} o @code{\markup}.
El encabezamiento de cada pieza se puede poner dentro del bloque
-@code{\score}. Antes de cada movimiento, se imprime el nombre de la
-pieza (@code{piece}) extraído del encabezamiento. El título del libro
-entero se puede poner dentro del bloque @code{\book}, pero si no está
-presente se inserta el encabezamiento @code{\header} que está al
-principio del archivo.
+@code{\score}. Antes de cada movimiento, se imprime el nombre de
+la pieza (@code{piece}) extraído del encabezamiento. El título
+del libro entero se puede poner dentro del bloque @code{\book},
+pero si no está presente se inserta el encabezamiento
+@code{\header} que está al principio del archivo.
@example
\header @{
\header @{ piece = "Romanze" @}
@}
\markup @{
- ..texto de la segunda estrofa..
+ @dots{}texto de la segunda estrofa@dots{}
@}
\markup @{
- ..texto de la tercera estrofa..
+ @dots{}texto de la tercera estrofa@dots{}
@}
\score @{
@dots{}
@}
@end example
-
@funindex \bookpart
-Se pueden agrupar distintas piezas de música en partes de un libro
-utilizando bloques @code{\bookpart}. Las partes de libro se separan
-por medio de saltos de página, y pueden dar comienzo con un título,
-como el libro propiamente dicho, mediante la especificación del bloque
-@code{\header}.
+Se pueden agrupar distintas piezas de música en partes de un
+libro utilizando bloques @code{\bookpart}. Las partes de libro
+se separan por medio de saltos de página, y pueden dar comienzo
+con un título, como el libro propiamente dicho, mediante la
+especificación del bloque @code{\header}.
@example
\bookpart @{
@}
@end example
+
@node Varios archivos de salida a partir de uno de entrada
@subsection Varios archivos de salida a partir de uno de entrada
@translationof Multiple output files from one input file
Si queremos varios archivos de salida a partir del mismo archivo
-@file{.ly}, podemos escribir varios bloques @code{\book}, donde cada
-uno de estos bloques @code{\book} dará como resultado un archivo de
-salida distinto. Si no especificamos ningún bloque @code{\book} en el
-archivo, LilyPond trata implícitamente todo el archivo como un solo
-bloque @code{\book}, véase @ref{Estructura del archivo}.
+@file{.ly}, podemos escribir varios bloques @code{\book}, donde
+cada uno de estos bloques @code{\book} dará como resultado un
+archivo de salida distinto. Si no especificamos ningún bloque
+@code{\book} en el archivo, LilyPond trata implícitamente todo el
+archivo como un solo bloque @code{\book}, véase @ref{Estructura
+del archivo}.
Al producir varios archivos a partir de un solo archivo fuente,
-Lilypond se asegura de que ninguno de los archivos de salida de ningún
-bloque @code{\book} sobreescribe el archivo de salida producido por un
-@code{\book} anterior del mismo archivo de entrada.
+LilyPond se asegura de que ninguno de los archivos de salida de
+ningún bloque @code{\book} sobreescribe el archivo de salida
+producido por un @code{\book} anterior del mismo archivo de
+entrada.
-Lo hace añadiendo un sufijo al nombre de la salida para cada libro
-@code{\book} que utiliza el nombre del archivo de salida
+Lo hace añadiendo un sufijo al nombre de la salida para cada
+libro @code{\book} que utiliza el nombre del archivo de salida
predeterminado, derivado del archivo fuente de entrada.
-El comportamiento predeterminado es añadir un sufijo con el número de
-versión para cada nombre que pueda coincidir; así:
+El comportamiento predeterminado es añadir un sufijo con el
+número de versión para cada nombre que pueda coincidir; así:
@example
\book @{
\score @{ @dots{} @}
- \layout @{ @dots{} @}
+ \paper @{ @dots{} @}
@}
\book @{
\score @{ @dots{} @}
- \layout @{ @dots{} @}
+ \paper @{ @dots{} @}
@}
\book @{
\score @{ @dots{} @}
- \layout @{ @dots{} @}
+ \paper @{ @dots{} @}
@}
@end example
@file{eightminiatures-2.pdf}.
@end itemize
+
@node Nombres de los archivos de salida
@subsection Nombres de los archivos de salida
@translationof Output file names
@funindex \bookOutputSuffix
@funindex \bookOutputName
-Lilypond le ofrece unos mecanismos que le permiten controlar los
-nombres de archivo que se utilizan por parte de los diversos motores
-finales al producir los archivos de salida.
+LilyPond le ofrece unos mecanismos que le permiten controlar los
+nombres de archivo que se utilizan por parte de los diversos
+motores finales al producir los archivos de salida.
-En la sección anterior vimos cómo Lilypond evita las coincidencias de
-nombres al producir varias salidas a partir de un único archivo fuente
-de entrada. También podemos especificar nuestros propios sufijos para
-cada bloque @code{\book}, de manera que podemos producir, por ejemplo,
-archivos con los nombres @file{eightminiatures-Romanze.pdf},
+En la sección anterior vimos cómo LilyPond evita las
+coincidencias de nombres al producir varias salidas a partir de
+un único archivo fuente de entrada. También podemos especificar
+nuestros propios sufijos para cada bloque @code{\book}, de manera
+que podemos producir, por ejemplo, archivos con los nombres
+@file{eightminiatures-Romanze.pdf},
@file{eightminiatures-Menuetto.pdf} y
@file{eightminiatures-Nocturne.pdf} añadiendo una declaración
@code{\bookOutputSuffix} dentro de cada bloque @code{\book}.
\book @{
\bookOutputSuffix "Romanze"
\score @{ @dots{} @}
- \layout @{ @dots{} @}
+ \paper @{ @dots{} @}
@}
\book @{
\bookOutputSuffix "Menuetto"
\score @{ @dots{} @}
- \layout @{ @dots{} @}
+ \paper @{ @dots{} @}
@}
\book @{
\bookOutputSuffix "Nocturne"
\score @{ @dots{} @}
- \layout @{ @dots{} @}
+ \paper @{ @dots{} @}
@}
@end example
-También podemos especificar un nombre de archivo de salida diferente
-para cada bloque @code{book}, mediante la utilización de declaraciones
-@code{\bookOutputName}:
+También podemos especificar un nombre de archivo de salida
+diferente para cada bloque @code{book}, mediante la utilización
+de declaraciones @code{\bookOutputName}:
@example
\book @{
\bookOutputName "Romanze"
\score @{ @dots{} @}
- \layout @{ @dots{} @}
+ \paper @{ @dots{} @}
@}
\book @{
\bookOutputName "Menuetto"
\score @{ @dots{} @}
- \layout @{ @dots{} @}
+ \paper @{ @dots{} @}
@}
\book @{
\bookOutputName "Nocturne"
\score @{ @dots{} @}
- \layout @{ @dots{} @}
+ \paper @{ @dots{} @}
@}
@end example
@file{Nocturne.pdf}.
@end itemize
+
@node Estructura del archivo
@subsection Estructura del archivo
@translationof File structure
@funindex \book
@funindex \bookpart
-Un archivo @file{.ly} puede contener cualquier número de expresiones
-del nivel superior, donde una expresión del nivel superior es una de
-las siguientes posibilidades:
+Un archivo @file{.ly} puede contener cualquier número de
+expresiones del nivel superior, donde una expresión del nivel
+superior es una de las siguientes posibilidades:
@itemize
@item
Una definición de salida, como @code{\paper}, @code{\midi} y
@code{\layout}. Tal definición en el nivel más alto cambia los
-ajustes predeterminados para todo el libro. Si se introduce más de
-una de estas definiciones del mismo tipo en el nivel más alto,
-cualquier definición en una expresión posterior tiene prioridad.
+ajustes predeterminados para todo el libro. Si se introduce más
+de una de estas definiciones del mismo tipo en el nivel más alto,
+las definiciones se combinan, pero en situaciones de conflicto
+las definiciones más tardías tienen preferencia. Para ver los
+detalles sobre cómo afecta al bloque @code{\layout}, consulte
+@ref{El bloque layout,,El bloque @code{@bs{}layout}}.
@item
Una expresión directa de Scheme, como
@code{#(ly:set-option 'point-and-click #f)}.
@item
-Un bloque @code{\header}. Esto establece el bloque de encabezamiento
-global. Es el bloque que contiene las definiciones de los ajustes
-para todo el libro, como el compositor, título, etc.
+Un bloque @code{\header}. Esto establece el bloque de
+encabezamiento global (es decir, al principio del archivo). Es
+el bloque que contiene los ajustes predeterminados de los campos
+de encabezamientos como el compositor, título, etc. para todos
+los libros que están dentro del archivo (véase
+@ref{Explicación de los títulos}).
@item
-Un bloque @code{\score}. Esta partitura se reúne con otras partituras
-del nivel superior, y se combina con ellas formando un @code{\book}
-(libro) único. Este comportamiento se puede cambiar estableciendo el
-valor de la variable @code{toplevel-score-handler} en el nivel
-superior. El @emph{handler} predeterminado se define en el archivo de
-inicio @file{../scm/lily.scm}.
+Un bloque @code{\score}. Esta partitura se reúne con otras
+partituras del nivel superior, y se combina con ellas formando un
+@code{\book} (libro) único. Este comportamiento se puede cambiar
+estableciendo el valor de la variable
+@code{toplevel-score-handler} en el nivel superior. El
+@emph{handler} predeterminado se define en el archivo de inicio
+@file{../scm/lily.scm}.
@item
Un bloque @code{\book} combina lógicamente varios movimientos (es
-decir, varios bloques @code{\score}) en un solo documento. Si hay
-varias partituras @code{\score}, se crea un solo archivo de salida
-para cada bloque @code{\book}, en el que se concatenan todos los
-movimientos correspondientes. La única razón para especificar
-explícitamente bloques @code{\book} en un archivo de entrada
-@file{.ly} es si queremos crear varios archivos de salida a partir de
-un único archivo de entrada. Una excepción se da dentro de los
-documentos de lilypond-book, en los que tenemos que escribir
-explícitamente un bloque @code{\book} si queremos tener más de una
-única partitura @code{\score} o marcado @code{\markup} en el mismo
-ejemplo. Se puede cambiar este comportamiento estableciendo el valor
-de la variable @code{toplevel-book-handler} en el nivel superior. El
+decir, varios bloques @code{\score}) en un solo documento. Si
+hay varias partituras @code{\score}, se crea un solo archivo de
+salida para cada bloque @code{\book}, en el que se concatenan
+todos los movimientos correspondientes. La única razón para
+especificar explícitamente bloques @code{\book} en un archivo de
+entrada @file{.ly} es si queremos crear varios archivos de salida
+a partir de un único archivo de entrada. Una excepción se da
+dentro de los documentos de lilypond-book, en los que tenemos que
+escribir explícitamente un bloque @code{\book} si queremos tener
+más de una única partitura @code{\score} o marcado @code{\markup}
+en el mismo ejemplo. Se puede cambiar este comportamiento
+estableciendo el valor de la variable
+@code{toplevel-book-handler} en el nivel superior. El
@emph{handler} predeterminado se define en el archivo de inicio
@file{../scm/lily.scm}.
@item
Un bloque @code{\bookpart}. Un libro puede dividirse en varias
-partes, utilizando bloques @code{\bookpart}, con objeto de facilitar
-la inserción de saltos de página o usar distintos ajustes de
-@code{\paper} en las distintas partes.
+partes, utilizando bloques @code{\bookpart}, con objeto de
+facilitar la inserción de saltos de página o usar distintos
+ajustes de @code{\paper} en las distintas partes.
@item
Una expresión musical compuesta, como
@{ c'4 d' e'2 @}
@end example
-Esto añade la pieza al @code{\score} y la conforma dentro de un libro
-único junto a todas las demás partituras @code{\score} y expresiones
-musicales del nivel superior. En otras palabras, un archivo que
-contiene sólo la expresión musical anterior se traduce a
+Esto añade la pieza al @code{\score} y la conforma dentro de un
+libro único junto a todas las demás partituras @code{\score} y
+expresiones musicales del nivel superior. En otras palabras, un
+archivo que contiene sólo la expresión musical anterior se
+traduce a
@example
\book @{
@end example
Los textos de marcado se colocan encima, en medio o debajo de las
-partituras o expresiones musicales, según donde aparezcan escritos.
+partituras o expresiones musicales, según donde aparezcan
+escritos.
@cindex variables
@end example
Esto se puede utilizar más tarde en el archivo escribiendo
-@code{\fulano}. El nombre de las variables ha de ser exclusivamente
-alfabético; sin números, guiones ni barras bajas.
+@code{\fulano}. El nombre de las variables ha de ser
+exclusivamente alfabético; sin números, guiones ni barras bajas.
@end itemize
-El ejemplo siguiente muestra tres cosas que se pueden introducir en el
-nivel superior:
+El ejemplo siguiente muestra tres cosas que se pueden introducir
+en el nivel superior:
@example
\layout @{
@{ c'4 d' e2 @}
@end example
-En cualquier punto del archivo se pueden introducir cualquiera de las
-instrucciones léxicas siguientes:
+En cualquier punto del archivo se pueden introducir cualquiera de
+las instrucciones léxicas siguientes:
@itemize
@item @code{\version}
@item @code{\include}
@item @code{\sourcefilename}
@item @code{\sourcefileline}
-@item
-Un comentario de una línea, determinado por un símbolo @code{%} al principio.
+@item Un comentario de una línea, determinado por un símbolo @code{%}
+al principio.
@item
-Un comentario de varias líneas, delimitado por @code{%@{ .. %@}}.
+Un comentario de varias líneas, delimitado por @code{%@{ @dots{}
+%@}}.
@end itemize
@cindex espacios en blanco
-Por lo general se ignoran los espacios entre elementos del flujo de
-entrada, y se pueden omitir o aumentar tranquilamente para mejorar la
-legibilidad. Sin embargo, los espacios se deben utilizar siempre para
-evitar errores, en las siguientes situaciones:
+Por lo general se ignoran los espacios entre elementos del flujo
+de entrada, y se pueden omitir o aumentar tranquilamente para
+mejorar la legibilidad. Sin embargo, los espacios se deben
+utilizar siempre para evitar errores, en las siguientes
+situaciones:
@itemize
-@item Alrededor de todas y cada una de las llaves curvas de apertura y cierre.
-@item A continuación de las instrucciones y variables, es decir, todos los elementos
-que comienzan con un signo @code{\} de barra invertida.
-@item A continuación de todo elemento que se deba interpretar como expresión
-de Scheme, es decir, todo elemento que comience por un signo@tie{}@code{#}.
+
+@item Alrededor de todas y cada una de las llaves curvas
+de apertura y cierre.
+
+@item A continuación de las instrucciones y variables, es decir,
+todos los elementos que comienzan con un signo @code{\} de barra
+invertida.
+
+@item A continuación de todo elemento que se deba interpretar
+como expresión de Scheme, es decir, todo elemento que comience
+por un signo@tie{}@code{#}.
+
@item Para separar los elementos de una expresión de Scheme.
-@item Dentro de @code{lyricmode} para separar todos los términos de las instrucciones
-@code{\override} y @code{\set}. Concretamente, hay que usar espacios
-alrededor del punto y el signo igual en instrucciones como
-@code{\override Score . LyricText #'font-size = #5} y antes y después
-de la instrucción completa.
+
+@item Dentro de @code{lyricmode} antes y después de las instrucciones
+@code{\set} y @code{\override}.
@end itemize
Manual de aprendizaje:
@rlearning{Cómo funcionan los archivos de entrada de LilyPond}.
+Referencia de la notación:
+@ref{Explicación de los títulos},
+@ref{El bloque layout,,El bloque @code{@bs{}layout}}.
+
-@node Títulos y cabeceras
-@section Títulos y cabeceras
+@node Títulos y encabezamientos
+@section Títulos y encabezamientos
@translationof Titles and headers
+@cindex títulos
+@cindex encabezamientos
+@cindex pies de página
+
Casi toda la música impresa tiene un título y el nombre del
compositor; ciertas piezas tienen mucha más información.
@menu
-* Crear títulos cabeceras y pies de página::
-* Cabeceras pies y títulos personalizados::
+* Crear títulos encabezamientos y pies de página::
+* Títulos encabezamientos y pies de página personalizados::
+* Creación de metadatos de PDF::
* Crear notas al pie::
* Referencia a números de página::
* Índice general::
@end menu
-@node Crear títulos cabeceras y pies de página
-@subsection Crear títulos, cabeceras y pies de página
+@node Crear títulos encabezamientos y pies de página
+@subsection Crear títulos, encabezamientos y pies de página
@translationof Creating titles headers and footers
@menu
-* Explicación de los bloques de títulos::
-* Presentación predeterminada de los bloques de título del libro y la partitura::
+* Explicación de los títulos::
+* Presentación predeterminada de los títulos de partes de libro y partitura::
* Disposición predeterminada de las cabeceras y pies de página::
@end menu
-@node Explicación de los bloques de títulos
-@unnumberedsubsubsec Explicación de los bloques de títulos
-@translationof Title blocks explained
+@node Explicación de los títulos
+@unnumberedsubsubsec Explicación de los títulos
+@translationof Titles explained
+
+Cada bloque @code{\book} de un solo archivo de entrada produce un
+archivo de salida distinto, véase @ref{Estructura del archivo}.
+Dentro de cada archivo de salida están disponibles tres tipos de
+zonas para títulos: @emph{Títulos de libro} al principio de cada
+libro, @emph{Títulos de parte de libro} al principio de cada
+parte de un libro y @emph{Títulos de partitura} al comienzo de
+una partitura.
+
+Los valores de los campos para encabezamientos tales como
+@code{title} (para el título) y @code{composer} (para el autor)
+se establecen en bloques @code{\header} (para ver la sintaxis de
+los bloques @code{\header} y una lista completa de los campos
+disponibles de forma predeterminada, consulte @ref{Presentación
+predeterminada de los títulos de partes de libro y partitura}).
+Tanto los títulos de libro como los títulos de parte de libro y
+los títulos de partitura pueden contener los mismos campos,
+aunque de forma predeterminada los campos de los títulos de
+partitura se limitan a @code{piece} (pieza) y @code{opus}.
+
+Los bloques @code{\header} se pueden situar en cuatro lugares
+distintos para formar una jerarquía descendente de bloques
+@code{\header}:
+
+@itemize
+
+@item
+Al principio del archivo de entrada, antes de cualquier otro bloque
+@code{\book}, @code{\bookpart} o @code{\score}.
+
+@item
+Dentro de un bloque @code{\book} pero fuera de los bloques
+@code{\bookpart} y @code{\score} que están dentro de ese libro.
+
+@item
+Dentro de un bloque @code{\bookpart} pero fuera de cualquier bloque
+@code{\score} dentro de dicha parte de libro.
+
+@item
+Después de la expresión musical de un bloque @code{\score}.
+
+@end itemize
+
+Los valores de los campos se filtran a través de esta jerarquía,
+persistiendo aquellos que se establecen más arriba a no ser que
+se sobreescriban por un valor establecido más abajo en la
+jerarquía, y así:
+
+@itemize
+
+@item
+El título de un libro deriva de los campos establecidos al
+principio del archivo de entrada, modificado por campos
+establecidos en el bloque @code{\book}. Los campos resultantes
+se usan para imprimir el título de libro para dicho libro,
+siempre y cuando haya otro material que genere una página al
+comienzo del libro, antes de la primera parte de libro. Es
+suficiente una sola instrucción @code{\pageBreak}.
-@c TODO: figure out how \bookpart titles work
+@item
+Un título de parte de libro se deriva de los campos fijados al
+principio del archivo de entrada, modificado por los campos
+establecidos dentro del bloque @code{\book}, y posteriormente
+modificado por los campos que se fijan dentro del bloque
+@code{\bookpart}. Los valores resultantes se usan para imprimir
+el título de parte de libro para esa parte.
-Existen dos clases de bloques de títulos: el bloque principal de
-títulos que aparece encima del primer bloque @code{\score} de un
-libro, y los bloques individuales de título que aparecen dentro de
-cada bloque @code{\score}. Los campos de texto para los dos tipos de
-bloque se introducen mediante un bloque @code{\header}.
+@item
+Un título de partitura se deriva de los campos que se fijan al
+principio del archivo de entrada, modificados por los campos
+fijados dentro del bloque @code{\book}, posteriormente
+modificados por los campos que se fijan dentro del bloque
+@code{\bookpart} y finalmente modificados por los campos
+establecidos dentro del bloque @code{\score}. Los valores
+resultantes se utilizan para imprimir el título de partitura.
+Observe, sin embargo, que de forma predeterminada solamente se
+imprimen los campos @code{piece} y @code{opus} en los títulos de
+partitura a no ser que la variable de @code{\paper},
+@code{print-all-headers}, tenga el valor @code{#t}.
-Si el libro tiene una única partitura, el bloque @code{\header} se
-puede situar dentro o fuera del bloque @code{\score}.
+@end itemize
-@warning{Recuerde que al añadir un bloque @bs{}@code{header} dentro de
-un bloque @bs{}@code{score}, la expresión musical debe aparecer antes
-del bloque @bs{}@code{header}.}
+@warning{Recuerde que al poner un bloque @bs{}@code{header}
+dentro de un bloque @bs{}@code{score}, la expresión musical debe
+aparecer antes del bloque @bs{}@code{header}.}
+
+No es necesario aportar bloques @code{\header} en los cuatro
+lugares: cualquiera de ellos o incluso todos pueden omitirse. De
+forma similar, los archivos de entrada sencillos pueden omitir
+los bloques @code{\book} y @code{\bookpart}, dejando que se creen
+de forma implícita.
+
+Si el libro solamente tiene una partitura, el bloque
+@code{\header} debiera situarse normalmente al principio del
+archivo de forma que solamente se produce una zona de título de
+parte de libro, haciendo que estén disponibles para su uso todos
+los títulos de encabezamientos.
+
+Si el libro tiene varias partituras, son posibles distintas
+combinaciones de bloques @code{\header}, según los distintos
+tipos de publicaciones musicales. Por ejemplo, si la publicación
+contiene varias piezas del mismo autor, un bloque @code{\header}
+colocado al principio del archivo que especifique el título del
+libro y el autor, con bloques @code{\header} en cada bloque
+@code{\score} que especifique la @code{piece} y/o el @code{opus}
+sería lo más adecuado, como aquí:
@lilypond[papersize=a5,quote,verbatim,noragged-right]
\header {
}
\score {
- \new Staff \relative g, {
+ \new Staff \relative {
\clef bass
\key g \major
- \repeat unfold 2 { g16( d' b') a b d, b' d, } |
+ \repeat unfold 2 { g,16( d' b') a b d, b' d, } |
\repeat unfold 2 { g,16( e' c') b c e, c' e, } |
}
\header {
}
\score {
- \new Staff \relative b {
+ \new Staff \relative {
\clef bass
\key g \major
\partial 16 b16 |
}
@end lilypond
-Los campos de texto extraídos del bloque prinicipal de título de un
-libro se pueden imprimir en todos los bloques @code{\score}, o
-suprimirse manualmente:
+Son posibles disposiciones más complejas. Por ejemplo, los
+campos de texto extraídos del bloque @code{\header} de un libro
+se pueden imprimir en todos los títulos de partitura, con ciertos
+campos sobreescritos y otros suprimidos manualmente:
@lilypond[papersize=a5,quote,verbatim,noragged-right]
\book {
\header {
title = "DAS WOHLTEMPERIRTE CLAVIER"
subtitle = "TEIL I"
- % Do not display the tagline for this book
+ % Do not display the default LilyPond footer for this book
tagline = ##f
}
\markup { \vspace #1 }
@seealso
Referencia de la notación:
@ref{Estructura del archivo},
-@ref{Personalización de los bloques de título}.
+@ref{Presentación predeterminada de los títulos de partes de libro y partitura},
+@ref{Personalización de los títulos}.
-@node Presentación predeterminada de los bloques de título del libro y la partitura
-@unnumberedsubsubsec Presentación predeterminada de los bloques de título del libro y la partitura
-@translationof Default layout of book and score title blocks
+@node Presentación predeterminada de los títulos de partes de libro y partitura
+@unnumberedsubsubsec Presentación predeterminada de los títulos de partes de libro y partitura
+@translationof Default layout of bookpart and score titles
-La disposición y formato de los bloques de título están controlados
-por medio de dos variables de @code{\paper}: @code{bookTitleMarkup}
-para el bloque de título @code{\header} principal y
-@code{scoreTitleMarkup} para los bloques @code{\header} individuales
-dentro de un bloque @code{\score}.
-
-@lilypond[papersize=a6,quote,verbatim,noragged-right]
-\header {
- % The following fields are centered
- dedication = "Dedication"
- title = "Title"
- subtitle = "Subtitle"
- subsubtitle = "Subsubtitle"
- instrument = "Instrument"
-
- % The following fields are left-aligned on the left side
- poet = "Poet"
- meter = "Meter"
-
- % The following fields are right-aligned on the right side
- composer = "Composer"
- arranger = "Arranger"
-}
+Este ejemplo muestra todas las variables impresas de @code{\header}:
-\score {
- { s1 }
+@c KEEP LY
+@lilypond[papersize=a6landscape,quote,verbatim,noragged-right]
+\book {
\header {
- % The following fields are placed at opposite ends of the same line
- piece = "Piece"
- opus = "Opus"
+ % Los siguientes campos están centrados
+ dedication = "Dedication (dedicatoria)"
+ title = "Title (título)"
+ subtitle = "Subtitle (subtítulo)"
+ subsubtitle = "Subsubtitle (sub-subtítulo)"
+ % Los siguientes campos se distribuyen regularmente sobre una línea
+ % el campo "instrument" también aparece en las siguientes páginas
+ instrument = \markup \with-color #green "Instrument (instrumento)"
+ poet = "Poet (poeta)"
+ composer = "Composer (autor)"
+ % Los siguientes campos se sitúan en los extremos opuestos de la misma línea
+ meter = "Meter (metro)"
+ arranger = "Arranger (arreglista)"
+ % Los siguientes campos están centrados en la parte inferior
+ tagline = "La tagline o línea de etiqueta va al final de la última página"
+ copyright = "El copyright va al final de la primera página"
+ }
+ \score {
+ { s1 }
+ \header {
+ % Los siguientes campos se colocan en los extremos de una línea
+ piece = "Piece (pieza) 1"
+ opus = "Opus 1"
+ }
+ }
+ \score {
+ { s1 }
+ \header {
+ % Los siguientes campos se sitúan en los extremos de una línea
+ piece = "Piece (pieza) 2 en la misma página"
+ opus = "Opus 2"
+ }
+ }
+ \pageBreak
+ \score {
+ { s1 }
+ \header {
+ % Los siguientes campos se sitúan en los extremos de una línea
+ piece = "Piece (pieza) 3 en una página nueva"
+ opus = "Opus 3"
+ }
}
}
@end lilypond
+Observe que
+
+@itemize
+@item
+El nombre de instrumento se repite en todas las páginas.
+
+@item
+Solamente @code{piece} (la pieza) y @code{opus} se imprimen en
+una @code{\score} cuando la variable de papel
+@code{print-all-headers} se establece a @code{##f} (el valor
+predeterminado).
+
+@item
@c Is the bit about \null markups true? -mp
+Los campos de texto que se dejan sin establecer dentro de un
+bloque @code{\header} se sustituyen por elementos de marcado
+nulos @code{\null} de manera que no ocupen espacio
+innecesariamente.
+
+@item
+Los ajustes predeterminados para @code{scoreTitleMarkup} sitúan
+los campos de texto @code{piece} y @code{opus} en extremos
+opuestos de la misma línea.
-Los campos de texto que se dejan sin establecer dentro de un bloque
-@code{\header} se sustituyen por elementos de marcado nulos
-@code{\null} de manera que no ocupen espacio innecesariamente.
+@end itemize
-Los ajustes predeterminados para @code{scoreTitleMarkup} sitúan los
-campos de texto @code{piece} y @code{opus} en extremos opuestos de la
-misma línea.
+Para cambiar la disposición predeterminada, véase
+@ref{Personalización de los títulos}.
@cindex breakbefore
-Utilice la variable @code{breakbefore} dentro de un bloque
-@code{\header} que está propiamente dentro de un bloque @code{\score}
-para hacer que los títulos del bloque @code{\header} del nivel
-superior aparezcan ocupando toda la primera página, empezando la
-música (definida en el bloque @code{\score}) en la página siguiente.
+Si un bloque @code{\book} comienza inmediatamente con un bloque
+@code{\bookpart}, no se imprime ningún título de libro, pues no
+existe ninguna página en que imprimirlo. Si es necesario un
+título de libro, inicie el bloque @code{\book} con algún material
+de marcado o con una instrucción @code{\pageBreak}.
-@lilypond[papersize=a8landscape,verbatim,noragged-right]
+Utilice la variable @code{breakbefore} dentro de un bloque
+@code{\header} que está propiamente dentro de un bloque
+@code{\score} para hacer que los títulos del bloque
+@code{\header} del nivel superior aparezcan ocupando toda la
+primera página, empezando la música (definida en el bloque
+@code{\score}) en la página siguiente.
+
+@c KEEP LY
+@lilypond[papersize=c7landscape,verbatim,noragged-right]
\book {
\header {
- title = "This is my Title"
- subtitle = "This is my Subtitle"
- copyright = "This is the bottom of the first page"
+ title = "Este es mi Title (título)"
+ subtitle = "Este es mi Subtitle (subtítulo)"
+ copyright = "Este es el final de la primera página"
}
\score {
\repeat unfold 4 { e'' e'' e'' e'' }
\header {
- piece = "This is the Music"
+ piece = "Esto es la música"
breakbefore = ##t
}
}
@rlearning{Cómo funcionan los archivos de entrada de LilyPond}
Referencia de la notación:
+@ref{Personalización de los títulos},
@ref{Estructura del archivo}.
Archivos de inicio:
@file{ly/titling-init.ly}.
+
@node Disposición predeterminada de las cabeceras y pies de página
@unnumberedsubsubsec Disposición predeterminada de las cabeceras y pies de página
@translationof Default layout of headers and footers
-Las @emph{cabeceras} y los @emph{pies} de página son líneas de texto
-que aparecen en la parte más alta y en la más baja de las páginas
-separadas del texto principal de un libro. Se controlan mediante las
-siguientes variables de @code{\paper}:
+Las @emph{cabeceras} y los @emph{pies} de página son líneas de
+texto que aparecen en la parte más alta y en la más baja de las
+páginas separadas del texto principal de un libro. Se controlan
+mediante las siguientes variables de @code{\paper}:
@itemize
@item @code{oddHeaderMarkup} (marcado de cabecera impar)
@item @code{evenFooterMarkup} (marcado de pie par)
@end itemize
-Estas variables de marcado sólo pueden acceder a los campos de texto
-extraídos de bloques @code{\header} del nivel superior (que se aplican
-a todas las partituras del libro) y se definen en el archivo
-@file{ly/titling-init.ly}. De forma predeterminada:
+Estas variables de marcado sólo pueden acceder a los campos de
+texto extraídos de bloques @code{\header} del nivel superior (que
+se aplican a todas las partituras del libro) y se definen en el
+archivo @file{ly/titling-init.ly}. De forma predeterminada:
@itemize
@item
-los números de página se sitúan automáticamente en el extremo superior
-izquierdo (si es par) o superior derecho (si es impar), a partir de la
-segunda página.
+los números de página se sitúan automáticamente en el extremo
+superior izquierdo (si es par) o superior derecho (si es impar),
+a partir de la segunda página.
@item
el campo de texto @code{instrument} se sitúa en el centro en cada
página, a partir de la segunda página.
@item
-el texto de @code{copyright} se centra en la parte baja de la primera
-página.
+el texto de @code{copyright} se centra en la parte baja de la
+primera página.
@item
la línea @code{tagline} se centra al final de la última página, y
@end itemize
-@lilypond[papersize=a8landscape]
-\book {
- \score {
- \relative c' {
- c4 d e f
- }
- }
-}
-@end lilypond
-
-La línea de etiqueta tagline predeterminada se puede cambiar añadiendo un campo
-@code{tagline} en el bloque @code{\header} del nivel superior.
+La línea predeterminada de pie de página de LilyPond se puede
+cambiar añadiendo un campo @code{tagline} en el bloque
+@code{\header} del nivel superior.
@lilypond[papersize=a8landscape,verbatim]
\book {
tagline = "... music notation for Everyone"
}
\score {
- \relative c' {
- c4 d e f
+ \relative {
+ c'4 d e f
}
}
}
@end lilypond
-Para eliminar la línea @code{tagline}, establezca su valor a
-@code{##f}.
+Para eliminar la línea de pie de página predeterminada de
+LilyPond, establezca el valor de @code{tagline} a @code{##f}.
-@node Cabeceras pies y títulos personalizados
-@subsection Cabeceras, pies y títulos personalizados
-@translationof Custom headers footers and titles
+@node Títulos encabezamientos y pies de página personalizados
+@subsection Títulos, encabezamientos y pies de página personalizados
+@translationof Custom titles headers and footers
@c TODO: somewhere put a link to header spacing info
@c (you'll have to explain it more in NR 4).
@menu
-* Formateo personalizado del texto de los bloques de título::
-* Personalización de los bloques de título::
+* Formateo personalizado del texto de los títulos::
+* Personalización de los títulos::
* Disposición personalizada de cabeceras y pies de página::
@end menu
-@node Formateo personalizado del texto de los bloques de título
+@node Formateo personalizado del texto de los títulos
@unnumberedsubsubsec Formateo personalizado del texto de los bloques de título
-@translationof Custom text formatting for title blocks
+@translationof Custom text formatting for titles
-Se pueden usar instrucciones @code{\markup} estándar para personalizar
-el texto de cualquier cabecera, pie o título dentro del bloque
-@code{\header}.
+Se pueden usar instrucciones @code{\markup} estándar para
+personalizar el texto de cualquier cabecera, pie o título dentro
+del bloque @code{\header}.
@lilypond[quote,verbatim,noragged-right]
\score {
{ s1 }
\header {
piece = \markup { \fontsize #4 \bold "PRAELUDIUM I" }
- subtitle = \markup { \italic "(Excerpt)" }
+ opus = \markup { \italic "BWV 846" }
}
}
@end lilypond
@ref{Formatear el texto}.
-@node Personalización de los bloques de título
-@unnumberedsubsubsec Personalización de los bloques de título
-@translationof Custom layout for title blocks
+@node Personalización de los títulos
+@unnumberedsubsubsec Personalización de los títulos
+@translationof Custom layout for titles
-Las instrucciones @code{\markup} dentro del bloque @code{\header} son
-útiles para dar un formato simple al texto, pero no permiten un
-control preciso sobre la colocación de los títulos. Para personalizar
-la colocación de los campos de texto, use una o las dos variables de
-@code{\paper} siguientes:
+@cindex bookTitleMarkup
+@cindex scoreTitleMarkup
+@funindex bookTitleMarkup
+@funindex scoreTitleMarkup
+
+Las instrucciones @code{\markup} dentro del bloque @code{\header}
+son útiles para dar un formato simple al texto, pero no permiten
+un control preciso sobre la colocación de los títulos. Para
+personalizar la colocación de los campos de texto, cambie una o
+las dos variables de @code{\paper} siguientes:
@itemize
@item @code{bookTitleMarkup} (marcado de título del libro)
@item @code{scoreTitleMarkup} (marcado de título de la partitura)
@end itemize
-Estas variables de marcado se estudian en
-@ref{Presentación predeterminada de los bloques de título del libro y la partitura}.
+La colocación de los títulos cuando se utilizan los valores
+predeterminados de estas variables de @code{\markup} se muestra
+en los ejemplos de
+@ref{Presentación predeterminada de los títulos de partes de libro y partitura}.
-Los ajustes predeterminados para @code{scoreTitleMarkup} tal y como
-están definidos en el archivo @file{ly/titling-init.ly} son:
+Los ajustes predeterminados para @code{scoreTitleMarkup} tal y
+como están definidos en el archivo @file{ly/titling-init.ly} son:
@example
scoreTitleMarkup = \markup @{ \column @{
- \on-the-fly #print-all-headers @{ \bookTitleMarkup \hspace #1 @}
+ \on-the-fly \print-all-headers @{ \bookTitleMarkup \hspace #1 @}
\fill-line @{
\fromproperty #'header:piece
\fromproperty #'header:opus
}
@end lilypond
-Este ejemplo redefine @code{scoreTitleMarkup} de manera que el campo
-de texto @code{piece} aparece centrado y en un tipo de letra grande y
-en negrita.
+Este ejemplo redefine @code{scoreTitleMarkup} de manera que el
+campo de texto @code{piece} aparece centrado y en un tipo de
+letra grande y en negrita.
@lilypond[papersize=a5,quote,verbatim,noragged-right]
\book {
}
@end lilypond
-Los campos de texto reservados normalmente para el bloque principal de
-título se pueden insertar dentro de los bloques de título de las
-partituras individuales con la variable @code{print-all-headers}
-establecida dentro del bloque @code{\paper}. Una desventaja de la
-utilización de este método es que los campos de texto que están
-orientados específicamente para el bloque @code{\header} del nivel
-superior han de suprimirse manualmente en cada uno de los bloques
-@code{\score}. Véase @ref{Explicación de los bloques de títulos}.
+Los campos de texto que normalmente no son efectivos dentro de
+los bloques @code{\header} de una partitura se pueden imprimir el
+la zona del Título de la partitura si se coloca
+@code{print-all-headers} dentro del bloque @code{\paper}. Una
+desventaja de la utilización de este método es que los campos de
+texto que están orientados específicamente para la zona del
+título de parte de libro han de suprimirse manualmente en cada
+uno de los bloques @code{\score}. Véase @ref{Explicación de los
+títulos}.
Para evitarlo, añada el campo de texto deseado a la definición de
-@code{scoreTitleMarkup}. En el ejemplo siguiente, el campo de texto
-@code{composer} (asociado normalmente con @code{bookTitleMarkup}) se
-añade a @code{scoreTitleMarkup}, permitiendo que cada partitura
-muestre un compositor diferente:
+@code{scoreTitleMarkup}. En el ejemplo siguiente, el campo de
+texto @code{composer} (asociado normalmente con
+@code{bookTitleMarkup}) se añade a @code{scoreTitleMarkup},
+permitiendo que cada partitura muestre un compositor diferente:
@lilypond[papersize=a5,quote,verbatim,noragged-right]
\book {
}
@end lilypond
-También podemos crear nuestros propios campos de texto personalizados,
-y referirnos a ellos en la definición del elemento de marcado.
+También podemos crear nuestros propios campos de texto
+personalizados, y referirnos a ellos en la definición del
+elemento de marcado.
@lilypond[papersize=a5,quote,verbatim,noragged-right]
\book {
@seealso
Referencia de la notación:
-@ref{Explicación de los bloques de títulos}.
+@ref{Explicación de los títulos}.
@node Disposición personalizada de cabeceras y pies de página
@c can make-header and make-footer be removed from
@c paper-defaults-init.ly? -mp
-Las instrucciones @code{\markup} dentro del bloque @code{\header} son
-de utilidad para dar formato al texto de una manera sencilla, pero no
-permiten un control preciso sobre la colocación de las cabeceras y los
-pies de página. Para personalizar la colocación de los campos de
-texto, use una o más de las siguientes variables de @code{\paper}:
+Las instrucciones @code{\markup} dentro del bloque @code{\header}
+son de utilidad para dar formato al texto de una manera sencilla,
+pero no permiten un control preciso sobre la colocación de las
+cabeceras y los pies de página. Para personalizar la colocación
+de los campos de texto, use una o más de las siguientes variables
+de @code{\paper}:
@itemize
@item @code{oddHeaderMarkup} (marcado de encabezamiento impar)
@item @code{evenFooterMarkup} (marcado de pie de página par)
@end itemize
-El ejemplo siguiente centra los números de página en la parte baja de
-las páginas. En primer lugar, los ajustes predeterminados para
-@code{oddHeaderMarkup} y @code{evenHeaderMarkup} se eliminan
-definiéndolos como un marcado @emph{nulo}. Después de esto, se
-redefine @code{oddFooterMarkup} con el número de página centrado.
-Finalmente, @code{evenFooterMarkup} recibe la misma disposición
-definiéndola como @code{\oddFooterMarkup}:
+@cindex marcado condicional
+@cindex on-the-fly
+@funindex \on-the-fly
+
+La instrucción de marcado @code{\on-the-fly} se puede utilizar
+para añadir elementos de forma condicional al texto de
+encabezamiento y pie de página definido dentro del bloque
+@code{\paper}, usando la sintaxis siguiente:
+
+@example
+variable = \markup @{
+ @dots{}
+ \on-the-fly \@var{procedimiento} @var{marcado}
+ @dots{}
+@}
+@end example
+
+El @var{procedimiento} se llama cada vez que se evalúa la
+instrucción @code{\markup} en que ésta aparece. El
+@var{procedimiento} debería comprobar si se cumple una condición
+determinada e interpretar (es decir: imprimir) el argumento
+@var{marcado} si, y sólo si, la condición es verdadera.
+
+Se proveen un cierto número de procedimientos ya hechos para la
+comprobación de diversas condiciones:
+
+@quotation
+@multitable {print-page-number-check-first-----} {¿es el núm. de páginas en la parte de libro > 1?-----}
+
+@headitem Nombre del procedimiento @tab Condición que se comprueba
+
+@item print-page-number-check-first @tab ¿debería imprimirse esta página?
+@item create-page-number-stencil @tab ¿es print-page-numbers verdadero?
+@item print-all-headers @tab ¿es print-all-headers verdadero?
+@item first-page @tab ¿es la primera página del libro?
+@item (on-page nmbr) @tab ¿es el número de página = nmbr?
+@item last-page @tab ¿es la última página del libro?
+@item not-first-page @tab ¿no es la primera página del libro?
+@item part-first-page @tab ¿es la primera página de la parte de libro?
+@item part-last-page @tab ¿es la última página de la parte de libro?
+@item not-single-page @tab ¿es el núm. de páginas en la parte de libro > 1?
+
+@end multitable
+@end quotation
+
+El ejemplo siguiente centra los números de página en la parte
+baja de las páginas. En primer lugar, los ajustes
+predeterminados para @code{oddHeaderMarkup} y
+@code{evenHeaderMarkup} se eliminan definiéndolos como un marcado
+@emph{nulo}. Después de esto, se redefine @code{oddFooterMarkup}
+con el número de página centrado. Finalmente,
+@code{evenFooterMarkup} recibe la misma disposición definiéndola
+como @code{\oddFooterMarkup}:
@lilypond[papersize=a8,quote,verbatim,noragged-right]
\book {
evenHeaderMarkup = \markup \null
oddFooterMarkup = \markup {
\fill-line {
- \on-the-fly #print-page-number-check-first
+ \on-the-fly \print-page-number-check-first
\fromproperty #'page:page-number-string
}
}
}
@end lilypond
+Se pueden combinar varias condiciones de @code{\on-the-fly} con
+un operador @q{and}, por ejemplo:
+
+@example
+ \on-the-fly \first-page
+ \on-the-fly \last-page
+ @code{@{ \markup @dots{} \fromproperty #'header: @dots{} @}}
+@end example
+
+determina si la salida es una sola página.
+
@seealso
-Notation Reference:
-@ref{Explicación de los bloques de títulos},
-@ref{Presentación predeterminada de los bloques de título del libro y la partitura}.
+Referencia de la notación:
+@ref{Explicación de los títulos},
+@ref{Presentación predeterminada de los títulos de partes de libro y partitura}.
+
+Archivos instalados:
+@file{../ly/titling-init.ly}.
+
+@node Creación de metadatos de PDF
+@subsection Creación de metadatos de PDF
+@translationof Creating PDF metadata
+
+@cindex metadatos de PDF
+
+Además de mostrarse en la salida impresa, las variables de
+encabezamiento de @code{\header} se usan para establecer los
+metadatos de PDF (la información que muestran los lectores de PDF
+como @code{propiedades} del archivo). Por ejemplo, si se
+establece la propiedad @code{title} del bloque @code{header} como
+@q{Sinfonía núm. 1}, el documento PDF llevará también este
+título.
+
+@example
+ \header@{
+ title = "Sinfonía núm. 1"
+ @}
+@end example
+
+Si quiere fijar el título de la salida impresa con un texto pero
+quiere que la propiedad de título del PDF tenga un texto
+diferente, puede usar @code{pdftitle} como se muestra a
+continuación.
+
+@example
+ \header@{
+ title = "Sinfonía núm. 1"
+ pdftitle = "Sinfonía núm. 1 de Beethoven"
+ @}
+@end example
+
+Todas las variables @code{title}, @code{subject},
+@code{keywords}, @code{subtitle}, @code{composer},
+@code{arranger}, @code{poet}, @code{author} y @code{copyright}
+establecen propiedades del PDF y pueden hacerse preceder de
+@q{pdf} para fijar una propiedad del archivo PDF a un valor
+distinto del de la salida impresa.
+
+La propiedad de PDF @code{Creator} se fija automáticamente a
+@q{LilyPond} más la versión actual de LilyPond, y las variables
+@code{CreationDate} y @code{ModDate} se fijan a la fecha y hora
+actuales. Se puede sobreescribir @code{ModDate} mediante el
+establecimiento de un valor para la variable de cabecera
+@code{moddate} (o @code{pdfmoddate}) a una cadena de fecha de PDF
+válida.
@node Crear notas al pie
@subsection Crear notas al pie
@translationof Creating footnotes
+@cindex notas al pie
+
Se pueden crear dos tipos de notas al pie: automáticas y manuales.
@menu
-* Panorámica de las notas al pie::
-* Notas al pie automáticas::
-* Notas al pie manuales::
+* Notas al pie dentro de expresiones musicales::
+* Notas al pie en texto independiente::
@end menu
-@node Panorámica de las notas al pie
-@unnumberedsubsubsec Panorámica de las notas al pie
-@translationof Footnotes overview
+@node Notas al pie dentro de expresiones musicales
+@unnumberedsubsubsec Notas al pie dentro de expresiones musicales
+@translationof Footnotes in music expressions
+
+@cindex notas al pie dentro de expresiones musicales
+@funindex \footnote
+
+@subsubsubheading Panorámica de las notas al pie
-Las notas al pie automáticas crean indicadores numéricos
-incrementales; las notas al pie manuales, en cambio, permiten crear un
-indicador personalizado. Se pueden anotar todos los grobs (objetos
-gráficos), elementos @code{\markup} del nivel superior y las notas de
-los acordes.
+Las notas al pie dentro de expresiones musicales caen dentro de
+dos categorías:
-El orden en que se dibuja cada grob determina el orden en que se crean
-los indicadores (y por tanto las notas al pie) durante la compilación.
+@table @emph
+@item Notas al pie basadas en eventos
+Se adjuntan a un evento en particular. Son ejemplos de tales
+eventos las notas sueltas, las articulaciones (como indicaciones
+de digitación, acentos, indicaciones dinámicas) y los
+post-eventos (como las ligaduras de expresión y las barras de
+corchea manuales). La forma general de las notas al pie basadas
+en eventos es como sigue:
-@node Notas al pie automáticas
-@unnumberedsubsubsec Notas al pie automáticas
-@translationof Automatic footnotes
+@example
+[@var{dirección}] \footnote [@var{marca}] @var{desplazamiento} @var{texto-de-la-nota} @var{música}
+@end example
-Las notas al pie automáticas aceptan tres argumentos; el @var{Objeto de
-presentación} que anotar, la posición @samp{(x . y)} del indicador y un
-elemento de @code{\markup} que aparecerá en la nota, en la parte
-inferior de la página.
+@item Notas al pie basadas en tiempo
+Se ligan a un punto temporal determinado, dentro de un contexto
+musical. Algunas instrucciones como @code{\time} y @code{\clef}
+en realidad no usan eventos para crear objetos como la indicación
+de compás y la clave. Un acorde tampoco crea un evento por sí
+mismo: su plica o corchete se crea al final de un paso de tiempo
+(nominalmente, a través de uno de los eventos de nota que
+contiene). Una nota al pie basada en tiempo permite anotar tales
+objetos de presentación sin referirse a ningún evento.
-La instrucción @code{\footnote} debe ir @emph{antes} del grob
-al que se adjunta la nota al pie:
+Una nota al pie basada en tiempo permite que tales objetos de
+presentación se puedan anotar sin hacer referencia a un evento.
+La forma general para las notas al pie basadas en tiempo es:
-@lilypond[verbatim,quote,ragged-right,papersize=a8]
+@example
+\footnote [@var{marca}] @var{desplazamiento} @var{texto-de-la-nota} [@var{Contexto}].@var{Nombre-del-Grob}
+@end example
+
+@end table
+
+Los elementos para las dos formas son como sigue:
+
+@table @var
+
+@item dirección
+Si (y sólo si) el @code{\footnote} se está aplicando a un
+post-evento o articulación, debe ir precedida de un indicador de
+dirección (@code{-, _, ^}) con el objeto de adjuntar la
+@var{música} (con una marca de nota al pie) a la nota o silencio
+precedente.
+
+@item marca
+es un elemento de marcado o cadena de caracteres que especifica
+la marca de nota al pie que se usa para marcar tanto el punto de
+referencia como la propia nota al pie en la parte inferior de la
+página. Se puede omitir (o, de forma equivalente, sustituirse
+por @code{\default}) en cuyo caso se genera un número
+secuencialmente de forma automática. Tales secuencias numéricas
+se reinician en cada página que contiene una nota al pie.
+
+@item desplazamiento
+es una pareja de números tal como @samp{#(2 . 1)} que especifica
+los desplazamientos en X y en Y en unidades de espacios de
+pentagrama a partir del límite del objeto en que se desea situar
+la marca. Los valores de desplazamiento positivos se toman a
+partir del borde superior derecho, los valores negativos a partir
+del borde inferior izquierdo y cero implica que la marca se
+centra sobre el borde.
+
+@item Contexto
+es el contexto en que se crea el grob que recibe la nota al pie.
+Se puede omitir si el grob está en un contexto del nivel inferior,
+p. ej. un contexto @code{Voice}.
+
+@item Nombre-del-Grob
+especifica un tipo de grob que marcar (como @samp{Flag} para el
+corchete). Si se da, la nota al pie no se adjunta a una
+expresión musical en particular, sino a todos los grobs del tipo
+especificado que ocurren en dicho momento de tiempo musical.
+
+@item texto-de-la-nota
+es el elemento de marcado o cadena de caracteres que especifica
+el texto de la nota al pie que utilizar en la parte baja de la
+página.
+
+@item música
+es el evento musical, post-evento o articulación que se
+está anotando.
+
+@end table
+
+@subsubsubheading Notas al pie basadas en eventos
+
+@cindex Notas al pie, basadas en eventos
+
+Una nota al pie se adjunta a un objeto de presentación causado
+directamente por el evento que corresponde a @var{música}, con la
+sintaxis siguiente:
+
+@example
+\footnote [@var{marca}] @var{desplazamiento} @var{texto-de-la-nota} @var{música}
+@end example
+
+@c KEEP LY
+@lilypond[quote,verbatim,papersize=a8landscape]
\book {
\header { tagline = ##f }
- \relative c' {
- \footnote #'(0.5 . -2) #'NoteHead
- \markup { The first note }
- a'4 b8
- \footnote #'(0.5 . 1) #'NoteHead
- \markup { The third note }
- e c4 d4
+ \relative c'' {
+ \footnote #'(-1 . 3) "Una nota" a4
+ a4
+ \footnote #'(2 . 2) "Un silencio" r4
+ a4
}
}
@end lilypond
-Para anotar las notas de un acorde, la instrucción
-@code{\footnote} debe ir @emph{después} de la nota a la que se
-quiere adjuntar la nota al pie como un @code{TextScript}:
+No es posible marcar un acorde @emph{completo} con una nota al
+pie basada en evento: un acorde, incluso aquel que contiene una
+sola nota, no produce un verdadero evento por sí mismo. Sin
+embargo, las notas individuales que están @emph{dentro} del
+acorde sí se pueden marcar:
-@lilypond[verbatim,quote,ragged-right,papersize=a8]
+@c KEEP LY
+@lilypond[quote,verbatim,papersize=a8landscape]
\book {
\header { tagline = ##f }
- \relative c' {
- <
- c-\footnote #'(1 . -1.25) "Here is a C"
- es-\footnote #'(2 . -0.25) \markup { \italic "An E-flat" }
- g-\footnote #'(2 . 3) \markup { \bold "This is a G" }
- >1
+ \relative c'' {
+ \footnote #'(2 . 3) "No funciona" <a-3>2
+ <\footnote #'(-2 . -3) "Funciona" a-3>4
+ <a-3 \footnote #'(3 . 1/2) "También funciona" c-5>4
}
}
@end lilypond
-@warning{Cuando las notas al pie tienen la misma posición vertical, se
-imprimen en orden de descendencia: cuando más alta es la nota al pie,
-más arriba está en la lista.}
+Si se desea que la nota al pie se adjunte a un post-evento o
+articulación, la instrucción @code{\footnote} @emph{debe} ir
+precedida por un indicador de dirección, @code{-, _, ^}, y
+seguida por el post-evento o articulación que se desea anotar
+como argumento @var{música}. En esta forma, la @code{\footnote}
+se puede considerar como una simple copia de su último argumento
+con una marca de nota al pie adjunta. La sintaxis es:
-He aquí unos ejemplos más de grobs con notas al pie, que
-muestran también la posición relativa de las notas respecto de la
-línea informativa y la línea de copyright.
+@example
+@var{dirección} \footnote [@var{marca}] @var{desplazamiento} @var{texto-de-la-nota} @var{música}
+@end example
-@lilypond[verbatim,quote,ragged-right,papersize=a8]
+@c KEEP LY
+@lilypond[quote,verbatim,papersize=a8landscape]
\book {
- \header { copyright = \markup { "Copyright 1970" } }
- \relative c' {
- \footnote #'(-3 . 0) #'DynamicText
- \markup { \bold Forte }
-
- \footnote #'(0 . 1.5) #'Slur
- \markup { A slur }
- a'4\f(
+ \header { tagline = ##f }
+ \relative {
+ a'4_\footnote #'(0 . -1) "Ligadura forzada hacia abajo" (
+ b8^\footnote #'(1 . 0.5) "Barra manual forzada hacia arriba" [
+ b8 ]
+ c4 )
+ c-\footnote #'(1 . 1) "Tenuto" --
+ }
+}
+@end lilypond
- \footnote #'(0 . -2) #'Beam
- \markup { Beam }
- b8)[ e]
+@subsubsubheading notas al pie basadas en tiempo
- \footnote #'(1 . -1) #'Stem
- \markup { \teeny { This is a stem } }
- c4
+@cindex notas al pie, basadas en tiempo
- \footnote #'(0 . 0.5) #'AccidentalCautionary
- \markup \italic { A cautionary accidental }
+Si el objeto de presentación que recibe la nota al pie está
+causado @emph{indirectamente} por un evento (como un objeto
+@code{Accidental}, alteración, o @code{Stem}, plica, causados por
+un evento @code{NoteHead}, cabeza de nota), el nombre del grob
+@var{GrobName} del objeto de presentación es necesario después
+del texto de la nota al pie, en lugar de @var{música}:
- \footnote #'(0.5 . -0.5) #'TextScript
- \markup \italic { Slow Down }
- dis?4_"rit."
+@c KEEP LY
+@lilypond[quote,verbatim,papersize=a8landscape]
+\book {
+ \header { tagline = ##f }
+ \relative c'' {
+ \footnote #'(-1 . -3) "Un bemol" Accidental
+ aes4 c
+ \footnote #'(-1 . 0.5) "Otro bemol" Accidental
+ ees
+ \footnote #'(1 . -2) "Una plica" Stem
+ aes
}
}
@end lilypond
-Para los elementos @code{\markup} del nivel superior, se requiere el
-uso de la instrucción @code{\auto-footnote}:
+Sin embargo, observe que cuando se especifica el nombre de un
+grob, se adjunta una nota al pie a todos los grobs de ese tipo
+dentro del instante de tiempo actual:
-@lilypond[verbatim,quote,ragged-right,papersize=a8]
+@c KEEP LY
+@lilypond[quote,verbatim,papersize=a8landscape]
\book {
\header { tagline = ##f }
- \markup { \auto-footnote "A simple tune" \italic "By me" }
\relative c' {
- a'4 b8 e c4 d
+ \footnote #'(-1 . 3) "Un bemol" Accidental
+ <ees ges bes>4
+ \footnote #'(2 . 0.5) "Articulación" Script
+ c'->-.
}
}
@end lilypond
+Una nota dentro de un acorde puede recibir una nota al pie
+individual, basada en evento. El único grob causado directamente
+por una nota de un acorde es @samp{NoteHead}, por lo que la
+instrucción de nota al pie basada en evento @emph{solamente} es
+apta para añadir una nota al pie a la @samp{NoteHead} dentro de
+un acorde. Todos los demás grobs de notas de acorde están
+causados indirectamente. La propia instrucción @code{\footnote}
+no ofrece ninguna sintaxis para especificar al mismo tiempo un
+tipo concreto de grob @emph{y también} un evento concreto al que
+adjuntar la nota. Sin embargo, se puede usar una instrucción
+@code{\footnote} basada en tiempo para especificar el tipo de
+grob, y luego añadir la instrucción @code{\single} como prefijo,
+con el objeto de que se aplique solamente al evento siguiente:
+
+@c KEEP LY
+@lilypond[quote,verbatim,papersize=a8landscape]
+\book {
+ \header { tagline = ##f }
+ \relative c'' {
+ < \footnote #'(1 . -2) "Un La" a
+ \single \footnote #'(-1 . -1) "Un sostenido" Accidental
+ cis
+ \single \footnote #'(0.5 . 0.5) "Un bemol" Accidental
+ ees fis
+ >2
+ }
+}
+@end lilypond
-@node Notas al pie manuales
-@unnumberedsubsubsec Notas al pie manuales
-@translationof Manual footnotes
-
-@cindex notas al pie manuales
-
-Las notas al pie manuales toman cuatro argumentos;
-el @var{objeto de presentación} que se va a anotar,
-la posición @samp{(x . y)} del indicador, y dos instrucciones
-@code{\markup}; la primera es el indicador adjunto a la nota o grob, y
-la segunda es la nota al pie, en la parte inferior de la página.
+@warning{Cuando las notas al pie se adjuntan a varios elementos musicales
+que están dentro del mismo momento musical, como ocurre en el
+ejemplo anterior, las notas al pie se numeran desde los elementos
+más altos a los más bajos tal y como aparecen en la salida
+impresa, no en el orden en que se escriben en el flujo de
+entrada.}
+
+Los objetos de presentación como las claves y las armaduras de
+cambio de tonalidad están, más bien, causadas por propiedades que
+cambian, y no por eventos. Otros, como las líneas divisorias y
+los números de compás, son una consecuencia directa del paso del
+tiempo. Por esta razón, las notas al pie sobre tales objetos
+tienen que basarse en su tiempo musical. Las notas al pie
+basadas en tiempo so preferibles también cuando se marcan cosas
+como las plicas y las barras de corchea en @emph{acordes}: dado
+que estas funcionalidades de cada acorde individual están
+asignadas normalmente a @emph{un solo} evento dentro del acorde,
+sería imprudente descansar en una elección particular.
+
+En las notas al pie basadas en tiempo, siempre se debe
+especificar explícitamente el objeto de presentación en cuestión,
+y si el grob se crea dentro de un contexto distinto al de nivel
+más bajo, debe especificarse el contexto apropiado.
+
+@c KEEP LY
+@lilypond[quote,verbatim,papersize=a8landscape]
+\book {
+ \header { tagline = ##f }
+ \relative c'' {
+ r1 |
+ \footnote #'(-0.5 . -1) "Cambio de compás" Staff.TimeSignature
+ \time 3/4
+ \footnote #'(1 . -1) "Plica de acorde" Stem
+ <c e g>4 q q
+ \footnote #'(-0.5 . 1) "Línea divisoria" Staff.BarLine
+ q q
+ \footnote #'(0.5 . -1) "Cambio de tonalidad" Staff.KeySignature
+ \key c\minor
+ q
+ }
+}
+@end lilypond
-Como las notas al pie automáticas, las instrucciones
-@code{\footnote} manuales deben ir @emph{después} del grob
-que la nota al pie está anotando y adjuntada como un
-@code{TextScript}:
+Se pueden usar marcas personalizadas como alternativas a las
+marcas numéricas, y se puede suprimir la línea de anotación que
+une el objeto marcado con su marca:
-@lilypond[verbatim,quote,ragged-right,papersize=a8]
+@c KEEP LY
+@lilypond[quote,verbatim,papersize=a8landscape]
\book {
\header { tagline = ##f }
\relative c' {
- a'4-\footnote
- "1" #'(0.5 . -2) #'NoteHead \markup { \italic "1. The first note" }
+ \footnote "*" #'(0.5 . -2) \markup { \italic "* La primera nota" } a'4
b8
- e-\footnote
- \markup { \bold "2" } #'(0.5 . 1) #'NoteHead "2. The second note"
+ \footnote \markup { \super "$" } #'(0.5 . 1)
+ \markup { \super "$" \italic " La segunda nota" } e
c4
- d\p-\footnote "3" #'(0.5 . -1) #'DynamicText "3. Piano"
+ \once \override Score.FootnoteItem.annotation-line = ##f
+ b-\footnote \markup \tiny "+" #'(0.1 . 0.1)
+ \markup { \super "+" \italic " Editorial" } \p
}
}
@end lilypond
-Para anotar notas de acordes con notas al pie manuales:
+Se muestran más ejemplos de marcas personalizadas en
+@ref{Notas al pie en texto independiente}.
+
+
+@node Notas al pie en texto independiente
+@unnumberedsubsubsec Notas al pie en texto independiente
+@translationof Footnotes in stand-alone text
+
+@cindex notas al pie en texto independiente
+
+Se utilizan dentro de un elemento de marcado fuera de cualquier
+expresión musical. No se traza una línea hasta el punto de
+referencia: la marca simplemente sigue al elemento de marcado que
+se referencia. Se pueden insertar las marcas automáticamente, en
+cuyo caso son numéricas. De forma alternativa, se pueden aportar
+manualmente marcas personalizadas.
+
+Las notas al pie para texto independiente con marcas automáticas
+y personalizadas se crean de distintas formas.
+
+@subsubsubheading Notas al pie en texto independiente con marcas automáticas
+
+La sintaxis de una nota al pie sobre texto independiente con
+marcas automáticas es
+
+@example
+\markup @{ @dots{} \auto-footnote @var{texto} @var{nota} @dots{} @}
+@end example
+
+Los elementos son:
+
+@table @var
+
+@item texto
+es el elemento de marcado o cadena de caracteres que se desea
+anotar.
+
+@item nota
+es el elemento de marcado o cadena de caracteres que especifica
+el texto de la nota al pie que utilizar en la parte baja de la
+página.
+
+@end table
+
+Por ejemplo:
@lilypond[verbatim,quote,ragged-right,papersize=a8]
\book {
\header { tagline = ##f }
- \relative c' {
- <
- c-\footnote "1" #'(1 . -1.25) "1. C"
- es-\footnote
- \markup { \bold "b" } #'(2 . -0.25) "b. E-flat"
- g-\footnote "3" #'(2 . 3) \markup { \italic "iii. G" }
- >1
+ \markup {
+ "A simple"
+ \auto-footnote "tune" \italic " By me"
+ "is shown below. It is a"
+ \auto-footnote "recent" \italic " Aug 2012"
+ "composition."
+ }
+ \relative {
+ a'4 b8 e c4 d
}
}
@end lilypond
-@warning {Cuando las notas al pie tienen la misma posición vertical, las
-anotaciones se imprimen en orden de descendencia; cuanto más alta es
-la nota al pie, más arriba está en la lista.}
+@subsubsubheading Notas al pie sobre texto independiente con marcas personalizadas
+
+La sintaxis de una nota al pie sobre texto independiente con
+marcas personalizadas es
-He aquí algunos ejemplos de grobs anotados manualmente, mostrando
-también la posición relativa de las notas al pie respecto a la línea
-informativa a la de copyright:
+@example
+\markup @{ @dots{} \footnote @var{marca} @var{nota} @dots{} @}
+@end example
+
+Los elementos son:
+
+@table @var
+
+@item marca
+es un elemento de marcado o cadena de caracteres que especifica
+la marca que se usa para señalar el punto de referencia. Observe
+que esta marca @emph{no} se inserta automáticamente antes de la
+propia nota al pie.
+
+@item nota
+es el elemento de marcado o cadena de caracteres que especifica
+el texto de la nota que aparece en la parte baja de la página,
+precedida por la @var{marca} especificada.
+
+@end table
+
+Se puede usar como marca un carácter fácil de teclear, como * ó +,
+según se muestra en @ref{Notas al pie dentro de expresiones musicales}.
+De forma alternativa, se pueden usar alias en ASCII (véase
+@ref{Alias de ASCII}):
@lilypond[verbatim,quote,ragged-right,papersize=a8]
\book {
+ \paper { #(include-special-characters) }
\header { tagline = ##f }
- \relative c' {
- \footnote
- \markup { \teeny 1 } #'(-3 . 0) #'DynamicText
- \markup { 1. \bold Forte }
-
- \footnote
- \markup { \teeny b } #'(0 . 1.5) #'Slur
- \markup { b. A slur }
- a'4\f(
-
- \footnote
- \markup { \teeny 3 } #'(0 . -2) #'Beam
- \markup { 3. Beam }
- b8)[ e]
-
- \footnote
- \markup { 4 } #'(1 . -1) #'Stem
- \markup { \bold 4. { This is a stem } }
- c4
-
- \footnote
- \markup \concat \teeny { "sharp (v)" }
- #'(0 . 0.5) #'AccidentalCautionary
- \markup \italic { v. A cautionary accidental }
-
- \footnote
- \markup \concat \teeny { "a" } #'(0.5 . -0.5) #'TextScript
- \markup \italic { a. Slow Down }
- dis?4_"rit."
-
- \breathe
- \footnote
- \markup { \teeny \musicglyph #"rests.4" }
- #'(1.5 . -0.25) #'BreathingSign
- \markup { \null }
+ \markup {
+ "A simple tune"
+ \footnote "*" \italic "* By me"
+ "is shown below. It is a recent"
+ \footnote \super † \concat {
+ \super † \italic " Aug 2012"
+ }
+ "composition."
+ }
+ \relative {
+ a'4 b8 e c4 d
}
}
@end lilypond
-Para anotar manualmente un elemento @code{\markup} del nivel superior:
+También pueden utilizarse códigos de caracteres Unicode para
+especificar las marcas (véase @ref{Unicode}):
@lilypond[verbatim,quote,ragged-right,papersize=a8]
\book {
\header { tagline = ##f }
- \markup { "A simple tune" \footnote "*" \italic "* By me" }
- \relative c' {
- a'4 b8 e c4 d4
+ \markup {
+ "A simple tune"
+ \footnote \super \char##x00a7 \concat {
+ \super \char##x00a7 \italic " By me"
+ }
+ "is shown below. It is a recent"
+ \footnote \super \char##x00b6 \concat {
+ \super \char##x00b6 \italic " Aug 2012"
+ }
+ "composition."
+ }
+ \relative {
+ a'4 b8 e c4 d
}
}
@end lilypond
@rlearning{Objetos e interfaces}.
Referencia de la notación:
+@ref{ASCII aliases},
@ref{Globos de ayuda},
-@ref{Disposición de la página},
+@ref{Lista de caracteres especiales},
@ref{Indicaciones de texto},
@ref{Guiones de texto},
-@ref{Títulos y cabeceras}.
+@ref{Unicode}.
Referencia de funcionamiento interno:
@rinternals{FootnoteEvent},
@rinternals{Footnote_engraver}.
@knownissues
-Varias notas al pie en la misma página solo pueden ir apiladas unas
-sobre otras, y no se pueden imprimir en la misma línea. Las notas al
-pie no se pueden adjuntar a elementos de silencio multicompás
-@code{MultiMeasureRests}, y pueden colisionar con el objeto
-@code{Staff}, objetos de @code{\markup} y otras anotaciones
-@code{footnote}. Cuando use una cualquiera de las instrucciones
-@code{footnote} se requiere un bloque @code{\paper} que contenga
-@code{footnote-auto-number = ##f}.
+Varias notas al pie en la misma página solo pueden ir apiladas
+unas sobre otras; no se pueden imprimir en la misma línea.
+
+Las notas al pie no se pueden adjuntar a @code{MultiMeasureRests}
+(silencios multicompás), a barras de corchea automáticas ni a la
+letra de las canciones.
+
+Las notas al pie pueden colisionar con las pautas, objetos
+@code{\markup}, otras marcas de notas al pie y líneas de
+anotación.
@node Referencia a números de página
@translationof Reference to page numbers
Un lugar determinado de una partitura puede señalizarse usando la
-instrucción @code{\label} (etiqueta), ya sea en el nivel superior o
-dentro de la música. Podemos referirnos a esta etiqueta más tarde
-dentro de un elemento de marcado, para obtener el número de la página
-en la que se sitúa el punto señalizado, usando la instrucción de
-marcado @code{\page-ref}.
-
-@lilypond[verbatim]
+instrucción @code{\label} (etiqueta), ya sea en el nivel superior
+o dentro de la música. Podemos referirnos a esta etiqueta más
+tarde dentro de un elemento de marcado, para obtener el número de
+la página en la que se sitúa el punto señalizado, usando la
+instrucción de marcado @code{\page-ref}.
+
+@c KEEP LY
+@lilypond[verbatim,papersize=a8landscape]
\header { tagline = ##f }
\book {
\label #'firstScore
c'1
}
}
- \markup { The first score begins on page \page-ref #'firstScore "0" "?" }
- \markup { Mark A is on page \page-ref #'markA "0" "?" }
+ \markup { La primera partitura comienza en la página \page-ref #'firstScore "0" "?" }
+ \markup { La marca A está en la página \page-ref #'markA "0" "?" }
}
@end lilypond
La instrucción de marcado @code{\page-ref} toma tres argumentos:
@enumerate
-@item la etiqueta, un símbolo de scheme, p.ej. @code{#'firstScore};
+@item la etiqueta, un símbolo de Scheme, p.ej. @code{#'firstScore};
@item un elemento de marcado que se usará como medidor para estimar las dimensiones del marcado;
@item un elemento de marcado que se utilizará en sustitución del número de página si la etiqueta es desconocida.
@end enumerate
-El motivo de que se necesite un medidor es que en el momento en que se
-están interpretando los marcados, los saltos de página aún no se han
-producido y por tanto los números de página no se conocen todavía.
-Para sortear este inconveniente, la interpretación real del marcado se
-retrasa hasta un momento posterior; sin embargo, las dimensiones del
-marcado se tienen que conocer de antemano, así que se usa el medidor
-para decidir estas dimensiones. Si el libro tiene entre 10 y 99
-páginas, el medidor puede ser "00", es decir, un número de dos
-dígitos.
-
+El motivo de que se necesite un medidor es que en el momento en
+que se están interpretando los marcados, los saltos de página aún
+no se han producido y por tanto los números de página no se
+conocen todavía. Para sortear este inconveniente, la
+interpretación real del marcado se retrasa hasta un momento
+posterior; sin embargo, las dimensiones del marcado se tienen que
+conocer de antemano, así que se usa el medidor para decidir estas
+dimensiones. Si el libro tiene entre 10 y 99 páginas, el medidor
+puede ser "00", es decir, un número de dos dígitos.
@predefined
@funindex \label
@subsection Índice general
@translationof Table of contents
-Se puede insertar un índice general o tabla de contenidos utilizando
-la instrucción @code{\markuplist \table-of-contents}. Los elementos
-que deben aparecer en la tabla de contenidos se introducen con la
-instrucción @code{\tocItem}, que se puede usar en el nivel más alto de
-la jerarquía del código, o dentro de una expresión musical.
+Se puede insertar un índice general o tabla de contenidos
+utilizando la instrucción @code{\markuplist \table-of-contents}.
+Los elementos que deben aparecer en la tabla de contenidos se
+introducen con la instrucción @code{\tocItem}, que se puede usar
+en el nivel más alto de la jerarquía del código, o dentro de una
+expresión musical.
@verbatim
\markuplist \table-of-contents
@end verbatim
Los elementos de marcado que se usan para dar formato al índice
-general se encuentran definidos dentro del bloque @code{\paper}. Los
-elementos predeterminados son @code{tocTitleMarkup}, para dar formato
-al título de la tabla, y @code{tocItemMarkup}, para aplicar formato a
-los elementos del índice, que consisten en el título del elemento y el
-número de página. Estas variables se pueden cambiar por parte del
-usuario:
+general o tabla de contenidos se encuentran definidos dentro del
+bloque @code{\paper}. Hay dos elementos de marcado
+@q{predefinidos} disponibles:
+
+@itemize
+
+@item
+@code{tocTitleMarkup}
+
+@noindent
+Utilizado para dar formato al título del índice general.
@verbatim
-\paper {
- %% Traducir el título del índice al español:
- tocTitleMarkup = \markup \huge \column {
- \fill-line { \null "Índice general" \null }
- \hspace #1
- }
- %% usar una fuente mayor
- tocItemMarkup = \markup \large \fill-line {
- \fromproperty #'toc:text \fromproperty #'toc:page
- }
+tocTitleMarkup = \markup \huge \column {
+ \fill-line { \null "Índice general" \null }
+ \null
}
@end verbatim
-Observe la forma en que nos referimos al texto y al número de página
-del elemento de índice, dentro de la definición @code{tocItemMarkup}.
+@item
+@code{tocItemMarkup}
+
+@noindent
+Usado para dar formato a los elementos del índice general.
+
+@verbatim
+tocItemMarkup = \markup \fill-line {
+ \fromproperty #'toc:text \fromproperty #'toc:page
+}
+@end verbatim
-También se pueden definir nuevas instrucciones y elementos de
-marcado para crear índices generales más elaborados:
-@itemize
-@item en primer lugar, defina una variable de marcado nueva dentro del bloque @code{\paper}
-@item luego defina una función de música cuyo propósito es añadir un elemento al índice general
-utilizando esta variable de marcado del bloque @code{\paper}.
@end itemize
-En el ejemplo siguiente se define un estilo nuevo para introducir los
-nombres de los actos de una ópera en el índice general:
+@noindent
+Ambas variables pueden modificarse.
+
+He aquí un ejemplo que modifica el título del índice general para
+que aparezca en francés:
@verbatim
\paper {
- tocActMarkup = \markup \large \column {
- \hspace #1
- \fill-line { \null \italic \fromproperty #'toc:text \null }
+ tocTitleMarkup = \markup \huge \column {
+ \fill-line { \null "Table des matières" \null }
\hspace #1
}
-}
+@end verbatim
-tocAct =
-#(define-music-function (parser location text) (markup?)
- (add-toc-item! 'tocActMarkup text))
+A continuación aparece un ejemplo que modifica el tamaño de
+fuente tipográfica de los elementos del índice general:
+
+@verbatim
+tocItemMarkup = \markup \large \fill-line {
+ \fromproperty #'toc:text \fromproperty #'toc:page
+}
@end verbatim
-@lilypond[line-width=11.0\cm]
+Observe la forma en que nos referimos al texto y al número de
+página del elemento de índice, dentro de la definición
+@code{tocItemMarkup}.
+
+La instrucción @code{\tocItemWithDotsMarkup} se puede incluir
+dentro de @code{tocItemMarkup} para llenar la línea con puntos
+entre un elemento del índice general y su número de página
+correspondiente:
+
+@lilypond[verbatim,line-width=10.0\cm]
\header { tagline = ##f }
\paper {
- tocActMarkup = \markup \large \column {
- \hspace #1
- \fill-line { \null \italic \fromproperty #'toc:text \null }
- \hspace #1
- }
+ tocItemMarkup = \tocItemWithDotsMarkup
}
-tocAct =
-#(define-music-function (parser location text) (markup?)
- (add-toc-item! 'tocActMarkup text))
-
\book {
\markuplist \table-of-contents
- \tocAct \markup { Atto Primo }
- \tocItem \markup { Coro. Viva il nostro Alcide }
- \tocItem \markup { Cesare. Presti omai l'Egizzia terra }
- \tocAct \markup { Atto Secondo }
- \tocItem \markup { Sinfonia }
- \tocItem \markup { Cleopatra. V'adoro, pupille, saette d'Amore }
+ \tocItem \markup { Allegro }
+ \tocItem \markup { Largo }
\markup \null
}
@end lilypond
-Se pueden añadir puntos de relleno entre un elemento y su número de página:
+Las instrucciones predefinidas con sus propios marcados pueden
+definirse también para que construyan un índice general más
+complejo. En el ejemplo siguiente se define un estilo nuevo para
+introducir los nombres de los actos de una ópera en el índice
+general:
-@lilypond[verbatim,quote]
+@noindent
+Una nueva variable de marcado (llamada @code{tocActMarkup}) se
+define en el bloque @code{\paper}:
+
+@verbatim
+\paper {
+ tocActMarkup = \markup \large \column {
+ \hspace #1
+ \fill-line { \null \italic \fromproperty #'toc:text \null }
+ \hspace #1
+ }
+}
+@end verbatim
+
+@noindent
+A continuación se crea una función musical personalizada
+(@code{tocAct}), que usa la nueva definición de marcado
+@code{tocActMarkup}.
+
+@verbatim
+tocAct =
+ #(define-music-function (text) (markup?)
+ (add-toc-item! 'tocActMarkup text))
+@end verbatim
+
+@noindent
+Un archivo de entrada de LilyPond que use estas definiciones
+personalizadas tendría el aspecto siguiente:
+
+@lilypond[line-width=10.0\cm]
\header { tagline = ##f }
\paper {
- tocItemMarkup = \tocItemWithDotsMarkup
+ tocActMarkup = \markup \large \column {
+ \hspace #1
+ \fill-line { \null \italic \fromproperty #'toc:text \null }
+ \hspace #1
+ }
}
+tocAct =
+#(define-music-function (text) (markup?)
+ (add-toc-item! 'tocActMarkup text))
+
\book {
\markuplist \table-of-contents
- \tocItem \markup { Allegro }
- \tocItem \markup { Largo }
+ \tocAct \markup { Atto Primo }
+ \tocItem \markup { Coro. Viva il nostro Alcide }
+ \tocItem \markup { Cesare. Presti omai l'Egizia terra }
+ \tocAct \markup { Atto Secondo }
+ \tocItem \markup { Sinfonia }
+ \tocItem \markup { Cleopatra. V'adoro, pupille, saette d'Amore }
\markup \null
}
@end lilypond
+He aquí un ejemplo de la instrucción @code{\fill-with-pattern}
+usada dentro del contexto de un índice general:
+
+@verbatim
+\paper {
+ tocItemMarkup = \markup { \fill-line {
+ \override #'(line-width . 70)
+ \fill-with-pattern #1.5 #CENTER . \fromproperty #'toc:text \fromproperty #'toc:page
+ }
+ }
+}
+@end verbatim
+
@seealso
Archivos de inicio:
-@file{../ly/toc-init.ly}.
-
+@file{ly/toc-init.ly}.
@predefined
@funindex \table-of-contents
\include "otroarchivo.ly"
@end example
-La línea @code{\include "otroarchivo.ly"} equivale a pegar todo el
-contenido de @file{otroarchivo.ly} en el archivo actual en el lugar en
-que aparece el @code{\include}. Por ejemplo, en un proyecto grande
-podríamos querer archivos distintos para cada parte instrumental y
-crear un archivo de @qq{partitura completa} que reúne los archivos
-individuales de los instrumentos. Normalmente el archivo incluido
-define un cierto número de variables que a partir de entonces quedan
-disponibles para poderlas utilizar en el archivo de la partitura
-completa. En los archivos incluidos se pueden marcar las secciones
-etiquetadas para ayudar a hacerlas utilizables en distintos lugares de
-la partitura, véase @ref{Distintas ediciones a partir de una misma fuente}.
-
-Los archivos que están en el directorio de trabajo actual se pueden
-referenciar simplemente especificando el nombre después de la
-instrucción @code{\include}. Los archivos en otros lugares se pueden
-incluir proporcionando una referencia de ruta completa o una ruta
-relativa (pero utilice la barra inclinada normal del UNIX, /, no la
-barra invertida de DOS/Windows, \, como separador de directorio). Por
-ejemplo, si @file{material.ly} está situado un directorio por encima
-del directorio de trabajo actual, utilice
+La línea @code{\include "otroarchivo.ly"} equivale a pegar todo
+el contenido de @file{otroarchivo.ly} en el archivo actual en el
+lugar en que aparece el @code{\include}. Por ejemplo, en un
+proyecto grande podríamos querer archivos distintos para cada
+parte instrumental y crear un archivo de @qq{partitura completa}
+que reúne los archivos individuales de los instrumentos.
+Normalmente el archivo incluido define un cierto número de
+variables que a partir de entonces quedan disponibles para
+poderlas utilizar en el archivo de la partitura completa. En los
+archivos incluidos se pueden marcar las secciones etiquetadas
+para ayudar a hacerlas utilizables en distintos lugares de la
+partitura, véase @ref{Distintas ediciones a partir de una misma
+fuente}.
+
+Los archivos que están en el directorio de trabajo actual se
+pueden referenciar simplemente especificando el nombre después de
+la instrucción @code{\include}. Los archivos en otros lugares se
+pueden incluir proporcionando una referencia de ruta completa o
+una ruta relativa (pero utilice la barra inclinada normal del
+UNIX, /, no la barra invertida de DOS/Windows, \, como separador
+de directorio). Por ejemplo, si @file{material.ly} está situado
+un directorio por encima del directorio de trabajo actual,
+utilice
@example
\include "../material.ly"
@example
\include "partes/VI.ly"
\include "partes/VII.ly"
-... etc.
+@dots{} etc.
@end example
Los archivos de inclusión también pueden contener enunciados
-@code{\include} a su vez. De forma predeterminada, estos enunciados
-@code{\include} de segundo nivel no se interpretan hasta que se
-incorporan al archivo principal, por lo que los nombres de archivo que
-especifican deben ser relativos al directorio que contiene el archivo
-principal, no al directorio que contiene el archivo incluido. Sin
-embargo, este comportamiento se puede modificar pasando la opción
-@option{-drelative-includes} en la línea de órdenes (o mediante la
-adición de @code{#(ly:set-option 'relative-includes #t)} al principio
-del archivo principal de entrada). Con el valor de
-@code{relative-includes} establecido, la ruta de cada instrucción
-@code{\include} se considera relativa al archivo que contiene dicha
-instrucción. Este comportamiento es el recomendado y se convertirá en
-el comportamiento predeterminado en una versión futura de lilypond.
-
-También se pueden incluir archivos de un directorio que está en una
-ruta de búsqueda especificada como opción al invocar a LilyPond desde
-la línea de órdenes. Los archivos incluidos se especifican usando
-solamente su nombre de archivo. Por ejemplo, para compilar mediante
-este método un archivo @file{principal.ly} que incluye archivos
-situados en un subdirectorio llamado @file{partes}, cambie al
-directorio que contiene @file{principal.ly} e introduzca
+@code{\include} a su vez. De forma predeterminada, estos
+enunciados @code{\include} de segundo nivel no se interpretan
+hasta que se incorporan al archivo principal, por lo que los
+nombres de archivo que especifican deben ser relativos al
+directorio que contiene el archivo principal, no al directorio
+que contiene el archivo incluido. Sin embargo, este
+comportamiento se puede modificar globalmente pasando la opción
+@option{-drelative-includes} en la línea de órdenes (o mediante
+la adición de @code{#(ly:set-option 'relative-includes #t)} al
+principio del archivo principal de entrada).
+
+Cuando @code{relative-includes} está establecido al valor
+@code{#t}, la ruta de cada instrucción @code{\include} se
+considera relativa al archivo que contiene dicha instrucción.
+Este comportamiento es el recomendado y se convertirá en el
+comportamiento predeterminado en una versión futura de lilypond.
+
+Tanto los archivos relativos al directorio principal como los
+archivos relativos a algún otro directorio se pueden
+@code{\include}ar mediante el establecimiento de
+@code{relative-includes} al valor @code{#t} o a @code{#f} en los
+lugares apropiados dentro de los archivos. Por ejemplo, si se ha
+creado una biblioteca genérica, libA, que a su vez utiliza
+sub-archivos que se @code{\include}an por medio del archivo de
+entrada de dicha biblioteca, esas instrucciones @code{\include}
+tendrán que venir precedidas por @code{#(ly:set-option
+#relative-includes #t)} de manera que se interpreten
+correctamente al construir el archivo de entrada @code{.ly}
+principal, de esta forma:
+
+@example
+libA/
+ libA.ly
+ A1.ly
+ A2.ly
+ @dots{}
+@end example
+
+@noindent
+entonces el archivo de entrada, @code{libA.ly}, contiene
+
+@example
+#(ly:set-option 'relative-includes #t)
+\include "A1.ly"
+\include "A2.ly"
+@dots{}
+% vuelta al ajuste predeterminado
+#(ly:set-option 'relative-includes #f)
+@end example
+
+Cualquier archivo @file{.ly} puede entonces incluir la biblioteca
+completa, simplemente con
+
+@example
+\include "~/libA/libA.ly"
+@end example
+
+Se pueden usar estructuras de archivo más complejas instando los
+cambios en los lugares adecuados.
+
+También se pueden incluir archivos de un directorio que está en
+una ruta de búsqueda especificada como opción al invocar a
+LilyPond desde la línea de órdenes. Los archivos incluidos se
+especifican usando solamente su nombre de archivo. Por ejemplo,
+para compilar mediante este método un archivo @file{principal.ly}
+que incluye archivos situados en un subdirectorio llamado
+@file{partes}, cambie al directorio que contiene
+@file{principal.ly} e introduzca
@example
lilypond --include=partes principal.ly
@example
\include "VI.ly"
\include "VII.ly"
-... etc.
+@dots{} etc.
@end example
-Los archivos que se incluyen en muchas partituras se pueden poner en
-el directorio de LilyPond @file{../ly} (la localización de este
-directorio depende de la instalación: véase
-@rlearning{Otras fuentes de información}). Estos archivos se pueden
-incluir sencillamente por su nombre en un enunciado @code{\include}.
-De esta forma se incluyen los archivos dependientes del idioma como
+Los archivos que se incluyen en muchas partituras se pueden poner
+en el directorio de LilyPond @file{../ly} (la localización de
+este directorio depende de la instalación: véase @rlearning{Otras
+fuentes de información}). Estos archivos se pueden incluir
+sencillamente por su nombre en un enunciado @code{\include}. De
+esta forma se incluyen los archivos dependientes del idioma como
@file{espanol.ly}.
-LilyPond incluye de forma predeterminada ciertos archivos cuando se
-inicia el programa. Estas inclusiones no son visibles para el
+LilyPond incluye de forma predeterminada ciertos archivos cuando
+se inicia el programa. Estas inclusiones no son visibles para el
usuario, pero los archivos se pueden identificar ejecutando
-@code{lilypond --verbose} desde la línea de órdenes. Esto presentará
-una lista de rutas y archivos que utiliza LilyPond, junto a muchas
-otras indicaciones. De forma alternativa, pueden verse explicaciones
-sobre los archivos más importantes de este conjunto en
-@rlearning{Otras fuentes de información}. Estos archivos se pueden
-editar, pero los cambios realizados sobre ellos se perderán al
-instalar una nueva versión de LilyPond.
-
-Pueden verse ejemplos sencillos sobre el uso de @code{\include} en
-@rlearning{Partituras y particellas}.
+@code{lilypond --verbose} desde la línea de órdenes. Esto
+presentará una lista de rutas y archivos que utiliza LilyPond,
+junto a muchas otras indicaciones. De forma alternativa, pueden
+verse explicaciones sobre los archivos más importantes de este
+conjunto en @rlearning{Otras fuentes de información}. Estos
+archivos se pueden editar, pero los cambios realizados sobre
+ellos se perderán al instalar una nueva versión de LilyPond.
+Pueden verse ejemplos sencillos sobre el uso de @code{\include}
+en @rlearning{Partituras y particellas}.
@seealso
Manual de aprendizaje:
@knownissues
Si un archivo incluido recibe un nombre igual al de uno de los
-archivos de instalación de LilyPond, el archivo que tiene prioridad es
-el de los archivos de instalación de LilyPond.
+archivos de instalación de LilyPond, el archivo que tiene
+prioridad es el de los archivos de instalación de LilyPond.
@node Distintas ediciones a partir de una misma fuente
@subsection Distintas ediciones a partir de una misma fuente
@translationof Different editions from one source
-Se pueden usar varios métodos para generar la producción de distintas
-versiones de una partitura a partir de la misma fuente musical. Las
-variables son quizá el más útil para combinar secciones extensas de
-música y/o anotaciones. Las etiquetas son más útiles para seleccionar
-una sección de entre varias secciones de música alternativas, más
-cortas, y se pueden usar también para dividir piezas de música en
-distintos trozos.
-
-Cualquiera que sea el método utilizado, la separación de la notación
-de la estructura de la partitura hará que sea más fácil cambiar la
-estructura dejando intacta la notación.
+Se pueden usar varios métodos para generar la producción de
+distintas versiones de una partitura a partir de la misma fuente
+musical. Las variables son quizá el más útil para combinar
+secciones extensas de música y/o anotaciones. Las etiquetas son
+más útiles para seleccionar una sección de entre varias secciones
+de música alternativas, más cortas, y se pueden usar también para
+dividir piezas de música en distintos trozos.
+Cualquiera que sea el método utilizado, la separación de la
+notación de la estructura de la partitura hará que sea más fácil
+cambiar la estructura dejando intacta la notación.
@menu
* Uso de las variables::
Si las secciones de la música se definen dentro de variables, se
pueden reutilizar en distintas partes de la partitura, véase
-@rlearning{Organizar las piezas mediante variables}. Por ejemplo, una
-partitura vocal @notation{a cappella} con frecuencia incluye una
-reducción de piano de las partes para ensayar que es idéntica a la
-música vocal, por lo que ésta sólo se tiene que escribir una vez. Se
-puede combinar sobre un solo pentagrama la música de dos variables,
-véase @ref{Combinación automática de las partes}. He aquí un ejemplo:
+@rlearning{Organizar las piezas mediante variables}. Por
+ejemplo, una partitura vocal @notation{a cappella} con frecuencia
+incluye una reducción de piano de las partes para ensayar que es
+idéntica a la música vocal, por lo que ésta sólo se tiene que
+escribir una vez. Se puede combinar sobre un solo pentagrama la
+música de dos variables, véase @ref{Combinación automática de las
+partes}. He aquí un ejemplo:
@lilypond[verbatim,quote]
-sopranoMusic = \relative c'' { a4 b c b8( a) }
-altoMusic = \relative g' { e4 e e f }
-tenorMusic = \relative c' { c4 b e d8( c) }
-bassMusic = \relative c' { a4 gis a d, }
-allLyrics = \lyricmode {King of glo -- ry }
+sopranoMusic = \relative { a'4 b c b8( a) }
+altoMusic = \relative { e'4 e e f }
+tenorMusic = \relative { c'4 b e d8( c) }
+bassMusic = \relative { a4 gis a d, }
+allLyrics = \lyricmode { King of glo -- ry }
<<
\new Staff = "Soprano" \sopranoMusic
\new Lyrics \allLyrics
\new Lyrics \allLyrics
\new PianoStaff <<
\new Staff = "RH" {
- \set Staff.printPartCombineTexts = ##f
- \partcombine
- \sopranoMusic
- \altoMusic
+ \partcombine \sopranoMusic \altoMusic
}
\new Staff = "LH" {
- \set Staff.printPartCombineTexts = ##f
\clef "bass"
- \partcombine
- \tenorMusic
- \bassMusic
+ \partcombine \tenorMusic \bassMusic
}
>>
>>
@end lilypond
-Se pueden producir partituras distintas que presenten sólo las partes
-vocales o sólo la parte de piano, cambiando solamente los enunciados
-estructurales, sin modificar la notación musical.
+Se pueden producir partituras distintas que presenten sólo las
+partes vocales o sólo la parte de piano, cambiando solamente los
+enunciados estructurales, sin modificar la notación musical.
-Para partituras extensas, las definiciones de variable se pueden poner
-en archivos separados que se incluyen más tarde, véase @ref{Inclusión de archivos de LilyPond}.
+Para partituras extensas, las definiciones de variable se pueden
+poner en archivos separados que se incluyen más tarde, véase
+@ref{Inclusión de archivos de LilyPond}.
@node Uso de etiquetas
@funindex \tag
@funindex \keepWithTag
@funindex \removeWithTag
-@funindex \pushToTag
-@funindex \appendToTag
@cindex etiqueta
@cindex mantener música etiquetada
@cindex quitar música etiquetada
-@cindex división en música etiquetada
-La instrucción @code{\tag #'@var{parteA}} marca una expresión musical
-con el nombre @var{parteA}. Las expresiones etiquetadas de esta
-manera se pueden seleccionar o filtrar más tarde por su nombre, usando
-bien @code{\keepWithTag #'@var{nombre}} o bien @code{\removeWithTag
-#'@var{nombre}}. El resultado de la aplicación de estos filtros a la
-música etiquetada es como sigue:
+La instrucción @code{\tag #'@var{parteA}} marca una expresión
+musical con el nombre @var{parteA}. Las expresiones etiquetadas
+de esta manera se pueden seleccionar o filtrar más tarde por su
+nombre, usando bien @code{\keepWithTag #'@var{nombre}} o bien
+@code{\removeWithTag #'@var{nombre}}. El resultado de la
+aplicación de estos filtros a la música etiquetada es como sigue:
@multitable @columnfractions .5 .5
@headitem Filtro
@tab Resultado
@item
Música etiquetada precedida de @code{\keepWithTag #'@var{nombre}}
-@tab
-Se incluye la música no etiquetada y la música etiquetada con
-@var{nombre}; se excluye la música etiquetada con cualquier otro
-nombre de etiqueta.
+o de @code{\keepWithTag #'(@var{nombre1} @var{nombre2}@dots{})}
+@tab Se incluye la música no etiquetada y la música etiquetada con
+el nombre o nombres de etiqueta dados; se excluye la música
+etiquetada con cualquier otro nombre de etiqueta.
@item
-Música etiquetada precedida de @code{\removeWithTag #'@var{nombre}}
+Música etiquetada precedida de
+@code{\removeWithTag #'@var{nombre}} o
+@code{\removeWithTag #'(@var{nombre1} @var{nombre2}@dots{})}
@tab
-Se incluye la música no etiquetada y la música etiquetada con
-cualquier nombre de etiqueta distinto a @var{nombre}; se excluye la
-música etiquetada con @var{nombre}.
+Se incluye la música no etiquetada y la música que no está
+etiquetada con ninguno de los nombres de etiqueta dados; se
+excluye la música etiquetada con los nombres de etiqueta dados.
@item
Música etiquetada no precedida de @code{\keepWithTag} ni de
@code{\removeWithTag}
@tab Se incluye toda la música etiquetada y no etiquetada.
@end multitable
-Los argumentos de las instrucciones @code{\tag}, @code{\keepWithTag} y
-@code{\removeWithTag} deben ser un símbolo (como @code{#'partitura} o
-@code{#'parte}), seguido de una expresión musical.
-
-En el ejemplo siguiente vemos dos versiones de una pieza musical, una
-que muestra trinos con la notación usual y otra con los trinos
-expandidos explícitamente:
+Los argumentos de las instrucciones @code{\tag},
+@code{\keepWithTag} y @code{\removeWithTag} deben ser un símbolo
+o lista de símbolos (como @code{#'score} o @code{#'(violinI
+violinII}), seguida de una expresión musical. Si @emph{y solo
+si} los símbolos son identificadores de LilyPond válidos
+(caracteres alfabéticos solamente, sin números, guiones bajos ni
+guiones normales) que no puedan confundirse con notas, la porción
+@code{#'} se puede omitir y, como abreviatura, una lista de
+símbolos puede usar el separador de punto, es decir: @code{\tag
+#'(violinI violinII)} se puede escribir como @code{\tag
+violinI.violinII}. Lo mismo vale para @code{\keepWithTag} y
+@code{\removeWithTag}.
+
+En el ejemplo siguiente vemos dos versiones de una pieza musical,
+una que muestra trinos con la notación usual y otra con los
+trinos expandidos explícitamente:
@lilypond[verbatim,quote]
-music = \relative g' {
- g8. c32 d
+music = \relative {
+ g'8. c32 d
\tag #'trills { d8.\trill }
\tag #'expand { \repeat unfold 3 { e32 d } }
c32 d
De forma alternativa, a veces es más fácil excluir secciones de música:
@lilypond[verbatim,quote]
-music = \relative g' {
- g8. c32 d
+music = \relative {
+ g'8. c32 d
\tag #'trills { d8.\trill }
\tag #'expand {\repeat unfold 3 { e32 d } }
c32 d
c1-\tag #'warn ^"¡Ojo!"
@end example
-Se pueden poner varias etiquetas sobre expresiones con varias entradas
-de @code{\tag}:
+Se pueden poner varias etiquetas sobre expresiones con varias
+entradas de @code{\tag}, o combinando varias etiquetas en una
+lista de símbolos:
@lilypond[quote,verbatim]
music = \relative c'' {
\tag #'a \tag #'both { a4 a a a }
- \tag #'b \tag #'both { b4 b b b }
+ \tag #'(b both) { b4 b b b }
}
<<
\keepWithTag #'a \music
@end lilypond
Se pueden aplicar varios filtros @code{\removeWithTag} a una sola
-expresión musical para quitar varias secciones etiquetadas con nombres
-distintos:
+expresión musical para quitar varias secciones etiquetadas con
+nombres distintos. De forma alternativa, podemos usar una sola
+instrucción @code{\removeWithTag} con una lista de etiquetas.
@lilypond[verbatim,quote]
music = \relative c'' {
-\tag #'A { a4 a a a }
-\tag #'B { b4 b b b }
-\tag #'C { c4 c c c }
-\tag #'D { d4 d d d }
+ \tag #'A { a4 a a a }
+ \tag #'B { b4 b b b }
+ \tag #'C { c4 c c c }
+ \tag #'D { d4 d d d }
}
-{
-\removeWithTag #'B
-\removeWithTag #'C
-\music
+\new Voice {
+ \removeWithTag #'B
+ \removeWithTag #'C
+ \music
+ \removeWithTag #'(B C)
+ \music
}
@end lilypond
-Dos o más filtros @code{\keepWithTag} aplicados a una sola expresión
-musical producen la eliminación de @emph{todas} las secciones
-etiquetadas, porque el primer filtro quita todas las secciones
-etiquetadas excepto la que se nombra, y el segundo filtro elimina
-incluso esa sección etiquetada.
+El uso de dos o más filtros @code{\keepWithTag} sobre una sola
+expresión musical produce la eliminación de @emph{todas} las
+secciones etiquetadas. El primer filtro quita todas excepto
+la que se nombra, y cualquier filtro posterior
+elimina el resto.
+Usando una sola instrucción @code{\keepWithTag} con una
+lista de varias etiquetas se suprimirán solamente
+las secciones etiquetadas que no aparezcan especificadas en la lista.
-A vecespodemos desear dividir la música en un determinado lugar dentro
-de una expresión musical existente. Podemos usar @code{\pushToTag} y
-@code{\appendToTag} para añadir material delante o al final de los
-@code{elements} de una construcción musical existente. No toda
-construcción musical tiene la parte @code{elements}, pero las músicas
-secuenciaes y simultáneas son dos apuestas seguras:
+@lilypond[verbatim,quote]
+music = \relative c'' {
+ \tag #'violinI { a4 a a a }
+ \tag #'violinII { b4 b b b }
+ \tag #'viola { c4 c c c }
+ \tag #'cello { d4 d d d }
+}
+
+\new Staff {
+ \keepWithTag #'(violinI violinII)
+ \music
+}
+@end lilypond
+
+@noindent
+will print @code{\tag}s @var{violinI} and @var{violinII} but not
+@var{viola} or @var{cello}.
+
+@cindex grupos de etiquetas
+@funindex \tagGroup
+Aunque @code{\keepWithTag} es útil para el manejo de @emph{un
+solo} conjunto de alternativas, la eliminación de música
+etiquetada con otras etiquetas @emph{no relacionadas} es
+problemática si se utilizan para más de un propósito.
+En ese caso pueden declararse @q{grupos de etiquetas}:
+
+@example
+\tagGroup #'(violinI violinII viola cello)
+@end example
+
+@noindent
+Ahora todas las etiquetas pertenecen a un solo @q{grupo de etiquetas}.
+Observe que las etiquetas individuales no pueden ser miembros
+de más de un @emph{grupo de etiquetas}.
+
+@example
+\keepWithTag #'violinI @dots{}
+@end example
+
+@noindent
+mostrará solamente la música etiquetada a partir del
+grupo de etiquetas de @code{violinI} y
+cualquier fragmento musical etiquetado con una de las
+@emph{otras} etiquetas resultará suprimido.
@lilypond[verbatim,quote]
-test = { \tag #'here { \tag #'here <<c''>> } }
+music = \relative {
+ \tagGroup #'(violinI violinII viola cello)
+ \tag #'violinI { c''4^"violinI" c c c }
+ \tag #'violinII { a2 a }
+ \tag #'viola { e8 e e2. }
+ \tag #'cello { d'2 d4 d }
+ R1^"untagged"
+}
+
+\new Voice {
+ \keepWithTag #'violinI
+ \music
+}
+@end lilypond
+
+Al usar la instrucción @code{\keepWithTag} solo son visibles
+las etiquetas de los grupos de aquellas etiquetas se se incluyen
+en la instrucción.
+
+@funindex \pushToTag
+@funindex \appendToTag
+@cindex dividir en música etiquetada
+
+A veces podemos desear dividir la música en un determinado lugar
+dentro de una expresión musical existente. Podemos usar
+@code{\pushToTag} y @code{\appendToTag} para añadir material
+delante o al final de los @code{elements} de una construcción
+musical existente. No toda construcción musical tiene la parte
+@code{elements}, pero las músicas secuenciales y simultáneas son
+dos apuestas seguras:
+
+@lilypond[verbatim,quote]
+music = { \tag #'here { \tag #'here <<c''>> } }
{
\pushToTag #'here c'
\pushToTag #'here e'
- \pushToTag #'here g' \test
+ \pushToTag #'here g' \music
\appendToTag #'here c'
\appendToTag #'here e'
- \appendToTag #'here g' \test
+ \appendToTag #'here g' \music
}
@end lilypond
-Las dos instrucciones admiten una etiqueta, el material que dividir en
-cada ocurrencia de la etiqueta, y la expresión etiquetada. Las
-instrucciones aseguran que se copia todo lo que cambian, de forma que
-el código original @code{\test} retiene su significado.
+Las dos instrucciones admiten una etiqueta, el material que
+dividir en cada ocurrencia de la etiqueta, y la expresión
+etiquetada.
@seealso
Manual de aprendizaje:
@ref{Combinación automática de las partes},
@ref{Inclusión de archivos de LilyPond}.
-
-@ignore
-@c This warning is more general than this placement implies.
-@c Rests are not merged whether or not they come from tagged sections.
-@c Should be deleted? -td
-
-
@knownissues
+Al llamar a @code{\relative} sobre una expresión musical obtenida
+mediante el filtrado de música con las instrucciones
+@code{\keepWithTag} o @code{\removeWithTag}, podría ocurrir que
+cambiaran las relaciones de octava, dado que solo se tendrán en
+cuenta las alturas de las notas que efectivamente permanecen en
+la expresión filtrada. La aplicación de @code{\relative} en
+primer lugar, antes de @code{\keepWithTag} o de
+@code{\removeWithTag}, evita este peligro porque en este caso
+@code{\relative} actúa sobre todas las notas tal y como se
+introducen.
-Multiple rests are not merged if you create a score with more
-than one tagged section at the same place.
-
-@end ignore
@node Uso de ajustes globales
@unnumberedsubsubsec Uso de ajustes globales
@cindex include-settings
-Se pueden incluir ajustes globales a partir de un archivo distinto:
+Se pueden incluir ajustes globales a partir de un archivo
+distinto:
@example
lilypond -dinclude-settings=MIS_AJUSTES.ly MI_PARTITURA.ly
@end example
-En archivos diferentes se pueden almacenar grupos de ajustes como
+En archivos diferentes se pueden almacenar grupos de ajustes como
el tamaño de la página o las fuentes tipográficas. Ello permite
-hacer diferentes ediciones de la mism a partitura así como aplicar
+hacer diferentes ediciones de la misma partitura así como aplicar
ajustes estándar a muchas partituras, simplemente por medio de la
especificación del archivo de ajustes adecuado.
Referencia de la notación:
@ref{Inclusión de archivos de LilyPond}.
+
@node Caracteres especiales
@subsection Caracteres especiales
@translationof Special characters
@cindex UTF-8
LilyPond usa el conjunto de caracteres definido por el consorcio
-Unicode y la norma ISO/IEC 10646. Define un nombre único y un código
-para los conjuntos de caracteres que se utilizan en prácticamente
-todos los idiomas modernos y también en muchos otros. Unicode se
-puede implementar utilizando varios esquemas de codificación
-distintos. LilyPond usa la codificación UTF-8 (UTF son las siglas de
-@emph{Unicode Transformation Format}, o formato de transformación de
-Unicode) que representa todos los caracteres comunes de Latin en un
-solo byte, y representa otros caracteres usando un formato de longitud
+Unicode y la norma ISO/IEC 10646. Define un nombre único y un
+código para los conjuntos de caracteres que se utilizan en
+prácticamente todos los idiomas modernos y también en muchos
+otros. Unicode se puede implementar utilizando varios esquemas
+de codificación distintos. LilyPond usa la codificación UTF-8
+(UTF son las siglas de @emph{Unicode Transformation Format}, o
+formato de transformación de Unicode) que representa todos los
+caracteres comunes de la codificación Latin en un solo byte, y
+representa otros caracteres usando un formato de longitud
variable de hasta cuatro bytes.
-El aspecto visual real de los caracteres viene determinado por los
-glifos que se definen en las fuentes tipográficas concretas que se
-tengan disponibles: una fuente tipográfica define la asignación de un
-subconjunto de los códigos de Unicode a glifos. LilyPond usa la
-biblioteca Pango para representar y disponer tipográficamente textos
-multilingües.
+El aspecto visual real de los caracteres viene determinado por
+los glifos que se definen en las fuentes tipográficas concretas
+que se tengan disponibles: una fuente tipográfica define la
+asignación de un subconjunto de los códigos de Unicode a glifos.
+LilyPond usa la biblioteca Pango para representar y disponer
+tipográficamente textos multilingües.
LilyPond no realiza ninguna conversión en la codificación de la
entrada. Esto significa que cualquier text, ya sea el título, la
-letra de la canción o una instrucción musical que contenga caracteres
-distintos a los del conjunto ASCII, se deben codificar en UTF-8. La
-forma más fácil de escribir dicho texto es utilizar un editor
-preparado para Unicode y guardar el archivo con la codificación UTF-8.
-Casi todos los editores modernos populares contemplan el UTF-8, por
-ejemplo lo hacen vim, Emacs, jEdit, y GEdit. Todos los sistemas MS
-Windows posteriores a NT usan Unicode como codificación de caracteres
-nativa, de manera que incluso el accesorio Bloc de Notas (Notepad)
-puede editar y guardar un archivo en el formato UTF-8. Una
-alternativa más funcional para Windows es BabelPad.
-
-Si un archivo de entrada que contiene un carácter que no es ASCII, no
-se guarda en el formato UTF-8, se genera el mensaje de error
+letra de la canción o una instrucción musical que contenga
+caracteres distintos a los del conjunto ASCII, se deben codificar
+en UTF-8. La forma más fácil de escribir dicho texto es utilizar
+un editor preparado para Unicode y guardar el archivo con la
+codificación UTF-8. Casi todos los editores modernos populares
+contemplan el UTF-8, por ejemplo lo hacen vim, Emacs, jEdit y
+Gedit. Todos los sistemas MS Windows posteriores a NT usan
+Unicode como codificación de caracteres nativa, de manera que
+incluso el accesorio Bloc de Notas (Notepad) puede editar y
+guardar un archivo en el formato UTF-8. Una alternativa más
+funcional para Windows es BabelPad.
+
+Si un archivo de entrada que contiene un carácter que no es
+ASCII, no se guarda en el formato UTF-8, se genera el mensaje de
+error
@example
FT_Get_Glyph_Name () error: argumento inválido
He aquí un ejemplo que muestra texto cirílico, hebreo y portugués:
+@c NOTE: No verbatim in the following example as the code does not
+@c display correctly in PDF Font settings for Cyrillic and Hebrew
+
@lilypond[quote]
-%c No verbatim here as the code does not display correctly in PDF
+% Linux Libertine fonts contain Cyrillic and Hebrew glyphs.
+\paper {
+ #(define fonts
+ (set-global-fonts
+ #:roman "Linux Libertine O,serif"
+ #:sans "Linux Biolinum O,sans-serif"
+ #:typewriter "Linux Libertine Mono O,monospace"
+ ))
+}
+
% Cyrillic
bulgarian = \lyricmode {
Жълтата дюля беше щастлива, че пухът, който цъфна, замръзна като гьон.
à vo -- cê uma can -- ção legal
}
-\relative c' {
- c2 d e f g f e
+\relative {
+ c'2 d e f g f e
}
\addlyrics { \bulgarian }
\addlyrics { \hebrew }
@node Unicode
@unnumberedsubsubsec Unicode
+@translationof Unicode
@cindex Unicode
-Para introducir un carácter aislado para el que se conoce el punto de
-código Unicode pero no está disponible en el editor que se está
-usando, use @code{\char ##xhhhh} o bien @code{\char #dddd} dentro de
-un bloque @code{\markup}, donde @code{hhhh} es el código hexadecimal
-del carácter en cuestión y @code{dddd} es su valor decimal
-correspondiente. Pueden omitirse los ceros iniciales, pero es
-costumbre indicar los cuatro caracteres en la representación
-hexadecimal (observe que @emph{no} debe utilizarse la codificación
-UTF-8 del punto de código Unicode después de @code{\char}, pues la
-codificación UTF-8 contiene bits adicionales que indican el número de
-octetos). Hay tablas de códigos Unicode y un índice de nombres de
-caracteres que da el punto de código en hexadecimal para cualquier
-carácter en el portal del Consorcio Unicode,
-@uref{http://www.unicode.org/}.
-
+Para introducir un carácter aislado para el que se conoce el
+punto de código Unicode pero no está disponible en el editor que
+se está usando, use @code{\char ##xhhhh} o bien @code{\char
+#dddd} dentro de un bloque @code{\markup}, donde @code{hhhh} es
+el código hexadecimal del carácter en cuestión y @code{dddd} es
+su valor decimal correspondiente. Pueden omitirse los ceros
+iniciales, pero es costumbre indicar los cuatro caracteres en la
+representación hexadecimal (observe que @emph{no} debe utilizarse
+la codificación UTF-8 del punto de código Unicode después de
+@code{\char}, pues la codificación UTF-8 contiene bits
+adicionales que indican el número de octetos). Hay tablas de
+códigos Unicode y un índice de nombres de caracteres que da el
+punto de código en hexadecimal para cualquier carácter en el
+portal del Consorcio Unicode, @uref{http://www.unicode.org/}.
Por ejemplo, tanto @code{\char ##x03BE} como @code{\char #958}
insertan el carácter Unicode U+03BE, que tiene el nombre Unicode
@qq{Letra griega Xi pequeña}.
-Se puede escribir de esta forma cualquier punto de código Unicode, y
-si todos los caracteres especiales se escriben en este formato no es
-necesario guardar el archivo de entrada en formato UTF-8. Por
-supuesto, debe estar instalada y estar disponible para LilyPond una
-fuente tipográfica que contenga codificados todos estos caracteres.
+Se puede escribir de esta forma cualquier punto de código
+Unicode, y si todos los caracteres especiales se escriben en este
+formato no es necesario guardar el archivo de entrada en formato
+UTF-8. Por supuesto, debe estar instalada y estar disponible
+para LilyPond una fuente tipográfica que contenga codificados
+todos estos caracteres.
-El ejemplo siguiente muestra valores hexadecimales Unicode que se usan
-en cuatro lugares: en una llamada de ensayo, como texto de
+El ejemplo siguiente muestra valores hexadecimales Unicode que se
+usan en cuatro lugares: en una llamada de ensayo, como texto de
articulación, en la letra y como texto independiente bajo la
partitura:
@lilypond[quote,verbatim]
\score {
- \relative c'' {
- c1 \mark \markup { \char ##x03EE }
+ \relative {
+ c''1 \mark \markup { \char ##x03EE }
c1_\markup { \tiny { \char ##x03B1 " to " \char ##x03C9 } }
}
\addlyrics { O \markup { \concat { Ph \char ##x0153 be! } } }
}
-\markup { "Copyright 2008--2012" \char ##x00A9 }
+\markup { "Copyright 2008--2015" \char ##x00A9 }
@end lilypond
@cindex copyright, símbolo de
}
@end lilypond
-También podemos hacer nuestros propios alias, ya sea de forma global:
+También podemos hacer nuestros propios alias, ya sea de forma global,
@lilypond[quote,verbatim]
\paper {
@file{ly/text-replacements.ly}.
-
@node Controlar la salida
@section Controlar la salida
@translationof Controlling output
* Sustituir la tipografía de la notación::
@end menu
+@funindex clip-regions
+@cindex fragmentos de música
+@cindex música, fragmentos
+
@node Extracción de fragmentos de música
@subsection Extracción de fragmentos de música
@translationof Extracting fragments of music
-Es posible citar pequeños fragmentos de una partitura grande
-directamente a partir de la salida. Puede compararse con la
-separación de una pieza de una partitura, recortándola con tijeras.
+Es posible producir en la salida uno o más fragmentos de una
+partitura mediante la definición de la situación explícita de la
+música que se quiere extraer dentro del bloque @code{\layout} del
+archivo de entrada, utilizando la función @code{clip-regions}, y
+a continuación ejecutando LilyPond con la opción
+@option{-dclip-systems}.
-Esto se hace definiendo los compases que se deben recortar. Por
-ejemplo, la inclusión de la siguiente definición
-
-@verbatim
-\layout {
+@example
+\layout @{
clip-regions
= #(list
(cons
(make-rhythmic-location 5 1 2)
(make-rhythmic-location 7 3 4)))
-}
-@end verbatim
+@}
+@end example
@noindent
-extrae un fragmento empezando por la mitad del quinto compás y
-finalizando en el séptimo compás. El significado de @code{5 1 2} es:
-después de una blanca (1/2) en el compás 5, y el de @code{7 3 4}
-después de tres negras del compás 7.
+Este ejemplo extrae un solo fragmento del archivo de entrada
+@emph{comenzando} después de la duración de una blanca en el
+quinto compás (@code{5 1 2}) y @emph{terminando} después de la
+tercera negra del compás séptimo (@code{7 3 4}).
+
+Se pueden extraer fragmentos adicionales añadiendo más pares de
+entradas de @code{make-rhythmic-location} a la lista
+@code{clip-regions} dentro del bloque @code{\layout}.
+
+De forma predeterminada, cada fragmento de música se obtendrá en
+la salida como un archivo @code{EPS} distinto, pero también se
+pueden crear otros formatos como @code{PDF} o @code{PNG} si es
+necesario. La música extraída se obtiene en la salida como si
+hubiera sido literalmente @q{cortada} de la partitura original
+impresa, de forma que si un fragmento se extiende sobre una o más
+líneas, se genera un archivo de salida distinto por cada línea
+generada.
-Se pueden definir más zonas de recorte añadiendo más parejas de
-definición de tiempo rhythmic-location a la lista.
+@seealso
+Referencia de la notación:
+@ref{El bloque layout}.
-Para poder utilizar esta funcionalidad, LilyPond se debe invocar con
-la opción @option{-dclip-systems}. Los recortes aparecen en la salida
-como archivos EPS, y se convierten en PDF y PNG si estos formatos
-también están activados.
+Manual de utilización:
+@rprogram{Utilización desde la línea de órdenes}.
-Para ver más información sobre los formatos de salida, consulte
-@rprogram{Invocar a LilyPond}.
@node Saltar la música corregida
@funindex showFirstLength
@funindex showLastLength
-Al escribir o copiar música, normalmente sólo es interesante de ver y
-corregir la música cercana al final (donde estamos añadiendo las
-notas). Para acelerar este proceso de corrección, es posible saltar
-la composición tipográfica de todos excepto unos pocos de los últimos
-compases. Esto se consigue poniendo
+Al escribir o copiar música, normalmente sólo es interesante de
+ver y corregir la música cercana al final (donde estamos
+añadiendo las notas). Para acelerar este proceso de corrección,
+es posible saltar la composición tipográfica de todos excepto
+unos pocos de los últimos compases. Esto se consigue poniendo
-@verbatim
+@example
showLastLength = R1*5
-\score { ... }
-@end verbatim
+\score @{ @dots{} @}
+@end example
@noindent
-en nuestro archivo fuente. Esto hará que se tracen sólo los últimos
-cinco compases (suponiendo un compás de 4/4) de cada una de las
-partituras @code{\score} del archivo de entrada. Para piezas largas,
-el tipografiado de únicamente una parte pequeña es con frecuencia un
-orden de magnitud más rápido que el de la obra completa. Si estamos
-trabajando sobre el principio de una partitura que ya hemos
-tipografiado (p.ej., para añadir una parte instrumental nueva),
-también puede ser útil la propiedad @code{showFirstLength}.
+en nuestro archivo fuente. Esto hará que se tracen sólo los
+últimos cinco compases (suponiendo un compás de 4/4) de cada una
+de las partituras @code{\score} del archivo de entrada. Para
+piezas largas, el tipografiado de únicamente una parte pequeña es
+con frecuencia un orden de magnitud más rápido que el de la obra
+completa. Si estamos trabajando sobre el principio de una
+partitura que ya hemos tipografiado (p.ej., para añadir una parte
+instrumental nueva), también puede ser útil la propiedad
+@code{showFirstLength}.
Este mecanismo de pasar por alto partes de un partitura se puede
controlar con un grano más fino mediante la propiedad
-@code{Score.skipTypesetting}. Cuando su valor está establecido, no se
-lleva a cabo ningún tipografiado en absoluto.
-
-Esta propiedad se usa también para controlar la salida al archivo
-MIDI. Observe que pasa por alto todos los eventos, incluidos el tempo
-y los cambios de instrumento. Está usted advertido.
-
-@lilypond[quote,relative=2,ragged-right,verbatim]
-c8 d
-\set Score.skipTypesetting = ##t
-e8 e e e e e e e
-\set Score.skipTypesetting = ##f
-c8 d b bes a g c2
+@code{Score.skipTypesetting}. Cuando su valor está establecido,
+no se lleva a cabo ningún tipografiado en absoluto.
+
+Esta propiedad se usa también para controlar la salida hacia el
+archivo MIDI. Observe que pasa por alto todos los eventos,
+incluidos el tempo y los cambios de instrumento. Está usted
+advertido.
+
+@lilypond[quote,ragged-right,verbatim]
+\relative c' {
+ c1
+ \set Score.skipTypesetting = ##t
+ \tempo 4 = 80
+ c4 c c c
+ \set Score.skipTypesetting = ##f
+ d4 d d d
+}
@end lilypond
-En música polifónica, @code{Score.skipTypesetting} afecta a todas las
-voces y pentagramas, ahorrando más tiempo incluso.
+En música polifónica, @code{Score.skipTypesetting} afecta a todas
+las voces y pentagramas, ahorrando más tiempo incluso.
+
@node Formatos de salida alternativos
@subsection Formatos de salida alternativos
@cindex EPS, salida
@cindex PostScript encapsulado, salida de
-Los formatos de salida predeterminados para la partitura impresa son
-el formato de documento portátil (PDF) y PostScript (PS). Los
-formatos de salida Gráficos de vector escalables (SVG), PostScript
-encapsulado (EPS) y Gráficos de red portátiles (PNG) también están
-disponibles a través de opciones de la línea de órdenes, véase
-@rprogram{Opciones de la línea de órdenes para lilypond}.
+Los formatos de salida predeterminados para la partitura impresa
+son el formato de documento portátil (PDF) y PostScript (PS).
+Los formatos de salida Gráficos de red portátiles (PNG),
+Gráficos de vector escalables (SVG) y PostScript encapsulado (EPS)
+también están disponibles a través de opciones de la línea de
+órdenes, véase
+@rprogram{Opciones básicas de la línea de órdenes para LilyPond}.
@node Sustituir la tipografía de la notación
@subsection Sustituir la tipografía de la notación
@translationof Replacing the notation font
-Gonville es una alternativa a la tipografía Feta que se utiliza en
-LilyPond y se puede descargar de:
+Gonville es una alternativa a la tipografía Emmentaler que se utiliza
+en LilyPond y se puede descargar de:
@example
@uref{http://www.chiark.greenend.org.uk/~sgtatham/gonville/ ,http://www.chiark.greenend.org.uk/~sgtatham/gonville/}
@end example
@c NOTE: these images are a bit big, but that's important
@c for the font comparison. -gp
-@sourceimage{Gonville_after,,,}
+@sourceimage{Gonville_after,15cm,,}
-Aquí hay unos compases de muestra tipografiados en la fuente Feta de
-LilyPond:
+Aquí hay unos compases de muestra tipografiados en el glifos Feta
+de LilyPond:
-@sourceimage{Gonville_before,,,}
+@sourceimage{Gonville_before,15cm,,}
@subsubheading Instrucciones de instalación para MacOS
-Descargue y extraiga el archivo zip. Copie la carpeta @code{lilyfonts}
-a @file{@var{SHARE_DIR}/lilypond/current}; para más información,
-consulte @rlearning{Otras fuentes de información}. Renombre la carpeta
-@code{fonts} existente a @code{fonts_orig} y la carpeta
-@code{lilyfonts} a @code{fonts}. Para volver a la fuente Feta,
-invierta el proceso.
+Descargue y extraiga el archivo zip. Copie la carpeta
+@code{lilyfonts} a @file{@var{SHARE_DIR}/lilypond/current}; para
+más información, consulte @rlearning{Otras fuentes de
+información}. Renombre la carpeta @code{fonts} existente a
+@code{fonts_orig} y la carpeta @code{lilyfonts} a @code{fonts}.
+Para volver a la fuente Emmentaler, invierta el proceso.
@seealso
Manual de aprendizaje:
@rlearning{Otras fuentes de información}.
@knownissues
-
Gonville no se puede usar para tipografiar notación de @q{Música
Antigua} y es probable que cualquier nuevo glifo en versiones
-posteriores de LilyPond no existan en la familia
-tipográfica Gonville. Diríjase a la página web del autor para obtener más
+posteriores de LilyPond no existan en la familia tipográfica
+Gonville. Diríjase a la página web del autor para obtener más
información sobre éste y otros asuntos, entre ellos el régimen de
licencias de Gonville.
-@node Salida MIDI
-@section Salida MIDI
-@translationof MIDI output
+@node Creación de salida MIDI
+@section Creación de salida MIDI
+@translationof Creating MIDI output
@cindex sonido
@cindex MIDI
-El MIDI (Musical Instrument Digital Interface, Interfase Digital para
-Instrumentos Musicales) es un estándar para interconectar y controlar
-instrumentos musicales electrónicos. Un archivo o secuencia MIDI es
-una serie de notas dentro de un conjunto de pistas. No es un archivo
-de sonidos reales; se necesita un programa reproductor especial para
-traducir la serie de notas en sonidos de verdad.
-
-Cualquier música se puede convertir a archivos MIDI, de manera que
-podamos escuchar lo que hayamos introducido. Esto es muy conveniente
-para comprobar la corrección de la música; las octavas equivocadas o
-las alteraciones erróneas se ponen de relieve muy claramente al
-escuchar la salida MIDI.
+LilyPond puede producir archivos que siguen el estándar MIDI
+(Musical Instrument Digital Interface; interfaz digital para
+instrumentos musicales) y permitir así comprobar la música por el
+oído (con la ayuda de alguna aplicación o dispositivo que
+entienda el MIDI). La escucha de la salida MIDI también puede
+ser de ayuda en la localización de errores tales como notas que
+se han introducido incorrectamente, alteraciones omitidas y otros
+casos por el estilo.
-La salida estándar de MIDI es un poco primitiva; de forma opcional, se
-encuentra disponible una salida MIDI mejorada y mucho más realista,
-por medio de @ref{El script Articulate}.
-
-La salida MIDI reserva un canal por cada pentagrama, y reserva
-el canal 10 para la percusión. Sólo hay 16 canales MIDI por cada
-dispositivo, por lo que si la partitura tiene más de 15 pautas, los
-canales MIDI se reutilizarán.
+Los archivos MIDI no contienen sonido (como los archivos AAC, MP3
+o Vorbis) pero requieren software adicional para producir el
+sonido a partir de ellos.
@menu
-* Crear archivos MIDI::
+* Notación contemplada por el MIDI::
+* Notación no contemplada en el MIDI::
* El bloque MIDI::
-* ¿Qué sale por el MIDI?::
-* Repeticiones y MIDI::
-* Control de los matices en el MIDI::
-* Percusión en MIDI::
+* Control de las dinámicas del MIDI::
+* Uso de los instrumentos MIDI::
+* Uso de las repeticiones con el MIDI::
+* Asignación de canales MIDI::
+* Propiedades de contexto para efectos MIDI::
+* Enriquecimiento de la salida MIDI::
* El script Articulate::
@end menu
-@node Crear archivos MIDI
-@subsection Crear archivos MIDI
-@translationof Creating MIDI files
+@cindex MIDI, notación contemplada
-Para crear un MIDI a partir de una pieza de música, escriba un bloque
-@code{\midi} en la partitura, por ejemplo:
+@node Notación contemplada por el MIDI
+@subsection Notación contemplada por el MIDI
+@translationof Supported notation for MIDI
-@example
-\score @{
- @var{...música...}
- \midi @{ @}
-@}
-@end example
+Se puede usar la notación musical siguiente con las posibilidades
+predeterminadas de LilyPond para producir salida MIDI:
+
+@itemize
+@item Marcas de respiración
+@item Acordes introducidos como nombres de acorde
+@item Crescendos y decrescendos sobre más de una nota. El volumen se altera de forma lineal entre los dos extremos
+@item Indicadores dinámicos desde @code{ppppp} hasta @code{fffff}, incluyendo @code{mp}, @code{mf} y @code{sf}
+@item Microtonos, pero @emph{no} acordes microtonales. Se necesita también un reproductor de MIDI capaz de ejecutar eventos de rueda de tono.
+@item Letra de las canciones
+@item Altura de las notas
+@item Ritmo introducido como duraciones de las notas, incluidos los grupos de valoración especial como los tresillos
+@item Articulaciones @q{sencillas}; picado, staccato, acento, marcato y portato
+@item Cambios de tempo introducidos con la función @code{\tempo}
+@item Ligaduras de unión
+@item Trémolos que @emph{not} se hayan introducido como un valor del tipo @q{@code{:}[@var{número}]}
+@end itemize
-Si hay un bloque @code{\midi} dentro de un @code{\score} que no tenga
-ningún bloque @code{\layout}, solamente se producirá MIDI. Si se
-necesita una notación impresa, debe haber también un bloque
-@code{\layout}:
+También se pueden controlar el panorama, el balance, la expresión
+y los efectos de reverberación y chorus mediante el
+establecimiento de propiedades de contexto, véase
+@ref{Propiedades de contexto para efectos MIDI}.
+
+Si se combina con el script @file{articulate}, es posible
+producir la salida por el MIDI de los siguientes elementos
+adicionales de notación musical:
+
+@itemize
+@item Appoggiaturas (apoyaturas). Se les da la mitad de la duración de la nota siguiente (sin tener en cuenta los puntillos). Por ejemplo:
@example
-\score @{
- @var{...música...}
- \midi @{ @}
- \layout @{ @}
-@}
+\appoggiatura c8 d2.
@end example
-Se traducen correctamente a la salida MIDI la altura y duración de las
-notas, las ligaduras de unión, matices y cambios de tempo. Las
-indicaciones dinámicas, crescendi y decrescendi se traducen a niveles
-de volumen MIDI. Las marcas dinámicas se traducen a una fracción fija
-del rango de volumen MIDI disponible. Los crescendi y decrescendi
-hacen que el volumen varía linealmente entre sus dos extremos. El
-efecto de las indicaciones dinámicas sobre la salida MIDI se puede
-eliminar por completo, véase @ref{El bloque MIDI}.
+@noindent
+El Do toma la duración de una negra.
-El tempo inicial y los cambios de tempo posteriores se pueden
-especificar utilizando la instrucción @code{\tempo} dentro de la
-propia notación musical. Se reflejan en cambios de tempo en la salida
-MIDI. Esta instrucción normalmente hace que se imprima la indicación
-metronómica, pero esto se puede eliminar, véase @ref{Indicaciones metronómicas}.
-Más abajo se describe una forma alternativa de especificar el tempo
-MIDI inicial o global, véase @ref{El bloque MIDI}.
+@item Notas y grupos de adorno (mordentes de una nota, trinos, grupetos circulares, etc.)
+@item Rallentando, accelerando, ritardando y a tempo
+@item Ligaduras de expresión y de fraseo
+@item Tenuto
+@end itemize
-Debido a ciertas limitaciones de Windows, la extensión predeterminada
-para los archivos MIDI en Windows es @code{.mid}. Otros sistemas
-operativos utilizan la extensión @code{.midi}. Si prefiere una
-extensión diferente, inserte la siguiente línea en el nivel jerárquico
-superior del archivo de entrada, antes del inicio de cualquier bloque
-@code{\book}, @code{\bookpart} o @code{\score}:
+@noindent
+Véase @ref{Enriquecimiento de la salida MIDI}.
-@example
-#(ly:set-option 'midi-extension "midi")
-@end example
+@cindex MIDI, notación no contemplada
-La línea anterior establece la extensión predeterminada para los
-archivos MIDI a @code{.midi}.
+@node Notación no contemplada en el MIDI
+@subsection Notación no contemplada en el MIDI
+@translationof Unsupported notation for MIDI
-De forma alternativa, esta opción se puede también proporcionar en la
-línea de órdenes:
+Los siguientes elementos de notación musical no se pueden hacer
+salir por el MIDI:
-@example
-lilypond … -dmidi-extension=midi archivoLily.ly
-@end example
+@itemize
+@item Articulaciones distintas al picado, staccato, acento, marcato y portato
+@item Crescendos y decrescendos sobre una @emph{sola} nota
+@item Calderón
+@item Bajo cifrado
+@item Glissandos
+@item Caídas y elevaciones
+@item Acordes microtonales
+@item Duraciones introducidas como anotaciones, p.ej. el swing
+@item Cambios de tempo sin @code{\tempo} (p.ej., introducidas como anotaciones)
+@item Trémolos que @emph{se introducen} con la notación de la forma @q{@code{:}[@var{número}]}
+@end itemize
-@unnumberedsubsubsec Nombres de instrumentos
+@node El bloque MIDI
+@subsection El bloque MIDI
+@translationof The MIDI block
-@cindex instrumento, nombres de
-@funindex Staff.midiInstrument
+@cindex bloque MIDI
-El nombre del instrumento MIDI se establece mediante la propiedad
-@code{Staff.midiInstrument}. El nombre del instrumento se debe elegir
-de entre los que están en la lista que aparece en @ref{Instrumentos MIDI}.
+Para crear un archivo de salida MIDI a partir de un archivo de
+entrada de LilyPond, introduzca un bloque @code{\midi}, que puede
+estar vacío, dentro del bloque @code{\score}:
@example
-\new Staff @{
- \set Staff.midiInstrument = #"glockenspiel"
- @var{...notes...}
+\score @{
+ @var{@dots{} música @dots{}}
+ \layout @{ @}
+ \midi @{ @}
@}
@end example
+@warning{ Un bloque @code{@bs{}score} que, además de la música,
+contiene solamente un bloque @code{@bs{}midi} (o sea, @emph{sin}
+el bloque @code{@bs{}layout}), solo produce archivos de salida
+MIDI; no se imprime ninguna notación musical.}
+
+La extensión predeterminada para los archivos de salida
+(@code{.midi}) se puede cambiar usando la opción
+@code{-dmidi-extension} con la instrucción @code{lilypond}:
+
@example
-\new Staff \with @{midiInstrument = #"cello"@} @{
- @var{...notes...}
-@}
+lilypond -dmidi-extension=mid Archivo.ly
@end example
-Si el instrumento elegido no coincide exactamente con uno de los
-instrumentos de la lista de instrumentos MIDI, se usará el instrumento
-Piano de Cola (@code{"acoustic grand"}).
+Como alternativa, puede añadirse la siguiente expresión de Scheme
+antes del comienzo de uno de los bloques @code{\book},
+@code{\bookpart} o @code{\score}. Véase @ref{Estructura del archivo}.
-@snippets
+@example
+#(ly:set-option 'midi-extension "mid")
+@end example
-@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
-{changing-midi-output-to-one-channel-per-voice.ly}
+@seealso
+Referencia de la notación:
+@ref{Estructura del archivo}.
+
+Archivos instalados:
+@file{scm/midi.scm}.
@knownissues
+Están disponibles 15 canales MIDI y un canal adicional (el número
+10) para la percusión. Los pentagramas se asignan a los canales
+por orden, de forma que una partitura que contenga más de 15
+pentagramas da como resultado que los pentagramas adicionales
+comparten (pero no sobreescriben) el mismo canal MIDI. Esto
+puede ser problemático si los pentagramas que comparten canal
+tienen establecidas propiedades MIDI, basadas en canal, en mutuo
+conflicto (como distintos instrumentos MIDI).
+
+
+@node Control de las dinámicas del MIDI
+@subsection Control de las dinámicas del MIDI
+@translationof Controlling MIDI dynamics
-@c In 2.11 the following no longer seems to be a problem -td
-@ignore
-Unterminated (de)crescendos will not render properly in the midi file,
-resulting in silent passages of music. The workaround is to explicitly
-terminate the (de)crescendo. For example,
+Es posible controlar el volumen MIDI general, el volumen relativo
+de las indicaciones de matiz dinámico y el volumen relativo de
+los distintos instrumentos.
-@example
-@{ a4\< b c d\f @}
-@end example
+Las indicaciones matiz dinámico se traducen automáticamente a
+niveles de volumen dentro del rango de volúmenes MIDI disponible
+mientras que los crescendos y decrescendos varían el volumen
+linealmente entre sus dos extremos. Es posible controlar el
+volumen relativo de las indicaciones de matiz dinámico, y el
+volumen general de los diferentes instrumentos.
-@noindent
-will not work properly but
+@menu
+* Indicaciones de matiz dinámico en el MIDI::
+* Establecimiento del volumen MIDI::
+* Establecimiento de las propiedades del bloque MIDI::
+@end menu
-@example
-@{ a4\< b c d\!\f @}
-@end example
+@cindex MIDI, volumen
+@cindex MIDI, ecualización
+@cindex MIDI, matices dinámicos
+@cindex dinámica del MIDI
-@noindent
-will.
-@end ignore
-Los cambios del volumen MIDI sólo tienen lugar al principio de la
-nota, por lo que los crescendi y decrescendi no pueden afectar al
-volumen de una sola nota.
+@node Indicaciones de matiz dinámico en el MIDI
+@unnumberedsubsubsec Indicaciones de matiz dinámico en el MIDI
+@translationof Dynamic marks in MIDI
-No todos los reproductores de MIDI manejar adecuadamente los cambios de
-tempo de la salida MIDI. Entre los reproductores que se sabe que
-funcionan se encuentran el Reproductor de Medios de MS Windows y
-@uref{http://@/timidity@/.sourceforge@/.net/,timidity}.
+Solo las marcas de dinámica desde @code{ppppp} hasta
+@code{fffff}, incluidos @code{mp}, @code{mf} y @code{sf} tienen
+valores asignados. Este valor se aplica a continuación al valor
+del rango de volumen MIDI general para obtener el volumen final
+que se incluye en la salida MIDI para esa indicación de matiz
+dinámico en particular. Las fracciones predeterminadas varían
+desde 0.25 para el @notation{ppppp} hasta 0.95 para el
+@notation{fffff}. El conjunto completo de las indicaciones de
+matiz dinámico pueden verse en el archivo @file{scm/midi.scm}.
-@node El bloque MIDI
-@subsection El bloque MIDI
-@translationof MIDI block
+@snippets
+@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
+{creating-custom-dynamics-in-midi-output.ly}
-@cindex bloque MIDI
+Archivos instalados:
+@file{ly/script-init.ly}
+@file{scm/midi.scm}.
-Si se requiere una salida MIDI, debe aparecer un bloque @code{\midi}
-dentro de un bloque de partitura. Es análogo al bloque layout de
-diseño de página, pero algo más simple. Con frecuencia, el bloque
-@code{\midi} se deja vacío, pero puede contener reorganizaciones de
-contextos, definiciones de contexto nuevas o código para fijar valores
-de propiedades. Por ejemplo, en el ejemplo siguiente se establece el
-tempo inicial exportado al archivo MIDI sin hacer que se imprima una
-indicación de tempo:
+Fragmentos de código:
+@rlsr{MIDI}.
-@example
-\score @{
- @var{...música...}
- \midi @{
- \tempo 4 = 72
- @}
-@}
-@end example
+Referencia de funcionamiento interno:
+@rinternals{Dynamic_performer}.
+
+
+@node Establecimiento del volumen MIDI
+@unnumberedsubsubsec Establecimiento del volumen MIDI
+@translationof Setting MIDI volume
-En este ejemplo, el tempo se establece a 72 pulsos de negra por
-minuto. Esta clase de especificación de tempo no puede tomar como
-argumento una figura con puntillo. Si necesitamos una figura con
-puntillo, dividimos la nota con puntillo en figuras más pequeñas. Por
-ejemplo, un tempo de 90 negras con puntillo por minuto se puede
-especificar como 270 corcheas por minuto:
+Los volúmenes generales mínimo y máximo de las indicaciones de
+matiz dinámico MIDI se controlan estableciendo las propiedades
+@code{midiMinimumVolume} y @code{midiMaximumVolume} en el nivel
+del bloque @code{Score}. Estas propiedades tienen efecto
+solamente al comienzo de una vos y sobre las indicaciones
+dinámicas. La fracción que corresponde a cada indicación
+dinámica se modifica con esta fórmula:
@example
-tempoWholesPerMinute = #(ly:make-moment 270 8)
+midiMinimumVolume + (midiMaximumVolume - midiMinimumVolume) * fracción
@end example
-@cindex MIDI, definiciones de contexto
-
-Las definiciones de contexto siguen con precisión la misma sintaxis
-que la de un bloque @code{\layout}. Los módulos de traducción para el
-sonido reciben el nombre de ejecutantes. Los contextos para la salida
-MIDI se definen en @file{../ly/performer-init.ly}, véase
-@rlearning{Otras fuentes de información}. Por ejemplo, para eliminar
-el efecto de los matices de la salida MIDI, inserte las líneas
-siguientes en el bloque @code{\midi@{ @}}.
+En el ejemplo siguiente, el rango dinámico del volumen MIDI
+general se limita al intervalo entre @code{0.2} y @code{0.5}.
@example
-\midi @{
- ...
- \context @{
- \Voice
- \remove "Dynamic_performer"
+\score @{
+ <<
+ \new Staff @{
+ \set Staff.midiInstrument = #"flute"
+ @var{@dots{} music @dots{}}
+ @}
+ \new Staff @{
+ \set Staff.midiInstrument = #"clarinet"
+ @var{@dots{} music @dots{}}
+ @}
+ >>
+ \midi @{
+ \context @{
+ \Score
+ midiMinimumVolume = #0.2
+ midiMaximumVolume = #0.5
+ @}
@}
@}
@end example
-La salida MIDI se crea sólo cuando se incluye un bloque @code{\midi}
-dentro de un bloque de partitura definido con una instrucción
-@code{\score}.
+Se puede obtener una ecualización sencilla de instrumentos MIDI
+estableciendo las propiedades @code{midiMinimumVolume} y
+@code{midiMaximumVolume} dentro del contexto @code{Staff}.
@example
\score @{
- @{ @dots{}notas@dots{} @}
+ \new Staff @{
+ \set Staff.midiInstrument = #"flute"
+ \set Staff.midiMinimumVolume = #0.7
+ \set Staff.midiMaximumVolume = #0.9
+ @var{@dots{} music @dots{}}
+ @}
\midi @{ @}
@}
@end example
-@node ¿Qué sale por el MIDI?
-@subsection ¿Qué sale por el MIDI?
-@translationof What goes into the MIDI output?
-
-@unnumberedsubsubsec Contemplado en el MIDI
-
-@cindex alturas en MIDI
-@cindex MIDI, alturas
-@cindex cuartos de tono en MIDI
-@cindex MIDI, cuartos de tono
-@cindex microtonos en MIDI
-@cindex MIDI, microtonos
-@cindex acordes, nombres de, en MIDI
-@cindex MIDI, nombres de
-@cindex duraciones en MIDI
-@cindex MIDI, duraciones
-@cindex Articlulate, scripts
-@cindex MIDI, articulaciones
-@cindex articulaciones en MIDI
-@cindex trinos en MIDI
-@cindex grupetos en MIDI
-@cindex rallentando en MIDI
-@cindex accelerando en MIDI
-@c TODO etc
-
-Los siguientes elementos de notación se reflejan en la salida MIDI:
+Para partituras con más de un pentagrama y más de un instrumento
+MIDI, se pueden fijar individualmente los volúmenes relativos de
+cada instrumento:
-@itemize
-@item Alturas
-@item Microtonos (véase @ref{Alteraciones accidentales}. La reproducción necesita un reproductor que contemple la curvatura de tono o @emph{pitch bend}.)
-@item Acordes escritos como nombres de acorde
-@item Ritmos escritos como duraciones de las notas, incluidos los grupos de valoración especial
-@item Trémolos escritos sin @q{@code{:}[@var{número}]}
-@item Ligaduras de unión
-@item Matices o indicaciones de dinámica
-@item Crescendi y decrescendi sobre varias notas
-@item Cambios de tempo insertados con una marca metronómica
-@item Letra de las canciones
-@end itemize
+@example
+\score @{
+ <<
+ \new Staff @{
+ \set Staff.midiInstrument = #"flute"
+ \set Staff.midiMinimumVolume = #0.7
+ \set Staff.midiMaximumVolume = #0.9
+ @var{@dots{} music @dots{}}
+ @}
+ \new Staff @{
+ \set Staff.midiInstrument = #"clarinet"
+ \set Staff.midiMinimumVolume = #0.3
+ \set Staff.midiMaximumVolume = #0.6
+ @var{@dots{} music @dots{}}
+ @}
+ >>
+ \midi @{ @}
+@}
+@end example
-Utilizando @ref{El script Articulate}, a la lista anterior se añaden
-una serie de elementos:
+En este ejemplo el volumen del clarinete se reduce de forma
+relativa al volumen de la flauta.
-@itemize
-@item Articulaciones (ligaduras de expresión, picados, etc)
-@item Trinos, mordentes circulares
-@item Rallentando y accelerando
-@end itemize
+Si no se establecen estas propiedades de volumen, LilyPond aún
+aplica un @q{pequeño grado} de ecualización a ciertos
+instrumentos. Véase @file{scm/midi.scm}.
+Archivos instalados:
+@file{scm/midi.scm}.
-@unnumberedsubsubsec No contemplado en el MIDI
+@seealso
+Referencia de la notación:
+@ref{Disposición de la partitura}.
-@c TODO index as above
+Referencia de funcionamiento interno:
+@rinternals{Dynamic_performer}.
-Los siguientes elementos de notación no tienen ningún efecto sobre la
-salida MIDI, a no ser que utilicemos @ref{El script Articulate}:
+@snippets
+@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
+{replacing-default-midi-instrument-equalization.ly}
-@itemize
-@item Duraciones escritas como anotaciones, p.ej. el swing
-@item Cambios de tempo escritos como anotaciones sin marca de tempo
-@item Staccato y otras articulaciones y ornamentos
-@item Ligaduras de expresión y de fraseo
-@item Crescendi y decrescendi sobre una nota única
-@item Trémolos introducidos con @q{@code{:}[@var{número}]}
-@item Bajo cifrado
-@item Acordes microtonales
-@end itemize
+@knownissues
+Los cambios en el volumen del MIDI solamente tienen lugar en el
+comienzo de una nota, por lo que los crescendos y decrescendos no
+afectan al volumen de una sola nota.
+@node Establecimiento de las propiedades del bloque MIDI
+@unnumberedsubsubsec Establecimiento de las propiedades del bloque MIDI
+@translationof Setting MIDI block properties
-@node Repeticiones y MIDI
-@subsection Repeticiones y MIDI
-@translationof Repeats in MIDI
+El bloque @code{\midi} puede contener distintas disposiciones de
+los contextos, definiciones de contexto nuevas o código que fija
+los valores de ciertas propiedades.
-@cindex repeticiones, expandir
-@funindex \unfoldRepeats
+@example
+\score @{
+ @var{@dots{} music @dots{}}
+ \midi @{
+ \tempo 4 = 72
+ @}
+@}
+@end example
-Con un poco de trucaje, se puede hacer que cualquier tipo de
-repetición esté presente en la salida MIDI. Esto se consigue mediante
-la aplicación de la función musical @code{\unfoldRepeats}. Esta
-función cambia todas las repeticiones a repeticiones desplegadas.
+Aquí, el tempo se establece a 72 pulsos de negra por minuto. La
+indicación de tempo dentro del bloque @code{\midi} no aparece en
+la partitura impresa. Aunque cualquier otra indicación de
+@code{\tempo} que se especifique dentro del bloque @code{\score}
+también se reflejará en la salida MIDI.
-@lilypond[quote,verbatim]
-\unfoldRepeats {
- \repeat tremolo 8 { c'32 e' }
- \repeat percent 2 { c''8 d'' }
- \repeat volta 2 { c'4 d' e' f' }
- \alternative {
- { g' a' a' g' }
- { f' e' d' c' }
- }
-}
-\bar "|."
-@end lilypond
+Dentro de un bloque @code{\midi}, la instrucción @code{\tempo}
+está estableciendo propiedades durante la interpretación de la
+música y en el contexto de las definiciones de salida; así, se
+interpreta @emph{como si} fuera una modificación de contesto.
-En partituras con varias voces, el desplegado de las repeticiones en
-la salida MIDI solo se produce correctamente si @emph{todas y cada
-una} de las voces incluye las repeticiones de manera completa y
-explícita.
+@cindex MIDI, definiciones de contexto
+@cindex contexto, definiciones con MIDI
-Al crear un archivo de partitura que use @code{\unfoldRepeats} para el
-MIDI, es necesario hacer dos bloques @code{\score}: uno para el MIDI
-(con repeticiones desplegadas) y otro para la notación impresa (con
-repeticiones de volta --primera y segunda vez--, tremolo --trémolo--,
-y percent --repetición de compases--). Por ejemplo,
+Las definiciones de contexto siguen la misma sintaxis que las del
+bloque @code{\layout}:
@example
\score @{
- @var{..música..}
- \layout @{ .. @}
-@}
-\score @{
- \unfoldRepeats @var{..música..}
- \midi @{ .. @}
+ @var{@dots{} music @dots{}}
+ \midi @{
+ \context @{
+ \Voice
+ \remove "Dynamic_performer"
+ @}
+ @}
@}
@end example
+Este ejemplo suprime el efecto de las indicaciones dinámicas
+sobre la salida MIDI. Nota: los módulos de traducción de
+LilyPond usados para el sonido se llaman @q{performers}.
-@node Control de los matices en el MIDI
-@subsection Control de los matices en el MIDI
-@translationof Controlling MIDI dynamics
+@seealso
+Manual de aprendizaje:
+@rlearning{Otras fuentes de información}.
-La dinámica en el MIDI está implementada por medio del intérprete
-Dynamic_performer que reside de forma predeterminada dentro del
-contexto Voice. Es posible controlar el volumen MIDI general, el
-volumen relativo de los matices dinámicos y el volumen relativo de los
-distintos instrumentos.
-
-@unnumberedsubsubsec Indicaciones dinámicas
-
-Los matices o indicaciones de dinámica se traducen a una fracción fija
-del rango de volumen MIDI disponible. Las fracciones predeterminadas
-se extienden desde 0.25 para @notation{ppppp} hasta 0.95 para
-@notation{fffff}. El conjunto de indicaciones dinámicas y las
-fracciones asociadas pueden verse en @file{../scm/midi.scm}, véase
-@rlearning{Otras fuentes de información}. Este conjunto de fracciones
-se puede cambiar o extender proporcionando una función que toma como
-argumento una indicación dinámica y devuelve la fracción requerida, y
-estableciendo @code{Score.dynamicAbsoluteVolumeFunction} a esta
-función.
-
-Por ejemplo, si se requiere una indicación dinámica
-@notation{rinforzando}, @code{\rfz}, ésta no tiene ningún efecto
-predeterminado sobre el volumen MIDI, pues no está incluida en el
-conjunto predeterminado. De igual manera, si se define una indicación
-dinámica nueva con @code{make-dynamic-script}, ésta tampoco estará
-incluida en el conjunto predeterminado. El ejemplo siguiente muestra
-cómo hay que añadir el volumen MIDI para estas indicaciones dinámicas.
-La función Scheme establece la fracción a 0.9 si se encuentra una
-indicación dinámica rfz, y en caso contrario llama a la función
-predeterminada.
+Referencia de la notación:
+@ref{Expresiones},
+@ref{Disposición de la partitura}.
-@lilypond[verbatim,quote]
-#(define (myDynamics dynamic)
- (if (equal? dynamic "rfz")
- 0.9
- (default-dynamic-absolute-volume dynamic)))
+Archivos instalados:
+@file{ly/performer-init.ly}.
-\score {
- \new Staff {
- \set Staff.midiInstrument = #"cello"
- \set Score.dynamicAbsoluteVolumeFunction = #myDynamics
- \new Voice {
- \relative c'' {
- a4\pp b c-\rfz
- }
- }
- }
- \layout {}
- \midi {}
-}
-@end lilypond
+Fragmentos de código:
+@rlsr{MIDI}.
-Como alternativa, si se necesitara redefinir la tabla completa de
-fracciones, sería mejor usar el procedimiento
-@notation{default-dynamic-absolute-volume} que aparece en
-@file{../scm/midi.scm} y la tabla asociada como modelo. El último
-ejemplo de esta sección muestra cómo se puede hacer esto.
+Referencia de funcionamiento interno:
+@rinternals{Dynamic_performer}.
-@unnumberedsubsubsec Volumen maestro MIDI
+@knownissues
+Ciertos reproductores de MIDI no siempre maneja correctamente los
+cambios de tempo en la salida MIDI.
-El volumen general máximo y mínimo de las indicaciones dinámicas de
-MIDI se controla estableciendo valores para las propiedades
-@code{midiMinimumVolume} y @code{midiMaximumVolume} en el nivel de
-@code{Score}. Estas propiedades tienen efecto solamente sobre las
-indicaciones dinámicas, por ello si queremos que tengan validez desde
-el comienzo de la partitura, se debe colocar allí una indicación de
-dinámica. La fracción que corresponde a cada indicación dinámica se
-modifica con esta fórmula:
+Los cambios efectuados al @code{midiInstrument}, así como ciertas
+opciones MIDI, al @emph{comienzo} de un pentagrama pueden
+aparecer dos veces en la salida MIDI.
+
+
+
+@node Uso de los instrumentos MIDI
+@subsection Uso de los instrumentos MIDI
+@translationof Using MIDI instruments
+
+Los instrumentos MIDI se establecen usando la propiedad
+@code{midiInstrument} dentro de un contexto @code{Staff}.
@example
-midiMinimumVolume + (midiMaximumVolume - midiMinimumVolume) * fracción
+\score @{
+ \new Staff @{
+ \set Staff.midiInstrument = #"glockenspiel"
+ @var{@dots{} music @dots{}}
+ @}
+ \midi @{ @}
+@}
@end example
-En el ejemplo siguiente, el rango de intensidad dinámica del volumen
-general MIDI está limitado al intervalo desde 0.2 hasta 0.5.
-
-@lilypond[verbatim,quote]
-\score {
- <<
- \new Staff {
- \key g \major
- \time 2/2
- \set Staff.midiInstrument = #"flute"
- \new Voice \relative c''' {
- r2 g\mp g fis~
- fis4 g8 fis e2~
- e4 d8 cis d2
- }
- }
- \new Staff {
- \key g \major
- \set Staff.midiInstrument = #"clarinet"
- \new Voice \relative c'' {
- b1\p a2. b8 a
- g2. fis8 e
- fis2 r
- }
- }
- >>
- \layout {}
- \midi {
- \context {
- \Score
- tempoWholesPerMinute = #(ly:make-moment 72 2)
- midiMinimumVolume = #0.2
- midiMaximumVolume = #0.5
- }
- }
-}
-@end lilypond
+o
-@unnumberedsubsubsec Balance entre instrumentos (i)
+@example
+\score @{
+ \new Staff \with @{midiInstrument = #"cello"@} @{
+ @var{@dots{} music @dots{}}
+ @}
+ \midi @{ @}
+@}
+@end example
-Si las propiedades de volumen MIDI máximo y mínimo están establecidas
-en el contexto @code{Staff} se pueden controlar los volúmenes
-relativos de los instrumentos MIDI. Esto proporciona un ecualizador
-de instrumentos básico que puede realzar significativamente la calidad
-de la salida MIDI.
+Si el instrumento elegido no coincide exactamente con uno de los
+instrumentos de la lista de la sección @q{instrumentos MIDI}, se
+usará el instrumento Piano de Cola (@code{"acoustic grand"}).
+Véase @ref{Instrumentos MIDI}.
-En este ejemplo se reduce el volumen del clarinete con relación al de
-la flauta. Debe haber una indicación dinámica en la primera nota de
-cada instrumento para que esto funcione correctamente.
+@seealso
+Manual de aprendizaje:
+@rlearning{Otras fuentes de información}.
-@lilypond[verbatim,quote]
-\score {
- <<
- \new Staff {
- \key g \major
- \time 2/2
- \set Staff.midiInstrument = #"flute"
- \set Staff.midiMinimumVolume = #0.7
- \set Staff.midiMaximumVolume = #0.9
- \new Voice \relative c''' {
- r2 g\mp g fis~
- fis4 g8 fis e2~
- e4 d8 cis d2
- }
- }
- \new Staff {
- \key g \major
- \set Staff.midiInstrument = #"clarinet"
- \set Staff.midiMinimumVolume = #0.3
- \set Staff.midiMaximumVolume = #0.6
- \new Voice \relative c'' {
- b1\p a2. b8 a
- g2. fis8 e
- fis2 r
- }
- }
- >>
- \layout {}
- \midi {
- \tempo 2 = 72
- }
-}
-@end lilypond
+Referencia de la notación:
+@ref{Instrumentos MIDI},
+@ref{Disposición de la partitura}.
-@unnumberedsubsubsec Balance entre instrumentos (ii)
-
-Si las propiedades de volumen MIDI máximo y mínimo no están
-establecidas, de forma predeterminada LilyPond aplica un pequeño grado
-de ecualización a algunos instrumentos. Los instrumentos y la
-ecualización que se aplica se muestra en la tabla
-@notation{instrument-equalizer-alist} en @file{../scm/midi.scm}.
-
-El ecualizador básico predeterminado se puede sustituir estableciendo
-@code{instrumentEqualizer} en el contexto @code{Score} a un
-procedimiento Scheme nuevo que acepte el nombre de un instrumento MIDI
-como único argumento y devuelva un par de fracciones que dan los
-volúmenes máximo y mínimo que se aplican a dicho instrumento. Esta
-sustitución se hace de la misma forma que mostramos para restablecer
-la fracción de volumen absoluto @code{dynamicAbsoluteVolumeFunction}
-al comienzo de esta sección. El ecualizador predeterminado,
-@notation{default-instrument-equalizer}, en
-@file{../scm/midi.scm}, muestra cómo se puede escribir tal
-procedimiento.
-
-El ejemplo siguiente establece los volúmenes relativos de la flauta y
-del clarinete a los mismos valores que el ejemplo anterior.
+Archivos instalados:
+@file{scm/midi.scm}.
-@lilypond[verbatim,quote]
-#(define my-instrument-equalizer-alist '())
+@knownissues
+Los instrumentos de percusión cuya notación está en un contexto
+@code{DrumStaff} se encontrará a la salida, correctamente, sobre
+el canal MIDI número@tie{}10 pero ciertos instrumentos de
+percusión afinada como el xilófono, el vibráfono o los timbales,
+se tratan como instrumentos @qq{normales}, de forma que la música
+de éstos se debe introducir en un contexto @code{Staff} (no
+@code{DrumStaff}) para obtener una salida MIDI correcta. Hay una
+lista completa de entradas de los @code{sets de percusión del
+canal 10} en el archivo @file{scm/midi.scm}. Véase
+@rlearning{Otras fuentes de información}.
-#(set! my-instrument-equalizer-alist
- (append
- '(
- ("flute" . (0.7 . 0.9))
- ("clarinet" . (0.3 . 0.6)))
- my-instrument-equalizer-alist))
-#(define (my-instrument-equalizer s)
- (let ((entry (assoc s my-instrument-equalizer-alist)))
- (if entry
- (cdr entry))))
+@node Uso de las repeticiones con el MIDI
+@subsection Uso de las repeticiones con el MIDI
+@translationof Using repeats with MIDI
-\score {
- <<
- \new Staff {
- \key g \major
- \time 2/2
- \set Score.instrumentEqualizer = #my-instrument-equalizer
- \set Staff.midiInstrument = #"flute"
- \new Voice \relative c''' {
- r2 g\mp g fis~
- fis4 g8 fis e2~
- e4 d8 cis d2
- }
- }
- \new Staff {
- \key g \major
- \set Staff.midiInstrument = #"clarinet"
- \new Voice \relative c'' {
- b1\p a2. b8 a
- g2. fis8 e
- fis2 r
- }
- }
- >>
- \layout { }
- \midi {
- \tempo 2 = 72
- }
-}
-@end lilypond
+@cindex repeticiones en MIDI
+@cindex MIDI con repeticiones
+@funindex \unfoldRepeats
-@ignore
-@c Delete when satisfied this is adequately covered elsewhere -td
+Las repeticiones se pueden representar en la salida MIDI
+aplicando la instrucción @code{\unfoldRepeats}.
-@n ode Microtones in MIDI
-@s ubsection Microtones in MIDI
+@example
+\score @{
+ \unfoldRepeats @{
+ \repeat tremolo 8 @{ c'32 e' @}
+ \repeat percent 2 @{ c''8 d'' @}
+ \repeat volta 2 @{ c'4 d' e' f' @}
+ \alternative @{
+ @{ g' a' a' g' @}
+ @{ f' e' d' c' @}
+ @}
+ @}
+ \midi @{ @}
+@}
+@end example
-@cindex microtones in MIDI
+Para restringir el efecto de @code{\unfoldRepeats} a la salida
+MIDI únicamente, y al mismo tiempo genera partituras imprimibles,
+es necesario hacer @emph{dos} bloques @code{\score}: uno para el
+MIDI (con las repeticiones desplegadas) y otro para la notación
+(con repeticiones de primera y segunda vez, trémolos y del tipo
+porcentaje);
-Microtones consisting of half sharps and half flats are exported
-to the MIDI file and render correctly in MIDI players which support
-pitch bending. See @ref{Nombres de las notas en otros idiomas}. Here is
-an example showing all the half sharps and half flats. It can be
-copied out and compiled to test microtones in your MIDI player.
+@example
+\score @{
+ @var{@dots{} music @dots{}}
+ \layout @{ @}
+@}
+\score @{
+ \unfoldRepeats @{
+ @var{@dots{} music @dots{}}
+ @}
+ \midi @{ @}
+@}
+@end example
-@lilypond[verbatim,quote]
-\score {
- \relative c' {
- c4 cih cis cisih
- d4 dih ees eeh
- e4 eih f fih
- fis4 fisih g gih
- gis4 gisih a aih
- bes4 beh b bih
- }
- \layout {}
- \midi {}
-}
-@end lilypond
-@end ignore
+Si se usan varias voces, cada una de ellas debe contener las
+repeticiones completamente desplegadas para poder obtener una
+salida MIDI correcta.
+@seealso
+Referencia de la notación:
+@ref{Repeticiones}.
+
+
+@node Asignación de canales MIDI
+@subsection Asignación de canales MIDI
+@translationof MIDI channel mapping
+
+@cindex MIDI, canales
+@cindex MIDI, pistas
+@funindex midiChannelMapping
+
+Cuando se está generando un archivo MIDI de una partitura,
+LilyPond asigna cada nota de la partitura automáticamente a un
+canal MIDI, aquel en que se tocaría cuando se envía hacia un
+dispositivo MIDI. Un canal MIDI tiene una cierta cantidad de
+controles disponibles para seleccionar, por ejemplo, el
+instrumento que usar para reproducir las notas en ese canal, u
+ordenar al dispositivo MIDI que aplique diversos efectos al
+sonido producido sobre el canal. En todo momento, cada control
+de un canal MIDI solo puede tener asignado un valor único (que
+sin embargo se puede modificar, por ejemplo, para cambiar a otro
+instrumento en mitad de una partitura).
+
+El estándar MIDI contempla solamente 16 canales por dispositivo
+MIDI. Este límite en el número de canales limita también el
+número de instrumentos diferentes que pueden estar tocando al
+mismo tiempo.
+
+LilyPond crea pistas MIDI separadas para cada pentagrama (o
+instrumento o voz, según el valor de
+@code{Score.midiChannelMapping}), y también para cada contexto de
+letra. No hay un límite para el número de pistas.
+
+Para solventar el número limitado de canales MIDI, LilyPond
+contempla algunos modos diferentes para la asignación de canales
+MIDI, que se seleccionan usando la propiedad de contexto
+@code{Score.midiChannelMapping}. En cada caso, si se necesitan
+más canales MIDI que el límite, los números de canal asignados
+vuelven a contar desde cero, causando posiblemente una asignación
+incorrecta de instrumento a algunas notas. Esta propiedad de
+contexto se puede fijar a uno de los siguientes valores:
+
+@table @var
+
+@item @code{'staff}
+
+Reservar un canal MIDI distinto para cada uno de los pentagramas
+de la partitura (es el ajuste predeterminado). Todas las notas
+de todas las voces comparten el canal MIDI del pentagrama que las
+encierra, y todas se codifican dentro de la misma pista MIDI.
+
+El límite de 16 canales se aplica al número total de contextos de
+pentagrama y de letra, incluso aunque las letras del MIDI no
+consumen un canal MIDI.
+
+@item @code{'instrument}
+
+Reservar un canal MIDI distinto a cada uno de los instrumentos
+diferentes especificados en la partitura. Esto significa que
+todas las notas reproducidas con el mismo instrumento MIDI
+comparten el mismo canal MIDI (y la misma pista), incluso aunque
+las notas provengan de diferentes voces o pentagramas.
+
+En este caso los contextos de letra no cuentan para el límite de
+16 canales MIDI (ya que no se asignan a un instrumento MIDI), de
+forma que este ajuste puede permitir una mejor distribución de
+los canales MIDI cuando el número de contextos de pentagrama y de
+letra en la partitura excede la cantidad de 16.
+
+@item @code{'voice}
+
+Reservar un canal MIDI distinto a cada voz de la partitura que
+tenga un nombre único entre las voces de su pentagrama
+circundante. Las voces de los distintos pentagramas siempre se
+asignan a distintos canales MIDI pero dos voces cualesquiera
+contenidas dentro del mismo pentagrama comparten el mismo canal
+MIDI sin tienen el mismo nombre. A causa de que
+@code{midiInstrument} y los diversos controles MIDI para los
+efectos son propiedades del contexto de pentagrama, no se pueden
+fijar independientemente para cada voz. La primera voz se
+reproduce con el instrumento y los efectos especificados para el
+pentagrama, y las voces con un nombre distinto de la primera
+recibirán el instrumento y los efectos predeterminados.
+
+Nota: se pueden asignar distintos instrumentos y/o efectos a
+varias voces dentro del mismo pentagrama moviendo el
+@code{Staff_performer} del contexto @code{Staff} al contexto
+@code{Voice}, y dejando que @code{midiChannelMapping} conserve su
+valor predeterminado de @code{'staff} o se fije al valor
+@code{'instrument}; véase el fragmento de código siguiente.
+
+@end table
+
+Por ejemplo, la asignación predeterminada de canal MIDI de una
+partitura puede cambiarse al ajuste @code{'instrument} como se
+muestra a continuación:
-@node Percusión en MIDI
-@subsection Percusión en MIDI
-@translationof Percussion in MIDI
+@example
+\score @{
+ ...music...
+ \midi @{
+ \context @{
+ \Score
+ midiChannelMapping = #'instrument
+ @}
+ @}
+@}
+@end example
-La notación de los instrumentos de percusión se realiza normalmente en
-un contexto @code{DrumStaff} y cuando se hace de esta forma se les da
-salida correctamente por el canal MIDI@tie{}10, pero ciertos
-instrumentos de percusión de altura determinada, como el xilófono,
-marimba, vibráfono, timbales, etc., se tratan como instrumentos
-@qq{normales} y la música para estos instrumentos se debe introducir
-en contextos de @code{Staff} normales, no en un contexto
-@code{DrumStaff}, para obtener la salida MIDI correcta.
+@snippets
+@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
+{changing-midi-output-to-one-channel-per-voice.ly}
-Ciertos sonidos de altura indeterminada que están incluidos en el
-estándar General MIDI, como el tom melódico, el tambor taiko, los
-tambores sintéticos, etc., no se pueden acceder a través del canal
-MIDI@tie{}10, por lo que la notación para dichos instrumentos se debe
-introducir también en un contexto normal de @code{Staff}, utilizando
-las alturas normales adecuadas.
-Muchos instrumentos de percusión no están incluidos dentro del
-estándar General MIDI, p.ej. las castañuelas. El método más
-fácil (aunque no satisfactorio) de producir una salida MIDI al
-escribir para estos instrumentos es sustituirlos por el sonido más
-parecido del conjunto estándar.
+@node Propiedades de contexto para efectos MIDI
+@subsection Propiedades de contexto para efectos MIDI
+@translationof Context properties for MIDI effects
+
+@cindex Efectos en MIDI
+@cindex Panorama en MIDI
+@cindex Balance en MIDI
+@cindex Estéreo, balance en MIDI
+@cindex Expresión en MIDI
+@cindex Reverberación en MIDI
+@cindex Chorus en MIDI
+@funindex midiPanPosition
+@funindex midiBalance
+@funindex midiExpression
+@funindex midiReverbLevel
+@funindex midiChorusLevel
+
+Se pueden usar las siguientes propiedades de contexto para
+aplicar diversos efectos MIDI a las notas que se reproducen sobre
+el canal MIDI asociado con el pentagrama, instrumento MIDI o voz
+actual (dependiendo del valor de la propiedad de contexto
+@code{Score.midiChannelMapping} y del contexto en que está
+situado el @code{Staff_performer}; véase @ref{Asignación de
+canales MIDI}).
+
+Los cambios en estas propiedades de contexto afectan a todas las
+notas que se reproducen sobre el canal después del cambio, aunque
+algunos de los efectos se pueden incluso aplicar también a notas
+que están ya sonando en ese momento (dependiendo de la
+implementación del dispositivo de salida MIDI).
+
+Se contemplan las siguientes propiedades de contexto:
+
+@table @var
+
+@item @code{Staff.midiPanPosition}
+
+La posición de panorama controla cómo se distribuye el sonido de
+un canal MIDI entre las salidas estéreo izquierda y derecha. La
+propiedad de contexto acepta un número entre -1.0 (@code{#LEFT})
+y 1.0 (@code{#RIGHT}); el valor -1.0 pone toda la potencia de
+sonido en la salida estéreo izquierda (dejando la salida derecha
+en completo silencio), el valor 0.0 (@code{#CENTER}) distribuye
+el sonido por igual entre las salidas estéreo izquierda y
+derecha, y el valor 1.0 mueve todo el sonido a la salida estéreo
+derecha. Los valores entre -1.0 y 1.0 se pueden usar para
+obtener distribuciones mezcladas entre las salidas estéreo
+izquierda y derecha.
+
+@item @code{Staff.midiBalance}
+
+Equilibrio estéreo de un canal MIDI. De forma similar a la
+posición de panorama esta propiedad de contexto acepta un número
+entre -1.0 (@code{#LEFT}) y 1.0 (@code{#RIGHT}). Varía el
+volumen relativo que se envía a los dos altavoces estéreo sin
+afectar a la distribución de las propias señales estéreo.
+
+@item @code{Staff.midiExpression}
+
+Nivel de expresión (como una fracción del nivel máximo
+disponible) que se aplica a un canal MIDI. Un dispositivo MIDI
+combina el nivel de expresión del canal MIDI con el nivel actual
+de dinámica de una voz (controlado mediante las instrucciones de
+dinámica como @code{\p} o @code{\ff}) para obtener el volumen
+total de cada nota dentro de la voz. El control de expresión se
+puede usar, por ejemplo, para implementar efectos de crescendo y
+decrescendo sobre notas mantenidas (algo que LilyPond no
+contempla de forma automática).
+
+@c Issue 4059 contains an attached snippet which shows how this might
+@c be done, but this is too large and complex for the NR, even as a
+@c referenced snippet. It could be added to the LSR.
+
+El rango de los niveles de expresión se extiende desde 0.0
+(ninguna expresión, lo que significa un volumen nulo) hasta 1.0
+(expresión al máximo).
+
+@item @code{Staff.midiReverbLevel}
+
+El nivel de reverberación (cono una fracción del máximo nivel
+disponible) que se aplica a un canal MIDI. Esta propiedad acepta
+números entre 0.0 (sin reverberación) y 1.0 (efecto máximo).
+
+@item @code{Staff.midiChorusLevel}
+
+Nivel del efecto Chorus (como una fracción del máximo nivel
+disponible) que se aplica a un canal MIDI. Esta propiedad acepta
+números entre 0.0 (sin efecto de chorus) y 1.0 (efecto al
+máximo).
+
+@end table
-@c TODO Expand with examples, and any other issues
@knownissues
-Debido a que el estándar General MIDI no contiene golpes de aro
-(@emph{rim shots}), para este propósito se utiliza en su lugar el
-golpe lateral de baqueta (@emph{sidestick}).
+Dado que los archivos MIDI no contienen en realidad ninguna
+información sonora, los cambios en estas propiedades de contexto
+solamente se convierten en peticiones para que cambien los
+controles de canal MIDI dentro de los archivos MIDI emitidos. Si
+un dispositivo MIDI determinado (como un reproductor MIDI por
+software) puede de hecho manejar cualquiera de estas solicitudes
+de un archivo MIDI, es algo que depende totalmente de la
+implementación del mismo: un dispositivo podría optar por ignorar
+algunas o todas estas solicitudes. Asimismo, la forma en que un
+dispositivo MIDI interpreta los diferentes valores de estos
+controles (generalmente, el estándar MIDI determina el
+comportamiento solamente en los puntos extremos del rango de
+valores disponibles para cada control), y el hecho de si un
+cambio en el valor de un control afecta a las notas que ya se
+están reproduciendo sobre ese canal MIDI o no, también son
+aspectos específicos de la implementación del dispositivo MIDI.
+
+Al generar archivos MIDI, LilyPond sencillamente convierte de
+forma lineal los valores fraccionarios dentro de cada rango (7
+bits, o 14 bits para los controles de canal MIDI que admiten
+resolución fina) en valores enteros dentro del rango
+correspondiente (de 0 a 127 o de 0 a 32767, respectivamente),
+redondeando los valores fraccionarios hacia el entero más próximo
+en dirección opuesta al cero. Los valores enteros convertidos se
+almacenan tal cual en el archivo MIDI generado. Consulte la
+documentación de su dispositivo MIDI para ver información acerca
+de cómo interpreta estos valores.
+
+
+@node Enriquecimiento de la salida MIDI
+@subsection Enriquecimiento de la salida MIDI
+@translationof Enhancing MIDI output
+
+@menu
+* El script Articulate::
+@end menu
+
+La salida MIDI predeterminada es muy básica, pero se puede
+mejorar mediante la selección de los instrumentos MIDI las
+propiedades del bloque @code{\midi} y/o usando el script
+@file{articulate}.
+
+@cindex instrumentos, nombres
+@cindex MIDI, instrumentos
+@cindex articulate, script
+@cindex articulate.ly
+@funindex Staff.midiInstrument
+
@node El script Articulate
@subsection El script Articulate
@translationof The Articulate script
-Es posible obtener una salida MIDI más real si se utiliza el script
-Articulate. Éste trata de tener en cuenta las articulaciones
-(ligaduras de expresión, picados, etc), mediante la sustitución de las
-notas con secuencias musicales de silencios y notas escaladas en el
-tiempo de forma apropiada. También trata de desplegar los trinos,
-grupetos circulares, etc. y responder a las indicaciones de
-rallentando y accelerando.
-
-Para utilizar el script Articulate, tenemos que incluirlo al principio
-de nuestro archivo de entrada:
+Para utilizar el script Articulate, tenemos que incluirlo al
+principio de nuestro archivo de entrada:
@example
\include "articulate.ly"
@end example
-y en la sección @code{\score}, hacer lo siguiente:
+El script crea una salida MIDI en que las notas tienen una
+duración ajustada en el tiempo de forma que se correspondan con
+una serie de indicaciones de articulación y de tempo. Sin
+embargo, la salida tipografiada también se altera para reflejar
+literalmente el contenido de la salida MIDI.
@example
-\unfoldRepeats \articulate <<
- resto de la partitura...
->>
+\score @{
+ \articulate <<
+ @var{@dots{} music @dots{}}
+ >>
+ \midi @{ @}
+@}
@end example
-Después de alterar el código de entrada de esta manera el resultado
-visual se altera profundamente, pero el bloque @code{\midi} estándar
-produce un archivo MIDI mejorado.
+La instrucción @code{\articulate} habilita el procesado de las
+abreviaturas como trinos y mordentes de varias notas. En el
+propio script puede verse una lista completa de los elementos que
+están previstos. Véase @file{ly/articulate.ly}.
-Si bien no es esencial para que funcione el script Articulate, podemos
-insertar la instrucción @code{\unfoldRepeats} según aparece en el
-ejemplo anterior, dado que habilita la ejecución de abreviaturas tales
-como los @notation{trinos}.
+@seealso
+Manual de aprendizaje:
+@rlearning{Otras fuentes de información}.
-@knownissues
+Referencia de la notación:
+@ref{Score layout}.
+
+Archivos instalados:
+@file{ly/articulate.ly}.
+
+@warning{El script @file{articulate} puede acortar los acordes,
+lo que podría no ser adecuado para algunos tipos de instrumento,
+como el órgano. Las notas que no tienen ninguna articulación
+también se pueden acortar; así, para contener el alcance
+de este efecto limite
+el uso de de la función @code{\articulate} a segmentos de música
+más breves o modifique los valores de las variables definidas
+dentro del script @file{articulate}
+para compensar el efecto de acortamiento de las notas.}
-Articulate acorta los acordes, y ciertos fragmentos de música
-(especialmente la música de órgano) es posible que suene peor.
@node Extraer información musical
@section Extraer información musical
@translationof Extracting musical information
-Además de crear un resultado visual y MIDI,
-LilyPond es capaz de presentar información
-musical en forma de texto.
+Además de crear un resultado visual y MIDI, LilyPond es capaz de
+presentar información musical en forma de texto.
@menu
* Impresión del código de notación de LilyPond::
* Guardar los eventos musicales en un archivo::
@end menu
+
@node Impresión del código de notación de LilyPond
@subsection Displaying LilyPond notation
@translationof Displaying LilyPond notation
@funindex \displayLilyMusic
-La impresión textual de una expresión musical en notación de LilyPond
-puede hacerse con la función musical @code{\displayLilyMusic}.
-Para ver el resultado, lo más usual es llamar a LilyPond
-mediante la línea de órdenes. Por ejemplo,
+La impresión textual de una expresión musical en notación de
+LilyPond puede hacerse con la función musical
+@code{\displayLilyMusic}. Para ver el resultado, lo más usual es
+llamar a LilyPond mediante la línea de órdenes. Por ejemplo,
@example
@{
@{ a,4 cis e fis g @}
@end example
-De forma predeterminada, LilyPond imprime estos mensajes en la consola
-junto al resto de los mensajes de la compilación de LilyPond.
-Para discernir entre estos mensajes y
-guardar el resultado de @code{\display@{MATERIAL@}}, redireccione la
-salida hacia un archivo.
+De forma predeterminada, LilyPond imprime estos mensajes en la
+consola junto al resto de los mensajes de la compilación de
+LilyPond. Para discernir entre estos mensajes y guardar el
+resultado de @code{\displayLilyMusic}, redireccione la salida
+hacia un archivo.
@example
lilypond archivo.ly >resultado.txt
@end example
+@funindex \void
+Observe que LilyPond no se limita a mostrar la expresión musical,
+sino que también la interpreta (porque @code{\displayLilyMusic}
+la devuelve además de mostrarla). Simplemente inserte
+@code{\displayLilyMusic} dentro de
+la música existente con el objeto de obtener información sobre
+ella.
+
+Para interpretar y mostrar una sección de música en la consola,
+y al mismo tiempo suprimirla del archivo de salida,
+use la instrucción @code{\void}.
+
+@example
+@{
+ \void \displayLilyMusic \transpose c a, @{ c4 e g a bes @}
+ c1
+@}
+@end example
+
@node Impresión de las expresiones musicales de Scheme
@subsection Impresión de las expresiones musicales de Scheme
@subsection Guardar los eventos musicales en un archivo
@translationof Saving music events to a file
-Los eventos musicales se pueden guardar en un archivo pentagrama a
-pentagrama mediante la inclusión de un archivo en nuestra partitura
-principal.
+Los eventos musicales se pueden guardar en un archivo pentagrama
+a pentagrama mediante la inclusión de un archivo en nuestra
+partitura principal.
@example
\include "event-listener.ly"
@end example
De esta forma se crean uno o más archivos llamados
-@file{FILENAME-STAFFNAME.notes} ó @file{FILENAME-unnamed-staff.notes}
-para cada pentagrama. Observe que si tiene más de un pentagrama sin
-nombre, los eventos de todos los pentagramas se mezclarán entre sí
-dentro del mismo archivo. El resultado tiene el aspecto siguiente:
+@file{FILENAME-STAFFNAME.notes} ó
+@file{FILENAME-unnamed-staff.notes} para cada pentagrama.
+Observe que si tiene más de un pentagrama sin nombre, los eventos
+de todos los pentagramas se mezclarán entre sí dentro del mismo
+archivo. El resultado tiene el aspecto siguiente:
@example
0.000 note 57 4 p-c 2 12
@end example
La sintaxis consiste en una línea delimitada por caracteres de
-tabulación, con dos campos fijos en cada línea seguidos de parámetros
-opcionales.
+tabulación, con dos campos fijos en cada línea seguidos de
+parámetros opcionales.
@example
-@var{tiempo} @var{tipo} @var{...parámetros...}
+@var{tiempo} @var{tipo} @var{@dots{}parámetros@dots{}}
@end example
-Esta información se puede leer fácilmente por parte de otros programas
-como guiones de Python, y pueden ser muy útiles para aquellos
-investigadores que desean realizar un análisis musical o hacer
-experimientos de reproducción con LilyPond.
-
+Esta información se puede leer fácilmente por parte de otros
+programas como guiones de Python, y pueden ser muy útiles para
+aquellos investigadores que desean realizar un análisis musical o
+hacer experimentos de reproducción con LilyPond.
@knownissues
-
No todos los eventos musicales de lilypond están contemplados por
@file{event-listener.ly}. Se pretende que sea una @qq{prueba de
concepto} bien realizada. Si algunos eventos que quiere ver no
-aparecen incluidos, copie @file{event-listener.ly} en su carpeta de
-lilypond y modifique el archivo de forma que produzca la información
-que desea.
+aparecen incluidos, copie @file{event-listener.ly} en su carpeta
+de lilypond y modifique el archivo de forma que produzca la
+información que desea.
projects / lilypond.git / blobdiff