@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
@c This file is part of lilypond.tely
@ignore
- Translation of GIT committish: b40f25ec7472b855483b5eb9126747bfb9487fe1
+ Translation of GIT committish: 71b67137f76fa4e8aede58299630369f616004d9
When revising a translation, copy the HEAD committish of the
version that you are working on. See TRANSLATION for details.
@c Your first LilyPond score in 10 minutes?
+@c Translators: Nicolas Grandclaude, Ludovic Sardain, Gauvain Pocentek
+@c Translation checkers: Jean-Charles Malahieude, Valentin Villenave, John Mandereau
+
+
@node Tutorial
@chapter Tutorial
Essayez sur cette image :
@c no verbatim here
+@c KEEP LY
@lilypond[quote,ragged-right]
\relative c'' {
- c-\markup { \bold \huge { Click here. } }
+ c-\markup { \bold \huge { Cliquez ici. } }
}
@end lilypond
-En copiant et en collant tout le code @qq{ly snippet} dans un fichier test,
-vous aurez un modèle de base pour faire vos expériences. Si vous
-apprenez de cette façon, vous aurez probablement envie d'imprimer ou
-de garder un lien vers la
-@ref{Cheat sheet}, tableau qui répertorie les commandes usuelles
-pour une consultation rapide.
+En copiant et en collant tout le code de l'extrait ly dans un fichier
+test, vous aurez un modèle de base pour faire vos expériences. Si vous
+apprenez de cette façon, vous aurez probablement envie d'imprimer ou de
+garder un lien vers l'@ruser{Cheat sheet}, tableau qui répertorie les
+commandes usuelles pour une consultation rapide.
@end ifhtml
@menu
la ligne. Bien que certains exemples de ce manuel ne comportent pas
d'accolades, ne les oubliez pas dans vos partitions !
-@cindex Case sensitive
+@cindex casse, prise en compte de
De plus, LilyPond est sensible à la casse. @code{ @{ c d e @} } est
un code valide ; @code{ @{ C D E @} } produira un message d'erreur.
@subsubheading MacOS X
-Si vous double-cliquez sur LilyPond.app, un fichier d'exemple
+Si vous double-cliquez sur @code{LilyPond.app}, un fichier d'exemple
s'ouvrira. 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 sera alors affiché sur votre
@subsubheading Windows
-Sous Windows, démarrez un éditeur de texte @footnote{N'importe quel
-éditeur simple ou orienté programmation, qui prend en charge le codage
-de caractères UTF-8, fera l'affaire, par exemple le Bloc-notes. 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' e' g' e'
-}
-@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
-fichier @file{test.ly} pour le traiter et afficher le fichier
-PDF résultant. Pour modifier un fichier @file{.ly} existant, faites
-un clic droit dessus et sélectionnez @qq{Éditer la source}.
-
-Si vous double-cliquez sur l'icône LilyPond sur le Bureau, un fichier
-d'exemple s'ouvrira dans un simple éditeur de texte. Enregistrez-le,
-par exemple en tant que @file{test.ly} sur votre Bureau, puis
-double-cliquez dessus pour le traiter. Après quelques secondes, vous
-obtiendrez un fichier @file{test.pdf} sur votre Bureau, fichier que
-vous pourrez ouvrir pour voir la partition imprimée. Une autre
-méthode pour lancer le traitement du fichier @file{test.ly} est de le
-glisser avec votre souris sur l'icône de LilyPond.
+Sous Windows, lorsque vous double-cliquez sur l'icône LilyPond qui se
+trouve sur le Bureau, un fichier d'exemple s'ouvre dans un simple
+éditeur de texte. Enregistrez-le, par exemple en tant que
+@file{test.ly} sur votre Bureau, puis double-cliquez sur son icône
+(qui montre une note de musique) pour le traiter. Après quelques
+secondes, vous obtiendrez un fichier @file{test.pdf} sur votre Bureau,
+fichier que vous pourrez ouvrir pour voir la partition imprimée. Une
+autre méthode pour lancer le traitement du fichier @file{test.ly} est
+de le glisser avec votre souris sur l'icône de LilyPond.
+
+Pour modifier un fichier @file{.ly} existant, faites un clic droit
+dessus et sélectionnez @qq{Éditer la source}. Pour partir d'un
+fichier vide, lancez l'éditeur en ouvrant un fichier existant et
+utilisez la commande @qq{New} du menu @qq{File}.
En double-cliquant sur le fichier, vous obtiendrez, en plus du fichier
PDF, un fichier @file{.log} qui récapitule les opérations que LilyPond
-a effectuées sur votre fichier. Si une erreur advient, c'est ce
+a effectuées sur votre fichier. Si une erreur survient, c'est ce
fichier qu'il vous faudra étudier.
+Notez qu'il existe d'autres éditeurs de texte, certains disposant d'un
+meilleur support pour LilyPond ; reportez-vous à @rprogram{Text editor support}.
+
@subsubheading Unix
encore installés, consultez le fichier @file{INSTALL.txt}. L'outil
d'édition le plus facile d'utilisation est de loin
@file{LilyPondTool}. Vous trouverez plus d'informations dans
-@ref{Editor support}.} Dans votre
+@rprogram{Text editor support}.} Dans votre
éditeur, entrez le texte suivant et sauvegardez le fichier sous
@file{test.ly}
Suivant votre installation, ces messages peuvent être traduits.
@c END DIV
-@cindex PDF file
-@cindex Viewing music
+@cindex fichier PDF
+@cindex visionnage de la musique
@noindent
De tout cela résulte un fichier @file{test.pdf}, que vous pouvez imprimer
La note de départ est @rglos{middle C}. Chacune des notes qui suivent
est à moins d'une quarte de la note précédente --- en d'autres termes,
le premier @samp{c} est le do central, entre la clé de sol et
-la clé de sa, puis est suivi par le ré le plus proche, et ainsi de
+la clé de fa, puis est suivi par le ré le plus proche, et ainsi de
suite. On peut bien sûr créer des mélodies d'intervalles plus étendus :
@lilypond[quote,ragged-right,verbatim]
pour les notes suivantes. En l'absence d'indication, la première note
est une noire.
-Les @rglos{dotted notes} s'obtiennent en ajoutant un point @samp{.} à
+Une @rglos{dotted note} s'obtient en ajoutant un point @samp{.} à
la valeur rythmique.
@lilypond[quote,ragged-right,verbatim]
@subheading Time signature
-Le @rglos{time signature} peut être défini à l'aide de la commande
+La @rglos{time signature} peut être définie à l'aide de la commande
@code{\time} :
@lilypond[quote,ragged-right,verbatim]
}
@end lilypond
-@moreinfo
+@seealso
@quotation
@table @asis
@item Entrer des hauteurs et des durées
-voir @ref{Pitches} and @ref{Durations}.
+voir @ruser{Pitches} and @ruser{Durations}.
@item Les silences
-voir @ref{Rests}.
+voir @ruser{Rests}.
@item Les chiffres de mesure et autres commandes de métrique
-voir @ref{Time signature}.
+voir @ruser{Time signature}.
@item Les clés
-voir @ref{Clef}.
+voir @ruser{Clef}.
@end table
@end quotation
@node Working on text files
@subsection Working on text files
-Les fichiers d'entrée de LilyPond sont traités comme la plupart des
-langages de programmation : la casse est prise en compte mais pas les
-espaces vides, les expressions musicales sont délimitées par des
-accolades @{ @}, et les commentaires par des @code{%} ou @code{%@{ ..
-%@}}.
+Le traitement des fichiers source de LilyPond est semblable à celui du
+code de nombreux langages de programmation répandus : la casse est prise
+en compte, et les caractères considérés comme espaces ont généralement
+peu d'importance. Les expressions sont délimitées par des accolades @{
+@}, et les commentaires par @code{%} ou @code{%@{ ... %@}}.
Si cette phrase vous paraît incompréhensible, ne vous en faites pas !
Tous ces termes vont être expliqués :
@itemize
-@cindex Case sensitive
+@cindex casse, prise en compte de
@item @strong{La casse} :
-LilyPond est sensible à la casse, c'est à dire qu'une lettre en
-capitales n'a pas la même valeur qu'une lettre en minuscules. Les
-notes, par exemple, doivent être entrées en minuscules : @code{ @{ c
-d e @} } est
-un code valide, alors que @code{ @{ C D E @} } produira un message d'erreur.
+LilyPond est sensible à la casse, c'est à dire qu'une lettre capitale
+n'a pas la même valeur qu'une lettre minuscule. Les notes, par
+exemple, doivent être entrées en minuscules : @code{@{ c d e @}} est
+un code valide, alors que @code{@{ C D E @}} produira un message
+d'erreur.
@item @strong{Les espaces multiples} :
LilyPond ne tient pas compte du nombre d'espaces, ou de retours à la
-ligne. @code{ @{ c d e @}} a le même sens que @code{ @{ c @ @ @ @ @
-d e @} } ou que
+ligne. @code{@{ c d e @}} a le
+même sens que @code{@{ c @tie{} @tie{} d @tie{} e @}} ou que
@example
@{
c d
@}
@end example
-@item @strong{Expressions musicales :}
+@item @strong{Expressions musicales} :
Tout morceau saisi dans LilyPond doit être placé entre @strong{@{
accolades @}}. Ces caractères indiquent à LilyPond que ce bloc de
texte est une et une seule expression musicale, tout comme les
éviter toute ambiguïté, d'entourer tous ces crochets d'espaces, à
moins qu'ils se trouvent au début ou à la fin d'une ligne.
-Une fonction telle que @code{\relative @{ @}} ) compte également comme
-une seule expression musicale.
+Une fonction --- @code{\relative @{ @}} par exemple --- compte
+également comme une seule expression musicale.
-@cindex comments
-@cindex line comment
-@cindex block comment
+@cindex commentaires
+@cindex commentaire de fin de ligne
+@cindex commentaire-bloc
@item @strong{Les commentaires} :
Un commentaire est une indication pour tout lecteur humain d'un
fichier de musique ; il est ignoré par l'ordinateur, et n'a donc aucun
tout ce qui suit ce symbole sur cette ligne sera ignoré.
@item le bloc de commentaire, qui peut être de plusieurs lignes voire
de toute une section : tout ce qui se trouve entre @code{%@{} et
-@code{%@}} est ignoré.
+@code{%@}} est ignoré. Les blocs de commentaires ne peuvent s'imbriquer.
@end itemize
Le fragment suivant met en évidence quelques usages possibles des commentaires :
@end itemize
Vous trouverez plus d'astuces pour organiser vos fichiers LilyPond dans
-@ref{Suggestions for writing LilyPond files}.
+@ruser{Suggestions for writing LilyPond files}.
@node How to read the tutorial
@subsection How to read the tutorial
-Comme nous l'avons vu dans @ref{Working on text files}, un code
+Comme nous l'avons vu dans @ruser{Working on text files}, un code
LilyPond doit être encadré par des @{ @} ou bien par @code{\relative
c'' @{ ... @}} afin d'être compris. Cependant, dans la suite de ce
manuel, la plupart des exemples ne feront pas apparaître ces signes.
@node Relative note names
@subsection Relative note names
-Comme nous l'avons vu dans @ref{Simple notation}, LilyPond calcule la
+Comme nous l'avons vu dans @ruser{Simple notation}, LilyPond calcule la
hauteur de chaque note en fonction de la précédente@footnote{Il existe
-un autre mode de saisie des hauteurs, le mode @ref{Absolute note
+un autre mode de saisie des hauteurs, le mode @ruser{Absolute note
names}, mais en pratique il est bien plus aisé et sûr d'avoir recours
au mode de hauteurs relatives.}. Si aucune indication supplémentaire
-d'octaviation n'est ajoutée, il en conlcuera que chaque hauteur est
+d'octaviation n'est ajoutée, il en concluera que chaque hauteur est
située à une quarte au plus de la note précédente.
Lilypond tient compte des intervalles induits par les noms des notes
c2 ges
@end lilypond
-@moreinfo
+@seealso
@quotation
@table @asis
@item Les hauteurs de note relatives
-voir @ref{Relative octaves}.
+voir @ruser{Relative octaves}.
@item Les vérifications d'octaves
-voir @ref{Octave check}.
+voir @ruser{Octave check}.
@end table
@end quotation
respectivement @samp{dd} et @samp{bb}
@c END DIV
-Pour en savoir plus sur les autres langues disponibles, voir @ref{Note
-names in other languages}.}
+Pour en savoir plus sur les autres langues disponibles, voir @ruser{Note
+names in other languages}.
@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
cis1 ees fisis, aeses
@end lilypond
-@cindex key signature, setting
+@cindex armure, définition de
@subheading Key signatures
L'armure est déterminée par la commande @code{\key}, suivie d'une
@end lilypond
@noindent
-Aucune note n'a ici d'altération accidentelle, et pourtant vous devrez
+aucune note n'a d'altération accidentelle, et pourtant vous devrez
entrer le @samp{is} pour les notes @code{cis} et @code{fis}.
Le code @samp{d} ne veut pas dire @qq{Imprimez-moi un point noir juste
grandement facilitée.
De plus les altérations accidentelles
peuvent être imprimées suivant plusieurs conventions. Regardez
-@ref{Automatic accidentals} pour connaître les différentes manières dont les
+@ruser{Automatic accidentals} pour connaître les différentes manières dont les
altérations accidentelles peuvent être imprimées, suivant les règles
que vous choisirez.
-@moreinfo
+@seealso
@quotation
@table @asis
@item Les altérations
-voir @ref{Accidentals} and @ref{Automatic accidentals}.
+voir @ruser{Accidentals} and @ruser{Automatic accidentals}.
@item Les armures
-voir @ref{Key signature}.
+voir @ruser{Key signature}.
@end table
@end quotation
@node Ties and slurs
@subsection Ties and slurs
-@cindex ties
+@cindex liaisons de prolongation
@subheading Ties
Une @rglos{tie}@footnote{parfois aussi appelée liaison de
tenue} se crée en ajoutant un tilde @samp{~} à la première note liée.
c4 ~ c8 a8 ~ a2
@end lilypond
-@cindex slurs
+@cindex liaisons d'articulation
@subheading Slurs
@c Le terme de "slur" a deux sens en français : articulation et phrasé.
@c car c'est celui qui me semble le plus couramment employé.
Une @rglos{slur} d'articulation (ou @qq{legato}) peut englober
-plusieurs notes. La note de départ et d'arrivée reçoivent
+plusieurs notes. Les notes de départ et d'arrivée reçoivent
respectivement un signe @samp{(} et @samp{)}.
@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
d4( c16) cis( d e c cis d) e( d4)
@end lilypond
-@cindex slurs, phrasing
-@cindex phrasing slurs
+@cindex liaisons de phrasé
@subheading Phrasing slurs
-@cindex phrasing slurs
De plus longues liaisons, dites de phrasé, sont délimitées par @code{\(} et
@code{\)}. Il est possible d'avoir en même temps des legatos et des
phrasés, mais pas plusieurs liaisons de phrasé ou de legato à la fois.
@sp 1
-@cindex slurs versus ties
+@cindex liaisons de phrasé et de prolongation, différences
@subheading Warnings: slurs vs. ties
Une liaison d'articulation ou de phrasé ressemble à une liaison de
c2~( c8 fis fis4 ~ fis2 g2)
@end lilypond
-@moreinfo
+@seealso
@quotation
@table @asis
-@item Liaisons de prolongation
-voir @ref{Ties}.
-@item Legato
-voir @ref{Slurs}.
-@item Liaisons de phrasé
-voir @ref{Phrasing slurs}.
+@item @ruser{Ties},
+@item @ruser{Slurs},
+@item @ruser{Phrasing slurs}.
@end table
@end quotation
@cindex staccato
@subheading Articulations
-Des @rglos{articulations} peuvent être ajoutées à une note, au moyen
+Des @rglos{articulation}s peuvent être ajoutées à une note, au moyen
d'un tiret @samp{-} suivi d'un caractère :
@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
c-. c-- c-> c-^ c-+ c-_
@end lilypond
-@cindex fingering
+@cindex doigtés
@subheading Fingerings
De même, des indications de doigté peuvent être ajoutées à une note en
utilisant un tiret (@samp{-}) et le chiffre à écrire :
Articulations et doigtés sont habituellement placés automatiquement,
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.
+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[quote,ragged-right,verbatim,fragment,relative=2]
c_-^1 d^. f^4_2-> e^-_+
c\ff c\mf c\p c\pp
@end lilypond
-@cindex dynamics
+@cindex nuances
@cindex decrescendo
@cindex crescendo
@c selon Littré, plutôt à la française (en "-os" qu'en "-i")
Crescendos et decrescendos 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{\!} :
+@code{\>}. Ils se terminent soit par une nuance d'arrivée, par exemple
+@code{\f}, soit par la commande @code{\!} :
@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
c2\< c2\ff\> c2 c2\!
@end lilypond
-@moreinfo
+@seealso
@quotation
@table @asis
-@item Articulations
-voir @ref{Articulations}.
-@item Doigtés
-voir @ref{Fingering instructions}.
-@item Nuances
-voir @ref{Dynamics}.
+@item @ruser{Articulations}.
+@item @ruser{Fingering instructions}.
+@item @ruser{Dynamics}.
@end table
@end quotation
@node Automatic and manual beams
@subsection Automatic and manual beams
-@cindex beams, by hand
-Toutes les @rglos{beam}s sont dessinées automatiquement :
+@cindex ligatures manuelles
+Toutes les @rglos{beam} sont dessinées automatiquement :
@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
a8 ais d ees r d c16 b a8
@noindent
Lorsqu'on n'aime pas la manière dont les notes sont automatiquement
-groupées, il est possible de les entrer à la main, en marquant la
+groupées, il est possible de les ligaturer manuellement, en marquant la
première note à attacher d'un @samp{[} et la dernière d'un @samp{]}.
@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
a8[ ais] d[ ees r d] a b
@end lilypond
-@moreinfo
+@seealso
@quotation
@table @asis
@item Groupements de notes et ligatures automatiques
-voir @ref{Automatic beams}.
+voir @ruser{Automatic beams}.
@item Groupements et ligatures manuels
-voir @ref{Manual beams}.
+voir @ruser{Manual beams}.
@end table
@end quotation
@node Advanced rhythmic commands
@subsection Advanced rhythmic commands
-@cindex pickup
-@cindex anacruse
-@cindex partial measure
+@cindex levée
+@cindex anacrouse
+@cindex mesure incomplète
@subheading Partial measure
Une levée (ou @rglos{anacrusis}) est entrée avec la commande
@code{\partial}, suivie d'une durée : @code{\partial 4} est une levée
-d'une noire et
-@code{\partial 8} d'une croche.
+d'une noire et @code{\partial 8} d'une croche.
@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
\partial 8
f8 c2 d
@end lilypond
-@cindex tuplets
-@cindex triplets
+@cindex nolets
+@cindex triolets
@subheading Tuplets
-Les nolets sont créés avec la commande @code{\times}, qui prend
-deux arguments : une fraction et une expression musicale. La durée des
-notes de l'expression musicale est multipliée par la fraction. Par exemple les
-notes d'un triolet durent les deux tiers du temps de leur notation
+Les nolets sont créés avec la commande @code{\times}, qui prend deux
+arguments : une fraction et une expression musicale. La durée des notes
+de l'expression musicale est multipliée par la fraction. Par exemple
+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,ragged-right,verbatim,fragment,relative=2]
\times 2/3 { d4 a8 }
@end lilypond
-@cindex grace notes
-@cindex acciaccatura
-@cindex appoggiatura
+@cindex notes d'ornement
+@cindex ornementation
+@cindex appoggiature
@subheading Grace notes
-Des notes d'ornement sont produites par la commande @code{\grace},
-mais aussi en préfixant une expression musicale avec le mot-clé
+Des notes d'ornement sont produites par la commande @code{\grace}, mais
+aussi en préfixant une expression musicale avec le mot-clé
@code{\appoggiatura} ou @code{\acciaccatura} :
@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
c2 \acciaccatura b16 c2
@end lilypond
-@moreinfo
+@seealso
@quotation
@table @asis
@item Notes d'ornement
-voir @ref{Grace notes},
+voir @ruser{Grace notes},
@item nolets
-voir @ref{Tuplets},
+voir @ruser{Tuplets},
@item levées
-voir @ref{Partial measures}.
+voir @ruser{Partial measures}.
@end table
@end quotation
@node Multiple notes at once
@section Multiple notes at once
-Cette section traite des situations où l'on a plus d'une note à la
-fois : plusieurs instruments, plusieurs portées pour un même
-instrument (le piano, par exemple), et les accords.
+Cette section traite des situations où l'on a plus d'une note à la fois
+: plusieurs instruments, plusieurs portées pour un même instrument (le
+piano, par exemple), et les accords.
La polyphonie, en théorie musicale, est la notion d'une musique
constituée de plusieurs voix ; dans lilypond, ce terme désigne les
* Music expressions explained::
* Multiple staves::
* Piano staves::
-* Single staff polyphony::
* Combining notes into chords::
+* Single staff polyphony::
@end menu
@node Music expressions explained
@subsection Music expressions explained
-Dans les fichiers source LilyPond, la musique est représentée par ce qu'on
-appelle des @emph{expressions musicales}. En soi, une seule note peut
-constituer une
-expression musicale, si tant est qu'elle soit correctement encadrée :
+Dans les fichiers source LilyPond, la musique est représentée par ce
+qu'on appelle des @emph{expressions musicales}. En soi, une seule note
+peut constituer une expression musicale, si tant est qu'elle soit
+correctement encadrée :
@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
a4
@subheading Simultaneous music expressions: multiple staves
-Cette technique est utile pour de la musique polyphonique. Pour
-entrer une musique avec plusieurs voix ou plusieurs portées, nous
-pouvons aussi combiner en parallèle les expressions. Deux voix qui doivent être
+Cette technique est utile pour de la musique polyphonique. Pour entrer
+une musique avec plusieurs voix ou plusieurs portées, nous 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 expressions. Une expression musicale @q{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.
+suivant, trois expressions (contenant chacune deux notes distinctes)
+sont combinées simultanément.
@lilypond[quote,ragged-right,verbatim]
\relative c'' {
}
@end lilypond
-Notez que nous avons ici indenté chaque niveau du fichier d'entrée
-avec un nombre d'espaces différent. LilyPond se moque de l'espace
-qu'il peut y avoir (ou pas) au début d'une ligne, mais en indentant
-votre code vous le rendrez bien plus facile à lire pour les humains.
+Notez que nous avons ici indenté chaque niveau du fichier d'entrée avec
+un nombre d'espaces différent. LilyPond se moque de l'espace qu'il peut
+y avoir (ou pas) au début d'une ligne, mais en indentant votre code vous
+le rendrez bien plus facile à lire pour les humains.
@strong{Attention} : chaque note saisie est relative à la précédente,
mais pas au @code{c''} de la commande @code{\relative} de départ.
@end lilypond
@cindex expression
-@cindex music expression
+@cindex expression musicale
@subheading Analogy: mathematical expressions
Ce mécanisme est similaire au formules mathématiques : une grosse
@end example
Ceci est une suite d'expressions, où chacune est contenue dans la
-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
+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
+musicales peuvent être imbriquées avec une profondeur arbitraire, ce qui
+est nécessaire pour de la musique complexe comme des partitions
polyphoniques.
@node Multiple staves
@subsection Multiple staves
-Comme nous l'avons vu dans @ref{Music expressions explained}, un
-fichier d'entrée LilyPond est fait d'expressions musicales. Si la
-partition commence par plusieurs expressions simultanées, LilyPond
-créera plusieurs portées. Cependant, il est plus facile de voir ce
-qu'il advient si l'on crée explicitement chacune des portées.
+Comme nous l'avons vu dans @ruser{Music expressions explained}, un fichier
+d'entrée LilyPond est fait d'expressions musicales. Si la partition
+commence par plusieurs expressions simultanées, LilyPond créera
+plusieurs portées. Cependant, il est plus facile de voir ce qu'il
+advient si l'on crée explicitement chacune des portées.
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 ensuite combinés en parallèle avec
- @code{<<} et @code{>>}, comme ceci :
+une portée est entrée en la faisant précéder de @code{\new Staff}. Ces
+éléments @code{Staff} sont ensuite combinés en parallèle avec @code{<<}
+et @code{>>}, comme ceci :
@lilypond[quote,ragged-right,verbatim]
\relative c'' {
@end lilypond
-La commande @code{\new} introduit un « contexte de notation ». Un
+La commande @code{\new} introduit un @qq{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
+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.
+spécifier explicitement les contextes. Cela assure que chaque fragment
+aura sa propre portée.
Il existe différents types de contextes. Les contextes @code{Staff}
(portée), @code{Voice} (voix) et @code{Score} (partition) gèrent la
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.
+comparaison, cela ressemble au signe @qq{moins} en mathématiques. La
+formule @math{(4+5)} est une expression, donc @math{-(4+5)} est une plus
+grosse expression.
-Les chiffres de mesure figurant sur une portée affectent toutes les
-autres portées ; en revanche l'armure d'une portée n'affectera
-@emph{pas} les autres portées.@footnote{Ce comportement peut être
-modifié si nécessaire : voir pour cela @ref{Changing defaults}.}.
+Les chiffres de métrique indiqués sur une portée affectent toutes les
+autres portées@footnote{Ce comportement peut être modifié si nécessaire,
+voir @ruser{Polymetric notation}.}. En revanche l'armure d'une portée
+n'affecte @emph{pas} les autres portées.
@lilypond[quote,ragged-right,verbatim]
\relative c'' {
@node Piano staves
@subsection Piano staves
-@cindex staff switch, manual
-@cindex cross staff voice, manual
-La musique pour piano s'écrit sur 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 de @ref{Multiple staves}, mais
-maintenant cette expression entière doit être interprétée dans un
-contexte @code{PianoStaff} :
+@cindex changement de portée manuel
+@cindex voix changeant manuellement de portée
+La musique pour piano s'écrit sur 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 de @ruser{Multiple staves}, mais maintenant cette expression
+entière doit être interprétée dans un contexte @code{PianoStaff} :
@example
\new PianoStaff <<
}
@end lilypond
-@moreinfo
+@seealso
@quotation
-Voir @ref{Piano music}.
+Voir @ruser{Piano music}.
@end quotation
+@node Combining notes into chords
+@subsection Combining notes into chords
+
+@cindex accords
+Des accords peuvent être produits en entourant les hauteurs de notes
+par des angles gauche et droit --- @samp{<} et @samp{>} ---
+
+@lilypond[quote,fragment,verbatim,relative=2,fragment]
+r4 <c e g>4 <c f a>2
+@end lilypond
+
+Vous pouvez combiner les indications comme les liaisons et les ligatures
+de croches avec les accords. Ils doivent cependant être placés en
+dehors des angles :
+
+@lilypond[quote,fragment,verbatim,relative=2,fragment]
+r4 <c e g>8[ <c f a>]~ <c f a>2
+@end lilypond
+
+@lilypond[quote,fragment,verbatim,relative=2,fragment]
+r4 <c e g>8\>( <c e g> <c e g>4 <c f a>\!)
+@end lilypond
+
+
@node Single staff polyphony
@subsection Single staff polyphony
-@cindex polyphony
-@cindex multiple voices
-@cindex voices, more -- on a staff
-Quand différentes lignes mélodiques sont combinées sur une seule et
-même portée, elles sont imprimées comme des voix polyphoniques ;
-chaque 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.
+@cindex polyphonie
+@cindex voix multiples sur une portée
+Quand différentes lignes mélodiques sont combinées sur une seule et même
+portée, elles sont imprimées comme des voix polyphoniques ; chaque 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.
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{\\} :
+en les séparant par @code{\\} :
@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
@end lilypond
Pour l'écriture de musique polyphonique, les silences invisibles
-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
-invisible (@code{s}) à la place d'un silence normal (@code{r}) :
+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 invisible
+(@code{s}) à la place d'un silence normal (@code{r}) :
@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
<<
>>
@end lilypond
-@moreinfo
+@seealso
@quotation
-Voir @ref{Basic polyphony}.
+Voir @ruser{Basic polyphony}.
@end quotation
-@node Combining notes into chords
-@subsection Combining notes into chords
-
-@cindex chords
-Des accords peuvent être produits en entourant les hauteurs de notes
-par des angles gauche et droit --- @samp{<} et @samp{>} ---
-
-@lilypond[quote,fragment,verbatim,relative=2,fragment]
-r4 <c e g>4 <c f a>2
-@end lilypond
-
-Vous pouvez combiner les indications comme les liaisons et les
-ligatures de croches avec les accords. Ils doivent cependant être
-placés en dehors des angles :
-
-
-@lilypond[quote,fragment,verbatim,relative=2,fragment]
-r4 <c e g>8[ <c f a>]~ <c f a>2
-@end lilypond
-
-@lilypond[quote,fragment,verbatim,relative=2,fragment]
-r4 <c e g>8\>( <c e g> <c e g>4 <c f a>\!)
-@end lilypond
-
-
@node Songs
@section Songs
@node Printing lyrics
@subsection Printing lyrics
-@cindex Lyrics
-@cindex Songs
+@cindex paroles
+@cindex chansons
Prenons une mélodie toute simple :
@lilypond[quote,ragged-right,verbatim]
}
@end lilypond
-Des paroles peuvent être associées à ces notes, en les combinant avec
-la commande @code{\addlyrics}. Les paroles sont entrées en séparant
-chaque syllable par un espace :
+Des paroles peuvent être associées à ces notes, en les combinant avec la
+commande @code{\addlyrics}. Les paroles sont entrées en séparant chaque
+syllable par un espace :
@lilypond[quote,ragged-right,verbatim]
<<
>>
@end lilypond
-@cindex melisma
-@cindex extender line
+@cindex mélisme
+@cindex ligne d'extension
Cette mélodie se termine sur un @rglos{melisma}, c'est-à-dire qu'une
-seule syllable (« free ») correspond à plus d'une note. Ceci est
+seule syllable (@qq{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 :
>>
@end lilypond
-@moreinfo
+@seealso
@quotation
-Plus de possibilités, 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 dans @ruser{Vocal music}.
@end quotation
@node A lead sheet
@subsection A lead sheet
-@cindex Lead sheets
-@cindex chords
-@cindex chord names
+@cindex partition de chanson
+@cindex chanson, partition complète
+@cindex accords, noms
+@cindex noms d'accords
-En 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 :
+En 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,ragged-right,verbatim]
\chordmode { c2 f4. g8 }
@end lilypond
-Maintenant, chaque hauteur est lue comme la base de l'accord à la
-place de la note. Ce mode est activé avec @code{\chordmode}.
-D'autres accords peuvent être créés en ajoutant des modifiacteurs
-après deux points. L'exemple suivant montre quelques modificateurs
-usuels :
+Maintenant, chaque hauteur est lue comme la base de l'accord à la place
+de la note. Ce mode est activé avec @code{\chordmode}. D'autres
+accords peuvent être créés en ajoutant des modificateurs après deux
+points. L'exemple suivant montre quelques modificateurs usuels :
@lilypond[quote,verbatim,ragged-right]
\chordmode { c2 f4:m g4:maj7 gis1:dim7 }
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é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 :
+syntaxe sera utilisée que dans le cas de@code{\chordmode}, mais le rendu
+des notes interviendra dans un contexte @code{ChordNames}, avec le
+résultat suivant :
@lilypond[quote,verbatim,ragged-right]
\chords { c2 f4.:m g4.:maj7 gis8:dim7 }
@end lilypond
-@cindex lead sheet
+@cindex partition de chanson
+@cindex chanson, partition complète
Une fois assemblés, les accords, paroles et mélodie forment une
partition de chanson :
@end lilypond
-@moreinfo
+@seealso
@quotation
-Une liste complète de modificateurs et d'autres options de mise en
-forme se trouve à la section @ref{Chords}.
+Une liste complète de modificateurs et d'autres options de mise en forme
+se trouve à la section @ruser{Chords}.
@end quotation
@node Final touches
@section Final touches
-L'ultime section de ce tutoriel montre comment ajouter la touche
-finale à des morceaux simples, et consititue une introduction au reste
-du manuel.
+L'ultime section de ce tutoriel montre comment ajouter une touche finale
+à des morceaux simples, et consititue une introduction au reste du
+manuel.
@menu
* Version number::
@node Version number
@subsection Version number
-@cindex versioning
+@cindex versions
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 2.11.20, ajoutez
+LilyPond pour laquelle le fichier a été écrit,
@example
-\version "2.11.20"
+\version "2.11.38"
@end example
@noindent
-tout en haut de votre fichier LilyPond.
+que l'on place par convention en début de 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.
+LilyPond. Les changements dans la syntaxe sont gérés avec un programme
+spécial, @file{convert-ly} --- voir @rprogram{Updating files with convert-ly}
+--- et il utilise @code{\version} pour déterminer les règles de
+conversion à appliquer au fichier.
@node Adding titles
@subsection Adding titles
-Les informations bibliographiques (nom du morceau, du compositeur,
-etc) sont entrées dans un bloc séparé, le bloc d'en-tête
-(@code{\header}), qui existe indépendamment des expressions musicales
-principales. Le bloc @code{\header} est habituellement placé en début
-de fichier.
+Les informations bibliographiques (nom du morceau, du compositeur, etc)
+sont entrées dans un bloc séparé, le bloc d'en-tête (@code{\header}),
+qui existe indépendamment des expressions musicales principales. Le
+bloc @code{\header} est habituellement placé en début de fichier.
@example
-\version "2.11.20"
+\version "2.11.38"
\header @{
title = "Symphonie"
composer = "Moi"
@dots{} music @dots{}
@}
@end example
-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}.
+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
+à @ruser{Creating titles}.
@node Absolute note names
@subsection Absolute note names
-Jusqu'ici nous n'avons utilisé que le mode @code{\relative} pour
-définir les hauteurs de notes. Si c'est effectivement le moyen le
-plus simple d'entrer la majeure partie de votre musique, il existe une
-autre façon de procéder : le mode de hauteurs absolues.
+Jusqu'ici nous n'avons utilisé que le mode @code{\relative} pour définir
+les hauteurs de notes. Si c'est effectivement le moyen le plus simple
+d'entrer la majeure partie de votre musique, il existe une autre façon
+de procéder : le mode des hauteurs absolues.
Si vous omettez la commande @code{\relative}, LilyPond considérera
toutes les hauteurs comme des hauteurs absolues. Un @code{c'} sera
-toujours un do du milieu, un @code{b} sera toujours une note
-au-dessous du précédent, et un @code{g,} sera toujours la note la plus
-grave dans la portée de clé de Fa.
+toujours un do du milieu, un @code{b} sera toujours une note au-dessous
+du précédent, et un @code{g,} sera toujours la note la plus grave dans
+la portée de clé de fa.
@lilypond[quote,verbatim,ragged-right]
{
}
@end lilypond
-Comme vous pouvez le voir, il faut beaucoup d'apostrophes pour écrire
-de la musique dans un registre aigu. Regardez cet extrait de Mozart :
+Comme vous pouvez le voir, il faut beaucoup d'apostrophes pour écrire de
+la musique dans un registre aigu. Regardez cet extrait de Mozart :
@lilypond[quote,verbatim,ragged-right]
{
@end lilypond
Toutes ces apostrophes rendent le fichier moins lisible, et c'est donc
-une source d'erreurs. En mode @code{\relative}, le même exemple
-devient bien plus facile à lire :
+une source d'erreurs. En mode @code{\relative}, le même exemple devient
+bien plus facile à lire :
@lilypond[quote,verbatim,ragged-right]
\relative c'' {
Si d'aventure vous faites une erreur d'octaviation, le mode
@code{\relative} la rendra frappante --- toutes les notes suivantes
-seront placées à la mauvaise octave. En mode de hauteurs absolues,
-une erreur isolée ne serait pas aussi visible, et donc aussi facile à
+seront placées à la mauvaise octave. En mode de hauteurs absolues, une
+erreur isolée ne serait pas auntant visible, et donc aussi facile à
dénicher.
-Cependant, le mode de hauteurs absolues reste utile pour les musiques
-où les intervalles sont étendus, surtout pour les fichiers LilyPond
-créés par ordinateur.
+Cependant, le mode de hauteurs absolues reste utile pour les musiques où
+les intervalles sont étendus, surtout pour les fichiers LilyPond créés
+par ordinateur.
@node Organizing pieces with identifiers
Lorsque l'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. Cet inconvénient peut être résolu par l'utilisation
+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. Cet
+inconvénient peut être résolu par l'utilisation
d'@emph{identificateurs}.
En utilisant ces identificateurs, que l'on pourrait aussi appeler
Le contenu de l'expression musicale @code{MusiqueToto} pourra être
utilisé plus loin en faisant précéder son nom d'un anti-slash,
-c'est-à-dire @code{\MusiqueToto}, juste comme n'importe quelle
-commande LilyPond. Tous les identificateurs doivent être définis
-@emph{avant} l'expression musicale principale.
+c'est-à-dire @code{\MusiqueToto}, juste comme n'importe quelle commande
+LilyPond. Tous les identificateurs doivent être définis @emph{avant}
+l'expression musicale principale.
@lilypond[quote,verbatim,ragged-right]
violin = \new Staff { \relative c'' {
@end example
En fonction de son contenu, un identificateur peut être utilisé à
-différents endroits. L'exemple suivant utilise la variable ci-dessus
-:
+différents endroits. L'exemple suivant utilise la variable ci-dessus :
@example
\paper @{
@node After the tutorial
@subsection After the tutorial
-Après avoir parcouru ce tutoriel, vous devriez vous essayer à écrire
-un morceau ou deux. Commencez par copier l'un des @ref{Templates}
-types 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{Templates}, lisez la section @ref{Extending the templates}.
-
-Après avoir écrit quelques pièces courtes, lisez les chapitres 3 à 5
-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 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.
+Après avoir parcouru ce tutoriel, vous devriez vous essayer à écrire un
+morceau ou deux. Commencez par copier l'un des @ruser{Templates} types 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 @ruser{Basic notation}. Si vous désirez écrire pour
+un ensemble instrumental non couvert par les @ruser{Templates}, lisez la
+section @ruser{Extending the templates}.
+
+Après avoir écrit quelques pièces courtes, lisez les chapitres 3 à 5 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
+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.
@node How to read the manual
@subsection How to read the manual
-Comme nous l'avons déjà vu dans @ref{How to read the tutorial}, de
-nombreux exemples du tutoriel n'ont pas fait apparaître le
+Comme nous l'avons déjà vu dans @ruser{How to read the tutorial}, de
+nombreux exemples du tutoriel n'ont pas fait apparaître
@code{\relative c'' @{ ... @}} dans l'extrait de code affiché.
-Dans le reste du manuel, les exemples utilisés sont encore beaucoup
-plus souples : parfois il leur manque le @code{\relative c'' @{ ...
-@}}, mais d'autres fois ils ont recours à une autre hauteur de
-référence, telle que @code{c'} ou @code{c,,}), et dans certains cas
-c'est même l'exemple entier qui est en mode de hauteurs absolues !
-Cependant, de telles ambiguïtés ne se trouvent que dans des contextes
-où les hauteurs n'ont que peu d'importance. Dans tous les exemples où
-elles en ont, le mode @code{\relative} ou absolu @code{@{ @}} est
-explicitement spécifié.
-
-Si vous ne vous y retrouvez toujours pas pour savoir quel code
-LilyPond produit précisément tel ou tel exemple, consultez la version
-HTML de ce manuel si ce n'est pas déjà le cas, et cliquez sur l'image
-de la partition. La source exacte utilisée pour générer ce manuel
-s'affichera alors.
+Dans le reste du manuel, les exemples utilisés sont encore beaucoup plus
+souples : parfois il leur manque le @code{\relative c'' @{ ... @}},
+mais d'autres fois ils ont recours à une autre hauteur de référence,
+telle que @code{c'} ou @code{c,,}), et dans certains cas c'est même
+l'exemple entier qui est en mode de hauteurs absolues ! Cependant, de
+telles ambiguïtés ne se trouvent que dans des contextes où les hauteurs
+n'ont que peu d'importance. Dans tous les exemples où elles en ont, le
+mode @code{\relative} ou absolu @code{@{ @}} est explicitement spécifié.
+
+Si vous ne vous y retrouvez toujours pas pour savoir quel code LilyPond
+produit précisément tel ou tel exemple, consultez la version HTML de ce
+manuel si ce n'est pas déjà le cas, et cliquez sur l'image de la
+partition. La source exacte utilisée pour générer ce manuel s'affichera
+alors.
+
+Pour en savoir plus sur l'organisation de la suite de ce manuel,
+reportez-vous à @ruser{About this manual}.