Merge branch 'lilypond/translation' of ssh://jomand@git.sv.gnu.org/srv/git/lilypond

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

@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
@c This file is part of lilypond.tely
@ignore
    Translation of GIT committish: a0e34b9be40d377c7815f96a07f23280b3257413

    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.38"


@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:

@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.

@item
Los textos de las canciones se deben alinear con las notas respectivas
de la melodía.
@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
* Simple lyrics::               
* Aligning lyrics to a melody::  
* Vocals and variables::        
* Flexibility in placement::    
* Spacing vocals::              
* More about stanzas::          
@end menu


@snippets

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

@example
\override Score.PaperColumn #'keep-inside-line = ##t
@end example

Para hacer que la letra evite las líneas divisorias también, utilice

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


@node Simple lyrics
@subsection Simple lyrics

@menu
* Setting simple songs::        
* Entering lyrics::             
@end menu

@node Setting simple songs
@subsubsection 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 { 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 { 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}.



@node Entering lyrics
@subsubsection Entering lyrics

@cindex letra
@funindex \lyricmode
@cindex puntuación
@cindex espacios, en la letra
@cindex comillas, en la letra

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
introducir la letra, con puntuación y acentos, y el carácter @code{d}
no se analiza como una nota, sino más bien como una sílaba de una sola
letra.  Las sílabas se introducen como las notas, pero con texto en
lugar de alturas de nota.  Por ejemplo,

@example
\lyricmode @{ Cam-4 pa-4 ni- ta del- lu- gar2 @}
@end example

Existen dos métodos principales para especificar la colocación
horizontal de las sílabas, bien especificando la duración de cada
sílaba de forma explícita, como en el ejemplo anterior, o bien
alineando automáticamente la letra a la melodía o a cualquier otra
voz, usando @code{\addlyrics} o @code{\lyricsto}.
@c  TODO: broken
@c For more details see @ref{The Lyrics context}.

Una palabra o sílaba de la letra comienza con un carácter alfabético,
y termina con cualquier espacio o dígito.  Los caracteres que siguen
pueden ser cualesquiera excepto un dígito o un espacio.

Cualquier carácter excepto un dígito o un espacio en blanco se
considera parte de una sílaba; esto tiene una importante consecuencia,
y es que una palabra puede terminar en @code{@}}, lo que con
frecuencia conduce al siguiente error:

@example
\lyricmode @{ la- la@}
@end example

En este ejemplo, el símbolo @code{@}} se encuentra incluido dentro de
la sílaba final, por tanto la llave de apertura no se compensa con la
correspondiente llave de cierre y el archivo de entrada probablemente
no se podrá procesar.


@funindex \property dentro de \lyricmode

@noindent
De forma similar, un punto que sigue a una secuencia alfabética queda
incluido dentro de la cadena resultante.  Como consecuencia, se deben
insertar espacios antes y después de los comandos de propiedades:
@emph{no} escriba

@example
\override Score.LyricText #'font-shape = #'italic
@end example

@noindent
sino lo siguiente:

@example
\override Score . LyricText #'font-shape = #'italic
@end example

@funindex _
@cindex espacios, en la letra
@cindex comillas, en la letra
@cindex ligaduras, en la letra

Para asignar más de una sílaba a una única nota, puede rodearlas por
comillas o usar un carácter @code{_} (guión bajo), para obtener
espacios entre las sílabas, o usar el símbolo de tilde curva
(@code{~}) para obtener una ligadura entre sílabas de la letra.

@lilypond[quote,relative=2,ragged-right,fragment,verbatim]
\time 3/4
\relative { c2 e4 g2 e4 }
\addlyrics { gran- de_a- mi- go }
\addlyrics { pu- "ro y ho-" nes- to }
\addlyrics { pu- ro~y~ho- nes- to }
@end lilypond

La ligadura de texto se construye con el carácter Unicode U+203F, por
tanto debe asegurarse de que tiene instalada una tipografía (como
DejaVuLGC) que incluya este glifo.


Para escribir letra con caracteres de una lengua no inglesa, o que
tenga caracteres acentuados o especiales (como el símbolo del corazón
o comillas inclinadas), introduzca simplemente los caracteres
directamente en el archivo de entrada y guárdelo con una codificación
utf-8.  Consulte @ref{Text encoding}, para ver más información.

@c FIXME: quotes.

@lilypond[quote,ragged-right,fragment,verbatim]
\relative { e4 f e d e f e2 }
\addlyrics { He said: “Let my peo ple go”. }
@end lilypond

Para utilizar comillas normales en la letra, escriba una barra
invertida antes de las comillas.  Por ejemplo,

@lilypond[quote,ragged-right,fragment,verbatim]
\relative c' { \time 3/4 e4 e4. e8 d4 e d c2. }
\addlyrics { "\"I" am so lone- "ly\"" said she }
@end lilypond

La definición completa del comienzo de una palabra en el modo Lyrics
(letra) es algo más compleja.

Una palabra en el modo Lyrics comienza por: un carácter alfabético,
@code{_}, @code{?}, @code{!}, @code{:}, @code{'}, los caracteres de
control desde @code{^A} hasta @code{^F}, desde @code{^Q} hasta
@code{^W}, @code{^Y}, @code{^^}, cualquier carácter de 8 bits con
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{^}.

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

@example
verseOne = \lyricmode @{ Joy to the world the Lord is come @}
\score @{
  <<
    \new Voice = "one" \relative c'' @{
      \autoBeamOff
      \time 2/4
      c4 b8. a16 g4. f8 e4 d c2
    @}
    \addlyrics @{ \verseOne @}
  >>
@}
@end example


@seealso

Referencia de funcionamiento interno: @internalsref{LyricText},
@internalsref{LyricSpace}.



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

@funindex \lyricmode
@funindex \addlyrics
@funindex \lyricsto


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

@example
\new Lyrics \lyricmode @dots{}
@end example

Existen dos métodos principales para especificar la colocación
horizontal de las sílabas:

@itemize
@item
alineando automáticamente el texto a una melodía o a otra voz,
utilizando @code{\addlyrics} o @code{\lyricsto}.

@item
o especificando la duración de cada sílaba explícitamente, utilizando
@code{\lyricmode}
@end itemize

@menu
* Automatic syllable durations::  
* Another way of entering lyrics::  
* Assigning more than one syllable to a single note::  
* More than one note on a single syllable::  
* Extenders and hyphens::       
@end menu

@node Automatic syllable durations
@subsubsection Automatic syllable durations

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

La letra se puede alinear automáticamente bajo una melodía dada.  Esto
se consigue combinando la melodía y el texto con la expresión
@code{\lyricsto}

@example
\new Lyrics \lyricsto @var{nombre} @dots{}
@end example

Esto alinea la letra a las notas del contexto de @internalsref{Voice}
llamado @var{nombre}, que debe existir previamente.  Por ello la
@code{Voice} normalmente se especifica en primer lugar, y después se
especifica la letra con @code{\lyricsto}.  La instrucción
@code{\lyricsto} cambia automáticamente al modo @code{\lyricmode}, por
lo que la palabra clave @code{\lyricmode} se puede omitir.

El ejemplo siguiente utiliza comandos diferentes para introducir la
letra.

@lilypond[quote,fragment,ragged-right,verbatim]
<<
  \new Voice = "one" \relative c'' {
    \autoBeamOff
    \time 2/4
    c4 b8. a16 g4. f8 e4 d c2
  }
  \new Lyrics \lyricmode { Joy4 to8. the16 world!4. the8 Lord4 is come.2 }
  \new Lyrics \lyricmode { Joy to the earth! the Sa -- viour reigns. }
  \new Lyrics \lyricsto "one" { No more let sins and sor -- rows grow. }
>>
@end lilypond

El segundo verso no está bien alineado porque las duraciones
no se han especificado.  Una solución para eso sería usar @code{\lyricsto}.

El comando @code{\addlyrics} es realmente tan sólo una forma cómoda de
escribir una estructura de LilyPond más complicada que establece la
letra.

@example
@{ MÚSICA @}
\addlyrics @{ LETRA @}
@end example

@noindent
es lo mismo que

@example
\new Voice = "blabla" @{ MÚSICA @}
\new Lyrics \lyricsto "blabla" @{ LETRA @}
@end example

@node Another way of entering lyrics
@subsubsection Another way of entering lyrics

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.
@end example

La alineación respecto de una melodía se puede especificar con la
propiedad @code{associatedVoice},
 
@example
\set associatedVoice = #"lala"
@end example

@noindent
El valor de la propiedad (aquí: @code{"lala"}) ha de ser el nombre de
un contexto de @internalsref{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:

@lilypond[relative=1,ragged-right,verbatim,fragment,quote]
<< \new Voice = "melody" {
    \time 3/4
    c2 e4 g2.
 }
 \new Lyrics \lyricmode {
   \set associatedVoice = #"melody"
   play2 the4 game2.
 } >>
@end lilypond

@seealso

Referencia de funcionamiento interno: @internalsref{Lyrics}.


@node Assigning more than one syllable to a single note
@subsubsection Assigning more than one syllable to a single note


@funindex _
@cindex ligaduras, en el texto

Para asignar más de una sílaba a una sola nota, puede encerrarlas
entre comillas o utilizar un guión bajo (@code{_}), para dejar
espacios entre las sílabas, o usar el símbolo de tilde curva
(@code{~}) para obtener una ligadura en el texto@footnote{Las
ligaduras de texto están hechas con el carácter de Unicode U+203F, por
tanto debe asegurarse de tener instalada una tipografía (como
DejaVuLGC) que incluya este glifo.}.

@lilypond[quote,relative=2,ragged-right,fragment,verbatim]
\time 3/4
\relative { c2 e4 g2 e4 }
\addlyrics { gran- de_a- mi- go }
\addlyrics { pu- "ro y ho-" nes- to }
\addlyrics { pu- ro~y~ho- nes- to }
@end lilypond

@seealso

Referencia de funcionamiento interno: @internalsref{LyricCombineMusic}.

@c Here come the section which used to be "Melismata"
@c the new title might be more self-explanatory


@node More than one note on a single syllable
@subsubsection More than one note on a single syllable

@cindex melisma
@cindex melismata
@cindex fraseo, en la letra

A veces, y sobre todo en la música medieval, varias notas se cantan
sobre una sílaba única; tales vocalizaciones reciben el nombre de
melismas, o melismata.

@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.

@lilypond[relative=1,verbatim,fragment,quote]
{ \set melismaBusyProperties = #'()
 c d( e) f f( e) e e  }
\addlyrics
 { 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.

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
notas unidas mediante ligadura de unión o de expresión.  Si quiere
forzar que un grupo de notas sin ligadura sea un melisma, inserte
@code{\melisma} después de la primera nota del grupo, y
@code{\melismaEnd} después de la última, p.ej.:

@lilypond[quote,relative=2,ragged-right,fragment,verbatim]
<<
  \new Voice = "lala" {
    \time 3/4
    f4 g8
    \melisma
    f e f
    \melismaEnd
    e2
  }
  \new Lyrics \lyricsto "lala" {
    la di __ daah
  }
>>
@end lilypond

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.

@c TODO: there might be some more relevant place for 
@c the following link (?)

@cindex SATB
@cindex coral, partitura

Hay un ejemplo completo de una disposición de partitura SATB en la
sección @rlearning{Vocal ensembles}.


@predefined

@code{\melisma}, @code{\melismaEnd}
@funindex \melismaEnd
@funindex \melisma

@seealso

Referencia de funcionamiento interno: @internalsref{Melisma_translator}.

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

@knownissues

Los melismas no se detectan automáticamente, y las líneas de extensión
se deben insertar a mano.

@node Extenders and hyphens
@subsubsection Extenders and hyphens

@cindex melisma
@cindex extender

@c leave this as samp. -gp
Los melismas se indican mediante una línea horizontal centrada entre
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).

@cindex guiones

@c leave this as samp. -gp
Los guiones centrados se escriben como @samp{ -- } entre sílabas de
una misma palabra (fíjese en los espacios antes y después de los dos
guiones).  El guión quedará centrado entre las sílabas, y su longitud
se ajustará en función del espacio que exista entre ellas.

En la música grabada de modo muy apretado, se pueden quitar los
guiones.  Se puede controlar si esto ocurre o no, mediante la
@code{minimum-distance} (distancia mínima entre las dos sílabas) y la
@code{minimum-length} (umbral por debajo del cual se suprimen los
guiones).

@seealso

Referencia de funcionamiento interno: @internalsref{LyricExtender},
@internalsref{LyricHyphen}


@node Vocals and variables
@subsection Vocals and variables

@menu
* Working with lyrics and variables::  
@end menu

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

@cindex letra, identificadores de

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.
 
@example
verseOne = \lyricmode @{ Joy to the world the Lord is come @}
\score @{
 <<
   \new Voice = "one" \relative c'' @{
     \autoBeamOff
     \time 2/4
     c4 b8. a16 g4. f8 e4 d c2
   @}
   \addlyrics @{ \verseOne @}
 >>
@}
@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
\new ChoirStaff <<
  \new Voice = "soprano" @{ @emph{música} @}
  \new Lyrics = "textoSoprano" @{ s1 @}
  \new Lyrics = "textoTenor" @{ s1 @}
  \new Voice = "tenor" @{ @emph{música} @}
>>
@end example
 
y después combinar las melodías y líneas de texto correspondientes:
 
@example
\context Lyrics = textoSoprano \lyricsto "soprano"
@emph{el texto}
@end example
 
@noindent

El código de entrada definitivo sería algo como
 
@example
<<\new ChoirStaff << @emph{prepare la música} >>
 \lyricsto "soprano" @emph{etc}
 \lyricsto "alto" @emph{etc}
@emph{etc}
>>
@end example
 
@seealso
 
@c TODO: document \new Staff << Voice \lyricsto >> bug
Referencia de funcionamiento interno:
@internalsref{LyricCombineMusic}, @internalsref{Lyrics}.


@node Flexibility in placement
@subsection Flexibility in placement

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
* Lyrics to multiple notes of a melisma::  
* Divisi lyrics::               
* Switching the melody associated with a lyrics line::  
* Lyrics independent of notes::  
@end menu


@node Lyrics to multiple notes of a melisma
@subsubsection Lyrics to multiple notes of a melisma

Existe la posibilidad de que el texto tenga un melisma en un verso,
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.

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]
%{
<<
  \relative \new Voice = "lahlah" {
    \set Staff.autoBeaming = ##f
    c4
    \slurDotted
    f8.[( g16])
    a4
  }
  \new Lyrics \lyricsto "lahlah" {
    more slow -- ly
  }
  \new Lyrics \lyricsto "lahlah" {
    \set ignoreMelismata = ##t % applies to "fas"
    go fas -- ter
    \unset ignoreMelismata
    still
  }
>>
%}
@end lilypond


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 g' }
\addlyrics {
  twin -- \skip 4
  kle
}
@end lilypond


@node Divisi lyrics
@subsubsection Divisi lyrics

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

@lilypond[verbatim,ragged-right,quote]
\score{ <<
  \new Voice = "melody" {
    \relative c' {
      c4
      <<
        { \voiceOne c8 e }
        \new Voice = "splitpart" { \voiceTwo c4 }
      >>
      \oneVoice c4 c | c
    }
  }
  \new Lyrics \lyricsto "melody" { we shall not o- ver- come }
  \new Lyrics \lyricsto "splitpart" { will }
>> }
@end lilypond


Puede usar este truco para presentar las distintas letras de una
sección que se repite.

@lilypond[verbatim,ragged-right,quote]
\score{ <<
  \new Voice = "melody" \relative c' {
    c2 e | g e | c1 |
    \new Voice = "verse" \repeat volta 2 {c4 d e f | g1 | }
    a2 b | c1}
  \new Lyrics = "mainlyrics" \lyricsto melody \lyricmode {
    do mi sol mi do
    la si do }
  \context Lyrics = "mainlyrics" \lyricsto verse \lyricmode {
   do re mi fa sol }
  \new Lyrics = "repeatlyrics" \lyricsto verse \lyricmode {
   dodo rere mimi fafa solsol }
>>
}
@end lilypond



@node Switching the melody associated with a lyrics line
@subsubsection Switching the melody associated with a lyrics line

Son posibles variaciones más complejas en la disposición del texto.
Se puede cambiar la melodía para una línea de la letra durante el
texto.  Esto se hace estableciendo la propiedad
@code{associatedVoice}.  En el ejemplo

@lilypond[ragged-right,quote]
<<
  \relative \new Voice = "lahlah" {
    \set Staff.autoBeaming = ##f
    c4
    <<
      \new Voice = "alternative" {
        \voiceOne
        \times 2/3 {
          % show associations clearly.
          \override NoteColumn #'force-hshift = #-3
          f8 f g
        }
      }
      {
        \voiceTwo
        f8.[ g16]
        \oneVoice
      } >>
    a8( b) c
  }
  \new Lyrics \lyricsto "lahlah" {
    Ju -- ras -- sic Park
  }
  \new Lyrics \lyricsto "lahlah" {
    % Tricky: need to set associatedVoice
    % one syllable too soon!
    \set associatedVoice = alternative % applies to "ran"
    Ty --
    ran --
    no --
    \set associatedVoice = lahlah % applies to "rus"
    sau -- rus Rex
  } >>
@end lilypond

@noindent
el texto del primer verso se aplica a una melodía llamada @q{lahlah},

@example
\new Lyrics \lyricsto "lahlah" @{
  Ju -- ras -- sic Park
@}
@end example


El segundo verso se aplica en principio al contexto de @code{lahlah},
pero para la sílaba @q{ran}, cambia a una melodía diferente.  Esto se
consigue con
@example
\set associatedVoice = alternative
@end example

@noindent
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.

@example
\new Lyrics \lyricsto "lahlah" @{
  \set associatedVoice = alternative % se aplica al "ran"
  Ty --
  ran --
  no --
  \set associatedVoice = lahlah % se aplica al "rus"
  sau -- rus Rex
@}
@end example

@noindent
La disposición se vuelve a cambiar a la situación inicial mediante la
asignación de @code{lahlah} a @code{associatedVoice}.


@node Lyrics independent of notes
@subsubsection 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
define dentro de @code{lyricrhythm} desaparece dentro del contexto
@code{Devnull}, pero los valores rítmicos aún se pueden utilizar para
colocar la letra.

@lilypond[quote,verbatim,ragged-right]
voice = {
  c''2
  \tag #'music { c''2 }
  \tag #'lyricrhythm { c''4. c''8 }
  d''1
}

lyr = \lyricmode { I like my cat! }

<<
  \new Staff \keepWithTag #'music \voice
  \new Devnull="nowhere" \keepWithTag #'lyricrhythm \voice
  \new Lyrics \lyricsto "nowhere" \lyr
  \new Staff { c'8 c' c' c' c' c' c' c'
  c' c' c' c' c' c' c' c' }
>>
@end lilypond


@node Spacing vocals
@subsection Spacing vocals

@menu
* Spacing lyrics::              
@end menu

@node Spacing lyrics
@subsubsection Spacing lyrics

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

Para aumentar el espaciado entre las sílabas de la letra, establezca
la propiedad minimum-distance de LyricSpace.

@lilypond[relative,verbatim,fragment,quote,ragged-right]
{
  c c c c
  \override Lyrics.LyricSpace #'minimum-distance = #1.0
  c c c c
}
\addlyrics {
  longtext longtext longtext longtext
  longtext longtext longtext longtext
}
@end lilypond

Para que este cambio sea válido para la letra de la partitura
completa, establezca la propiedad dentro del @q{layout} o disposición.

@lilypond[relative,verbatim,quote,ragged-right]
\score {
  \relative c' {
  c c c c
  c c c c
  }
  \addlyrics {
  longtext longtext longtext longtext
  longtext longtext longtext longtext
  }
  \layout {
    \context {
      \Lyrics
      \override LyricSpace #'minimum-distance = #1.0
    }
  }
}
@end lilypond

@node More about stanzas
@subsection More about stanzas

@menu
* Adding stanza numbers ::      
* Adding dynamics marks::       
* Adding singer names::         
* Printing stanzas at the end ::  
* Printing stanzas at the end in multiple columns ::  
@end menu


@node Adding stanza numbers 
@subsubsection Adding stanza numbers 

@cindex verso, número de

Los números de los versos se pueden añadir estableciendo
@code{stanza}, p.ej.,

@lilypond[quote,ragged-right,verbatim,relative=2,fragment]
\new Voice {
  \time 3/4 g2 e4 a2 f4 g2.
} \addlyrics {
  \set stanza = "1. "
  Hi, my name is Bert.
} \addlyrics {
  \set stanza = "2. "
  Oh, ché -- ri, je t'aime
}
@end lilypond

@noindent
Estos números aparecerán inmediatamente antes de la primera sílaba.


@node Adding dynamics marks
@subsubsection Adding dynamics marks

Los versos que difieren en su sonoridad se pueden especificar
escribiendo una indicación dinámica antes de cada verso.  En LilyPond,
todo lo que aparece delante de un verso está dentro del objeto
@code{StanzaNumber}; las indicaciones dinámicas no son diferentes.
Por razones técnicas, tendrá que establecer el valor de la sección
stanza (verso) fuera de @code{\lyricmode}:

@lilypond[quote,ragged-right,verbatim]
text = {
  \set stanza = \markup { \dynamic "ff" "1. " }
  \lyricmode {
    Big bang
  }
}

<<
  \new Voice = "tune" {
    \time 3/4
    g'4 c'2
  }
\new Lyrics \lyricsto "tune" \text
>>
@end lilypond

@node Adding singer names
@subsubsection Adding singer names


@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
versión abreviada como @code{shortVocalName}.

@lilypond[fragment,ragged-right,quote,verbatim,relative=2]
\new Voice {
  \time 3/4 g2 e4 a2 f4 g2.
} \addlyrics {
  \set vocalName = "Bert "
  Hi, my name is Bert.
} \addlyrics {
  \set vocalName = "Ernie "
  Oh, che -- ri, je t'aime
}
@end lilypond


@node Printing stanzas at the end 
@subsubsection 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
@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}.

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

text = \lyricmode {
\set stanza = "1." Ma- ry had a lit- tle lamb,
its fleece was white as snow.
}

\score{ <<
  \new Voice = "one" { \melody }
  \new Lyrics \lyricsto "one" \text
>>
  \layout { }
}
\markup { \column{
  \line{ Verse 2. }
  \line{ All the children laughed and played }
  \line{ To see a lamb at school. }
  }
}
\markup{
  \wordwrap-string #"
  Verse 3.

  Mary took it home again,

  It was against the rule."
}
@end lilypond


@node Printing stanzas at the end in multiple columns 
@subsubsection 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
muestra cómo producir dicha salida en Lilypond.

@lilypond[ragged-right,quote,verbatim]
melody = \relative c' {
  c c c c | d d d d
}
 
text = \lyricmode {
  \set stanza = "1." This is verse one.
  It has two lines.
}

\score{ <<
    \new Voice = "one" { \melody }
    \new Lyrics \lyricsto "one" \text
   >>
  \layout { }
}

\markup {
  \fill-line {
    \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 {
          "This is verse two."
          "It has two lines."
        }
      }
      \hspace #0.1 % adds vertical spacing between verses
      \line { \bold "3."
        \column {
          "This is verse three."
          "It has two lines."
        }
      }
    }
    \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 {
          "This is verse four."
          "It has two lines."
        }
      }
      \hspace #0.1 % adds vertical spacing between verses
      \line { \bold "5."
        \column {
          "This is verse five."
          "It has two lines."
        }
      }
    }
  \hspace #0.1 % gives some extra space on the right margin; can
      % be removed if page space is tight
  }
}
@end lilypond


@seealso

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

@c TODO: stick elsewhere
@ignore
@n ode Other vocal issues
@s ubsection Other vocal issues

yeah, I'm giving up somewhat by stuffing a bunch of things in
here.  But at least they're in the manual now; it's easier to
move them around in the manual once they're already here.

Besides, if users complain about everything stuffed in here, I
can ask them for specific instructions about where to move these
examples, and that might get them more involved in the docs.  -gp


@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}.
@end ignore