lilypond-book robustness: ensure EOL at the end of @verbatim

[lilypond.git] / Documentation / es / user / vocal.itely

diff --git a/Documentation/es/user/vocal.itely b/Documentation/es/user/vocal.itely
index 015e4a1cad127ea0adad3d91460182508e5b1c2a..d2b1032b1fca5beda978acfb9129199e5294d022 100644 (file)
--- a/Documentation/es/user/vocal.itely
+++ b/Documentation/es/user/vocal.itely
@@ -1,128 +1,170 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
 @c This file is part of lilypond.tely
 @ignore
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
 @c This file is part of lilypond.tely
 @ignore

-    Translation of GIT committish: 2ac76a5b0a5572cb259f22751764acfe431bfff2
+    Translation of GIT committish: d4f58bb3ad4e7fe1967a6b48f25e3addffc8aa14

 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  See TRANSLATION for details.
 @end ignore
 
 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  See TRANSLATION for details.
 @end ignore
 

-@c \version "2.11.51"
+@c \version "2.12.0"

 
 
 @node Vocal music
 @section Vocal music
 
 
 
 @node Vocal music
 @section Vocal music
 

-Puesto que los archivos de entrada de LilyPond son de texto, hay un
-par de cuestiones dignas de consideración cuando se trabaja con música
-vocal:
+@c TODO: inspirational headword
+
+Esta sección explica cómo tipografiar música vocal, y cómo asegurarse
+de que la letra se alinea con las notas de su melodía correspondiente.
+
+@menu
+* Common notation for vocal music::
+* Entering lyrics::
+* Aligning lyrics to a melody::
+* Specific uses of lyrics::
+* Stanzas::
+@end menu
+
+
+@node Common notation for vocal music
+@subsection Common notation for vocal music
+
+Esta sección trata sobre asuntos relacionados con la música vocal en
+general y con ciertos estilos concretos de música vocal.
+
+
+@menu
+* References for vocal music and lyrics::
+* Opera::
+* Song books::
+* Spoken music::
+* Chants::
+* Ancient vocal music::
+@end menu
+
+
+@node References for vocal music and lyrics
+@unnumberedsubsubsec References for vocal music and lyrics
+
+@c TODO: split this section in two parts? -vv
+
+Pueden surgir varias cuestiones al tipografiar música vocal.  Algunas
+se discuten en esta sección, pero otras están tratadas en otros
+lugares del manual:

 
 @itemize
 @item
 
 @itemize
 @item

-Los textos de las canciones se deben introducir como texto, no como
-notas.  Por ejemplo, la entrada@tie{}@code{d} se debe interpretar como
-una sílaba de una sola letra, no como la nota@tie{}Re.
+Casi todos los estilos de música vocal utilizan texto escrito como
+letra.  Hay una introducción a esta notación en @rlearning{Setting
+simple songs}.
+
+@item
+La música vocal probablemente requiere el uso del modo de marcado o
+@code{markup}, ya sea para la letra o para otros elementos de texto
+(nombres de los personajes, etc.).  Esta sintaxis está descrita en
+@ref{Text markup introduction}.
+
+@item
+Las hojas guía de acordes o @emph{Lead sheets} se pueden imprimir
+combinando partes vocales y el @q{modo de acordes}; esta sintaxis se
+explica en @ref{Chord notation}.
+
+@item
+Los @q{ambitus} o indicaciones de tesitura vocal se pueden añadir al
+principio de los pentagramas vocales, como se explica en
+@ref{Ambitus}.

 
 @item
 
 @item

-Los textos de las canciones se deben alinear con las notas respectivas
-de la melodía.
+Las partes vocales se pueden imprimir utilizando las claves
+tradicionales, como se muestra en @ref{Clef}.
+
+@item
+Está contemplada la música vocal en estilo de notación antiguo, como
+se explica en @ref{Ancient notation}.

 @end itemize
 
 @end itemize
 

-Existen varias formas diferentes de definir la letra; comenzaremos
-examinando el método más simple, y poco a poco iremos aumentando la
-complejidad.

 
 

-@menu
-* Common notation for vocals::  
-* Aligning lyrics to a melody::  
-* Placement of lyrics::         
-* Stanzas::                     
-@end menu
+@node Opera
+@unnumberedsubsubsec Opera

 
 

+@c TODO
+Continuará...

 
 

-@snippets
+@c add characters names snippet -vv

 
 

-Las comprobaciones que aseguran que las indicaciones textuales y las
-letras se encuentran dentro de los márgenes es una tarea computacional
-relativamente grande.  Para acelerar el procesado, lilypond no realiza
-estos cálculos por defecto; para activarlos, utilice
+@node Song books
+@unnumberedsubsubsec Song books

 
 

-@example
-\override Score.PaperColumn #'keep-inside-line = ##t
-@end example
+@c TODO
+Continuará...

 
 

-Para hacer que la letra evite las líneas divisorias también, utilice
+@snippets
+@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
+{simple-lead-sheet.ly}

 
 

-@example
-\layout @{
-  \context @{
-    \Lyrics
-      \consists "Bar_engraver"
-      \consists "Separating_line_group_engraver"
-      \override BarLine #'transparent = ##t
-  @}
-@}
-@end example

 
 

-@node Common notation for vocals
-@subsection Common notation for vocals
+@seealso
+Referencia de la notación:
+@ref{Chord notation}.

 
 

-@menu
-* References for vocal music::  
-* Setting simple songs::        
-* Entering lyrics::             
-* Working with lyrics and variables::  
-@end menu

 
 

-@node References for vocal music
-@subsubsection References for vocal music
+@node Spoken music
+@unnumberedsubsubsec Spoken music
+
+@cindex parlato
+@cindex Sprechgesang

 
 @c TODO Add @refs
 
 
 @c TODO Add @refs
 

-@q{Parlato} es texto hablado sin notas pero con ritmo; su notación se
-realiza mediante cabezas de nota en forma de cruz.  Esto queda demostrado en
-@ref{Special note heads}.
+Los efectos como el @q{parlato} o el @q{Sprechgesang} requieren de los
+intérpretes que hablen sin altura determinada pero con su ritmo; su
+notación se realiza mediante cabezas de nota en forma de aspas, como
+se muestra en @ref{Special note heads}.

 
 

+@c TODO add "marking-notes-on-spoken-parts" snippet -vv
+@c add "showing the rhythm of a melody" snip
+@c add "one staff-line notation"
+@c add "improvisation" ref
+@c add "lyrics independents of notes" ref

 
 

-@node Setting simple songs
-@subsubsection Setting simple songs

 
 

-@cindex \addlyrics
+@node Chants
+@unnumberedsubsubsec Chants

 
 

-La manera más fácil de poner letra a una melodía es añadir
+@c TODO Add text from lsr and -user
+Continuará...

 
 

-@example
-\addlyrics @{ @var{la letra} @}
-@end example

 
 

-@noindent
-a la melodía.  He aquí un ejemplo:
+@node Ancient vocal music
+@unnumberedsubsubsec Ancient vocal music

 
 

-@lilypond[ragged-right,verbatim,fragment,quote]
-\time 3/4
-\relative c' { c2 e4 g2. }
-\addlyrics { play the game }
-@end lilypond
+@c TODO
+Continuará...

 
 

-Se pueden añadir más versos mediante la adición de más secciones
-@code{\addlyrics}
+@c Add "Printing both the ancient and the modern clef in vocal music" snippet,
+@c and "Transcription of Ancient music with incipit" snippet. -vv

 
 

-@lilypond[ragged-right,verbatim,fragment,quote]
-\time 3/4
-\relative c' { c2 e4 g2. }
-\addlyrics { play the game }
-\addlyrics { speel het spel }
-\addlyrics { joue le jeu }
-@end lilypond
-
-La instrucción @code{\addlyrics} no puede manejar situaciones de
-polifonía.  Para estos casos tendrá que usar @code{\lyricsto} y
-@code{\lyricmode}, tal y como se explicará en @ref{Entering lyrics}.

 
 

+@seealso
+Referencia de la notación:
+@ref{Ancient notation}.

 
 
 @node Entering lyrics
 
 
 @node Entering lyrics

-@subsubsection Entering lyrics
+@subsection Entering lyrics
+
+@c TODO add one sentence here. -vv
+
+@menu
+* Lyrics explained::
+* Setting simple songs::
+* Working with lyrics and variables::
+@end menu
+
+
+@node Lyrics explained
+@unnumberedsubsubsec Lyrics explained

 
 @cindex letra
 @funindex \lyricmode
 
 @cindex letra
 @funindex \lyricmode


@@ -130,6 +172,15 @@ polifonía.  Para estos casos tendrá que usar @code{\lyricsto} y
 @cindex espacios, en la letra
 @cindex comillas, en la letra
 
 @cindex espacios, en la letra
 @cindex comillas, en la letra
 

+@c FIXME: this section is to be rewritten.
+Dado que los archivos de entrada de LilyPond son de texto, existe al
+menos un asunto que tener en cuenta al trabajar con música vocal: los
+textos de las canciones se deben interpretar como texto, no como
+notas.  Por ejemplo, la entrada@tie{}@code{d} debe interpretarse como
+una sílaba de una sola letra, no como la nota@tie{}Re.  Por tanto se
+hace necesario utilizar un modo especial para la letra, ya sea
+explícitamente o mediante el uso de métodos abreviados.
+

 La letra de las canciones se introduce en un modo de entrada especial
 que se inicia mediante la palabra clave @code{\lyricmode}, o bien
 mediante @code{\addlyrics} ó @code{\lyricsto}.  En este modo puede
 La letra de las canciones se introduce en un modo de entrada especial
 que se inicia mediante la palabra clave @code{\lyricmode}, o bien
 mediante @code{\addlyrics} ó @code{\lyricsto}.  En este modo puede


@@ -243,6 +294,8 @@ código ASCII por encima del 127, o una combinación de dos caracteres
 consistente en la combinación de una barra invertida seguida por
 @code{`}, @code{'}, @code{"} ó @code{^}.
 
 consistente en la combinación de una barra invertida seguida por
 @code{`}, @code{'}, @code{"} ó @code{^}.
 

+@c " to balance double quotes for not-so-bright context-sensitive editors
+

 Para definir identificadores que contengan letra, se debe usar la
 función @code{lyricmode}.
 
 Para definir identificadores que contengan letra, se debe usar la
 función @code{lyricmode}.
 


@@ -262,12 +315,53 @@ verseOne = \lyricmode @{ Joy to the world the Lord is come @}
 
 
 @seealso
 
 
 @seealso

+Referencia de la notación:
+@ref{Fonts}.

 
 

-Referencia de funcionamiento interno: @rinternals{LyricText},
+Referencia de funcionamiento interno:
+@rinternals{LyricText},

 @rinternals{LyricSpace}.
 
 @rinternals{LyricSpace}.
 

+
+@c FIXME: this title has to be changed (possible confusion with LM) -vv
+@node Setting simple songs
+@unnumberedsubsubsec Setting simple songs
+
+@cindex \addlyrics
+
+La manera más fácil de poner letra a una melodía es añadir
+
+@example
+\addlyrics @{ @var{la letra} @}
+@end example
+
+@noindent
+a la melodía.  He aquí un ejemplo:
+
+@lilypond[ragged-right,verbatim,fragment,quote]
+\time 3/4
+\relative c' { c2 e4 g2. }
+\addlyrics { play the game }
+@end lilypond
+
+Se pueden añadir más versos mediante la adición de más secciones
+@code{\addlyrics}
+
+@lilypond[ragged-right,verbatim,fragment,quote]
+\time 3/4
+\relative c' { c2 e4 g2. }
+\addlyrics { play the game }
+\addlyrics { speel het spel }
+\addlyrics { joue le jeu }
+@end lilypond
+
+La instrucción @code{\addlyrics} no puede manejar situaciones de
+polifonía.  Para estos casos tendrá que usar @code{\lyricsto} y
+@code{\lyricmode}, tal y como se explicará en @ref{Lyrics explained}.
+
+

 @node Working with lyrics and variables
 @node Working with lyrics and variables

-@subsubsection Working with lyrics and variables
+@unnumberedsubsubsec Working with lyrics and variables

 
 @cindex letra, identificadores de
 
 
 @cindex letra, identificadores de
 


@@ -275,7 +369,7 @@ Para definir identificadores que contengan texto, se debe usar la
 función @code{\lyricmode}.  Si embargo no tendrá que escribir las
 duraciones, si añade @code{\addlyrics} o @code{\lyricsto} en el
 momento de invocar el identificador.
 función @code{\lyricmode}.  Si embargo no tendrá que escribir las
 duraciones, si añade @code{\addlyrics} o @code{\lyricsto} en el
 momento de invocar el identificador.

- 
+

 @example
 verseOne = \lyricmode @{ Joy to the world the Lord is come @}
 \score @{
 @example
 verseOne = \lyricmode @{ Joy to the world the Lord is come @}
 \score @{


@@ -289,7 +383,7 @@ verseOne = \lyricmode @{ Joy to the world the Lord is come @}
  >>
 @}
 @end example
  >>
 @}
 @end example

- 
+

 Para arreglos distintos o más complejos, la mejor forma es preparar
 previamente la jerarquía de pautas y textos, p.ej.:
 @example
 Para arreglos distintos o más complejos, la mejor forma es preparar
 previamente la jerarquía de pautas y textos, p.ej.:
 @example


@@ -300,18 +394,18 @@ previamente la jerarquía de pautas y textos, p.ej.:
   \new Voice = "tenor" @{ @emph{música} @}
 >>
 @end example
   \new Voice = "tenor" @{ @emph{música} @}
 >>
 @end example

- 
+

 y después combinar las melodías y líneas de texto correspondientes:
 y después combinar las melodías y líneas de texto correspondientes:

- 
+

 @example
 \context Lyrics = textoSoprano \lyricsto "soprano"
 @emph{el texto}
 @end example
 @example
 \context Lyrics = textoSoprano \lyricsto "soprano"
 @emph{el texto}
 @end example

- 
+

 @noindent
 
 El código de entrada definitivo sería algo como
 @noindent
 
 El código de entrada definitivo sería algo como

- 
+

 @example
 <<\new ChoirStaff << @emph{prepare la música} >>
  \lyricsto "soprano" @emph{etc}
 @example
 <<\new ChoirStaff << @emph{prepare la música} >>
  \lyricsto "soprano" @emph{etc}


@@ -319,12 +413,14 @@ El código de entrada definitivo sería algo como
 @emph{etc}
 >>
 @end example
 @emph{etc}
 >>
 @end example

- 
+
+

 @seealso
 @seealso

- 

 @c TODO: document \new Staff << Voice \lyricsto >> bug
 Referencia de funcionamiento interno:
 @c TODO: document \new Staff << Voice \lyricsto >> bug
 Referencia de funcionamiento interno:

-@rinternals{LyricCombineMusic}, @rinternals{Lyrics}.
+@rinternals{LyricCombineMusic},
+@rinternals{Lyrics}.
+

 
 
 @node Aligning lyrics to a melody
 
 
 @node Aligning lyrics to a melody


@@ -334,6 +430,11 @@ Referencia de funcionamiento interno:
 @funindex \addlyrics
 @funindex \lyricsto
 
 @funindex \addlyrics
 @funindex \lyricsto
 

+La alineación del texto con las melodías se puede hacer
+automáticamente, pero si especificamos las duraciones de las sílabas
+también puede hacerse de forma manual.  La alineación y el
+tipografiado de la letra se preparan con la ayuda de saltos o
+@i{skips}, guiones y líneas extensoras.

 
 La letra se imprime a través de su interpretación dentro del contexto
 llamado @rinternals{Lyrics}.
 
 La letra se imprime a través de su interpretación dentro del contexto
 llamado @rinternals{Lyrics}.


@@ -355,18 +456,25 @@ o especificando la duración de cada sílaba explícitamente, utilizando
 @code{\lyricmode}
 @end itemize
 
 @code{\lyricmode}
 @end itemize
 

+El contexto @code{Voice} que contiene la melodía con la que se está
+alineando la letra no debe haber @qq{muerto}, o se perderá la letra
+después de ese punto.  Esto puede ocurrir si existen períodos en los
+que dicha voz no tiene nada que hacer.  Para ver métodos de mantener
+vivos los contextos, consulte @ref{Keeping contexts alive}.
+
+

 @menu
 @menu

-* Automatic syllable durations::  
-* Manual syllable durations::   
-* Multiple syllables to one note::  
-* Multiple notes to one syllable::  
-* Skipping notes::              
-* Extenders and hyphens::       
-* Lyrics and repeats::          
+* Automatic syllable durations::
+* Manual syllable durations::
+* Multiple syllables to one note::
+* Multiple notes to one syllable::
+* Skipping notes::
+* Extenders and hyphens::
+* Lyrics and repeats::

 @end menu
 
 @node Automatic syllable durations
 @end menu
 
 @node Automatic syllable durations

-@subsubsection Automatic syllable durations
+@unnumberedsubsubsec Automatic syllable durations

 
 @cindex duraciones automáticas de las sílabas
 @cindex letra y melodías
 
 @cindex duraciones automáticas de las sílabas
 @cindex letra y melodías


@@ -396,8 +504,14 @@ letra.
     \time 2/4
     c4 b8. a16 g4. f8 e4 d c2
   }
     \time 2/4
     c4 b8. a16 g4. f8 e4 d c2
   }

+
+% not recommended: left aligns syllables

   \new Lyrics \lyricmode { Joy4 to8. the16 world!4. the8 Lord4 is come.2 }
   \new Lyrics \lyricmode { Joy4 to8. the16 world!4. the8 Lord4 is come.2 }

+
+% wrong: durations needed

   \new Lyrics \lyricmode { Joy to the earth! the Sa -- viour reigns. }
   \new Lyrics \lyricmode { Joy to the earth! the Sa -- viour reigns. }

+
+%correct

   \new Lyrics \lyricsto "one" { No more let sins and sor -- rows grow. }
 >>
 @end lilypond
   \new Lyrics \lyricsto "one" { No more let sins and sor -- rows grow. }
 >>
 @end lilypond


@@ -423,13 +537,13 @@ es lo mismo que
 @end example
 
 @node Manual syllable durations
 @end example
 
 @node Manual syllable durations

-@subsubsection Manual syllable durations
+@unnumberedsubsubsec Manual syllable durations

 
 El texto también se puede introducir sin @code{\addlyrics} ni
 @code{\lyricsto}.  En este caso, las sílabas se escriben como notas
 (pero con las alturas sustituidas por texto) y la duración de cada
 sílaba se debe escribir explícitamente.  Por ejemplo:
 
 El texto también se puede introducir sin @code{\addlyrics} ni
 @code{\lyricsto}.  En este caso, las sílabas se escriben como notas
 (pero con las alturas sustituidas por texto) y la duración de cada
 sílaba se debe escribir explícitamente.  Por ejemplo:

- 
+

 @example
 play2 the4 game2.
 sink2 or4 swim2.
 @example
 play2 the4 game2.
 sink2 or4 swim2.


@@ -437,7 +551,7 @@ sink2 or4 swim2.
 
 La alineación respecto de una melodía se puede especificar con la
 propiedad @code{associatedVoice},
 
 La alineación respecto de una melodía se puede especificar con la
 propiedad @code{associatedVoice},

- 
+

 @example
 \set associatedVoice = #"lala"
 @end example
 @example
 \set associatedVoice = #"lala"
 @end example


@@ -446,7 +560,7 @@ propiedad @code{associatedVoice},
 El valor de la propiedad (aquí: @code{"lala"}) ha de ser el nombre de
 un contexto de @rinternals{Voice}.  Sin este ajuste, las líneas de
 extensión no se formatearán correctamente.
 El valor de la propiedad (aquí: @code{"lala"}) ha de ser el nombre de
 un contexto de @rinternals{Voice}.  Sin este ajuste, las líneas de
 extensión no se formatearán correctamente.

- 
+

 Presentamos a continuación un ejemplo que muestra el uso de las
 duraciones manuales de las sílabas del texto:
 
 Presentamos a continuación un ejemplo que muestra el uso de las
 duraciones manuales de las sílabas del texto:
 


@@ -461,14 +575,17 @@ duraciones manuales de las sílabas del texto:
  } >>
 @end lilypond
 
  } >>
 @end lilypond
 

+

 @seealso
 @seealso

+Referencia de la notación:
+@ref{Keeping contexts alive}.

 
 

-Referencia de funcionamiento interno: @rinternals{Lyrics}.
+Referencia de funcionamiento interno:
+@rinternals{Lyrics}.

 
 
 @node Multiple syllables to one note
 
 
 @node Multiple syllables to one note

-@subsubsection Multiple syllables to one note
-
+@unnumberedsubsubsec Multiple syllables to one note

 
 @funindex _
 @cindex ligaduras, en el texto
 
 @funindex _
 @cindex ligaduras, en el texto


@@ -489,8 +606,8 @@ DejaVuLGC) que incluya este glifo.}.
 \addlyrics { pu- ro~y~ho- nes- to }
 @end lilypond
 
 \addlyrics { pu- ro~y~ho- nes- to }
 @end lilypond
 

-@seealso

 
 

+@seealso

 Referencia de funcionamiento interno: @rinternals{LyricCombineMusic}.
 
 @c Here come the section which used to be "Melismata"
 Referencia de funcionamiento interno: @rinternals{LyricCombineMusic}.
 
 @c Here come the section which used to be "Melismata"


@@ -498,7 +615,7 @@ Referencia de funcionamiento interno: @rinternals{LyricCombineMusic}.
 
 
 @node Multiple notes to one syllable
 
 
 @node Multiple notes to one syllable

-@subsubsection Multiple notes to one syllable
+@unnumberedsubsubsec Multiple notes to one syllable

 
 @cindex melisma
 @cindex melismata
 
 @cindex melisma
 @cindex melismata


@@ -511,10 +628,24 @@ melismas, o melismata.
 @c this method seems to be the simplest; therefore
 @c it might be better to present it first - vv
 
 @c this method seems to be the simplest; therefore
 @c it might be better to present it first - vv
 

-Puede definir los melismas completamente dentro de la letra,
-escribiendo un guión bajo @code{_} para cada nota que forma parte del
-melisma.
+Podemos definir los melismas completamente dentro de la letra,
+escribiendo un guión bajo @code{_} por cada nota que se quiere añadir
+al melisma.
+
+@c FIXME: clarify: __ is used to crate a lyric extender,
+@c _ is used to add a note to a melisma, so both __ and _ are needed.
+
+@c verbose! --FV
+@c duplicated: TODO fix
+Además, podemos hacer que se imprima una línea extensora para indicar
+el melisma en la partitura, escribiendo un doble guión bajo junto a la
+primera sílaba del melisma. Este ejemplo presenta los tres elementos
+que se usan con este fin (todos ellos circundados por espacios):
+guiones dobles para separar las sílabas de una palabra, guiones bajos
+para añadir notas al melisma, y un doble guión bajo para poner una
+línea extensora.

 
 

+@c wrong: extender line only on last syllable of a word. Change example

 @lilypond[relative=1,verbatim,fragment,quote]
 { \set melismaBusyProperties = #'()
  c d( e) f f( e) e e  }
 @lilypond[relative=1,verbatim,fragment,quote]
 { \set melismaBusyProperties = #'()
  c d( e) f f( e) e e  }


@@ -522,9 +653,9 @@ melisma.
  { Ky -- _ _ ri __ _ _ _  e }
 @end lilypond
 
  { Ky -- _ _ ri __ _ _ _  e }
 @end lilypond
 

-En este caso, también puede tener ligaduras de unión y de expresión en
-la melodía, si establece @code{melismaBusyProperties}, como se hizo en
-el ejemplo anterior.
+En este caso también podemos tener ligaduras de unión y de expresión
+en la melodía, si establecemos @code{melismaBusyProperties}, como se
+hizo en el ejemplo anterior.

 
 Sin embargo la instrucción @code{\lyricsto} también puede detectar los
 melismas automáticamente: sólo pone una sílaba debajo de un grupo de
 
 Sin embargo la instrucción @code{\lyricsto} también puede detectar los
 melismas automáticamente: sólo pone una sílaba debajo de un grupo de


@@ -553,8 +684,7 @@ Además, las notas se consideran un melisma si están unidas manualmente
 mediante una barra, y el barrado automático (véase @ref{Setting
 automatic beam behavior}) está desactivado.
 
 mediante una barra, y el barrado automático (véase @ref{Setting
 automatic beam behavior}) está desactivado.
 

-@c TODO: there might be some more relevant place for 
-@c the following link (?)
+@c FIXME: this now links to LM -vv

 
 @cindex SATB
 @cindex coral, partitura
 
 @cindex SATB
 @cindex coral, partitura


@@ -564,16 +694,16 @@ sección @rlearning{Vocal ensembles}.
 
 
 @predefined
 
 
 @predefined

-
+@funindex \melisma

 @code{\melisma},
 @code{\melisma},

-@code{\melismaEnd}

 @funindex \melismaEnd
 @funindex \melismaEnd

-@funindex \melisma
+@code{\melismaEnd}.
+@endpredefined
+

 
 @seealso
 
 @seealso

+@c @lsr{vocal,lyric@/-combine.ly}.

 
 

-@comment  Referencia de funcionamiento interno:
-@comment  @rinternals{Melisma_translator}.

 
 @knownissues
 
 
 @knownissues
 


@@ -581,15 +711,31 @@ Los melismas no se detectan automáticamente, y las líneas de extensión
 se deben insertar a mano.
 
 @node Skipping notes
 se deben insertar a mano.
 
 @node Skipping notes

-@subsubsection Skipping notes
+@unnumberedsubsubsec Skipping notes
+
+Se puede conseguir que una línea de letra progrese más lentamente que
+la melodía, mediante la inserción de desplazamientos o @code{\skip}s
+en la letra.  Por cada @code{\skip}, el texto se retrasa en una nota.
+La instrucción @code{\skip} debe ir seguida de una duración válida,
+pero esta duración se ignora cuando se usa @code{\skip} en las letras.
+
+Por ejemplo,
+
+@lilypond[verbatim,ragged-right,quote]
+\relative c' { c c g' }
+\addlyrics {
+  twin -- \skip 4
+  kle
+}
+@end lilypond

 
 

-@untranslated

 
 @node Extenders and hyphens
 
 @node Extenders and hyphens

-@subsubsection Extenders and hyphens
+@unnumberedsubsubsec Extenders and hyphens

 
 @cindex melisma
 
 @cindex melisma

-@cindex extender
+@cindex extensora, línea
+@cindex línea de extensión

 
 @c leave this as samp. -gp
 Los melismas se indican mediante una línea horizontal centrada entre
 
 @c leave this as samp. -gp
 Los melismas se indican mediante una línea horizontal centrada entre


@@ -597,6 +743,13 @@ una sílaba y la siguiente.  Esta línea recibe el nombre de línea de
 extensión, y se escribe como @samp{ __ } (fíjese en los espacios antes
 y después de los dos guiones bajos).
 
 extensión, y se escribe como @samp{ __ } (fíjese en los espacios antes
 y después de los dos guiones bajos).
 

+@warning{Los melismas se indican en la partitura con líneas
+extensoras, que se escriben con un doble guión bajo; pero también se
+pueden introducir melismas cortos mediante saltos de notas
+individuales, que se escriben como caracteres de guión bajo sueltos;
+de forma predeterminada éstos no producen la impresión de una línea de
+extensión.}
+

 @cindex guiones
 
 @c leave this as samp. -gp
 @cindex guiones
 
 @c leave this as samp. -gp


@@ -611,35 +764,38 @@ guiones.  Se puede controlar si esto ocurre o no, mediante la
 @code{minimum-length} (umbral por debajo del cual se suprimen los
 guiones).
 
 @code{minimum-length} (umbral por debajo del cual se suprimen los
 guiones).
 

-@seealso

 
 

-Referencia de funcionamiento interno: @rinternals{LyricExtender},
-@rinternals{LyricHyphen}
+@seealso
+Referencia de funcionamiento interno:
+@rinternals{LyricExtender},
+@rinternals{LyricHyphen}.

 
 
 @node Lyrics and repeats
 
 
 @node Lyrics and repeats

-@subsubsection Lyrics and repeats
+@unnumberedsubsubsec Lyrics and repeats
+
+@c TODO New section.  Add text
+Continuará...

 
 

-@untranslated
+@node Specific uses of lyrics
+@subsection Specific uses of lyrics

 
 

-@node Placement of lyrics
-@subsection Placement of lyrics
+@c FIXME This whole section is to be reorganized. -vv

 
 A menudo se aplican a una melodía distintos versos de una canción de
 formas ligeramente distintas.  Tales variantes pueden aún captarse
 mediante @code{\lyricsto}.
 
 @menu
 
 A menudo se aplican a una melodía distintos versos de una canción de
 formas ligeramente distintas.  Tales variantes pueden aún captarse
 mediante @code{\lyricsto}.
 
 @menu

-* Divisi lyrics::               
-* Lyrics independent of notes::  
-* Chants::                      
-* Spacing out syllables::       
-* Centering lyrics between staves::  
+* Divisi lyrics::
+* Lyrics independent of notes::
+* Spacing out syllables::
+* Centering lyrics between staves::

 @end menu
 
 
 @node Divisi lyrics
 @end menu
 
 
 @node Divisi lyrics

-@subsubsection Divisi lyrics
+@unnumberedsubsubsec Divisi lyrics

 
 Puede presentar letras alternativas (o divisi) nombrando contextos de
 voz y aplicando la letra a los mencionados contextos específicos.
 
 Puede presentar letras alternativas (o divisi) nombrando contextos de
 voz y aplicando la letra a los mencionados contextos específicos.


@@ -684,7 +840,7 @@ sección que se repite.
 
 
 @node Lyrics independent of notes
 
 
 @node Lyrics independent of notes

-@subsubsection Lyrics independent of notes
+@unnumberedsubsubsec Lyrics independent of notes

 
 En cierta música vocal compleja, podría ser deseable colocar la letra
 de forma totalmente independiente de las notas.  La música que se
 
 En cierta música vocal compleja, podría ser deseable colocar la letra
 de forma totalmente independiente de las notas.  La música que se


@@ -711,14 +867,20 @@ lyr = \lyricmode { I like my cat! }
 >>
 @end lilypond
 
 >>
 @end lilypond
 

-@node Chants
-@subsubsection Chants
+Sólo se recomienda este método si la música que está en el contexto
+@code{Devnull} no contiene melismas.  Los melismas están definidos por
+el contexto @code{Voice}.  La conexión de la letra a un contexto
+@code{Devnull} hace que se pierdan los enlaces entre la voz y las
+sílabas, y también la información relativa a los melismas.  Por tanto,
+si enlazamos la letra a un contexto @code{Devnull}, los melismas
+implícitos se ignoran.

 
 

-@untranslated
+@c Conclusion: do not use devnull for lyrics -FV

 
 

+@c this clarifies http://code.google.com/p/lilypond/issues/detail?id=248

 
 @node Spacing out syllables
 
 @node Spacing out syllables

-@subsubsection Spacing out syllables
+@unnumberedsubsubsec Spacing out syllables

 
 @cindex Espaciado de la letra
 @cindex Letra, aumentar el espaciado
 
 @cindex Espaciado de la letra
 @cindex Letra, aumentar el espaciado


@@ -760,26 +922,72 @@ completa, establezca la propiedad dentro del @q{layout} o disposición.
 }
 @end lilypond
 
 }
 @end lilypond
 

+@c @snippets
+@c This snippet has been renamed to "lyrics-alignment.ly"
+@c update as soon as lsr/is updated -vv
+@c @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
+@c {lyrics-alignment.ly}
+
+@c TODO: move to LSR -vv
+@snippets
+
+La comprobación que asegura que las inscripciones de texto y la letra
+de las canciones se mantienen dentro de los márgenes, es una tarea
+computacional relativamente costosa.  Para acelerar el procesado,
+LilyPond no hace tales cálculos de forma predeterminada; para
+habilitarlos, utilice
+
+@example
+\override Score.PaperColumn #'keep-inside-line = ##t
+@end example
+
+Para hacer también que las sílabas de la letra eviten las barras de compás, use
+
+@example
+\layout @{
+  \context @{
+    \Lyrics
+      \consists "Bar_engraver"
+      \consists "Separating_line_group_engraver"
+      \override BarLine #'transparent = ##t
+  @}
+@}
+@end example
+
+@c TODO Create and add lsr example of lyricMelismaAlignment
+@c It's used like this to center-align all lyric syllables,
+@c even when notes are tied. -td
+
+@ignore
+\layout
+{
+     \context { \Score lyricMelismaAlignment = #0 }
+}
+@end ignore
+
+

 @node Centering lyrics between staves
 @node Centering lyrics between staves

-@subsubsection Centering lyrics between staves
+@unnumberedsubsubsec Centering lyrics between staves
+
+@c TODO Add text from -user
+Continuará...

 
 

-@untranslated

 
 @node Stanzas
 @subsection Stanzas
 
 @menu
 
 @node Stanzas
 @subsection Stanzas
 
 @menu

-* Adding stanza numbers ::      
-* Adding dynamics marks to stanzas::  
-* Adding singers' names to stanzas::  
-* Stanzas with different rhythms::  
-* Printing stanzas at the end::  
-* Printing stanzas at the end in multiple columns::  
+* Adding stanza numbers::
+* Adding dynamics marks to stanzas::
+* Adding singers' names to stanzas::
+* Stanzas with different rhythms::
+* Printing stanzas at the end::
+* Printing stanzas at the end in multiple columns::

 @end menu
 
 
 @end menu
 
 

-@node Adding stanza numbers 
-@subsubsection Adding stanza numbers 
+@node Adding stanza numbers
+@unnumberedsubsubsec Adding stanza numbers

 
 @cindex verso, número de
 
 
 @cindex verso, número de
 


@@ -790,10 +998,10 @@ Los números de los versos se pueden añadir estableciendo
 \new Voice {
   \time 3/4 g2 e4 a2 f4 g2.
 } \addlyrics {
 \new Voice {
   \time 3/4 g2 e4 a2 f4 g2.
 } \addlyrics {

-  \set stanza = "1. "
+  \set stanza = #"1. "

   Hi, my name is Bert.
 } \addlyrics {
   Hi, my name is Bert.
 } \addlyrics {

-  \set stanza = "2. "
+  \set stanza = #"2. "

   Oh, ché -- ri, je t'aime
 }
 @end lilypond
   Oh, ché -- ri, je t'aime
 }
 @end lilypond


@@ -801,9 +1009,40 @@ Los números de los versos se pueden añadir estableciendo
 @noindent
 Estos números aparecerán inmediatamente antes de la primera sílaba.
 
 @noindent
 Estos números aparecerán inmediatamente antes de la primera sílaba.
 

+@c TODO Create and add snippet to show how two lines of a
+@c stanza can be grouped together, along these lines:
+@c (might need improving a bit) -td
+
+@ignore
+leftbrace = \markup { \override #'(font-encoding . fetaBraces) \lookup
+#"brace105" }
+
+stanzaOneOne = {
+  \set stanza = \markup { "1. " \leftbrace }
+  \lyricmode { Child, you're mine and I love you.
+    Lend thine ear to what I say.
+
+  }
+}
+
+stanzaOneThree =  {
+%  \set stanza = \markup { "   "}
+  \lyricmode { Child, I have no great -- er joy
+    Than to have you walk in truth.
+
+  }
+}
+
+\new Voice {
+  \repeat volta 2 { c'8 c' c' c' c' c' c'4
+                    c'8 c' c' c' c' c' c'4   }
+}  \addlyrics { \stanzaOneOne }
+   \addlyrics { \stanzaOneThree }
+
+@end ignore

 
 @node Adding dynamics marks to stanzas
 
 @node Adding dynamics marks to stanzas

-@subsubsection Adding dynamics marks to stanzas
+@unnumberedsubsubsec Adding dynamics marks to stanzas

 
 Los versos que difieren en su sonoridad se pueden especificar
 escribiendo una indicación dinámica antes de cada verso.  En LilyPond,
 
 Los versos que difieren en su sonoridad se pueden especificar
 escribiendo una indicación dinámica antes de cada verso.  En LilyPond,


@@ -831,12 +1070,11 @@ text = {
 
 
 @node Adding singers' names to stanzas
 
 
 @node Adding singers' names to stanzas

-@subsubsection Adding singers' names to stanzas
+@unnumberedsubsubsec Adding singers' names to stanzas

 
 @cindex cantante, nombre del
 @cindex nombre del cantante
 
 
 @cindex cantante, nombre del
 @cindex nombre del cantante
 

-

 También se pueden poner los nombres de los cantantes.  Se imprimen al
 comienzo de la línea, igual que los nombres de instrumento.  Se crean
 estableciendo un valor para @code{vocalName}.  Se puede definir una
 También se pueden poner los nombres de los cantantes.  Se imprimen al
 comienzo de la línea, igual que los nombres de instrumento.  Se crean
 estableciendo un valor para @code{vocalName}.  Se puede definir una


@@ -846,17 +1084,17 @@ versión abreviada como @code{shortVocalName}.
 \new Voice {
   \time 3/4 g2 e4 a2 f4 g2.
 } \addlyrics {
 \new Voice {
   \time 3/4 g2 e4 a2 f4 g2.
 } \addlyrics {

-  \set vocalName = "Bert "
+  \set vocalName = #"Bert "

   Hi, my name is Bert.
 } \addlyrics {
   Hi, my name is Bert.
 } \addlyrics {

-  \set vocalName = "Ernie "
+  \set vocalName = #"Ernie "

   Oh, ché -- ri, je t'aime
 }
 @end lilypond
 
 
 @node Stanzas with different rhythms
   Oh, ché -- ri, je t'aime
 }
 @end lilypond
 
 
 @node Stanzas with different rhythms

-@subsubsection Stanzas with different rhythms
+@unnumberedsubsubsec Stanzas with different rhythms

 
 @subsubheading Ignoring melismata
 
 
 @subsubheading Ignoring melismata
 


@@ -865,13 +1103,7 @@ pero varias sílabas en otro.  Una solución es hacer que la voz más
 rápida ignore el melisma.  Esto se consigue estableciendo
 @code{ignoreMelismata} en el contexto Lyrics.
 
 rápida ignore el melisma.  Esto se consigue estableciendo
 @code{ignoreMelismata} en el contexto Lyrics.
 

-Hay un aspecto delicado: el valor de @code{ignoreMelismata} se debe
-establecer una sílaba @emph{antes} de la sílaba no melismática del
-texto, tal y como se muestra a continuación:
-
-@c  TODO: breaks compile

 @lilypond[verbatim,ragged-right,quote]
 @lilypond[verbatim,ragged-right,quote]

-%{

 <<
   \relative c' \new Voice = "lahlah" {
     \set Staff.autoBeaming = ##f
 <<
   \relative c' \new Voice = "lahlah" {
     \set Staff.autoBeaming = ##f


@@ -884,31 +1116,21 @@ texto, tal y como se muestra a continuación:
     more slow -- ly
   }
   \new Lyrics \lyricsto "lahlah" {
     more slow -- ly
   }
   \new Lyrics \lyricsto "lahlah" {

-    \set ignoreMelismata = ##t % se aplica al "fas"
-    go fas -- ter
+    go
+    \set ignoreMelismata = ##t
+    fas -- ter

     \unset ignoreMelismata
     still
   }
 >>
     \unset ignoreMelismata
     still
   }
 >>

-%}

 @end lilypond
 
 @end lilypond
 

+@knownissues
+A diferencia de casi todas las instrucciones @code{\set}, @code{\set
+ignoreMelismata} no funciona si va precedido de @code{\once}.  Es
+necesario utilizar @code{\set} y @code{\unset} para delimitar la letra
+en que se quieren ignorar los melismas.

 
 

-El @code{ignoreMelismata} se aplica a la sílaba @q{fas}, por ello se
-debe introducir antes de @q{go}.
-
-La inversa también es posible: hacer que una línea de letra sea más
-lenta que la normal.  Esto se puede conseguir insertando @code{\skip}s
-(desplazamientos) dentro de la letra.  Para cada @code{\skip}, el
-texto se retrasará una nota más.  Por ejemplo,
-
-@lilypond[verbatim,ragged-right,quote]
-\relative c' { c c g' }
-\addlyrics {
-  twin -- \skip 4
-  kle
-}
-@end lilypond

 
 @subsubheading Switching to an alternative melody
 
 
 @subsubheading Switching to an alternative melody
 


@@ -974,8 +1196,11 @@ consigue con
 Aquí, @code{alternative} es el nombre del contexto de @code{Voice} que
 contiene el tresillo.
 
 Aquí, @code{alternative} es el nombre del contexto de @code{Voice} que
 contiene el tresillo.
 

-Una vez más, la instrucción debe ir una sílaba antes de la cuenta,
-antes de @q{Ty} en este caso.
+@c FIXME: make this easier to understand -vv
+La instrucción debe ir una sílaba antes de la cuenta, antes de @q{Ty}
+en este caso.  En otras palabras, el cambio en la voz asociada
+associatedVoice se produce un paso más tarde de lo que se espera.
+Esto es así por razones técnicas, y no es un fallo del programa.

 
 @example
 \new Lyrics \lyricsto "lahlah" @{
 
 @example
 \new Lyrics \lyricsto "lahlah" @{


@@ -994,12 +1219,12 @@ asignación de @code{lahlah} a @code{associatedVoice}.
 
 
 @node Printing stanzas at the end
 
 
 @node Printing stanzas at the end

-@subsubsection Printing stanzas at the end
+@unnumberedsubsubsec Printing stanzas at the end

 
 En ocasiones es conveniente tener un verso ajustado a la música, y el
 resto añadido en forma de estrofa al final de la pieza.  Esto se puede
 conseguir escribiendo los versos adicionales dentro de una sección
 
 En ocasiones es conveniente tener un verso ajustado a la música, y el
 resto añadido en forma de estrofa al final de la pieza.  Esto se puede
 conseguir escribiendo los versos adicionales dentro de una sección

-@code{\markup} fuera del bloque score principal de la partitura.
+@code{\markup} fuera del bloque Score principal de la partitura.

 Tenga en cuenta que existen dos formas distintas de forzar los saltos
 de línea al utilizar @code{\markup}.
 
 Tenga en cuenta que existen dos formas distintas de forzar los saltos
 de línea al utilizar @code{\markup}.
 


@@ -1010,7 +1235,7 @@ d d e d | c1 |
 }
 
 text = \lyricmode {
 }
 
 text = \lyricmode {

-\set stanza = "1." Ma- ry had a lit- tle lamb,
+\set stanza = #"1." Ma- ry had a lit- tle lamb,

 its fleece was white as snow.
 }
 
 its fleece was white as snow.
 }
 


@@ -1038,20 +1263,20 @@ its fleece was white as snow.
 
 
 @node Printing stanzas at the end in multiple columns
 
 
 @node Printing stanzas at the end in multiple columns

-@subsubsection Printing stanzas at the end in multiple columns
+@unnumberedsubsubsec Printing stanzas at the end in multiple columns

 
 Cuando una pieza tiene muchos versos, a menudo se imprimen en varias
 columnas a lo largo de toda la página. Con frecuencia un número de
 verso fuera del margen precede a cada verso. El ejemplo siguiente
 
 Cuando una pieza tiene muchos versos, a menudo se imprimen en varias
 columnas a lo largo de toda la página. Con frecuencia un número de
 verso fuera del margen precede a cada verso. El ejemplo siguiente

-muestra cómo producir dicha salida en Lilypond.
+muestra cómo producir dicha salida en LilyPond.

 
 @lilypond[ragged-right,quote,verbatim]
 melody = \relative c' {
   c c c c | d d d d
 }
 
 @lilypond[ragged-right,quote,verbatim]
 melody = \relative c' {
   c c c c | d d d d
 }

- 
+

 text = \lyricmode {
 text = \lyricmode {

-  \set stanza = "1." This is verse one.
+  \set stanza = #"1." This is verse one.

   It has two lines.
 }
 
   It has two lines.
 }
 


@@ -1064,8 +1289,8 @@ text = \lyricmode {
 
 \markup {
   \fill-line {
 
 \markup {
   \fill-line {

-    \hspace #0.1 % moves the column off the left margin; can be removed if
-        % space on the page is tight
+    \hspace #0.1 % moves the column off the left margin;
+        % can be removed if space on the page is tight

      \column {
       \line { \bold "2."
         \column {
      \column {
       \line { \bold "2."
         \column {


@@ -1081,9 +1306,9 @@ text = \lyricmode {
         }
       }
     }
         }
       }
     }

-    \hspace #0.1  % adds horizontal spacing between columns; if they are
-        % still too close, add more " " pairs until the result 
-        % looks good
+    \hspace #0.1  % adds horizontal spacing between columns;
+        % if they are still too close, add more " " pairs
+        % until the result looks good

      \column {
       \line { \bold "4."
         \column {
      \column {
       \line { \bold "4."
         \column {


@@ -1099,16 +1324,14 @@ text = \lyricmode {
         }
       }
     }
         }
       }
     }

-  \hspace #0.1 % gives some extra space on the right margin; can
-      % be removed if page space is tight
+  \hspace #0.1 % gives some extra space on the right margin;
+      % can be removed if page space is tight

   }
 }
 @end lilypond
 
 
 @seealso
   }
 }
 @end lilypond
 
 
 @seealso

-

 Referencia de funcionamiento interno:
 @rinternals{LyricText},
 @rinternals{StanzaNumber}.
 Referencia de funcionamiento interno:
 @rinternals{LyricText},
 @rinternals{StanzaNumber}.

-