From: Francisco Vila <francisco.vila@hispalinux.es>
Date: Tue, 18 Mar 2008 16:45:54 +0000 (+0100)
Subject: repeats, fully updated
X-Git-Tag: release/2.11.43-1~26^2~2^2~2
X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=e400d27c0376a5473f9278ff1dfb3e177d80e061;p=lilypond.git

repeats, fully updated

Also fixes a broken ref, duplicate node
---

diff --git a/Documentation/es/user/repeats.itely b/Documentation/es/user/repeats.itely
index 650b54eb94..f55ab3bfb4 100644
--- a/Documentation/es/user/repeats.itely
+++ b/Documentation/es/user/repeats.itely
@@ -1,6 +1,6 @@
 @c -*- coding: utf-8; mode: texinfo; -*-
 @ignore
-    Translation of GIT committish: 2607a3536733d8d4a1e74176027a5cb01d4e776a
+    Translation of GIT committish: 751ee13b75db49706f1d9ef34455f16ff11818f1
 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  See TRANSLATION for details.
@@ -9,63 +9,38 @@
 @node Repeats
 @section Repeats
 
-La repetición es un concepto fundamental en música, y existen varios
-tipos de notación para las repeticiones.
-
-@menu
-* Writing repeats::             
-* Other repeats::               
-@end menu
-
-@node Writing repeats
-@subsection Writing repeats
-
-@menu
-* Repeat types::                
-* Repeat syntax::               
-* Manual repeat commands::      
-* Repeats and MIDI::            
-@end menu
-
-@node Repeat types
-@subsubsection Repeat types
-
-@cindex repeticiones
+@lilypondfile[ragged-right,line-width=16\cm,staffsize=16,quote]
+{repeats-headword.ly}
 
-Están contemplados los siguientes tipos de repetición
+La repetición es un concepto fundamental en música, y existen varios
+tipos de notación para las repeticiones.  LilyPond contempla los
+siguientes tipos de repetición:
 
 @table @code
-@item desplegada
-Las música repetida está completamente escrita (e interpretada).  Es
-útil cuando se introduce música repetitiva.  Éste es el único tipo de
-repetición que se incluye en la salida MIDI.
-
 @item volta (primera y segunda vez)
-Las repeticiones no están desarrolladas, pero se imprimen finales
-alternativos (volte) de izquierda a derecha con corchetes.  Ésta es la
-notación estándar para las repeticiones con alternativas.  Por omisión
-no se reproducen en la salida MIDI.
-
-
-@item trémolo
-Hacen barras de trémolo.  Por omisión no se reproducen en la salida MIDI.
-
-@item porcentaje
-Hacen repeticiones de compases o parte de ellos.  Tienen un aspecto
-semejante a un signo de porcentaje.  Por omisión no se reproducen en
-la salida MIDI.  Las repeticiones de porcentaje se deben declarar dentro de un contexto @code{Voice}.
+La repetición de la música no se imprime de forma desarrollada, sino
+que se indica encerrándola entre barras de repetición.  Si el salto de
+la repetición se encuentra al comienzo de una pieza, la barra de
+repetición sólo se imprime al final del fragmento.  Se imprimen una
+serie de finales alternativos (volte) de izquierda a derecha indicados
+mediante corchetes.  Ésta es la notación estándar para las
+repeticiones con alternativas.
+
+@item unfold (desplegada)
+Las música repetida se escribe y se interpreta completamente tantas
+veces como especifique el valor @var{número_de_repeticiones}.  Es útil
+cuando se estáescribiendo música repetitiva.
+
+@item percent (porcentaje)
+Hacer repeticiones de compases o parte de ellos.  Tienen un aspecto
+semejante a un signo de porcentaje.  Las repeticiones de porcentaje se
+deben declarar dentro de un contexto @code{Voice}.
+
+@item tremolo (trémolo)
+Hacen barras de trémolo.
 
 @end table
 
-
-@node Repeat syntax
-@subsubsection Repeat syntax
-
-@cindex volta
-@cindex prima volta
-@cindex seconda volta
-@funindex \repeat
-
 LilyPond tiene una construcción sintáctica para especificar distintos
 tipos de repetición.  La sintaxis es
 
@@ -73,7 +48,10 @@ tipos de repetición.  La sintaxis es
 \repeat @var{variante} @var{número_de_repeticiones} @var{cuerpo_de_la_repetición}
 @end example
 
-Si tiene finales alternativos, puede añadir
+donde @var{cuerpo_de_la_repetición} es una expresión musical.
+
+
+Los finales alternativos se escriben con
 @funindex \alternative
 @example
 \alternative @{
@@ -85,27 +63,53 @@ Si tiene finales alternativos, puede añadir
 @end example
 
 @noindent
-donde cada @var{alternativa} es una expresión musical.  Si no da un
-número de alternativas suficiente para todas las repeticiones, se
-supondrá que la primera alternativa se interpreta más de una vez.
+después de un bloque @code{\repeat volta} o @code{unfold}, donde cada
+@var{alternativa} es una expresión musical.  Si especifica menos
+alternativas que las que se especifican en
+@var{número_de_repeticiones}, se supondrá que la primera alternativa
+se interpreta más de una vez.
 
-Las repeticiones estándar se usan de esta forma:
 
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-c1
+@menu
+* Writing long repeats::        
+* Short repeats::               
+@end menu
+
+@node Writing long repeats
+@subsection Writing long repeats
+
+@menu
+* Normal repeats::              
+* Manual repeat marks::         
+@end menu
+
+@cindex volta
+@cindex prima volta
+@cindex primera y segunda vez
+@cindex seconda volta
+@cindex volta, prima
+@cindex volta, seconda
+@funindex \repeat
+
+@node Normal repeats
+@subsubsection Normal repeats
+
+FIXME: this example needs to go by itself.
+@verbatim
 \repeat volta 2 { c4 d e f }
-\repeat volta 2 { f e d c }
-@end lilypond
+@end verbatim
 
-Con finales alternativos
+Repeticiones normales, con finales alternativos o sin ellos:
 
 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+\repeat volta 2 { g f e d }
+  \alternative {
+    { cis2 g' }
+    { cis,2 b }
+  }
 c1
-\repeat volta 2 {c4 d e f}
-\alternative { {d2 d} {f f,} }
 @end lilypond
-
-Se pueden crear repeticiones con anacrusa.
+Repeticiones con anacrusa:
 
 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
 \new Staff {
@@ -127,10 +131,9 @@ o bien
 @end lilypond
 
 
-
 @funindex \repeatTie
 
-Se pueden añadir ligaduras de unión al segundo final,
+Se pueden añadir ligaduras de unión al segundo final:
 
 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
 c1
@@ -138,9 +141,11 @@ c1
 \alternative { {f2 d} {f\repeatTie f,} }
 @end lilypond
 
-Es posible acortar los corchetes de primera y segunda vez
-estableciendo @code{voltaSpannerDuration}.  En el ejemplo siguiente, el
-corchete sólo dura un compás, lo que supone una duración de 3/4.
+De manera predeterminada, los corchetes de primera y segunda vez se
+dibujan por encima de todo el fragmento de finales alternativos, pero
+es posible acortar los corchetes de primera y segunda vez
+estableciendo @code{voltaSpannerDuration}.  En el ejemplo siguiente,
+el corchete sólo dura un compás, lo que supone una duración de 3/4.
 
 @lilypond[verbatim,ragged-right,quote]
 \relative c''{
@@ -153,27 +158,44 @@ corchete sólo dura un compás, lo que supone una duración de 3/4.
 }
 @end lilypond
 
+El grabador @code{Volta_engraver} reside de manera predeterminada
+dentro del contexto Score, y así los corchetes de las repeticiones se
+imprimen solamente por encima del pentagrama superior.  Se puede
+ajustar esto añadiento el grabador @code{Volta_engraver} al contexto
+Staff en que queremos que aparezcan los corchetes; véase
+@ref{Modifying context plug-ins} y
+@c @lsr{repeats,volta@/-multi@/-staff@/.ly}.
+
+@lilypond[verbatim,ragged-right,quote]
+\score { <<
+  \new Staff { \repeat volta 2 { c'1 } \alternative { c' } }
+  \new Staff { \repeat volta 2 { c'1 } \alternative { c' } }
+  \new Staff \with { \consists Volta_engraver } { c'2 g' e' a' }
+  \new Staff { \repeat volta 2 { c'1 } \alternative { c' } }
+ >> }
+@end lilypond
+
+@c Is there a way to have a final bar ("|.") at the end of the
+@c previous line? Doesn't seem to be.
 Si quiere comenzar una repetición al principio de una línea y tiene una
 doble barra al final de la línea anterior, utilice
 @example
 @dots{} \bar "||:" \break 
 \repeat volta 2 @{ @dots{} 
 @end example
+
 consulte @ref{Bar lines} para ver más información.
 
 @seealso
 
-Referencia del programa: @internalsref{VoltaBracket},
+Fragmentos de código: @lsrdir{Repeats,Repeats}
+
+Referencia de funcionamiento interno: @internalsref{VoltaBracket},
 @internalsref{RepeatedMusic},
 @internalsref{VoltaRepeatedMusic} y
 @internalsref{UnfoldedRepeatedMusic}.
 
-Ejemplos:
-
-Normalmente los corchetes para la repetición sólo se imprimen sobre el
-pentagrama superior.  Esto se puede ajustar moviendo @code{Volta_engraver} al contexto
-Staff donde quiera que aparezcan los corchetes;
-consulte @ref{Modifying context plug-ins} y
+@c Ejemplos:
 
 @lsr{repeats,volta@/-multi@/-staff@/.ly}.
 
@@ -194,23 +216,31 @@ Una repetición anidada como
 es ambigua porque no está claro a qué @code{\repeat} pertenece la
 @code{\alternative}.  Esta ambigüedad se resuelve haciendo que la
 @code{\alternative} pertenezca siempre a la @code{\repeat} más
-interna.  Para más claridad, se recomienda usar llaves en tales situaciones.
+interna.  Para más claridad, se recomienda usar llaves en tales
+situaciones.
 
-La información del contador de tiempo no se recuerda al comienzo de una alternativa,
-por ello después de una repetición la información de la cuenta de tiempo se debe reajustar
-manualmente; por ejemplo, estableciendo el valor de @code{Score.measurePosition} o
-introduciendo @code{\partial}.  De forma similar, las ligaduras de expresión o de unión tampoco se repiten.
+La información del contador de tiempo no se recuerda al comienzo de
+una alternativa, por ello después de una repetición la información de
+la cuenta de tiempo se debe reajustar manualmente; por ejemplo,
+estableciendo el valor de @code{Score.measurePosition} o introduciendo
+@code{\partial}.  De forma similar, las ligaduras de expresión o de
+unión tampoco se repiten.
 
-Los corchetes de primera y segunda vez no se alinean verticalmente.
 
 
-@node Manual repeat commands
-@subsubsection Manual repeat commands
+@node Manual repeat marks
+@subsubsection Manual repeat marks
 
 @funindex repeatCommands
 
+@c FIXME: Markup does not work in the "text" field
+@c And how does one change the font?
+@c On the whole, this section needs better documentation (why the
+@c double parentheses around the volta expressions?)
+
 Se puede usar la propiedad @code{repeatCommands} para controlar la
-disposición de las repeticiones.  Su valor es una lista de Scheme de comandos de repetición.
+disposición de las repeticiones.  Su valor es una lista de Scheme de
+comandos de repetición.
 
 @table @asis
 @item @code{start-repeat}
@@ -220,10 +250,11 @@ Imprimir una barra de compás @code{|:}
 Imprimir una barra de compás @code{:|}
 
 @item @code{(volta @var{texto})}
-Imprimir un corchete de volta que diga @var{texto}: El texto se puede
+Imprimir un corchete de volta que diga @var{texto} El texto se puede
 especificar como una cadena de texto o como un texto de marcado,
 consulte @ref{Text markup}.  No olvide cambiar la fuente tipográfica,
-porque el tipo por defecto para los números no contiene caracteres alfabéticos;
+porque el tipo por defecto para los números no contiene caracteres
+alfabéticos;
 
 @item @code{(volta #f)}
 Detener un corchete de volta mantenido.
@@ -237,72 +268,87 @@ c4 c4
 c4 c4
 @end lilypond
 
+@c FIXME: improve visibility of bar lines link?
 
 @seealso
 
+Referencia de la notación: @ref{Bar lines}.
+
+Fragmentos de código: @lsrdir{Repeats,Repeats}
+
 Referencia del programa: @internalsref{VoltaBracket},
-@internalsref{RepeatedMusic},
-@internalsref{VoltaRepeatedMusic} y
+@internalsref{RepeatedMusic}, @internalsref{VoltaRepeatedMusic} y
 @internalsref{UnfoldedRepeatedMusic}.
 
 
-@node Repeats and MIDI
-@subsubsection Repeats and MIDI
+@node Short repeats
+@subsection Short repeats
 
-@cindex expansión de repeticiones
-@funindex \unfoldRepeats
+@menu
+* Percent repeats::             
+* Tremolo repeats::             
+@end menu
 
-Con un poco de trucaje, todos los tipos de repeticiones pueden estar
-presentes en la salida MIDI.  Se consigue por medio de la aplicación
-de la función musical @code{\unfoldRepeats}.  Esta función transforma
-todas las repeticiones en repeticiones desarrolladas o desplegadas.
+@node Percent repeats
+@subsubsection Percent repeats
 
-@lilypond[quote,verbatim,fragment,line-width=8.0\cm]
-\unfoldRepeats {
-  \repeat tremolo 8 {c'32 e' }
-  \repeat percent 2 { c''8 d'' }
-  \repeat volta 2 {c'4 d' e' f'}
-  \alternative {
-    { g' a' a' g' }
-    {f' e' d' c' }
-  }
+@cindex porcentaje, repeticiones de
+@cindex compás, repeticiones de
+
+En el estilo @code{percent} (porcentaje), se puede hacer que se repita
+un patrón de notas.  Se imprime una sola vez, y luego el patrón se
+sustituye con un símbolo especial.  Los patrones de uno y dos compases
+se sustituyen por símbolos parecidos a un porcentaje, y los patrones
+que dividen a la duración de un compás se sustituyen por barras
+inclinadas.  Las repeticiones de porcentaje se deben declarar dentro
+de un contexto @code{Voice}.
+
+@lilypond[quote,verbatim,ragged-right]
+\new Voice \relative c' {
+  \repeat percent 4 { c4 }
+  \repeat percent 2 { c2 es2 f4 fis4 g4 c4 }
 }
-\bar "|."
 @end lilypond
 
-Cuando se elabora un archivo de partitura que utiliza @code{\unfoldRepeats} para el MIDI,
-es necesario hacer dos bloques @code{\score}: uno para el MIDI (con las repeticiones desplegadas)
-y otro para la notación (con primera y segunda vez, trémolo y repeticiones de porcentaje).
-Por ejemplo,
+Las repeticiones de compás de más de 2 compases llevan un contador, si
+se activa la propiedad @code{countPercentRepeats},
 
-@example
-\score @{
-  @var{..música..}
-  \layout @{ .. @}
-@}
-\score @{
-  \unfoldRepeats @var{..música..}
-  \midi @{ .. @}
-@}
-@end example
+@lilypond[relative=2,fragment,quote,verbatim,ragged-right]
+\new Voice {
+\set countPercentRepeats = ##t
+  \repeat percent 4 { c1 }
+}
+@end lilypond
+
+También se pueden imprimir porcentajes aislados.  Esto se hace
+mediante la colocación de un silencio multicompás con una función de
+impresión distinta,
+
+@lilypond[fragment,verbatim,quote]
+\override MultiMeasureRest #'stencil
+  = #ly:multi-measure-rest::percent
+R1
+@end lilypond
 
 
-@node Other repeats
-@subsection Other repeats
+@seealso
 
-@menu
-* Tremolo repeats::             
-* Tremolo subdivisions::        
-* Measure repeats::             
-@end menu
+Fragmentos de código: @lsrdir{Repeats,Repeats}
+
+Referencia del programa: @internalsref{RepeatSlash},
+@internalsref{PercentRepeat}, @internalsref{DoublePercentRepeat},
+@internalsref{DoublePercentRepeatCounter},
+@internalsref{PercentRepeatCounter},
+@internalsref{PercentRepeatedMusic}.
 
 @node Tremolo repeats
 @subsubsection Tremolo repeats
 
 @cindex barras de trémolo
 
-Para colocar marcas de trémolo entre las notas, use @code{\repeat} con el
-estilo tremolo
+Para colocar marcas de trémolo entre las notas, use @code{\repeat} con
+el estilo @code(tremolo) (trémolo):
+
 @lilypond[quote,verbatim,ragged-right]
 \new Voice \relative c' {
   \repeat tremolo 8 { c16 d16 }
@@ -311,35 +357,35 @@ estilo tremolo
 }
 @end lilypond
 
-Las marcas de trémolo también se pueden poner sobre una nota única.  En este caso, la
-nota no debe estar encerrada entre llaves.
-@lilypond[quote,verbatim,ragged-right]
-\repeat tremolo 4 c'16
-@end lilypond
-
-Se obtiene una salida similar usando la subdivisión del trémolo, que se describe en
-@ref{Tremolo subdivisions}.
-
-
-@seealso
+La sintaxis de @code{\repeat tremolo} espera que se escriban
+exactamente dos notas dentro de las llaves, y el número de
+repeticiones debe corresponderse con un valor que se pueda expresar
+con figuras normales o con puntillo.  Así, @code{\repeat tremolo 7} es
+válido y produce una nota con doble puntillo, pero @code{\repeat
+tremolo 9} no es válido.
 
-En el presente manual: @ref{Tremolo subdivisions}, @ref{Repeats}.
+La duración del trémolo es igual a la duración de la expresión entre
+llaves, multiplicada por el número de repeticiones: @code{\repeat
+tremolo 8 @{ c16 d16 @}} da como resultado un trémolo de redonda,
+escrito como dos redondas unidas por barras de trémolo.
 
-Referencia del programa: @internalsref{Beam}, @internalsref{StemTremolo}.
+Existen dos maneras de colocar marcas de trémolo sobre una única nota.
+Incluso aquí se puede utilizar la sintaxis @code{\repeat tremolo}, en
+cuyo caso la nota no debe ir encerrada entre llaves:
 
+@lilypond[quote,verbatim,ragged-right]
+\repeat tremolo 4 c'16
+@end lilypond
 
-@node Tremolo subdivisions
-@subsubsection Tremolo subdivisions
-
-@cindex marcas de trémolo
+@cindex trémolo, indicaciones de
 @funindex tremoloFlags
 
-Las marcas de trémolo se pueden imprimir sobre una nota única escribiendo
+El mismo resultado se puede obtener escribiendo
 @q{@code{:}[@var{número}]} después de la nota.  El número indica la
-duración de la subdivisión, y debe ser al menos 8.  Un valor de
-@var{longitud} de 8 produce una línea tachando la plica de la nota.  Si se
-omite la longitud,
-se utiliza el último valor (almacenado en @code{tremoloFlags})
+duración de la subdivisión, y debe ser 8 como mínimo.  Un valor de 8
+para @var{número} produce una línea que atraviesa la plica de la nota.
+Si se omite la longitud, se utiliza el último valor (almacenado en
+@code{tremoloFlags})
 
 @lilypond[quote,ragged-right,verbatim,fragment]
 c'2:8 c':32 | c': c': |
@@ -348,66 +394,23 @@ c'2:8 c':32 | c': c': |
 
 @knownissues
 
-Los trémolos escritos de esta forma no se trasladan a la salida MIDI.
-
 
-@seealso
-
-En el presente manual: @ref{Tremolo repeats}.
-
-En otros lugares: @internalsref{StemTremolo}.
+Los trémolos que se escriben con @q{@code{:}[@var{número}]} no se
+trasladan hacia la salida MIDI.
 
 
-@node Measure repeats
-@subsubsection Measure repeats
-
-@cindex porcentaje, repeticiones de
-@cindex compás, repeticiones de
-
-En el estilo @code{percent} (porcentaje), se puede hacer que se repita un patrón de notas.  Se
-imprime una sola vez, y luego el patrón se sustituye con un símbolo especial.
-Los patrones de uno y dos compases se sustituyen por símbolos parecidos a un porcentaje,
-y los patrones que dividen a la duración de un compás se sustituyen por barras inclinadas.
-Las repeticiones de porcentaje se deben declarar dentro de un contexto @code{Voice}.
-
-@lilypond[quote,verbatim,ragged-right]
-\new Voice \relative c' {
-  \repeat percent 4 { c4 }
-  \repeat percent 2 { c2 es2 f4 fis4 g4 c4 }
-}
-@end lilypond
-
-Las repeticiones de compás de más de 2 compases llevan un contador, si
-se activa la propiedad @code{countPercentRepeats},
-
-@lilypond[relative=2,fragment,quote,verbatim,ragged-right]
-\new Voice {
-\set countPercentRepeats = ##t
-  \repeat percent 4 { c1 }
-}
-@end lilypond
-
+@seealso
 
+Referencia de la notación: @ref{Tremolo repeats}.
 
-También se pueden imprimir porcentajes aislados.  Esto se hace
-mediante la colocación de un silencio multicompás con una función de impresión distinta,
-
-@lilypond[fragment,verbatim,quote]
-\override MultiMeasureRest #'stencil
-  = #ly:multi-measure-rest::percent
-R1
-@end lilypond
+Referencia de funcionamiento interno: @internalsref{Beam},
+@internalsref{StemTremolo}.
 
+Fragmentos de código: @lsrdir{Repeats,Repeats}
 
+En otros lugares: @internalsref{StemTremolo}.
 
 
-@seealso
-
-Referencia del programa: @internalsref{RepeatSlash},
-@internalsref{PercentRepeat}, @internalsref{DoublePercentRepeat},
-@internalsref{DoublePercentRepeatCounter},
-@internalsref{PercentRepeatCounter},
-@internalsref{PercentRepeatedMusic}.