]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/es/notation/input.itely
Rerun scripts/auxiliar/update-with-convert-ly.sh
[lilypond.git] / Documentation / es / notation / input.itely
index 6c735634e68e1c09942372af03d7e3c0a38f5d5b..519172dae8863feec419925e5fb75ec24e001d96 100644 (file)
@@ -1,14 +1,14 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
 
 @ignore
-    Translation of GIT committish: 14c4ea2e2fb9cf26c79f5003d8f56c3696573552
+    Translation of GIT committish: ba92a1755026936bebe14a6c8ff6d2cfc704eeb1
 
     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.17"
+@c \version "2.17.6"
 
 @node Entrada y salida generales
 @chapter Entrada y salida generales
@@ -19,7 +19,7 @@ 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::
@@ -203,7 +203,6 @@ principio del archivo.
 @}
 @end example
 
-
 @funindex \bookpart
 
 Se pueden agrupar distintas piezas de música en partes de un libro
@@ -230,6 +229,7 @@ como el libro propiamente dicho, mediante la especificación del bloque
 @}
 @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
@@ -279,6 +279,7 @@ en el archivo fuente @file{eightminiatures.ly}, produce
 @file{eightminiatures-2.pdf}.
 @end itemize
 
+
 @node Nombres de los archivos de salida
 @subsection Nombres de los archivos de salida
 @translationof Output file names
@@ -350,6 +351,7 @@ El código anterior produce los siguientes archivos de salida:
 @file{Nocturne.pdf}.
 @end itemize
 
+
 @node Estructura del archivo
 @subsection Estructura del archivo
 @translationof File structure
@@ -371,8 +373,11 @@ las siguientes posibilidades:
 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}.
 
 @item
 Una expresión directa de Scheme, como
@@ -381,8 +386,10 @@ 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
@@ -520,7 +527,7 @@ de Scheme, es decir, todo elemento que comience por un signo@tie{}@code{#}.
 @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
+@code{\override Score.LyricText.font-size = #5} y antes y después
 de la instrucción completa.
 
 @end itemize
@@ -529,53 +536,135 @@ de la instrucción completa.
 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}.
 
-@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 dos tipos de zonas
+para títulos: @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 parte
+de libro como 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.
 
-@c TODO: figure out how \bookpart titles work
+@item
+Después de la expresión musical de un bloque @code{\score}.
 
-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}.
+@end itemize
+
+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í:
 
-Si el libro tiene una única partitura, el bloque @code{\header} se
-puede situar dentro o fuera del bloque @code{\score}.
+@itemize
+
+@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}.
+
+@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."
@@ -608,9 +697,10 @@ del bloque @bs{}@code{header}.}
 }
 @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 {
@@ -655,57 +745,92 @@ suprimirse manualmente:
 @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=a7,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
 
 Utilice la variable @code{breakbefore} dentro de un bloque
@@ -714,17 +839,18 @@ 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=a8landscape,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
     }
   }
@@ -736,11 +862,13 @@ Manual de aprendizaje:
 @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
@@ -813,23 +941,23 @@ Para eliminar la línea @code{tagline}, establezca su valor 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
@@ -850,14 +978,19 @@ Referencia de la notación:
 @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
@@ -865,8 +998,10 @@ la colocación de los campos de texto, use una o las dos variables de
 @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:
@@ -922,14 +1057,15 @@ en negrita.
 }
 @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
@@ -1003,7 +1139,7 @@ y referirnos a ellos en la definición del elemento de marcado.
 
 @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
@@ -1026,6 +1162,51 @@ texto, use una o más de las siguientes variables de @code{\paper}:
 @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} @{
+  ...
+  @code{\on-the-fly}  #@var{procedimiento}  @var{marcado}
+  ...
+@}
+@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
@@ -1055,249 +1236,392 @@ definiéndola como @code{\oddFooterMarkup}:
 }
 @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 ... \fromproperty #'header: ... @}}
+@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 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
 
-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.
+@cindex notas al pie dentro de expresiones musicales
+@funindex \footnote
 
-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.
+@subsubsubheading Panorámica de las notas al pie
 
-@node Notas al pie automáticas
-@unnumberedsubsubsec Notas al pie automáticas
-@translationof Automatic footnotes
+Las notas al pie dentro de expresiones musicales caen dentro de dos
+categorías:
 
-De las dos instrucciones utilizadas para crear notas al pie
-automáticas, utilice @code{\autoFootnoteGrob} para los grobs
-individuales (es decir: la cabeza de las notas, plicas, ligaduras de
-expresión, matices dinámicos y elementos de @code{\markup} si se
-utilizan @code{TextScripts}); y @code{\autoFootnote} para anotar las
-notas de un acorde.
+@table @emph
+@item Notas al pie basadas en eventos
+Se adjuntan a un evento en particular.  Son ejemplos de tales eventos
+las notas sueltas, notas dentro de un acorde, articulaciones (como
+barras, ligaduras de expresión, indicaciones de digitación, acentos,
+indicaciones dinámicas) y letra de las canciones.
 
-Las dos instrucciones aceptan tres argumentos; el @var{Objeto de
-presentación} que anotar, la posición @var{(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{\autoFootnoteGrob} debe ir @emph{antes} del grob
-al que se adjunta la nota al pie:
+@end table
 
-@lilypond[verbatim,quote,ragged-right,papersize=a8]
+La forma completa de una instrucción de nota al pie tanto para las
+notas al pie basadas en eventos como para las basadas en tiempo, es:
+
+@example
+[@var{dirección}] \footnote [@var{marca}] @var{desplazamiento} [@var{nombre-del-grob}] @var{texto-de-la-nota} @var{música}
+@end example
+
+Los elementos 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 nombre-del-grob
+especifica un tipo de grob que marcar (como @samp{#'Flag} para el
+corchete).  Si se da, se usa como punto de referencia un grob de ese
+tipo asociado con la @var{música} referenciada.  Se puede omitir (o
+sustituirse con @code{\default}) si se desea que la marca de nota al
+pie se adjunte al grob directamente creado dentro de @var{música}.
+
+@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 o componente de un acorde o post-evento que se
+está anotando.  Aunque no se puede omitir, se puede sustituir por
+@code{\default} en cuyo caso la nota al pie no se adjunta a ninguna
+expresión en particular, sino más bien a un momento de tiempo.  Es
+obligatorio en este caso utilizar el argumento @var{nombre-del-grob}
+para seleccionar un tipo de grob afectado, como por ejemplo
+@samp{#'TimeSignature}.
+
+@end table
+
+@subsubsubheading Notas al pie basadas en eventos
+
+@cindex Notas al pie, basadas en eventos
+
+La forma más simple de una nota al pie basada en eventos es
+sencillamente
+
+@example
+\footnote @var{desplazamiento} @var{texto-de-la-nota} @var{música}
+@end example
+
+Este tipo de nota al pie se adjunta a un objeto de presentación
+causado directamente por el evento que corresponde a @var{música}.
+
+@lilypond[quote,verbatim,papersize=a8landscape]
 \book {
   \header { tagline = ##f }
-  \relative c' {
-    \autoFootnoteGrob #'NoteHead #'(0.5 . -2)
-      \markup { The first note }
-    a'4 b8
-    \autoFootnoteGrob #'NoteHead #'(0.5 . 1)
-      \markup { The third note }
-    e c4 d4
+  \relative c'' {
+    \footnote #'(-1 . 3) "A note" a4
+    a4
+    \footnote #'(2 . 2) "A rest" r4
+    a4
   }
 }
 @end lilypond
 
-Para anotar las notas de un acorde, la instrucción
-@code{\autoFootnote} debe ir @emph{después} de la nota a la que se
-quiere adjuntar la nota al pie como un @code{TextScript}:
+Si se desea que la nota al pie se adjunte a un post-evento o
+articulación, la instrucción @code{\footnote} 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.
 
-@lilypond[verbatim,quote,ragged-right,papersize=a8]
+@lilypond[quote,verbatim,papersize=a8landscape]
 \book {
   \header { tagline = ##f }
-  \relative c' {
-    <
-    c-\autoFootnote #'(1 . -1.25) "Here is a C"
-    es-\autoFootnote #'(2 . -0.25) \markup { \italic "An E-flat" }
-    g-\autoFootnote #'(2 . 3) \markup { \bold "This is a G" }
-    >1
+  \relative c'' {
+    a4_\footnote #'(0 . -1) "A slur forced down" (
+    b8^\footnote #'(1 . 0.5) "A manual beam forced up" [
+    b8 ]
+    c4 )
+    c-\footnote #'(1 . 1) "Tenuto" --
   }
 }
 @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.}
-
-He aquí unos ejemplos de grobs con notas al pie automáticas, que
-muestran también la posición relativa de las notas respecto de la
-línea informativa y la línea de copyright.
+Se pueden usar marcas personalizadas como altenativas a las marcas
+numéricas, y la línea de anotación que une el objeto marcado con la
+marca puede suprimirse:
 
-@lilypond[verbatim,quote,ragged-right,papersize=a8]
+@lilypond[quote,verbatim,papersize=a8landscape]
 \book {
-  \header { copyright = \markup { "Copyright 1970" } }
+  \header { tagline = ##f }
   \relative c' {
-    \autoFootnoteGrob #'DynamicText #'(-3 . 0)
-      \markup { \bold Forte }
-
-    \autoFootnoteGrob #'Slur #'(0 . 1.5)
-      \markup { A slur }
-    a'4\f(
+    \footnote "*" #'(0.5 . -2) \markup { \italic "* The first note" }
+    a'4 b8
+    \footnote \markup { \super "$" } #'(0.5 . 1)
+      \markup { \super "$" \italic " The second note" }
+    e c4
+    \once \override Score.FootnoteItem.annotation-line = ##f
+    b-\footnote \markup \tiny "+" #'(0.1 . 0.1)
+      \markup { \super "+" \italic " Editorial" } \p
+  }
+}
+@end lilypond
 
-    \autoFootnoteGrob #'Beam #'(0 . -2)
-      \markup { Beam }
-    b8)[ e]
+Se pueden ver más ejemplos de marcas personalizadas en
+@ref{Notas al pie en texto independiente}.
 
-    \autoFootnoteGrob #'Stem #'(1 . -1)
-      \markup  { \teeny { This is a stem } }
-    c4
+No es posible hacer un acorde completo de esta forma porque un acorde
+no produce un evento distinto al de las notas que lo componen, pero
+las propias notas que lo componen sí se pueden marcar.
 
-    \autoFootnoteGrob #'AccidentalCautionary #'(0 . 0.5)
-      \markup \italic { A cautionary accidental }
+Si el objeto de presentación que se está anotando está causado
+@emph{indirectly} por un evento (como una alteración accidental o una
+plica causados por una cabeza de nota), se requiere un argumento
+adicional de símbolo, el @var{nombre-del-grob}, antes del texto de la
+nota al pie:
 
-    \autoFootnoteGrob #'TextScript #'(0.5 . -0.5)
-      \markup \italic { Slow Down }
-    dis?4_"rit."
+@lilypond[quote,verbatim,papersize=a8landscape]
+\book {
+  \header { tagline = ##f }
+  \relative c'' {
+    % footnotes may be added to chord constituents
+    < \single\footnote #'(-1 . -3) "Another flat" Accidental aes
+      c
+      \single\footnote #'(-1 . 0.5) "A flat" Accidental ees
+    >2
+    \single\footnote #'(-1 . 2) "A stem" Stem ees2
   }
 }
 @end lilypond
 
-Para los elementos @code{\markup} del nivel superior, se requiere el
-uso de la instrucción @code{\auto-footnote}:
-
-@lilypond[verbatim,quote,ragged-right,papersize=a8]
+@warning {Cuando las notas al pie se adjuntan a varios elementos musicales que
+están dentro del mismo momento musical, 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.}
+
+@subsubsubheading Notas al pie basadas en tiempo
+
+@cindex Notas al pie, basadas en tiempo
+
+Los objetos de presentación como las claves y las armaduras de
+tonalidad están producidas mayormente como consecuencia de propiedades
+cambiadas, más que como verdaderos eventos.  Otros, como las líneas
+divisorias y los números de compás, son una consecuencia directa de la
+cuenta de tiempo.  Por este motivo, las notas al pie basadas en estos
+objetos tienen que estar basadas en su cuenta de tiempo musical.  Las
+notas al pie basadas en tiempo son preferibles también cuando se están
+creando funcionalidades como plicas y barras dentro de @emph{acordes}:
+mientras que tales funcionalidades por cada acorde se asignan
+normalmente a @emph{un} evento dentro del acorde, confiar en una
+elección en particular sería imprudente.
+
+Una nota al pie basada en tiempo se escribe de la misma manera que con
+una nota al pie basada en evento, excepto que se usa @code{\default}
+en lugar de la música que indica un evento.  El objeto de presentación
+en cuestión debería siempre especificarse explícitamente para las
+notas al pie basadas en tiempo para evitar acabar teniendo marcas en
+los objetos más inesperados.
+
+@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
+  \relative c'' {
+    r1 |
+    \footnote #'(-0.5 . -1) "Meter change" Staff.TimeSignature
+    \time 3/4
+    \footnote #'(1 . -1) "Chord stem" Stem
+    <c e g>4 q q
+    \footnote #'(-0.5 . 1) "Bar line" Staff.BarLine
+    q q
+    \footnote #'(0.5 . -1) "Key change" Staff.KeySignature
+    \key c\minor
+    q
   }
 }
 @end lilypond
 
 
-@node Notas al pie manuales
-@unnumberedsubsubsec Notas al pie manuales
-@translationof Manual footnotes
+@node Notas al pie en texto independiente
+@unnumberedsubsubsec Notas al pie en texto independiente
+@translationof Footnotes in stand-alone text
 
-@funindex \footnote
-@funindex \footnoteGrob
-@cindex notas al pie manuales
+@cindex notas al pie en texto independiente
 
-Existen dos instrucciones para crear notas al pie manuales;
-@code{\footnote} para elementos de @code{\markup} del nivel superior y
-notas de acordes; y @code{\footnoteGrob} para grobs individuales (y
-elementos de @code{\markup} cuando se usan @code{TextScripts}).
+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.
 
-Si se están anotando grobs, la instrucción @code{\footnote} toma
-cuatro argumentos; el @var{objeto de presentación} que se va a anotar,
-la posición @var{(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.
+Las notas al pie para texto independiente con marcas automáticas y
+personalizadas se crean de distintas formas.
 
-La instrucción @code{\footnoteGrob} debe ir @emph{después} del grob
-que la nota al pie está anotando y adjuntada como un
-@code{TextScript}:
+@subsubsubheading Notas al pie en texto independiente con marcas automáticas
 
-@lilypond[verbatim,quote,ragged-right,papersize=a8]
-\book {
-  \header { tagline = ##f }
-  \relative c' {
-    a'4-\footnoteGrob #'NoteHead #'(0.5 . -2)
-          "1" \markup { \italic "1. The first note" }
-    b8
-    e-\footnoteGrob #'NoteHead #'(0.5 . 1)
-          \markup { \bold "2" } "2. The second note"
-    c4
-    d\p-\footnoteGrob #'DynamicText #'(0.5 . -1) "3" "3. Piano"
-  }
-}
-@end lilypond
+La sintaxis de una nota al pue sobre texto independiente con marcas
+automáticas es
+
+@example
+\markup @{ ... \auto-footnote @var{texto} @var{nota} ... @}
+@end example
+
+Los elementos son:
+
+@table @var
 
-Para anotar notas de acordes, la instrucción @code{\footnote} debe ir
-@emph{después} de la nota que se está anotando con una nota al pie, y
-adjuntarse como un @code{TextScript}:
+@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.25) "1" "1. C"
-    es-\footnote #'(2 . -0.25)
-       \markup { \bold "b" } "b. E-flat"
-    g-\footnote #'(2 . 3) "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
 
-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:
+La sintaxis de una nota al pie sobre texto independiente con marcas
+personalizadas es
+
+@example
+\markup @{ ... \footnote @var{marca} @var{nota} ... @}
+@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 }
+  \markup {
+    "A simple tune"
+    \footnote "*" \italic "* By me"
+    "is shown below.  It is a recent"
+    \footnote \super &dagger; \concat {
+      \super &dagger; \italic " Aug 2012"
+    }
+    "composition."
+  }
   \relative c' {
-    \footnoteGrob #'DynamicText #'(-3 . 0)
-      \markup { \teeny 1 }
-      \markup { 1. \bold Forte }
-
-    \footnoteGrob #'Slur #'(0 . 1.5)
-      \markup { \teeny b }
-      \markup { b. A slur }
-    a'4\f(
-
-    \footnoteGrob #'Beam #'(0 . -2)
-      \markup { \teeny 3 }
-      \markup { 3. Beam }
-    b8)[ e]
-
-    \footnoteGrob #'Stem #'(1 . -1)
-      \markup { 4 }
-      \markup  { \bold 4. { This is a stem } }
-    c4
-
-    \footnoteGrob #'AccidentalCautionary #'(0 . 0.5)
-      \markup \concat \teeny { "sharp (v)" }
-      \markup \italic { v. A cautionary accidental }
-
-    \footnoteGrob #'TextScript #'(0.5 . -0.5)
-      \markup \concat \teeny { "a" }
-      \markup \italic { a. Slow Down }
-    dis?4_"rit."
-
-    \breathe
-    \footnoteGrob #'BreathingSign #'(1.5 . -0.25)
-      \markup { \teeny \musicglyph #"rests.4" }
-      \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
@@ -1307,11 +1631,12 @@ Manual de aprendizaje:
 @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},
@@ -1321,13 +1646,12 @@ Referencia de funcionamiento interno:
 
 @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) o a barras de corchea automáticas y 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
@@ -1341,7 +1665,7 @@ 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]
+@lilypond[verbatim,papersize=a8landscape]
 \header { tagline = ##f }
 \book {
   \label #'firstScore
@@ -1374,7 +1698,6 @@ 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
 @code{\label},
@@ -1464,7 +1787,7 @@ tocAct =
    (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 {
@@ -1492,7 +1815,7 @@ tocAct =
 
 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
@@ -1506,11 +1829,9 @@ Se pueden añadir puntos de relleno entre un elemento y su número de página:
 }
 @end lilypond
 
-
 @seealso
 Archivos de inicio:
-@file{../ly/toc-init.ly}.
-
+@file{ly/toc-init.ly}.
 
 @predefined
 @funindex \table-of-contents
@@ -1587,14 +1908,57 @@ 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
+  ...
+@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"
+...
+% 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
@@ -1638,7 +2002,6 @@ 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:
 @rlearning{Otras fuentes de información},
@@ -1666,7 +2029,6 @@ 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::
 * Uso de etiquetas::
@@ -1910,15 +2272,12 @@ Referencia de la notación:
 @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.
 
@@ -1953,6 +2312,7 @@ Manual de aprendizaje:
 Referencia de la notación:
 @ref{Inclusión de archivos de LilyPond}.
 
+
 @node Caracteres especiales
 @subsection Caracteres especiales
 @translationof Special characters
@@ -2041,6 +2401,7 @@ portuguese = \lyricmode {
 
 @node Unicode
 @unnumberedsubsubsec Unicode
+@translationof Unicode
 
 @cindex Unicode
 
@@ -2059,7 +2420,6 @@ 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}.
@@ -2151,7 +2511,6 @@ Archivos instalados:
 @file{ly/text-replacements.ly}.
 
 
-
 @node Controlar la salida
 @section Controlar la salida
 @translationof Controlling output
@@ -2163,6 +2522,7 @@ Archivos instalados:
 * Sustituir la tipografía de la notación::
 @end menu
 
+
 @node Extracción de fragmentos de música
 @subsection Extracción de fragmentos de música
 @translationof Extracting fragments of music
@@ -2251,6 +2611,7 @@ c8 d b bes a g c2
 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
 @translationof Alternative output formats
@@ -2266,7 +2627,7 @@ 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}.
+@rprogram{Opciones básicas de la línea de órdenes para LilyPond}.
 
 
 @node Sustituir la tipografía de la notación
@@ -2353,6 +2714,7 @@ canales MIDI se reutilizarán.
 * El script Articulate::
 @end menu
 
+
 @node Crear archivos MIDI
 @subsection Crear archivos MIDI
 @translationof Creating MIDI files
@@ -2502,24 +2864,16 @@ indicación de tempo:
 \score @{
   @var{...música...}
   \midi @{
-    \context @{
-      \Score
-      tempoWholesPerMinute = #(ly:make-moment 72 4)
-    @}
+    \tempo 4 = 72
   @}
 @}
 @end example
 
 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:
-
-@example
-tempoWholesPerMinute = #(ly:make-moment 270 8)
-@end example
+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.
 
 @cindex MIDI, definiciones de contexto
 
@@ -2552,6 +2906,7 @@ dentro de un bloque de partitura definido con una instrucción
 @}
 @end example
 
+
 @node ¿Qué sale por el MIDI?
 @subsection ¿Qué sale por el MIDI?
 @translationof What goes into the MIDI output?
@@ -2773,9 +3128,9 @@ general MIDI está limitado al intervalo desde 0.2 hasta 0.5.
   >>
   \layout {}
   \midi {
+    \tempo 2 = 72
     \context {
       \Score
-      tempoWholesPerMinute = #(ly:make-moment 72 2)
       midiMinimumVolume = #0.2
       midiMaximumVolume = #0.5
     }
@@ -2824,10 +3179,7 @@ cada instrumento para que esto funcione correctamente.
   >>
   \layout {}
   \midi {
-    \context {
-      \Score
-      tempoWholesPerMinute = #(ly:make-moment 72 2)
-    }
+    \tempo 2 = 72
   }
 }
 @end lilypond
@@ -2895,10 +3247,7 @@ del clarinete a los mismos valores que el ejemplo anterior.
   >>
   \layout { }
   \midi {
-    \context {
-      \Score
-      tempoWholesPerMinute = #(ly:make-moment 72 2)
-    }
+    \tempo 2 = 72
   }
 }
 @end lilypond
@@ -2968,6 +3317,7 @@ 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}).
 
+
 @node El script Articulate
 @subsection El script Articulate
 @translationof The Articulate script
@@ -3024,6 +3374,7 @@ musical en forma de texto.
 * 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
@@ -3040,7 +3391,7 @@ mediante la línea de órdenes.  Por ejemplo,
 @}
 @end example
 
-imprimirá
+imprime lo siguiente:
 
 @example
 @{ a,4 cis e fis g @}
@@ -3105,9 +3456,7 @@ 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