]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/fr/user/vocal.itely
lilypond-book robustness: ensure EOL at the end of @verbatim
[lilypond.git] / Documentation / fr / user / vocal.itely
index eb353dbdaee35febbabb0112bca84cc0ec8f2082..1e843d60d3dc9565d18d103a3e358b86ff7d968f 100644 (file)
@@ -1,13 +1,13 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
 @c This file is part of lilypond.tely
 @ignore
-    Translation of GIT committish: dab80970d8e89571263d16433aff1e6f878a8f62
+    Translation of GIT committish: bdf8540b74167817eab96ed3d13b35477217f9fe
 
     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.11.38"
+@c \version "2.12.0"
 
 @c Translators: Valentin Villenave
 @c Translation checkers: Jean-Charles Malahieude
@@ -32,9 +32,10 @@ Plusieurs solutions existent pour ajouter des paroles ; nous les
 examinerons par degré croissant de complexité.
 
 @menu
-* Common notation for vocals::  
+* Common notation for vocal music::
+* Entering lyrics::  
 * Aligning lyrics to a melody::  
-* Placement of lyrics::         
+* Specific uses of lyrics::         
 * Stanzas::                     
 @end menu
 
@@ -62,66 +63,65 @@ Pour que les paroles évitent également les barres de mesure, ajoutez
 @end example
 
 
-@node Common notation for vocals
-@subsection Common notation for vocals
+@node Common notation for vocal music
+@subsection Common notation for vocal music
+
+@untranslated
 
 @menu
-* References for vocal music::  
-* Setting simple songs::        
-* Entering lyrics::             
-* Working with lyrics and variables::  
+* References for vocal music and lyrics::
+* Opera::
+* Song books::
+* Chants::
+* Spoken music::
+* Ancient vocal music::
 @end menu
 
-@node References for vocal music
-@subsubsection References for vocal music
+@node References for vocal music and lyrics
+@unnumberedsubsubsec References for vocal music and lyrics
 
-@c TODO Add @refs
+@untranslated
 
-Le @emph{parlato} est du texte scandé en rythme, mais sans hauteurs
-définies ; il est indiqué par des notes en croix, à l'instar des
-percussions --- voir @ref{Special noteheads}.
+@node Opera
+@unnumberedsubsubsec Opera
 
+@untranslated
 
-@node Setting simple songs
-@subsubsection Setting simple songs
+@node Song books
+@unnumberedsubsubsec Song books
 
-@cindex \addlyrics
+@untranslated
 
-Le plus simple pour ajouter des paroles à une mélodie est d'adjoindre 
+@node Spoken music
+@unnumberedsubsubsec Spoken music
 
-@example
-\addlyrics @{ @var{les paroles} @}
-@end example
+Le @emph{parlato} est du texte scandé en rythme, mais sans hauteurs
+définies ; il est indiqué par des notes en croix, à l'instar des
+percussions --- voir @ref{Special note heads}.
 
-@noindent
-à la mélodie.  En voici un exemple :
+@node Chants
+@unnumberedsubsubsec Chants
 
-@lilypond[ragged-right,verbatim,fragment,quote]
-\time 3/4
-\relative { c2 e4 g2. }
-\addlyrics { play the game }
-@end lilypond
+@untranslated
 
-On peut ajouter davantage de couplets en multipliant le nombre de
-sections @code{\addlyrics}.
+@node Ancient vocal music
+@unnumberedsubsubsec Ancient vocal music
 
-@lilypond[ragged-right,verbatim,fragment,quote]
-\time 3/4
-\relative { c2 e4 g2. }
-\addlyrics { play the game }
-\addlyrics { speel het spel }
-\addlyrics { joue le jeu }
-@end lilypond
+@untranslated
 
-Cependant, la commande @code{\addlyrics} ne peut gérer les
-constructions polyphoniques.  Dans ce cas, mieux vaut employer
-@code{\lyricsto} et @code{\lyricmode}, comme nous le verrons dans
-@ref{Entering lyrics}. 
 
+@node Entering lyrics
+@subsection Entering lyrics
+
+@menu
+* Lyrics explained::
+* Setting simple songs::
+* Working with lyrics and variables::
+@end menu
 
 
-@node Entering lyrics
-@subsubsection Entering lyrics
+@node Lyrics explained
+@unnumberedsubsubsec Lyrics explained
 
 @cindex paroles
 @funindex \lyricmode
@@ -146,7 +146,7 @@ il est aussi possible d'attribuer automatiquement chaque syllabe à une
 note d'une mélodie ou d'une voix existante, avec @code{\addlyrics} ou
 @code{\lyricsto}.  
 @c  TODO: broken but exists Aligning lyrics
-@c For more details see @ref{The Lyrics context}.
+@c For more details see @ref{Aligning contexts}.
 
 Dans les paroles, un mot ou une syllabe commence par une lettre de
 l'alphabet, et se termine par un espace (éventuellement précédé d'un
@@ -193,9 +193,9 @@ ces syllabes entre guillemets, ou bien remplacer l'espace par un
 caractère souligné (@code{_}), ou encore utiliser un tilde (@code{~})
 pour obtenir une liaison entre les syllabes.
 
-@lilypond[quote,relative=2,ragged-right,fragment,verbatim]
+@lilypond[quote,ragged-right,fragment,verbatim]
 \time 3/4
-\relative { c2 e4 g2 e4 }
+\relative c' { c2 e4 g2 e4 }
 \addlyrics { gran- de_a- mi- go }
 \addlyrics { pu- "ro y ho-" nes- to }
 \addlyrics { pu- ro~y~ho- nes- to }
@@ -209,10 +209,10 @@ incluant ce symbole (par exemple DejaVuLGC) installée sur le système.
 Pour utiliser des lettres accentuées ou des caractères spéciaux 
 --- cœurs ou guillemets inversés par exemple --- il suffit de les insérer
 dans le fichier et de veiller à sauvegarder ce dernier avec le codage
-utf-8.  Voir à ce sujet @ref{Text encoding} pour plus de détails.
+UTF-8.  Voir à ce sujet @ref{Text encoding} pour plus de détails.
 
 @lilypond[quote,ragged-right,fragment,verbatim]
-\relative { e4 f e d e f e2 }
+\relative c' { e4 f e d e f e2 }
 \addlyrics { He said: “Let my peo ple go”. }
 @end lilypond
 
@@ -253,12 +253,48 @@ verseOne = \lyricmode @{ Joy to the world the Lord is come @}
 
 
 @seealso
+Référence du programme : @rinternals{LyricText}, @rinternals{LyricSpace}.
+
 
-Référence du programme : @internalsref{LyricText}, @internalsref{LyricSpace}.
+@node Setting simple songs
+@unnumberedsubsubsec Setting simple songs
+
+@cindex \addlyrics
+
+Le plus simple pour ajouter des paroles à une mélodie est d'adjoindre 
+
+@example
+\addlyrics @{ @var{les paroles} @}
+@end example
+
+@noindent
+à la mélodie.  En voici un exemple :
+
+@lilypond[ragged-right,verbatim,fragment,quote]
+\time 3/4
+\relative { c2 e4 g2. }
+\addlyrics { play the game }
+@end lilypond
+
+On peut ajouter davantage de couplets en multipliant le nombre de
+sections @code{\addlyrics}.
+
+@lilypond[ragged-right,verbatim,fragment,quote]
+\time 3/4
+\relative { c2 e4 g2. }
+\addlyrics { play the game }
+\addlyrics { speel het spel }
+\addlyrics { joue le jeu }
+@end lilypond
+
+Cependant, la commande @code{\addlyrics} ne peut gérer les
+constructions polyphoniques.  Dans ce cas, mieux vaut employer
+@code{\lyricsto} et @code{\lyricmode}, comme nous le verrons dans
+@ref{Lyrics explained}. 
 
 
 @node Working with lyrics and variables
-@subsubsection Working with lyrics and variables
+@unnumberedsubsubsec Working with lyrics and variables
 
 @cindex paroles, variables
 
@@ -311,13 +347,12 @@ Le résultat donnera ainsi quelque chose comme
 >>
 @end example
  
+
 @seealso
 @c TODO: document \new Staff << Voice \lyricsto >> bug
-
-Référence du programme : @internalsref{LyricCombineMusic},
-@internalsref{Lyrics}.  
-
+@c
+Référence du programme : @rinternals{LyricCombineMusic},
+@rinternals{Lyrics}.  
 
 
 @node Aligning lyrics to a melody
@@ -329,7 +364,7 @@ Référence du programme : @internalsref{LyricCombineMusic},
 
 
 Avant d'être imprimées, les paroles sont interprétées par le programme
-dans le contexte @internalsref{Lyrics}.
+dans le contexte @rinternals{Lyrics}.
 
 @example
 \new Lyrics \lyricmode @dots{}
@@ -359,7 +394,7 @@ contexte @code{\lyricmode}
 @end menu
 
 @node Automatic syllable durations
-@subsubsection Automatic syllable durations
+@unnumberedsubsubsec Automatic syllable durations
 
 @cindex durée automatique des syllabes
 @cindex paroles et mélodies
@@ -373,7 +408,7 @@ paroles avec la commande @code{\lyricsto}.
 @end example
 
 Cette commande adapte les paroles aux notes de la voix (contexte
-@internalsref{Voice} dans le jargon LilyPond) @var{nom}.  Ce contexte
+@rinternals{Voice} dans le jargon LilyPond) @var{nom}.  Ce contexte
 @code{Voice} doit exister avant l'indication des paroles avec
 @code{\lyricsto}.  La commande @code{\lyricsto} introduit
 automatiquement le mode @code{\lyricmode}, donc dans ce cas vous n'avez
@@ -415,7 +450,7 @@ est exactement la même chose que
 @end example
 
 @node Manual syllable durations
-@subsubsection Manual syllable durations
+@unnumberedsubsubsec Manual syllable durations
 
 On peut aussi se passer de @code{\addlyrics} et de @code{\lyricsto} pour
 saisir des paroles.  Dans ce cas, les syllabes sont entrées comme des
@@ -436,7 +471,7 @@ La mélodie associée à ces paroles peut être spécifiée par la propriété
  
 @noindent
 La valeur que vous attribuez à cette propriété (ici @code{"lala"})
-doit désigner un contexte @internalsref{Voice}, sans quoi les mélismes
+doit désigner un contexte @rinternals{Voice}, sans quoi les mélismes
 ne seront pas imprimés correctement.
  
 Voici un exemple de cette manière de procéder :
@@ -452,13 +487,13 @@ Voici un exemple de cette manière de procéder :
  } >>
 @end lilypond
 
+
 @seealso
-Référence du programme : @internalsref{Lyrics}.
+Référence du programme : @rinternals{Lyrics}.
 
 
 @node Multiple syllables to one note
-@subsubsection Multiple syllables to one note
+@unnumberedsubsubsec Multiple syllables to one note
 
 @funindex _
 @cindex liaisons, dans les paroles
@@ -471,23 +506,25 @@ liaison adaptée aux paroles correspond au caractère Unicode U+203F, et
 n'apparaîtra dans la partition que si le système dispose d'une police
 installée qui contient ce symbole(par exemple DejaVuLGC).}.
 
-@lilypond[quote,relative=2,ragged-right,fragment,verbatim]
+@lilypond[quote,ragged-right,fragment,verbatim]
 \time 3/4
-\relative { c2 e4 g2 e4 }
+\relative c' { c2 e4 g2 e4 }
 \addlyrics { gran- de_a- mi- go }
 \addlyrics { pu- "ro y ho-" nes- to }
 \addlyrics { pu- ro~y~ho- nes- to }
 @end lilypond
 
+
 @seealso
+Référence du programme : @rinternals{LyricCombineMusic}.
 
-Référence du programme : @internalsref{LyricCombineMusic}.
 
 @c Here come the section which used to be "Melismata"
 @c the new title might be more self-explanatory
 
+
 @node Multiple notes to one syllable
-@subsubsection Multiple notes to one syllable
+@unnumberedsubsubsec Multiple notes to one syllable
 
 @cindex mélisme
 @cindex vocalise
@@ -549,20 +586,22 @@ connecter manuellement créera un mélisme.
 @cindex choral score
 
 Vous trouverez un exemple complet de partition pour chœur dans la
-section @ref{Vocal ensembles}.
+section @rlearning{Vocal ensembles}.
 
 
 @predefined
-
-@code{\melisma}, @code{\melismaEnd}
-@funindex \melismaEnd
 @funindex \melisma
+@code{\melisma},
+@funindex \melismaEnd
+@code{\melismaEnd}.
+@endpredefined
+
 
 @seealso
+@comment  Référence du programme : @rinternals{Melisma_translator}.
 
-Référence du programme : @internalsref{Melisma_translator}.
+Exemples : @rlsr{Vocal music}.
 
-@lsr{vocal,lyric@/-combine.ly}.
 
 @knownissues
 
@@ -570,17 +609,15 @@ Certains mélismes ne sont pas détectés automatiquement ; vous devrez
 alors prolonger vous-même les syllabes concernées.
 
 @node Skipping notes
-@subsubsection Skipping notes
+@unnumberedsubsubsec Skipping notes
 
-@ifhtml
-UNTRANSLATED NODE: IGNORE ME
-@end ifhtml
+@untranslated
 @ifnothtml
 @englishref
 @end ifnothtml
 
 @node Extenders and hyphens
-@subsubsection Extenders and hyphens
+@unnumberedsubsubsec Extenders and hyphens
 
 @cindex mélisme
 @cindex extenseur
@@ -604,38 +641,35 @@ imprimés.  Cet inconvénient peut être contrôlé par
 et @code{minimum-length}, seuil en deçà duquel il n'y a pas de trait
 d'union.
 
-@seealso
 
-Référence du programme : @internalsref{LyricExtender},
-@internalsref{LyricHyphen}
+@seealso
+Référence du programme : @rinternals{LyricExtender},
+@rinternals{LyricHyphen}
 
 
 @node Lyrics and repeats
-@subsubsection Lyrics and repeats
+@unnumberedsubsubsec Lyrics and repeats
 
-@ifhtml
-UNTRANSLATED NODE: IGNORE ME
-@end ifhtml
+@untranslated
 @ifnothtml
 @englishref
 @end ifnothtml
 
-@node Placement of lyrics
-@subsection Placement of lyrics
+@node Specific uses of lyrics
+@subsection Specific uses of lyrics
 
 Une même mélodie peut se voir traitée différemment suivant les couplets.
 La commande @code{\lyricsto} permet de prendre en compte ces variantes.
 
 @menu
 * Divisi lyrics::               
-* Lyrics independent of notes::  
-* Chants::                      
+* Lyrics independent of notes::                
 * Spacing out syllables::       
 * Centering lyrics between staves::  
 @end menu
 
 @node Divisi lyrics
-@subsubsection Divisi lyrics
+@unnumberedsubsubsec Divisi lyrics
 
 En donnant un nom à chaque voix et en leur attribuant spécifiquement
 des paroles, on peut créer des paroles alternatives --- également
@@ -679,7 +713,7 @@ Cette astuce permet de faire varier les paroles lorsqu'une section est reprise.
 @end lilypond
 
 @node Lyrics independent of notes
-@subsubsection Lyrics independent of notes
+@unnumberedsubsubsec Lyrics independent of notes
 
 Dans certaines musiques vocales assez complexes, on peut avoir intérêt à
 imprimer les paroles indépendamment des notes.  La mélodie sur laquelle
@@ -708,18 +742,12 @@ lyr = \lyricmode { I like my cat! }
 >>
 @end lilypond
 
-@node Chants
-@subsubsection Chants
-
-@ifhtml
-UNTRANSLATED NODE: IGNORE ME
-@end ifhtml
 @ifnothtml
 @englishref
 @end ifnothtml
 
 @node Spacing out syllables
-@subsubsection Spacing out syllables
+@unnumberedsubsubsec Spacing out syllables
 
 @cindex espacer des paroles
 @cindex paroles, accroître l'espacement
@@ -742,7 +770,7 @@ d'accroître l'espacement des paroles.
 Pour que ce réglage s'applique à toute la partition, définissez-le
 dans le bloc @code{\layout}.
 
-@lilypond[relative,verbatim,quote,ragged-right]
+@lilypond[verbatim,quote,ragged-right]
 \score {
   \relative c' {
   c c c c
@@ -762,11 +790,9 @@ dans le bloc @code{\layout}.
 @end lilypond
 
 @node Centering lyrics between staves
-@subsubsection Centering lyrics between staves
+@unnumberedsubsubsec Centering lyrics between staves
 
-@ifhtml
-UNTRANSLATED NODE: IGNORE ME
-@end ifhtml
+@untranslated
 @ifnothtml
 @englishref
 @end ifnothtml
@@ -786,7 +812,7 @@ UNTRANSLATED NODE: IGNORE ME
 
 
 @node Adding stanza numbers
-@subsubsection Adding stanza numbers
+@unnumberedsubsubsec Adding stanza numbers
 
 @cindex numéro de couplet
 
@@ -797,10 +823,10 @@ On peut ajouter un numéro aux couplets en définissant la variable
 \new Voice {
   \time 3/4 g2 e4 a2 f4 g2.
 } \addlyrics {
-  \set stanza = "1. "
+  \set stanza = #"1. "
   Hi, my name is Bert.
 } \addlyrics {
-  \set stanza = "2. "
+  \set stanza = #"2. "
   Oh, ché -- ri, je t'aime
 }
 @end lilypond
@@ -809,7 +835,7 @@ On peut ajouter un numéro aux couplets en définissant la variable
 Ces numéros se placeront juste avant le début de la première syllabe.
 
 @node Adding dynamics marks to stanzas
-@subsubsection Adding dynamics marks to stanzas
+@unnumberedsubsubsec Adding dynamics marks to stanzas
 
 Lorsque des couplets ont des nuances différentes, vous pouvez ajouter
 une nuance devant chaque numéro.  L'objet @code{StanzaNumber} contient
@@ -835,7 +861,7 @@ text = {
 @end lilypond
 
 @node Adding singers' names to stanzas
-@subsubsection Adding singers' names to stanzas
+@unnumberedsubsubsec Adding singers' names to stanzas
 
 @cindex nom de personnage
 @cindex nom du chanteur
@@ -849,16 +875,16 @@ abrégée.
 \new Voice {
   \time 3/4 g2 e4 a2 f4 g2.
 } \addlyrics {
-  \set vocalName = "Bert "
+  \set vocalName = #"Bert "
   Hi, my name is Bert.
 } \addlyrics {
-  \set vocalName = "Ernie "
-  Oh, che -- ri, je t'aime
+  \set vocalName = #"Ernie "
+  Oh, ché -- ri, je t'aime
 }
 @end lilypond
 
 @node Stanzas with different rhythms
-@subsubsection Stanzas with different rhythms
+@unnumberedsubsubsec Stanzas with different rhythms
 
 @subsubheading Mélismes dans certaines strophes seulement
 
@@ -905,7 +931,7 @@ faire un mélisme.  Il faudra alors insérer des sauts invisibles
 suivant d'une note :
 
 @lilypond[verbatim,ragged-right,quote]
-\relative { c c g' }
+\relative c' { c c g' }
 \addlyrics {
   twin -- \skip 4
   kle
@@ -921,7 +947,7 @@ modifie la propriété @code{associatedVoice}.  Dans cet exemple,
 
 @lilypond[ragged-right,quote]
 <<
-  \relative \new Voice = "lahlah" {
+  \relative c' \new Voice = "lahlah" {
     \set Staff.autoBeaming = ##f
     c4
     <<
@@ -998,7 +1024,7 @@ la valeur @code{lahlah}.
 
 
 @node Printing stanzas at the end
-@subsubsection Printing stanzas at the end
+@unnumberedsubsubsec Printing stanzas at the end
 
 Il peut parfois s'avérer opportun d'aligner un seul couplet sur la
 mélodie, et de présenter tous les autres en bloc à la fin du morceau.
@@ -1016,7 +1042,7 @@ d d e d | c1 |
 }
 
 text = \lyricmode {
-\set stanza = "1." Ma- ry had a lit- tle lamb,
+\set stanza = #"1." Ma- ry had a lit- tle lamb,
 its fleece was white as snow.
 }
 
@@ -1043,7 +1069,7 @@ its fleece was white as snow.
 @end lilypond
 
 @node Printing stanzas at the end in multiple columns 
-@subsubsection Printing stanzas at the end in multiple columns
+@unnumberedsubsubsec Printing stanzas at the end in multiple columns
 
 Si les couplets sont vraiment nombreux, il est possible de les imprimer
 sur plusieurs colonnes.  De plus, l'exemple suivant vous montrera
@@ -1057,7 +1083,7 @@ melody = \relative c' {
 }
  
 text = \lyricmode {
-  \set stanza = "1." This is verse one.
+  \set stanza = #"1." This is verse one.
   It has two lines.
 }
 
@@ -1113,7 +1139,6 @@ text = \lyricmode {
 
 
 @seealso
-
-Référence du programme : @internalsref{LyricText},
-@internalsref{StanzaNumber}, @internalsref{VocalName}.
+Référence du programme : @rinternals{LyricText},
+@rinternals{StanzaNumber}.