]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/es/user/repeats.itely
Merge branch 'master' into dev/texi2html
[lilypond.git] / Documentation / es / user / repeats.itely
index 5723354b08e48e376edf239fe8e8689ff90f1cda..c86cdca0657ff88d06d272451f4b7a8240e0a972 100644 (file)
@@ -1,71 +1,49 @@
 @c -*- coding: utf-8; mode: texinfo; -*-
 @ignore
-    Translation of GIT committish: f7420240e4ce1fe2217646482a47d00f566af52c
+    Translation of GIT committish: 2ac76a5b0a5572cb259f22751764acfe431bfff2
 
     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"
+
 @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
-@unnumberedsubsubsec Repeat types
+@lilypondfile[ragged-right,line-width=16\cm,staffsize=16,quote]
+{repeats-headword.ly}
 
-@cindex repeticiones
-
-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)
+Hacer barras de trémolo.
 
 @end table
 
-
-@node Repeat syntax
-@unnumberedsubsubsec Repeat syntax
-
-@cindex volta
-@cindex prima volta
-@cindex seconda volta
-@funindex \repeat
-
+@ignore
 LilyPond tiene una construcción sintáctica para especificar distintos
 tipos de repetición.  La sintaxis es
 
@@ -73,7 +51,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,31 +66,72 @@ 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.
+@end ignore
+
+@menu
+* Writing long repeats::        
+* Short repeats::               
+@end menu
+
+@node Writing long repeats
+@subsection Writing long repeats
+
+@menu
+* Normal repeats::              
+* Manual repeat marks::         
+* Written-out repeats::         
+@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
+
+La sintaxis de una repetición simple es
+
+@example
+\repeat @var{variante} @var{número_de_repeticiones} @var{cuerpo_de_la_repetición}
+@end example
 
-Las repeticiones estándar se usan de esta forma:
+donde @var{cuerpo_de_la_repetición} es una expresión musical.
+
+Repeticiones normales sin finales alternativos:
 
 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-c1
 \repeat volta 2 { c4 d e f }
-\repeat volta 2 { f e d c }
+c2 d
+\repeat volta 2 { d4 e f g }
 @end lilypond
 
-Con finales alternativos
+Repeticiones normales con primera y segunda vez:
 
 @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 {
-  \partial 4 e |
+  \partial 4
+  e |
   \repeat volta 4 { c2 d2 | e2 f2 | }
   \alternative { { g4 g g e } { a a a a | b2. } }
 }
@@ -127,10 +149,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,47 +159,72 @@ 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[quote,ragged-right,fragment,verbatim,relative=2]
+\time 3/4
+c c c
+\set Score.voltaSpannerDuration = #(ly:make-moment 3 4)
+\repeat volta 5 { d d d }
+\alternative { { e e e f f f }
+{ g g g } }
+@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 @rlsr{Repeats}.
 
 @lilypond[verbatim,ragged-right,quote]
-\relative c''{
-  \time 3/4
-  c c c
-  \set Score.voltaSpannerDuration = #(ly:make-moment 3 4)
-  \repeat volta 5 { d d d }
-  \alternative { { e e e f f f }
-  { g g g } }
-}
+\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
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+c4 c c c
+\bar "||:" \break 
+\repeat volta 2 { c4 d e f }   
+@end lilypond
+
 consulte @ref{Bar lines} para ver más información.
 
 @seealso
 
-Referencia del programa: @internalsref{VoltaBracket},
-@internalsref{RepeatedMusic},
-@internalsref{VoltaRepeatedMusic} y
-@internalsref{UnfoldedRepeatedMusic}.
+Glosario musical:
+@rglos{repeat}.
+@c FIXME : add @rglos{volta} after glossary addition
 
-Ejemplos:
+Referencia de la notación:
+@ref{Bar lines},
+@ref{Modifying context plug-ins}.
 
-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
+Fragmentos de código:
+@rlsr{Repeats}.
 
-@lsr{repeats,volta@/-multi@/-staff@/.ly}.
+Referencia de funcionamiento interno:
+@rinternals{VoltaBracket},
+@rinternals{RepeatedMusic},
+@rinternals{VoltaRepeatedMusic},
+@rinternals{UnfoldedRepeatedMusic}.
 
+@c Ejemplos:
 
-@refbugs
+@knownissues
 
 @cindex repetición ambigua
 
@@ -194,23 +240,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
-@unnumberedsubsubsec 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 +274,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;
+consulte @ref{Formatting text}.  No olvide cambiar la fuente tipográfica,
+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,177 +292,166 @@ c4 c4
 c4 c4
 @end lilypond
 
+@c FIXME: improve visibility of bar lines link?
 
 @seealso
 
-Referencia del programa: @internalsref{VoltaBracket},
-@internalsref{RepeatedMusic},
-@internalsref{VoltaRepeatedMusic} y
-@internalsref{UnfoldedRepeatedMusic}.
+Referencia de la notación:
+@ref{Bar lines}.
 
+Fragmentos de código:
+@rlsr{Repeats}.
 
-@node Repeats and MIDI
-@unnumberedsubsubsec Repeats and MIDI
+Referencia del programa: @rinternals{VoltaBracket},
+@rinternals{RepeatedMusic}, @rinternals{VoltaRepeatedMusic} y
+@rinternals{UnfoldedRepeatedMusic}.
 
-@cindex expansión de repeticiones
-@funindex \unfoldRepeats
 
-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 Written-out repeats
+@subsubsection Written-out 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' }
-  }
-}
-\bar "|."
-@end lilypond
+unfold
 
-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,
 
-@example
-\score @{
-  @var{..música..}
-  \layout @{ .. @}
-@}
-\score @{
-  \unfoldRepeats @var{..música..}
-  \midi @{ .. @}
-@}
-@end example
 
 
-@node Other repeats
-@subsection Other repeats
+@node Short repeats
+@subsection Short repeats
 
 @menu
+* Percent repeats::             
 * Tremolo repeats::             
-* Tremolo subdivisions::        
-* Measure repeats::             
 @end menu
 
-@node Tremolo repeats
-@unnumberedsubsubsec Tremolo repeats
+@node Percent repeats
+@subsubsection Percent repeats
 
-@cindex barras de trémolo
+@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}.
 
-Para colocar marcas de trémolo entre las notas, use @code{\repeat} con el
-estilo tremolo
 @lilypond[quote,verbatim,ragged-right]
 \new Voice \relative c' {
-  \repeat tremolo 8 { c16 d16 }
-  \repeat tremolo 4 { c16 d16 }
-  \repeat tremolo 2 { c16 d16 }
+  \repeat percent 4 { c4 }
+  \repeat percent 2 { c2 es2 f4 fis4 g4 c4 }
 }
 @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
+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
 
-Se obtiene una salida similar usando la subdivisión del trémolo, que se describe en
-@ref{Tremolo subdivisions}.
+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
 
-@seealso
 
-En el presente manual: @ref{Tremolo subdivisions}, @ref{Repeats}.
+@seealso
 
-Referencia del programa: @internalsref{Beam}, @internalsref{StemTremolo}.
+Fragmentos de código:
+@rlsr{Repeats}.
 
+Referencia del programa:
+@rinternals{RepeatSlash},
+@rinternals{PercentRepeat},
+@rinternals{DoublePercentRepeat},
+@rinternals{DoublePercentRepeatCounter},
+@rinternals{PercentRepeatCounter},
+@rinternals{PercentRepeatedMusic}.
 
-@node Tremolo subdivisions
-@unnumberedsubsubsec Tremolo subdivisions
+@node Tremolo repeats
+@subsubsection Tremolo repeats
 
-@cindex marcas de trémolo
-@funindex tremoloFlags
+@cindex barras de trémolo
 
-Las marcas de trémolo se pueden imprimir sobre una nota única 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})
+Para colocar marcas de trémolo entre las notas, use @code{\repeat} con
+el estilo @code{tremolo} (trémolo):
 
-@lilypond[quote,ragged-right,verbatim,fragment]
-c'2:8 c':32 | c': c': |
+@lilypond[quote,verbatim,ragged-right]
+\new Voice \relative c' {
+  \repeat tremolo 8 { c16 d16 }
+  \repeat tremolo 4 { c16 d16 }
+  \repeat tremolo 2 { c16 d16 }
+}
 @end lilypond
 
+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.
 
-@refbugs
+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.
 
-Los trémolos escritos de esta forma no se trasladan a la salida MIDI.
+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
 
-@seealso
-
-En el presente manual: @ref{Tremolo repeats}.
-
-En otros lugares: @internalsref{StemTremolo}.
-
-
-@node Measure repeats
-@unnumberedsubsubsec Measure repeats
-
-@cindex porcentaje, repeticiones de
-@cindex compás, repeticiones de
+@cindex trémolo, indicaciones de
+@funindex tremoloFlags
 
-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}.
+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 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,verbatim,ragged-right]
-\new Voice \relative c' {
-  \repeat percent 4 { c4 }
-  \repeat percent 2 { c2 es2 f4 fis4 g4 c4 }
-}
+@lilypond[quote,ragged-right,verbatim,fragment]
+c'2:8 c':32 | c': c': |
 @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
+@knownissues
 
 
+Los trémolos que se escriben con @q{@code{:}[@var{número}]} no se
+trasladan hacia la salida MIDI.
 
-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
+@seealso
 
+Referencia de la notación:
+@ref{Tremolo repeats}.
 
+Referencia de funcionamiento interno:
+@rinternals{Beam},
+@rinternals{StemTremolo}.
 
+Fragmentos de código:
+@rlsr{Repeats}.
+
+En otros lugares:
+@rinternals{StemTremolo}.
 
-@seealso
 
-Referencia del programa: @internalsref{RepeatSlash},
-@internalsref{PercentRepeat}, @internalsref{DoublePercentRepeat},
-@internalsref{DoublePercentRepeatCounter},
-@internalsref{PercentRepeatCounter},
-@internalsref{PercentRepeatedMusic}.