version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@c Translators: Valentin Villenave
@c Translation checkers: Jean-Charles Malahieude
Plusieurs solutions existent pour ajouter des paroles ; nous les
examinerons par degré croissant de complexité.
-@menu
-* TODO subsection vocal music::
+@menu
+* Common notation for vocals::
+* Aligning lyrics to a melody::
+* Placement of lyrics::
+* Stanzas::
@end menu
@commonprop
@end example
-@node TODO subsection vocal music
-@subsection TODO subsection vocal music
-
-@menu
-* Setting simple songs::
-* Entering lyrics::
-* Aligning lyrics to a melody::
-* Automatic syllable durations::
-* Another way of entering lyrics::
-* Assigning more than one syllable to a single note::
-* More than one note on a single syllable::
-* Extenders and hyphens::
-* Working with lyrics and identifiers::
-* Flexibility in placement::
-* Lyrics to multiple notes of a melisma::
-* Divisi lyrics::
-* Switching the melody associated with a lyrics line::
-* Lyrics independent of notes::
-* Spacing lyrics::
-* More about stanzas::
-* Other vocal issues::
+@node Common notation for vocals
+@subsection Common notation for vocals
+
+@menu
+* References for vocal music::
+* Setting simple songs::
+* Entering lyrics::
+* Working with lyrics and variables::
@end menu
+@node References for vocal music
+@subsubsection References for vocal music
+
+@c TODO Add @refs
+
+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 Setting simple songs
-@unnumberedsubsubsec Setting simple songs
+@subsubsection Setting simple songs
@cindex \addlyrics
@node Entering lyrics
-@unnumberedsubsubsec Entering lyrics
+@subsubsection Entering lyrics
@cindex paroles
@funindex \lyricmode
Référence du programme : @internalsref{LyricText}, @internalsref{LyricSpace}.
+@node Working with lyrics and variables
+@subsubsection Working with lyrics and variables
+
+@cindex paroles, variables
+
+La fonction @code{\lyricmode} permet de définir une variable pour
+les paroles. Point n'est besoin de spécifier les durées si vous
+utilisez @code{\addlyrics} ou @code{\lyricsto} lorsque vous y faites
+référence.
+
+@example
+verseOne = \lyricmode @{ Joy to the world the Lord is come @}
+\score @{
+ <<
+ \new Voice = "one" \relative c'' @{
+ \autoBeamOff
+ \time 2/4
+ c4 b8. a16 g4. f8 e4 d c2
+ @}
+ \addlyrics @{ \verseOne @}
+ >>
+@}
+@end example
+
+Pour une organisation différente ou plus complexe, mieux vaut
+commencer par définir la hiérarchie des portées et des paroles,
+@example
+\new ChoirStaff <<
+ \new Voice = "soprano" @{ @emph{musique} @}
+ \new Lyrics = "sopranoParoles" @{ s1 @}
+ \new Lyrics = "tenorParoles" @{ s1 @}
+ \new Voice = "tenor" @{ @emph{musique} @}
+>>
+@end example
+
+puis combiner correctement les mélodies et les paroles :
+
+@example
+\context Lyrics = sopranoParoles \lyricsto "soprano"
+@emph{les paroles}
+@end example
+
+@noindent
+
+Le résultat donnera ainsi quelque chose comme
+
+@example
+<<\new ChoirStaff << @emph{définition de la musique} >>
+ \lyricsto "soprano" @emph{etc}
+ \lyricsto "alto" @emph{etc}
+@emph{etc}
+>>
+@end example
+
+@seealso
+
+@c TODO: document \new Staff << Voice \lyricsto >> bug
+
+Référence du programme : @internalsref{LyricCombineMusic},
+@internalsref{Lyrics}.
+
+
@node Aligning lyrics to a melody
-@unnumberedsubsubsec Aligning lyrics to a melody
+@subsection Aligning lyrics to a melody
@funindex \lyricmode
@funindex \addlyrics
@menu
* Automatic syllable durations::
-* Another way of entering lyrics::
-* Assigning more than one syllable to a single note::
-* More than one note on a single syllable::
+* Manual syllable durations::
+* Multiple syllables to one note::
+* Multiple notes to one syllable::
+* Skipping notes::
* Extenders and hyphens::
+* Lyrics and repeats::
@end menu
@node Automatic syllable durations
-@unnumberedsubsubsec Automatic syllable durations
+@subsubsection Automatic syllable durations
@cindex durée automatique des syllabes
@cindex paroles et mélodies
\new Lyrics \lyricsto "blah" @{ PAROLES @}
@end example
-@node Another way of entering lyrics
-@unnumberedsubsubsec Another way of entering lyrics
+@node Manual syllable durations
+@subsubsection 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
Référence du programme : @internalsref{Lyrics}.
-@node Assigning more than one syllable to a single note
-@unnumberedsubsubsec Assigning more than one syllable to a single note
-
+@node Multiple syllables to one note
+@subsubsection Multiple syllables to one note
@funindex _
@cindex liaisons, dans les paroles
@c Here come the section which used to be "Melismata"
@c the new title might be more self-explanatory
-
-@node More than one note on a single syllable
-@unnumberedsubsubsec More than one note on a single syllable
+@node Multiple notes to one syllable
+@subsubsection Multiple notes to one syllable
@cindex mélisme
@cindex vocalise
-@c better here
@cindex phrasé, pour des paroles
section @ref{Vocal ensembles}.
-@refcommands
+@predefined
@code{\melisma}, @code{\melismaEnd}
@funindex \melismaEnd
@lsr{vocal,lyric@/-combine.ly}.
-@refbugs
+@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
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+@ifnothtml
+@englishNR
+@end ifnothtml
+
@node Extenders and hyphens
-@unnumberedsubsubsec Extenders and hyphens
+@subsubsection Extenders and hyphens
@cindex mélisme
@cindex extenseur
@internalsref{LyricHyphen}
-@node Working with lyrics and identifiers
-@unnumberedsubsubsec Working with lyrics and identifiers
-@cindex paroles, identificateurs
-
-La fonction @code{\lyricmode} permet de définir un identificateur pour
-les paroles. Point n'est besoin de spécifier les durées si vous
-utilisez @code{\addlyrics} ou @code{\lyricsto} lorsque vous y faites référence.
-
-@example
-verseOne = \lyricmode @{ Joy to the world the Lord is come @}
-\score @{
- <<
- \new Voice = "one" \relative c'' @{
- \autoBeamOff
- \time 2/4
- c4 b8. a16 g4. f8 e4 d c2
- @}
- \addlyrics @{ \verseOne @}
- >>
-@}
-@end example
-
-Pour une organisation différente ou plus complexe, mieux vaut
-commencer par définir la hiérarchie des portées et des paroles,
-@example
-\new ChoirStaff <<
- \new Voice = "soprano" @{ @emph{musique} @}
- \new Lyrics = "sopranoParoles" @{ s1 @}
- \new Lyrics = "tenorParoles" @{ s1 @}
- \new Voice = "tenor" @{ @emph{musique} @}
->>
-@end example
-
-puis combiner correctement les mélodies et les paroles :
-
-@example
-\context Lyrics = sopranoParoles \lyricsto "soprano"
-@emph{les paroles}
-@end example
-
-@noindent
-
-Le résultat donnera ainsi quelque chose comme
-
-@example
-<<\new ChoirStaff << @emph{définition de la musique} >>
- \lyricsto "soprano" @emph{etc}
- \lyricsto "alto" @emph{etc}
-@emph{etc}
->>
-@end example
-
-@seealso
-
-@c TODO: document \new Staff << Voice \lyricsto >> bug
-
-Référence du programme : @internalsref{LyricCombineMusic},
-@internalsref{Lyrics}.
+@node Lyrics and repeats
+@subsubsection Lyrics and repeats
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+@ifnothtml
+@englishNR
+@end ifnothtml
-@node Flexibility in placement
-@unnumberedsubsubsec Flexibility in placement
+@node Placement of lyrics
+@subsection Placement 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
-* Lyrics to multiple notes of a melisma::
* Divisi lyrics::
-* Switching the melody associated with a lyrics line::
* Lyrics independent of notes::
+* Chants::
+* Spacing out syllables::
+* Centering lyrics between staves::
@end menu
-
-@node Lyrics to multiple notes of a melisma
-@unnumberedsubsubsec Lyrics to multiple notes of a melisma
-
-Il peut survenir que les paroles comportent un mélisme pour l'un des
-couplets, mais plusieurs syllabes pour d'autres. Une solution consiste à
-temporairement ignorer les mélismes dans le couplet ayant plus de
-syllabes. Il suffit pour cela de définir la propriété
-@code{ignoreMelismata} à l'intérieur du contexte Lyrics.
-
-Petit détail qui a son importance : la définition de
-@code{ignoreMelismata} doit intervenir une syllabe @emph{avant} les
-syllabes auxquelles elle s'appliquera :
-
-@c FIXME: breaks compile
-@lilypond[verbatim,ragged-right,quote]
-%{
-<<
- \relative \new Voice = "lahlah" {
- \set Staff.autoBeaming = ##f
- c4
- \slurDotted
- f8.[( g16])
- a4
- }
- \new Lyrics \lyricsto "lahlah" {
- more slow -- ly
- }
- \new Lyrics \lyricsto "lahlah" {
- \set ignoreMelismata = ##t % applies to "fas"
- go fas -- ter
- \unset ignoreMelismata
- still
- }
->>
-%}
-@end lilypond
-
-
-Ici la fonction @code{ignoreMelismata} concerne la syllabe @q{fas},
-bien qu'elle ait été définie avant la syllabe @q{go}.
-
-L'inverse est aussi possible : prendre une mélodie syllabique pour en
-faire un mélisme. Il faudra alors insérer des sauts invisibles
-@code{\skip} dans vos paroles. Chaque @code{\skip} décale le texte
-suivant d'une note :
-
-@lilypond[verbatim,ragged-right,quote]
-\relative { c c g' }
-\addlyrics {
- twin -- \skip 4
- kle
-}
-@end lilypond
-
-
@node Divisi lyrics
-@unnumberedsubsubsec Divisi lyrics
+@subsubsection Divisi lyrics
En donnant un nom à chaque voix et en leur attribuant spécifiquement
des paroles, on peut créer des paroles alternatives --- également
}
@end lilypond
-
-
-@node Switching the melody associated with a lyrics line
-@unnumberedsubsubsec Switching the melody associated with a lyrics line
-
-On peut créer des variations plus complexes à partir d'une mélodie à
-plusieurs voix. Les paroles peuvent suivre l'une ou l'autre des
-lignes mélodiques, et même basculer de l'une à l'autre si l'on
-modifie la propriété @code{associatedVoice}. Dans cet exemple,
-
-@lilypond[ragged-right,quote]
-<<
- \relative \new Voice = "lahlah" {
- \set Staff.autoBeaming = ##f
- c4
- <<
- \new Voice = "alternative" {
- \voiceOne
- \times 2/3 {
- % show associations clearly.
- \override NoteColumn #'force-hshift = #-3
- f8 f g
- }
- }
- {
- \voiceTwo
- f8.[ g16]
- \oneVoice
- } >>
- a8( b) c
- }
- \new Lyrics \lyricsto "lahlah" {
- Ju -- ras -- sic Park
- }
- \new Lyrics \lyricsto "lahlah" {
- % Tricky: need to set associatedVoice
- % one syllable too soon!
- \set associatedVoice = alternative % applies to "ran"
- Ty --
- ran --
- no --
- \set associatedVoice = lahlah % applies to "rus"
- sau -- rus Rex
- } >>
-@end lilypond
-
-@noindent
-le texte du premier couplet s'aligne sur la mélodie nommée
-@q{lahlah},
-
-@example
-\new Lyrics \lyricsto "lahlah" @{
- Ju -- ras -- sic Park
-@}
-@end example
-
-
-Le second couplet est tout d'abord rattaché au contexte @code{lahlah},
-mais bascule sur une autre mélodie sur la syllabe @q{ran}. Pour cela,
-nous utilisons
-@example
-\set associatedVoice = alternative
-@end example
-
-@noindent
-où @code{alternative} désigne le nom du contexte @code{Voice} qui contient
-le triolet.
-
-Encore une fois, cette commande doit être spécifiée une syllabe en
-avance, c'est-à-dire ici avant la syllabe @q{Ty}.
-
-@example
-\new Lyrics \lyricsto "lahlah" @{
- \set associatedVoice = alternative % applies to "ran"
- Ty --
- ran --
- no --
- \set associatedVoice = lahlah % applies to "rus"
- sau -- rus Rex
-@}
-@end example
-
-@noindent
-Comme vous pouvez le voir, nous revenons ensuite à l'alignement sur la
-mélodie d'origine, en assignant à la propriété @code{associatedVoice}
-la valeur @code{lahlah}.
-
-
@node Lyrics independent of notes
-@unnumberedsubsubsec Lyrics independent of notes
+@subsubsection 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
>>
@end lilypond
+@node Chants
+@subsubsection Chants
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+@ifnothtml
+@englishNR
+@end ifnothtml
-@node Spacing lyrics
-@unnumberedsubsubsec Spacing lyrics
+@node Spacing out syllables
+@subsubsection Spacing out syllables
@cindex espacer des paroles
@cindex paroles, accroître l'espacement
}
@end lilypond
+@node Centering lyrics between staves
+@subsubsection Centering lyrics between staves
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+@ifnothtml
+@englishNR
+@end ifnothtml
+
-@node More about stanzas
-@unnumberedsubsubsec More about stanzas
+@node Stanzas
+@subsection Stanzas
+
+@menu
+* Adding stanza numbers::
+* Adding dynamics marks to stanzas::
+* Adding singers' names to stanzas::
+* Stanzas with different rhythms::
+* Printing stanzas at the end::
+* Printing stanzas at the end in multiple columns ::
+@end menu
+
+
+@node Adding stanza numbers
+@subsubsection Adding stanza numbers
@cindex numéro de couplet
-@unnumberedsubsubsec Adding stanza numbers
On peut ajouter un numéro aux couplets en définissant la variable
@code{stanza} :
@noindent
Ces numéros se placeront juste avant le début de la première syllabe.
-@unnumberedsubsubsec Adding dynamics marks
+@node Adding dynamics marks to stanzas
+@subsubsection 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
>>
@end lilypond
+@node Adding singers' names to stanzas
+@subsubsection Adding singers' names to stanzas
+
@cindex nom de personnage
@cindex nom du chanteur
-@unnumberedsubsubsec Adding singer names
On peut également ajouter le nom de chaque rôle ; ils s'imprimeront au
début de chaque ligne comme les noms d'instruments. Il faut pour cela
}
@end lilypond
+@node Stanzas with different rhythms
+@subsubsection Stanzas with different rhythms
+
+@subsubheading Mélismes dans certaines strophes seulement
+
+Il peut survenir que les paroles comportent un mélisme pour l'un des
+couplets, mais plusieurs syllabes pour d'autres. Une solution consiste à
+temporairement ignorer les mélismes dans le couplet ayant plus de
+syllabes. Il suffit pour cela de définir la propriété
+@code{ignoreMelismata} à l'intérieur du contexte Lyrics.
+
+Petit détail qui a son importance : la définition de
+@code{ignoreMelismata} doit intervenir une syllabe @emph{avant} les
+syllabes auxquelles elle s'appliquera :
+
+@c FIXME: breaks compile
+@lilypond[verbatim,ragged-right,quote]
+%{
+<<
+ \relative \new Voice = "lahlah" {
+ \set Staff.autoBeaming = ##f
+ c4
+ \slurDotted
+ f8.[( g16])
+ a4
+ }
+ \new Lyrics \lyricsto "lahlah" {
+ more slow -- ly
+ }
+ \new Lyrics \lyricsto "lahlah" {
+ \set ignoreMelismata = ##t % applies to "fas"
+ go fas -- ter
+ \unset ignoreMelismata
+ still
+ }
+>>
+%}
+@end lilypond
+
+Ici la fonction @code{ignoreMelismata} concerne la syllabe @q{fas},
+bien qu'elle ait été définie avant la syllabe @q{go}.
+
+L'inverse est aussi possible : prendre une mélodie syllabique pour en
+faire un mélisme. Il faudra alors insérer des sauts invisibles
+@code{\skip} dans vos paroles. Chaque @code{\skip} décale le texte
+suivant d'une note :
+
+@lilypond[verbatim,ragged-right,quote]
+\relative { c c g' }
+\addlyrics {
+ twin -- \skip 4
+ kle
+}
+@end lilypond
+
+@subsubheading Basculer vers une mélodie alternative
-@unnumberedsubsubsec Printing stanzas at the end
+On peut créer des variations plus complexes à partir d'une mélodie à
+plusieurs voix. Les paroles peuvent suivre l'une ou l'autre des
+lignes mélodiques, et même basculer de l'une à l'autre si l'on
+modifie la propriété @code{associatedVoice}. Dans cet exemple,
+
+@lilypond[ragged-right,quote]
+<<
+ \relative \new Voice = "lahlah" {
+ \set Staff.autoBeaming = ##f
+ c4
+ <<
+ \new Voice = "alternative" {
+ \voiceOne
+ \times 2/3 {
+ % show associations clearly.
+ \override NoteColumn #'force-hshift = #-3
+ f8 f g
+ }
+ }
+ {
+ \voiceTwo
+ f8.[ g16]
+ \oneVoice
+ } >>
+ a8( b) c
+ }
+ \new Lyrics \lyricsto "lahlah" {
+ Ju -- ras -- sic Park
+ }
+ \new Lyrics \lyricsto "lahlah" {
+ % Tricky: need to set associatedVoice
+ % one syllable too soon!
+ \set associatedVoice = alternative % applies to "ran"
+ Ty --
+ ran --
+ no --
+ \set associatedVoice = lahlah % applies to "rus"
+ sau -- rus Rex
+ } >>
+@end lilypond
+
+@noindent
+le texte du premier couplet s'aligne sur la mélodie nommée
+@q{lahlah},
+
+@example
+\new Lyrics \lyricsto "lahlah" @{
+ Ju -- ras -- sic Park
+@}
+@end example
+
+
+Le second couplet est tout d'abord rattaché au contexte @code{lahlah},
+mais bascule sur une autre mélodie sur la syllabe @q{ran}. Pour cela,
+nous utilisons
+@example
+\set associatedVoice = alternative
+@end example
+
+@noindent
+où @code{alternative} désigne le nom du contexte @code{Voice} qui contient
+le triolet.
+
+Encore une fois, cette commande doit être spécifiée une syllabe en
+avance, c'est-à-dire ici avant la syllabe @q{Ty}.
+
+@example
+\new Lyrics \lyricsto "lahlah" @{
+ \set associatedVoice = alternative % applies to "ran"
+ Ty --
+ ran --
+ no --
+ \set associatedVoice = lahlah % applies to "rus"
+ sau -- rus Rex
+@}
+@end example
+
+@noindent
+Comme vous pouvez le voir, nous revenons ensuite à l'alignement sur la
+mélodie d'origine, en assignant à la propriété @code{associatedVoice}
+la valeur @code{lahlah}.
+
+
+@node Printing stanzas at the end
+@subsubsection 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.
}
@end lilypond
-
-@unnumberedsubsubsec Printing stanzas at the end in multiple columns
+@node Printing stanzas at the end in multiple columns
+@subsubsection 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
Référence du programme : @internalsref{LyricText},
@internalsref{StanzaNumber}, @internalsref{VocalName}.
-
-
-@node Other vocal issues
-@unnumberedsubsubsec Other vocal issues
-
-@ignore
-yeah, I'm giving up somewhat by stuffing a bunch of things in
-here. But at least they're in the manual now; it's easier to
-move them around in the manual once they're already here.
-
-Besides, if users complain about everything stuffed in here, I
-can ask them for specific instructions about where to move these
-examples, and that might get them more involved in the docs. -gp
-@end ignore
-
-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}.
-