Doc-de: update macros.itely and nitpicks

[lilypond.git] / Documentation / fr / user / vocal.itely

diff --git a/Documentation/fr/user/vocal.itely b/Documentation/fr/user/vocal.itely
index f6c196f97d98daa82d300815c9e988eca6e4f5e0..1e843d60d3dc9565d18d103a3e358b86ff7d968f 100644 (file)
--- a/Documentation/fr/user/vocal.itely
+++ b/Documentation/fr/user/vocal.itely
@@ -1,13 +1,13 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
 @c This file is part of lilypond.tely
 @ignore
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
 @c This file is part of lilypond.tely
 @ignore

-    Translation of GIT committish: 1440fffdf8579046cc2033b9c697a190b34b91e5
+    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
 
 
     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
 
 @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
 examinerons par degré croissant de complexité.
 
 @menu

-* Common notation for vocals::  
+* Common notation for vocal music::
+* Entering lyrics::  

 * Aligning lyrics to a melody::  
 * Aligning lyrics to a melody::  

-* Placement of lyrics::         
+* Specific uses of lyrics::         

 * Stanzas::                     
 @end menu
 
 * Stanzas::                     
 @end menu
 


@@ -62,66 +63,65 @@ Pour que les paroles évitent également les barres de mesure, ajoutez
 @end example
 
 
 @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
 
 @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
 
 @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 note heads}.
+@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
 
 @cindex paroles
 @funindex \lyricmode


@@ -253,12 +253,48 @@ verseOne = \lyricmode @{ Joy to the world the Lord is come @}
 
 
 @seealso
 
 
 @seealso

-

 Référence du programme : @rinternals{LyricText}, @rinternals{LyricSpace}.
 
 
 Référence du programme : @rinternals{LyricText}, @rinternals{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
 @node Working with lyrics and variables

-@subsubsection Working with lyrics and variables
+@unnumberedsubsubsec Working with lyrics and variables

 
 @cindex paroles, variables
 
 
 @cindex paroles, variables
 


@@ -311,15 +347,14 @@ Le résultat donnera ainsi quelque chose comme
 >>
 @end example
  
 >>
 @end example
  

+

 @seealso
 @seealso

- 

 @c TODO: document \new Staff << Voice \lyricsto >> bug
 @c TODO: document \new Staff << Voice \lyricsto >> bug

-
+@c

 Référence du programme : @rinternals{LyricCombineMusic},
 @rinternals{Lyrics}.  
 
 
 Référence du programme : @rinternals{LyricCombineMusic},
 @rinternals{Lyrics}.  
 
 

-

 @node Aligning lyrics to a melody
 @subsection Aligning lyrics to a melody
 
 @node Aligning lyrics to a melody
 @subsection Aligning lyrics to a melody
 


@@ -359,7 +394,7 @@ contexte @code{\lyricmode}
 @end menu
 
 @node Automatic syllable durations
 @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
 
 @cindex durée automatique des syllabes
 @cindex paroles et mélodies


@@ -415,7 +450,7 @@ est exactement la même chose que
 @end example
 
 @node Manual syllable durations
 @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
 
 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


@@ -452,13 +487,13 @@ Voici un exemple de cette manière de procéder :
  } >>
 @end lilypond
 
  } >>
 @end lilypond
 

+

 @seealso
 @seealso

- 

 Référence du programme : @rinternals{Lyrics}.
 
 
 @node Multiple syllables to one note
 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
 
 @funindex _
 @cindex liaisons, dans les paroles


@@ -479,15 +514,17 @@ installée qui contient ce symbole(par exemple DejaVuLGC).}.
 \addlyrics { pu- ro~y~ho- nes- to }
 @end lilypond
 
 \addlyrics { pu- ro~y~ho- nes- to }
 @end lilypond
 

-@seealso

 
 

+@seealso

 Référence du programme : @rinternals{LyricCombineMusic}.
 
 Référence du programme : @rinternals{LyricCombineMusic}.
 

+

 @c Here come the section which used to be "Melismata"
 @c the new title might be more self-explanatory
 
 @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
 @node Multiple notes to one syllable

-@subsubsection Multiple notes to one syllable
+@unnumberedsubsubsec Multiple notes to one syllable

 
 @cindex mélisme
 @cindex vocalise
 
 @cindex mélisme
 @cindex vocalise


@@ -553,34 +590,34 @@ section @rlearning{Vocal ensembles}.
 
 
 @predefined
 
 
 @predefined

-
-@code{\melisma}, @code{\melismaEnd}
-@funindex \melismaEnd

 @funindex \melisma
 @funindex \melisma

+@code{\melisma},
+@funindex \melismaEnd
+@code{\melismaEnd}.
+@endpredefined

 
 

-@seealso

 
 

-Référence du programme : @rinternals{Melisma_translator}.
+@seealso
+@comment  Référence du programme : @rinternals{Melisma_translator}.

 
 Exemples : @rlsr{Vocal music}.
 
 
 Exemples : @rlsr{Vocal music}.
 

+

 @knownissues
 
 Certains mélismes ne sont pas détectés automatiquement ; vous devrez
 alors prolonger vous-même les syllabes concernées.
 
 @node Skipping notes
 @knownissues
 
 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
 @ifnothtml
 @englishref
 @end ifnothtml
 
 @node Extenders and hyphens

-@subsubsection Extenders and hyphens
+@unnumberedsubsubsec Extenders and hyphens

 
 @cindex mélisme
 @cindex extenseur
 
 @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.
 
 et @code{minimum-length}, seuil en deçà duquel il n'y a pas de trait
 d'union.
 

-@seealso

 
 

+@seealso

 Référence du programme : @rinternals{LyricExtender},
 @rinternals{LyricHyphen}
 
 
 @node Lyrics and repeats
 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
 
 @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::               
 
 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
 * 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
 
 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
 @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
 
 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
 
 >>
 @end lilypond
 

-@node Chants
-@subsubsection Chants
-
-@ifhtml
-UNTRANSLATED NODE: IGNORE ME
-@end ifhtml

 @ifnothtml
 @englishref
 @end ifnothtml
 
 @node Spacing out syllables
 @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
 
 @cindex espacer des paroles
 @cindex paroles, accroître l'espacement


@@ -762,11 +790,9 @@ dans le bloc @code{\layout}.
 @end lilypond
 
 @node Centering lyrics between staves
 @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
 @ifnothtml
 @englishref
 @end ifnothtml


@@ -786,7 +812,7 @@ UNTRANSLATED NODE: IGNORE ME
 
 
 @node Adding stanza numbers
 
 
 @node Adding stanza numbers

-@subsubsection Adding stanza numbers
+@unnumberedsubsubsec Adding stanza numbers

 
 @cindex numéro de couplet
 
 
 @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 {
 \new Voice {
   \time 3/4 g2 e4 a2 f4 g2.
 } \addlyrics {

-  \set stanza = "1. "
+  \set stanza = #"1. "

   Hi, my name is Bert.
 } \addlyrics {
   Hi, my name is Bert.
 } \addlyrics {

-  \set stanza = "2. "
+  \set stanza = #"2. "

   Oh, ché -- ri, je t'aime
 }
 @end lilypond
   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
 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
 
 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
 @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
 
 @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 {
 \new Voice {
   \time 3/4 g2 e4 a2 f4 g2.
 } \addlyrics {

-  \set vocalName = "Bert "
+  \set vocalName = #"Bert "

   Hi, my name is Bert.
 } \addlyrics {
   Hi, my name is Bert.
 } \addlyrics {

-  \set vocalName = "Ernie "
+  \set vocalName = #"Ernie "

   Oh, ché -- ri, je t'aime
 }
 @end lilypond
 
 @node Stanzas with different rhythms
   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
 
 
 @subsubheading Mélismes dans certaines strophes seulement
 


@@ -998,7 +1024,7 @@ la valeur @code{lahlah}.
 
 
 @node Printing stanzas at the end
 
 
 @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.
 
 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 {
 }
 
 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.
 }
 
 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 
 @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
 
 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 {
 }
  
 text = \lyricmode {

-  \set stanza = "1." This is verse one.
+  \set stanza = #"1." This is verse one.

   It has two lines.
 }
 
   It has two lines.
 }
 


@@ -1113,7 +1139,6 @@ text = \lyricmode {
 
 
 @seealso
 
 
 @seealso

-

 Référence du programme : @rinternals{LyricText},
 Référence du programme : @rinternals{LyricText},

-@rinternals{StanzaNumber}, @rinternals{VocalName}.
+@rinternals{StanzaNumber}.