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

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

@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
@ignore
    Translation of GIT committish: 41ef91786a08102d9b9a839f6a2f40cec263d723

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

@node Repeats
@section 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 @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
* Long repeats::
* Short repeats::
@end menu

@node Long repeats
@subsection 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
* Normal repeats::
* Manual repeat marks::
* Written-out repeats::
@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 Normal repeats
@unnumberedsubsubsec 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

donde @var{cuerpo_de_la_repetición} es una expresión musical.  Los
finales alternativos se pueden obtener utilizando @code{\alternative}.
Para delimitar los finales alternativos, el grupo de alternativas se
debe incluir dentro de un par de llaves.  Si existen más repeticiones
que finales alternativos, las primeras repeticiones recibirán la
primera alternativa.


Repeticiones normales 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

Repeticiones normales con primera y segunda vez:

@lilypond[verbatim,quote,relative=2]
\repeat volta 4 { c4 d e f }
\alternative {
  { d2 e }
  { f2 g }
}
c1
@end lilypond


@cindex repetición con anacrusa
@cindex anacrusa en repeticiones
@funindex \partial

Las repeticiones con anacrusa se pueden introducir de dos formas:

@lilypond[verbatim,quote,relative=2]
\partial 4
e |
\repeat volta 4 { c2 d | e2 f | }
\alternative {
  { g4 g g e }
  { a4 a a a | b2. }
}
@end lilypond

@noindent
o bien

@lilypond[verbatim,quote,relative=2]
\partial 4
\repeat volta 4 { e4 | c2 d | e2 f | }
\alternative {
  { \partial 4*3 g4 g g }
  { a4 a a a | b2. }
}
@end lilypond


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


@seealso
Glosario musical:
@rglos{repeat},
@rglos{volta}.

Referencia de la notación:
@ref{Bar lines},
@ref{Modifying context plug-ins}.

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

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.

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 tampoco
se repiten.



@node Manual repeat marks
@unnumberedsubsubsec 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{\\repeat} o
imprimiendo las barras de compás correspondientes.  Para ver más
información, consulte @ref{Bar lines}.}

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{Formatting text}.  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{Bar lines},
@ref{Formatting text}.

Fragmentos de código:
@rlsr{Repeats}.

Referencia de funcionamiento interno:
@rinternals{VoltaBracket},
@rinternals{RepeatedMusic},
@rinternals{VoltaRepeatedMusic}.


@node Written-out repeats
@unnumberedsubsubsec 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

donde @var{expresión_musical} es una expresión musical y
@var{número_de_repeticiones} es el número de veces que
@var{expresión_musical} se repite.

@lilypond[verbatim,quote,relative=2]
c1
\repeat unfold 2 { c4 d e f }
c1
@end lilypond

Se pueden hacer repeticiones desplegadas con finales alternativos.  Si
hay más repeticiones que finales alternativos, el primer final
alternativo se aplica a las primeras repeticiones.

@lilypond[verbatim,quote,relative=2]
c1
\repeat unfold 2 { g4 f e d }
  \alternative {
    { cis2 g' }
    { cis,2 b }
  }
c1
@end lilypond


@seealso
Fragmentos de código:
@rlsr{Repeats}.

Referencia de funcionamiento interno:
@rinternals{RepeatedMusic},
@rinternals{UnfoldedRepeatedMusic}.


@node Short repeats
@subsection Short repeats

Esta sección trata de cómo introducir repeticiones cortas.  Las
repeticiones cortas adoptan dos formas básicas: repeticiones desde una
sola nota hasta dos compases representadas por barras inclinadas o
símbolos de porcentaje, y trémolos.

@menu
* Percent repeats::
* Tremolo repeats::
@end menu

@node Percent repeats
@unnumberedsubsubsec 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

Están contempladas las repeticiones de patrones cortos de notas.  La
música se imprime una sola vez, y el patrón se sustituye por un
símbolo especial.  Los patrones que son más cortos de un compás se
sustituyen por barras inclinadas, y los patrones de uno o dos compases
se sustituyen por símbolos de tipo porcentaje.  La sintaxis es:

@example
@code{\repeat percent @var{número} @var{expresión_musical}}
@end example

donde @var{expresión_musical} es una expresión musical.

@lilypond[verbatim,quote,relative=2]
\repeat percent 4 { c4 }
\repeat percent 2 { b4 a g f }
\repeat percent 2 { c2 es | f4 fis g c | }
@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{PercentRepeat},
@rinternals{DoublePercentRepeat},
@rinternals{DoublePercentRepeatCounter},
@rinternals{PercentRepeatCounter},
@rinternals{PercentRepeatedMusic}.


@knownissues

Sólo están contempladas tres clases de repeticiones del tipo
porcentaje: una barra inclinada única que representa un solo pulso
(sin que importe la duración de las notas repetidas); una sola barra
inclinada con puntos que representa un compás completo; y dos barras
con puntos que cruzan a una línea divisoria y que representa dos
compases completos.  No están contempladas ni varias barras inclinadas
que representan repeticiones de un pulso consistentes en semicorcheas
o figuras menores, ni dos barras con puntos que representan
repeticiones de un solo pulso consistentes en notas de duraciones
variables.


@node Tremolo repeats
@unnumberedsubsubsec 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
@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,relative=2]
c2:8 c:32
c: c:
@end lilypond


@seealso
Fragmentos de código:
@rlsr{Repeats}.


@cindex trémolos de pentagrama cruzado
@cindex pentagrama cruzado, trémolo de


@knownissues

Los trémolos de pentagrama cruzado no funcionan bien.