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

@ignore
   Translation of GIT committish: a5cf37bc53f57635bf984ecc2d1c5a067573b87c

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

@c Translators: Jean-Charles Malahieude

@node Modèles
@appendix Modèles
@translationof Templates

Cette annexe du manuel d'initiation propose des patrons de partition
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::
* Modèles pour ensemble vocal::
* Orchestre::
* Exemples de notation ancienne::
* Autres modèles::
@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}.

@morerefs
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}.
@endmorerefs

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

@morerefs
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}.
@endmorerefs

@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

@menu
* Notes seules::
* Notes et paroles::
* Notes et accords::
* Notes paroles et accords::
@end menu


@node Notes seules
@appendixsubsec Notes seules
@translationof Notes only

@lilypondfile[verbatim,quote,ragged-right,texidoc]
{snippets/single-staff-template-with-only-notes.ly}


@node Notes et paroles
@appendixsubsec Notes et paroles
@translationof Notes and lyrics

@lilypondfile[verbatim,quote,ragged-right,texidoc]
{snippets/single-staff-template-with-notes-and-lyrics.ly}


@node Notes et accords
@appendixsubsec Notes et accords
@translationof Notes and chords

@lilypondfile[verbatim,quote,ragged-right,texidoc]
{snippets/single-staff-template-with-notes-and-chords.ly}


@node Notes paroles et accords
@appendixsubsec Notes, paroles et accords
@translationof Notes lyrics, and chords

@lilypondfile[verbatim,quote,ragged-right,texidoc]
{snippets/single-staff-template-with-notes,-lyrics,-and-chords.ly}


@node Modèles pour piano
@appendixsec Modèles pour piano
@translationof Piano templates

@menu
* Piano seul::
* Chant et accompagnement::
* Piano et paroles entre les portées::
@end menu


@node Piano seul
@appendixsubsec Piano seul
@translationof Solo piano

@lilypondfile[verbatim,quote,ragged-right,texidoc]
{snippets/piano-template-simple.ly}


@node Chant et accompagnement
@appendixsubsec Chant et accompagnement
@translationof Piano and melody with lyrics

@lilypondfile[verbatim,quote,ragged-right,texidoc]
{snippets/piano-template-with-melody-and-lyrics.ly}


@node Piano et paroles entre les portées
@appendixsubsec Piano et paroles entre les portées
@translationof Piano centered lyrics

@lilypondfile[verbatim,quote,ragged-right,texidoc]
{snippets/piano-template-with-centered-lyrics.ly}


@node Modèles pour quatuor à cordes
@appendixsec Modèles pour quatuor à cordes
@translationof String quartet templates

@menu
* Quatuor à cordes simple::
* Parties pour quatuor à cordes::
@end menu


@node Quatuor à cordes simple
@appendixsubsec Quatuor à cordes simple
@translationof String quartet

@lilypondfile[verbatim,quote,ragged-right,texidoc]
{snippets/string-quartet-template-simple.ly}


@node Parties pour quatuor à cordes
@appendixsubsec Parties pour quatuor à cordes
@translationof String quartet parts

@lilypondfile[verbatim,quote,ragged-right,texidoc]
{snippets/string-quartet-template-with-separate-parts.ly}


@node Modèles pour ensemble vocal
@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::
* Partition pour chœur SATB avec alignement des contextes::
* Chœur à quatre voix mixtes sur quatre portées::
* Couplet pour solo et refrain à deux voix::
* Hymnes et cantiques::
* Psalmodie::
@end menu


@node Partition pour chœur SATB
@appendixsubsec Partition pour chœur SATB
@translationof SATB vocal score

@lilypondfile[verbatim,quote,ragged-right,texidoc]
{snippets/vocal-ensemble-template.ly}


@node Partition pour chœur SATB avec réduction pour piano
@appendixsubsec Partition pour chœur SATB avec réduction pour piano
@translationof SATB vocal score and automatic piano reduction

@lilypondfile[verbatim,quote,ragged-right,texidoc]
{snippets/vocal-ensemble-template-with-automatic-piano-reduction.ly}


@node Partition pour chœur SATB avec alignement des contextes
@appendixsubsec Partition pour chœur SATB avec alignement des contextes
@translationof SATB with aligned contexts

@lilypondfile[verbatim,quote,ragged-right,texidoc]
{snippets/vocal-ensemble-template-with-lyrics-aligned-below-and-above-the-staves.ly}


@node Chœur à quatre voix mixtes sur quatre portées
@appendixsubsec Chœur à quatre voix mixtes sur quatre portées
@translationof SATB on four staves

@lilypondfile[verbatim,quote,ragged-right,texidoc]
{snippets/satb-choir-template---four-staves.ly}


@node Couplet pour solo et refrain à deux voix
@appendixsubsec Couplet pour solo et refrain à deux voix
@translationof Solo verse and two-part refrain

@lilypondfile[verbatim,quote,ragged-right,texidoc]
{snippets/vocal-ensemble-template-with-verse-and-refrain.ly}


@node Hymnes et cantiques
@appendixsubsec Hymnes et cantiques
@translationof Hymn tunes

@lilypondfile[verbatim,quote,ragged-right,texidoc]
{snippets/hymn-template.ly}


@node Psalmodie
@appendixsubsec Psalmodie
@translationof Psalms

@lilypondfile[verbatim,quote,ragged-right,texidoc]
{snippets/anglican-psalm-template.ly}


@node Orchestre
@appendixsec Orchestre
@translationof Orchestral templates

@menu
* Orchestre chœur et piano::
@end menu


@node Orchestre chœur et piano
@appendixsubsec Orchestre, chœur et piano
@translationof Orchestra choir and piano

@lilypondfile[verbatim,quote,ragged-right,texidoc]
{snippets/orchestra,-choir-and-piano-template.ly}


@node Exemples de notation ancienne
@appendixsec Exemples de notation ancienne
@translationof Ancient notation templates

@menu
* Transcription de musique mensurale::
* Transcription du grégorien::
@end menu


@node Transcription de musique mensurale
@appendixsubsec Transcription de musique mensurale
@translationof Transcription of mensural music

@lilypondfile[verbatim,quote,ragged-right,texidoc]
{snippets/incipit.ly}


@node Transcription du grégorien
@appendixsubsec Transcription du grégorien
@translationof Gregorian transcription template

@lilypondfile[verbatim,quote,ragged-right,texidoc]
{snippets/ancient-notation-template----modern-transcription-of-gregorian-music.ly}


@node Autres modèles
@appendixsec Autres modèles
@translationof Other templates

@menu
* Symboles de jazz::
@end menu


@node Symboles de jazz
@appendixsubsec Symboles de jazz
@translationof Jazz combo

@lilypondfile[verbatim,quote,ragged-right,texidoc]
{snippets/jazz-combo-template.ly}
