@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
@ignore
- Translation of GIT committish: 80340bdefc128536c79733d8c6f3467d91b01f72
+ Translation of GIT committish: 18f6f13f39b25f28679fe2073763151008ca3366
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.2"
@node Entrada y salida generales
@chapter Entrada y salida generales
@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::
@example
\score @{
-...
+ @dots{}
@}
@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
+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}.
@example
\score @{
- @var{..música..}
+ @var{@dots{}música@dots{}}
@}
@end example
@example
\markup @{
- @var{..texto..}
+ @var{@dots{}texto@dots{}}
@}
@end example
@example
\score @{
- @var{..}
+ @var{@dots{}}
@}
\markup @{
- @var{..}
+ @var{@dots{}}
@}
\score @{
- @var{..}
+ @var{@dots{}}
@}
@end example
\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{}
@example
\book @{
\score @{ @dots{} @}
- \layout @{ @dots{} @}
+ \paper @{ @dots{} @}
@}
\book @{
\score @{ @dots{} @}
- \layout @{ @dots{} @}
+ \paper @{ @dots{} @}
@}
\book @{
\score @{ @dots{} @}
- \layout @{ @dots{} @}
+ \paper @{ @dots{} @}
@}
@end example
\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
\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
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.
+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
@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.
+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
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
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
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::
* 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
-@c TODO: figure out how \bookpart titles work
+Los valores de los campos se fitran 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í:
-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}.
+@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}.
+
+@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.
+
+@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 restulantes 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
+@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 lobro 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 {
title = "SUITE I."
}
@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 {
@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
-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}.
+@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
-@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 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 úitlma 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
-@c Is the bit about \null markups true? -mp
+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.
+@end itemize
+
+Para cambiar la disposición predeterminada, véase
+@ref{Personalización de los títulos}.
+
@cindex breakbefore
+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}.
+
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.
-@lilypond[papersize=a8landscape,verbatim,noragged-right]
+@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:
@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.
@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
{ 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
+
+@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, use una o las dos variables de
+la colocación de los campos de texto, cambie una o las dos variables de
@code{\paper} siguientes:
@itemize
@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:
@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
-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
+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 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}.
+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
@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
@item @code{evenFooterMarkup} (marcado de pie de página par)
@end itemize
+@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
+@code{variable} = @code{\markup} @{
+ @dots{}
+ @code{\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
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
+ @code{\on-the-fly \first-page}
+ @code{\on-the-fly \last-page}
+ @code{@{ \markup @dots{} \fromproperty #'header: @dots{} @}}
+@end example
+
+determina si la salida es una sola página.
+
@seealso
Referencia de la notación:
-@ref{Explicación de los bloques de títulos},
-@ref{Presentación predeterminada de los bloques de título del libro y la partitura}.
+@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 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 Notas al pie dentro de expresiones musicales
+@unnumberedsubsubsec Notas al pie dentro de expresiones musicales
+@translationof Footnotes in music expressions
-@node Panorámica de las notas al pie
-@unnumberedsubsubsec Panorámica de las notas al pie
-@translationof Footnotes overview
+@cindex notas al pie dentro de expresiones musicales
+@funindex \footnote
-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.
+@subsubsubheading Panorámica de las notas al pie
-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.
+Las notas al pie dentro de expresiones musicales caen dentro de dos
+categorías:
+@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 marccado 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 acrode @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 c'' {
+ a4_\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 usat 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) "An A" 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{antes} 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íne 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 pue 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 }
+ \markup {
+ "A simple"
+ \auto-footnote "tune" \italic " By me"
+ "is shown below. It is a"
+ \auto-footnote "recent" \italic " Aug 2012"
+ "composition."
+ }
\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
+ 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
+
+@example
+\markup @{ @dots{} \footnote @var{marca} @var{nota} @dots{} @}
+@end example
+
+Los elementos son:
+
+@table @var
-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:
+@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 }
+ \markup {
+ "A simple tune"
+ \footnote "*" \italic "* By me"
+ "is shown below. It is a recent"
+ \footnote \super † \concat {
+ \super † \italic " Aug 2012"
+ }
+ "composition."
+ }
\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 }
+ 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" }
+ \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 c' {
- a'4 b8 e c4 d4
+ 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{List of special characters},
@ref{Indicaciones de texto},
@ref{Guiones de texto},
-@ref{Títulos y cabeceras}.
+@ref{Unicode}.
Referencia de funcionamiento interno:
@rinternals{FootnoteEvent},
@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}.
+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
en la que se sitúa el punto señalizado, usando la instrucción de
marcado @code{\page-ref}.
-@lilypond[verbatim]
+@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
(add-toc-item! 'tocActMarkup text))
@end verbatim
-@lilypond[line-width=11.0\cm]
+@lilypond[line-width=10.0\cm]
\header { tagline = ##f }
\paper {
tocActMarkup = \markup \large \column {
Se pueden añadir puntos de relleno entre un elemento y su número de página:
-@lilypond[verbatim,quote]
+@lilypond[verbatim,line-width=10.0\cm]
\header { tagline = ##f }
\paper {
tocItemMarkup = \tocItemWithDotsMarkup
@example
\include "partes/VI.ly"
\include "partes/VII.ly"
-... etc.
+@dots{} etc.
@end example
Los archivos de inclusión también pueden contener enunciados
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.
+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
@example
\include "VI.ly"
\include "VII.ly"
-... etc.
+@dots{} etc.
@end example
Los archivos que se incluyen en muchas partituras se pueden poner en
@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}
@end example
Se pueden poner varias etiquetas sobre expresiones con varias entradas
-de @code{\tag}:
+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.
-
-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:
+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. Por lo general,
+querrá usar una sola instrucción @code{\keepWithTag} con una lista
+de varias etiquetas: de esta forma solamente se suprimirán las
+secciones etiquetadas que no aparezcan en @emph{ninguna} de las
+etiquetas.
+
+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 secuenciaes y simultáneas son
+dos apuestas seguras:
@lilypond[verbatim,quote]
test = { \tag #'here { \tag #'here <<c''>> } }
@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
-Multiple rests are not merged if you create a score with more
-than one tagged section at the same place.
+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.
-@end ignore
@node Uso de ajustes globales
@unnumberedsubsubsec Uso de ajustes globales
@node Unicode
@unnumberedsubsubsec Unicode
+@translationof Unicode
@cindex Unicode
}
\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
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
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}.
+@rprogram{Opciones básicas de la línea de órdenes para LilyPond}.
@node Sustituir la tipografía de la notación
@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:
-@sourceimage{Gonville_before,,,}
+@sourceimage{Gonville_before,15cm,,}
@subsubheading Instrucciones de instalación para MacOS
@menu
* Crear archivos MIDI::
-* El bloque MIDI::
+* Instrumentos MIDI::
* ¿Qué sale por el MIDI?::
* Repeticiones y MIDI::
* Control de los matices en el MIDI::
* El script Articulate::
@end menu
-
@node Crear archivos MIDI
@subsection Crear archivos MIDI
@translationof Creating MIDI files
-Para crear un MIDI a partir de una pieza de música, escriba un bloque
-@code{\midi} en la partitura, por ejemplo:
+@cindex MIDI, bloque
+Para crear un MIDI a partir de un archivo de LilyPond, inserte un
+bloque @code{\midi} dentro de un bloque @code{\score};
@example
\score @{
- @var{...música...}
+ @var{@dots{}música@dots{}}
+ \layout @{ @}
\midi @{ @}
@}
@end example
-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}:
+Si hay @emph{solamente} un bloque @code{\midi} dentro de un
+@code{\score} (es decir, sin ningún bloque @code{\layout}),
+entonces @emph{solamente} se producirá MIDI. No se produce
+ninguna salida impresa de notación musical.
@example
\score @{
- @var{...música...}
+ @var{@dots{}música@dots{}}
\midi @{ @}
- \layout @{ @}
@}
@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}.
-
-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}.
-
-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}:
-
-@example
-#(ly:set-option 'midi-extension "midi")
-@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
+@q{marcas} dinámicas se traducen a niveles de volumen con una
+@q{fracción fija} del rango de volumen MIDI disponible; Los
+crescendi y decrescendi hacen que el volumen varíe linealmente
+entre sus dos extremos.
-La línea anterior establece la extensión predeterminada para los
-archivos MIDI a @code{.midi}.
+Se reflejan en la salida de MIDI todas las indicaciones de
+@code{\tempo}, incluidos todos los cambios de tempo siguientes,
+especificados dentro de la notación musical.
-De forma alternativa, esta opción se puede también proporcionar en la
-línea de órdenes:
+Por lo general basta con dejar vacío el bloque @code{\midi}, pero
+puede contener disposiciones distintas de los contextos,
+definiciones de contexto nuevas o código que establezca valores
+para propiedades. En el ejemplo que aparece a continuación se
+fija el tempo a 72 negras por minuto, pero @emph{solamente} para
+la reproducción de audio a través de MIDI.
@example
-lilypond … -dmidi-extension=midi archivoLily.ly
+\score @{
+ @var{@dots{}music@dots{}}
+ \midi @{
+ \tempo 4 = 72
+ @}
+@}
@end example
+Observe que @code{\tempo} es en realidad una instrucción para
+establecer valores para propiedades durante la interpretación de
+la música, y en el contexto de las definiciones de salida, como un
+bloque @code{\midi}, se reinterpreta como si fuese una
+modificación de contexto.
-@unnumberedsubsubsec Nombres de instrumentos
-
-@cindex instrumento, nombres de
-@funindex Staff.midiInstrument
-
-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}.
+@cindex MIDI, definiciones de contexto
-@example
-\new Staff @{
- \set Staff.midiInstrument = #"glockenspiel"
- @var{...notes...}
-@}
-@end example
+Las definiciones de contexto siguen la misma sintaxis que las de
+un bloque @code{\layout};
@example
-\new Staff \with @{midiInstrument = #"cello"@} @{
- @var{...notes...}
+\score @{
+ @var{@dots{}música@dots{}}
+ \midi @{
+ \context @{
+ \Voice
+ \remove "Dynamic_performer"
+ @}
+ @}
@}
@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"}).
+elimina de la salida MIDI el efecto de los matices dinámicos. Los
+módulos de traducción para el sonido se llaman @q{performers}
+(intérpretes).
@snippets
@knownissues
-@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,
+Algunos sistemas operativos requieren una extensión de archivo
+@emph{específica} para los archivos MIDI. Si se prefiere una
+extensión distinta, inserte la línea siguiente en el nivel
+superior del archivo de entrada, antes del comienzo de cualquier
+bloque @code{\book}, @code{\bookpart} o @code{\score};
@example
-@{ a4\< b c d\f @}
+#(ly:set-option 'midi-extension "mid")
@end example
-@noindent
-will not work properly but
+De esta manera quedará establecida la extensión predeterminada
+para los archivos MIDI a @code{.mid}.
+
+De forma alternativa, se puede proporcionar una opción en la línea
+de órdenes de la consola:
@example
-@{ a4\< b c d\!\f @}
+lilypond -dmidi-extension=mid MiArchivo.ly
@end example
-@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.
-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}.
-
+Puede que algunos propgramas reproductores de MIDI no siempre
+manejen correctamente los cambios de tempo en la salida MIDI.
-@node El bloque MIDI
-@subsection El bloque MIDI
-@translationof MIDI block
-
-@cindex bloque MIDI
+@seealso
+Archivos instalados:
+@file{../ly/performer-init.ly}.
-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:
+Manual de aprendizaje:
+@rlearning{Otras fuentes de información}.
-@example
-\score @{
- @var{...música...}
- \midi @{
- \tempo 4 = 72
- @}
-@}
-@end example
-En este ejemplo, el tempo se establece a 72 pulsos de negra por
-minuto. @code{\tempo} is actually a music command for
-setting properties during the interpretation of music: in the
-context of output definitions like a @code{\midi} block, as a matter of
-courtesy those are reinterpreted as if they were context modifications.
+@node Instrumentos MIDI
+@subsection Instrumentos MIDI
+@translationof MIDI Instruments
-@cindex MIDI, definiciones de contexto
+@cindex instrumento, nombres de
+@funindex Staff.midiInstrument
-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@{ @}}.
+El instrumento MIDI que se quiere utilizar se establece fijando la
+propiedad @code{Staff.midiInstrument} al nombre del instrumento.
+El nombre se debe elegir de entre los que están en la lista que
+aparece en @ref{instrumentos MIDI}.
@example
-\midi @{
- ...
- \context @{
- \Voice
- \remove "Dynamic_performer"
- @}
+\new Staff @{
+ \set Staff.midiInstrument = #"glockenspiel"
+ @var{@dots{}notas@dots{}}
@}
@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}.
-
@example
-\score @{
- @{ @dots{}notas@dots{} @}
- \midi @{ @}
+\new Staff \with @{midiInstrument = #"cello"@} @{
+ @var{@dots{}notas@dots{}}
@}
@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"}).
+
@node ¿Qué sale por el MIDI?
@subsection ¿Qué sale por el MIDI?
@translationof What goes into the MIDI output?
+@menu
+* Contemplado en el MIDI::
+* No contemplado en el MIDI::
+@end menu
+
+@node Contemplado en el MIDI
@unnumberedsubsubsec Contemplado en el MIDI
+@translationof Supported in MIDI
@cindex alturas en MIDI
@cindex MIDI, alturas
@end itemize
+@node No contemplado en el MIDI
@unnumberedsubsubsec No contemplado en el MIDI
+@translationof Unsupported in MIDI
@c TODO index as above
@example
\score @{
- @var{..música..}
- \layout @{ .. @}
+ @var{@dots{}música@dots{}}
+ \layout @{ @dots{} @}
@}
\score @{
- \unfoldRepeats @var{..música..}
- \midi @{ .. @}
+ \unfoldRepeats @var{@dots{}música@dots{}}
+ \midi @{ @dots{} @}
@}
@end example
volumen relativo de los matices dinámicos y el volumen relativo de los
distintos instrumentos.
-@unnumberedsubsubsec Indicaciones dinámicas
+@menu
+* Indicaciones dinámicas::
+* Volumen maestro MIDI::
+* Balance entre instrumentos (i)::
+* Balance entre instrumentos (ii)::
+@end menu
-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
+@node Indicaciones dinámicas
+@unnumberedsubsubsec Indicaciones dinámicas
+@translationof Dynamic marks
+
+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.
+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.
@lilypond[verbatim,quote]
#(define (myDynamics dynamic)
@file{../scm/midi.scm} y la tabla asociada como modelo. El último
ejemplo de esta sección muestra cómo se puede hacer esto.
+@node Volumen maestro MIDI
@unnumberedsubsubsec Volumen maestro MIDI
+@translationof Overall MIDI volume
-El volumen general máximo y mínimo de las indicaciones dinámicas de
-MIDI se controla estableciendo valores para las propiedades
+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:
+@code{Score}. Estas propiedades tienen efecto solamente al inicio
+de una voz y sobre las indicaciones dinámicas. La fracción que
+corresponde a cada indicación dinámica se modifica con esta
+fórmula:
@example
midiMinimumVolume + (midiMaximumVolume - midiMinimumVolume) * fracción
@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.
+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 {
\set Staff.midiInstrument = #"flute"
\new Voice \relative c''' {
r2 g\mp g fis~
- fis4 g8 fis e2~
- e4 d8 cis d2
+ 4 g8 fis e2~
+ 4 d8 cis d2
}
}
\new Staff {
}
@end lilypond
+@node Balance entre instrumentos (i)
@unnumberedsubsubsec Balance entre instrumentos (i)
+@translationof Equalizing different instruments (i)
-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 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.
-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.
+En este ejemplo se reduce el volumen del clarinete con relación al
+de la flauta.
@lilypond[verbatim,quote]
\score {
\set Staff.midiMaximumVolume = #0.9
\new Voice \relative c''' {
r2 g\mp g fis~
- fis4 g8 fis e2~
- e4 d8 cis d2
+ 4 g8 fis e2~
+ 4 d8 cis d2
}
}
\new Staff {
}
@end lilypond
+
+@node Balance entre instrumentos (ii)
@unnumberedsubsubsec Balance entre instrumentos (ii)
+@translationof Equalizing different instruments (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
+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,
+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.
+El ejemplo siguiente establece los volúmenes relativos de la
+flauta y del clarinete a los mismos valores que el ejemplo
+anterior.
@lilypond[verbatim,quote]
#(define my-instrument-equalizer-alist '())
\set Staff.midiInstrument = #"flute"
\new Voice \relative c''' {
r2 g\mp g fis~
- fis4 g8 fis e2~
- e4 d8 cis d2
+ 4 g8 fis e2~
+ 4 d8 cis d2
}
}
\new Staff {
@subsection Percusión en MIDI
@translationof Percussion in MIDI
-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.
+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.
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.
+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.
+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.
@c TODO Expand with examples, and any other issues
@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.
+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"
@example
\unfoldRepeats \articulate <<
- resto de la partitura...
+ resto de la partitura@dots{}
>>
@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.
+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.
-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}.
+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}.
@knownissues
@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::
@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
@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.
+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 experimientos 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