]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/es/learning/tutorial.itely
Doc-es: update Learning/Tutorial.
[lilypond.git] / Documentation / es / learning / tutorial.itely
index 2735d522ce64cf2dd2b06fe8198400c021a1740d..c053fa65cc9012d696ec4d372f8ab6b201068e05 100644 (file)
@@ -1,90 +1,75 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
 
 @ignore
-    Translation of GIT committish: 45945bd973aa9161b10e3f517902afb7ef4b4a56
+    Translation of GIT committish: 09ef86c87175cc6c1071eedb022ed1d01a93bcaf
 
     When revising a translation, copy the HEAD committish of the
-    version that you are working on.  See TRANSLATION for details.
+    version that you are working on.  For details, see the Contributors'
+    Guide, node Updating translation committishes..
 @end ignore
 
-@c \version "2.12.0"
+@include included/generating-output.itexi
 
-@ignore
-Tutorial guidelines:  (different from policy.txt!)
-- unless you have a really good reason, use either
-    @lilypond[verbatim,quote]
-  or
-    @lilypond[verbatim,quote,relative=2]
-
-  Don't use any other relative=X commands.
-
-- use "aes" and "ees" instead of "as" and "es".  I know it's not
-  correct Dutch naming, but let's not confuse people with this
-  until we get to the Basic notation chapter.
-
-- Add "Music Glossary: @rglos{foo}" to the *top* of the relevant
-  portions of the tutorial.
-
-@end ignore
-
-@c Translation status: post-GDP
+@c \version "2.19.21"
 
 @node Tutorial
 @chapter Tutorial
+@translationof Tutorial
 
-Este tutorial comienza con una introducción al lenguaje musical
-LilyPond y explica cómo producir música impresa.  Después de este
-primer contacto, explicaremos cómo crear música impresa de forma
-bella, que contenga notación musical usual.
-
+Este capítulo ofrece una introducción básica al trabajo con
+LilyPond.
 
 @menu
-* First steps::
-* Single staff notation::
-* Multiple notes at once::
-* Songs::
-* Final touches::
+* Compilación del archivo::
+* Cómo escribir archivos de entrada::
+* Tratar con los errores::
+* Cómo leer los manuales::
 @end menu
 
+@node Compilación del archivo
+@section Compilación del archivo
+@translationof Compiling a file
 
-@node First steps
-@section First steps
-
-Esta sección le ofrece una introducción básica al trabajo con LilyPond.
+Esta sección presenta el concepto de @qq{compilación}: el
+procesamiento de los documentos de entrada de LilyPond (escritos
+por uno mismo) para producir archivos de salida.
 
 @menu
-* Compiling a file::
-* Simple notation::
-* Working on input files::
-* How to read the manual::
+* Escritura del código de entrada::
+* MacOS X::
+* Windows::
+* Línea de órdenes::
 @end menu
 
-
-@node Compiling a file
-@subsection Compiling a file
+@node Escritura del código de entrada
+@subsection Escritura del código de entrada
+@translationof Entering input
 
 @cindex compilación
 @cindex ejemplo inicial
 @cindex inicial, ejemplo
 @cindex mayúsculas, sensible a
 
+@menu
+* Generar el resultado::
+@end menu
+
 @qq{Compilación} es una palabra que significa procesar un texto de
-entrada en formato de LilyPond para producir un archivo que se puede
-imprimir y (de manera opcional) un archivo MIDI que se puede
+entrada en formato de LilyPond para producir un archivo que se
+puede imprimir y (de manera opcional) un archivo MIDI que se puede
 reproducir.  El primer ejemplo muestra el aspecto de un sencillo
 archivo de texto de entrada.
 
-Para crear una partitura, escribimos un archivo de texto que detalla
-la notación deseada.  Por ejemplo, si escribimos
+Este ejemplo muestra un archivo de entrada sencillo:
 
 @example
+\version "@w{@version{}}"
 @{
   c' e' g' e'
 @}
 @end example
 
-@noindent
-el resultado tiene este aspecto:
+El resultado tiene este aspecto:
 
 @c  in this case we don't want verbatim
 @lilypond[quote]
@@ -94,129 +79,123 @@ el resultado tiene este aspecto:
 @end lilypond
 
 @warning{la música y la letra escrita en el código de entrada de
-LilyPond tiene que ir siempre entre @strong{@{ llaves @}}.  Las llaves
-deberían también estar rodeadas por espacios a no ser que se
-encuentren al principio o al final de una línea, para evitar
-ambigüedades.  Es posible que se omitan en algunos ejemplos del
-presente manual ¡pero no las omita en su propia música!  Para ver más
-información sobre la presentación de los ejemplos del manual, consulte
-@ref{How to read the manual}.}
-
-Además, la entrada de LilyPond es @strong{sensible a las mayúsculas}.
-@code{ @{ c d e @}} es una entrada válida; @code{@{ C D E @}} produce
-un mensaje de error.
+LilyPond tiene que ir siempre entre @w{@strong{@{ llaves @}}}.
+Las llaves deberían también estar rodeadas por espacios a no ser
+que se encuentren al principio o al final de una línea, para
+evitar ambigüedades.  Es posible que se omitan en algunos ejemplos
+del presente manual ¡pero no las omita en su propia música!  Para
+ver más información sobre la presentación de los ejemplos del
+manual, consulte @ref{Cómo leer los manuales}.}
+
+Además, la entrada de LilyPond es @strong{sensible a las
+mayúsculas}.  @w{@samp{ @{ c d e @}}} es una entrada válida;
+@w{@samp{@{ C D E @}}} produce un mensaje de error.
 
 @smallspace
 
-@subheading Entering music and viewing output
+@node Generar el resultado
+@unnumberedsubsubsec Generar el resultado
+@translationof Producing output
 
 @cindex PDF, archivo
 @cindex ver la música
 @cindex editores de texto
-@cindex ejecutar LilyPond bajo MacOS X
-@cindex MacOS X, ejecutar LilyPond
-@cindex ejecutar LilyPond bajo Windows
-@cindex Windows, ejecutar LilyPond
-@cindex ejecutar LilyPond bajo UNIX
-@cindex UNIX, ejecutar LilyPond
 
-En esta sección vamos a explicar qué órdenes hay que ejecutar y cómo,
-para ver o imprimir el resultado.
+El método para producir un resultado impreso depende de nuestro
+sistema operativo y del programa o programas que utilicemos.
 
-Tenga en cuenta que están disponibles varios otros editores de texto
-con un mejor apoyo a la edición de texto de LilyPond.  Para ver más
-información, consulte @rprogram{Text editor support}.
 
-@warning{La primera vez que ejecute LilyPond, tardará un minuto o dos
-porque todas las tipografías del sistema han de ser analizadas
-previamente.  ¡Después de esto, LilyPond será mucho más rápido!}
+@itemize
 
-@subsubheading MacOS X
+@item
+@ref{MacOS X, @sourceimage{logo-macosx,,,}}
+@ref{MacOS X, MacOS X} (gráfico)
 
-Si hace doble clic sobre @code{LilyPond.app}, se abrirá con un archivo
-de ejemplo.  Guárdelo, por ejemplo, como @file{prueba.ly} en el
-Escritorio, y a continuación procéselo con la orden de menú
-@samp{Compilar > Componer archivo}.  El PDF resultante se mostrará en
-la pantalla.
+@item
+@ref{Windows, @sourceimage{logo-windows,,,}}
+@ref{Windows, Microsoft Windows} (gráfico)
 
+@item
+@ref{Línea de órdenes, @sourceimage{logo-linux,,,}
+@sourceimage{logo-freebsd,,,}
+@sourceimage{logo-macosx,,,}
+@sourceimage{logo-windows,,,}
+}
+@ref{Línea de órdenes, Todos los sistemas operativos} (consola)
 
-Para posteriores usos de LilyPond, debería comenzar eligiendo
-@q{Nuevo} o @q{Abrir}.  Tiene que grabar el archivo antes de
-componerlo tipográficamente.  Si se produce algún error durante el
-proceso, observe la ventana del registro.
+@end itemize
 
+Existen varios otros editores de texto con un apoyo específico a
+la edición de texto de LilyPond.  Para ver más información,
+consulte @rweb{Entornos mejorados}.
 
-@subsubheading Windows
+@warning{La primera vez que ejecute LilyPond, tardará un minuto o
+dos porque todas las tipografías del sistema han de ser analizadas
+previamente.  ¡Después de esto, LilyPond será mucho más rápido!}
 
-En Windows, si hace doble clic sobre el icono de LilyPond que está en
-el escritorio, se abrirá un sencillo editor de texto con un archivo de
-ejemplo.  Guárdelo, por ejemplo, con el nombre @file{prueba.ly} en el
-escritorio y después haga doble clic sobre el icono del archivo para
-procesarlo (el icono tiene la forma de una corchea).  Transcurridos
-unos segundos, obtendrá un archivo @file{prueba.pdf} en el
-escritorio. Haga doble clic sobre este archivo PDF para ver la
-partitura compuesta tipográficamente.  Un método alternativo para
-procesar el archivo @file{prueba.ly} es arrastrarlo y soltarlo sobre
-el icono de LilyPond utilizando el ratón.
 
-Para editar un archivo @file{.ly} existente, haga clic sobre él con el
-botón derecho del ratón y elija @qq{Editar la fuente}.  Para empezar
-con un archivo vacío, arranque el editor como se describe más arriba y
-elija @qq{Nuevo} del menú @qq{Archivo}, o haga clic con el botón
-derecho sobre el escritorio y elija @qq{Nuevo..Documento de texto},
-cámbiele el nombre por otro de su elección y cambie la extensión del
-archivo a @code{.ly}.  Edítelo y luego haga doble click sobre él para
-procesarlo como se explicó antes.
+@node MacOS X
+@subsection MacOS X
 
-Al hacer doble clic sobre el archivo no sólo se obtiene como resultado
-un archivo PDF, sino también un archivo @file{.log} que contiene
-cierta información acerca de lo que LilyPond ha hecho con el
-archivo. Si se produce algún error, examine este archivo de registro.
+@cindex ejecución de LilyPond bajo MacOS X
+@cindex MacOS X, ejecución de LilyPond
 
+@lilypadOSX
 
-@subsubheading UNIX
 
-Cree un archivo de texto con el nombre @file{prueba.ly} y escriba en él:
+@node Windows
+@subsection Windows
 
-@example
-@{
-  c' e' g' e'
-@}
-@end example
+@cindex ejecutar LilyPond bajo Windows
+@cindex Windows, ejecutar LilyPond
 
-Para procesar el archivo @file{prueba.ly} haga lo siguiente:
+@lilypadWindows
 
-@example
-lilypond prueba.ly
-@end example
 
-@noindent
-Verá algo parecido a:
+@node Línea de órdenes
+@subsection Línea de órdenes
+@translationof Command-line
 
-@example
-lilypond prueba.ly
-GNU LilyPond @version{}
-Procesando `prueba.ly'
-Analizando...
-Interpretando la música...
-Preprocesando los objetos gráficos...
-Buscando el número de páginas ideal...
-Disponiendo la música en 1 página...
-Dibujando los sistemas...
-Escribiendo la página de salida en `prueba.ps'...
-Convirtiendo a `prueba.pdf'...
-@end example
+@cindex ejecución de  LilyPond bajo Unix
+@cindex Unix, ejecución de LilyPond
+
+@lilypadCommandLine
+
+@node Cómo escribir archivos de entrada
+@section Cómo escribir archivos de entrada
+@translationof How to write input files
+
+Esta sección presenta una parte de la sintaxis básica de LilyPond
+como ayuda para que se inicie en la escritura de archivos de
+entrada.
 
+@menu
+* Notación sencilla::
+* Trabajar sobre los archivos de entrada::
+@end menu
 
-@node Simple notation
-@subsection Simple notation
+
+@node Notación sencilla
+@subsection Notación sencilla
+@translationof Simple notation
 
 @cindex sencilla, notación
 @cindex notación sencilla
 
-LilyPond añadirá ciertos elementos de notación de manera automática.
-En el siguiente ejemplo hemos especificado solamente cuatro alturas,
-pero LilyPond ha añadido la clave, el compás y las duraciones.
+@menu
+* Alturas::
+* Duraciones (valores rítmicos)::
+* Silencios::
+* Indicación de compás::
+* Indicaciones de tempo::
+* Clave::
+* Todo junto::
+@end menu
+
+LilyPond añadirá ciertos elementos de notación de manera
+automática.  En el siguiente ejemplo hemos especificado solamente
+cuatro alturas, pero LilyPond ha añadido la clave, el compás y las
+duraciones.
 
 @lilypond[verbatim,quote]
 {
@@ -225,11 +204,13 @@ pero LilyPond ha añadido la clave, el compás y las duraciones.
 @end lilypond
 
 @noindent
-Este comportamiento se puede modificar, pero en general estos valores
-automáticos son adecuados.
+Este comportamiento se puede modificar, pero en general estos
+valores automáticos son adecuados.
 
 
-@subheading Pitches
+@node Alturas
+@unnumberedsubsubsec Alturas
+@translationof Pitches
 
 @cindex alturas
 @cindex notas
@@ -241,11 +222,9 @@ automáticos son adecuados.
 @cindex relativo, modo, alteraciones y
 
 @funindex \relative
-@funindex relative
 @funindex '
 @funindex ,
 
-
 Glosario musical:
 @rglos{pitch},
 @rglos{interval},
@@ -254,105 +233,115 @@ Glosario musical:
 @rglos{octave},
 @rglos{accidental}.
 
+LilyPond emplea letras minúsculas para las alturas.  Las letras
+desde @code{c} hasta@tie{}@code{b} denotan las alturas de las
+notas de la @q{octava corta} por debajo del @notation{Do central}.
+Los sufijos @code{'} (apóstrofo) o@tie{}@code{,} (coma) se añaden
+para indicar octavas más agudas o más graves.  A continuación se
+muestra una escala que comienza en el @notation{Do central}, y un
+arpegio:
+
+@lilypond[verbatim,quote]
+{ c' d' e' f' g' a' b' c'' g c' e' g' c'' e'' g'' c''' }
+@end lilypond
+
 La manera más sencilla de introducir las notas es mediante la
-utilización del modo @code{\relative} (relativo).  En este modo, se
-elige la octava automáticamente bajo la suposición de que la siguiente
-nota se colocará siempre lo más cerca de la nota actual, es decir, se
-colocará en la octava comprendida dentro de hasta tres espacios de
-pentagrama a partir de la nota anterior.  Comenzaremos por introducir
-el fragmento musical más elemental: una @notation{escala}, donde cada
-nota está comprendida dentro de tan sólo un espacio de pentagrama
-desde la nota anterior.
+utilización del modo @code{\relative} (relativo).  En este modo,
+se elige la octava automáticamente bajo la suposición de que la
+siguiente nota se colocará siempre lo más cerca de la nota actual,
+es decir, se colocará en la octava comprendida dentro de hasta
+tres espacios de pentagrama a partir de la nota anterior.
+Comenzaremos por introducir el fragmento musical más elemental:
+una @notation{escala}, donde cada nota está comprendida dentro de
+tan sólo un espacio de pentagrama desde la nota anterior.
 
 @lilypond[verbatim,quote]
-% set the starting point to middle C
-\relative c' {
-  c d e f
+\relative {
+  c' d e f
   g a b c
 }
 @end lilypond
 
-La nota inicial es el @notation{Do central}.  Cada nota sucesiva se
-coloca lo más cerca posible de la nota previa (en otras palabras: la
-primera @samp{c} es el Do más cercano al Do central; a éste le sigue
-el Re más cercano a la nota previa, y así sucesivamente).  Podemos
-crear melodías con intervalos mayores, aún sin dejar de utilizar el
-modo relativo:
+La nota inicial, escrita como @code{c'}, es el @notation{Do
+central}.  Cada nota sucesiva se coloca lo más cerca posible de la
+nota previa (en otras palabras: la primera @samp{c} es el Do más
+cercano al Do central; a éste le sigue el Re más cercano a la nota
+previa, y así sucesivamente).  Podemos crear melodías con
+intervalos mayores, aún sin dejar de utilizar el modo relativo:
 
 @lilypond[verbatim,quote]
-\relative c' {
-  d f a g
+\relative {
+  d' f a g
   c b f d
 }
 @end lilypond
 
 @noindent
-No es necesario que la primera nota de la melodía comience exactamente
-en aquella que especifica la altura de inicio.  En el ejemplo
-anterior, la primera nota (@code{d}) es el Re más cercano al Do
-central.
+En el ejemplo anterior, la primera nota (@code{d'}, con un
+apóstrofo) es el Re que está en la octava que va del Do central al
+Si por encima de él.
 
-Añadiendo (o eliminando) comillas simples @code{'} o comas @code{,} a
-la instrucción @code{@w{\relative c' @{}}, podemos cambiar la octava
-de inicio:
+Añadiendo (o eliminando) comillas simples @code{'} o comas
+@code{,} a la primera nota, podemos cambiar la octava de inicio:
 
 @lilypond[verbatim,quote]
-% one octave above middle C
-\relative c'' {
-  e c a c
+\relative {
+  e'' c a c
 }
 @end lilypond
 
-Al principio, el modo relativo puede resultar algo confuso, pero es la
-forma más sencilla de introducir la mayor parte de las melodías.
-Veamos cómo funciona en la práctica este cálculo relativo.  Comenzando
-por Si, que está situado en la línea central en clave de Sol, podemos
-alcanzar Do, Re y Mi dentro de los tres espacios de pentagrama hacia
-arriba, y La, Sol y Fa dentro de los tres espacios hacia abajo.  Por
-tanto, si la nota siguiente a Si es Do, Re o Mi se supondrá que está
-por encima del Si, mientras que La, Sol o Fa se entenderán situados
-por debajo.
+Al principio, el modo relativo puede resultar algo confuso, pero
+es la forma más sencilla de introducir la mayor parte de las
+melodías.  Veamos cómo funciona en la práctica este cálculo
+relativo.  Comenzando por Si, que está situado en la línea central
+en clave de Sol, podemos alcanzar Do, Re y Mi dentro de los tres
+espacios de pentagrama hacia arriba, y La, Sol y Fa dentro de los
+tres espacios hacia abajo.  Por tanto, si la nota siguiente a Si
+es Do, Re o Mi se supondrá que está por encima del Si, mientras
+que La, Sol o Fa se entenderán situados por debajo.
 
+@c KEEP LY
 @lilypond[verbatim,quote]
-\relative c'' {
-  b c  % c is 1 staff space up, so is the c above
-  b d  % d is 2 up or 5 down, so is the d above
-  b e  % e is 3 up or 4 down, so is the e above
-  b a  % a is 6 up or 1 down, so is the a below
-  b g  % g is 5 up or 2 down, so is the g below
-  b f  % f is 4 up or 3 down, so is the f below
+\relative {
+  b' c  % el Do está un espacio por encima, es el Do de arriba
+  b d  % el Re está dos por encima ó 5 por debajo, es el Re de arriba
+  b e  % el Mi está 3 por encima ó 4 por debajo, es el Mi de arriba
+  b a  % el La está 6 por encima ó 1 por debajo, es el La de abajo
+  b g  % el Sol está 5 por encima ó 2 por debajo, es el Sol de abajo
+  b f  % el Fa está 4 por encima ó 3 por debajo, es el Fa de abajo
 }
 @end lilypond
 
-Lo mismo exactamente ocurre cuando cualquiera de esas notas llevan un
-sostenido o un bemol.  Las @notation{Alteraciones accidentales} se
-@strong{ignoran totalmente} en el cálculo de la posición relativa.
-Exactamente la misma cuenta de espacios de pentagrama se hace a partir
-de una nota situada en cualquier otro lugar del mismo.
+Lo mismo exactamente ocurre cuando cualquiera de esas notas llevan
+un sostenido o un bemol.  Las @notation{Alteraciones accidentales}
+se @strong{ignoran totalmente} en el cálculo de la posición
+relativa.  Exactamente la misma cuenta de espacios de pentagrama
+se hace a partir de una nota situada en cualquier otro lugar del
+mismo.
 
-Para añadir intervalos mayores de tres espacios de pentagrama, podemos
-elevar la @notation{octava} añadiendo una comilla simple @code{'} (o
-apóstrofo) a continuación del nombre de la nota.  También podemos
-bajar la octava escribiendo una coma @code{,} a continuación del
-nombre de la nota.
+Para añadir intervalos mayores de tres espacios de pentagrama,
+podemos elevar la @notation{octava} añadiendo una comilla simple
+@code{'} (o apóstrofo) a continuación del nombre de la nota.
+También podemos bajar la octava escribiendo una coma @code{,} a
+continuación del nombre de la nota.
 
 @lilypond[verbatim,quote]
-\relative c'' {
-  a a, c' f,
+\relative {
+  a' a, c' f,
   g g'' a,, f'
 }
 @end lilypond
 
-
 @noindent
 Para subir o bajar una nota en dos (¡o más!) octavas, utilizamos
 varias @code{''} ó @code{,,} (pero tenga cuidado de utilizar dos
-comillas simples @code{''} ¡y no una comilla doble @code{"}@tie{}!)
-El valor inicial de @code{@w{\relative c'}} también puede modificarse
-de esta forma.
+comillas simples @code{''} ¡y no una comilla doble
+@code{"}@tie{}!)
 @c " - keeps quotes in order for context-sensitive editor -td
 
-@subheading Durations (rhythms)
+@node Duraciones (valores rítmicos)
+@unnumberedsubsubsec Duraciones (valores rítmicos)
+@translationof Durations (rhythms)
 
 @cindex duraciones de las notas
 @cindex notas, duraciones de
@@ -372,37 +361,39 @@ Glosario musical:
 @rglos{quarter note},
 @rglos{dotted note}.
 
-La @notation{duración} de una nota se especifica mediante un número
-después del nombre de la nota: @code{1} significa @notation{redonda},
-@code{2} significa @notation{blanca}, @code{4} significa
-@notation{negra} y así sucesivamente.  Las @notation{barras de
-corchea} se añaden automáticamente.
+La @notation{duración} de una nota se especifica mediante un
+número después del nombre de la nota: @code{1} significa
+@notation{redonda}, @code{2} significa @notation{blanca}, @code{4}
+significa @notation{negra} y así sucesivamente.  Las
+@notation{barras de corchea} se añaden automáticamente.
 
-Si no especifica una duración, se utiliza la duración previa para la
-nota siguiente.  La figura por omisión de la primera nota es una
-negra.
+Si no especifica una duración, se utiliza la duración previa para
+la nota siguiente.  La figura por omisión de la primera nota es
+una negra.
 
 @lilypond[verbatim,quote]
-\relative c'' {
-  a1
+\relative {
+  a'1
   a2 a4 a8 a
   a16 a a a a32 a a a a64 a a a a a a a a2
 }
 @end lilypond
 
-Para crear @notation{notas con puntillo}, añada un punto @code{.} al
-número de la duración.  La duración de una nota con puntillo se debe
-especificar de forma explícita (es decir: mediante un número).
+Para crear @notation{notas con puntillo}, añada un punto @code{.}
+al número de la duración.  La duración de una nota con puntillo se
+debe especificar de forma explícita (es decir: mediante un
+número).
 
 @lilypond[verbatim,quote]
-\relative c'' {
-  a a a4. a8
+\relative {
+  a'4 a a4. a8
   a8. a16 a a8. a8 a4.
 }
 @end lilypond
 
-
-@subheading Rests
+@node Silencios
+@unnumberedsubsubsec Silencios
+@translationof Rests
 
 @cindex silencio
 @cindex notación de los silencios
@@ -410,43 +401,76 @@ especificar de forma explícita (es decir: mediante un número).
 Glosario musical:
 @rglos{rest}.
 
-Un @notation{silencio} se introduce igual que si fuera una nota con el
-nombre @code{r}@tie{}:
+Un @notation{silencio} se introduce igual que si fuera una nota
+con el nombre @code{r}@tie{}:
 
 @lilypond[verbatim,quote]
-\relative c'' {
-  a r r2
+\relative {
+  a'4 r r2
   r8 a r4 r4. r8
 }
 @end lilypond
 
 
-@subheading Time signature
+@node Indicación de compás
+@unnumberedsubsubsec Indicación de compás
+@translationof Time signature
 
 @cindex compás, indicación de
 
 @funindex \time
-@funindex time
 
 Glosario musical:
 @rglos{time signature}.
 
-La @notation{indicación de compás} se puede establecer con la orden
-@code{\time} :
+La @notation{indicación de compás} se puede establecer con la
+orden @code{\time} :
+
+@lilypond[verbatim,quote]
+\relative {
+  \time 3/4
+  a'4 a a
+  \time 6/8
+  a4. a
+  \time 4/4
+  a4 a a a
+}
+@end lilypond
+
+@node Indicaciones de tempo
+@unnumberedsubsubsec Indicaciones de tempo
+@translationof Tempo marks
+
+@cindex tempo, indicaciones de
+@cindex metronómicas, indicaciones
+
+@funindex \tempo
+
+Glosario musical:
+@rglos{tempo indication},
+@rglos{metronome}.
+
+La @notation{indicación de tempo} y la @notation{indicación
+metronómica} pueden establecerse con la instrucción @code{\tempo}:
 
 @lilypond[verbatim,quote]
-\relative c'' {
+\relative {
   \time 3/4
-  a4 a a
+  \tempo "Andante"
+  a'4 a a
   \time 6/8
+  \tempo 4. = 96
   a4. a
   \time 4/4
+  \tempo  "Presto" 4 = 120
   a4 a a a
 }
 @end lilypond
 
 
-@subheading Clef
+@node Clave
+@unnumberedsubsubsec Clave
+@translationof Clef
 
 @cindex clave
 @cindex sol, clave de
@@ -459,7 +483,6 @@ La @notation{indicación de compás} se puede establecer con la orden
 @cindex bajo
 
 @funindex \clef
-@funindex clef
 
 Glosario musical:
 @rglos{clef}.
@@ -468,45 +491,51 @@ La @notation{clave} se puede establecer utilizando la orden
 @code{\clef} :
 
 @lilypond[verbatim,quote]
-\relative c' {
-  \clef treble
-  c1
-  \clef alto
+\relative {
+  \clef "treble"
+  c'1
+  \clef "alto"
   c1
-  \clef tenor
+  \clef "tenor"
   c1
-  \clef bass
+  \clef "bass"
   c1
 }
 @end lilypond
 
 
-@subheading All together
+@node Todo junto
+@unnumberedsubsubsec Todo junto
+@translationof All together
 
-He aquí un pequeño ejemplo que muestra todos los elementos anteriores
-juntos:
+He aquí un pequeño ejemplo que muestra todos los elementos
+anteriores juntos:
 
 @lilypond[verbatim,quote]
-\relative c, {
+\relative {
+  \clef "bass"
   \time 3/4
-  \clef bass
-  c2 e8 c' g'2.
-  f4 e d c4 c, r4
+  \tempo "Andante" 4 = 120
+  c,2 e8 c'
+  g'2.
+  f4 e d
+  c4 c, r
 }
 @end lilypond
 
 
 @seealso
 Referencia de la notación:
-@ruser{Writing pitches},
-@ruser{Writing rhythms},
-@ruser{Writing rests},
-@ruser{Time signature},
-@ruser{Clef}.
+@ruser{Escritura de notas},
+@ruser{Escritura de las duraciones (valores rítmicos)},
+@ruser{Escritura de silencios},
+@ruser{Indicación de compás},
+@ruser{Clave}.
 
 
-@node Working on input files
-@subsection Working on input files
+@node Trabajar sobre los archivos de entrada
+@subsection Trabajar sobre los archivos de entrada
+@translationof Working on input files
 
 @cindex llaves
 @cindex comentarios
@@ -516,37 +545,68 @@ Referencia de la notación:
 @cindex mayúsculas, sensible a
 @cindex espacios, insensible a
 @cindex expresiones
+@cindex versiones
+@cindex versión
+@cindex número de versión
+
 
+@funindex \version
 @funindex { ... }
 @funindex %
 @funindex %@{ ... %@}
 
-Los archivos de entrada de LilyPond son como los archivos fuente de
-muchos lenguajes de programación corrientes.  Son sensibles a las
-mayúsculas e insensibles al número de espacios.  Las expresiones se
-forman con llaves @{ @} y los comentarios se denotan por un signo de
-porcentaje (@code{%}) o por @w{@code{%@{ ... %@}}}.
+Los archivos de entrada de LilyPond son como los archivos fuente
+de muchos lenguajes de programación corrientes.  Contienen un
+enunciado de versión, son sensibles a las mayúsculas y
+generalmente los espacios se ignoran.  Las expresiones se forman
+con llaves @w{@code{@{ @}}} y los comentarios se denotan por un
+signo de porcentaje (@code{%}) o por @w{@code{%@{ @dots{}
+%@}}}@tie{}.
 
-Si la frase anterior no tiene sentido para usted ¡no se preocupe! A
-continuación explicaremos el significado de todos estos términos:
+Si la frase anterior no tiene sentido para usted ¡no se preocupe!
+A continuación explicaremos el significado de todos estos
+términos:
 
 @itemize
 
 @item
-@strong{Sensible a las mayúsculas}: tiene importancia el hecho de que
-introduzca una letra en minúsculas (p.ej. @w{@code{a, b, s, t}}) o en
-mayúsculas (p.ej.  @w{@code{A, B, S, T}}).  Las notas son minúsculas:
-@w{@code{@{ c d e @}}} es una entrada válida; @w{@code{@{ C D E @}}}
-produciría un mensaje de error.
+@strong{Enunciado de la versión}: Todo archivo de LilyPond debe
+contener un enunciado de versión.  Un enunciado de versión es una
+línea que describe la versión de LilyPond para la que se escribió
+este archivo, como en el ejemplo siguiente:
+
+@example
+\version "@w{@version{}}"
+@end example
+
+Por convenio, el enunciado de versión se coloca al principio del
+archivo de LilyPond.
+
+El enunciado de versión es importante por dos motivos como mínimo.
+En primer lugar, permite la actualización automática del código de
+entrada conforme se va modificando la sintaxis de LilyPond.  En
+segundo lugar, indica la versión de LilyPond que se necesita para
+compilar el archivo.
+
+Si no se escribe ningún enunciado de versión en el archivo de
+entrada, LilyPond imprime una advertencia durante la compilación
+del mismo.
+
+@item
+@strong{Sensible a las mayúsculas}: tiene importancia el hecho de
+que introduzca una letra en minúsculas (p.ej. @w{@code{a, b, s, t}})
+o en mayúsculas (p.ej.  @w{@code{A, B, S, T}}).  Las notas son
+minúsculas: @w{@samp{@{ c d e @}}} es una entrada válida;
+@w{@samp{@{ C D E @}}} produciría un mensaje de error.
 
 @item
-@strong{Insensible al número de espacios}: no importa cuántos espacios
-(o saltos de línea o de tabulación) añada.  @w{@code{@{ c d e @}}}
-significa lo mismo que @w{@code{@{ c @tie{}} @tie{} @tie{} d e @}} y
-que
+@strong{Insensible al número de espacios}: no importa cuántos
+espacios (o saltos de línea o de tabulación) añada.
+@w{@samp{@{ c4 d e @}}} significa lo mismo que
+@w{@samp{@{ c4 @tie{} @tie{} @tie{} d e @}}} y que
 
 @example
-@{ c                        d
+@{ c4                       d
                    e   @}
 @end example
 
@@ -557,43 +617,43 @@ tabulación, o bien con dos espacios:
 
 @example
 @{
-  c d e
+  c4 d e
 @}
 @end example
 
 Sin embargo, @emph{sí} se necesitan espacios para separar muchos
-elementos sintácticos unos de otros.  En otras palabras, los espacios
-se pueden siempre @emph{añadir}, pero no se pueden @emph{eliminar}.
-Dado que la falta de espacios puede dar lugar a extraños errore,
-recomendamos insertar espacios siempre antes y después de cualquier
-elemento sintáctico, por ejemplo, antes y después de las llaves
-curvas.
+elementos sintácticos unos de otros.  En otras palabras, los
+espacios se pueden siempre @emph{añadir}, pero no siempre
+@emph{eliminar}.  Dado que la falta de espacios puede dar lugar a
+extraños errores, recomendamos insertar espacios siempre antes y
+después de cualquier elemento sintáctico, por ejemplo, antes y
+después de las llaves.
 
 @item
-@strong{Expresiones:}
-Todo fragmento de código de entrada para LilyPond ha de llevar
-@strong{@{ llaves @}} antes y después de la entrada.  Estas llaves le dicen a
-LilyPond que la entrada es una expresión musical unitaria, igual que
-los paréntesis @samp{()} de las matemáticas.  Las llaves deben ir rodeadas
-de un espacio a no ser que se encuentren al comienzo o al final de una
-línea, para evitar cualquier ambigüedad.
+@strong{Expresiones:} Todo fragmento de código de entrada para
+LilyPond ha de llevar @strong{@{@tie{}llaves@tie{}@}} antes y
+después de la entrada.  Estas llaves le dicen a LilyPond que la
+entrada es una expresión musical unitaria, igual que los
+paréntesis @samp{()} de las matemáticas.  Las llaves deben ir
+rodeadas de un espacio a no ser que se encuentren al comienzo o al
+final de una línea, para evitar cualquier ambigüedad.
 
 Una instrucción de LilyPond seguida de una expresión simple entre
-llaves (como por ejemplo @w{@code{\relative @{ @}}}) también es una
-expresión musical unitaria.
+llaves (como por ejemplo @q{@w{@code{@bs{}relative @{ @dots{}
+@}}}}) también es una expresión musical unitaria.
 
 @cindex comentarios
 @cindex comentario de línea
 @cindex comentario de bloque
 @item
-@strong{Comentarios}:
-Un comentario es una nota para el lector humano de la entrada musical;
-se ignora cuando esta entrada se analiza, de manera que no tiene
-ningún efecto sobre la salida impresa.  Existen dos tipos de
-comentarios.  El símbolo de porcentaje @samp{%} introduce un
-comentario de línea; todo lo que se encuentra después de @samp{%} en
-esa línea se ignora.  Por convenio, una línea de comentario se coloca
-@emph{por encima} del código a que se refiere el comentario.
+@strong{Comentarios}: Un comentario es una nota para el lector
+humano de la entrada musical; se ignora cuando esta entrada se
+analiza, de manera que no tiene ningún efecto sobre la salida
+impresa.  Existen dos tipos de comentarios.  El símbolo de
+porcentaje @samp{%} introduce un comentario de línea; todo lo que
+se encuentra después de @samp{%} en esa línea se ignora.  Por
+convenio, una línea de comentario se coloca @emph{por encima} del
+código a que se refiere el comentario.
 
 @example
 a4 a a a
@@ -601,13 +661,14 @@ a4 a a a
 b2 b
 @end example
 
-Un comentario de bloque marca una sección entera de entrada musical
-como comentario.  Todo lo que está encerrado dentro de @code{%@{} y
-@code{%@}} se ignora (pero los comentarios no pueden anidarse, lo que
-significa que un comentario de bloque no puede incluir otros
-comentarios de bloque).  Si lo hiciera, el primer @code{%@}} daría por
-terminado @emph{los dos} comentarios de bloque.  El siguiente
-fragmento muestra algunos posibles usos para los comentarios:
+Un comentario de bloque marca una sección entera de entrada
+musical como comentario.  Todo lo que está encerrado dentro de
+@code{%@{} y @code{%@}} se ignora (pero los comentarios no pueden
+anidarse, lo que significa que un comentario de bloque no puede
+incluir otros comentarios de bloque).  Si lo hiciera, el primer
+@code{%@}} daría por terminado @emph{los dos} comentarios de
+bloque.  El siguiente fragmento muestra algunos posibles usos para
+los comentarios:
 
 @example
 % a continuación van las notas de campanitas del lugar
@@ -618,1500 +679,183 @@ fragmento muestra algunos posibles usos para los comentarios:
   se ignoran, por estar dentro de un
   comentario de bloque.
 
-  f f e e d d c2
+  f4 f e e d d c2
 %@}
 @end example
 
 @end itemize
 
 
-@node How to read the manual
-@subsection How to read the manual
-
-@cindex cómo leer el manual
-@cindex manual, lectura del
-@cindex leer el manual
-@cindex ejemplos, pulsar
-@cindex pulsar sobre los ejemplos
-@cindex consejos para construir archivos
-@cindex plantillas
-@cindex construir archivos, consejos
-@cindex archivos, consejos para construir
-
-Como ya vimos en @ref{Working on input files}, el código de entrada de
-LilyPond debe estar rodeado de llaves @{ @} o de @code{@w{\relative
-c'' @{ ... @}}}.  Durante el resto del presente manual, la mayor parte
-de los ejemplos omitirán las llaves.  Para reproducir los ejemplos,
-deberá copiar y pegar la entrada que se muestra, pero @strong{deberá}
-escribir el @code{@w{\relative c'' @{ @}}}, de la siguiente forma:
-
-@example
-\relative c'' @{
-  ... aquí va el ejemplo...
-@}
-@end example
-
-¿Por qué omitir las llaves? Casi todos los ejemplos del presente
-manual se pueden insertar en medio de un fragmento mayor de música.
-Para estos ejemplos no tiene ningún sentido añadir @code{@w{\relative
-c'' @{ @}}} (¡no debería poner un @code{\relative} dentro de otro
-@code{\relative}!); si hubiésemos incluido @code{@w{\relative c'' @{
-@}}} rodeando a cada uno de los ejemplos, usted no podría copiar un
-ejemplo pequeño procedente de la documentación y pegarlo dentro de su
-propia pieza.  La mayoría querrá insertar el código dentro de una
-pieza más grande, por eso hemos formateado el manual de esta manera.
-
-
-
-@subheading Clickable examples
-
-Muchas personas aprenden a utilizar programas probando y enredando con
-ellos.  Esto también puede hacerse con LilyPond.  Si hace clic sobre
-una imagen en la versión en HTML de este manual, podrá ver la entrada
-exacta de LilyPond que se utilizó para generar esa imagen.  Pruébelo
-sobre esta imagen:
-
-@c no verbatim here
-@lilypond[quote]
-\relative c'' {
-  c-\markup { \bold \huge { Click here.  } }
-}
-@end lilypond
-
-Cortando y pegando todo lo que se encuentra dentro de la sección
-@qq{ly snippet} (fragmento de tipo ly), tendrá una plantilla inicial
-para sus experimentos. Para poder ver exactamente el mismo resultado
-(con igual anchura de línea y todo), copie todo lo que está desde
-@qq{Start cut-&-pastable section} hasta el final del archivo.
-
-
-@seealso
-Podrá encontrar más consejos y trucos para la construcción de archivos
-de entrada en @ref{Suggestions for writing LilyPond files}; pero quizá
-sea mejor leer primero el resto del tutorial.
-
+@node Tratar con los errores
+@section Tratar con los errores
+@translationof Dealing with errors
 
-@node Single staff notation
-@section Single staff notation
+@cindex depuración de errores
 
-Esta sección es una introducción a la notación corriente que se utiliza para una voz
-o un pentagrama.
+A veces, LilyPond no produce el resultado esperado.  Esta sección
+aporta algunos enlaces para ayudarle a resolver los problemas que
+pudiera encontrar.
 
 @menu
-* Accidentals and key signatures::
-* Ties and slurs::
-* Articulation and dynamics::
-* Adding text::
-* Automatic and manual beams::
-* Advanced rhythmic commands::
+* Consejos generales de solución de problemas::
+* Algunos errores comunes::
 @end menu
 
+@node Consejos generales de solución de problemas
+@subsection Consejos generales de solución de problemas
+@translationof General troubleshooting tips
 
-@node Accidentals and key signatures
-@subsection Accidentals and key signatures
-
-@subheading Accidentals
-
-@cindex accidentales, alteraciones
-@cindex alteraciones
-@cindex alteraciones y armaduras
-@cindex sostenido
-@cindex doble sostenido
-@cindex sostenido, doble
-@cindex bemol
-@cindex doble bemol
-@cindex bemol, doble
-
-@funindex es
-@funindex is
-@funindex eses
-@funindex isis
-
-Glosario musical:
-@rglos{sharp},
-@rglos{flat},
-@rglos{double sharp},
-@rglos{double flat},
-@rglos{accidental}.
-
-Una nota con @notation{sostenido} se hace añadiendo @code{is} al
-nombre, y una nota @notation{bemol} añadiendo @code{es}.  Como ha
-podido adivinar, un @notation{doble sostenido} o @notation{doble
-bemol} se hace añadiendo @code{isis} o @code{eses}.  Esta sintaxis se
-deriva de las convenciones de nomenclatura de las notas en las lenguas
-nórdicas y germánicas como el alemán y el holandés.  Para utilizar
-otros nombres para las @notation{alteraciones accidentales}, véase
-@ruser{Note names in other languages}.
-
-@lilypond[verbatim,quote,relative=2]
-cis1 ees fisis, aeses
-@end lilypond
-
-@cindex tonalidad, armadura de la, establecer
-@subheading Key signatures
-
-@cindex tonalidad, armadura de
-@cindex armadura
-@cindex mayor
-@cindex menor
-@cindex alteraciones y armadura
-@cindex contenido frente a presentación
-@cindex presentación frente a contenido
-
-@funindex \key
-@funindex key
-@funindex \major
-@funindex major
-@funindex \minor
-@funindex minor
-
-Glosario musical:
-@rglos{key signature},
-@rglos{major},
-@rglos{minor}.
-
-La @notation{armadura de la tonalidad} se establece mediante la
-instrucción @code{\key} seguido de una nota y @code{\major} o
-@code{\minor}.
-
-@lilypond[verbatim,quote,relative=2]
-\key d \major
-a1
-\key c \minor
-a
-@end lilypond
-
-@smallspace
-
-@subheading Warning: key signatures and pitches
-
-Glosario musical:
-@rglos{accidental},
-@rglos{key signature},
-@rglos{pitch},
-@rglos{flat},
-@rglos{natural},
-@rglos{sharp},
-@rglos{transposition}.
-
-Para determinar si hay que imprimir una @notation{alteración
-accidental}, LilyPond examina las notas y la @notation{armadura de la
-tonalidad}.  La armadura solamente afecta a las alteraciones
-@emph{impresas}, ¡no a las propias notas!  Esta funcionalidad suele
-confundir a los que están empezando con el programa, por ello
-permítanos explicarla en detalle.
-
-LilyPond hace una clara distinción entre el contenido musical y la
-presentación.  La alteración (@notation{bemol}, @notation{becuadro} o
-@notation{sostenido}) de una nota es parte de la altura, y por tanto
-es contenido musical.  Si una alteración (un signo @emph{impreso} de
-bemol, becuadro o sostenido) se imprime o no delante de la nota
-correspondiente, es una cuestión de presentación.  La presentación es
-algo que sigue unas reglas, así que las alteraciones accidentales se
-imprimen automáticamente según dichas reglas.  Las alturas de las
-notas en su música son obras de arte, por tanto no se añadirán
-automáticamente, y usted deberá introducir aquello que quiera oír.
-
-En el siguiente ejemplo:
-
-@lilypond[verbatim,quote,relative=2]
-\key d \major
-d cis fis
-@end lilypond
-
-@noindent
-ninguna nota lleva una alteración impresa, pero de todas formas usted
-debe añadir el @code{is} a @code{cis} y a @code{fis}.
-
-El texto @code{b} no significa @qq{imprimir una bolita negra en la
-tercera línea del pentagrama.}  Más bien significa: @qq{hay una nota
-Si natural.}  En la tonalidad de La bemol mayor, @emph{lleva} una
-alteración accidental:
-
-@lilypond[verbatim,quote,relative=2]
-\key aes \major
-b
-@end lilypond
-
-Poner todas las alteraciones de forma explícita puede que requiera
-algo más de trabajo al teclear, pero la ventaja es que la
-@notation{transposición} es más fácil, y las alteraciones se pueden
-imprimir siguiendo varias convenciones distintas.  Consulte
-@ruser{Automatic accidentals} para ver ejemplos de cómo se pueden
-imprimir las alteraciones de acuerdo a reglas diferentes.
-
-
-@seealso
-Referencia de la notación:
-@ruser{Note names in other languages},
-@ruser{Accidentals},
-@ruser{Automatic accidentals},
-@ruser{Key signature}.
-
-Glosario musical:
-@rglos{Pitch names}.
-
-
-@node Ties and slurs
-@subsection Ties and slurs
-
-@cindex ligadura de unión
-@cindex ligadura de expresión
-@cindex ligadura de fraseo
-@cindex fraseo, ligadura de
-
-@funindex ~
-@funindex ( ... )
-@funindex \( ... \)
-
-@subheading Ties
-
-Glosario musical:
-@rglos{tie}.
-
-Una @notation{ligadura de unión} se crea adjuntando un carácter de
-tilde curva @code{~} a la primera nota ligada:
-
-@lilypond[verbatim,quote,relative=2]
-g4~ g c2~
-c4 ~ c8 a8 ~ a2
-@end lilypond
-
-@subheading Slurs
-
-Glosario musical:
-@rglos{slur}.
-
-Una @notation{ligadura de expresión} es una curva que se traza
-abarcando varias notas.  Las notas inicial y final se marcan mediante
-@code{(} y @code{)} respectivamente.
-
-@lilypond[verbatim,quote,relative=2]
-d4( c16) cis( d e c cis d) e( d4)
-@end lilypond
-
-@subheading Phrasing slurs
-
-Glosario musical:
-@rglos{slur},
-@rglos{phrasing}.
-
-Las ligaduras que se utilizan para indicar @notation{fraseos} más
-largos se pueden introducir mediante @code{\(} y @code{\)}.  Puede
-haber al mismo tiempo ligaduras de legato y ligaduras de fraseo, pero
-no es posible tener legatos simultáneos o ligaduras de expresión
-simultáneas.
-
-@lilypond[verbatim,quote,relative=2]
-a8(\( ais b c) cis2 b'2 a4 cis,\)
-@end lilypond
-
-@smallspace
-
-@cindex ligaduras de expresión frente a ligaduras de unión
-@subheading Warnings: slurs vs. ties
-
-Glosario musical:
-@rglos{articulation},
-@rglos{slur},
-@rglos{tie}.
-
-Una @notation{ligadura de expresión} parece una @notation{ligadura de
-unión}, pero tiene un significado distinto.  Una ligadura (de unión)
-sencillamente hace que la primera nota sea más larga, y sólo se puede
-utilizar sobre parejas de notas iguales.  Las ligaduras de expresión
-indican la @notation{articulación} de las notas, y se pueden utilizar
-sobre grupos mayores de notas.  Las ligaduras de unión y de expresión
-se pueden anidar unas dentro de otras.
-
-@lilypond[verbatim,quote,relative=2]
-c2~( c8 fis fis4 ~ fis2 g2)
-@end lilypond
-
-
-@seealso
-Referencia de la notación:
-@ruser{Ties},
-@ruser{Slurs},
-@ruser{Phrasing slurs}.
-
-
-@node Articulation and dynamics
-@subsection Articulation and dynamics
-
-@subheading Articulations
-
-@cindex articulación
-@cindex acento
-@cindex staccato
-
-Glosario musical:
-@rglos{articulation}.
-
-Las @notation{articulaciones} más corrientes se pueden añadir a las
-notas utilizando un guión @code{-} seguido de un carácter único:
-
-@lilypond[verbatim,quote,relative=2]
-c-. c-- c-> c-^ c-+ c-_
-@end lilypond
-
-@subheading Fingerings
-
-@cindex digitaciones
-
-@funindex ^
-@funindex _
-
-Glosario musical:
-@rglos{fingering}.
-
-De manera similar, las @notation{digitaciones} se pueden añadir a una
-nota utilizando un guión (@code{-}) seguido del dígito deseado:
+La solución de problemas en LilyPond puede ser un desafío para las
+personas acostumbradas a los interfaces gráficos, porque es
+posible crear archivos de entrada inválidos.  Cuando esto ocurre,
+la mejor forma de identificar y resolver el problema es aplicar un
+enfoque lógico.  Se dan algunas guías para ayudarle a aprender a
+hacerlo, en @rprogram{Solución de problemas}.
 
-@lilypond[verbatim,quote,relative=2]
-c-3 e-5 b-2 a-1
-@end lilypond
 
-Las articulaciones y digitaciones normalmente se colocan de forma
-automática, pero puede especificar una dirección mediante @code{^}
-(encima) o @code{_} (debajo).  También puede usar varias
-articulaciones sobre la misma nota.  Sin embargo, casi siempre es
-mejor dejar que LilyPond determine la dirección de las articulaciones.
+@node Algunos errores comunes
+@subsection Algunos errores comunes
+@translationof Some common errors
 
-@lilypond[verbatim,quote,relative=2]
-c_-^1 d^. f^4_2-> e^-_+
-@end lilypond
+@cindex comunes, errores
+@cindex errores comunes
 
-@subheading Dynamics
-
-@cindex dinámica, indicaciones de
-@cindex matices
-@cindex decrescendo
-@cindex crescendo
-
-@funindex \f
-@funindex \ff
-@funindex \mp
-@funindex \p
-@funindex \mf
-@funindex \pp
-@funindex \<
-@funindex <
-@funindex \>
-@funindex >
-@funindex \!
-@funindex !
+Existen algunos errores comunes que son difíciles de solucionar si
+nos basamos solamente en los mensajes de error que se nos
+presentan.  Éstos se describen en @rprogram{Errores comunes}.
 
-Glosario musical:
-@rglos{dynamics},
-@rglos{crescendo},
-@rglos{decrescendo}.
 
-Las expresiones de @notation{matiz} o signos dinámicos se hacen
-añadiendo las marcas (con una barra invertida) a la nota:
+@node Cómo leer los manuales
+@section Cómo leer los manuales
+@translationof How to read the manuals
 
-@lilypond[verbatim,quote,relative=2]
-c\ff c\mf c\p c\pp
-@end lilypond
+Esta sección muestra cómo leer la documentación de forma
+eficiente, y presenta algunas interesantes funcionalidades
+interactivas de la versión en línea.
 
-Los @notation{crescendi} y @notation{decrescendi} comienzan con las
-órdenes @code{\<} y @code{\>}.  La siguiente indicación de matiz, como
-por ejemplo @code{\f}, dará por terminado el (de)crescendo, o bien se
-puede usar la instrucción @code{\!}:
+@menu
+* Material omitido::
+* Ejemplos con enlace::
+* Panorámica de los manuales::
+@end menu
 
-@lilypond[verbatim,quote,relative=2]
-c2\< c2\ff\> c2 c2\!
-@end lilypond
 
+@node Material omitido
+@subsection Material omitido
+@translationof Omitted material
 
-@seealso
-Referencia de la notación:
-@ruser{Articulations and ornamentations},
-@ruser{Fingering instructions},
-@ruser{Dynamics}.
 
+@cindex cómo leer el manual
+@cindex manual, lectura del
+@cindex leer el manual
+@cindex ejemplos, pulsar
+@cindex pulsar sobre los ejemplos
+@cindex consejos para construir archivos
+@cindex plantillas
+@cindex construir archivos, consejos
+@cindex archivos, consejos para construir
 
-@node Adding text
-@subsection Adding text
+Como ya vimos en @ref{Trabajar sobre los archivos de entrada}, el
+código de entrada de LilyPond debe estar rodeado de llaves
+@code{@{ @}} o de @q{@w{@code{@bs{}relative @{ @dots{} @}}}}.
+Durante el resto del presente manual, ciertos ejemplos breves
+omitirán las llaves.  Para reproducir estos ejemplos puede copiar
+la entrada que se muestra, pero debe pegarla entre @code{@{} y
+@code{@}} dentro del archivo de entrada.
 
-@cindex texto, añadir
-@cindex añadir texto
-@cindex marcado
+@example
+@{
+  @dots{}aquí va el ejemplo@dots{}
+@}
+@end example
 
-@funindex \markup
-@funindex markup
+Asimismo, recuerde que todo archivo de LilyPond debe llevar un
+enunciado @code{\version}.  Dado que los ejemplos de los manuales
+son fragmentos de código y no archivos completos, el enunciado
+@code{\version} se omite.  De todas formas, debemos acostumbrarnos
+a incluirlo en nuestros documentos.
 
-Es posible añadir texto a la partitura:
+@node Ejemplos con enlace
+@subsection Ejemplos con enlace
+@translationof Clickable examples
 
-@lilypond[verbatim,quote,relative=2]
-c1^"espr" a_"legato"
-@end lilypond
+@warning{Esta funcionalidad sólo está disponible en los manuales
+en HTML.}
 
-Se puede aplicar un formateo adicional mediante la instrucción @code{\markup}:
+Muchas personas aprenden a utilizar programas probando y enredando
+con ellos.  Esto también puede hacerse con LilyPond.  Si hace clic
+sobre una imagen en la versión en HTML de este manual, podrá ver
+la entrada exacta de LilyPond que se utilizó para generar esa
+imagen.  Pruébelo sobre esta imagen:
 
-@lilypond[verbatim,quote,relative=2]
-c1^\markup{ \bold espr}
-a1_\markup{
-  \dynamic f \italic \small { 2nd } \hspace #0.1 \dynamic p
+@c no verbatim here
+@c KEEP LY
+@lilypond[quote]
+\relative {
+  c''4-\markup { \bold \huge { Haga clic aquí. } }
 }
 @end lilypond
 
+Cortando y pegando todo lo que se encuentra dentro de la sección
+@qq{ly snippet} (fragmento de tipo ly), tendrá una plantilla
+inicial para sus experimentos. Para poder ver exactamente el mismo
+resultado (con igual anchura de línea y todo), copie todo lo que
+está desde @qq{Start cut-&-pastable section} hasta el final del
+archivo.
 
-@seealso
-Referencia de la notación:
-@ruser{Writing text}.
-
-
-@node Automatic and manual beams
-@subsection Automatic and manual beams
-
-@cindex barras de corchea
-@cindex barrado
-@cindex automáticas, barras
-@cindex manuales, barras
-@cindex barras automáticas
-@cindex barras manuales
-
-@funindex [ ... ]
-@funindex [
-@funindex ]
-@funindex \autoBeamOff
-@funindex autoBeamOff
-@funindex \autoBeamOn
-@funindex autoBeamOn
-
-Glosario musical:
-@rglos{beam}.
-
-Todas las @notation{barras} de las figuras se dibujan automáticamente:
-
-@lilypond[verbatim,quote,relative=2]
-a8 ais d ees r d c16 b a8
-@end lilypond
-
-@noindent
-Si no le gustan las barras automáticas, pueden forzarse manualmente.
-Marque la primera nota que comprende la barra con @code{[} y la última
-con @code{]}.
-
-@lilypond[verbatim,quote,relative=2]
-a8[ ais] d[ ees r d] a b
-@end lilypond
-
-Si quiere desactivar completamente el barrado automático o para una
-sección extensa de música, utilice la instrucción @code{\autoBeamOff}
-para apagarlo y @code{\autoBeamOn} para activarlo de nuevo.
-
-@lilypond[verbatim,quote,relative=2]
-\autoBeamOff
-a8 c b4 d8. c16 b4
-\autoBeamOn
-a8 c b4 d8. c16 b4
-@end lilypond
-
-
-@seealso
-Referencia de la notación:
-@ruser{Automatic beams},
-@ruser{Manual beams}.
-
-
-@node Advanced rhythmic commands
-@subsection Advanced rhythmic commands
 
-@subheading Partial measure
+@ignore
+This is item 825
 
-@cindex anacrusa
-@cindex compás parcial
+@n ode Navegación con el teclado
+@s ubsection Navegación con el teclado
+@t ranslationof Keyboard navigation
 
-@funindex \partial
-@funindex partial
+@warning{Esta posibilidad sólo está disponible en los manuales en
+HTML.}
 
-Glosario musical:
-@rglos{anacrusis}.
+@c TODO: once this is figured out, insert it here.
 
-Una @notation{anacrusa} se introduce con la palabra clave
-@code{\partial}.  Va seguida de una duración: @code{\partial 4} es una
-anacrusa de negra y @code{\partial 8} de corchea.
+Estamos trabajando sobre esta funcionalidad.
+@end ignore
 
-@lilypond[verbatim,quote,relative=2]
-\partial 8
-f8 c2 d
-@end lilypond
+@node Panorámica de los manuales
+@subsection Panorámica de los manuales
+@translationof Overview of manuals
 
-@subheading Tuplets
+Existe abundantísima documentación sobre LilyPond.  Con
+frecuencia, los nuevos usuarios se encuentran desorientados
+respecto a qué parte o partes deben leer, y ocasionalmente pasan
+por alto la lectura de partes de importancia vital.
 
-@cindex grupos especiales
-@cindex tresillos
+@warning{Por favor: no se salte las partes importantes de la
+documentación.  Le resultará mucho más difícil comprender las
+secciones subsiguientes.}
 
-@funindex \times
-@funindex times
+@itemize
 
-Glosario musical:
-@rglos{note value},
-@rglos{triplet}.
-
-Los grupos especiales como los tresillos se hacen con la palabra clave
-@code{\times}.  Requiere dos argumentos: una fracción y un fragmento
-de música.  La duración del fragmento de música se multiplica por la
-fracción.  Los tresillos hacen que las notas ocupen 2/3 de su duración
-expresa, por tanto un @notation{tresillo} lleva una fracción de 2/3:
-
-@lilypond[verbatim,quote,relative=2]
-\times 2/3 { f8 g a }
-\times 2/3 { c r c }
-\times 2/3 { f,8 g16[ a g a] }
-\times 2/3 { d4 a8 }
-@end lilypond
+@item
+@strong{Antes de intentar hacer @emph{cualquier cosa}}: lea el
+@ref{Tutorial} del manual de Aprendizaje, y la sección
+@ref{Notación corriente}.  Si encuentra términos musicales que no
+reconoce, búsquelos en el @rglosnamed{Top, Glosario}.
 
-@subheading Grace notes
+@item
+@strong{Antes de tratar de escribir una pieza completa de música}:
+lea la sección @ref{Conceptos fundamentales} del manual de
+Aprendizaje.  Después, le vendrá bien consultar las secciones
+correspondientes de la @rusernamed{Top, Referencia de la
+notación}.
 
-@cindex notas de adorno
-@cindex acciaccatura
-@cindex appoggiatura
+@item
+@strong{Antes de tratar de modificar los resultados
+predeterminados}: lea la sección @ref{Trucar la salida} del manual
+de Aprendizaje.
 
-@funindex \grace
-@funindex grace
-@funindex \acciaccatura
-@funindex acciaccatura
-@funindex \appoggiatura
-@funindex acciaccatura
+@item
+@strong{Antes de afrontar un proyecto grande}: lea la sección
+@rprogramnamed{Suggestions for writing files,Sugerencias para
+escribir archivos de entrada de LilyPond} del manual de
+Utilización del programa.
 
-Glosario musical:
-@rglos{grace notes},
-@rglos{acciaccatura},
-@rglos{appoggiatura}.
-
-Las @notation{notas de adorno} se crean con la instrucción
-@code{\grace}, aunque también se pueden conseguir precediendo una
-expresión musical por la palabra clave @code{\appoggiatura} o
-@code{\acciaccatura}
-
-@lilypond[verbatim,quote,relative=2]
-c2 \grace { a32[ b] } c2
-c2 \appoggiatura b16 c2
-c2 \acciaccatura b16 c2
-@end lilypond
-
-
-@seealso
-Referencia de la notación:
-@ruser{Grace notes},
-@ruser{Tuplets},
-@ruser{Upbeats}.
-
-
-@node Multiple notes at once
-@section Multiple notes at once
-
-Esta sección es una introducción a las notas simultáneas: varios
-instrumentos, varios pentagramas para un solo instrumento
-(p.ej. piano) y acordes.
-
-La palabra @qq{polifonía} en música hace referencia al hecho de tener
-más de una voz en un momento determinado dentro de una pieza musical.
-La palabra @qq{polifonía} en LilyPond se refiere al hecho de tener más
-de una voz en el mismo pentagrama.
-
-@menu
-* Music expressions explained::
-* Multiple staves::
-* Staff groups::
-* Combining notes into chords::
-* Single staff polyphony::
-@end menu
-
-
-@node Music expressions explained
-@subsection Music expressions explained
-
-@cindex musical, expresión
-@cindex expresión musical
-@cindex compuesta, expresión musical
-@cindex musical, expresión, compuesta
-
-En los archivos de entrada de LilyPond, la música se representa
-mediante @emph{expresiones musicales}.  Una sola nota es una expresión
-musical:
-
-@lilypond[verbatim,quote,relative=2]
-a4
-@end lilypond
-
-Al encerrar un grupo de notas dentro de llaves creamos una
-@emph{expresión musical compuesta}.  Aquí hemos creado una expresión
-musical compuesta con dos notas:
-
-@lilypond[verbatim,quote,relative=2]
-{ a4 g4 }
-@end lilypond
-
-Si colocamos un grupo de expresiones musicales (p.ej.: notas) dentro
-de llaves, eso significa que se encuentran en secuencia (es decir,
-cada una sigue a la anterior).  El resultado es otra expresión
-musical:
-
-@lilypond[verbatim,quote,relative=2]
-{ { a4 g } f g }
-@end lilypond
-
-@subheading Analogy: mathematical expressions
-
-Este mecanismo es semejante a las fórmulas matemáticas: una fórmula
-grande se construye combinando fórmulas pequeñas.  Dichas fórmulas se
-llaman expresiones, y su definición es recursiva de tal forma que se
-pueden construir expresiones de un tamaño y complejidad arbitrarios.
-Por ejemplo:
-
-@example
-1
-
-1 + 2
-
-(1 + 2) * 3
-
-((1 + 2) * 3) / (4 * 5)
-@end example
-
-Ésta es una secuencia de expresiones donde cada expresión se encuentra
-contenida dentro de la siguiente, más grande.  Las expresiones más
-simples son números, y las mayores se hacen combinando expresiones
-mediante operadores (como @code{+}, @code{*} y @code{/}) y paréntesis.
-Del mismo modo que las expresiones matemáticas, las expresiones
-musicales se pueden anidar a una profundidad arbitraria, lo que se
-hace necesario para músicas complejas como las partituras polifónicas.
-
-
-@subheading Simultaneous music expressions: multiple staves
-
-@cindex varios pentagramas
-@cindex pentagramas, varios
-@cindex polifonía
-@cindex combinar expresiones en paralelo
-@cindex paralelas, expresiones
-@cindex expresiones paralelas
-@cindex relativo, modo, música simultánea y
-@cindex relativo, modo, expresiones paralelas y
-@cindex simultánea, música, modo relativo y
-@cindex paralelas, expresiones, modo relativo y
-
-@funindex <<
-@funindex >>
-@funindex << ... >>
-
-Glosario musical:
-@rglos{polyphony}.
-
-Esta técnica es muy útil para la música @notation{polifónica}.  Para
-introducir música con más voces o con más pentagramas, lo que hacemos
-es combinar varias expresiones en paralelo.  Para indicar que dos
-voces se deben interpretar al mismo tiempo, sencillamente introduzca
-una combinación simultánea de expresiones musicales.  Una expresión
-musical @q{simultánea} se forma encerrando las expresiones dentro de
-@code{<<} y @code{>>}.  En el ejemplo que sigue, tres secuencias (cada
-una de las cuales contiene dos notas diferentes) se combinan de forma
-simultánea:
-
-@lilypond[verbatim,quote]
-\relative c'' {
-  <<
-    { a4 g }
-    { f e }
-    { d b }
-  >>
-}
-@end lilypond
-
-Tenga en cuenta que hemos sangrado cada nivel jerárquico de la entrada
-con un margen distinto.  A LilyPond no le importa cuánto (o cuán poco)
-espacio haya al comienzo de una línea, pero el establecimiento de
-márgenes distintos dentro del código de LilyPond, de esta forma, lo
-hace mucho más fácil de leer por nosotros los seres humanos.
-
-@warning{cada nota se entiende relativa a la nota anterior de la
-entrada, no relativa a la @code{c''} dentro de la instrucción inicial
-@code{@bs{}\relative}.}
-
-
-@subheading Simultaneous music expressions: single staff
-
-Para determinar el número de pentagramas en una pieza, LilyPond
-examina el comienzo de la primera expresión.  Si hay una sola nota,
-hay un solo pentagrama; si hay una expresión simultánea, hay más de un
-pentagrama.  El siguiente ejemplo presenta una expresión compleja,
-pero dado que comienza con una sola nota, se dispone sobre un solo
-pentagrama.
-
-@lilypond[verbatim,quote]
-\relative c'' {
-  c2 <<c e>>
-  << { e f } { c <<b d>> } >>
-}
-@end lilypond
-
-@node Multiple staves
-@subsection Multiple staves
-
-@cindex varios pentagramas
-@cindex pentagramas, varios
-@cindex contexto
-@cindex contexto de notación
-@cindex notación, contexto de
-
-@funindex \new Staff
-@funindex new Staff
-@funindex Staff
-@funindex \new
-@funindex new
-@funindex Score
-@funindex Voice
-@funindex Lyrics
-@funindex ChordNames
-
-Como ya hemos visto en @ref{Music expressions explained}, los
-archivos de entrada para LilyPond se construyen a base de expresiones
-musicales.  Si la partitura comienza con expresiones musicales
-simultáneas, LilyPond crea varios pentagramas.  Sin embargo es más
-fácil ver lo que ocurre si creamos cada uno de los pentagramas de
-forma explícita.
-
-Para imprimir más de un pentagrama, cada fragmento de música que
-constituye un pentagrama se marca escribiendo @code{\new Staff} antes
-de él.  Estos elementos @code{Staff} se combinan después en paralelo
-con @code{<<} y @code{>>}:
-
-@lilypond[verbatim,quote]
-\relative c'' {
-  <<
-    \new Staff { \clef treble c }
-    \new Staff { \clef bass c,, }
-  >>
-}
-@end lilypond
-
-La instrucción @code{\new} inaugura un @q{contexto de notación}.  Un
-contexto de notación es un entorno dentro del que se interpretan los
-acontecimientos musicales (como las notas o las instrucciones
-@code{\clef}).  Para piezas sencillas, tales contextos de notación se
-crean automáticamente.  Para piezas más complicadas, es mejor marcar
-los contextos de forma explícita.
-
-Existen varias clases de contextos.  @code{Score}, @code{Staff} y
-@code{Voice} manejan la notación melódica, mientras que @code{Lyrics}
-se ocupa de los textos cantados y @code{ChordNames} imprime los
-nombres de los acordes.
-
-En términos de sintaxis, la anteposición de @code{\new} a una
-expresión musical crea una expresión musical mayor.  Es semejante al
-signo menos de las matemáticas.  La fórmula @math{(4+5)} es una
-expresión, por tanto @math{-(4+5)} es una expresión más amplia.
-
-Las indicaciones de compás escritas en un pentagrama afectan al resto
-de ellos, de forma predeterminada.  En cambio, la armadura de la
-tonalidad de un pentagrama @emph{no} afecta a los otros pentagramas.
-Este comportamiento predeterminado diferente es a causa de que las
-partituras con instrumentos transpositores son más comunes que las
-partituras polirrítmicas.
-
-@lilypond[verbatim,quote]
-\relative c'' {
-  <<
-    \new Staff { \clef treble \key d \major \time 3/4 c }
-    \new Staff { \clef bass c,, }
-  >>
-}
-@end lilypond
-
-@node Staff groups
-@subsection Staff groups
-
-@cindex sistema de piano
-@cindex piano, sistema de
-@cindex sistema de coro
-@cindex coro, sistema de
-@cindex grupo de pentagramas
-@cindex pentagramas, grupo de
-
-@funindex PianoStaff
-@funindex GrandStaff
-@funindex ChoirStaff
-
-Glosario musical:
-@rglos{brace}.
-
-La música para piano se compone tipográficamente en forma de dos
-pentagramas unidos mediante una @notation{llave}. El aspecto impreso
-de este sistema de pentagramas se parece al ejemplo polifónico que
-aparece en @ref{Multiple staves}, pero en esta ocasión la expresión
-completa se coloca dentro de un @code{PianoStaff}:
-
-@example
-\new PianoStaff <<
-  \new Staff @dots{}
-  \new Staff @dots{}
->>
-@end example
-
-He aquí un pequeño ejemplo:
-
-@lilypond[verbatim,quote]
-\relative c'' {
-  \new PianoStaff <<
-    \new Staff { \time 2/4 c4 e g g, }
-    \new Staff { \clef bass c,, c' e c }
-  >>
-}
-@end lilypond
-
-Otros grupos de pentagramas se declaran mediante @code{\new
-GrandStaff}, que es apropiado para partituras orquestales, y
-@code{\new ChoirStaff}, que es apropiado para partituras vocales.
-Cada uno de estos grupos de pautas forma un tipo de contexto distinto,
-que produce la llave a la izquierda y que también controla el alcance
-de las líneas divisorias.
-
-
-@seealso
-Referencia de la notación:
-@ruser{Keyboard and other multi-staff instruments},
-@ruser{Displaying staves}.
-
-
-@node Combining notes into chords
-@subsection Combining notes into chords
-
-@cindex acordes
-@cindex duraciones de notas en acordes
-
-@funindex <
-@funindex >
-@funindex < ... >
-
-Glosario musical:
-@rglos{chord}.
-
-Hemos visto con anterioridad cómo se pueden combinar las notas
-formando @notation{acordes} que indican que son simultáneas,
-encerrándolas entre dobles ángulos.  Sin embargo, la forma normal de
-indicar un acorde es encerrar las notas entre ángulos
-@emph{sencillos}.  Observe que todas las notas de un acorde deben
-tener la misma duración, y que la duración se escribe después del
-ángulo de cierre.
-
-
-@lilypond[verbatim,quote,relative=2]
-r4 <c e g>4 <c f a>2
-@end lilypond
-
-Debemos pensar en los acordes como algo casi equivalente a las notas
-sencillas: casi todo lo que se puede adjuntar a una nota se puede
-adjuntar también a un acorde, y todo debe ir @emph{por fuera} de los
-ángulos.  Por ejemplo, puede combinar marcas como barras y ligaduras,
-con acordes.  Tan sólo debe recordar que se escriben por fuera de los
-ángulos.
-
-@lilypond[verbatim,quote,relative=2]
-r4 <c e g>8[ <c f a>]~ <c f a>2
-r4 <c e g>8( <c e g>\> <c e g>4 <c f a>\!)
-@end lilypond
-
-
-@node Single staff polyphony
-@subsection Single staff polyphony
-
-@cindex polifonía
-@cindex varias voces
-@cindex voces, más, en un solo pentagrama
-@cindex único, polifonía en pentagrama
-@cindex separador, silencio
-@cindex silencio separador
-
-@funindex << ... \\ ... >>
-@funindex <<
-@funindex \\
-@funindex >>
-
-La música polifónica en LilyPond, aunque no es difícil, utiliza
-conceptos que aún no hemos tratado, por lo que no vamos a presentarlos
-en este momento.  En su lugar, las secciones siguientes presentan
-estos conceptos y los explican en profundidad.
-
-@seealso
-Manual de aprendizaje:
-@ref{Voices contain music}.
-
-Referencia de la notación:
-@ruser{Simultaneous notes}.
-
-
-@node Songs
-@section Songs
-
-En esta sección presentamos cómo elaborar música vocal y hojas de
-canción sencillas.
-
-@menu
-* Setting simple songs::
-* Aligning lyrics to a melody::
-* Lyrics to multiple staves::
-@end menu
-
-
-@node Setting simple songs
-@subsection Setting simple songs
-
-@cindex letra
-@cindex canciones
-
-@funindex \addlyrics
-@funindex addlyrics
-
-Glosario musical:
-@rglos{lyrics}.
-
-Presentamos a continuación el inicio de la melodía de una canción
-infantil, @qq{Girls and boys come out to play}:
-
-@lilypond[verbatim,quote]
-\relative c'' {
-  \key g \major
-  \time 6/8
-  d4 b8 c4 a8 d4 b8 g4
-}
-@end lilypond
-
-La @notation{letra} se puede asignar a esas notas, combinando ambas
-con la palabra clave @code{\addlyrics}.  La letra se escribe separando
-cada sílaba mediante un espacio.
-
-@lilypond[verbatim,quote]
-<<
-  \relative c'' {
-    \key g \major
-    \time 6/8
-    d4 b8 c4 a8 d4 b8 g4
-  }
-  \addlyrics {
-    Girls and boys come out to play,
-  }
->>
-@end lilypond
-
-Observe las llaves rodeando tanto la música como la letra, y los
-ángulos dobles @w{@code{<< ... >>}} alrededor del fragmento entero
-para expresar que la música y la letra han de suceder al mismo tiempo.
-
-@node Aligning lyrics to a melody
-@subsection Aligning lyrics to a melody
-
-@cindex melisma
-@cindex línea de extensión
-@cindex guión
-@cindex guión bajo
-@cindex letra, alineación de
-@cindex alineación de la letra
-@cindex letra, palabras polisílabas
-@cindex palabras polisílabas en la letra
-
-Glosario musical:
-@rglos{melisma},
-@rglos{extender line}.
-
-La siguiente línea de la canción infantil es @notation{The moon doth
-shine as bright as day}.  A continuación vamos a ampliarla:
-
-@lilypond[verbatim,quote]
-<<
-  \relative c'' {
-    \key g \major
-    \time 6/8
-    d4 b8 c4 a8 d4 b8 g4
-    g8 a4 b8 c b a d4 b8 g4.
-  }
-  \addlyrics {
-    Girls and boys come out to play,
-    The moon doth shine as bright as day;
-  }
->>
-@end lilypond
-
-Podemos observar que la letra adicional no se alinea correctamente con
-las notas.  La palabra @q{shine} se debe cantar sobre dos notas, no
-una.  Esto se conoce como @notation{melisma}, una sílaba única que se
-canta sobre más de una nota.  Existen varias formas de hacer que una
-sílaba recaiga sobre varias notas, siendo la más sencilla escribir una
-ligadura de expresión sobre ellas (véase @ref{Ties and slurs}):
-
-@lilypond[verbatim,quote]
-<<
-  \relative c'' {
-    \key g \major
-    \time 6/8
-    d4 b8 c4 a8 d4 b8 g4
-    g8 a4 b8 c( b) a d4 b8 g4.
-  }
-  \addlyrics {
-    Girls and boys come out to play,
-    The moon doth shine as bright as day;
-  }
->>
-@end lilypond
-
-Ahora la letra se alinea correctamente con las notas, pero el barrado
-automático de las notas que corresponden a @notation{shine as} no
-parece correcto.  Podemos remediarlo insertando instrucciones de
-barrado manual para sobreescribir el barrado automático; para ver más
-detalles consulte @ref{Automatic and manual beams}.
-
-@lilypond[verbatim,quote]
-<<
-  \relative c'' {
-    \key g \major
-    \time 6/8
-    d4 b8 c4 a8 d4 b8 g4
-    g8 a4 b8 c([ b]) a d4 b8 g4.
-  }
-  \addlyrics {
-    Girls and boys come out to play,
-    The moon doth shine as bright as day;
-  }
->>
-@end lilypond
-
-Como alternativa a la utilización de ligaduras de expresión, los
-melismas se pueden indicar solamente en la letra utilizando un guión
-bajo, @code{_}, para cada nota que queremos incluir dentro del
-melisma:
-
-@lilypond[verbatim,quote]
-<<
-  \relative c'' {
-    \key g \major
-    \time 6/8
-    d4 b8 c4 a8 d4 b8 g4
-    g8 a4 b8 c[ b] a d4 b8 g4.
-  }
-  \addlyrics {
-    Girls and boys come out to play,
-    The moon doth shine _ as bright as day;
-  }
->>
-@end lilypond
-
-Si una sílaba se extiende sobre varias notas o una sola nota muy
-larga, normalmente se traza una @notation{línea extensora} desde la
-sílaba que se extiende y por debajo de todas las notas que
-corresponden a dicha sílaba.  Se escribe como dos guiones bajos
-@code{__}.  He aquí un ejemplo extraído de los primeros tres compases
-del @notation{Lamento de Dido}, de @notation{Dido y Eneas} de Purcell:
-
-@lilypond[verbatim,quote]
-<<
-  \relative c'' {
-    \key g \minor
-    \time 3/2
-    g2 a bes bes( a)
-    b c4.( bes8 a4. g8 fis4.) g8 fis1
-  }
-  \addlyrics {
-    When I am laid,
-    am laid __ in earth,
-  }
->>
-@end lilypond
-
-Hasta el momento, ninguno de los ejemplos implicaban palabras que
-tuviesen más de una sílaba.  Estas palabras se reparten por lo general
-a razón de una nota por cada sílaba, con guiones cortos entre las
-sílabas.  Dichos guiones separadores se teclean como dos guiones, con
-el resultado de un guión corto centrado entre las sílabas.
-Presentamos a continuación un ejemplo que demuestra esto y todo lo que
-hemos aprendido hasta el momento acerca de la alineación de la letra a
-las notas.
-
-@c no ragged-right here because otherwise the hyphens get lost,
-@c but the example is long enough to avoid looking strange.
-@lilypond[verbatim,quote,noragged-right]
-<<
-  \relative c' {
-    \key g \major
-    \time 3/4
-    \partial 4
-    d4 g4 g a8( b) g4 g4
-    b8( c) d4 d e4 c2
-  }
-  \addlyrics {
-    A -- way in a __ man -- ger,
-    no __ crib for a bed, __
-  }
->>
-@end lilypond
-
-Algunos textos (especialmente los que están en italiano o en español)
-requieren lo contrario: colocar más de una sílaba a una única nota.
-Esto se consigue enlazando las sílabas entre sí mediante un guión bajo
-simple @code{_} (sin ningún espacio), o bien encerrándolas entre
-corchetes.  Aquí aparece un ejemplo procedente del @notation{Barbero
-de Sevilla} de Rossini, donde la sílaba @notation{al} se canta sobre
-la misma nota que la sílaba @notation{go} de la palabra @q{Largo} en
-el aria de Fígaro @notation{Largo al factotum}:
-
-@c no ragged-right here because otherwise the hyphens get lost,
-@c but the example is long enough to avoid looking strange.
-@lilypond[verbatim,quote,noragged-right]
-<<
-  \relative c' {
-    \clef bass
-    \key c \major
-    \time 6/8
-    c4.~ c8 d b c([ d]) b c d b c
-  }
-  \addlyrics {
-    Lar -- go_al fac -- to -- tum del -- la cit -- tà
-  }
->>
-@end lilypond
-
-
-@seealso
-Referencia de la notación:
-@ruser{Vocal music}.
-
-
-@node Lyrics to multiple staves
-@subsection Lyrics to multiple staves
-
-@cindex letra y varios pentagramas
-@cindex varios pentagramas y letra
-
-La solución sencilla que utiliza @code{\addlyrics} se puede usar para
-poner letra a más de un pentagrama.  Aquí aparece un ejemplo sacado
-del @notation{Judas Macabeo} de Haendel:
-
-@lilypond[verbatim,quote]
-<<
-  \relative c'' {
-    \key f \major
-    \time 6/8
-    \partial 8
-    c8 c([ bes]) a a([ g]) f f'4. b, c4.~ c4
-  }
-  \addlyrics {
-    Let flee -- cy flocks the hills a -- dorn, __
-  }
-  \relative c' {
-    \key f \major
-    \time 6/8
-    \partial 8
-    r8 r4. r4 c8 a'([ g]) f f([ e]) d e([ d]) c bes'4
-  }
-  \addlyrics {
-    Let flee -- cy flocks the hills a -- dorn,
-  }
->>
-@end lilypond
-
-
-Cualquier partitura de una complejidad mayor que la de este sencillo
-ejemplo se hace mejor separando la letra de la estructura de
-pentagramas mediante variables (expresiones con nombre).  Éstas se
-tratan en @ref{Organizing pieces with variables}.
-
-
-@seealso
-Referencia de la notación:
-@ruser{Vocal music}.
-
-
-@node Final touches
-@section Final touches
-
-Éste es el último apartado del tutorial; muestra la forma de dar los
-toques finales a piezas sencillas, y ofrece una introducción al resto
-del manual.
-
-@menu
-* Organizing pieces with variables::
-* Version number::
-* Adding titles::
-* Absolute note names::
-* After the tutorial::
-@end menu
-
-
-@node Organizing pieces with variables
-@subsection Organizing pieces with variables
-
-@cindex variables
-@cindex variables, definir
-@cindex identificadores
-@cindex macros
-@cindex asignación de variables
-@cindex uso de las variables
-@cindex variables, uso de
-@cindex variables, caracteres permitidos en
-@cindex caracteres permitidos en variables
-
-Cuando los elementos que hemos discutido anteriormente se combinan
-para producir archivos mayores, las expresiones musicales se hacen
-enormes.  En música polifónica con muchos pentagramas, los archivos de
-entrada pueden volverse muy propensos a la confusión.  Podemos reducir
-esta confusión utilizando las @emph{variables}.
-
-Con las variables (también conocidas como identificadores o macros),
-podemos trocear las expresiones musicales complejas.  Una variable se
-asigna de la manera siguiente:
-
-@example
-musicaConNombre = @{ @dots{} @}
-@end example
-
-El contenido de la expresión musical @code{musicaConNombre} se puede usar
-posteriormente colocando una barra invertida delante del nombre
-(@code{\musicaConNombre}, igual que una orden normal de LilyPond).
-
-@lilypond[verbatim,quote]
-violin = \new Staff {
-  \relative c'' {
-    a4 b c b
-  }
-}
-cello = \new Staff {
-  \relative c {
-    \clef bass
-    e2 d
-  }
-}
-{
-  <<
-    \violin
-    \cello
-  >>
-}
-@end lilypond
-
-
-@noindent
-El nombre de una variable debe consistir enteramente en caracteres
-alfabéticos, es decir sin números, guiones ni guiones bajos.
-
-Las variables se deben definir @emph{antes} de la expresión musical
-principal, pero se pueden usar tantas veces como se quiera, en
-cualquier lugar, una vez que han sido definidas.  Incluso se pueden
-usar dentro de la definición de otra variable, proporcionando una vía
-para acortar el código si una sección musical se repite muchas veces.
-
-@c KEEP LY
-@lilypond[verbatim,quote,ragged-right]
-tresilloA = \times 2/3 { c,8 e g }
-compasA = { \tresilloA \tresilloA \tresilloA \tresilloA }
-
-\relative c'' {
- \compasA \compasA
-}
-@end lilypond
-
-Las variables se pueden usar para otros muchos tipos de objetos dentro
-del código de entrada.  Por ejemplo,
-
-@example
-ancho = 4.5\cm
-nombre = "Wendy"
-papelAcinco = \paper @{ paperheight = 21.0 \cm @}
-@end example
-
-Dependiendo de su contenido, la variable se puede usar en distintos
-lugares.  El siguiente ejemplo utiliza las variables anteriores:
-
-@example
-\paper @{
-  \papelAcinco
-  line-width = \ancho
-@}
-@{
-  c4^\nombre
-@}
-@end example
-
-
-@node Version number
-@subsection Version number
-
-@cindex versión
-@cindex versión, indicación de
-@cindex versión, número de
-@cindex actualizaciones
-@cindex futuras, actualizaciones
-@cindex actualizar archivos
-@cindex archivos, actualización de
-
-@funindex \version
-@funindex version
-@funindex convert-ly
-
-La indicación @code{\version} deja registrado para qué versión de
-LilyPond se escribió el archivo:
-
-@example
-\version @w{"@version{}"}
-@end example
-
-@noindent
-por convenio se sitúa al principio del archivo de partitura de
-LilyPond.
-
-Estas anotaciones hacen menos problemáticas las subsiguientes
-actualizaciones de LilyPond.  Los cambios en la sintaxis se tratan
-mediante un programa especial, @command{convert-ly}, y utiliza
-@code{\version} para determinar qué reglas hay que aplicar.  Para ver
-más detalles, consulte @rprogram{Updating files with convert-ly}).
-
-
-@node Adding titles
-@subsection Adding titles
-
-@cindex título
-@cindex cabeceras
-@cindex bloque de cabeceras
-
-@funindex \header
-@funindex header
-
-La información sobre el título, autor, número de Opus y similares se
-escriben en el bloque @code{\header}.  Éste se encuentra fuera de la
-expresión musical principal; el bloque @code{\header} normalmente se
-sitúa por debajo del número de versión.
-
-@example
-\version @w{"@version{}"}
-\header @{
-  title = "Sinfonía"
-  composer = "Yo"
-  opus = "Op. 9"
-@}
-
-@{
-  @dots{} música @dots{}
-@}
-@end example
-
-Cuando se procesa el archivo, el título y el autor se imprimen por
-encima de la música.  Puede obtener más información sobre los títulos
-en @ruser{Creating titles}.
-
-
-@node Absolute note names
-@subsection Absolute note names
-
-@cindex notas, nombres de
-@cindex notas, nombres absolutos de
-@cindex absoluto, modo
-@cindex absolutos, valores de altura
-@cindex alturas, valores absolutos de
-@cindex absolutos, nombres de nota
-
-Hasta el momento siempre hemos utilizado @code{\relative} para definir
-las alturas.  Ésta es la forma más sencilla de escribir la mayor parte
-de la música, pero existe otra forma de definir las alturas: el modo
-absoluto.
-
-Si omite el @code{\relative}, LilyPond tratará todas las alturas como
-valores absolutos.  Una @code{c'} significará siembre un Do central,
-una @code{b} significará siempre la nota inmediatamente por debajo del
-Do central, y una @code{g,} significará siempre la nota que se coloca
-en la primera línea del pentagrama en clave de Fa.
-
-@lilypond[verbatim,quote]
-{
-  \clef bass
-  c' b g, g,
-  g, f, f c'
-}
-@end lilypond
-
-He aquí una escala que abarca cuatro octavas:
-
-@lilypond[verbatim,quote]
-{
-  \clef bass
-  c, d, e, f,
-  g, a, b, c
-  d e f g
-  a b c' d'
-  \clef treble
-  e' f' g' a'
-  b' c'' d'' e''
-  f'' g'' a'' b''
-  c'''1
-}
-@end lilypond
-
-Como puede ver, escribir una melodía en clave de Sol implica escribir
-gran cantidad de apóstrofos @q{'} .  Consideremos este fragmento de
-Mozart:
-
-@lilypond[verbatim,quote]
-{
-  \key a \major
-  \time 6/8
-  cis''8. d''16 cis''8 e''4 e''8
-  b'8. cis''16 b'8 d''4 d''8
-}
-@end lilypond
-
-Todos estos apóstrofos hacen casi ilegible el código de entrada y será
-origen de numerosos errores.  Con @code{\relative}, el ejemplo
-anterior es mucho más fácil de leer:
-
-@lilypond[verbatim,quote]
-\relative c'' {
-  \key a \major
-  \time 6/8
-  cis8. d16 cis8 e4 e8
-  b8. cis16 b8 d4 d8
-}
-@end lilypond
-
-Si comete un error con una marca de octava (@code{'} o @code{,})
-mientras trabaja en el modo @code{\relative}, será muy obvio (muchas
-notas estarán en la octava equivocada).  Mientras trabaja en el modo
-absoluto, un solo fallo no será tan visible, y tampoco será tan fácil
-de localizar.
-
-Sin embargo, el modo absoluto es útil para escribir música que
-contenga intervalos grandes, y será extremadamente útil para hacer
-archivos de LilyPond generados por ordenador.
-
-
-@node After the tutorial
-@subsection After the tutorial
-
-Después de terminar el tutorial, quizá debería probar a escribir una o
-dos piezas.  Comience con una de las plantillas que aparecen en
-@ref{Templates} y añada algunas notas.  Si necesita un tipo de
-notación que no ha sido tratada en el tutorial, eche un vistazo a la
-Referencia de Notación, empezando por @ruser{Musical notation}.  Si
-quiere escribir música para un conjunto instrumental que no está
-cubierto por ninguna plantilla, consulte @ref{Extending the
-templates}.
-
-Una vez que ha escrito algunas piezas cortas, lea el resto del Manual
-de aprendizaje (capítulos 3 al 5).  ¡Por supuesto, no pasa nada por
-leerlo ahora mismo!  Sin embargo, el resto del Manual de Aprendizaje
-da por sentado que está familiarizado con la entrada de LilyPond.
-Puede saltarse estos capítulos ahora y volver a ellos cuando haya
-adquirido más experiencia.
-
-En este tutorial y en el resto del Manual de aprendizaje, existe un
-apartado @strong{Véase también} al final de cada una de las secciones,
-que contiene referencias cruzadas a otras secciones: no siga estas
-referencias durante la primera lectura; cuando haya leído el Manual de
-aprendizaje completo, quizá desee releer ciertas secciones y seguir
-las referencias cruzadas para obtener más información.
-
-Si no lo ha hecho aún, le @emph{rogamos} que lea @ref{About the
-documentation}.  Existe una gran cantidad de información sobre
-LilyPond, de manera que los recién llegados con frecuencia no saben
-exactamente dónde deben buscar la ayuda.  Si emplea cinco minutos en
-leer cuidadosamente esta sección ¡se ahorrará horas de frustración
-buscando en el sitio equivocado!
+@end itemize