]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/es/notation/repeats.itely
resolve merge
[lilypond.git] / Documentation / es / notation / repeats.itely
diff --git a/Documentation/es/notation/repeats.itely b/Documentation/es/notation/repeats.itely
new file mode 100644 (file)
index 0000000..fdaf0e0
--- /dev/null
@@ -0,0 +1,750 @@
+@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
+@ignore
+    Translation of GIT committish: 85fe0f15000f793435221fab2688ba3fa65a028f
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  For details, see the Contributors'
+    Guide, node Updating translation committishes..
+@end ignore
+
+@c \version "2.14.0"
+
+@node Repeticiones
+@section Repeticiones
+@translationof Repeats
+
+@lilypondfile[quote]{repeats-headword.ly}
+
+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 volta (primera y segunda vez)
+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 finales alternativos.
+
+@item unfold (desplegada)
+Las música repetida se escribe y se interpreta completamente tantas
+veces como especifique el valor @code{@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
+
+
+@menu
+* Repeticiones largas::
+* Repeticiones cortas::
+@end menu
+
+@node Repeticiones largas
+@subsection Repeticiones largas
+@translationof Long repeats
+
+Esta sección trata sobre la forma de introducir repeticiones largas,
+normalmente de varios compases.  Las repeticiones adoptan dos formas:
+repeticiones encerradas entre signos de repetición, o repeticiones
+explícitas, que se usan para escribir música repetitiva.  También se
+pueden controlar manualmente los signos de repetición.
+
+@menu
+* Repeticiones normales::
+* Marcas de repetición manual::
+* Repeticiones explícitas::
+@end menu
+
+@cindex repeticiones normales
+@cindex repetición con finales alternativos
+@cindex finales alternativos
+@cindex volta
+@cindex prima volta
+@cindex primera y segunda vez
+@cindex seconda volta
+@cindex volta, prima
+@cindex volta, seconda
+@funindex \repeat
+@funindex \alternative
+@funindex \partial
+
+@node Repeticiones normales
+@unnumberedsubsubsec Repeticiones normales
+@translationof Normal repeats
+
+La sintaxis de una repetición normal es
+
+@example
+\repeat volta @var{número_de_repeticiones} @var{expresión_musical}
+@end example
+
+@noindent
+donde @code{@var{expresión_musical}} es una expresión musical.
+
+Una repetición simple sin finales alternativos:
+
+@lilypond[verbatim,quote,relative=2]
+\repeat volta 2 { c4 d e f }
+c2 d
+\repeat volta 2 { d4 e f g }
+@end lilypond
+
+Los filanes alternativos (casillas de primera y segunda vez)
+se pueden generar utilizando @code{\alternative}.  Cada
+grupo de alternativas debe,  a su vez, estar encerrado
+entre llaves curvas.
+
+@example
+\repeat volta @var{número_de_repeticiones} @var{expresión_musical}
+\alternative @{
+  @{ @var{expresión_musical} @}
+@}
+@end example
+
+@noindent
+donde @code{@var{expresión_musical}} es una expresión musical.
+
+Si existen más repeticiones que finales alternativos,
+se asigna el primer final alternativo
+a las repeticiones más antiguas.
+
+Repetición única con primera y segunda vez:
+
+@lilypond[verbatim,quote,relative=2]
+\repeat volta 2 { c4 d e f | }
+\alternative {
+  { c2 e | }
+  { f2 g | }
+}
+c1
+@end lilypond
+
+
+Repetición única con primera y segunda vez,
+con más de un final alternativo:
+
+@lilypond[verbatim,quote,relative=2]
+\repeat volta 4 { c4 d e f | }
+\alternative {
+  { c2 e | }
+  { f2 g | }
+}
+c1
+@end lilypond
+
+Más de una repetición con más de un final alternativo:
+
+@lilypond[verbatim,quote,relative=2]
+\repeat volta 3 { c4 d e f | }
+\alternative {
+  { c2 e | }
+  { f2 g | }
+  { a2 g | }
+}
+c1
+@end lilypond
+
+@warning{Si hay dos o más alternativas, no debe aparecer
+nada entre la llave de cierre de una y la de apertura de la otra
+dentro de un bloque @code{@bs{}alternative}, pues en caso
+contrario no obtendremos el número de finales esperado.}
+
+@warning{Si incluimos @code{@bs{}relative} dentro de un
+@code{@bs{}repeat} sin instanciar el contexto
+@code{Voice} explícitamente,
+aparecerán pentagramas adicionales no deseados.
+Véase @rprogram{Aparece un pentagrama de más}.}
+
+@cindex repetición con anacrusa
+@cindex anacrusa en repeticiones
+@funindex \partial
+
+Si una repetición comienza en medio de un compás y no tiene finales
+alternativos (primera y segunda vez), normalmente el final de la
+repetición también caerá en el medio de un compás, de forma que el
+comienzo y el final formen un compás completo.  En tales casos, los
+signos de repetición no son verdaderas líneas divisorias.  No utilice
+instrucciones @code{\partial} o comprobaciones de compás en los
+lugares en que se imprimen estos símbolos de repetición:
+
+@lilypond[verbatim,quote,relative=1]
+% no \partial here
+c4 e g  % no bar check here
+% no \partial here
+\repeat volta 4 {
+  e4 |
+  c2 e |
+  % no \partial here
+  g4 g g  % no bar check here
+}
+% no \partial here
+g4 |
+a2 a |
+g1 |
+@end lilypond
+
+De forma similar, si una repetición compienza con el compás de
+anacrusa inicial de una partitura y no tiene finales alternativos, se
+dan las mismas condiciones que en el ejemplo anterior, excepto que en
+este caso se necesita la instrucción @code{\partial} al principio de
+la partitura:
+
+@lilypond[verbatim,quote,relative=1]
+\partial 4  % required
+\repeat volta 4 {
+  e4 |
+  c2 e |
+  % no \partial here
+  g4 g g  % no bar check here
+}
+% no \partial here
+g4 |
+a2 a |
+g1 |
+@end lilypond
+
+Cuando se añaden primera y segunda vez a una repetición que comienza
+con un compás incompleto, se hace necesario establecer la propiedad de
+contexto @code{Timing.measureLength} manualmente, en los siguiente
+lugares específicos:
+
+@itemize
+@item
+en el comienzo de los complases incompletos del bloque
+@code{\alternative}, que normalmente se producen al final de cada
+final alternativo, excepto (en la mayoría de los casos) el último de
+ellos.
+
+@item
+en el comienzo de cada uno de los finales alternativos, excepto el
+primero.
+@end itemize
+
+@lilypond[verbatim,quote,relative=1]
+\partial 4
+\repeat volta 2 { e4 | c2 e | }
+\alternative {
+  {
+    f2 d |
+    \set Timing.measureLength = #(ly:make-moment 3 4)
+    g4 g g  % optional bar check is allowed here
+  }
+  {
+    \set Timing.measureLength = #(ly:make-moment 4 4)
+    a2 a |
+  }
+}
+g1 |
+@end lilypond
+
+La propiedad @code{measureLength} se describe en @ref{Gestión del
+tiempo}.
+
+@cindex repeticiones con ligaduras
+@cindex primera y segunda vez con ligaduras
+@cindex ligaduras en las repeticiones
+@cindex ligaduras en primera y segunda vez
+@funindex \repeatTie
+
+Se pueden añadir ligaduras de unión al segundo final:
+
+@lilypond[verbatim,quote,relative=2]
+c1
+\repeat volta 2 { c4 d e f~ }
+\alternative {
+  { f2 d }
+  { f2\repeatTie f, }
+}
+@end lilypond
+
+@snippets
+
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{shortening-volta-brackets.ly}
+
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{adding-volta-brackets-to-additional-staves.ly}
+
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{setting-the-double-repeat-default-for-volte.ly}
+
+@seealso
+Glosario musical:
+@rglos{repeat},
+@rglos{volta}.
+
+Referencia de la notación:
+@ref{Barras de compás},
+@ref{Modificar los complementos (plug-ins) de contexto},
+@ref{Gestión del tiempo}.
+
+Fragmentos de código:
+@rlsr{Repeats}.
+
+Referencia de funcionamiento interno:
+@rinternals{VoltaBracket},
+@rinternals{RepeatedMusic},
+@rinternals{VoltaRepeatedMusic},
+@rinternals{UnfoldedRepeatedMusic}.
+
+
+@knownissues
+
+@cindex repetición ambigua
+@cindex anidada, repetición
+@cindex repetición anidada
+@cindex repetición, contador de tiempo de la
+@cindex repetición y números de compás
+@cindex números de compás y repeticiones
+@cindex tiempo, repeticiones y contador de
+@cindex compás, repeticiones y números de
+@cindex repetición y ligadura de expresión
+@cindex ligaduras de expresión y repeticiones
+
+Las ligaduras de expresión que abarcan desde un bloque @code{\repeat}
+hasta un bloque @code{\alternative} sólo funcionan para la casilla de
+primera vez.  Asimismo, no es posible hacer que las ligaduras de
+expresión se replieguen desde el final de una alternativa hasta el
+comienzo de la repetición.
+
+Si una repetición que comienza con un compás incompleto tiene un
+bloque @code{\alternative} que contiene modificaciones a la propiedad
+@code{measureLength}, la utilización de @code{\unfoldRepeats} dará
+lugar a líneas divisorias erróneamente colocadas y advertencias de
+comprobación de compás.
+
+Una repetición anidada como
+
+@example
+\repeat @dots{}
+\repeat @dots{}
+\alternative
+@end example
+
+@noindent
+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.
+
+
+@node Marcas de repetición manual
+@unnumberedsubsubsec Marcas de repetición manual
+@translationof Manual repeat marks
+
+
+@cindex manual, marca de repetición
+@cindex repetición manual
+@cindex comienzo de repetición
+@cindex repetición, comienzo de
+@cindex final de repetición
+@cindex repetición, final de
+@cindex repetición, cambiar número de
+@cindex repetición, cambiar finales alternativos
+@cindex corchete de primera y segunda vez
+@funindex repeatCommands
+@funindex start-repeat
+
+@warning{Estos métodos sólo se utilizan para realizar construcciones
+de repetición poco usuales, y pueden tener un comportamiento distinto
+al esperado.  En casi todas las situaciones, se deben crear las
+repeticiones utilizando la instrucción estándar @code{@bs{}repeat} o
+imprimiendo las barras de compás correspondientes.  Para ver más
+información, consulte @ref{Barras de compás}.}
+
+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.
+
+@table @code
+@item start-repeat
+Imprimir una barra de compás @code{|:}
+
+@lilypond[verbatim,quote,relative=2]
+c1
+\set Score.repeatCommands = #'(start-repeat)
+d4 e f g
+c1
+@end lilypond
+
+En la práctica habitual del grabado no se imprimen signos de
+repetición al principio de la pieza.
+
+
+@item @code{end-repeat}
+Imprimir una barra de compás @code{:|}
+
+@lilypond[verbatim,quote,relative=2]
+c1
+d4 e f g
+\set Score.repeatCommands = #'(end-repeat)
+c1
+@end lilypond
+
+@item (volta @var{number}) ... (volta #f)
+Crear una nueva casilla de repetición con el número que se especifica.
+El corchete de vez se debe terminar de forma explícita, pues en caso
+contrario no se imprimirá.
+
+@lilypond[verbatim,quote,relative=2]
+f4 g a b
+\set Score.repeatCommands = #'((volta "2"))
+g4 a g a
+\set Score.repeatCommands = #'((volta #f))
+c1
+@end lilypond
+
+@end table
+
+Se pueden producir varias instrucciones de repetición en el mismo
+punto:
+
+@lilypond[verbatim,quote,relative=2]
+f4 g a b
+\set Score.repeatCommands = #'((volta "2, 5") end-repeat)
+g4 a g a
+c1
+\set Score.repeatCommands = #'((volta #f) (volta "95") end-repeat)
+b1
+\set Score.repeatCommands = #'((volta #f))
+@end lilypond
+
+@cindex corchete de casilla de repetición con texto
+@cindex texto en casilla de repetición
+
+Se puede incluir texto dentro de la casilla de primera y segunda vez.
+El texto puede ser un número o números, o un elemento de marcado,
+véase @ref{Formatear el texto}.  La forma más fácil de usar texto de
+marcado es definir el marcado previamente, y luego incluirlo dentro de
+una lista de Scheme.
+
+@lilypond[verbatim,quote]
+voltaAdLib = \markup { 1. 2. 3... \text \italic { ad lib. } }
+\relative c'' {
+  c1
+  \set Score.repeatCommands = #(list(list 'volta voltaAdLib) 'start-repeat)
+  c4 b d e
+  \set Score.repeatCommands = #'((volta #f) (volta "4.") end-repeat)
+  f1
+  \set Score.repeatCommands = #'((volta #f))
+}
+@end lilypond
+
+
+@snippets
+
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{printing-a-repeat-sign-at-the-beginning-of-a-piece.ly}
+
+
+@seealso
+Referencia de la notación:
+@ref{Barras de compás},
+@ref{Formatear el texto}.
+
+Fragmentos de código:
+@rlsr{Repeats}.
+
+Referencia de funcionamiento interno:
+@rinternals{VoltaBracket},
+@rinternals{RepeatedMusic},
+@rinternals{VoltaRepeatedMusic}.
+
+
+@node Repeticiones explícitas
+@unnumberedsubsubsec Repeticiones explícitas
+@translationof Written-out repeats
+
+@cindex explícitas, repeticiones
+@cindex repetitiva, música
+@cindex repeticiones explícitas
+@cindex repetición desplegada
+@cindex desplegar música
+@cindex desplegar repetición
+@cindex repetición desplegada con finales alternativos
+@cindex música desplegada con finales alternativos
+@cindex alternativos, finales, en repeticiones explícitas
+@funindex unfold
+
+Mediante la utilización de la instrucción @code{unfold} se pueden usar
+las repeticiones para simplificar la escritura desplegada de música
+repetitiva.  La sintaxis es:
+
+@example
+\repeat unfold @var{número_de_repeticiones} @var{expresión_musical}
+@end example
+
+@noindent
+donde @code{@var{expresión_musical}} es una expresión musical y
+@code{@var{número_de_repeticiones}} es el número de veces que
+@code{@var{expresión_musical}} se repite.
+
+@lilypond[verbatim,quote,relative=2]
+\repeat unfold 2 { c4 d e f }
+c1
+@end lilypond
+
+Se pueden hacer repeticiones desplegadas con finales alternativos.
+
+@lilypond[verbatim,quote,relative=2]
+\repeat unfold 2 { c4 d e f }
+\alternative {
+  { c2 g' }
+  { c,2 b }
+}
+c1
+@end lilypond
+
+Si hay más repeticiones que finales alternativos, el primer final
+alternativo se aplica las veces necesarias hasta que
+las alternativas restantes completan el número total
+de repeticiones.
+
+@lilypond[verbatim,quote,relative=2]
+\repeat unfold 4 { c4 d e f }
+\alternative {
+  { c2 g' }
+  { c,2 b }
+  { e2 d }
+ }
+c1
+@end lilypond
+
+Si existen más finales alternativos que repeticiones,
+se aplican los primeros finales alternativos y LilyPond
+ignora las alternativas restantes, que no se imprimen.
+
+@lilypond[verbatim,quote,relative=2]
+\repeat unfold 2 { c4 d e f }
+\alternative {
+  { c2 g' }
+  { c,2 b }
+  { e2 d }
+}
+c1
+@end lilypond
+
+Es posible también anidar varias funciones
+@code{unfold} (con  finales alternativos o sin ellos).
+
+@lilypond[verbatim,quote,relative=2]
+\repeat unfold 2 {
+  \repeat unfold 2 { c4 d e f }
+  \alternative {
+    { c2 g' }
+    { c,2 b }
+  }
+}
+c1
+@end lilypond
+
+
+@warning{Si pone @code{@bs{}relative} dentro de un bloque
+@code{@bs{}repeat} sin instanciar explícitamente el contexto
+@code{Voice}, aparecerán pentagramas no deseados.  Véase
+@rprogram{Aparece un pentagrama de más}.}
+
+@seealso
+Fragmentos de código:
+@rlsr{Repeats}.
+
+Referencia de funcionamiento interno:
+@rinternals{RepeatedMusic},
+@rinternals{UnfoldedRepeatedMusic}.
+
+
+@node Repeticiones cortas
+@subsection Repeticiones cortas
+@translationof Short repeats
+
+Esta sección trata de cómo introducir repeticiones cortas.  Las
+repeticiones cortas pueden adoptar dos formas:
+barras inclinadas o signos de porcentaje
+si estamos representando repeticiones de una
+sola nota, un compás o dos compases,
+y trémolos en caso contrario.
+
+@menu
+* Repeticiones de compás o parte de ellos::
+* Repeticiones de trémolo::
+@end menu
+
+@node Repeticiones de compás o parte de ellos
+@unnumberedsubsubsec Repeticiones de compás o parte de ellos
+@translationof Percent repeats
+
+@cindex porcentaje, repetición de
+@cindex compás, repetición de
+@cindex repetición de porcentaje
+@cindex repetición de compás
+@cindex repetición corta
+@funindex \repeat percent
+@funindex percent
+
+Los patrones cortos que se repiten se imprimen una sola vez,
+y el patrón repetido se sustituye por un símbolo especial.
+
+La sintaxis es:
+
+@example
+\repeat percent @var{número} @var{expresión_musical}
+@end example
+
+@noindent
+donde @code{@var{expresión_musical}} es una expresión musical.
+
+Los patrones más cortos que un compás se sustituyen por
+barras inclinadas.
+
+@lilypond[verbatim,quote,relative=2]
+\repeat percent 4 { c128 d e f }
+\repeat percent 4 { c64 d e f }
+\repeat percent 5 { c32 d e f }
+\repeat percent 4 { c16 d e f }
+\repeat percent 4 { c8 d }
+\repeat percent 4 { c4 }
+\repeat percent 2 { c2 }
+@end lilypond
+
+Los patrones de repetición de uno o dos compases se sustituyen
+por signos parecidos al símbolo de porcentaje.
+
+@lilypond[verbatim,quote,relative=2]
+\repeat percent 2 { c4 d e f }
+\repeat percent 2 { c2 d }
+\repeat percent 2 { c1 }
+@end lilypond
+
+@lilypond[verbatim,quote,relative=2]
+\repeat percent 3 { c4 d e f | c2 g' }
+@end lilypond
+
+Los patrones más cortos que un compás pero que contienen
+duraciones mezcladas utilizan un símbolo de porcentaje doble.
+
+@lilypond[verbatim,quote,relative=2]
+\repeat percent 4 { c8. <d f>16 }
+\repeat percent 2 { \times 2/3 { r8 c d } e4 }
+@end lilypond
+
+@snippets
+
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{percent-repeat-counter.ly}
+
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{percent-repeat-count-visibility.ly}
+
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{isolated-percent-repeats.ly}
+
+@seealso
+Glosario musical:
+@rglos{percent repeat},
+@rglos{simile}.
+
+Fragmentos de código:
+@rlsr{Repeats}.
+
+Referencia de funcionamiento interno:
+@rinternals{RepeatSlash},
+@rinternals{RepeatSlashEvent},
+@rinternals{DoubleRepeatSlash},
+@rinternals{PercentRepeat},
+@rinternals{PercentRepeatCounter},
+@rinternals{PercentRepeatedMusic},
+@rinternals{Percent_repeat_engraver},
+@rinternals{DoublePercentEvent},
+@rinternals{DoublePercentRepeat},
+@rinternals{DoublePercentRepeatCounter},
+@rinternals{Double_percent_repeat_engraver},
+@rinternals{Slash_repeat_engraver}.
+
+
+@node Repeticiones de trémolo
+@unnumberedsubsubsec Repeticiones de trémolo
+@translationof Tremolo repeats
+
+@cindex trémolo
+@cindex barras de trémolo
+@cindex repetición de trémolo
+@funindex \repeat tremolo
+@funindex tremolo
+
+Los trémolos pueden adoptar dos formas: alternancia entre dos acordes
+o dos notas, y repetición rápida de una sola nota o acorde.  Los
+trémolos que consisten en una alternancia se indican por medio de la
+adición de barras entre las notas o acordes que se alternan, mientras
+que los trémolos que consisten en la repetición rápida de una sola
+nota se indican mediante la adición de barras cruzadas a una nota
+única.
+
+Para colocar marcas de trémolo entre las notas, use @code{\repeat} con
+el estilo @code{tremolo} (trémolo):
+
+@lilypond[quote,verbatim,relative=2]
+\repeat tremolo 8 { c16 d }
+\repeat tremolo 6 { c16 d }
+\repeat tremolo 2 { c16 d }
+@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.
+
+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.
+
+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
+
+@cindex trémolo, indicaciones de
+@funindex tremoloFlags
+@funindex :
+
+El mismo resultado se puede obtener escribiendo
+@code{:@var{N}} después de la nota, donde @code{@var{N}} indica la
+duración de la subdivisión (debe ser 8 como mínimo).  Si @code{@var{N}}
+es 8, se añade una barra de corchea a la plica de la nota.
+Si @code{@var{N}} se omite, se utiliza el último valor (almacenado en
+@code{tremoloFlags}):
+
+@lilypond[quote,verbatim,relative=2]
+c2:8 c:32
+c: c:
+@end lilypond
+
+@snippets
+
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{cross-staff-tremolos.ly}
+
+
+@seealso
+Fragmentos de código:
+@rlsr{Repeats}.
+
+@cindex trémolos de pentagrama cruzado
+@cindex pentagrama cruzado, trémolo de