Run scripts/auxiliar/update-with-convert-ly.sh

[lilypond.git] / Documentation / fr / notation / repeats.itely

@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-

@ignore
    Translation of GIT committish: a59d022ee65e8310ea16954da7b637c07ca00ae2

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

@c Translators: Valentin Villenave, Jean-Charles Malahieude
@c Translation checkers: Jean-Charles Malahieude, John Mandereau

@node Répétitions et reprises
@section Répétitions et reprises
@translationof Repeats

@lilypondfile[quote]{repeats-headword.ly}

@cindex reprises
@cindex répétitions

La répétition est une notion essentielle en musique, et il existe de
nombreuses façons de mettre en œuvre et noter ce concept.  LilyPond
prend en charge les types de répétition suivants :

@table @code
@item volta
Le passage répété n'est pas développé, mais il est encadré par des
barres de reprise et peut se terminer par plusieurs fins
alternatives -- ou @emph{volte} -- imprimées de gauche à droite sous
des crochets.  Lorsque la répétition commence au début de la pièce,
aucune barre de reprise n'est gravée au début de la partition.  Il
s'agit de la notation courante des reprises avec fins alternatives.

@item unfold
La musique répétée est développée dans la partition autant de fois
qu'indiqué.  Ceci est particulièrement utile pour de la musique
répétitive.

@item percent
Des barres obliques ou signes de pourcentage indiquent la répétition
de temps ou de mesures.

@item tremolo
Ce type permet de réaliser des trémolos sous forme de liens de croches.

@end table

@menu
* Répétition d'un long passage::
* Autres types de répétition::
@end menu


@node Répétition d'un long passage
@subsection Répétition d'un long passage
@translationof Long repeats

Cette section présente la syntaxe des répétitions longues --
c'est-à-dire plusieurs mesures.  Ces répétitions peuvent prendre deux
formes : encadrées par des barres de reprises, ou bien développées dans
la partition.  Les barres et autres signes de reprise peuvent être
contrôlés manuellement.

@menu
* Répétitions courantes::
* Indications de reprise manuelles::
* Répétitions explicites::
@end menu

@cindex volta
@cindex fois, première
@cindex première fois
@cindex seconde fois
@cindex reprise courante
@cindex reprise avec alternative
@cindex fin alternative
@cindex alternative, reprise

@funindex \repeat
@funindex \alternative
@funindex \partial


@node Répétitions courantes
@unnumberedsubsubsec Répétitions courantes
@translationof Normal repeats

On peut indiquer une répétition de la façon suivante :

@example
\repeat volta @var{nombre_de_fois} @var{expression_musicale}
@end example

@noindent
où @code{@var{expression_musicale}} représente ce qui doît être répété.

Les reprises courantes, sans alternative, s'indiquent comme ceci :

@lilypond[verbatim,quote,relative=2]
\repeat volta 2 { c4 d e f }
c2 d
\repeat volta 2 { d4 e f g }
@end lilypond

Aucun « début » de reprise n'est indiqué par défaut pour la première
mesure d'un morceau.  Vous pouvez cependant ajouter une barre de reprise
avec un @code{\bar ".|:"} avant la première note.

@lilypond[verbatim,fragment,quote,relative=2]
\repeat volta 2 { \bar ".|:" c4 d e f }
c2 d
\repeat volta 2 { d4 e f g }
@end lilypond

On peut ajouter une fin alternative à l'aide de la commande
@code{\alternative}.  Chaque @code{@var{alternative}} est une expression
musicale en elle-même ; il faudra donc les regrouper par des accolades.

@example
\repeat volta @var{nombre_de_fois} @var{expression_musicale}
\alternative @{
  @{ @var{expression_musicale} @}
@}
@end example

Si l'on donne trop peu d'alternatives en regard du nombre de fois où le
passage doit être rejoué, la première alternative sera jouée plusieurs
fois.

Voici une simple reprise avec une fin alternative :

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

Et une répétition avec plusieurs alternatives :

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

@warning{Lorsqu'il y a plus d'une alternative, prenez garde à ce
qu'aucun caractère n'apparaisse entre l'accolade fermant une alternative
et l'accolade ouvrant la suivante, au risque de ne pas obtenir le nombre
voulu d'alternatives.}

@warning{Une clause @code{@bs{}relative} ne doit jamais se trouver à
l'intérieur d'une section @code{@bs{}repeat} : vous aurez
immanquablement des portées parasites.  Voir
@rprogram{Apparition d'une portée supplémentaire}.}

@cindex reprise avec levée
@cindex levée dans une reprise
@cindex anacrouse et reprise
@cindex reprise et anacrouse

@funindex \partial

Lorsqu'une reprise sans fin alternative débute au milieu d'une mesure,
elle devrait se terminer aussi au milieu d'une mesure, de telle sorte
que les mesures soient complètes.  En pareil cas, les indications de
reprise ne constituent pas des barres de mesure à proprement parler ; il
n'est donc pas nécessaire de faire appel à la commande @code{\partial}
ou à des contrôles d'intégrité de mesure.

@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

Il est possible de créer des reprises en début de morceau avec une
levée.  Le cas est similaire à ce que nous venons de voir.  Toutefois,
l'utilisation d'un @code{\partial} est ici nécessaire pour respecter
cette entame.

@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

@cindex reprise et liaison de prolongation
@cindex alternative et liaison de prolongation
@cindex liaison de prolongation et reprise
@cindex liaison de prolongation et alternative

@funindex \repeatTie

Des liaisons de tenue peuvent être ajoutées à toute alternative :

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

@cindex reprise et segno
@cindex segno et reprise
@funindex \inStaffSegno

La commande @code{\inStaffSegno} permet de générer une barre de mesure
composite par l'adjonction d'un symbole de @emph{segno} à une barre de
reprise créée par une commande @code{\repeat volta}.  Qu'il s'agisse
d'un début, d'une fin ou d'une double reprise, le type de barre est
automatiquement sélectionné.  L'indication « D.S. » devra cependant être

En dehors de toute reprise :

@lilypond[verbatim,quote,relative=1]
e1
\inStaffSegno
f2 g a b
c1_"D.S." \bar "|."
@end lilypond

Au début d'une reprise :

@lilypond[verbatim,quote,relative=1]
e1
\repeat volta 2 {
  \inStaffSegno  % start repeat
  f2 g a b
}
c1_"D.S." \bar "|."
@end lilypond

En fin de reprise :

@lilypond[verbatim,quote,relative=1]
e1
\repeat volta 2 {
  f2 g a b
  \inStaffSegno  % end repeat
}
f2 g a b
c1_"D.S." \bar "|."
@end lilypond

Entre deux reprises :

@lilypond[verbatim,quote,relative=1]
e1
\repeat volta 2 {
  f2 g a b
}
\inStaffSegno  % double repeat
\repeat volta 2 {
  f2 g a b
}
c1_"D.S." \bar "|."
@end lilypond

Des symboles alternatifs de barre de mesure sont aussi accessibles, dans
un contexte @code{Score}, à l'aide des propriétés @code{segnoType},
@code{startRepeatSegnoType}, @code{endRepeatSegnoType} ou
@code{doubleRepeatSegnoType} selon les besoins.  Ces types de barre
alternative doivent être choisis parmi les types prédéfinis ou
préalablement créés à l'aide d'une commande @code{\defineBarLine} --
voir @ref{Barres de mesure}.

@lilypond[verbatim,quote,relative=1]
\defineBarLine ":|.S[" #'(":|." "S[" "")
\defineBarLine "]" #'("]" "" "")
e1
\repeat volta 2 {
  f2 g a b
  \once \set Score.endRepeatSegnoType = ":|.S["
  \inStaffSegno
}
f2 g \bar "]" a b
c1_"D.S." \bar "|."
@end lilypond

@snippets
@lilypondfile[verbatim,quote,texidoc,doctitle]
{shortening-volta-brackets.ly}

@lilypondfile[verbatim,quote,texidoc,doctitle]
{adding-volta-brackets-to-additional-staves.ly}

@lilypondfile[verbatim,quote,texidoc,doctitle]
{setting-the-double-repeat-default-for-volte.ly}

@cindex reprises et numéros de mesure
@cindex numéro de mesure et reprise
@cindex mesure, numérotation et reprises

@lilypondfile[verbatim,quote,texidoc,doctitle]
{alternative-bar-numbering.ly}

@seealso
Glossaire musicologique :
@rglosnamed{repeat,répétition},
@rglos{volta}.

Manuel de notation :
@ref{Barres de mesure},
@ref{Modification des greffons de contexte},
@ref{Modification des liaisons},
@ref{Gestion du temps}.

Fichiers d'initialisation :
@file{ly/engraver-init.ly}.

Morceaux choisis :
@rlsrnamed{Repeats,Répétitions}.

Référence des propriétés internes :
@rinternals{VoltaBracket},
@rinternals{RepeatedMusic},
@rinternals{VoltaRepeatedMusic},
@rinternals{UnfoldedRepeatedMusic}.

@knownissues
@cindex reprises ambigües
@cindex reprises imbriquées
@cindex imbrication de reprises
@cindex numéro de mesure et reprises
@cindex reprises et liaison
@cindex liaison et reprises
@cindex glissando et reprises
@cindex reprises et glissando

L'extension d'une liaison à partir d'un bloc @code{\repeat} sur un bloc
@code{\alternative} n'est possible que pour la première alternative.
L'aspect visuel d'une liaison se continuant dans les autres
alternatives, peut être simulée à l'aide de la commande
@code{\repeatTie} lorsqu'elle s'arrête sur sa première note --
méthode qui cependant ne fonctionne pas pour un @code{TabStaff}.
D'autres moyens existent pour indiquer la prolongation d'une
liaison sur des alternatives, y compris dans un @code{TabStaff},
en suivant les préceptes donnés à la rubrique
@ref{Modification des liaisons}.

Selon le même principe, une liaison ne saurait partir de la fin d'une
alternative pour se terminer au début de la reprise.

L'extension d'un glissando à partir d'un bloc @code{\repeat} sur
un bloc @code{\alternative} n'est possible que pour la première
alternative.  L'aspect visuel d'un glissando se continuant dans
les autres alternatives peut être simulé à l'aide d'un glissando
partant d'une note d'ornement supplémentaire et masquée.  Un
exemple se trouve à la rubrique @ref{Glissando}.

Le développement, à l'aide de la commande @code{\unfoldRepeats}, d'une
répétition qui commence sur une mesure incomplète et contient un bloc
@code{alternative} avec modification de la propriété
@code{measureLength} entraînera des messages d'erreur concernant le
placement des barres de mesure.

Des reprises imbriquées telles que

@example
\repeat @dots{}
\repeat @dots{}
\alternative
@end example

@noindent
présentent une ambiguïté, dans la mesure où l'on ne sait à quelle
section @code{\repeat} attribuer la section @code{\alternative}.  Pour
résoudre cette ambiguïté, il convient de toujours insérer la commande
@code{\alternative} à l'intérieur de la section @code{\repeat}.  Il est
préférable, dans une telle situation, d'utiliser des accolades pour plus
de clarté.


@node Indications de reprise manuelles
@unnumberedsubsubsec Indications de reprise manuelles
@translationof Manual repeat marks

@cindex reprise manuelle

@funindex repeatCommands
@funindex start-repeat

@warning{Les méthodes présentées dans les lignes qui suivent ne
devraient servir à indiquer que des constructions de répétition
inhabituelles.  En règle générale, il vaut mieux recourir à la fonction
@code{@bs{}repeat} pour créer une reprise ou bien insérer la barre de
mesure adéquate.   Pour plus d'information, voir le chapitre
@ref{Barres de mesure}.}

La propriété @code{repeatCommands} sert à contrôler la mise en forme des
reprises.  On la définit par une suite de commandes de reprise Scheme.

@table @code
@item start-repeat
Pour imprimer une barre de reprise @code{.|:}

@lilypond[verbatim,quote,relative=2]
c1
\set Score.repeatCommands = #'(start-repeat)
d4 e f g
c1
@end lilypond

Traditionnellement, on n'imprime pas de signe de reprise en début de
morceau.

@item end-repeat
Pour imprimer une barre de reprise @code{:|.}

@lilypond[verbatim,quote,relative=2]
c1
d4 e f g
\set Score.repeatCommands = #'(end-repeat)
c1
@end lilypond

@item (volta @var{nombre}) @dots{} (volta #f)
Pour obtenir un crochet indiquant le numéro de l'alternative.  Pour que
le crochet s'imprime effectivement, il faut spécifier explicitement
l'endroit où il doit se terminer.

@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

Plusieurs commandes de reprise peuvent intervenir au même moment :

@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 alternative et texte
@cindex texte et alternative

Le crochet indiquant une alternative peut contenir aussi du texte.  Il
peut s'agir d'un ou plusieurs nombres ou bien d'une indication textuelle
(@emph{markup}) -- voir @ref{Mise en forme du texte}.  Le plus simple,
dans le cas d'une indication textuelle, est de tout d'abord définir ce
@emph{markup}, puis de l'inclure dans une liste Scheme.

@lilypond[verbatim,quote]
voltaAdLib = \markup { 1. 2. 3... \text \italic { ad lib. } }
\relative {
  c''1
  \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

@seealso
Manuel de notation :
@ref{Barres de mesure},
@ref{Mise en forme du texte}.

Morceaux choisis :
@rlsrnamed{Repeats,Répétitions}.

Référence des propriétés internes :
@rinternals{VoltaBracket},
@rinternals{RepeatedMusic},
@rinternals{VoltaRepeatedMusic}.


@node Répétitions explicites
@unnumberedsubsubsec Répétitions explicites
@translationof Written-out repeats

@cindex musique répétitive
@cindex reprise, expansion
@cindex expansion de reprise

@funindex \repeat unfold
@funindex unfold

Adjoindre à la commande @code{\repeat} l'opion @code{unfold} permet de
s'affranchir de ressaisir de la musique répétitive.  En voici la
syntaxe :

@example
\repeat unfold @var{nombre_de_fois} @var{expression_musicale}
@end example

@noindent
Le contenu de @var{expression_musicale} sera donc expansé autant de fois
que stipulé par @var{nombre_de_fois}.

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

Dans certains cas, et tout particulièrement dans un contexte
@code{\relative}, la fonction @code{\repeat unfold} ne revient pas à
écrire littéralement la même expression musicale plusieurs fois.
Ainsi :

@example
\repeat unfold 2 @{ a'4 b c @}
@end example

n'est pas équivalent à

@example
a'4 b c | a'4 b c
@end example

Une répétition expansée peut aussi avoir une fin alternative :

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

Si l'on donne trop peu d'alternatives en regard du nombre de fois où le
passage doit être rejoué, la première alternative sera jouée plusieurs
fois.

@lilypond[verbatim,quote,relative=2]
\repeat unfold 4 { c4 d e f }
\alternative {
  { c2 g' }
  { c,2 b }
  { e2 d }
 }
c1
@end lilypond

S'il y a par contre plus d'alternatives que de répétitions, les
alternatives superflues seront tout simplement ignorées et ne seront pas
imprimées.

@lilypond[verbatim,quote,relative=2]
\repeat unfold 2 { c4 d e f }
\alternative {
  { c2 g' }
  { c,2 b }
  { e2 d }
}
c1
@end lilypond

Vous pouvez imbriquer plusieurs fonctions @code{unfold}, qu'elles
comportent ou non des fins alternatives :

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

Une construction en accord peut se répéter à l'aide du symbole @code{q}
-- voir @ref{Répétition d'accords}.

@warning{L'insertion d'un @code{@bs{}relative} dans une section
@code{@bs{}repeat} sans déclaration explicite du contexte @code{Voice}
génèrera une portée supplémentaire -- voir
@rprogram{Apparition d'une portée supplémentaire}.}

@seealso
Manuel de notation :
@ref{Répétition d'accords}.

Morceaux choisis :
@rlsrnamed{Repeats,Répétitions}.

Référence des propriétés internes :
@rinternals{RepeatedMusic},
@rinternals{UnfoldedRepeatedMusic}.


@node Autres types de répétition
@subsection Autres types de répétition
@translationof Short repeats

Nous abordons ici les reprises de courte durée.  Il en existe deux
formes, à savoir la répétition d'une même note sur quelques mesures --
représentée par une barre oblique ou le signe pourcent -- et les
trémolos.

@menu
* Répétitions de mesure::
* Répétitions en trémolo::
@end menu


@node Répétitions de mesure
@unnumberedsubsubsec Répétitions de mesure
@translationof Percent repeats

@cindex pourcent, répétition
@cindex mesure, répétition de
@cindex répétition, pourcent
@cindex répétition de mesure
@cindex répétition courte

@funindex \repeat percent
@funindex percent

Le style de « reprise en pourcent » sert à répéter une séquence de
notes.  Elle sera imprimée une fois, puis remplacée par un symbole
spécial.

En voici la syntaxe :

@example
\repeat percent @var{nombre} @var{expression_musicale}
@end example

Les séquences inférieures à une mesure sont remplacées par une barre
oblique.

@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

Les séquences d'une ou deux mesures sont remplacées par un
symbole qui ressemble au symbole de pourcentage.

@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

Les séquences inférieures à la mesure et qui contiennent des durées
différentes sont remplacées par un double symbole de pourcentage.

@lilypond[verbatim,quote,relative=2]
\repeat percent 4 { c8. <d f>16 }
\repeat percent 2 { \tuplet 3/2 { r8 c d } e4 }
@end lilypond

@snippets
@lilypondfile[verbatim,quote,texidoc,doctitle]
{percent-repeat-counter.ly}

@lilypondfile[verbatim,quote,texidoc,doctitle]
{percent-repeat-count-visibility.ly}

@lilypondfile[verbatim,quote,texidoc,doctitle]
{isolated-percent-repeats.ly}

@seealso
Glossaire musicologique :
@rglos{percent repeat},
@rglos{simile}.

Morceaux choisis :
@rlsrnamed{Repeats,Répétitions}.

Référence des propriétés internes :
@rinternals{RepeatSlash},
@rinternals{RepeatSlashEvent},
@rinternals{DoubleRepeatSlash},
@rinternals{PercentRepeat},
@rinternals{PercentRepeatCounter},
@rinternals{PercentRepeatedMusic},
@rinternals{Percent_repeat_engraver},
@rinternals{DoublePercentEvent},
@rinternals{DoublePercentRepeat},
@rinternals{DoublePercentRepeatCounter},
@rinternals{PercentRepeatCounter},
@rinternals{PercentRepeatedMusic}.
@rinternals{Double_percent_repeat_engraver},
@rinternals{Slash_repeat_engraver}.


@node Répétitions en trémolo
@unnumberedsubsubsec Répétitions en trémolo
@translationof Tremolo repeats

@cindex trémolo
@cindex trémolo, ligatures de

@funindex \repeat tremolo
@funindex tremolo

Il y a deux formes de trémolo : la répétition alernative de deux
notes ou accords, et la répétition rapide d'une seule note ou d'un
accord.  Lorsqu'il est constitué d'une alternance répétitive, le trémolo
s'indique en ajoutant des barres de ligature entre les deux notes ou
accords concernés.  Lorsqu'il s'agit d'une répétition rapide, des barres
de ligature penchées sont ajoutées à la note en question.

On peut placer une notation de trémolo entre deux notes, avec la
commande @code{\repeat} suivie du style 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 syntaxe de @code{\repeat tremolo} requiert expressément deux notes
encadrées par des accolades, et le nombre de répétitions exprimé en
durée d'une note (pointée ou non).  Ainsi, dans l'exemple ci-dessus,
@code{\repeat tremolo 7} est valide car correspond à une note
doublement pointée, à l'inverse de @code{\repeat tremolo 9}.

La durée d'un trémolo est égale à la durée de l'expression entre
accolades multipliée par le nombre de fois à répéter :
@code{\repeat tremolo 8 @{ c16 d16 @}} correspond donc à la valeur d'une
ronde, et sera représenté par deux rondes séparées par des barres de
trémolo.

On peut indiquer de la même manière un trémolo sur une seule note, qu'il
faudra alors laisser sans accolades :

@lilypond[quote,verbatim,ragged-right]
\repeat tremolo 4 c'16
@end lilypond

@cindex trémolo, indication de

@funindex tremoloFlags
@funindex :

Le même résultat s'obtient en faisant suivre la note considérée
de deux points et d'un nombre (@w{@code{note:@var{nombre}}}).
Le nombre en question correspond à la valeur de la subdivision ;
il doit être au moins de 8, auquel cas la hampe sera barrée par un
seul trait de ligature.  Si ce nombre est omis, la dernière valeur sera
utilisée.

@lilypond[quote,verbatim,relative=2]
c2:8 c:32
c: c:
@end lilypond

@snippets
@lilypondfile[verbatim,quote,texidoc,doctitle]
{cross-staff-tremolos.ly}

@seealso
Morceaux choisis :
@rlsrnamed{Repeats,Répétitions}.

@cindex tremolo, cross-staff
@cindex cross-staff tremolo