@node Tutorial
@chapter Tutorial
-Ce tutoriel commence par une courte introduction au langage d'écriture
-de la musique avec LilyPond. Après ce premier contact, nous verrons
-comment produire une partition à imprimer. Vous serez alors capable de
-créer et d'imprimer vos propres partitions.
+Ce tutoriel commence par une courte introduction au langage utilisé
+par LilyPond pour représenter la musique. Après ce premier contact,
+nous verrons comment produire une partition à imprimer. Vous serez
+alors capable de créer et d'imprimer vos propres partitions.
@ifhtml
Beaucoup de gens apprennent à utiliser les programmes en les essayant
-et en jouant avec. Ceci est également possible avec LilyPond. Si
+et en bidouillant avec. C'est également possible avec LilyPond. Si
vous cliquez sur une image dans la version HTML de ce manuel, vous
-verrez exactement le code LilyPond que nous avons utilisé pour
-générer cette image.
+verrez exactement le code LilyPond utilisé pour générer cette image.
Essayez sur cette image
@lilypond[fragment,quote,ragged-right,relative=2]
@end lilypond
@end ifhtml
-En coupant et en collant l'itégralité du code dans un fichier test, vous aurez
-un modèle pour démarrer les expérimentations. Si vous apprenez de cette
-façon, vous aurez probablement envie d'imprimer ou de créer un lien
-vers
+En copiant et en collant l'intégralité du code dans un fichier test,
+vous aurez un modèle comme base pour expérimenter. Si vous
+apprenez de cette façon, vous aurez probablement envie d'imprimer ou
+de créer un lien vers
@ifhtml
la
@end ifhtml
@ref{Cheat sheet}, tableau qui répertorie les commandes usuelles
-et constitue une référence rapide.
+pour une consultation rapide.
@menu
* First steps::
@section First steps
Le premier exemple montre comment écrire la partition la plus
-élémentaire qui soit, une gamme (@rglos{scale}). Une @rglos{note} peut
-être entrée en tapant son nom, de @samp{a} à @samp{g}. Donc si vous entrez
+élémentaire qui soit, une gamme (@rglos{scale}). Une @rglos{note} peut
+être entrée en tapant son nom, de @samp{a} à @samp{g}. Donc si vous
+entrez
@example
@{
c d e f g a b
@end lilypond
-@footnote{NdT : il est aussi possible d'utiliser les noms
-de notes do re mi fa sol la si, en insérant au début du fichier
-@samp{\include "catalan.ly"}}
+@c DIV specific
+Il est aussi possible d'utiliser les noms de notes français @samp{do
+re mi fa sol la si}, en insérant au début du fichier la ligne
+@samp{\include "catalan.ly"}
+@c END DIV
-Toue partie de code LilyPond doit être entouré d'une @{paire
-d'accolades@}. Bien que la plupart des exemples de ce manuel n'en
+Tout extrait de code LilyPond doit être entouré d'une @{paire
+d'accolades@}. Bien que la plupart des exemples de ce manuel n'en
comportent pas, ne les oubliez pas dans vos compositions !
-De plus, de nombreux exemples utilisent les mode @code{relative}. Ceci
+De plus, de nombreux exemples utilisent le mode @code{relative}. Ceci
est expliqué à la section @ref{Octave entry} ; sachez dès à présent
que certains exemples devraient être libellés sous la forme
@code{\relative @{ @emph{...musique...} @}}.
-De nombreux exemples ont aussi été « raccourcis » pour économiser la
-place, grace à la commande @code{\paper @{ ragged-right = ##t @}}.
+De nombreux exemples ont aussi été compressés horizontalement pour
+économiser de la place, grace à la commande
+@code{\paper @{ragged-right = ##t @}}.
@cindex Case sensitive
-Enfin, LilyPond est sensible à la casse. @code{ @{ c d e @} } est
+Enfin, LilyPond est sensible à la casse. @code{ @{ c d e @} } est
un code valide ; @code{ @{ C D E @} } produira un message d'erreur.
-La valeur (@rglos{duration}) d'une note est spécifiée par un nombre
-qui suit le nom de cette note. @samp{1} pour une ronde (@rglos{whole
+La durée (@rglos{duration}) d'une note est spécifiée par un nombre
+qui suit le nom de cette note : @samp{1} pour une ronde (@rglos{whole
note}), @samp{2} pour une blanche (@rglos{half note}), @samp{4} pour
une noire (@rglos{quarter note}) et ainsi de suite.
{ a1 a2 a4 a16 a32 s16_" " }
@end lilypond
-Si aucune durée n'est spécifiée, la dernière entrée est utilisée pour les
-notes suivantes. La valeur par défaut de la première note d'une partition
-est la noire.
+Si aucune durée n'est spécifiée, la dernière durée entrée est utilisée
+pour les notes suivantes. La valeur implicite de la première note
+dans les fichiers sources de la partition est la noire :
@example
a a8 a a2 a
@end lilypond
-Un silence (@rglos{rest}) se saisi tout comme une note, mais avec le
-caractère @samp{r}.
+On saisit un silence (@rglos{rest}) tout comme une note, mais avec le
+caractère @samp{r}
@example
r2 r4 r8 r16
@end lilypond
Ajouter un point @samp{.} après une durée permet d'obtenir une note
-pointée (@rglos{dotted note}).
+pointée (@rglos{dotted note})
@example
a2. a4 a8. a16
{ a2. a4 a8. a16 s16_" " }
@end lilypond
-Le chiffrage de la mesure (@rglos{time signature}) peut se définir à
-l'aide de la commande @code{\time}.
+La métrique (@rglos{time signature}) est définie par
+la commande @code{\time}
@example
\time 3/4
s16_" "
@end lilypond
-La @rglos{clef} peut être réglée avec la commande @code{\clef}.
+La @rglos{clef} est définie par la commande @code{\clef}
@example
\clef treble
s16_" "
@end lilypond
-Pensez bien à encadrer les notes et commandes avec des accolades
-@code{@{@tie{}@dots{}@tie{}@}} pour pouvoir obtenir un résultat imprimable.
+Pensez bien à encadrer les notes et les commandes avec des accolades
+@code{@{@tie{}@dots{}@tie{}@}} pour pouvoir obtenir un résultat
+imprimable.
-@c @li @lilypond[fragment,quote,noindent,linewidth=55\staffspace]
@lilypond[fragment,quote,noindent,verbatim]
\time 3/4
\clef bass
@quotation
@table @asis
-@item Définir des hauteurs et des durées
+@item la définition des hauteurs et des durées
voir
@ref{Pitches}, et @ref{Durations}.
@item les clefs
-see @ref{Clef}.
+voir @ref{Clef}
@item les silences
-see @ref{Rests}.
-@item les chiffrages de mesure et autres commandes liées au temps
-see @ref{Time signature}.
+voir @ref{Rests}.
+@item la métrique et autres commandes liées au temps
+voir @ref{Time signature}.
@end table
@end quotation
@c cheesy title to avoid clash with chapter name.
Dans la section précédente, nous avons vu quelles sortes d'éléments
-peut contenir un fichier LilyPond. Dans cette section nous
+peut contenir un fichier LilyPond. Dans cette section nous
expliquerons quelles commandes exécuter et comment voir ou imprimer le
-résultat de LilyPond. Si vous n'avez jamais utilisé
-LilyPond, voulez tester votre installation ou souhaitez exécuter
+résultat de LilyPond. Si vous n'avez jamais utilisé
+LilyPond, voulez tester votre installation ou souhaitez compiler
vous-même un fichier d'exemple, lisez cette section.
@unnumberedsubsec MacOS X
Si vous double-cliquez sur LilyPond.app, un fichier d'exemple sera
-ouvert. Sauvegardez le, par exemple, sous @file{test.ly} sur votre
+ouvert. Sauvegardez-le, par exemple, sous @file{test.ly} sur votre
bureau, et traitez-le ensuite avec la commande du menu
@samp{Compile > Typeset File}.
-Le fichier PDF résultant est affiché sur votre écran.
+Le fichier PDF résultant est alors affiché sur votre écran.
-Prenez note que le premier démarrage prend une minute ou deux
+Prenez note que le premier démarrage prend une minute ou deux ,
car toutes les polices systèmes doivent être d'abord analysées.
@unnumberedsubsec Windows
Sous Windows, démarrez un éditeur de texte @footnote{N'importe quel
-éditeur simple ou orienté programmation fera l'affaire, comme
-Notepad. N'utilisez pas de traitement de texte car ceux-ci insèrent
-des codes de formatage qui posent problème à LilyPond.} et entrez
+éditeur simple ou orienté programmation, qui prend en charge le
+codage de caractères UTF-8, fera l'affaire, par exemple
+Notepad. N'utilisez pas de traitement de texte car ceux-ci insèrent
+des codes de formatage qui posent problème à LilyPond.} et saisissez
@verbatim
@{ c'4 e' g' @}
@end verbatim
Enregistrez le sur le bureau sous @file{test.ly} et vérifiez bien
-qu'il ne s'appelle pas @file{test.ly.TXT}. Double-cliquez sur le
+qu'il ne s'appelle pas @file{test.ly.TXT}. Double-cliquez sur le
fichier @file{test.ly} pour le traiter et afficher le fichier
PDF résultant.
@unnumberedsubsec Unix
-Commencez par ouvrir une fenêtre de terminal et lancez un éditeur de
-texte. Par exemple, vous pouvez ouvrir un xterm et exécuter
-@code{joe}. @footnote{Des fichiers de macros pour les fans de VIM et un
-@code{LilyPond-mode} pour les fans d'Emacs existent. S'ils ne sont pas
+Commencez par ouvrir une fenêtre de terminal et un éditeur de
+texte. Par exemple, vous pouvez ouvrir un xterm et exécuter
+@code{joe}. @footnote{Des fichiers de macros pour les fans de VIM et un
+@code{LilyPond-mode} pour les fans d'Emacs existent. S'ils ne sont pas
encore installés, consultez le fichier @file{INSTALL.txt}.} Dans votre
éditeur, entrez le texte suivant et sauvegardez le fichier sous
@file{test.ly}
Converting to `test.pdf'...
@end example
+@c DIV specific
+Suivant votre installation, les messages peuvent être traduits.
+@c END DIV
+
@cindex DVI file
@cindex Viewing music
@cindex xdvi
@uref{http://@/www@/.cs@/.wisc@/.edu/@/~ghost/,Ghostscript}, un
programme pour voir et imprimer les fichiers PDF et PostScript.}
-@footnote{NdT : suivant votre installation, les messages
-peuvent être traduits.}
-
@node More about pitches
@section More about pitches
-Un dièse (@rglos{sharp}) s'obtient en ajoutant @samp{is} au nom
-de la note, un bémol (@rglos{flat}) en ajoutant @samp{es}. Comme
-vous pouvez vous y attendre, un double dièse ou double bémol est
-obtenu en ajoutant @samp{isis} ou @samp{eses}@footnote{Cette syntaxe
-est dérivée de la convention de dénomination des notes dans les langues
-nordiques et germaniques, comme l'allemand ou le hollandais.}.
-@footnote{NdT : si vous utilisez la commande décrite plus haut
-pour utiliser do ré mi à la place des lettres, il faudra ajouter un
-@samp{d} pour un dièse, et un @samp{b} pour un bèmol. Le double dièse
-et le double bémol s'obtiennent en ajoutant respectivement @samp{dd} et @samp{bb}}
+Un dièse (@rglos{sharp}) s'obtient en ajoutant @samp{is} au nom de la
+note, un bémol (@rglos{flat}) en ajoutant @samp{es}. Comme vous pouvez
+vous y attendre, un double dièse ou double bémol est obtenu en
+ajoutant @samp{isis} ou @samp{eses}@footnote{Cette syntaxe est dérivée
+de la convention de dénomination des notes dans les langues nordiques
+et germaniques, comme l'allemand ou le hollandais.}.
+
+@c DIV specific
+Si vous utilisez la commande @samp{\include "catalan.ly"} pour entrer
+les noms de notes français au lieu des noms hollandais, il faudra
+ajouter un @samp{d} pour un dièse, et un @samp{b} pour un bèmol. Le
+double dièse et le double bémol s'obtiennent en ajoutant
+respectivement @samp{dd} et @samp{bb}
+@c END DIV
@example
cis1 ees fisis aeses
@cindex key signature, setting
L'armure est déterminée par la commande @code{\key}, suivie d'une
-hauteur et de @code{\major} (majeur) ou @code{\minor} (mineur).
+hauteur puis de @code{\major} (majeur) ou @code{\minor} (mineur) :
@example
\key d \major
@end lilypond
@noindent
-Les armures fixées par des hauteurs (y compris les altérations)
-permettent de déterminer quand afficher les altérations
-accidentelles. Cette fonctionnalité est souvent source
-de confusion pour les nouveaux utilisateurs, aussi expliquons la
-plus en détails.
-
-
-LilyPond fait une distinction entre le contenu musical et la mise
-en page. L'altération (bémol, bécarre ou dièse) d'une note fait
-partie de sa hauteur, et donc du contenu musical. La présence d'une
-altération accidentelle (un @emph{signe} bémol, bécarre ou dièse) devant
-la note correspondante est question de mise en page. La mise
-en page est quelque chose qui obéit à des règles ; les signes
-accidentels sont donc automatiquement imprimés suivant ces règles. Les
-hauteurs de note contenues dans votre musique font partie des éléments
-artistiques, et les altérations ne sont pas ajoutées automatiquement,
-même si vous devez entrer ce que vous voulez entendre.
-
-Dans cet exemple :
+La combinaison de l'armure et des hauteurs de note -- y compris les
+altérations -- permet de déterminer dans quel cas afficher les
+altérations accidentelles. Cette fonctionnalité est souvent source de
+confusion pour les nouveaux utilisateurs, aussi expliquons-la en
+détail.
+
+
+LilyPond fait une nette distinction entre le contenu musical et la
+mise en forme. L'altération d'une note -- bémol, bécarre ou dièse --
+fait partie de sa hauteur, et donc du contenu musical. La présence
+d'une altération accidentelle -- un @emph{signe} bémol, bécarre ou
+dièse -- devant la note correspondante est une question de mise en
+page. La mise en page est un processus qui obéit à des règles ; les
+altérations accidentelles sont donc automatiquement imprimées suivant
+ces règles. Les hauteurs de note appartiennent à la musique que vous
+entrez, et comme vous êtes sensé(e) entrer ce que vous voulez entendre,
+LilyPond, qui n'est chargé que de la gravure, ne les choisit pas à
+votre place.
+
+Dans cet exemple
@lilypond[quote,notime,fragment]
\key d \major
@end lilypond
@noindent
-si aucune note n'a une altération accidentelle explicite, vous devez
-cependant les entrer :
+si aucune note n'a d'altération accidentelle, vous devez
+cependant entrer
@example
\key d \major
@end example
@noindent
-Le code @samp{d} ne veut pas dire « imprimer un point noir sur la
-portée. » Cela signifie plutôt : « une note ayant la hauteur ré
-naturel. »
-Avec l'armure en la bémol majeur, il y aura un signe accidentel.
+Le code @samp{d} ne veut pas dire « imprimer un point noir juste
+en-dessous de la portée. » Cela signifie plutôt : « une note ayant la
+hauteur ré naturel. » Avec l'armure de la bémol majeur, ce ré sera flanqué
+d'un bécarre accidentel.
@lilypond[quote,notime,fragment,relative=1,verbatim]
\key as \major
@end lilypond
Ajouter explicitement toutes les altérations requiert un peu plus
-d'effort en cours de saisie, mais l'avantage est que la transposition
-sera facilitée. De plus les signes accidentels peuvent être imprimés suivant
-plusieurs conventions. Regardez @ref{Automatic accidentals} pour
-d'autres exemples sur la manière dont les signes accidentels peuvent
-être imprimés suivant différentes règles.
+d'effort dans la phase de saisie, mais avec l'avantage que la
+transposition en sera facilitée. De plus les altérations accidentelles
+peuvent être imprimées suivant plusieurs conventions. Regardez
+@ref{Automatic accidentals} pour connaître la manière dont les
+altérations accidentelles peuvent être imprimées suivant différentes
+règles.
Pour plus d'informations sur
@section Entering ties
@cindex tie
-Une liaison entre deux notes de même hauteur (@rglos{tie}) est créée
-en ajoutant un tilde @samp{~} à la suite de la première note à être liée.
+Une liaison de durée@footnote{parfois aussi appelée liaison de
+prolongation.} (@rglos{tie}) est créée en ajoutant un tilde @samp{~} à
+la suite de la première note liée.
@lilypond[quote,notime,fragment,verbatim,relative=3]
g4~ g a2~ a4
@end lilypond
-Pour plus d'informations sur les liaisons de durées, voir @ref{Ties}.
+Pour plus d'informations sur les liaisons de durée, voir @ref{Ties}.
@section Automatic and manual beams
@cindex beams, by hand
-Toutes les ligatures (@rglos{beam}), ou liens de croches, sont dessinées
-automatiquement.
+Toutes les ligatures@footnote{parfois appelées aussi liens de croches}
+(@rglos{beam}), sont dessinées automatiquement :
@lilypond[quote,fragment,relative=2,verbatim]
a8 ais d es r d
@noindent
Si l'emplacement des barres ne vous convient pas, vous pouvez
-les entrer à la main. Marquer la première note à être attachée d'un
+les entrer à la main. Marquer la première note à être attachée d'un
@samp{[} et la dernière d'un @samp{]}.
@lilypond[quote,fragment,relative=2,verbatim]
a8[ ais] d[ es r d]
@end lilypond
-Pour plus d'informations sur les liens de croches, voir @ref{Manual beams}.
+Pour plus d'informations sur les ligatures, voir @ref{Manual beams}.
-Voici comment se comportent armures, altérations accidentelles et
-liaisons
+Voici comment se comportent ensemble armures, altérations
+accidentelles et liaisons :
@lilypond[fragment,quote,noindent,line-width=50\staff-space,verbatim]
\relative c'' {
@noindent
Il y a plusieurs points intéressants à noter dans cet exemple. Les
-barres de mesure et les liens de croches sont dessinés automatiquement.
-Les sauts de ligne sont calculés automatiquement ; peu importe où ils
-se situent dans le fichier source. Enfin, l'ordre dans lequel
-l'indicateur de mesure, l'armure et les changements de clefs sont
-saisis n'a pas d'importance ; dans la sortie imprimable, ils sont
-organisés suivant les conventions standard de notation.
+barres de mesure et les liens de croches sont dessinés
+automatiquement. Les sauts de ligne sont calculés automatiquement ;
+peu importe où se situent les sauts de ligne dans le fichier source.
+Enfin, l'ordre dans lequel la métrique, l'armure et les changements de
+clefs sont saisis n'a pas d'importance : dans la sortie imprimable,
+ils sont organisés suivant les conventions standard de notation.
@c better to have this just before the `octaves are bad' snipped
@c but we'd need to remove the ', from \key and tie
-Pour hausser une note d'une octave, ajoutez lui une apostrophe
-@code{'} ; pour la baisser d'une octave, ajoutez lui une virgule
-@code{,}. Le do entre la clef de sol et la clef de fa est @code{c'}.
+Pour hausser une note d'une octave, ajoutez une apostrophe @code{'} au
+nom de la note ; pour la baisser d'une octave, ajoutez une virgule
+@code{,}. Le do central (entre la clef de sol et la clef de fa) est
+@code{c'}
@lilypond[quote,notime,fragment,verbatim]
c'4 c'' c''' \clef bass c c,
@end lilypond
-Un exemple de l'utilisation des apostrophes dans ce fragment de Mozart
+Un exemple de l'utilisation des apostrophes dans ce fragment de Mozart :
@lilypond[quote,ragged-right,fragment,verbatim]
\key a \major
@end lilypond
@noindent
-Cet exemple montre qu'il faut beaucoup d'apostrophes pour écrire de
-la musique dans un registre aigu. Ceci rend le fichier moins
-lisible, et c'est une source d'erreurs. La solution consiste à utiliser
-les « octaves relatives ». C'est la façon la plus commode pour copier de
+Cet exemple montre qu'il faut beaucoup d'apostrophes pour écrire de la
+musique dans un registre aigu. Ceci rend le fichier moins lisible, et
+c'est une source d'erreurs. La solution consiste à utiliser le mode
+d'« octaves relatives ». C'est la façon la plus commode de copier de
la musique existante.
-En mode relatif, une note sans signe d'octavation (c'est à dire @code{'} ou
-@code{,} après la note) est interprétée de manière à ce qu'elle soit la
-plus proche de la note précédente. Par exemple, @samp{c f} monte, alors
-que @samp{c g} descend.
+En mode relatif, une note sans signe d'octaviation -- @code{'} ou
+@code{,} après le nom de la note -- est interprétée de manière à ce
+qu'elle soit la plus proche de la note précédente. Par exemple,
+@samp{c f} monte, alors que @samp{c g} descend.
-Pour utiliser le mode relatif, ajouter @code{\relative} avant la pièce de
-musique.
-La première note est choisie relativement en fonction du do medium
-@c no , for this sentence
-(cad. @code{c'}).
+Pour utiliser le mode relatif, ajoutez @code{\relative} avant le
+morceau de musique. La première hauteur de note est choisie
+relativement en fonction du do central -- c'est-à-dire @code{c'}.
@end lilypond
-Puisque la plupart de la musique utilise de petits intervalles, les pièces
-peuvent être écrites en mode relatif, sans pratiquement utiliser de signes
-d'octavation. L'exemple précédent est entré comme ceci :
+Puisque la plus grande partie de la musique utilise de petits
+intervalles, les pièces peuvent être écrites en mode relatif sans
+pratiquement utiliser de signes d'octavation. L'exemple précédent est
+entré comme
@lilypond[quote,ragged-right,verbatim]
\relative {
@c added another example below.
@c grappig: Pa vond het heel logies, en slim toen-i eenmaal begreep.
@c in eerste instantie drong het `relative' niet door zonder extra uitleg.
-Les intervalles plus grands sont faits en ajoutant les signes d'octavation.
+Les intervalles plus grands qu'une quarte sont produits en ajoutant
+les signes d'octavation :
@lilypond[quote,notime,verbatim,fragment]
\relative c {
}
@end lilypond
-En résumé, apostrophes et virgules ne déterminent pas la
-hauteur absolue d'une note dans le mode @code{\relative}. La hauteur de la
-note est relative à la précédente, et modifier l'octave d'une seule
-note changera l'octave des suivantes.
+En résumé, apostrophes et virgules ne déterminent pas la hauteur
+absolue d'une note dans le mode @code{\relative}. Au lieu de cela, la
+hauteur de la note est relative à la précédente, et modifier l'octave
+d'une seule note changera l'octave de toutes les notes suivantes.
-Pour plus d'information sur les octaves relatives, voir @ref{Relative
-octaves}, et @ref{Octave check}.
+Pour plus d'information sur les octaves relatives, voir
+@ref{Relative octaves}, et @ref{Octave check}.
@node Music expressions explained
@section Music expressions explained
-Dans les fichiers LilyPond, la musique est représentée par ce qu'on
-appelle des @emph{expressions musicales}. Nous en avons déjà vu dans
+Dans les fichiers source LilyPond, la musique est représentée par ce qu'on
+appelle des @emph{expressions musicales}. Nous en avons déjà vu dans
les quelques exemples précédents ; une seule note constitue une
-expression musicale.
+expression musicale :
@lilypond[fragment,quote,verbatim,relative=3]
a4
@end lilypond
Mettre un groupe de notes entre accolades crée une nouvelle expression
-musicale.
+musicale :
@lilypond[fragment,quote,verbatim,relative=3]
{ a4 g4 }
@end lilypond
-Placer un groupe d'expressions musicales (ex: des notes) entre accolades
-signifie qu'elles doivent être jouées en une seule phrase. Le résultat
-est une expression, qui peut être regroupé avec d'autres expressions
-séquentiellement. Ici, l'expression de l'expemple précédent est
-combiné à deux notes :
+Placer une séquence d'expressions musicales -- des notes par exemple
+-- entre accolades signifie qu'elles doivent être jouées
+successivement, les unes après les autres. Le résultat est une
+expression, qui peut elle-même être regroupée séquentiellement avec
+d'autres expressions. Ici, l'expression de l'exemple précédent est
+combinée à deux notes :
@lilypond[fragment,quote,verbatim,relative=3]
{ { a4 g } f g }
@end lilypond
-Cette technique est utile pour de la musique non monophonique. Pour
+Cette technique est utile pour de la musique non monophonique. Pour
entrer une musique avec plusieurs voix ou plusieurs portées, nous
-combinons les expressions en parallèle. Deux voix qui doivent être
+pouvons aussi combiner en parallèle les expressions. Deux voix qui doivent être
jouées en même temps, sont entrées comme une combinaison simultanée de
-deux phrases. Une expression musicale « simultanée » est formée en
-entourant les expressions entre @code{<<} et @code{>>}. Dans l'exemple
-suivant, trois phrases (contenant chacune deux notes séparées) sont
+deux expression. Une expression musicale « simultanée » est formée en
+entourant les expressions entre @code{<<} et @code{>>}. Dans l'exemple
+suivant, trois expressions (contenant chacune deux notes distinctes) sont
combinées simultanément.
@lilypond[fragment,quote,verbatim,relative=3]
@end lilypond
Ce mécanisme est similaire au formules mathématiques : une grosse formule
-est créée en assemblant plusieurs petites formules. Ces types
+est créée en assemblant plusieurs petites formules. Ces types
de formules, appelées expressions, ont une définition récursive, de
-telle sorte que vous pouvez fabriquer arbitrairement des expressions
-complexes et importantes. Par exemple,
+telle sorte que vous pouvez fabriquer des expressions
+arbitrairement longues et complexes. Par exemple,
@example
1
@cindex expression
@cindex music expression
Ceci est une suite d'expressions, où chacune est contenue dans la
-suivante. Les expressions les plus simples sont les nombres, et les plus
-conséquentes sont faites en combinant des expressions avec des
-opérateurs (comme @samp{+}, @samp{*} et @samp{/}) et des
-parenthèses. Tout comme les expressions mathématiques, les expressions
-musicales peuvent être profondément imbriquées, ce qui est nécessaire
-pour de la musique complexe comme des partitions polyphoniques.
-
-Notez que cet exemple ne comporte qu'une seule portée, contrairement à
-l'exemple précédent qui contenait trois portées séparées. C'est parce que
-l'exemple commence par une note seule. Pour déterminer le nombre de
-portées, LilyPond regarde le premier élément. Si c'est une seule note, il
-y a une portée ; en cas d'expressions simultanées, il y aura
-plus d'une portée.
+suivante. Les expressions les plus simples sont les nombres, et de
+plus grandes expressions sont produites en combinant des expressions
+avec des opérateurs -- comme @samp{+}, @samp{*} et @samp{/} -- et des
+parenthèses. Tout comme les expressions mathématiques, les expressions
+musicales peuvent être imbriquées avec une profondeur arbitraire, ce
+qui est nécessaire pour de la musique complexe comme des partitions
+polyphoniques.
+
+Notez que l'exemple suivant ne comporte qu'une seule portée,
+contrairement à l'exemple précédent qui contenait trois portées
+séparées. C'est parce que l'exemple commence par une note seule. Pour
+déterminer le nombre de portées, LilyPond regarde le premier élément
+qui n'est pas une accolade. Si c'est une seule note, il y a une portée
+; si c'est une expression simultanée, il y aura plus d'une portée.
@lilypond[fragment,quote,verbatim,relative=2]
{
}
@end lilypond
-On s'y perd souvent avec des fichiers musicaux comprenant de nombreuses
-imbrications, tant pour leur création que pour leur maintenance. Une
-convention permet d'éviter cette confusion : l'indentation. Pour
-entrer un fichier avec de nombreux emboîtements d'accolades et de
+Il est facile de s'y perdre avec des fichiers musicaux comprenant de nombreuses
+imbrications, tant pour leur création que pour leur maintenance. Une
+convention permet d'éviter cette confusion : l'indentation. Pour
+entrer un fichier avec de prfondes imbrications d'accolades et de
crochets, il est d'usage d'avoir recours à une indentation qui indique
-le niveau de profondeur. Formatter la musique de telle manière en
-facilite la lecture et vous aide à insérer le bon nombre de caractère
-ferment une expression. Par exemple,
+le niveau de profondeur. Formater la musique d'une telle manière en
+facilite la lecture et vous aide à insérer le bon nombre d'accolades
+fermant les expressions. Par exemple,
@example
<<
>>
@end example
-Certains éditeurs disposent d'un mode spécifique pour taper des
-fichiers LilyPond qui peut aider à l'indentation du fichier source.
+Certains éditeurs disposent d'un mode spécifique pour saisir des
+fichiers LilyPond, qui peut vous aider à indenter le fichier source.
Voir la section @ref{Editor support} pour plus d'informations.
@node More staves
@section More staves
-Pour imprimer plus d'une portée, chaque partie de la musique faisant
-l'objet d'une portée distincte est entrée en la faisant précéder de
-@code{\new Staff}. Ces éléments @code{Staff} sont combinés en parallèle avec
-@code{<<} et @code{>>} comme ci-dessous :
+Pour créer plus d'une portée, chaque partie de la musique constituant
+une portée est entrée en la faisant précéder de
+@code{\new Staff}. Ces éléments @code{Staff} sont combinés en parallèle avec
+@code{<<} et @code{>>}, comme
@lilypond[quote,fragment,verbatim]
<<
@end lilypond
-La commande @code{\new} introduit un « contexte de notation.» Un contexte
-de notation est un environnement dans lequel les évènements musicaux
-(comme les notes ou les commandes @code{\clef}) sont interprétés.
-Pour des pièces simples, ces contectes sont créés automatiquement. Pour
-des œuvres plus complexes, il est préférable de marquer les contextes
-explicitement. Cela assure que chaque fragment aura sa propre portée.
+La commande @code{\new} introduit un « contexte de notation ». Un
+contexte de notation est un environnement dans lequel les événements
+musicaux -- comme les notes ou les commandes @code{\clef} -- sont
+interprétés. Pour des pièces simples, ces contextes sont créés
+automatiquement. Pour des pièces plus complexes, il est préférable de
+spécifier explicitement les contextes. Cela assure que chaque fragment
+aura sa propre portée.
-Il existe différents types de contextes. Portée (@code{Staff}), Voix
-(@code{Voice}) et partition (@code{Score}) gèreent la notation de la
-mélodie, alors que @code{Lyrics} gère les paroles et @code{ChordNames}
-imprime le nom des accords.
+Il existe différents types de contextes. Les contextes @code{Staff}
+(portée), @code{Voice} (voix) et @code{Score} (partition) gèrent la
+notation de la mélodie, alors que @code{Lyrics} gère les paroles et
+@code{ChordNames} imprime le nom des accords.
-En matière de syntaxe, faire précéder une expression musicale de
-@code{\new} crée une plus grosse expression musicale. Pour conserver la
-comparaison, cela ressemble au « moins » en mathématiques. La formule
+En termes de syntaxe, faire précéder une expression musicale de
+@code{\new} crée une plus grosse expression musicale. En reprenant la
+comparaison, cela ressemble au signe « moins » en mathématiques. La formule
@math{(4+5)} est une expression, donc @math{-(4+5)} est une plus grosse
expression.
-Nous pouvons maintenant écrire une mélodie à deux portées.
+Nous pouvons maintenant écrire un morceau à deux portées :
@c TODO: (c) status of this Paul McCartney (?) song (let's all stand together)
>>
@end lilypond
-Pour plus d'informations sur les contextes voir leur description dans
+Pour plus d'informations sur les contextes, voir leur description à
@ref{Interpretation contexts}.
@cindex accents
@cindex staccato
-Les accents standards peuvent être ajoutés à une note en utilisant un tiret
-(@samp{-}) et un caractère.
+Les articulations standard peuvent être ajoutées à une note en
+utilisant un tiret (@samp{-}) et un caractère :
@lilypond[fragment,quote,verbatim,relative=2]
c-. c-- c-> c-^ c-+ c-_
@end lilypond
@cindex fingering
-De la même manière, les indications de doigté peuvent être ajoutées à
-une note en utilisant un tiret (@samp{-}) et le chiffre à écrire.
+De la même manière, des indications de doigté peuvent être ajoutées à
+une note en utilisant un tiret (@samp{-}) et le chiffre à écrire :
@lilypond[fragment,quote,verbatim,relative=2]
c-3 e-5 b-2 a-1
@end lilypond
Articulations et doigtés sont habituellement placés automatiquement,
-mais vous pouvez spécifier l'emplacement en utilisant @samp{^} (en haut)
-ou @samp{_} (en bas). Vous pouvez aussi utiliser plusieurs articulations
-sur la même note. Dans la plupart des cas, cependant, il est mieux de
+mais vous pouvez spécifier une direction en utilisant @samp{^} (en haut)
+ou @samp{_} (en bas). Vous pouvez aussi utiliser plusieurs articulations
+sur la même note. Dans la plupart des cas, cependant, il est mieux de
laisser LilyPond déterminer l'emplacement de l'articulation.
@lilypond[fragment,quote,verbatim,relative=2]
@end lilypond
Les signes de nuances sont obtenus en ajoutant à la note les noms des nuances,
-précédées d'un anti-slash (@samp{\}).
+précédées d'un anti-slash @samp{\} :
@lilypond[fragment,quote,verbatim,relative=2]
c\ff c\mf
@cindex decrescendo
@cindex crescendo
-Crescendos et decrescendos débutent avec les commandes @code{\<} et
-@code{\>}. Une nuance d'arrivée, par exemple @code{\f}, va finir le
-(de)crescendo. La commande @code{\!} peut aussi être utilisée pour la
-terminaison.
-Crescendi and decrescendi are started with the commands @code{\<} and
-@code{\>}. An ending dynamic, for example @code{\f}, will finish the
-(de)crescendo, or the command @code{\!} can be used
+Crescendi et decrescendi débutent avec les commandes @code{\<} et
+@code{\>}. Ils se terminent soit par une nuance d'arrivée, par exemple @code{\f},
+soit par la commande @code{\!} :
@lilypond[fragment,quote,verbatim,relative=2]
c2\< c2\ff\> c2 c2\!
@cindex slur
-Une liaison d'articulation (@rglos{slur}) est une courbe tendue
-au-dessus de plusieurs notes. Elle indique un jeu legato. La note de
-départ et celle d'arrivée sont marquées respectivement par @samp{(} et
-@samp{)}.
+Une liaison d'articulation (@rglos{slur}) est une courbe tracée
+au-dessus de plusieurs notes. Elle indique un jeu legato. Les notes de
+départ et d'arrivée sont suivies respectivement par @samp{(} et
+@samp{)} :
@lilypond[fragment,quote,fragment,relative=2,verbatim]
d4( c16) cis( d e c cis d) e( d4)
@end lilypond
@cindex slurs versus ties
-Une liaison d'atriculation ressemble à une liaison de prolongation
-(@rglos{tie}), mais signifie signifie autre chose. Une liaison de
-prolongation fait durer la première note plus longtemps, et ne peut
-être utilisée que sur deux notes de même hauteur. Ces deux types de
-liaison peuvent être imbriqués.
+Une liaison d'articulation ressemble à une liaison de
+durée (@rglos{tie}),
+mais a une signification différente. Une liaison de durée fait
+durer la première note plus longtemps, et ne peut être utilisée que
+sur une paire de notes de même hauteur. Ces deux types de liaison
+peuvent être imbriqués :
@lilypond[quote,fragment,relative=2]
c2~( c8 fis fis4 ~ fis2 g2)
@cindex phrasing slurs
Une liaison de phrasé peut être entrée avec @code{\(} et @code{\)},
-vous pouvez donc avoir simultanément des liaisons d'articulation et des
-liaisons de phrasé. Vous ne pouvez pas avoir simultanément plusieurs
-liaisons d'articulation ou simultanément plusieurs liaisons de phrasés.
+vous pouvez donc avoir simultanément une liaison d'articulation et une
+liaison de phrasé. Vous ne pouvez pas avoir de liaisons d'articulation
+simultanées ni de liaisons de phrasé simultanées.
@lilypond[quote,fragment,relative=2,verbatim]
a8(\( ais b c) cis2 b'2 a4 cis, c\)
@quotation
@table @asis
-@item Doigtés
+@item doigtés
voir @ref{Fingering instructions}.
-@item Articulations
+@item articulations
voir @ref{Articulations}.
-@item Liaisons
+@item liaisons d'articulation
voir @ref{Slurs}.
-@item Liaisons de phrasé
+@item liaisons de phrasé
voir @ref{Phrasing slurs}.
-@item Nuances
+@item nuances
voir @ref{Dynamics}.
@end table
@end quotation
@section Combining notes into chords
@cindex chords
-Les accords peuvent être créés en entourant les notes avec les symboles
-@samp{<} et @samp{>}.
+Des accords peuvent être produits en entourant les hauteurs de note
+avec les angles gauche et droit -- @samp{<} et @samp{>} --
@lilypond[quote,relative=1,fragment,verbatim]
r4 <c e g>4 <c f a>8
Vous pouvez combiner les indications comme les liaisons et les liens de
-croches avec les accords. Ils doivent cependant être placés en
-dehors des symboles @samp{<} et @samp{>}
+croches avec les accords. Ils doivent cependant être placés en
+dehors des angles :
@lilypond[quote,relative=1,fragment,verbatim]
r4 <c e g>8[ <c f a>]~ <c f a>
@cindex pickup
@cindex anacruse
@cindex partial measure
-Une levée est entrée avec le mot-clef @code{\partial}. Il est suivi par
+Une levée est entrée avec le mot-clé @code{\partial}. Il est suivi par
une durée : @code{\partial 4} est une levée d'une noire et
@code{\partial 8} d'une croche.
@cindex tuplets
@cindex triplets
-Les n-olets sont créés avec le mot-clef @code{\times}. Il prend deux
-arguments : une fraction et une de la musique. La durée de la partie
-musique est multipliée par la fraction. Les triolets ne prennent que
-2/3 du temps de leur notation réelle, cette fraction est donc de 2/3
-pour les triolets.
+Les n-olets sont créés avec le mot-clef @code{\times}. Celui-ci prend
+deux arguments : une fraction et une expression musicale. La durée des
+notes de l'expression musicale est multipliée par la fraction. Les
+notes d'un triolet durent les deux tiers du temps de leur notation
+réelle, cette fraction est donc de 2/3 pour les triolets :
@lilypond[quote,relative=1,verbatim,fragment]
\times 2/3 { f8 g a }
@cindex grace notes
@cindex acciaccatura
-Les notes d'ornement sont aussi créées en préfixant une expression musicale
-avec le mot-clef @code{\appoggiatura} ou @code{\acciaccatura}.
+Des notes d'ornement sont produites en préfixant une expression musicale
+avec le mot-clé @code{\appoggiatura} ou @code{\acciaccatura} :
@cindex appoggiatura
@cindex acciaccatura
@quotation
@table @asis
-@item Ornementations
+@item ornementations
voir @ref{Grace notes},
-@item N-olets
+@item n-olets
voir @ref{Tuplets},
-@item Mesures partielles
+@item mesures incomplètes (levées)
voir @ref{Partial measures}.
@end table
@end quotation
@cindex line comment
@cindex block comment
Un commentaire est une remarque à l'attention du lecteur du fichier
-source ; il est ignoré lors de l'analyse du fichier, et n'aura donc
-aucun effet sur la sortie imprimable. Il existe deux types
-de commentaires. Le symbole pourcent @samp{%} introduit un commentaire
-d'une ligne ; après @code{%}, le reste de la ligne est ignoré. Un bloc de
-commentaire marque une section entière dans le fichier d'entrée. Tout ce
-qui est à l'intérieur de @code{%@{} et @code{%@}} est ignoré. Le fragment
-suivant montre les utilisations possible des commentaires.
+source ; il est ignoré lors de l'analyse du fichier, et n'a donc
+aucun effet sur la sortie imprimable. Il existe deux types
+de commentaires. Le symbole pourcent @samp{%} introduit un commentaire
+d'une ligne : après @code{%}, le reste de la ligne est ignoré. Un bloc de
+commentaire marque une section entière dans le fichier d'entrée. Tout ce
+qui est à l'intérieur de @code{%@{} et @code{%@}} est ignoré. Le fragment
+suivant montre les utilisations possible des commentaires :
@example
% mélodie de "ah vous dirais-je maman"
sont ignorées, puisque'elles sont dans
un bloc de commentaire.
- g g f f e e d d c2
+ f f e e d d c2
%@}
@end example
@cindex versioning
-Il y a une déclaration particulière qui est une sorte de commentaire. La
+Il y a une déclaration particulière qui est une sorte de commentaire. La
déclaration @code{\version} stipule le numéro de la version de LilyPond
-pour laquelle le fichier a été écrit. Pour donner à un fichier la version
+pour laquelle le fichier a été écrit. Pour donner à un fichier la version
2.10.0, utilisez
@example
@end example
@noindent
-Ces annotations permettent de faciliter les prochaines mises à jour de
-LilyPond. Les changements dans la syntaxe sont gérés avec un
-programme spécial, @file{convert-ly} (voir @ref{Updating files with
-convert-ly}), et il utilise @code{\version} pour déterminer les
-règles de conversion à appliquer au fichier.
+Cette annotation permet de faciliter les prochaines mises à jour de
+LilyPond. Les changements dans la syntaxe sont gérés avec un
+programme spécial, @file{convert-ly} -- voir
+@ref{Updating files with convert-ly} -- et il utilise @code{\version}
+pour déterminer les règles de conversion à appliquer au fichier.
@node Printing lyrics
@cindex Lyrics
@cindex Songs
-Les paroles sont entrées en séparant chaque syllable par un espace.
+Les paroles sont entrées en séparant chaque syllable par un espace :
@example
I want to break free
}
@end lilypond
-Les paroles peuvent être accolées à ces notes en les combinant avec le
-mot-clef @code{\addlyrics}
+Les paroles peuvent être associées à ces notes en les combinant avec le
+mot-clé @code{\addlyrics}
@lilypond[quote,verbatim,fragment,ragged-right]
<<
@c synonyms?
Cette mélodie se termine sur un mélisme (@rglos{melisma}),
c'est-à-dire qu'une seule syllable (« free ») correspond à plus d'une
-note. Ceci est indiqué avec une @emph{ligne d'extension}. Elle est
-entrée avec deux caractères souligné (@code{_}), c'est à dire
+note. Ceci est indiqué avec une @emph{ligne d'extension}. Elle est
+entrée avec deux caractères souligné (@code{_}), c'est-à-dire
@example
@{ I want to break free __ @}
De la même manière, les séparations syllabiques d'un mot peuvent être entrées
avec deux tirets (@code{-}), ce qui produit un tiret centré entre les deux
-syllabes.
+syllabes :
@example
A -- le gri -- a
>>
@end lilypond
-Plus d'options, comme celle d'ajouter plusieurs lignes de paroles en dessous
-d'une même mélodie sont exposées dans @ref{Vocal music}.
+Plus de possibilités, comme celle d'ajouter plusieurs lignes de
+paroles en dessous d'une même mélodie sont exposées à
+@ref{Vocal music}.
@node A lead sheet
@c TODO: revise this, \chords { } is shorter and more intuitive.
-Dans la variété, il est courant d'indiquer l'accompagnement par le
-nom des accords. De tels accords peuvent être entrés comme les notes,
+Dans la musique de variété, il est courant d'indiquer l'accompagnement
+par le nom des accords. De tels accords peuvent être entrés comme les
+notes :
@lilypond[quote,verbatim,ragged-right]
\chordmode { c2 f4. g8 }
@noindent
Maintenant, chaque hauteur est lue comme la base de l'accord à la
-place de la note. Ce mode est activé avec @code{\chordmode}
+place de la note. Ce mode est activé avec @code{\chordmode}.
-Les autres accords peuvent être créés en ajoutant des indications après
-deux points. L'exemple suivant montre quelques indications usuelles.
+Les autres accords peuvent être créés en ajoutant des modifiacteurs après
+deux points. L'exemple suivant montre quelques modificateurs usuels :
@lilypond[quote,verbatim,ragged-right]
\chordmode { c2 f4:m g4:maj7 gis1:dim7 }
@end lilypond
Pour la musique improvisée, les accords ne sont pas imprimés sur des
-portées mais comme des lignes à part entière. Ceci s'obtient en
-utilisant @code{\chords} à la place de @code{\chordmode}. La même
-syntaxe sera utilisé que dans le cas de@code{\chordmode}, mais le
+portées mais comme des lignes à part entière. Ceci s'obtient en
+utilisant @code{\chords} à la place de @code{\chordmode}. La même
+syntaxe sera utilisée que dans le cas de@code{\chordmode}, mais le
rendu des notes interviendra dans un contexte de @code{ChordNames},
-avec le résultat suivant.
+avec le résultat suivant
@lilypond[quote,verbatim,ragged-right]
\chords { c2 f4.:m g4.:maj7 gis8:dim7 }
@cindex lead sheet
Une fois assemblés, les accords, paroles et mélodie forment une
-partition d'improvisation :
+partition de chanson :
@example
<<
- \chords @{ @emph{chords} @}
- @emph{the melody}
- \addlyrics @{ @emph{the text} @}
+ \chords @{ @emph{les accords} @}
+ @emph{la mélodie}
+ \addlyrics @{ @emph{le texte} @}
>>
@}
@end example
>>
@end lilypond
-Une liste complète de modificateurs et d'autres options pour
-l'agencement des pages se trouve à la section @ref{Chords}.
+Une liste complète de modificateurs et d'autres options de
+mise en forme se trouve à la section @ref{Chords}.
@node Adding titles
@section Adding titles
Les informations bibliographiques sont entrées dans un bloc séparé, le
-bloc d'entête (@code{\header}). Le nom du morceau, son compositeur, etc, sont
-déterminés et affectés dans @code{\header@{@tie{}@dots{}@tie{}@}}.
+bloc d'en-tête (@code{\header}). Le nom du morceau, son compositeur, etc., sont
+définis dans @code{\header@{@tie{}@dots{}@tie{}@}}.
Le bloc @code{\header} est habituellement placé en début de fichier.
Par exemple,
@end example
-Quand le fichier est traité, le titre et le compositeur sont imprimés en haut
-de la partition. Plus d'informations sur les titres peuvent être trouvées
-dans @ref{Creating titles}.
+Quand le fichier est traité, le titre et le compositeur sont imprimés
+en haut de la partition. Vous trouverez plus d'informations sur les
+titres à @ref{Creating titles}.
@node Single staff polyphony
@cindex voices, more -- on a staff
Quand différentes lignes mélodiques sont combinées sur une seule et
même portée, elle sont imprimées comme des voix polyphoniques ; chaque
-voix a ses propre queues, liaisons et barres, la voix supérieure ayant
-les queues vers le haut, la voix du bas vers le bas.
+voix a ses propre hampes@footnote{familièrement appelées queues de
+note.}, liaisons et ligatures, la voix supérieure ayant les hampes
+vers le haut, la voix inférieure vers le bas.
-Saisir ce type de partition est réalisé en entrant chaque voix comme
-une chaine (avec @code{@{...@}}), et en les combinant simultanément
-en séparant les voix avec @code{\\}.
+Ce type de partition est réalisé en entrant chaque voix comme
+une séquence (avec @code{@{...@}}), en combinant simultanément les
+voix et en les séparant par @code{\\} :
@lilypond[quote,verbatim,relative=2,fragment]
<< { a4 g2 f4~ f4 } \\
{ r4 g4 f2 f4 } >>
@end lilypond
-Pour l'écriture de musique polyphonique, des « blancs » (spacer rests)
-s'avèrent bien pratique ; ce sont des silences qui ne s'impriment pas. Ils
-sont utiles pour remplir les voix qui, temporairement, ne jouent pas. On peut
-voir ici le même exemple avec un « silence espace » (@code{s}) à la place
-d'un silence normal (@code{r}) :
+Pour l'écriture de musique polyphonique, les silences invisibles
+(spacer rests) s'avèrent bien pratiques ; ce sont des silences qui ne
+s'impriment pas. Ils sont utiles pour remplir des voix qui,
+temporairement, ne jouent rien. On peut voir ici le même exemple avec
+un silence espace invisible (@code{s}) à la place d'un silence normal
+(@code{r}) :
@lilypond[quote,verbatim,relative=2,fragment]
<< { a4 g2 f4~ f4 } \\
@end lilypond
@noindent
-Encore une fois, ces expressions peuvent s'imbriquer arbitrairement.
+Encore une fois, ces expressions peuvent s'imbriquer arbitrairement :
@lilypond[quote,fragment,verbatim,relative=2,fragment]
<<
@cindex staff switch, manual
@cindex cross staff voice, manual
-La musique pour piano s'écrit avec deux portées connectées par une
-accolade. Imprimer ce type de portée revient au même que dans l'exemple de
+La musique pour piano s'écrit avec deux portées reliées par une
+accolade. Imprimer ce type de portée revient au même que dans l'exemple de
musique polyphonique (@ref{More staves}),
@example
@end lilypond
Plus d'informations sur le formatage de la musique pour piano sont
-données dans @ref{Piano music}.
+données à @ref{Piano music}.
@node Organizing larger pieces
@section Organizing larger pieces
-Quand tous les éléments discutés plus haut sont combinés ensemble pour
-produire un fichier plus volumineux, les blocs @code{\score}
-deviennent beaucoup plus gros parce que les expressions musicales
-sont plus longues et, dans le cas des pièces polyphoniques, très
-emboîtées. Ce type d'expression imposante finit par devenir peu maniable.
+Lorsqu'on combine tous les éléments étudiés plus haut pour produire
+des fichiers plus volumineux, les blocs @code{\score} deviennent
+beaucoup plus gros parce que les expressions musicales sont plus
+longues et, dans le cas des pièces polyphoniques, profondément
+imbriquées. De telles expressions imposantes finissent par devenir peu
+maniables.
-En utilisant des variables, appelées également identifiants, il est
-possible de découper les expressions musicales complexes. Un identificateur
-est assigné comme suit :
+En utilisant des variables, appelées également identificateurs, il est
+possible de découper des expressions musicales complexes. Un identificateur
+se définit comme
@example
-namedMusic = @{ @dots{} @}
+MusiqueToto = @{ @dots{} @}
@end example
@noindent
-Le contenu de l'expression musicale @code{NomDeLaVariable}, peut être
-rappelé plus loin en faisant précéder son nom d'un anti-slash, par exemple
-@code{\NomDeLaVariable}. Dans l'exemple suivant, un motif de deux notes est
-répété deux fois en utilisant la substitution par une variable.
+Le contenu de l'expression musicale @code{MusiqueToto}, peut être
+utilisé plus loin en faisant précéder son nom d'un anti-slash, c'est-à-dire
+@code{\MusiqueToto}. Dans l'exemple suivant, un motif de deux notes est
+répété deux fois en utilisant la substitution par une variable :
@lilypond[quote,ragged-right,verbatim,nofragment]
seufzer = {
{ \seufzer \seufzer }
@end lilypond
-Le nom d'un identifiant ne doit comporter que des caractères
-alphabétiques, et pas de nombre, souligné ou tiret. L'assignation
-doit être faite en dehors de la musique.
+Le nom d'un identificateur ne doit comporter que des caractères
+alphabétiques non accentués, aucun nombre ni tiret. On doit le définir
+en dehors de toute expression musicale.
-Il est possible d'utiliser des variables de plusieurs types d'objet.
+Il est possible d'utiliser des variables de types variés.
Par exemple,
@example
-width = 4.5\cm
-name = "Wendy"
-aFivePaper = \paper @{ paperheight = 21.0 \cm @}
+largeur = 4.5\cm
+nom = "Wendy"
+papierACinq = \paper @{ paperheight = 21.0 \cm @}
@end example
-En fonction de son contenu, l'identifiant peut être utilisé à différents
-endroits. L'exemple suivant utilise la variable précédente :
+En fonction de son contenu, l'identificateur peut être utilisé à différents
+endroits. L'exemple suivant utilise la variable précédente :
@example
\paper @{
- \aFivePaper
- line-width = \width
+ \papierACinq
+ line-width = \largeur
@}
-@{ c4^\name @}
+@{ c4^\nom @}
@end example
-Plus d'informations sur les recours possibles aux identifiants
-sont données dans le manuel technique, section @ref{Input variables
-and Scheme}.
+Vous trouverez plus d'informations sur les usages possibles des
+identificateurs dans le manuel technique, section
+@ref{Input variables and Scheme}.
@c fixme: the ref is too technical.
@node An orchestral part
@section An orchestral part
-Pour la musique d'orchestre, toutes les notes sont imprimées deux fois.
-Une partition pour chaque pupître, et un conducteur pour le chef.
-Recourrir à des identifiants permet de s'épargner un double travail. La
-musique est entrée une seule fois, et enregistrée dans une variable. Le
+Pour la musique d'orchestre, toute la musique est imprimée deux fois.
+Une partie séparée pour chaque pupitre, et un conducteur pour le chef.
+Recourir à des identifiants permet de s'épargner un double travail. La
+musique est entrée une seule fois, et enregistrée dans une variable. Le
contenu de ces variables sera utilisé pour générer à la fois la
partie d'instrument et le conducteur.
-Définir les notes dans un fichier spécial est très pratique. Par
-exemple, supposons que le fichier @file{horn-music.ly} contienne la
-partie d'un duo haubois/@/basson.
+Définir les notes dans un fichier à part est très pratique. Par
+exemple, supposons que le fichier @file{musique-cor.ly} contienne la
+partie d'un duo cor/@/basson :
@example
-hornNotes = \relative c @{
+notesCor = \relative c @{
\time 2/4
r4 f8 a cis4 f e d
@}
@end example
@noindent
-Puis, une partie individuelle est faite en mettant ce qui suit dans
+Puis, une partie individuelle est créée en mettant ce qui suit dans
un fichier
@example
-\include "horn-music.ly"
+\include "musique-cor.ly"
\header @{
- instrument = "Horn in F"
+ instrument = "Cor en fa"
@}
@{
- \transpose f c' \hornNotes
+ \transpose f c' \notesCor
@}
@end example
La ligne
@example
-\include "horn-music.ly"
+\include "musique-cor.ly"
@end example
@noindent
-substitue le contenu de @file{horn-music.ly} à cet endroit dans le
-fichier, ainsi @code{hornNotes} est définit pour ce qui suivra. La commande
-@code{\transpose f@tie{}c'} indique que l'argument, en l'occurence
-@code{\hornNotes}, doit être transposé une quinte au-dessus. Entendre
-@samp{fa} correspond à la notation @code{do'}, ce qui correspond à la
-transpostion d'un cor anglais en fa. La transposition peut être
-constatée dans la sortie suivante :
+indique à LilyPond de lire le contenu de @file{musique-cor.ly} à cet
+endroit dans le fichier, ainsi @code{notesCor} est défini pour ce qui
+suivra. La commande @code{\transpose f@tie{}c'} indique que
+l'argument, en l'occurence @code{\notesCor}, doit être transposé d'une
+quinte ascendante. Le son entendu @samp{fa} correspond à la note écrite
+@code{do'}, ce qui correspond bien à la transpostion d'un cor en
+fa. La transposition peut être constatée dans la sortie suivante :
@lilypond[quote,ragged-right]
\transpose f c' \relative c {
@end lilypond
Dans la musique d'ensemble, il arrive souvent qu'une des voix ne joue
-pas pendant plusieurs mesures. Ceci est spécifié par un silence
-spécial, le silence multi-mesure (mesures à compter). Il est saisi
+pas pendant plusieurs mesures. Ceci est spécifié par un silence
+spécial, le silence multi-mesures (mesures à compter). Il est saisi
par une lettre capitale @samp{R} suivie d'une durée (@code{1}@tie{}pour une
-ronde, @code{2}@tie{}pour une blanche, etc.). En multipliant la durée, on
-peut construire des silences plus longs. Par exemple, ce silence dure
+ronde, @code{2}@tie{}pour une blanche, etc.). En multipliant la durée, on
+peut construire des silences plus longs. Par exemple, ce silence dure
3@tie{}mesures à 2/4
@example
@end example
Pour l'impression de parties séparées, ces silences multi-mesures doivent être
-condensés. Ceci est réalisé en réglant une variable « run-time »
+condensés. On peut l'obtenir en réglant une variable d'exécution
@example
\set Score.skipBars = ##t
@noindent
Cette commande règle la propriété @code{skipBars} dans le contexte
-@code{Score} à vrai (@code{##t}). Faire précéder la musique plus haut
-par ce silence et cette option à la musique produit au résultat suivant
+@code{Score} à vrai (@code{##t}). En faisant précéder la musique plus haut
+du silence et de cette option, on obtient
@lilypond[quote,ragged-right]
\transpose f c' \relative c {
@end lilypond
-Le conducteur est créé en combinant ensemble toutes les parties. En
-supposant que l'autre voix soit dans @code{bassoonNotes} du fichier
-@file{bassoon-music.ly}, un conducteur est fait avec
+On crée le conducteur en combinant toutes les parties. En
+supposant que l'autre voix soit dans l'expression @code{notesBasson} du fichier
+@file{musique-basson.ly}, le conducteur est composé des commandes
@example
-\include "bassoon-music.ly"
-\include "horn-music.ly"
+\include "musique-cor.ly"
+\include "musique-basson.ly"
<<
- \new Staff \hornNotes
- \new Staff \bassoonNotes
+ \new Staff \notesCor
+ \new Staff \notesBasson
>>
@end example
@noindent
-leading to
+donnant pour résultat
@lilypond[quote,ragged-right]
\relative c <<
De plus amples informations sur la gestion des parties et conducteurs
se trouvent dans le manuel de notation, section @ref{Orchestral music}.
-Le réglage des variables « run-time » ("propriétés") est abordé dans
+Le réglage des variables d'exécution (« propriétés ») est abordé dans
@ref{Changing context properties on the fly}.
@section After the tutorial
Après avoir parcouru ce tutoriel, vous devriez vous essayer à écrire
-un morceau ou deux. Commencez par l'une des matrices (@ref{Example
-templates}) et ajoutez-y des notes. Si vous utilisez une notation que
-vous n'avez pas trouvé dans le tutoriel, consultez la section Notation
-Reference (@ref{Basic notation}). Si vous désirez écrire pour un
+un morceau ou deux. Commencez par copier l'un des modèles types (@ref{Example
+templates}) et ajoutez-y des notes. Si vous voulez employer une notation que
+vous n'avez pas trouvé dans le tutoriel, consultez la référence de
+notation, en commençant par la @ref{Basic notation}. Si vous désirez écrire pour un
ensemble instrumental non couvert par les @ref{Example templates},
lisez la section @ref{Extending the templates}.
Après avoir écrit quelques pièces courtes, lisez les chapitres 3 à 5
-du utilisateur. Rien ne s'oppose à ce que vous consultiez dès à
+du manuel d'apprentissage. Rien ne s'oppose à ce que vous consultiez dès à
présent les autres chapitres, bien sûr ! Néanmoins, le reste du manuel
-utilisateur part du principe que vous avez déjà bien assimilé la
-syntaxe de LilyPond. Vous pouvez toujours survoler le reste du manuel,
-et y revenir plus tard, ayant acquis de l'expérience.
+de l'utilisateur part du principe que vous avez déjà bien assimilé la
+syntaxe de LilyPond. Vous pouvez toujours survoler le reste du manuel,
+et y revenir plus tard après avoir acquis de l'expérience.
projects / lilypond.git / commitdiff