X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Ffr%2Flearning%2Ftemplates.itely;h=34fa67f93b14bc23819ebcb3ee46fcca3459f29b;hb=3af0951f9a11677240efa6228683dd4fcea13eaf;hp=3995bff9a0eaca61d17654869298872cbc3354ca;hpb=652ed35a2013489d0a14fede6307cd2595abb2c4;p=lilypond.git

diff --git a/Documentation/fr/learning/templates.itely b/Documentation/fr/learning/templates.itely
index 3995bff9a0..34fa67f93b 100644
--- a/Documentation/fr/learning/templates.itely
+++ b/Documentation/fr/learning/templates.itely
@@ -1,14 +1,14 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
 
 @ignore
-    Translation of GIT committish: 3bad1130cea3a64b2592e1bfd44fbd5f0a9a98ee
+   Translation of GIT committish: 88a5dbc589b0d0434f8e640467b5ab57d14dc461
 
-    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..
+   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.16.0"
+@c \version "2.19.25"
 
 @c Translators: Jean-Charles Malahieude
 
@@ -21,6 +21,7 @@ Lilypond, prets à l'emploi.  Il vous suffira d'y ajouter quelques notes,
 de lancer LilyPond, et d'aprécier le résultat.
 
 @menu
+* Gabarits préprogrammés::
 * Modèles pour portée unique::
 * Modèles pour piano::
 * Modèles pour quatuor à cordes::
@@ -31,6 +32,325 @@ de lancer LilyPond, et d'aprécier le résultat.
 @end menu
 
 
+@node Gabarits préprogrammés
+@appendixsec Gabarits préprogrammés
+@translationof Built-in templates
+
+LilyPond est livré avec plusieurs gabarits convenant à différentes
+configurations chorales. Ils permettent de gérer de la musique chorale
+simple, avec ou sans accompagnement de piano, présentée sur deux, quatre
+ou huit portées.  Contrairement aux autre gabarits, celui-ci est
+« préprogrammé », ce qui signifie qu'il ne nécessite pas d'être recopié
+et édité ; il suffit en fait d'ajouter une instruction @code{\include}
+au fichier source.
+
+@warning {Contrairement à la plupart des inclusions, la commande
+@code{@bs{}include} traitant ces gabarit préprogrammés doit se placer
+@strong{à la fin} du fichier source.}
+
+Les expressions musicales nécessaires sont affectées à des variables
+spécifiques.  Ces définitions doivent intervenir avant la commande
+@code{\include}.
+
+La musique peut se présenter en une ou deux voix par portée à l'aide du
+commutateur @code{TwoVoicesPerStaff} (@emph{DeuxVoixParPortée}) --
+valorisé à @code{##f} ou @code{##t} selon le cas.
+
+@menu
+* Gabarit pour chœur à quatre voix mixtes::
+* Gabarit pour double chœur à quatre voix mixtes::
+@end menu
+
+@node Gabarit pour chœur à quatre voix mixtes
+@appendixsubsec Gabarit pour chœur à quatre voix mixtes
+@translationof SATB template
+
+@cindex Choeur SATB
+
+Voici l'intégralité d'un fichier permettant d'obtenir une partition pour
+chœur à quatre voix avec paroles individuelles et accompagnement de
+piano :
+
+@lilypond[verbatim, quote]
+  SopranoMusic = \relative { a'4\f a8 a a4 a }
+  SopranoLyrics = \lyricmode { Sop -- ra -- no ly -- rics }
+  AltoMusic = \relative { d'4\f d d d }
+  AltoLyrics = \lyricmode { Al -- to ly -- rics }
+  TenorMusic = \relative { a4\p a a a }
+  TenorLyrics = \lyricmode { Te -- nor ly -- rics }
+  BassMusic = \relative { c2\p c4 c }
+  BassLyrics = \lyricmode { Bass ly -- rics }
+  PianoRHMusic = \relative { c' e g c }
+  PianoDynamics = { s2\mp s4 s4 }
+  PianoLHMusic = \relative { c e g c }
+  \include "satb.ly"
+@end lilypond
+
+Ce même fichier peut servir à générer une partition dans laquelle deux
+voix partagent une même portée, après avoir simplement commuté
+@code{TwoVoicesPerStaff} à @code{##t}.  Chaque voix dispose à nouveau de
+ses propres paroles.
+
+@lilypond[verbatim, quote]
+  SopranoMusic = \relative { a'4\f a8 a a4 a }
+  SopranoLyrics = \lyricmode { Sop -- ra -- no ly -- rics }
+  AltoMusic = \relative { d'4\f d d d }
+  AltoLyrics = \lyricmode { Al -- to ly -- rics }
+  TenorMusic = \relative { a4\p a a a }
+  TenorLyrics = \lyricmode { Te -- nor ly -- rics }
+  BassMusic = \relative { c2\p c4 c }
+  BassLyrics = \lyricmode { Bass ly -- rics }
+  PianoRHMusic = \relative { c' e g c }
+  PianoDynamics = { s2\mp s4 s4 }
+  PianoLHMusic = \relative { c e g c }
+  TwoVoicesPerStaff = ##t
+  \include "satb.ly"
+@end lilypond
+
+Désactiver @code{TwoVoicesPerStaff}, ou le laisser à sa valeur par
+défaut, et se limiter à certaines variables seulement permet d'obtenir
+un agencement pour moins de voix.  Voici, par exemple, comment saisir un
+duo soprano basse :
+
+@lilypond[verbatim,quote]
+  SopranoMusic = \relative { c'' c c c }
+  SopranoLyrics = \lyricmode { High voice ly -- rics }
+  BassMusic = \relative { a a a a }
+  BassLyrics = \lyricmode { Low voice ly -- rics }
+  \include "satb.ly"
+@end lilypond
+
+Chacune des parties peut se voir adjoindre un deuxième couplet ou des
+paroles alternatives :
+
+@lilypond[verbatim, quote]
+  SopranoMusic = \relative { a'4 a a a }
+  SopranoLyricsOne = \lyricmode {
+    \set stanza = "1."
+    Words to verse one
+  }
+  SopranoLyricsTwo = \lyricmode {
+    \set stanza = "2."
+    Words to verse two
+  }
+  \include "satb.ly"
+@end lilypond
+
+Lorsque paroles et rythme sont identiques à toutes les voix, la
+partition peut s'agencer sur deux portées, chacune comportant deux voix.
+Le gabarit préprogrammé autorise jusqu'à neuf couplets.  L'exemple
+suivant, dépourvu d'accompagnement, se contente de trois couplets.
+
+@lilypond[verbatim, quote]
+  SopranoMusic = \relative { a' a a a }
+  AltoMusic = \relative { f' f f f }
+  VerseOne = \lyricmode {
+    \set stanza = "1."
+    Words to verse one
+  }
+  VerseTwo = \lyricmode {
+    \set stanza = "2."
+    Words to verse two
+  }
+  VerseThree = \lyricmode {
+    \set stanza = "3."
+    Words to verse three
+  }
+  TenorMusic = \relative { a a a a }
+  BassMusic = \relative { f f f f }
+  TwoVoicesPerStaff = ##t
+  \include "satb.ly"
+@end lilypond
+
+Dautres variables peuvent se voir attribuer une valeur.  C'est notamment
+le cas de la tonalité et de la métrique :
+
+@lilypond[verbatim, quote]
+  Key = \key a \major
+  Time = {
+    \time 5/4
+    \tempo "Allegro" 4 = 144
+  }
+  SopranoMusic = \relative { gis' gis gis gis gis }
+  AltoMusic = \relative { cis' cis cis cis cis }
+  VerseOne = \lyricmode { Words to this du -- et }
+  TwoVoicesPerStaff = ##t
+  \include "satb.ly"
+@end lilypond
+
+Les intitulés d'instrument, ainsi que leur version abrégée, sont
+modifiables :
+
+@lilypond[verbatim,quote]
+  SopranoMusic = \relative { c'' c c c }
+  SopranoLyrics = \lyricmode { High voice ly -- rics }
+  SopranoInstrumentName = "Soprano 1"
+  SopranoShortInstrumentName = "S1"
+  AltoMusic = \relative { a' a a a }
+  AltoLyrics = \lyricmode { Low voice ly -- rics }
+  AltoInstrumentName = "Soprano 2"
+  AltoShortInstrumentName = "S2"
+  \include "satb.ly"
+@end lilypond
+
+@noindent
+bien que, dans ce cas particulier, il est plus simple d'utiliser le
+gabarit @code{ssaattbb.ly} -- voir
+@ref{Gabarit pour double chœur à quatre voix mixtes}.
+
+Une partie de soliste s'ajoute à l'aide de la variable
+@code{DescantMusic}, à laquelle s'appliqueront les paroles contenues
+dans la variable @code{DescantLyrics}.  De la même manière, une partie
+de solo peut s'ajouter au-dessus du chœur en alimentant les variables
+@code{SoloMusic} et @code{SoloLyrics}.
+
+Comme pour n'importe quelle partition, vous pouver y ajouter des blocs
+@code{\header} et @code{\paper} en tête de fichier ; leur contenu sera
+combiné (sans les remplacer) aux réglages du gabarit préprogrammé.  Tous
+les réglages par défaut du gabarit seront annulés dès lors que
+@b{toutes} ses valeurs auront été redéfinies dans une variable
+@code{Layout} :
+
+@example
+Layout = \layout @{ ... @}
+@end example
+
+Le jeu complet des variables modifiables disponibles est contenu dans le
+fichier @file{ly/satb.ly} -- voir @ref{Autres sources de documentation}.
+
+@seealso
+Manuel d'initiation :
+@ref{Autres sources de documentation},
+@ref{Extension des modèles}.
+@ref{Modèles pour ensemble vocal},
+@ref{Organisation du code source avec des variables}.
+
+@knownissues
+Les réglages de la variable @code{TwoVoicesPerStaff} (deux voix par
+portée) s'étendent à l'intégralité de la partition ; ils ne sauraient
+varier en cours de partition.
+
+Des arrangements plus complexes de partition pour chœur mixte à quatre
+voix ne sont pas réalisables avec ce gabarit préprogrammé.
+
+
+@node Gabarit pour double chœur à quatre voix mixtes
+@appendixsubsec Gabarit pour double chœur à quatre voix mixtes
+@translationof SSAATTBB template
+
+@cindex chœur SSAATTBB
+
+Ce gabarit préprogrammé dispose, à l'exception des variables
+@code{VerseXxx}, des mêmes variable que le gabarit SATB -- voir
+@ref{Gabarit pour chœur à quatre voix mixtes}.  Pour chacune des quatre
+parties, paroles et musique peuvent être dédoublées en alimentant les
+variables @code{SopranoOneMusic} et @code{SopranoTwoMusic}, etc. ainsi
+que leurs paroles associées dans @code{SopranoOneLyrics} et
+@code{SopranoTwoLyrics}, etc.  Jusqu'à quatre couplets supplémentaires
+peuvent venir s'ajouter aux paroles, à l'aide de variables de la forme
+@code{SopranoOneLyricsOne}.
+
+Le commutateur @code{TwoVoicesPerStaff}, basculé sur @code{##t},
+regroupera @b{toutes} les parties sur une même portée.  Lui laisser sa
+avaleur par défaut ou lui affecter @code{##f} laisse la possibilité de
+répartir les voix sur une ou deux portées selon le réglage de
+@code{SopranoTwoVoicesPerStaff}, @code{MenTwoVoicesPerStaff}, etc.
+
+Prenons par exmple un pièce pour soprano et alto qui commence à
+l'unisson, puis passe à deux voix (soprano et alto), lesquelles
+finissent par se diviser.  Cette partition pourrait se coder ainsi :
+
+@lilypond[verbatim,quote]
+Time = { s1 \break s1 \break }
+WomenMusic = \relative { a'4 a a a }
+WomenLyrics = \lyricmode { Wo -- men ly -- rics }
+SopranoMusic = \relative { s1 | c''4 c c c8 c }
+SopranoLyrics = \lyricmode{ So -- pra -- no ly -- rics }
+AltoMusic = \relative { s1 | g'4 g g g }
+AltoLyrics = \lyricmode { Al -- to ly -- rics }
+SopranoOneMusic = \relative { s1 | s1 |e''4 e e e }
+SopranoOneLyrics = \lyricmode { Sop One ly -- rics }
+SopranoTwoMusic = \relative { s1 | s1 | c''4 c c c }
+SopranoTwoLyrics = \lyricmode { Sop Two ly -- rics }
+AltoOneMusic = \relative { s1 | s1 | g'4 g g g8 g }
+AltoOneLyrics = \lyricmode { Al -- to One ly -- rics }
+AltoTwoMusic = \relative { s1 | s1 | e'4 e e e8 e }
+AltoTwoLyrics = \lyricmode { Al -- to Two ly -- rics }
+\layout { ragged-right = ##t }
+\include "ssaattbb.ly"
+@end lilypond
+
+Les voix d'homme s'ajouteront de la même manière.
+
+Les sopranos, une fois divisées, peuvent partager la même portée en
+basculant @code{SopranoTwoVoicesPerStaff} sur @code{##t} tout en
+laissant les autres parties inchangées, comme ici :
+
+@lilypond[verbatim,quote]
+SopranoTwoVoicesPerStaff = ##t
+Time = { s1 \break s1 \break }
+WomenMusic = \relative { a'4 a a a }
+WomenLyrics = \lyricmode { Wo -- men ly -- rics }
+SopranoMusic = \relative { s1 | c''4 c c c8 c }
+SopranoLyrics = \lyricmode{ So -- pra -- no ly -- rics }
+AltoMusic = \relative { s1 | g'4 g g g }
+AltoLyrics = \lyricmode { Al -- to ly -- rics }
+SopranoOneMusic = \relative { s1 | s1 |e''4 e e e }
+SopranoOneLyrics = \lyricmode { Sop One ly -- rics }
+SopranoTwoMusic = \relative { s1 | s1 | c''4 c c c }
+SopranoTwoLyrics = \lyricmode { Sop Two ly -- rics }
+AltoOneMusic = \relative { s1 | s1 | g'4 g g g8 g }
+AltoOneLyrics = \lyricmode { Al -- to One ly -- rics }
+AltoTwoMusic = \relative { s1 | s1 | e'4 e e e8 e }
+AltoTwoLyrics = \lyricmode { Al -- to Two ly -- rics }
+\layout { ragged-right = ##t }
+\include "ssaattbb.ly"
+@end lilypond
+
+Le regroupement de chaque pupitre divisé sur une même portée demande
+simplement d'activer @code{TwoVoicesPerStaff} :
+
+@lilypond[verbatim,quote]
+TwoVoicesPerStaff = ##t
+Time = { s1 \break s1 \break }
+WomenMusic = \relative { a'4 a a a }
+WomenLyrics = \lyricmode { Wo -- men ly -- rics }
+SopranoMusic = \relative { s1 | c''4 c c c8 c }
+SopranoLyrics = \lyricmode{ So -- pra -- no ly -- rics }
+AltoMusic = \relative { s1 | g'4 g g g }
+AltoLyrics = \lyricmode { Al -- to ly -- rics }
+SopranoOneMusic = \relative { s1 | s1 |e''4 e e e }
+SopranoOneLyrics = \lyricmode { Sop One ly -- rics }
+SopranoTwoMusic = \relative { s1 | s1 | c''4 c c c }
+SopranoTwoLyrics = \lyricmode { Sop Two ly -- rics }
+AltoOneMusic = \relative { s1 | s1 | g'4 g g g8 g }
+AltoOneLyrics = \lyricmode { Al -- to One ly -- rics }
+AltoTwoMusic = \relative { s1 | s1 | e'4 e e e8 e }
+AltoTwoLyrics = \lyricmode { Al -- to Two ly -- rics }
+\layout { ragged-right = ##t }
+\include "ssaattbb.ly"
+@end lilypond
+
+Le jeu complet des variables modifiables disponibles est contenu dans le
+fichier @file{ly/ssaattbb.ly} -- voir
+@ref{Autres sources de documentation}.
+
+@seealso
+Manuel d'initiation :
+@ref{Autres sources de documentation},
+@ref{Extension des modèles}.
+@ref{Modèles pour ensemble vocal},
+@ref{Organisation du code source avec des variables}.
+
+@knownissues
+Les réglages des variables @code{...TwoVoicesPerStaff} (deux voix par
+portée) s'étendent à l'intégralité de la partition ; ils ne sauraient
+varier en cours de partition.
+
+Des arrangements plus complexes de partition pour chœur à huit voix ne
+sont pas réalisables avec ce gabarit préprogrammé.
+
+
 @node Modèles pour portée unique
 @appendixsec Modèles pour portée unique
 @translationof Single staff templates
@@ -41,13 +361,13 @@ de lancer LilyPond, et d'aprécier le résultat.
 * Notes et accords::
 * Notes paroles et accords::
 @end menu
- 
+
 
 @node Notes seules
 @appendixsubsec Notes seules
 @translationof Notes only
 
-@lilypondfile[verbatim,quote,ragged-right,texidoc,addversion]
+@lilypondfile[verbatim,quote,ragged-right,texidoc]
 {single-staff-template-with-only-notes.ly}
 
 
@@ -55,7 +375,7 @@ de lancer LilyPond, et d'aprécier le résultat.
 @appendixsubsec Notes et paroles
 @translationof Notes and lyrics
 
-@lilypondfile[verbatim,quote,ragged-right,texidoc,addversion]
+@lilypondfile[verbatim,quote,ragged-right,texidoc]
 {single-staff-template-with-notes-and-lyrics.ly}
 
 
@@ -140,6 +460,11 @@ de lancer LilyPond, et d'aprécier le résultat.
 @appendixsec Modèles pour ensemble vocal
 @translationof Vocal ensembles templates
 
+Les exemples ci-après demandent à être recopiés et édités dans vos
+propres fichiers.  Pour des constructions simples, vous pouvez
+adopter une construction préprogrammée appelée par une instruction
+@code{\include} -- voir @ref{Gabarits préprogrammés}.
+
 @menu
 * Partition pour chœur SATB::
 * Partition pour chœur SATB avec réduction pour piano::
@@ -238,9 +563,8 @@ de lancer LilyPond, et d'aprécier le résultat.
 @appendixsubsec Transcription de musique mensurale
 @translationof Transcription of mensural music
 
-@c Line-width below is because of Issue 766.  If that's fixed, it can be removed.
-@lilypondfile[verbatim,quote,ragged-right,texidoc,line-width=140]
-{ancient-notation-template----modern-transcription-of-mensural-music.ly}
+@lilypondfile[verbatim,quote,ragged-right,texidoc]
+{incipit.ly}
 
 
 @node Transcription du grégorien
@@ -264,7 +588,5 @@ de lancer LilyPond, et d'aprécier le résultat.
 @appendixsubsec Symboles de jazz
 @translationof Jazz combo
 
-@c Line-width below is because of Issue 766.  If that's fixed, it can be removed.
-@lilypondfile[verbatim,quote,ragged-right,texidoc,line-width=140]
+@lilypondfile[verbatim,quote,ragged-right,texidoc]
 {jazz-combo-template.ly}
-