-@c -*- coding: utf-8; mode: texinfo; -*-
+@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
@c This file is part of lilypond.tely
@ignore
- Translation of GIT committish: a9d6b9a317e20cff479f9e0e54320dfae40bde31
+ 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
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 utilisé pour générer cette image.
-Essayez sur cette image :
+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
@example
@{
- c' e' g' e'
+ c' e' g' e'
@}
@end example
@c in this case we don't want verbatim
@lilypond[quote,ragged-right]
{
- c' e' g' e'
+ c' e' g' e'
}
@end lilypond
@samp{\include "italiano.ly"}
@c END DIV
-@emph{Attention :} tout extrait de code LilyPond doit être entouré
+@emph{Attention :} tout extrait de code LilyPond doit être entouré
d'une @{paire d'accolades@}. De plus, pour éviter toute ambiguïté, il
est préférable d'entourer les accolades par des espaces ou retours à
la ligne. Bien que certains exemples de ce manuel ne comportent pas
-d'accolades, ne les oubliez pas dans vos partitions !
+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.
+un code valide ; @code{ @{ C D E @} } produira un message d'erreur.
@sp 1
@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 >
+bureau, et traitez-le ensuite avec la commande du menu @samp{Compile >
Typeset File}. Le fichier PDF résultant sera alors affiché sur votre
écran.
Notez que le premier démarrage peut prendre une minute ou deux, car
toutes les polices système doivent être d'abord analysées.
-À l'avenir, vous aurez certainement recours aux commandes @qq{ Nouveau
-} ou @qq{ Ouvrir }. Vous devez enregistrer votre fichier avant de
-lancer la création de la partition. Si une erreur advient pendant le
-traitement, vous la trouverez dans la fenêtre @qq{ log }.
+À l'avenir, vous aurez certainement recours aux commandes @qq{Nouveau}
+ou @qq{Ouvrir}. Vous devez enregistrer votre fichier avant de lancer
+la création de la partition. Si une erreur advient pendant le
+traitement, vous la trouverez dans la fenêtre @qq{log}.
@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}
@verbatim
{
- c' e' g' e'
+ c' e' g' e'
}
@end verbatim
@noindent
-Pour traiter @file{test.ly}, procédez comme ceci :
+Pour traiter @file{test.ly}, procédez comme ceci :
@example
lilypond test.ly
@end example
@noindent
-Vous verrez quelque chose ressemblant à :
+Vous verrez quelque chose ressemblant à :
@example
lilypond 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
@lilypond[quote,ragged-right,verbatim]
{
- c' e' g' e'
+ c' e' g' e'
}
@end lilypond
@code{\relative}. Avec ce mode, l'@rglos{interval} entre la note et
celle qui la précède est supposé inférieur ou égal à une
@rglos{fourth}. Commençons par entrer la partition la plus
-élémentaire qui soit, une (@rglos{scale}).
+élémentaire qui soit, une @rglos{scale}.
@lilypond[quote,ragged-right,verbatim]
\relative c' {
- c d e f
- g a b c
+ c d e f
+ g a b c
}
@end lilypond
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 dit "du milieu", entre la clé de Sol et
-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
-:
+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 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]
\relative c' {
- d f a g
- c b f d
+ d f a g
+ c b f d
}
@end lilypond
@noindent
Comme vous l'aurez remarqué, cet exemple ne commence plus sur le do du
-milieu. La première note --le @samp{d} -- est le Ré qui en est le
+milieu. La première note --- le @samp{d} --- est le ré qui en est le
plus proche.
Pour ajouter des intervalles supérieurs à une quarte, il suffit
@lilypond[quote,ragged-right,verbatim]
\relative c'' {
- a a, c' f,
- g g'' a,, f'
+ a a, c' f,
+ g g'' a,, f'
}
@end lilypond
@noindent
-Pour envoyer une note deux octaves (ou davantage !) plus haut ou plus
-bas, il suffit de mettre plusieurs @code{''} ou plusieurs @code{,,} --
+Pour déplacer une note deux octaves (ou davantage !) plus haut ou plus
+bas, il suffit de mettre plusieurs @code{''} ou plusieurs @code{,,} ---
attention cependant à bien mettre deux apostrophes @code{''}, et non
-deux guillemets @code{"}@tie{} ! C'est de cette même manière que l'on
+un guillemet @code{"}@tie{}! C'est de cette même manière que l'on
peut modifier la valeur de départ de @code{\relative c'}.
@subheading Durations (rhythms)
La @rglos{duration} d'une note est indiquée par un nombre
-qui suit son nom : @samp{1} pour une (@rglos{whole
-note}), @samp{2} pour une (@rglos{half note}), @samp{4} pour
-une (@rglos{quarter note}) et ainsi de suite. Les hampes sont
+qui suit son nom : @samp{1} pour une @rglos{whole
+note}, @samp{2} pour une @rglos{half note}, @samp{4} pour
+une @rglos{quarter note} et ainsi de suite. Les hampes sont
ajoutées automatiquement.
@lilypond[quote,ragged-right,verbatim]
\relative c'' {
- a1
- a2 a4 a8 a
- a16 a a a a32 a a a a64 a a a a a a a a2
+ a1
+ a2 a4 a8 a
+ a16 a a a a32 a a a a64 a a a a a a a a2
}
@end lilypond
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]
\relative c'' {
- a a a4. a8
- a8. a16 a a8. a8 a4.
+ a a a4. a8
+ a8. a16 a a8. a8 a4.
}
@end lilypond
@subheading Rests
-On saisit un (@rglos{rest}) tout comme une note, mais avec le
+On saisit un @rglos{rest} tout comme une note, mais avec le
caractère @samp{r}.
@lilypond[quote,ragged-right,verbatim]
\relative c'' {
- a r r2
- r8 a r4 r4. r8
+ a r r2
+ r8 a r4 r4. r8
}
@end lilypond
@subheading Time signature
-Le @rglos{time signature}) peut être défini à l'aide de la commande
-@code{\time} :
+La @rglos{time signature} peut être définie à l'aide de la commande
+@code{\time} :
@lilypond[quote,ragged-right,verbatim]
\relative c'' {
- \time 3/4
- a4 a a
- \time 6/8
- a4. a
- \time 4/4
- a4 a a a
+ \time 3/4
+ a4 a a
+ \time 6/8
+ a4. a
+ \time 4/4
+ a4 a a a
}
@end lilypond
@subheading Clef
-La @rglos{clef} peut être définie à l'aide de la commande @code{\clef} :
+La @rglos{clef} peut être définie à l'aide de la commande @code{\clef} :
@lilypond[quote,ragged-right,verbatim]
\relative c' {
- \clef treble
- c1
- \clef alto
- c1
- \clef tenor
- c1
- \clef bass
- c1
+ \clef treble
+ c1
+ \clef alto
+ c1
+ \clef tenor
+ c1
+ \clef bass
+ c1
}
@end lilypond
@subheading All together
-Voici un bref exemple qui montre tous ces éléments ensemble :
+Voici un bref exemple qui montre tous ces éléments ensemble :
@lilypond[quote,ragged-right,verbatim]
\relative c, {
- \time 3/4
- \clef bass
- c2 e8 c' g'2.
- f4 e d c4 c, r4
+ \time 3/4
+ \clef bass
+ c2 e8 c' g'2.
+ f4 e d c4 c, r4
}
@end lilypond
-@moreinfo
+@seealso
@quotation
@table @asis
@item Entrer des hauteurs et des durées
-see @ref{Pitches} and @ref{Durations}.
+voir @ruser{Pitches} and @ruser{Durations}.
@item Les silences
-see @ref{Rests}.
+voir @ruser{Rests}.
@item Les chiffres de mesure et autres commandes de métrique
-see @ref{Time signature}.
+voir @ruser{Time signature}.
@item Les clés
-see @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 :
+Si cette phrase vous paraît incompréhensible, ne vous en faites pas !
+Tous ces termes vont être expliqués :
@itemize
-@cindex Case sensitive
-@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.
+@cindex casse, prise en compte de
+@item @strong{La casse} :
+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} :
+@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
@noindent
Bien sûr, ce dernier exemple est difficile à lire. Une bonne habitude
à prendre est d'indenter les blocs de code avec soit des tabulations
-soit des doubles espaces :
+soit des doubles espaces :
@example
@{
- c d e
+ c d e
@}
@end example
-@item @strong{Expressions musicales :}
-Tout morceau saisi dans LilyPond nécessite d'ê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
+@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
parenthèses @samp{()} en mathématiques. Il est préférable, pour
é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
-@item @strong{Les commentaires} :
+@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
+fichier de musique ; il est ignoré par l'ordinateur, et n'a donc aucun
effet sur la partition imprimée. On distingue deux types de
-commentaires :
+commentaires :
@itemize @bullet
-@item la ligne de commentaire, introduite par le symbole @samp{%} :
+@item la ligne de commentaire, introduite par le symbole @samp{%} :
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é.
+de toute une section : tout ce qui se trouve entre @code{%@{} et
+@code{%@}} est ignoré. Les blocs de commentaires ne peuvent s'imbriquer.
@end itemize
-Le fragment suivant met en évidence quelques usages possibles des commentaires :
+Le fragment suivant met en évidence quelques usages possibles des commentaires :
@example
% voici les notes de "ah vous dirai-je maman"
@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.
cliquer sur l'image. Si vous ne disposez pas de la version HTML, il
vous est possible de simplement copier et coller le code affiché, mais
@strong{à condition} d'ajouter @code{\relative c'' @{ @}} de la façon
-suivante :
+suivante :
@example
\relative c'' @{
@}
@end example
-Pourquoi avoir omis les accolades ? La plupart des exemples de ce
+Pourquoi avoir omis les accolades ? La plupart des exemples de ce
manuel peuvent être insérés au milieu d'un morceau de musique plus
long. Il n'y a donc aucune raison d'ajouter @code{\relative c'' @{
-@}} à ces exemples -- en effet, il n'est pas possible d'insérer un
+@}} à ces exemples --- en effet, il n'est pas possible d'insérer un
@code{\relative} à l'intérieur d'un autre @code{\relative}. Il vous
serait donc devenu impossible de copier un bref exemple de la
-documentation et de le coller dans une pièce de votre crû.
+documentation et de le coller dans une pièce de votre cru.
@node Single staff notation
@section Single staff notation
@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
--- en d'autres termes,une quarte augmentée n'est @emph{pas}
+--- en d'autres termes, une quarte augmentée n'est @emph{pas}
équivalente à une quinte diminuée. Ainsi, si l'on part d'un Do, un Fa
dièse sera placé au-dessus, tandis qu'un Sol bémol sera placé
au-dessous.
c2 ges
@end lilypond
-@moreinfo
+@seealso
@quotation
@table @asis
-@item Les Octaves Relatives
-see @ref{Relative octaves}.
+@item Les hauteurs de note relatives
+voir @ruser{Relative octaves}.
@item Les vérifications d'octaves
-see @ref{Octave check}.
+voir @ruser{Octave check}.
@end table
@end quotation
@subheading Accidentals
-Dans la notation par défaut,un dièse (@rglos{sharp}) s'obtient en
-ajoutant @samp{is} au nom de la
-note, et un bémol (@rglos{flat}) en ajoutant @samp{es}. Comme vous pouvez
-vous y attendre, un double dièse ou double bémol est alors 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.}.
+Dans la notation par défaut, un @rglos{sharp} s'obtient en ajoutant
+@samp{is} au nom de la note, et un @rglos{flat} en ajoutant @samp{es}.
+Comme vous pouvez vous y attendre, un double dièse ou double bémol est
+alors 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
Cependant, si vous utilisez la commande @samp{\include "italiano.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
+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
-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
-hauteur puis de @code{\major} (majeur) ou @code{\minor} (mineur) :
+hauteur puis de @code{\major} (majeur) ou @code{\minor} (mineur) :
@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
\key d \major
@subheading Warning: key signatures and pitches
-La combinaison de l'armure et des hauteurs de note -- y compris les
-altérations -- permet à LilyPond de déterminer dans quel cas afficher les
-altérations accidentelles. L'armure n'affecte que les altérations
-@emph{imprimées}, et non les hauteurs réelles ! Cette fonctionnalité
-est souvent source de
-confusion pour les nouveaux utilisateurs, aussi expliquons-la en
-détail.
+La combinaison de l'armure et des hauteurs de note --- y compris les
+altérations --- permet à LilyPond de déterminer dans quel cas afficher
+les altérations accidentelles. L'armure n'affecte que les altérations
+@emph{imprimées}, et non les hauteurs réelles ! 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 relève donc du contenu musical. La
-présence ou non
-d'une altération accidentelle -- un @emph{signe} bémol, bécarre ou
-dièse -- devant la note correspondante est une question qui relève de la mise en
-page. Mettre en page une partition se fait selon des règles ; les
-altérations accidentelles seront donc automatiquement imprimées suivant
-ces règles. Les hauteurs de note, en revanche, relèvent de ce que
-vous voulez entendre ; et, dans la mesure où la musique que vous
-entrez est censée être celle que vous voulez entendre, LilyPond (qui
-n'est chargé que de la gravure) ne les choisira pas à votre place.
+mise en forme. L'altération d'une note --- bémol, bécarre ou dièse
+--- fait partie de sa hauteur, et relève donc du contenu musical. La
+présence ou non d'une altération accidentelle --- un @emph{signe}
+bémol, bécarre ou dièse --- devant la note correspondante est une
+question qui relève de la mise en page. Mettre en page une partition
+se fait selon des règles ; les altérations accidentelles seront donc
+automatiquement imprimées suivant ces règles. Les hauteurs de note,
+en revanche, relèvent de ce que vous voulez entendre ; et, dans la
+mesure où la musique que vous entrez est censée être celle que vous
+voulez entendre, LilyPond (qui n'est chargé que de la gravure) ne les
+choisira pas à votre place.
Dans cet exemple,
@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
-en-dessous de la portée.} Cela signifie plutôt : @qq{Ici se trouve
+en-dessous de la portée.} Cela signifie plutôt : @qq{Ici se trouve
une note dont la
hauteur est un ré naturel.} Avec l'armure de la bémol majeur, ce ré
sera flanqué
-d'un bécarre accidentel :
+d'un bécarre accidentel :
@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
\key aes \major
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
-see @ref{Accidentals} and @ref{Automatic accidentals}.
+voir @ruser{Accidentals} and @ruser{Automatic accidentals}.
@item Les armures
-see @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 Le terme de "slur" a deux sens en français : articulation et phrasé.
@c Je garde ici le terme "legato", tel qu'il apparaît dans le texte original,
@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
-@subheading Warnings: slurs vs. 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
tenue, mais n'a pas la même signification. Alors qu'une liaison de
c2~( c8 fis fis4 ~ fis2 g2)
@end lilypond
-@moreinfo
+@seealso
@quotation
@table @asis
-@item Liaisons de prolongation
-see @ref{Ties}.
-@item Legato
-see @ref{Slurs}.
-@item Liaisons de phrasé
-see @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
-d'un tiret @samp{-} suivi d'un caractère :
+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-_
+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 :
+utilisant un tiret (@samp{-}) et le chiffre à écrire :
@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
c-3 e-5 b-2 a-1
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_-^1 d^. f^4_2-> e^-_+
@end lilypond
@subheading Dynamics
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[quote,ragged-right,verbatim,fragment,relative=2]
c\ff c\mf c\p c\pp
@end lilypond
-@cindex dynamics
+@cindex nuances
@cindex decrescendo
@cindex crescendo
-@c Pluriel des termes musicaux italiens :
+@c Pluriel des termes musicaux italiens :
@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{\!} :
+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{\!} :
@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
-c2\< c2\ff\> c2 c2\!
+c2\< c2\ff\> c2 c2\!
@end lilypond
-@moreinfo
+@seealso
@quotation
@table @asis
-@item Ponctuations
-see @ref{Articulations}.
-@item Doigtés
-see @ref{Fingering instructions}.
-@item Nuances
-see @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
-see @ref{Automatic beams}.
+voir @ruser{Automatic beams}.
@item Groupements et ligatures manuels
-see @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.
+@code{\partial}, suivie d'une durée : @code{\partial 4} est une levée
+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 n-olets 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 :
+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 { f8 g a }
\times 2/3 { c r c }
-\times 2/3 { f,8 g16 a g a }
+\times 2/3 { f,8 g16[ a g a] }
\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é
-@code{\appoggiatura} ou @code{\acciaccatura} :
+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 \grace { a32[ b] } c2
c2 \acciaccatura b16 c2
@end lilypond
-@moreinfo
+@seealso
@quotation
@table @asis
@item Notes d'ornement
-see @ref{Grace notes},
-@item N-olets
-see @ref{Tuplets},
-@item Levées
-see @ref{Partial measures}.
+voir @ruser{Grace notes},
+@item nolets
+voir @ruser{Tuplets},
+@item levées
+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
+constituée de plusieurs voix ; dans lilypond, ce terme désigne les
situations où il y a plus d'une voix sur une même portée.
@menu
* 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
@end lilypond
Mettre un groupe de notes entre accolades crée une nouvelle expression
-musicale :
+musicale :
@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
{ a4 g4 }
@end lilypond
-Placer une séquence d'expressions musicales -- des notes par exemple
--- entre accolades signifie qu'elles doivent être jouées
+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 :
+combinée à deux notes :
@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
{ { a4 g } f g }
@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.
+entourant les expressions entre @code{<<} et @code{>>}. Dans l'exemple
+suivant, trois expressions (contenant chacune deux notes distinctes)
+sont combinées simultanément.
@lilypond[quote,ragged-right,verbatim]
\relative c'' {
- <<
- { a4 g }
- { f e }
- { d b }
- >>
+ <<
+ { a4 g }
+ { f e }
+ { d b }
+ >>
}
@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,
+@strong{Attention} : chaque note saisie est relative à la précédente,
mais pas au @code{c''} de la commande @code{\relative} de départ.
Pour déterminer le nombre de portées, LilyPond regarde le premier
élément autre qu'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 ; si c'est une expression simultanée, il y aura plus d'une
portée.
@lilypond[quote,ragged-right,verbatim]
\relative c'' {
- c2 <<c e>>
- << { e f } { c <<b d>> } >>
+ c2 <<c e>>
+ << { e f } { c <<b d>> } >>
}
@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
+Ce mécanisme est similaire au formules mathématiques : une grosse
formule 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 des expressions arbitrairement
@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'' {
- <<
- \new Staff { \clef treble c }
- \new Staff { \clef bass c,, }
- >>
+ <<
+ \new Staff { \clef treble c }
+ \new Staff { \clef bass 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
+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.
+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'' {
- <<
- \new Staff { \clef treble \time 3/4 c }
- \new Staff { \clef bass \key d \major c,, }
- >>
+ <<
+ \new Staff { \clef treble \time 3/4 c }
+ \new Staff { \clef bass \key d \major c,, }
+ >>
}
@end lilypond
@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 <<
- \new Staff @dots{}
- \new Staff @dots{}
->>
+\new PianoStaff <<
+ \new Staff @dots{}
+ \new Staff @dots{}
+>>
@end example
-Voici un bref exemple :
+Voici un bref exemple :
@lilypond[quote,ragged-right,verbatim]
\relative c'' {
- \new PianoStaff <<
- \new Staff { \time 2/4 c4 e g g, }
- \new Staff { \clef bass c,, c' e c }
- >>
+ \new PianoStaff <<
+ \new Staff { \time 2/4 c4 e g g, }
+ \new Staff { \clef bass c,, c' e c }
+ >>
}
@end lilypond
-@moreinfo
+@seealso
@quotation
-See @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]
-<<
- { a4 g2 f4~ f4 } \\
- { r4 g4 f2 f4 }
->>
+<<
+ { a4 g2 f4~ f4 } \\
+ { r4 g4 f2 f4 }
+>>
@end lilypond
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}) :
+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]
-<<
- { a4 g2 f4~ f4 } \\
- { s4 g4 f2 f4 }
->>
+<<
+ { a4 g2 f4~ f4 } \\
+ { s4 g4 f2 f4 }
+>>
@end lilypond
@noindent
-Là encore, ces expressions peuvent s'imbriquer arbitrairement :
+Là encore, ces expressions peuvent s'imbriquer arbitrairement :
@lilypond[quote,fragment,verbatim,relative=2,fragment]
-<<
- \new Staff <<
- { a4 g2 f4~ f4 } \\
- { s4 g4 f2 f4 }
- >>
- \new Staff <<
- \clef bass
- { <c g>1 ~ <c g>4 } \\
- { e,,4 d e2 ~ e4}
- >>
->>
+<<
+ \new Staff <<
+ { a4 g2 f4~ f4 } \\
+ { s4 g4 f2 f4 }
+ >>
+ \new Staff <<
+ \clef bass
+ { <c g>1 ~ <c g>4 } \\
+ { e,,4 d e2 ~ e4}
+ >>
+>>
@end lilypond
-@moreinfo
+@seealso
@quotation
-See @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
-Cette section présente l'écriture vocale, et les partitions de variété.
+Cette section présente l'écriture vocale et les partitions de variété.
@menu
* Printing lyrics::
@node Printing lyrics
@subsection Printing lyrics
-@cindex Lyrics
-@cindex Songs
-Prenons une mélodie toute simple :
+@cindex paroles
+@cindex chansons
+Prenons une mélodie toute simple :
@lilypond[quote,ragged-right,verbatim]
\relative c'' {
- a4 e c8 e r4
- b2 c4( d)
+ a4 e c8 e r4
+ b2 c4( d)
}
@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]
-<<
- \relative c'' {
- a4 e c8 e r4
- b2 c4( d)
- }
- \addlyrics { One day this shall be free }
->>
+<<
+ \relative c'' {
+ a4 e c8 e r4
+ b2 c4( d)
+ }
+ \addlyrics { One day this shall be free }
+>>
@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 :
+caractères souligné (@code{_}), c'est-à-dire :
@lilypond[quote,ragged-right,verbatim]
-<<
- \relative c'' {
- a4 e c8 e r4
- b2 c4( d)
- }
- \addlyrics { One day this shall be free __ }
->>
+<<
+ \relative c'' {
+ a4 e c8 e r4
+ b2 c4( d)
+ }
+ \addlyrics { One day this shall be free __ }
+>>
@end lilypond
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 :
+entre les deux syllabes :
@c no ragged-right here because otherwise the hypens get lost.
@lilypond[quote,verbatim]
-<<
- \relative c' {
- \time 2/4
- f4 f c c
- }
- \addlyrics { A -- le -- gri -- a }
->>
+<<
+ \relative c' {
+ \time 2/4
+ f4 f c c
+ }
+ \addlyrics { A -- le -- gri -- a }
+>>
@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 }
+\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 }
@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é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 :
+partition de chanson :
@lilypond[quote,verbatim,ragged-right]
-<<
- \chords { c2 g:sus4 f e }
- \relative c'' {
- a4 e c8 e r4
- b2 c4( d)
- }
- \addlyrics { One day this shall be free __ }
->>
+<<
+ \chords { c2 g:sus4 f e }
+ \relative c'' {
+ a4 e c8 e r4
+ b2 c4( d)
+ }
+ \addlyrics { One day this shall be free __ }
+>>
@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
-Voici l'ultime section de ce tutoriel, qui montre comment ajouter la
-touche finale à des morceaux simples, et sert d'introduction pour le
-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.10.0, ajoutez
+LilyPond pour laquelle le fichier a été écrit,
@example
-\version "2.10.1"
+\version @w{"@version{}"}
@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.10.1"
+\version "2.11.38"
\header @{
- title = "Symphony"
- composer = "Me"
- opus = "Op. 9"
+ title = "Symphonie"
+ composer = "Moi"
+ opus = "Op. 9"
@}
@{
@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]
{
- \clef bass
- c' b g, g,
- g, f, f c'
+ \clef bass
+ c' b g, g,
+ g, f, f c'
}
@end lilypond
-Voici une gamme sur 4 octaves :
+Voici une gamme sur 4 octaves :
@lilypond[quote,verbatim,ragged-right]
{
- \clef bass
- c, d, e, f,
- g, a, b, c
- d e f g
- a b c' d'
- \clef treble
- e' f' g' a'
- b' c'' d'' e''
- f'' g'' a'' b''
- c'''1
+ \clef bass
+ c, d, e, f,
+ g, a, b, c
+ d e f g
+ a b c' d'
+ \clef treble
+ e' f' g' a'
+ b' c'' d'' e''
+ f'' g'' a'' b''
+ c'''1
}
@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]
{
- \key a \major
- \time 6/8
- cis''8. d''16 cis''8 e''4 e''8
- b'8. cis''16 b'8 d''4 d''8
+ \key a \major
+ \time 6/8
+ cis''8. d''16 cis''8 e''4 e''8
+ b'8. cis''16 b'8 d''4 d''8
}
@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'' {
- \key a \major
- \time 6/8
- cis8. d16 cis8 e4 e8
- b8. cis16 b8 d4 d8
+ \key a \major
+ \time 6/8
+ cis8. d16 cis8 e4 e8
+ b8. cis16 b8 d4 d8
}
@end lilypond
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 à
+@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 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
variables ou macros, il est possible de découper des expressions
-musicales complexes. Un identificateur se définit comme suit :
+musicales complexes. Un identificateur se définit comme suit :
@example
MusiqueToto = @{ @dots{} @}
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'' {
- a4 b c b
+ a4 b c b
}}
cello = \new Staff { \relative c {
- \clef bass
- e2 d
+ \clef bass
+ e2 d
}}
{
- <<
- \violin
- \cello
- >>
+ <<
+ \violin
+ \cello
+ >>
}
@end lilypond
@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 @{
- \aFivePaper
- line-width = \width
+ \aFivePaper
+ line-width = \width
@}
@{ c4^\name @}
@end example
@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 modèles types
-(@ref{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 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}.
projects / lilypond.git / blobdiff