--- /dev/null
+@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
+@ignore
+ Translation of GIT committish: 057106293b07b74b00553fe4dc3dfac5c1f3b682
+
+ 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"
+
+@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@tie{}:
+
+@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@tie{}: 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@tie{}:
+
+@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@tie{}:
+
+@lilypond[verbatim,quote,relative=2]
+\repeat volta 2 { 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@tie{}; 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 doît jamais se trouver à
+l'intérieur d'une section @code{@bs{}repeat}@tie{}: 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 fins alternatives 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@tie{}; 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 entâme.
+
+@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
+
+Lorsqu'une reprise débute par une mesure incomplète et a des fins
+alternatives, il est indispensable d'ajuster manuellement la propriété
+@code{Timing.measureLength} selon les préceptes suivants@tie{}:
+
+@itemize
+@item
+au début de chacune des mesures incomplètes du bloc @code{\alternative},
+ce qui est le cas en principe pour chaque fin d'alternative sauf --
+la plupart du temps -- pour la dernière.
+
+@item
+au début de chaque alternative à l'exception de la première.
+@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 propriété @code{measureLength} est abordée plus en détail au chapitre
+@ref{Gestion du temps}.
+
+@cindex reprise et liaison de prolongation
+@cindex alternative et liaison de prolongation
+@cindex liaison de prolongationt et reprise
+@cindex liaison de prolongation et alternative
+
+@funindex \repeatTie
+
+Des liaisons de tenue peuvent être ajoutées à toute alternative@tie{}:
+
+@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
+Glossaire musicologique :
+@rglosnamed{repeat,répétition},
+@rglos{volta}.
+
+Manuel de notation :
+@ref{Barres de mesure},
+@ref{Modification des greffons de contexte},
+@ref{Gestion du temps}.
+
+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 reprise et liaison
+@cindex liaison et reprise
+
+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.
+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.
+
+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 recourrir à 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 doît 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 commande de reprise peuvent intervenir au même moment@tie{}:
+
+@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
+@code{markup}, puis de l'inclure dans une liste 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
+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@tie{}:
+
+@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
+
+Une répétition expansée peut aussi avoir une fin alternative@tie{}:
+
+@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@tie{}:
+
+@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{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
+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 @qq{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@tie{}:
+
+@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 { 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 3 { c4 d e f }
+\repeat percent 4 { c2 d }
+@end lilypond
+
+@lilypond[verbatim,quote,relative=2]
+\repeat percent 3 { c4 d e f | c2 g' }
+@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
+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{PercentRepeat},
+@rinternals{DoublePercentRepeat},
+@rinternals{DoublePercentRepeatCounter},
+@rinternals{PercentRepeatCounter},
+@rinternals{PercentRepeatedMusic}.
+
+
+@knownissues
+
+LilyPond ne dispose que de trois signes différents pour indiquer une
+répétition @qq{en pourcent}@tie{}: une simple barre oblique qui
+représente un seul temps quelle que soit la durée des notes
+répétées@tie{}; une barre oblique simple entourée de points qui
+représente une mesure entière@tie{}; une double barre oblique entourée
+de points et placée sur la barre de mesure pour indiquer une répétition
+de deux mesures.
+
+@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@tie{}: 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@tie{}:
+
+@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 espressé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@tie{}tremolo@tie{}7} est valide car correspond à une note
+doublement pointée, à l'inverse de @code{\repeat@tie{}tremolo@tie{}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@tie{}:
+@code{\repeat@tie{}tremolo@tie{}8@tie{}@{@tie{}c16@tie{}d16@tie{}@}}
+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@tie{}:
+
+@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@tie{};
+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 --
+telle que mémorisée dans @code{tremoloFlags} -- sera utilisée.
+
+@lilypond[quote,verbatim,relative=2]
+c2:8 c:32
+c: c:
+@end lilypond
+
+@snippets
+
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{cross-staff-tremolos.ly}
+
+
+@seealso
+Morceaux choisis :
+@rlsrnamed{Repeats,Répétitions}.
+
+@cindex tremolo, cross-staff
+@cindex cross-staff tremolo
+
projects / lilypond.git / blobdiff