@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
@c This file is part of lilypond.tely
@ignore
- Translation of GIT committish: 64f0d86a7c0987b311bfdfdfeddfa063e1f2d6e7
+ Translation of GIT committish: f413550b658b43fbea690fc060f872bce6bbc885
- When revising a translation, copy the HEAD committish of the
- version that you are working on. See TRANSLATION for details.
+ When revising a translation, copy the HEAD committish of the
+ version that you are working on. See TRANSLATION for details.
@end ignore
-@c TODO:
-@c * more details about running lilypond; error messages,
-@c compiling/viewing (emacs?)
-@c * where to go from First steps+More basics?
+@c \version "2.12.0"
-@c wherever possible, do not include index entries here; the
-@c index should point to stuff in the reference manual. -gp
+@ignore
+Tutorial guidelines: (different from policy.txt!)
+- unless you have a really good reason, use either
+ @lilypond[verbatim,quote]
+ or
+ @lilypond[verbatim,quote,relative=2]
+
+ Don't use any other relative=X commands.
+
+- use "aes" and "ees" instead of "as" and "es". I know it's not
+ correct Dutch naming, but let's not confuse people with this
+ until we get to the Basic notation chapter.
+
+- Add "Music Glossary: @rglos{foo}" to the *top* of the relevant
+ portions of the tutorial.
+
+@end ignore
-@c Your first LilyPond score in 10 minutes?
-@node Tutorial
+@c Translators: Nicolas Grandclaude, Ludovic Sardain, Gauvain Pocentek
+@c Translation checkers: Jean-Charles Malahieude, Valentin Villenave, John Mandereau
+@c Translation status: post-GDP
+
+@node Tutorial
@chapter Tutorial
Ce tutoriel commence par une introduction au langage musical utilisé
par LilyPond, qui vous permettra de faire fonctionner le logiciel pour
-prosuire une partition. Après ce premier contact, nous verrons comment
+produire une partition. Après ce premier contact, nous verrons comment
créer des partitions utilisant une notation musicale courante.
-@ifhtml
-Beaucoup de gens apprennent à utiliser les programmes en les essayant
-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
+@menu
+* First steps::
+* Single staff notation::
+* Multiple notes at once::
+* Songs::
+* Final touches::
+@end menu
-@lilypond[fragment,quote,ragged-right,relative=2]
-c-\markup { \bold \huge { Click here. } }
-@end lilypond
-@end ifhtml
-En copiant et en collant l'intégralité du code dans un fichier test,
-vous aurez un modèle comme base pour expérimenter. Si vous
-apprenez de cette façon, vous aurez probablement envie d'imprimer ou
-de créer un lien vers
-@ifhtml
-la
-@end ifhtml
-@ref{Cheat sheet}, tableau qui répertorie les commandes usuelles
-pour une consultation rapide.
+@node First steps
+@section First steps
+
+Cette section présente les aspects élémentaires de l'utilisation de
+LilyPond.
@menu
-* First steps::
-* Second steps::
-* More about pitches::
-* Entering ties::
-* Automatic and manual beams::
-* Octave entry::
-* Music expressions explained::
-* More staves::
-* Adding articulation marks to notes::
-* Combining notes into chords::
-* Advanced rhythmic commands::
-* Commenting input files::
-* Printing lyrics::
-* A lead sheet::
-* Adding titles::
-* Single staff polyphony::
-* Piano staves::
-* Organizing larger pieces::
-* An orchestral part::
-* After the tutorial::
+* Compiling a file::
+* Simple notation::
+* Working on input files::
+* How to read the manual::
@end menu
-@node First steps
-@section First steps
+@node Compiling a file
+@subsection Compiling a file
+
+@cindex compilation
+@cindex exemple, premier
+@cindex premier exemple
-Le premier exemple montre comment écrire la partition la plus
-élémentaire qui soit, une gamme (@rglos{scale}). Une @rglos{note} peut
-être entrée en tapant son nom, de @samp{a} à @samp{g}. Donc si vous
-entrez
+Pour créer une partition avec LilyPond, on écrit un fichier texte,
+appelé fichier source, qui décrit la notation musicale. La
+@emph{compilation} de ce fichier source par LilyPond produit un
+fichier graphique imprimable, et si on le désire un fichier MIDI qui
+peut être joué par un séquenceur.
+
+Voici un premier exemple simple de fichier source LilyPond.
@example
@{
-c' d' e' f' g' a' b' c''
+ c' e' g' e'
@}
@end example
@noindent
-le résultat ressemblera à
+La compilation de ce fichier donnera quelque chose de sembable à
+l'image ci-dessous.
+@c in this case we don't want verbatim
@lilypond[quote]
{
-c' d' e' f' g' a' b' c''
+ c' e' g' e'
}
@end lilypond
@c DIV specific
Il est aussi possible d'utiliser les noms de notes français @samp{do
re mi fa sol la si}, en insérant au début du fichier la ligne
-@samp{\include "catalan.ly"}
+@samp{\include "italiano.ly"}.
@c END DIV
-@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 !
+@warning{Tout extrait de code LilyPond doit être entouré d'une
+@strong{@{ 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 !
+Pour plus d'informations sur l'affichage des exemples de cette
+documentation, consultez @ref{How to read the manual}.}
+
+
+@cindex casse, prise en compte de la
+@cindex prise en compte de la casse
+@cindex sensibilité à la casse
+
+De plus, LilyPond est @strong{sensible à la casse} : le code
+@w{@code{@{ c d e @}}} est valide, alors que @w{@code{@{ C D E @}}}
+produira un message d'erreur.
-@cindex Case sensitive
-De plus, LilyPond est sensible à la casse. @code{ @{ c d e @} } est
-un code valide ; @code{ @{ C D E @} } produira un message d'erreur.
+@smallspace
-@unnumberedsubsec Entering music and viewing output
+@subheading Entering music and viewing output
+
+@cindex fichier PDF
+@cindex PDF
+@cindex partition, lire
+@cindex lire la partition
+@cindex éditeurs de texte
+@cindex LilyPond et MacOS X
+@cindex MacOS X et LilyPond
+@cindex LilyPond et Windows
+@cindex Windows et LilyPond
+@cindex LilyPond et Unix
+@cindex Unix et LilyPond
Dans cette section nous expliquerons quelles commandes exécuter et
-comment voir ou imprimer le résultat de LilyPond.
+comment voir ou imprimer le résultat produit par LilyPond.
-@unnumberedsubsubsec MacOS X
+Notez qu'il existe plusieurs éditeurs de texte disponibles avec un bon
+support de LilyPond ; consultez @rprogram{Text editor support}.
-Si vous double-cliquez sur LilyPond.app, un fichier d'exemple sera
-ouvert. Sauvegardez-le, par exemple, sous @file{test.ly} sur votre
-bureau, et traitez-le ensuite avec la commande du menu @samp{Compile >
-Typeset File}. Le fichier PDF résultant est alors affiché sur votre
-écran.
+@warning{Le premier démarrage de LilyPond peut prendre une minute ou
+deux, afin de générer la liste des polices du système. LilyPond démarre
+en principe plus rapidement lors des exécutions suivantes.}
-Pour l'utilisation future de LilyPond, vous commencerez certainement
-en sélectionnant « Nouveau » ou « Ouvrir ».
-Notez que le premier démarrage peut prendre une minute ou deux, car
-toutes les polices systèmes doivent être d'abord analysées.
+@subsubheading MacOS X
-@unnumberedsubsubsec Windows
+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, puis traitez-le avec la commande de menu @samp{Compile >
+Typeset File}. Le fichier PDF résultant sera alors affiché à l'écran.
-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 Notepad. N'utilisez
-pas de traitement de texte car ceux-ci insèrent des codes de formatage
-qui posent problème à LilyPond.} et saisissez
+À l'avenir, vous aurez certainement recours aux commandes @qq{Nouveau}
+ou @qq{Ouvrir}. Vous devez enregistrer votre fichier avant de lancer
+la gravure de la partition par LilyPond. Si une erreur apparaît
+pendant le traitement, vous la trouverez dans la fenêtre @qq{log}.
-@verbatim
-{ c' e' g' c'' }
-@end verbatim
+@subsubheading Windows
+
+Sous Windows, 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 le 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 le bureau, fichier que vous pourrez ouvrir pour
+voir la partition gravé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.
-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}. 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 survient, vous en
+trouverez les détails dans ce fichier.
-@unnumberedsubsubsec Unix
+@subsubheading UNIX
-Commencez par ouvrir une fenêtre de terminal et un éditeur de
-texte. Par exemple, vous pouvez ouvrir un xterm et exécuter
-@code{joe}. @footnote{Des fichiers de macros pour les fans de VIM et un
-@code{LilyPond-mode} pour les fans d'Emacs existent. S'ils ne sont pas
-encore installés, consultez le fichier @file{INSTALL.txt}.} Dans votre
-éditeur, entrez le texte suivant et sauvegardez le fichier sous
-@file{test.ly}
+Créez un fichier texte @file{test.ly} qui contient
@verbatim
-{ c' e' g' c'' }
+{
+ c' e' g' e'
+}
@end verbatim
@noindent
-Pour traiter @file{test.ly}, procédez comme ceci :
+Pour traiter @file{test.ly}, entrez la commande suivante dans un
+terminal :
@example
lilypond test.ly
@end example
@noindent
-Vous verrez quelque chose ressemblant à :
+Vous verrez quelque chose ressemblant à
@example
lilypond test.ly
-GNU LilyPond 2.10.0
-Processing `test.ly'
-Parsing...
-Interpreting music... [1]
-Preprocessing graphical objects...
-Calculating line breaks... [2]
-Layout output to `test.ps'...
-Converting to `test.pdf'...
+GNU LilyPond @version{}
+Traitement de « test.ly »
+Analyse...
+Interprétation en cours de la musique...
+Pré-traitement des éléments graphiques...
+Détermination du nombre optimal de pages...
+Répartition de la musique sur une page...
+Dessin des systèmes...
+Sortie mise en page vers « test.ps »...
+Conversion à « ./test.pdf »...
@end example
@c DIV specific
-Suivant votre installation, les messages peuvent être traduits.
+@noindent
+Suivant votre installation, ces messages peuvent être traduits ou
+non.
@c END DIV
-@cindex PDF file
-@cindex Viewing music
-@noindent
-Le résultat est le fichier @file{test.pdf}, que vous pouvez imprimer
-ou visualiser avec les outils standards de votre système
-d'exploitation. @footnote{Si votre système ne dispose pas des outils
-nécessaires, vous pouvez essayer
-@uref{http://@/www@/.cs@/.wisc@/.edu/@/~ghost/,Ghostscript}, un
-programme pour voir et imprimer les fichiers PDF et PostScript.}
-
-
-@node Second steps
-@section Second steps
-
-@emph{N'oubliez pas :} tout extrait de musique source LilyPond doit
-être entouré d'@{accolades@}. 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 !
-
-@c will be removed once the tutorial either explains \relative or
-@c examples are fixed so they don't use it. -gp
-De plus, de nombreux exemples utilisent le mode @code{relative}. Ceci
-est expliqué à la section @ref{Octave entry} ; sachez dès à présent
-que certains exemples devraient être libellés sous la forme
-@code{\relative @{ @emph{...musique...} @}}.
-De nombreux exemples ont aussi été compressés horizontalement pour
-économiser de la place, grace à la commande
-@code{\paper @{ragged-right = ##t @}}.
-
-@cindex Case sensitive
-Enfin, LilyPond est sensible à la casse. @code{ @{ c d e @} } est
-un code valide ; @code{ @{ C D E @} } produira un message d'erreur.
-
-@c End of latest re-write. Since I have no life, I may do more
-@c work on this, but I'd really like to have a Doc Helper take
-@c over this task. -gp
-
-La durée (@rglos{duration}) d'une note est spécifiée par un nombre
-qui suit le nom de cette note : @samp{1} pour une ronde (@rglos{whole
-note}), @samp{2} pour une blanche (@rglos{half note}), @samp{4} pour
-une noire (@rglos{quarter note}) et ainsi de suite.
+@node Simple notation
+@subsection Simple notation
-@example
-a1 a2 a4 a16 a32
-@end example
+@cindex simple, notation
+@cindex notation simple
-@lilypond[fragment,quote,notime,relative=2]
-\set Staff.autoBeaming = ##f
-{ a1 a2 a4 a16 a32 s16_" " }
-@end lilypond
+Il y a certains éléments graphiques de notation que LilyPond ajoute
+automatiquement. Dans l'exemple suivant, nous n'avons fourni que
+quatre hauteurs, mais LilyPond a ajouté une clef, un chiffre de mesure
+et du rythme.
-Si aucune durée n'est spécifiée, la dernière durée entrée est utilisée
-pour les notes suivantes. La valeur implicite de la première note
-dans les fichiers sources de la partition est la noire :
+@lilypond[verbatim,quote]
+{
+ c' e' g' e'
+}
+@end lilypond
-@example
-a a8 a a2 a
-@end example
+@noindent
+Ces valeurs automatiques simplifient la saisie du code source dans
+bien des cas ; nous verrons plus loin comment les indiquer
+explicitement.
+
+
+@subheading Hauteurs
+
+@cindex hauteurs
+@cindex mode relatif
+@cindex apostrophe
+@cindex virgule
+@cindex altérations et mode relatif
+@cindex mode relatif et altérations
+
+@funindex \relative
+@funindex relative
+@funindex '
+@funindex ,
+
+Glossaire musical : @rglos{pitch}, @rglos{interval},
+@rglos{scale}, @rglos{middle C}, @rglos{octave},
+@rglos{accidental}.
+
+Le moyen le plus simple d'entrer des notes est d'utiliser le mode
+d'octaves relatives, ou mode @code{\relative}. Dans ce mode, l'octave
+de chaque note est sélectionnée automatiquement de façon à ce qu'elle
+soit la plus proche possible de la note précédente, c'est-à-dire de
+façon à ce que l'intervalle avec la note précédente soit au plus d'une
+quarte. Commençons par saisir une partition très simple, à savoir une
+gamme.
+
+@lilypond[verbatim,quote]
+% set the starting point to middle C
+\relative c' {
+ c d e f
+ g a b c
+}
+@end lilypond
-@lilypond[fragment,quote,notime,relative=2]
-{ a a8 a a2 a s16_" " }
+La note de départ est le @notation{do central}. Chacune des notes qui
+suivent est placée à l'octave la plus proche de la note précédente ---
+en d'autres termes, le premier @samp{c} est le do central, entre la
+clef de sol et la clef 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 avec de plus
+grands intervalles, toujours avec le mode @code{\relative} :
+
+@lilypond[verbatim,quote]
+\relative c' {
+ d f a g
+ c b f d
+}
@end lilypond
+@noindent
+Remarquez que cet exemple ne commence plus sur le do central : la
+première note --- le @samp{d} --- est le ré qui en est le plus proche.
-On saisit un silence (@rglos{rest}) tout comme une note, mais avec le
-caractère @samp{r}
+Dans l'exemple suivant, on remplace @code{c'} dans la commande
+@w{@code{\relative c'}} par @code{c''}, afin de calculer l'octave de
+la première note par rapport au do situé une octave au-dessus du do
+central :
-@example
-r2 r4 r8 r16
-@end example
+@lilypond[verbatim,quote]
+% one octave above middle C
+\relative c'' {
+ e c a c
+}
+@end lilypond
-@lilypond[fragment,quote,notime]
-r2 r4 r8 r16 s16_" "
+Le mode d'octaves relatives peut être déroutant au début, mais c'est
+souvent la façon la plus économique de saisir les hauteurs en
+utilisant le clavier de l'ordinateur de façon classique. Détaillons
+dans un exemple le calcul des octaves relatives. En partant d'un si
+sur la troisième ligne de la clé de sol, un do, un ré ou un mi sans
+indication d'octave particulière seront placés juste au-dessus du si,
+c'est-à-dire au plus à une quarte ascendante du si, alors qu'un la, un
+sol ou un fa seront placés juste en-dessous du si, c'est-à-dire au
+plus à une quarte descendante du si.
+
+@lilypond[verbatim,quote]
+\relative c'' {
+ b c % c is 1 staff space up, so is the c above
+ b d % d is 2 up or 5 down, so is the d above
+ b e % e is 3 up or 4 down, so is the e above
+ b a % a is 6 up or 1 down, so is the a below
+ b g % g is 5 up or 2 down, so is the g below
+ b f % f is 4 up or 3 down, so is the f below
+}
@end lilypond
-Ajouter un point @samp{.} après une durée permet d'obtenir une note
-pointée (@rglos{dotted note})
+Notez que le calcul des octaves relatives @strong{ne dépend pas des
+altérations} des notes, dièses bémols ou bécarre.
-@example
-a2. a4 a8. a16
-@end example
+Pour obtenir des intervalles supérieurs à une quarte, on peut ajouter
+des apostrophes @code{'} --- qui font chacune monter la hauteur d'une
+octave --- ou des virgules @code{,} --- qui font chacune descendre la
+hauteur d'une octave --- au nom de la note.
-@lilypond[fragment,quote,notime,relative=1]
-{ a2. a4 a8. a16 s16_" " }
+@lilypond[verbatim,quote]
+\relative c'' {
+ a a, c' f,
+ g g'' a,, f'
+}
@end lilypond
-La métrique (@rglos{time signature}) est définie par
-la commande @code{\time}
+@noindent
+Pour déplacer une note deux octaves (ou davantage !) plus haut ou plus
+bas, il suffit de mettre deux (ou davantage) @code{'} ou @code{,} ---
+attention cependant à bien mettre deux apostrophes @code{''}, et non
+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 Durées et rythme
+
+@cindex note, durée
+@cindex durées
+@cindex rhythmes
+@cindex ronde
+@cindex blanche
+@cindex noire
+@cindex note pointée
+@cindex spécification des durées
+
+Glossaire musical : @rglos{beam}, @rglos{duration},
+@rglos{whole note}, @rglos{half note}, @rglos{quarter note},
+@rglos{dotted note}.
+
+La @notation{durée} d'une note est indiquée par un nombre qui suit sa
+hauteur : @samp{1} pour une @notation{ronde}, @samp{2} pour une
+@notation{blanche}, @samp{4} pour une @notation{noire} et ainsi de
+suite. Les @notation{crochets} et @notation{liens} sont ajoutés
+automatiquement.
+
+Si aucune durée n'est indiquée pour une note, la dernière durée entrée
+est utilisée. En l'absence d'indication de durée, la première note
+est une noire.
+
+@lilypond[verbatim,quote]
+\relative c'' {
+ a1
+ a2 a4 a8 a
+ a16 a a a a32 a a a a64 a a a a a a a a2
+}
+@end lilypond
-@example
-\time 3/4
-\time 6/8
-\time 4/4
-@end example
+Une @notation{note pointée} s'obtient en ajoutant un point @code{.} à
+la valeur rythmique. Le point doit être précédé d'un nombre spécifiant
+la durée de base.
-@c A clef here may lead to confusion, remove it.
-@lilypond[fragment,quote]
-\override Staff.Clef #'transparent = ##t
-\time 3/4
-s4_" "
-\time 6/8
-s4_" "
-\time 4/4
-s16_" "
+@lilypond[verbatim,quote]
+\relative c'' {
+ a a a4. a8
+ a8. a16 a a8. a8 a4.
+}
@end lilypond
-La @rglos{clef} est définie par la commande @code{\clef}
-@example
-\clef treble
-\clef bass
-\clef alto
-\clef tenor
-@end example
+@subheading Silences
-@lilypond[fragment,quote,notime]
-\clef treble
-s4_" "
-\clef bass
-s4_" "
-\clef alto
-s4_" "
-\clef tenor
-s16_" "
-@end lilypond
-
-Pensez bien à encadrer les notes et les commandes avec des accolades
-@code{@{@tie{}@dots{}@tie{}@}} pour pouvoir obtenir un résultat
-imprimable.
-
-@lilypond[fragment,quote,noindent,verbatim]
-\time 3/4
-\clef bass
-c2 e4 g2.
-f4 e d c2 r4
-@end lilypond
-
-Pour plus d'informations sur
-
-@quotation
-@table @asis
-@item la définition des hauteurs et des durées
-voir
-@ref{Pitches}, et @ref{Durations}.
-@item les clefs
-voir @ref{Clef}
-@item les silences
-voir @ref{Rests}.
-@item la métrique et autres commandes liées au temps
-voir @ref{Time signature}.
-@end table
-@end quotation
-
-
-@node More about pitches
-@section More about pitches
-
-Un dièse (@rglos{sharp}) s'obtient en ajoutant @samp{is} au nom de la
-note, un bémol (@rglos{flat}) en ajoutant @samp{es}. Comme vous pouvez
-vous y attendre, un double dièse ou double bémol est obtenu en
-ajoutant @samp{isis} ou @samp{eses}@footnote{Cette syntaxe est dérivée
-de la convention de dénomination des notes dans les langues nordiques
-et germaniques, comme l'allemand ou le hollandais.}.
+@cindex silences
+@cindex notation des silences
-@c DIV specific
-Si vous utilisez la commande @samp{\include "catalan.ly"} pour entrer
-les noms de notes français au lieu des noms hollandais, il faudra
-ajouter un @samp{d} pour un dièse, et un @samp{b} pour un bèmol. Le
-double dièse et le double bémol s'obtiennent en ajoutant
-respectivement @samp{dd} et @samp{bb}
-@c END DIV
+Glossaire musical : @rglos{rest}.
-@example
-cis1 ees fisis aeses
-@end example
+On saisit un @notation{silence} tout comme une note, mais avec la
+lettre @samp{r} (pour @emph{rest}).
-@lilypond[fragment,quote,notime]
-\set Score.timing = ##f
-\transpose c c' { cis1 ees fisis aeses s16_" " }
+@lilypond[verbatim,quote]
+\relative c'' {
+ a r r2
+ r8 a r4 r4. r8
+}
@end lilypond
-@cindex key signature, setting
-L'armure est déterminée par la commande @code{\key}, suivie d'une
-hauteur puis de @code{\major} (majeur) ou @code{\minor} (mineur) :
-@example
-\key d \major
-g1
-\key c \minor
-g
-@end example
+@subheading Métrique
-@lilypond[fragment,quote,notime,fragment]
-\key d \major
-g'1
-\key c \minor
-g'
-@end lilypond
+@cindex métrique
-@noindent
-La combinaison de l'armure et des hauteurs de note -- y compris les
-altérations -- permet de déterminer dans quel cas afficher les
-altérations accidentelles. Cette fonctionnalité est souvent source de
-confusion pour les nouveaux utilisateurs, aussi expliquons-la en
-détail.
-
-
-LilyPond fait une nette distinction entre le contenu musical et la
-mise en forme. L'altération d'une note -- bémol, bécarre ou dièse --
-fait partie de sa hauteur, et donc du contenu musical. La présence
-d'une altération accidentelle -- un @emph{signe} bémol, bécarre ou
-dièse -- devant la note correspondante est une question de mise en
-page. La mise en page est un processus qui obéit à des règles ; les
-altérations accidentelles sont donc automatiquement imprimées suivant
-ces règles. Les hauteurs de note appartiennent à la musique que vous
-entrez, et comme vous êtes sensé(e) entrer ce que vous voulez entendre,
-LilyPond, qui n'est chargé que de la gravure, ne les choisit pas à
-votre place.
-
-Dans cet exemple
-
-@lilypond[quote,notime,fragment]
-\key d \major
-d' cis' fis'
+@funindex \time
+@funindex time
+
+Glossaire musical : @rglos{time signature}.
+
+La @notation{métrique}, aussi appelée @notation{chiffre de mesure},
+peut être définie à l'aide de la commande @code{\time} :
+
+@lilypond[verbatim,quote]
+\relative c'' {
+ \time 3/4
+ a4 a a
+ \time 6/8
+ a4. a
+ \time 4/4
+ a4 a a a
+}
@end lilypond
-@noindent
-si aucune note n'a d'altération accidentelle, vous devez
-cependant entrer
-@example
-\key d \major
-d cis fis
-@end example
+@subheading Clef
-@noindent
-Le code @samp{d} ne veut pas dire « imprimer un point noir juste
-en-dessous de la portée. » Cela signifie plutôt : « une note ayant la
-hauteur ré naturel. » Avec l'armure de la bémol majeur, ce ré sera flanqué
-d'un bécarre accidentel.
+@cindex clef
+@cindex clé
+@cindex sol, clef de
+@cindex ut, clef d'
+@cindex fa, clef de
-@lilypond[quote,notime,fragment,relative=1,verbatim]
-\key as \major
-d
+@funindex \clef
+@funindex clef
+
+Glossaire musical : @rglos{clef}.
+
+La @notation{clef} peut être définie à l'aide de la commande
+@code{\clef} :
+
+@lilypond[verbatim,quote]
+\relative c' {
+ \clef treble
+ c1
+ \clef alto
+ c1
+ \clef tenor
+ c1
+ \clef bass
+ c1
+}
@end lilypond
-Ajouter explicitement toutes les altérations requiert un peu plus
-d'effort dans la phase de saisie, mais avec l'avantage que la
-transposition en sera facilitée. De plus les altérations accidentelles
-peuvent être imprimées suivant plusieurs conventions. Regardez
-@ref{Automatic accidentals} pour connaître la manière dont les
-altérations accidentelles peuvent être imprimées suivant différentes
-règles.
+@subheading Tout ensemble
-Pour plus d'informations sur
+Voici un bref exemple qui rassemble tous les éléments que nous déjà
+vus :
-@quotation
-@table @asis
-@item les altérations accidentelles
-voir @ref{Automatic accidentals}.
+@lilypond[verbatim,quote]
+\relative c, {
+ \time 3/4
+ \clef bass
+ c2 e8 c' g'2.
+ f4 e d c4 c, r4
+}
+@end lilypond
-@item les armures
-voir @ref{Key signature}.
-@end table
-@end quotation
-@node Entering ties
-@section Entering ties
+@seealso
+Manuel de notation : @ruser{Writing pitches},
+@ruser{Writing rhythms}, @ruser{Writing rests},
+@ruser{Time signature}, @ruser{Clef}.
-@cindex tie
-Une liaison de prolongation@footnote{parfois aussi appelée liaison de
-tenue.} (@rglos{tie}) est créée en ajoutant un tilde @samp{~} à
-la suite de la première note liée.
-@lilypond[quote,notime,fragment,verbatim,relative=3]
-g4~ g a2~ a4
-@end lilypond
+@node Working on input files
+@subsection Working on input files
-Pour plus d'informations sur les liaisons de prolongation, voir @ref{Ties}.
+@cindex accolades
+@funindex { ... }
+Le traitement des fichiers source de LilyPond est semblable à celui du
+code de nombreux langages de programmation. 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 !
+Expliquons tous ces termes :
-@node Automatic and manual beams
-@section Automatic and manual beams
+@itemize
-@cindex beams, by hand
-Toutes les ligatures@footnote{parfois appelées aussi liens de croches}
-(@rglos{beam}), sont dessinées automatiquement :
+@item @strong{La casse} :
+@cindex casse, prise en compte de
+@cindex prise en compte de la casse
+@cindex sensibilité à 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 minuscule : @code{@{ c d e @}} est
+un code valide, alors que @code{@{ C D E @}} produira un message
+d'erreur.
-@lilypond[quote,fragment,relative=2,verbatim]
-a8 ais d es r d
-@end lilypond
+@cindex espaces multiples, insensibilité
+@cindex insensibilité aux 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 @tie{} @tie{} d @tie{} e @}} ou que
+@example
+ @{
+c d
+ e @}
+@end example
@noindent
-Si l'emplacement des barres ne vous convient pas, vous pouvez
-les entrer à la main. Marquer la première note à être attachée d'un
-@samp{[} et la dernière d'un @samp{]}.
+Bien sûr, ce dernier exemple est illisible. Une bonne habitude
+à prendre est d'indenter les blocs de code avec soit des tabulations
+soit des doubles espaces :
-@lilypond[quote,fragment,relative=2,verbatim]
-a8[ ais] d[ es r d]
-@end lilypond
+@example
+@{
+ c d e
+@}
+@end example
-Pour plus d'informations sur les ligatures, voir @ref{Manual beams}.
+@cindex expressions
+
+@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 représente une et une seule expression musicale, tout comme les
+parenthèses @samp{()} en mathématiques. Pour éviter toute ambiguïté,
+il est préférable d'entourer ces accolades d'espaces ou de retours à
+la ligne.
+
+Un appel de fonction --- @w{@code{\relative @{ @}}} par exemple ---
+compte également comme une seule expression musicale.
+
+@cindex commentaire
+@cindex commentaire de fin de ligne
+@cindex commentaire-bloc
+@cindex bloc de commentaire
+
+@funindex %
+@funindex %@{ ... %@}
+
+@item @strong{Les commentaires} :
+un commentaire est une indication pour tout lecteur humain d'un
+fichier source 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. Le commentaire de fin de ligne, introduit par le
+symbole @samp{%} : tout ce qui suit ce symbole sur la même ligne sera
+ignoré. Par convention, un commentaire qui occupe une ligne entière
+se place juste @emph{au-dessus} de la ligne à laquelle il fait
+référence.
+@example
+a4 a a a
+% ce commentaire fait référence aux si
+b2 b
+@end example
-Voici comment se comportent ensemble armures, altérations
-accidentelles et liaisons :
+Le bloc de commentaire, qui peut occuper plusieurs lignes, voire toute
+une section : tout ce qui se trouve entre @code{%@{} et @code{%@}} est
+ignoré. Les blocs de commentaires ne peuvent s'imbriquer, ce qui
+signifie que vous ne pouvez pas placer un commentaire-bloc à
+l'intérieur d'un autre commentaire-bloc. Si jamais vous essayez, vous
+verrez que la première occurence de @code{%@}} terminera @qq{les
+@emph{deux} commentaires-blocs}. Le fragment suivant met en évidence
+quelques usages possibles des commentaires :
-@lilypond[fragment,quote,noindent,line-width=50\staff-space,verbatim]
-\relative c'' {
- \time 4/4
- \key g \minor
- \clef treble
- r4 r8 a8 gis4 b
- a8 d4.~ d e,8
- fis4 fis8 fis8 eis4 a8 gis~
- gis2 r2
-}
-@end lilypond
+@example
+% voici les notes de "ah vous dirai-je maman"
+ c4 c g' g a a g2
-@cindex accidentals
+%@{
+ Ces lignes et les notes qui suivent
+ seront ignorées, car elles se trouvent
+ dans un bloc de commentaire.
+ f f e e d d c2
+%@}
+@end example
-@noindent
-Il y a plusieurs points intéressants à noter dans cet exemple. Les
-barres de mesure et les liens de croches sont dessinés
-automatiquement. Les sauts de ligne sont calculés automatiquement ;
-peu importe où se situent les sauts de ligne dans le fichier source.
-Enfin, l'ordre dans lequel la métrique, l'armure et les changements de
-clefs sont saisis n'a pas d'importance : dans la sortie imprimable,
-ils sont organisés suivant les conventions standard de notation.
+@end itemize
-@node Octave entry
-@section Octave entry
+@node How to read the manual
+@subsection How to read the manual
+@cindex bien lire le manuel
+@cindex manuel, lecture
+@cindex compulser le manuel
+@cindex exemples cliquables
+@cindex cliquables, exemples
+@cindex conseils de construction des fichiers
+@cindex squelettes
+@cindex construction des fichiers, conseils
+@cindex fichiers, conseils de construction
-@c Tim wants to move this quotes example just before the: quotes-do not-work
-@c score, but we'd need to remove quotes from the other two (key and
-@c tie) examples...
+Comme nous l'avons vu dans @ref{Working on input files}, un code
+LilyPond doit être encadré par des accolades @{ @} ou bien par
+@code{\relative c'' @{ ... @}}. Cependant, dans la suite de ce
+manuel, la plupart des exemples ne feront pas apparaître ces signes.
-@c better to have this just before the `octaves are bad' snipped
-@c but we'd need to remove the ', from \key and tie
-Pour hausser une note d'une octave, ajoutez une apostrophe @code{'} au
-nom de la note ; pour la baisser d'une octave, ajoutez une virgule
-@code{,}. Le do central (entre la clef de sol et la clef de fa) est
-@code{c'}
+Pour reproduire les exemples, vous pouvez copier et coller le code
+affiché, mais @strong{à condition} d'ajouter @code{\relative c'' @{
+@}} de la façon suivante :
-@lilypond[quote,notime,fragment,verbatim]
-c'4 c'' c''' \clef bass c c,
-@end lilypond
+@example
+\relative c'' @{
+ ...collez ici votre exemple...
+@}
+@end example
+
+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 une
+expression @code{\relative} à l'intérieur d'un autre expression
+@code{\relative}. Si nous mettions tous nos exemples dans une
+expression @code{\relative}, vous ne pourriez plus copier un bref
+exemple de la documentation pour le coller dans vos pièces.
-Un exemple de l'utilisation des apostrophes dans ce fragment de Mozart :
-@lilypond[quote,ragged-right,fragment,verbatim]
-\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
+@subheading Exemples cliquables
+
+Beaucoup de gens apprennent à utiliser les programmes en les essayant
+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 :
+
+@c no verbatim here
+@c KEEP LY
+@lilypond[quote,ragged-right]
+\relative c'' {
+ c-\markup { \bold \huge { Cliquez ici. } }
+}
@end lilypond
-@noindent
-Cet exemple montre qu'il faut beaucoup d'apostrophes pour écrire de la
-musique dans un registre aigu. Ceci rend le fichier moins lisible, et
-c'est une source d'erreurs. La solution consiste à utiliser le mode
-d'« octaves relatives ». C'est la façon la plus commode de copier de
-la musique existante.
+En copiant-collant le code à partir du commentaire @qq{ly snippet}
+vers un fichier test, vous aurez un modèle de base pour faire vos
+expériences. Pour obtenir une gravure à l'identique, copiez tout le
+code à partir de @qq{Start cut-&-pastable section}.
-En mode relatif, une note sans signe d'octaviation -- @code{'} ou
-@code{,} après le nom de la note -- est interprétée de manière à ce
-qu'elle soit la plus proche de la note précédente. Par exemple,
-@samp{c f} monte, alors que @samp{c g} descend.
+@c No longer in the text in English, but should we really
+@c remove this? --jm
+@ignore
+Si vous apprenez de cette façon, vous aurez probablement envie
+d'imprimer ou de garder un lien vers @ruser{Cheat sheet}, tableau
+qui répertorie les commandes usuelles pour une consultation rapide.
+@end ignore
-Pour utiliser le mode relatif, ajoutez @code{\relative} avant le
-morceau de musique. La première hauteur de note est choisie
-relativement en fonction du do central -- c'est-à-dire @code{c'}.
+@seealso
+Vous trouverez plus de conseils pour construire des fichiers source
+dans @ref{Suggestions for writing LilyPond input files}. Cependant,
+lors d'une première lecture il est préférable de terminer d'abord la
+lecture du tutoriel.
-@lilypond[quote,notime,fragment,verbatim]
-\relative {
- c' f c g c
-}
-@end lilypond
+@node Single staff notation
+@section Single staff notation
+Cette section présente la notation courante dont on a besoin pour
+écrire une voix sur une portée.
-Puisque la plus grande partie de la musique utilise de petits
-intervalles, les pièces peuvent être écrites en mode relatif sans
-pratiquement utiliser de signes d'octavation. L'exemple précédent est
-entré comme
+@menu
+* Accidentals and key signatures::
+* Ties and slurs::
+* Articulation and dynamics::
+* Adding text::
+* Automatic and manual beams::
+* Advanced rhythmic commands::
+@end menu
-@lilypond[quote,ragged-right,verbatim]
-\relative {
- \key a \major
- \time 6/8
- cis'8. d16 cis8 e4 e8
- b8. cis16 b8 d4 d8
-}
-@end lilypond
-@c needed better, maybe even redundant explanation
-@c added another example below.
-@c grappig: Pa vond het heel logies, en slim toen-i eenmaal begreep.
-@c in eerste instantie drong het `relative' niet door zonder extra uitleg.
-Les intervalles plus grands qu'une quarte sont produits en ajoutant
-les signes d'octavation :
+@node Accidentals and key signatures
+@subsection Accidentals and key signatures
-@lilypond[quote,notime,verbatim,fragment]
-\relative c {
- c'' f, f c' c g' c,
-}
+@subheading Accidentals
+
+@cindex dièse
+@cindex double dièse
+@cindex dièse, double
+@cindex bémol
+@cindex double bémol
+@cindex bémol, double
+
+@funindex es
+@funindex b
+@funindex is
+@funindex d
+@funindex eses
+@funindex bb
+@funindex isis
+@funindex dd
+
+Glossaire musical : @rglos{sharp}, @rglos{flat}, @rglos{double sharp},
+@rglos{double flat}, @rglos{accidental}.
+
+Dans la notation par défaut, on obtient un @notation{dièse} en
+ajoutant @code{is} au nom de la note, et un @notation{bémol} en
+ajoutant @code{es}. Comme vous pouvez vous y attendre, un double
+dièse ou double bémol s'obtiennent en ajoutant @code{isis} ou
+@code{eses}. 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 @code{\include "italiano.ly"}
+pour entrer les noms de notes français au lieu des noms hollandais, il
+faudra ajouter un @code{d} pour obtenir un dièse, et un @code{b} pour
+un bémol. Le double dièse et le double bémol s'obtiennent en ajoutant
+respectivement @code{dd} et @code{bb}. Pour en savoir plus sur les
+autres langues disponibles, consultez @ruser{Note names in other
+languages}.
+@c END DIV
+
+@lilypond[verbatim,quote,relative=2]
+cis1 ees fisis, aeses
@end lilypond
-En résumé, apostrophes et virgules ne déterminent pas la hauteur
-absolue d'une note dans le mode @code{\relative}. Au lieu de cela, la
-hauteur de la note est relative à la précédente, et modifier l'octave
-d'une seule note changera l'octave de toutes les notes suivantes.
+@subheading Key signatures
-Pour plus d'information sur les octaves relatives, voir
-@ref{Relative octaves}, et @ref{Octave check}.
+@cindex armure, définition de l'
+@cindex armure, altérations à l'
+@cindex altérations à l'armure
+@cindex majeur
+@cindex mineur
+@funindex \key
+@funindex key
+@funindex \major
+@funindex major
+@funindex \minor
+@funindex minor
-@node Music expressions explained
-@section Music expressions explained
+Glossaire musical : @rglos{key signature}, @rglos{major},
+@rglos{minor}.
+L'armure est déterminée par la commande @code{\key}, suivie d'une
+hauteur puis de @code{\major} (majeur) ou @code{\minor} (mineur).
-Dans les fichiers source LilyPond, la musique est représentée par ce qu'on
-appelle des @emph{expressions musicales}. Nous en avons déjà vu dans
-les quelques exemples précédents ; une seule note constitue une
-expression musicale :
+@lilypond[verbatim,quote,relative=2]
+\key d \major
+a1
+\key c \minor
+a
+@end lilypond
-@lilypond[fragment,quote,verbatim,relative=3]
-a4
+@smallspace
+
+@subheading Warning: key signatures and pitches
+
+Glossaire musical : @rglos{accidental}, @rglos{key signature},
+@rglos{pitch}, @rglos{flat}, @rglos{natural}, @rglos{sharp},
+@rglos{transposition}.
+
+La combinaison de l'@notation{armure} et des hauteurs de note --- y
+compris les altérations --- permet à LilyPond de déterminer dans quel
+cas imprimer des @notation{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 distinction nette entre le contenu musical et la
+mise en forme. L'altération d'une note --- @notation{bémol},
+@notation{bécarre} ou @notation{dièse} --- fait partie de sa hauteur,
+et relève donc du contenu musical. La gravure 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 forme.
+La gravure d'une partition suit des règles, en particulier des règles
+d'indication des altérations accidentelles. 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,
+
+@lilypond[verbatim,quote,relative=2]
+\key d \major
+d cis fis
@end lilypond
-Mettre un groupe de notes entre accolades crée une nouvelle expression
-musicale :
+@noindent
+aucune note n'a d'altération accidentelle, et pourtant vous devrez
+entrer le @code{is} pour les notes @code{cis} et @code{fis}.
-@lilypond[fragment,quote,verbatim,relative=3]
-{ a4 g4 }
+Le code @code{b} ne veut pas dire @qq{Imprimez-moi un point noir sur
+la troisième ligne de la portée.} Cela signifie plutôt : @qq{Ici se
+trouve une note dont la hauteur est un si naturel.} Avec une armure
+de la bémol majeur, ce si est flanqué d'un bécarre accidentel :
+
+@lilypond[verbatim,quote,relative=2]
+\key aes \major
+b
@end lilypond
-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 :
+Ajouter explicitement toutes les altérations demande un peu plus
+d'effort dans la phase de saisie, mais cela facilite grandement la
+@notation{transposition}. De plus, les altérations accidentelles
+peuvent ainsi être imprimées suivant plusieurs conventions. Pour
+connaître les différentes manières dont les altérations accidentelles
+peuvent être imprimées, consultez @ruser{Automatic accidentals}.
-@lilypond[fragment,quote,verbatim,relative=3]
-{ { a4 g } f g }
-@end lilypond
-Cette technique est utile pour de la musique non monophonique. 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 expression. Une expression musicale « simultanée » est formée en
-entourant les expressions entre @code{<<} et @code{>>}. Dans l'exemple
-suivant, trois expressions (contenant chacune deux notes distinctes) sont
-combinées simultanément.
+@seealso
+Manuel de notation : @ruser{Note names in other languages},
+@ruser{Accidentals}, @ruser{Automatic accidentals},
+@ruser{Key signature}.
-@lilypond[fragment,quote,verbatim,relative=3]
-<<
- { a4 g }
- { f e }
- { d b }
->>
-@end lilypond
+Glossaire musical : @rglos{Pitch names}.
-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 longues et complexes. Par exemple,
-@example
-1
+@node Ties and slurs
+@subsection Ties and slurs
-1 + 2
+@cindex liaisons de prolongation
+@cindex liaisons de tenue
+@cindex prolongation, liaisons de
+@cindex durée, liaisons de
+@cindex tenue, liaisons de
-(1 + 2) * 3
+@funindex ~
+@funindex ( ... )
+@funindex \( ... \)
-((1 + 2) * 3) / (4 * 5)
-@end example
+@subheading Ties
-@cindex expression
-@cindex music expression
-Ceci est une suite d'expressions, où chacune est contenue dans la
-suivante. Les expressions les plus simples sont les nombres, et de
-plus grandes expressions sont produites en combinant des expressions
-avec des opérateurs -- comme @samp{+}, @samp{*} et @samp{/} -- et des
-parenthèses. Tout comme les expressions mathématiques, les expressions
-musicales peuvent être imbriquées avec une profondeur arbitraire, ce
-qui est nécessaire pour de la musique complexe comme des partitions
-polyphoniques.
-
-Notez que l'exemple suivant ne comporte qu'une seule portée,
-contrairement à l'exemple précédent qui contenait trois portées
-séparées. C'est parce que l'exemple commence par une note seule. Pour
-déterminer le nombre de portées, LilyPond regarde le premier élément
-qui n'est pas une accolade. Si c'est une seule note, il y a une portée
-; si c'est une expression simultanée, il y aura plus d'une portée.
-
-@lilypond[fragment,quote,verbatim,relative=2]
-{
- c <<c e>>
- << { e f } { c <<b d>> } >>
-}
+Glossaire musical : @rglos{tie}.
+
+Pour créer une liaison de prolongation@footnote{parfois aussi appelée
+liaison de tenue}, on ajoute un tilde @code{~} à la première note
+liée.
+
+@lilypond[verbatim,quote,relative=2]
+g4~ g c2~
+c4 ~ c8 a8 ~ a2
@end lilypond
-Il est facile de s'y perdre avec des fichiers musicaux comprenant de nombreuses
-imbrications, tant pour leur création que pour leur maintenance. Une
-convention permet d'éviter cette confusion : l'indentation. Pour
-entrer un fichier avec de prfondes imbrications d'accolades et de
-crochets, il est d'usage d'avoir recours à une indentation qui indique
-le niveau de profondeur. Formater la musique d'une telle manière en
-facilite la lecture et vous aide à insérer le bon nombre d'accolades
-fermant les expressions. Par exemple,
+@cindex liaisons d'articulation
+@cindex articulation, liaisons d'
-@example
-<<
- @{
- @dots{}
- @}
- @{
- @dots{}
- @}
->>
-@end example
+@subheading Slurs
-Certains éditeurs disposent d'un mode spécifique pour saisir des
-fichiers LilyPond, qui peut vous aider à indenter le fichier source.
-Voir la section @ref{Editor support} pour plus d'informations.
+@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é.
+@c slur = "il zon" (articulation). jcm
+@c phrasing slur = "ils ont des chapeaux ronds" (phrase). jcm
-@node More staves
-@section More staves
+Glossaire musical : @rglos{slur}, @rglos{phrasing}.
-Pour créer plus d'une portée, chaque partie de la musique constituant
-une portée est entrée en la faisant précéder de
-@code{\new Staff}. Ces éléments @code{Staff} sont combinés en parallèle avec
-@code{<<} et @code{>>}, comme
+Une liaison d'articulation ou @emph{legato} peut englober
+plusieurs notes. Les notes de départ et d'arrivée sont suivies
+respectivement d'un signe @samp{(} et @samp{)}.
-@lilypond[quote,fragment,verbatim]
-<<
- \new Staff { \clef treble c'' }
- \new Staff { \clef bass c }
->>
+@lilypond[verbatim,quote,relative=2]
+d4( c16) cis( d e c cis d) e( d4)
@end lilypond
+@cindex liaisons de phrasé
+@cindex phrasé, liaisons de
+@cindex legato
+@subheading Phrasing slurs
-La commande @code{\new} introduit un « contexte de notation ». Un
-contexte de notation est un environnement dans lequel les événements
-musicaux -- comme les notes ou les commandes @code{\clef} -- sont
-interprétés. Pour des pièces simples, ces contextes sont créés
-automatiquement. Pour des pièces plus complexes, il est préférable de
-spécifier explicitement les contextes. Cela assure que chaque fragment
-aura sa propre portée.
+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 @emph{legato} à la fois.
-Il existe différents types de contextes. Les contextes @code{Staff}
-(portée), @code{Voice} (voix) et @code{Score} (partition) gèrent la
-notation de la mélodie, alors que @code{Lyrics} gère les paroles et
-@code{ChordNames} imprime le nom des accords.
+@lilypond[verbatim,quote,relative=2]
+a8(\( ais b c) cis2 b'2 a4 cis,\)
+@end lilypond
-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.
+@smallspace
-Nous pouvons maintenant écrire un morceau à deux portées :
+@cindex liaisons d'articulation et de prolongation, différences
+@subheading Warnings: slurs vs. ties
-@c TODO: (c) status of this Paul McCartney (?) song (let's all stand together)
+Glossaire musical : @rglos{articulation}, @rglos{slur}, @rglos{tie}.
-@lilypond[fragment,quote,verbatim,ragged-right]
-\relative <<
- \new Staff {
- \time 3/4
- \clef treble
+Une liaison d'articulation ou de phrasé ressemble à une liaison de
+prolongation, mais n'a pas la même signification. Alors qu'une
+liaison de prolongation ne peut relier que deux notes de même hauteur,
+le @emph{legato} indique une articulation de plusieurs notes,
+éventuellement en grand nombre. Les liaisons de tenue peuvent être
+enchâssées dans un @emph{legato} ou un phrasé.
- e'2 d4 c2 b4 a8[ a]
- b[ b] g[ g] a2.
- }
- \new Staff {
- \clef bass
- c,,2 e4 g2.
- f4 e d c2.
- }
->>
+@lilypond[verbatim,quote,relative=2]
+c2~( c8 fis fis4 ~ fis2 g2)
@end lilypond
-Pour plus d'informations sur les contextes, voir leur description à
-@ref{Interpretation contexts}.
+@seealso
+Manuel de notation : @ruser{Ties}, @ruser{Slurs},
+@ruser{Phrasing slurs}.
-@node Adding articulation marks to notes
-@section Adding articulation marks to notes
+@node Articulation and dynamics
+@subsection Articulation and dynamics
@cindex articulation
@cindex accents
@cindex staccato
+@subheading Articulations
-Les articulations standard peuvent être ajoutées à une note en
-utilisant un tiret (@samp{-}) et un caractère :
+Glossaire musical : @rglos{articulation}.
-@lilypond[fragment,quote,verbatim,relative=2]
-c-. c-- c-> c-^ c-+ c-_
+Des @notation{articulations} peuvent être ajoutées à une note, au moyen
+d'un tiret @code{-} suivi d'un caractère :
+
+@lilypond[verbatim,quote,relative=2]
+c-. c-- c-> c-^ c-+ c-_
@end lilypond
-@cindex fingering
-De la même manière, des indications de doigté peuvent être ajoutées à
-une note en utilisant un tiret (@samp{-}) et le chiffre à écrire :
+@cindex doigtés
+@subheading Fingerings
+
+@funindex ^
+@funindex _
-@lilypond[fragment,quote,verbatim,relative=2]
+Glossaire musical : @rglos{fingering}.
+
+De même, des indications de doigté peuvent être ajoutées à une note en
+utilisant un tiret (@samp{-}) et le chiffre à écrire :
+
+@lilypond[verbatim,quote,relative=2]
c-3 e-5 b-2 a-1
@end lilypond
Articulations et doigtés sont habituellement placés automatiquement,
-mais vous pouvez spécifier 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.
+mais vous pouvez spécifier leur positionnement 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 bon de laisser LilyPond déterminer l'emplacement de
+l'articulation.
-@lilypond[fragment,quote,verbatim,relative=2]
+@lilypond[verbatim,quote,relative=2]
c_-^1 d^. f^4_2-> e^-_+
@end lilypond
-Les signes de nuances sont obtenus en ajoutant à la note les noms des nuances,
-précédées d'un anti-slash @samp{\} :
-
-@lilypond[fragment,quote,verbatim,relative=2]
-c\ff c\mf
+@subheading Dynamics
+
+@funindex \f
+@funindex \ff
+@funindex \mp
+@funindex \p
+@funindex \mf
+@funindex \pp
+@funindex \<
+@funindex <
+@funindex \>
+@funindex >
+@funindex \!
+@funindex !
+
+Glossaire musical : @rglos{dynamics}, @rglos{crescendo},
+@rglos{decrescendo}.
+
+On obtient un signe de @notation{nuance} en ajoutant à la note les
+lettres du signe, précédées d'un anti-slash @samp{\} :
+
+@lilypond[verbatim,quote,relative=2]
+c\ff c\mf c\p c\pp
@end lilypond
-@cindex dynamics
+@cindex nuances
@cindex decrescendo
@cindex crescendo
-Crescendi et decrescendi débutent avec les commandes @code{\<} et
-@code{\>}. Ils se terminent soit par une nuance d'arrivée, par exemple @code{\f},
-soit par la commande @code{\!} :
+@c Pluriel des termes musicaux italiens :
+@c selon Littré, plutôt à la française (en "-os" qu'en "-i")
+
+@notation{Crescendos} et @notation{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[fragment,quote,verbatim,relative=2]
+@lilypond[verbatim,quote,relative=2]
c2\< c2\ff\> c2 c2\!
@end lilypond
+@seealso
+Manuel de notation : @ruser{Articulations and ornamentations},
+@ruser{Fingering instructions}, @ruser{Dynamics}.
-@cindex slur
-Une liaison d'articulation (@rglos{slur}) est une courbe tracée
-au-dessus de plusieurs notes. Elle indique un jeu legato. Les notes de
-départ et d'arrivée sont suivies respectivement par @samp{(} et
-@samp{)} :
+@node Adding text
+@subsection Adding text
-@lilypond[fragment,quote,fragment,relative=2,verbatim]
-d4( c16) cis( d e c cis d) e( d4)
-@end lilypond
+@cindex texte, ajout de
+@cindex ajout de texte
+@cindex étiquette
-@cindex slurs versus ties
-Une liaison d'articulation ressemble à une liaison de
-prolongation (@rglos{tie}),
-mais a une signification différente. Une liaison de prolongation fait
-durer la première note plus longtemps, et ne peut être utilisée que
-sur une paire de notes de même hauteur. Ces deux types de liaison
-peuvent être imbriqués :
+@funindex \markup
+@funindex markup
-@lilypond[quote,fragment,relative=2]
-c2~( c8 fis fis4 ~ fis2 g2)
+On peut ajouter du texte à une partition :
+
+@lilypond[verbatim,quote,relative=2]
+c1^"espr" a_"legato"
@end lilypond
-@cindex phrasing slurs
-Une liaison de phrasé peut être entrée avec @code{\(} et @code{\)},
-vous pouvez donc avoir simultanément une liaison d'articulation et une
-liaison de phrasé. Vous ne pouvez pas avoir de liaisons d'articulation
-simultanées ni de liaisons de phrasé simultanées.
+Pour mettre en forme du texte, on utilise la commande @code{markup} :
-@lilypond[quote,fragment,relative=2,verbatim]
-a8(\( ais b c) cis2 b'2 a4 cis, c\)
+@lilypond[verbatim,quote,relative=2]
+c1^\markup{ \bold espr}
+a1_\markup{
+ \dynamic f \italic \small { 2nd } \hspace #0.1 \dynamic p
+}
@end lilypond
-Pour plus d'informations sur les
+@seealso
+Manuel de notation : @ruser{Writing text}.
-@quotation
-@table @asis
-@item doigtés
-voir @ref{Fingering instructions}.
-@item articulations
-voir @ref{Articulations}.
-@item liaisons d'articulation
-voir @ref{Slurs}.
-@item liaisons de phrasé
-voir @ref{Phrasing slurs}.
-@item nuances
-voir @ref{Dynamics}.
-@end table
-@end quotation
+@node Automatic and manual beams
+@subsection Automatic and manual beams
-@node Combining notes into chords
-@section Combining notes into chords
+@cindex lihature
+@cindex ligatures automatiques
+@cindex ligatures manuelles
+@cindex ligatures explicites
-@cindex chords
-Des accords peuvent être produits en entourant les hauteurs de note
-avec les angles gauche et droit -- @samp{<} et @samp{>} --
+@funindex [ ... ]
+@funindex [
+@funindex ]
+@funindex \autoBeamOff
+@funindex autoBeamOff
+@funindex \autoBeamOn
+@funindex autoBeamOn
-@lilypond[quote,relative=1,fragment,verbatim]
-r4 <c e g>4 <c f a>8
-@end lilypond
+Glossaire musical : @rglos{beam}.
+Toutes les barres de ligature sont dessinées automatiquement :
-Vous pouvez combiner les indications comme les liaisons et les liens de
-croches avec les accords. Ils doivent cependant être placés en
-dehors des angles :
+@lilypond[verbatim,quote,relative=2]
+a8 ais d ees r d c16 b a8
+@end lilypond
+
+@noindent
+Lorsqu'on n'aime pas la manière dont les notes sont automatiquement
+groupées, il est possible de les ligaturer manuellement, en marquant la
+première note à attacher d'un crochet ouvrant @code{[} et la dernière
+d'un crochet fermant @code{]}.
-@lilypond[quote,relative=1,fragment,verbatim]
-r4 <c e g>8[ <c f a>]~ <c f a>
+@lilypond[verbatim,quote,relative=2]
+a8[ ais] d[ ees r d] a b
@end lilypond
-@example
-r4 <c e g>8\>( <c e g> <c e g> <c f a>\!)
-@end example
+Pour désactiver les barres de ligature automatiques pour des passages
+entiers, utilisez la commande @code{\autoBeamOff}, et utilisez
+@code{\autoBeamOn} pour les réactiver.
-@lilypond[quote,relative=1,fragment]
-\slurUp
-r4 <c e g>8\>( <c e g> <c e g> <c f a>\!)
+@lilypond[verbatim,quote,relative=2]
+\autoBeamOff
+a8 c b4 d8. c16 b4
+\autoBeamOn
+a8 c b4 d8. c16 b4
@end lilypond
+@seealso
+Manuel de notation : @ruser{Automatic beams}, @ruser{Manual beams}.
+
+
@node Advanced rhythmic commands
-@section Advanced rhythmic commands
+@subsection Advanced rhythmic commands
+
+@subheading Partial measure
-@cindex pickup
-@cindex anacruse
-@cindex partial measure
-Une levée est entrée avec le mot-clé @code{\partial}. Il est suivi par
-une durée : @code{\partial 4} est une levée d'une noire et
-@code{\partial 8} d'une croche.
+@cindex levée
+@cindex anacrouse
+@cindex mesure incomplète
-@lilypond[quote,relative=2,verbatim,fragment]
+@funindex \partial
+@funindex partial
+
+Glossaire musical : @rglos{anacrusis}.
+
+On crée une levée (ou anacrouse) avec la commande @code{\partial},
+suivie d'une durée : @code{\partial 4} produit une levée d'une noire
+et @code{\partial 8} d'une croche.
+
+@lilypond[verbatim,quote,relative=2]
\partial 8
-f8 c2 d e
+f8 c2 d
@end lilypond
-@cindex tuplets
-@cindex triplets
-Les n-olets sont créés avec le mot-clef @code{\times}. Celui-ci prend
-deux arguments : une fraction et une expression musicale. La durée des
-notes de l'expression musicale est multipliée par la fraction. Les
-notes d'un triolet durent les deux tiers du temps de leur notation
-réelle, cette fraction est donc de 2/3 pour les triolets :
+@subheading Tuplets
+
+@cindex nolets
+@cindex triolets
-@lilypond[quote,relative=1,verbatim,fragment]
+@funindex \times
+@funindex times
+
+Glossaire musical : @rglos{note value}, @rglos{triplet}.
+
+Les @notation{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 @notation{triolet} durent les
+deux tiers de la durée de leur notation réelle, cette fraction est
+donc de 2/3 pour les triolets :
+
+@lilypond[verbatim,quote,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 { d4 a8 }
@end lilypond
-@cindex grace notes
-@cindex acciaccatura
-Des notes d'ornement sont produites en préfixant une expression musicale
-avec le mot-clé @code{\appoggiatura} ou @code{\acciaccatura} :
-@cindex appoggiatura
-@cindex acciaccatura
+@subheading Grace notes
-@lilypond[quote,relative=2,verbatim,fragment]
-c4 \appoggiatura b16 c4
-c4 \acciaccatura b16 c4
-@end lilypond
+@cindex notes d'ornement
+@cindex ornementation
+@cindex appoggiature
+@cindex acciaccature
-@noindent
+@funindex \grace
+@funindex grace
+@funindex \acciaccatura
+@funindex acciaccatura
+@funindex \appoggiatura
+@funindex acciaccatura
-Pour plus d'informations sur les
-
-@quotation
-@table @asis
-@item ornementations
-voir @ref{Grace notes},
-@item n-olets
-voir @ref{Tuplets},
-@item mesures incomplètes (levées)
-voir @ref{Partial measures}.
-@end table
-@end quotation
-
-
-@node Commenting input files
-@section Commenting input files
-
-@cindex comments
-@cindex line comment
-@cindex block comment
-Un commentaire est une remarque à l'attention du lecteur du fichier
-source ; il est ignoré lors de l'analyse du fichier, et n'a donc
-aucun effet sur la sortie imprimable. Il existe deux types
-de commentaires. Le symbole pourcent @samp{%} introduit un commentaire
-d'une ligne : après @code{%}, le reste de la ligne est ignoré. Un bloc de
-commentaire marque une section entière dans le fichier d'entrée. Tout ce
-qui est à l'intérieur de @code{%@{} et @code{%@}} est ignoré. Le fragment
-suivant montre les utilisations possible des commentaires :
+Glossaire musical : @rglos{grace notes}, @rglos{acciaccatura},
+@rglos{appoggiatura}.
-@example
-% mélodie de "ah vous dirais-je maman"
- c4 c g' g a a g2
+Des @notation{notes d'ornement} s'obtiennent en appliquant la commande
+@code{\grace}, @code{\appoggiatura} ou @code{\acciaccatura} à une
+expression musicale :
-%@{
- Cette ligne, et les notes ci-dessous
- sont ignorées, puisque'elles sont dans
- un bloc de commentaire.
+@lilypond[verbatim,quote,relative=2]
+c2 \grace { a32[ b] } c2
+c2 \appoggiatura b16 c2
+c2 \acciaccatura b16 c2
+@end lilypond
- f f e e d d c2
-%@}
-@end example
-@c TODO post-2.6 reorg
-@c This is good info, but I wouldn't call it a comment. IMO it should
-@c be moved somewhere else.
+@seealso
+Manuel de notation : @ruser{Grace notes}, @ruser{Tuplets},
+@ruser{Upbeats}.
-@cindex versioning
-Il y a une déclaration particulière qui est une sorte de commentaire. La
-déclaration @code{\version} stipule le numéro de la version de LilyPond
-pour laquelle le fichier a été écrit. Pour donner à un fichier la version
-2.10.0, utilisez
+@node Multiple notes at once
+@section Multiple notes at once
-@example
-\version "2.10.0"
-@end example
+Cette section traite de situations où l'on a plus d'une note à la fois :
+plusieurs instruments, plusieurs voix ou portées pour un même
+instrument (le piano, par exemple), et les accords.
-@noindent
-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.
+En théorie musicale, la polyphonie désigne une musique 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::
+* Staff groups::
+* Combining notes into chords::
+* Single staff polyphony::
+@end menu
-@node Printing lyrics
-@section Printing lyrics
-@cindex lyrics
-@c TODO: (c) status of the Queen fragment.
+@node Music expressions explained
+@subsection Music expressions explained
-@cindex Lyrics
-@cindex Songs
-Les paroles sont entrées en séparant chaque syllable par un espace :
+@cindex expression musicale
-@example
-I want to break free
-@end example
+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 :
+
+@lilypond[verbatim,quote,relative=2]
+a4
+@end lilypond
-Voyons la mélodie
+Mettre un groupe de notes entre accolades crée une nouvelle expression
+musicale, appelée @emph{expression musicale composée}. En voici un
+exemple avec deux notes :
-@lilypond[quote,verbatim,fragment,ragged-right]
-\relative {
- r4 c \times 2/3 { f g g }
- \times 2/3 { g4( a2) }
-}
+@lilypond[verbatim,quote,relative=2]
+{ a4 g4 }
@end lilypond
-Les paroles peuvent être associées à ces notes en les combinant avec le
-mot-clé @code{\addlyrics}
+La mise entre accolades d'une séquence d'expressions musicales --- des
+notes par exemple --- signifie qu'elles doivent être jouées
+successivement, les unes après les autres. Le résultat est une
+expression, qui peut elle-même être regroupée séquentiellement avec
+d'autres expressions. Ici, l'expression de l'exemple précédent est
+combinée à deux notes :
-@lilypond[quote,verbatim,fragment,ragged-right]
-<<
- \relative {
- r4 c \times 2/3 { f g g }
- \times 2/3 { g4( a2) }
- }
- \addlyrics { I want to break free }
->>
+@lilypond[verbatim,quote,relative=2]
+{ { a4 g } f g }
@end lilypond
-@cindex melisma
-@cindex extender line
-@c synonyms?
-Cette mélodie se termine sur un mélisme (@rglos{melisma}),
-c'est-à-dire qu'une seule syllable (« free ») correspond à plus d'une
-note. Ceci est indiqué avec une @emph{ligne d'extension}. Elle est
-entrée avec deux caractères souligné (@code{_}), c'est-à-dire
+@subheading Analogy: mathematical expressions
+
+@cindex expression
+
+Ce mécanisme est similaire aux formules mathématiques : une grosse
+formule est créée en assemblant plusieurs petites formules. De telles
+formules sont appelées expressions, elles ont une définition
+récursive, de telle sorte que vous pouvez fabriquer des expressions
+arbitrairement longues et complexes. Par exemple :
@example
-@{ I want to break free __ @}
-@end example
+1
-@lilypond[fragment,quote,ragged-right]
-<<
- \relative {
- r4 c \times 2/3 { f g g }
- \times 2/3 { g4( a2) }
- }
- \addlyrics { I want to break free __ }
->>
-@end lilypond
+1 + 2
-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 :
+(1 + 2) * 3
-@example
-A -- le gri -- a
+((1 + 2) * 3) / (4 * 5)
@end example
-@c no ragged-right here, because otherwise the hypens get lost.
-@lilypond[fragment,quote]
-<<
- \relative {
- \time 2/4
- f4 f c' c
- }
- \addlyrics { A -- le gri -- a }
->>
+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 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 des partitions complexes comme
+de la musique polyphonique.
+
+
+@subheading Simultaneous music expressions: multiple staves
+
+@cindex portées multiples
+@cindex polyphonie
+@cindex combinaison d'expressions en parallèle
+@cindex parallèles, expressions
+@cindex expressions parallèles
+@cindex hauteur relative et musique simultanée
+@cindex musique simultanée et hauteur relative
+@cindex hauteur relative et expressions parallèles
+@cindex expressions parallèles et hauteur relative
+
+@funindex <<
+@funindex >>
+@funindex << ... >>
+
+Glossaire musical : @rglos{polyphony}.
+
+Cette technique est utile pour de la musique @notation{polyphonique}.
+Pour entrer une musique avec plusieurs voix ou plusieurs portées, nous
+pouvons aussi combiner @emph{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
+@qq{simultanée} est formée en entourant les expressions entre @code{<<}
+et @code{>>}. Dans l'exemple suivant, trois expressions (contenant
+chacune deux notes distinctes) sont combinées simultanément.
+
+@lilypond[verbatim,quote]
+\relative c'' {
+ <<
+ { a4 g }
+ { f e }
+ { d b }
+ >>
+}
@end lilypond
-Plus de possibilités, comme celle d'ajouter plusieurs lignes de
-paroles en dessous d'une même mélodie sont exposées à
-@ref{Vocal music}.
+Notez que nous avons ici indenté chaque niveau du fichier d'entrée
+avec un nombre d'espaces différent. LilyPond se moque --- ou presque
+--- de l'espace qu'il peut y avoir ou non au début d'une ligne, mais
+un code bien indenté est bien plus lisible par des humains.
+
+@warning{la hauteur de chaque note saisie est relative à la précédente,
+mais pas au @code{c''} de la commande @code{\relative} de départ.}
-@node A lead sheet
-@section A lead sheet
+@subheading Simultaneous music expressions: single staff
-@cindex Lead sheets
-@cindex chords
-@cindex chord names
+Pour déterminer le nombre de portées, LilyPond regarde le début
+de la première expression. Si c'est une seule note, une seule portée
+est produite ; si c'est une expression simultanée, plusieurs portées
+sont produites.
-@c TODO: revise this, \chords { } is shorter and more intuitive.
+@lilypond[verbatim,quote]
+\relative c'' {
+ c2 <<c e>>
+ << { e f } { c <<b d>> } >>
+}
+@end lilypond
-Dans la musique de variété, il est courant d'indiquer l'accompagnement
-par le nom des accords. De tels accords peuvent être entrés comme les
-notes :
-@lilypond[quote,verbatim,ragged-right]
-\chordmode { c2 f4. g8 }
+@node Multiple staves
+@subsection Multiple staves
+
+@cindex multiples portées
+@cindex portées multiples
+@cindex contexte
+@cindex contexte de notation
+@cindex notation, contexte
+
+@funindex \new Staff
+@funindex new Staff
+@funindex Staff
+@funindex \new
+@funindex new
+@funindex Score
+@funindex Voice
+@funindex Lyrics
+@funindex ChordNames
+
+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 prévoir le
+nombre de portées si on les crée explicitement, ce que nous allons
+voir.
+
+Pour créer plus d'une portée, on ajoute @code{\new Staff} au début de
+chaque partie de la musique constituant une portée. Ces éléments
+@code{Staff} sont ensuite combinés en parallèle avec @code{<<} et
+@code{>>}, comme ci-dessous.
+
+@lilypond[verbatim,quote]
+\relative c'' {
+ <<
+ \new Staff { \clef treble c }
+ \new Staff { \clef bass c,, }
+ >>
+}
@end lilypond
-@noindent
-Maintenant, chaque hauteur est lue comme la base de l'accord à la
-place de la note. Ce mode est activé avec @code{\chordmode}.
-Les autres accords peuvent être créés en ajoutant des modifiacteurs après
-deux points. L'exemple suivant montre quelques modificateurs usuels :
+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
+automatiquement. Pour des pièces plus complexes, il est préférable de
+spécifier explicitement les contextes, afin de s'assurer que chaque
+fragment aura sa propre portée.
-@lilypond[quote,verbatim,ragged-right]
-\chordmode { c2 f4:m g4:maj7 gis1:dim7 }
+Il existe différents types de contextes. Les contextes @code{Score}
+(partition), @code{Staff} (portée) et @code{Voice} (voix) gèrent la
+notation de la mélodie, alors que @code{Lyrics} gère les paroles et
+@code{ChordNames} imprime des noms d'accords.
+
+En termes de syntaxe, ajouter @code{\new} devant une expression
+musicale crée une plus grande expression musicale. En reprenant la
+comparaison précédente, cela ressemble au signe @emph{moins} en
+mathématiques. La formule @math{(4+5)} est une expression, donc
+@math{-(4+5)} est une plus grande expression.
+
+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. Ces
+caractéristiques par défaut se justifient par le fait que
+l'utilisation d'instruments transpositeurs est bien plus fréquente que
+la musique polyrythmique.
+
+@lilypond[verbatim,quote]
+\relative c'' {
+ <<
+ \new Staff { \clef treble \key d \major \time 3/4 c }
+ \new Staff { \clef bass c,, }
+ >>
+}
@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
-@lilypond[quote,verbatim,ragged-right]
-\chords { c2 f4.:m g4.:maj7 gis8:dim7 }
-@end lilypond
+@node Staff groups
+@subsection Staff groups
+
+@cindex portée double
+@cindex portée pour piano
+@cindex piano, portée pour
+@cindex clavier, portée pour
+@cindex chœur, système pour
+@cindex système pour chœur
+@cindex système
+@cindex portées, regroupement de
+@cindex regroupement de portées
-@cindex lead sheet
-Une fois assemblés, les accords, paroles et mélodie forment une
-partition de chanson :
+@funindex PianoStaff
+@funindex GrandStaff
+@funindex ChoirStaff
+
+Glossaire musical : @rglos{brace}.
+
+La musique pour piano s'écrit sur deux portées reliées par une
+@notation{accolade}. La gravure de ce type de portée est semblable à
+l'exemple de musique polyphonique de @ref{Multiple staves}, mais
+maintenant cette expression entière est interprétée dans un contexte
+@code{PianoStaff} :
@example
-<<
- \chords @{ @emph{les accords} @}
- @emph{la mélodie}
- \addlyrics @{ @emph{le texte} @}
+\new PianoStaff <<
+ \new Staff @dots{}
+ \new Staff @dots{}
>>
-@}
@end example
-@lilypond[quote,ragged-right]
-<<
- \chords { r2 c:sus4 f }
- \relative {
- r4 c' \times 2/3 { f g g }
- \times 2/3 { g4( a2) }
- }
- \addlyrics { I want to break free __ }
->>
+Voici un bref exemple :
+
+@lilypond[verbatim,quote]
+\relative c'' {
+ \new PianoStaff <<
+ \new Staff { \time 2/4 c4 e g g, }
+ \new Staff { \clef bass c,, c' e c }
+ >>
+}
@end lilypond
-Une liste complète de modificateurs et d'autres options de
-mise en forme se trouve à la section @ref{Chords}.
+@seealso
+Manuel de notation : @ruser{Keyboard and other multi-staff instruments},
+@ruser{Displaying staves}.
-@node Adding titles
-@section Adding titles
-Les informations bibliographiques sont entrées dans un bloc séparé, le
-bloc d'en-tête (@code{\header}). Le nom du morceau, son compositeur, etc., sont
-définis dans @code{\header@{@tie{}@dots{}@tie{}@}}.
-Le bloc @code{\header} est habituellement placé en début de fichier.
-Par exemple,
+@node Combining notes into chords
+@subsection Combining notes into chords
+
+@cindex accords, notes simultanées
+@cindex accords et durée
-@example
-\header @{
- title = "Miniature"
- composer = "Igor Stravinsky"
-@}
+@funindex <
+@funindex >
+@funindex < ... >
-@{ @dots{} @}
-@end example
+Glossaire musical : @rglos{chord}.
+
+Nous avons vu précédemment comment combiner des notes simultanément,
+en les encadrant par des angles doubles @code{<<} et @code{>>}. Pour
+produire des accords simples, c'est-à-dire une superposition de notes
+de même durée, on encadre les hauteurs de notes par des angles simples
+@code{<} et @code{>}, et on écrit la durée juste après.
+
+@lilypond[verbatim,quote,relative=2]
+r4 <c e g>4 <c f a>2
+@end lilypond
+Beaucoup d'éléments de notation que l'on peut attacher à une note
+simple, comme une liaison, un crochet indiquant un début ou une fin de
+lien, un signe d'articulation, peuvent être également attachés à un
+accord : il faut ajouter ces indications après les hauteurs et la
+durée, donc @emph{à l'extérieur} des angles.
-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}.
+@lilypond[verbatim,quote,relative=2]
+r4 <c e g>8[ <c f a>]~ <c f a>2
+r4 <c e g>8( <c e g>\> <c e g>4 <c f a>\!)
+@end lilypond
@node Single staff polyphony
-@section Single staff polyphony
+@subsection Single staff polyphony
+
+@cindex polyphonie
+@cindex voix multiples sur une portée
+@cindex silence invisible
+@cindex invisible, silence
-@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, elle 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.
+@funindex << ... \\ ... >>
+@funindex <<
+@funindex \\
+@funindex >>
-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{\\} :
+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.
-@lilypond[quote,verbatim,relative=2,fragment]
-<< { a4 g2 f4~ f4 } \\
- { r4 g4 f2 f4 } >>
+On réalise ce type de partition en entrant chaque voix comme une
+séquence, autrement dit avec @code{@{...@}}, puis en combinant
+simultanément les voix et en les séparant par @code{\\}.
+
+@lilypond[verbatim,quote,relative=2]
+<<
+ { 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. Voici le même exemple que ci-dessus, avec un silence invisible
+@code{s} (pour @emph{skip}) à la place d'un silence normal @code{r} :
-@lilypond[quote,verbatim,relative=2,fragment]
-<< { a4 g2 f4~ f4 } \\
- { s4 g4 f2 f4 } >>
+@lilypond[verbatim,quote,relative=2]
+<<
+ { a4 g2 f4~ f4 } \\
+ { s4 g4 f2 f4 }
+>>
@end lilypond
@noindent
-Encore une fois, ces expressions peuvent s'imbriquer arbitrairement :
+Là encore, ces expressions peuvent s'imbriquer arbitrairement :
-@lilypond[quote,fragment,verbatim,relative=2,fragment]
+@lilypond[verbatim,quote,relative=2]
<<
\new Staff <<
{ a4 g2 f4~ f4 } \\
>>
@end lilypond
-Plus de fonctionnalités sur l'écriture polyphonique sont décrites à la
-section @ref{Basic polyphony} du manuel.
+@seealso
+Manuel de notation : @ruser{Simultaneous notes}.
-@node Piano staves
-@section Piano staves
-@cindex staff switch, manual
-@cindex cross staff voice, manual
-La musique pour piano s'écrit avec deux portées reliées par une
-accolade. Imprimer ce type de portée revient au même que dans l'exemple de
-musique polyphonique (@ref{More staves}),
+@node Songs
+@section Songs
-@example
-<< \new Staff @{ @dots{} @}
- \new Staff @{ @dots{} @} >>
-@end example
+Cette section présente l'écriture vocale et les partitions de variété.
-@noindent
-mais maintenant cette expression entière doit être interprétée dans un
-contexte @code{PianoStaff}
+@menu
+* Setting simple songs::
+* Aligning lyrics to a melody::
+* Lyrics to multiple staves::
+@end menu
-@example
-\new PianoStaff << \new Staff @dots{} >>
-@end example
-Voici un petit exemple :
+@node Setting simple songs
+@subsection Setting simple songs
-@lilypond[quote,verbatim,relative=1,fragment]
-\new PianoStaff <<
- \new Staff { \time 2/4 c4 c g' g }
- \new Staff { \clef bass c,, c' e c }
+@cindex paroles
+@cindex chansons
+
+@funindex \addlyrics
+@funindex addlyrics
+
+Glossaire musical : @rglos{lyrics}.
+
+Prenons une mélodie toute simple, la comptine @emph{Girls and boys
+come out to play}.
+
+@lilypond[verbatim,quote]
+\relative c'' {
+ \key g \major
+ \time 6/8
+ d4 b8 c4 a8 d4 b8 g4
+}
+@end lilypond
+
+Des @notation{paroles} peuvent être associées à ces notes, en les
+combinant avec la commande @code{\addlyrics}. On entre les paroles en
+séparant chaque syllable par un espace :
+
+@lilypond[verbatim,quote]
+<<
+ \relative c'' {
+ \key g \major
+ \time 6/8
+ d4 b8 c4 a8 d4 b8 g4
+ }
+ \addlyrics {
+ Girls and boys come out to play,
+ }
>>
@end lilypond
-Plus d'informations sur le formatage de la musique pour piano sont
-données à @ref{Piano music}.
+Remarquez les accolades embrassant la musique et celles embrassant les
+paroles, ainsi que les angles doubles encadrant toute la pièce ; ces
+derniers indiquent simplement que la musique et les paroles se
+produisent en même temps.
-@node Organizing larger pieces
-@section Organizing larger pieces
+@node Aligning lyrics to a melody
+@subsection Aligning lyrics to a melody
-Lorsqu'on combine tous les éléments étudiés plus haut pour produire
-des fichiers plus volumineux, les blocs @code{\score} deviennent
-beaucoup plus gros parce que les expressions musicales sont plus
-longues et, dans le cas des pièces polyphoniques, profondément
-imbriquées. De telles expressions imposantes finissent par devenir peu
-maniables.
+@cindex mélisme
+@cindex ligne d'extension
+@cindex trait d'union (paroles)
+@cindex caractère souligné (paroles)
+@cindex paroles, alignement des
+@cindex alignement des paroles
+@cindex paroles, mot de plusieurs syllabes
-En utilisant des variables, appelées également identificateurs, il est
-possible de découper des expressions musicales complexes. Un identificateur
-se définit comme
+Glossaire musical : @rglos{melisma}, @rglos{extender line}.
+
+La ligne suivante de la comptine précédente est @emph{The moon doth
+shine as bright as day}. Ajoutons-la au code.
+
+@lilypond[verbatim,quote]
+<<
+ \relative c'' {
+ \key g \major
+ \time 6/8
+ d4 b8 c4 a8 d4 b8 g4
+ g8 a4 b8 c b a d4 b8 g4.
+ }
+ \addlyrics {
+ Girls and boys come out to play,
+ The moon doth shine as bright as day;
+ }
+>>
+@end lilypond
+
+Remarquez que les paroles ajoutées ne s'alignent pas bien avec les
+notes. Le mot @emph{shine} devrait être chanté sur deux notes au lieu
+d'une. On appelle ceci un @notation{mélisme} : il s'agit d'une seule
+syllabe chantée sur plus d'une note. Il existe plusieurs façons
+d'étaler une sylabe sur plusieurs notes, la plus simple étant de lier
+les notes du mélisme. Pour les détails, consultez @ref{Ties and
+slurs}.
+
+@lilypond[verbatim,quote]
+<<
+ \relative c'' {
+ \key g \major
+ \time 6/8
+ d4 b8 c4 a8 d4 b8 g4
+ g8 a4 b8 c( b) a d4 b8 g4.
+ }
+ \addlyrics {
+ Girls and boys come out to play,
+ The moon doth shine as bright as day;
+ }
+>>
+@end lilypond
+
+Les paroles sont maintenant correctement alignées, mais les liens de
+croche automatiques ne conviennent pas pour les notes au-dessus de
+@emph{shine as}. On peut les corriger en ajoutant des liens de croche
+manuels, pour ceci consultez @ref{Automatic and manual beams}.
+
+@lilypond[verbatim,quote]
+<<
+ \relative c'' {
+ \key g \major
+ \time 6/8
+ d4 b8 c4 a8 d4 b8 g4
+ g8 a4 b8 c([ b]) a d4 b8 g4.
+ }
+ \addlyrics {
+ Girls and boys come out to play,
+ The moon doth shine as bright as day;
+ }
+>>
+@end lilypond
+
+Au lieu d'utiliser une liaison, on peut indiquer le mélisme dans les
+paroles en insérant un caractère souligné @code{_} pour chaque note du
+mélisme sauf la première.
+
+@lilypond[verbatim,quote]
+<<
+ \relative c'' {
+ \key g \major
+ \time 6/8
+ d4 b8 c4 a8 d4 b8 g4
+ g8 a4 b8 c[ b] a d4 b8 g4.
+ }
+ \addlyrics {
+ Girls and boys come out to play,
+ The moon doth shine _ as bright as day;
+ }
+>>
+@end lilypond
+
+Si une syllabe s'étend sur un grand nombre de notes ou une note très
+longue, on représente souvent le mélisme par un @notation{trait de
+prolongation}, qu'on entre avec @code{__}. L'exemple suivant montre
+les trois premières mesures de la plainte de Didon, extraite de
+@emph{Didon et Énée} de Purcell.
+
+@lilypond[verbatim,quote]
+<<
+ \relative c'' {
+ \key g \minor
+ \time 3/2
+ g2 a bes bes( a)
+ b c4.( bes8 a4. g8 fis4.) g8 fis1
+ }
+ \addlyrics {
+ When I am laid,
+ am laid __ in earth,
+ }
+>>
+@end lilypond
+
+Aucun exemple jusqu'à présent n'a utilisé de mots de plus d'une
+syllabe. Dans des paroles, de tels mots sont écrits en syllabes
+séparées par des traits d'union. Avec LilyPond, on utilise deux
+tirets pour produire un trait d'union centré entre deux syllabes.
+L'exemple suivant montre tout ce que nous avons vu jusqu'à maintenant
+sur l'alignement de paroles à une mélodie.
+
+@c no ragged-right here because otherwise the hyphens get lost,
+@c but the example is long enough to avoid looking strange.
+@lilypond[verbatim,quote,noragged-right]
+<<
+ \relative c' {
+ \key g \major
+ \time 3/4
+ \partial 4
+ d4 g4 g a8( b) g4 g4
+ b8( c) d4 d e4 c2
+ }
+ \addlyrics {
+ A -- way in a __ man -- ger,
+ no __ crib for a bed, __
+ }
+>>
+@end lilypond
+
+Avec certaines paroles, en particulier en italien, il se produit la
+situation inverse : il peut y avoir plusieurs syllabes sur une seule
+note. On réalise ceci avec LilyPond grâce à un caractère souligné
+@code{_} sans espace entre les syllabes, ou alors en groupant les
+syllabes avec des guillemets. L'exemple suivant est extrait de l'air
+de Figaro @emph{Largo al factotum}, dans @emph{Figaro} de Rossini, où
+la syllabe @emph{al} est chantée sur la même note que @emph{go}.
+
+@c no ragged-right here because otherwise the hyphens get lost,
+@c but the example is long enough to avoid looking strange.
+@lilypond[verbatim,quote,noragged-right]
+<<
+ \relative c' {
+ \clef bass
+ \key c \major
+ \time 6/8
+ c4.~ c8 d b c([ d]) b c d b c
+ }
+ \addlyrics {
+ Lar -- go_al fac -- to -- tum del -- la cit -- tà
+ }
+>>
+@end lilypond
+
+
+@seealso
+Manuel de notation : @ruser{Vocal music}.
+
+
+@node Lyrics to multiple staves
+@subsection Lyrics to multiple staves
+
+@cindex paroles et portées mutiples
+@cindex portées multiples et paroles
+
+La méthode simple d'ajout de paroles avec @code{\addlyrics} peut être
+également utilisée pour placer des paroles sous plusieurs portées.
+L'exemple suivant est extrait de @emph{Judas Macchabée} de Händel.
+
+@lilypond[verbatim,quote]
+<<
+ \relative c'' {
+ \key f \major
+ \time 6/8
+ \partial 8
+ c8 c([ bes]) a a([ g]) f f'4. b, c4.~ c4
+ }
+ \addlyrics {
+ Let flee -- cy flocks the hills a -- dorn, __
+ }
+ \relative c' {
+ \key f \major
+ \time 6/8
+ \partial 8
+ r8 r4. r4 c8 a'([ g]) f f([ e]) d e([ d]) c bes'4
+ }
+ \addlyrics {
+ Let flee -- cy flocks the hills a -- dorn,
+ }
+>>
+@end lilypond
+
+Pour produire des partitions plus complexes ou plus longues que cet
+exemple simple, il est vivement conseillé de séparer la structure de
+la partition des notes et paroles, grâce à des variables. Ceci sera
+détaillé plus loin dans @ref{Organizing pieces with variables}.
+
+
+@seealso
+Manuel de notation : @ruser{Vocal music}.
+
+
+@node Final touches
+@section Final touches
+
+L'ultime section de ce tutoriel montre comment ajouter une touche
+finale à des morceaux simples, et constitue une introduction au reste
+du manuel.
+
+@menu
+* Organizing pieces with variables::
+* Version number::
+* Adding titles::
+* Absolute note names::
+* After the tutorial::
+@end menu
+
+
+@node Organizing pieces with variables
+@subsection Organizing pieces with variables
+
+@cindex variables
+@cindex variables, definition
+@cindex identificateurs
+@cindex macros
+@cindex assignation de variables
+@cindex utilisation de variables
+@cindex variables, utilisation de
+@cindex variables, caractères autorisés dans les
+@cindex caractères autorisés dans les variables
+
+Lorsque l'on combine tous les éléments étudiés précédemment pour
+écrire des partitions plus longues, les expressions musicales prennent
+de l'ampleur et, dans le cas des pièces polyphoniques, deviennent
+profondément imbriquées, jusqu'au point où il devient difficile de se
+repérer dans le fichier source. Cet inconvénient peut être résolu par
+l'utilisation de @emph{variables}.
+
+En utilisant des variables, parfois appelées identificateurs ou
+macros, on peut scinder des expressions musicales complexes en des
+expressions plus simples. Une variable se définit comme suit :
@example
-MusiqueToto = @{ @dots{} @}
+musiqueToto = @{ @dots{} @}
@end example
-@noindent
-Le contenu de l'expression musicale @code{MusiqueToto}, peut être
-utilisé plus loin en faisant précéder son nom d'un anti-slash, c'est-à-dire
-@code{\MusiqueToto}. Dans l'exemple suivant, un motif de deux notes est
-répété deux fois en utilisant la substitution par une variable :
-
-@lilypond[quote,ragged-right,verbatim,nofragment]
-seufzer = {
- e'4( dis'4)
+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}, tout comme n'importe quelle commande
+LilyPond. Toute variable doit être définie @emph{avant} son
+utilisation dans une autre expression musicale.
+
+@lilypond[verbatim,quote]
+violin = \new Staff {
+ \relative c'' {
+ a4 b c b
+ }
+}
+cello = \new Staff {
+ \relative c {
+ \clef bass
+ e2 d
+ }
+}
+{
+ <<
+ \violin
+ \cello
+ >>
}
-{ \seufzer \seufzer }
@end lilypond
-Le nom d'un identificateur ne doit comporter que des caractères
-alphabétiques non accentués, aucun nombre ni tiret. On doit le définir
-en dehors de toute expression musicale.
+@noindent
+Le nom d'une variable ne doit comporter que des caractères
+alphabétiques non accentués, aucun nombre ni tiret ne sont autorisés.
+
+On peut utiliser une variable déjà définie autant de fois que l'on
+veut, y compris dans la définition d'une nouvelle variable ; par
+exemple, cela peut servir à saisir un motif qu'une seule fois, même
+s'il se répète un grand nombre de fois dans la pièce.
-Il est possible d'utiliser des variables de types variés.
-Par exemple,
+@lilypond[verbatim,quote]
+tripletA = \times 2/3 { c,8 e g }
+barA = { \tripletA \tripletA \tripletA \tripletA }
+
+\relative c'' {
+ \barA \barA
+}
+@end lilypond
+
+Il est possible d'utiliser des variables de types variés. Par exemple,
@example
-largeur = 4.5\cm
-nom = "Wendy"
-papierACinq = \paper @{ paperheight = 21.0 \cm @}
+width = 4.5\cm
+name = "Wendy"
+aFivePaper = \paper @{ paperheight = 21.0 \cm @}
@end example
-En fonction de son contenu, l'identificateur peut être utilisé à différents
-endroits. L'exemple suivant utilise la variable précédente :
+En fonction de son contenu, un identificateur peut être utilisé à
+différents endroits. L'exemple suivant utilise les variable définies
+ci-dessus.
@example
\paper @{
- \papierACinq
- line-width = \largeur
+ \aFivePaper
+ line-width = \width
@}
-@{ c4^\nom @}
+@{ c4^\name @}
@end example
-Vous trouverez plus d'informations sur les usages possibles des
-identificateurs dans le manuel technique, section
-@ref{Input variables and Scheme}.
-@c fixme: the ref is too technical.
+@node Version number
+@subsection Version number
-@node An orchestral part
-@section An orchestral part
+@cindex version
+@cindex versionage
+@cindex numéro de version
+@cindex version, numéro de
+@cindex mise à jour
+@cindex future mise à jour
+@cindex mise à jour de fichiers
+@cindex fichiers, mise à jour de
-Pour la musique d'orchestre, toute la musique est imprimée deux fois.
-Une partie séparée pour chaque pupitre, et un conducteur pour le chef.
-Recourir à des identifiants permet de s'épargner un double travail. La
-musique est entrée une seule fois, et enregistrée dans une variable. Le
-contenu de ces variables sera utilisé pour générer à la fois la
-partie d'instrument et le conducteur.
+@funindex \version
+@funindex version
+@funindex convert-ly
-Définir les notes dans un fichier à part est très pratique. Par
-exemple, supposons que le fichier @file{musique-cor.ly} contienne la
-partie d'un duo cor/@/basson :
+La déclaration @code{\version} stipule le numéro de la version de
+LilyPond pour laquelle le fichier a été écrit :
@example
-notesCor = \relative c @{
- \time 2/4
- r4 f8 a cis4 f e d
-@}
+\version @w{"@version{}"}
@end example
@noindent
-Puis, une partie individuelle est créée en mettant ce qui suit dans
-un fichier
+Par convention, on place cette instruction en début de fichier.
+
+Cette instruction permet de faciliter les mises à jour futures de
+LilyPond. Les changements de syntaxe au fil des versions sont gérés
+avec un programme dédié, @command{convert-ly}, qui utilise la valeur
+de @code{\version} pour déterminer les règles de conversion à
+appliquer au fichier source. Pour plus d'informations, consultez
+@rprogram{Updating files with convert-ly}.
+
+
+@node Adding titles
+@subsection Adding titles
+
+@cindex titre
+@cindex en-têtes
+@cindex bloc d'en-tête
+
+@funindex \header
+@funindex header
+
+On indique les informations bibliographiques --- nom du morceau, du
+compositeur, numéro d'opus@dots{} --- dans un bloc à part, le bloc
+d'en-tête @code{\header}, qui existe indépendamment de l'expression
+musicale principale. Le bloc @code{\header} est habituellement placé
+en début de fichier, après le numéro de version.
@example
-\include "musique-cor.ly"
+\version @w{"@version{}"}
\header @{
- instrument = "Cor en fa"
+ title = "Symphonie"
+ composer = "Moi"
+ opus = "Op. 9"
@}
@{
- \transpose f c' \notesCor
+ @dots{} la musique @dots{}
@}
@end example
-La ligne
+Quand LilyPond traite le fichier, le titre et le compositeur sont
+imprimés au début de la partition. Vous trouverez plus d'informations
+sur les titres à la section @ruser{Creating titles}.
-@example
-\include "musique-cor.ly"
-@end example
-@noindent
-indique à LilyPond de lire le contenu de @file{musique-cor.ly} à cet
-endroit dans le fichier, ainsi @code{notesCor} est défini pour ce qui
-suivra. La commande @code{\transpose f@tie{}c'} indique que
-l'argument, en l'occurence @code{\notesCor}, doit être transposé d'une
-quinte ascendante. Le son entendu @samp{fa} correspond à la note écrite
-@code{do'}, ce qui correspond bien à la transpostion d'un cor en
-fa. La transposition peut être constatée dans la sortie suivante :
-
-@lilypond[quote,ragged-right]
-\transpose f c' \relative c {
- \time 2/4
- r4 f8 a cis4 f e d
-}
-@end lilypond
-
-Dans la musique d'ensemble, il arrive souvent qu'une des voix ne joue
-pas pendant plusieurs mesures. Ceci est spécifié par un silence
-spécial, le silence multi-mesures (mesures à compter). Il est saisi
-par une lettre capitale @samp{R} suivie d'une durée (@code{1}@tie{}pour une
-ronde, @code{2}@tie{}pour une blanche, etc.). En multipliant la durée, on
-peut construire des silences plus longs. Par exemple, ce silence dure
-3@tie{}mesures à 2/4
-
-@example
-R2*3
-@end example
+@node Absolute note names
+@subsection Absolute note names
-Pour l'impression de parties séparées, ces silences multi-mesures doivent être
-condensés. On peut l'obtenir en réglant une variable d'exécution
+@cindex notes, nom des
+@cindex absolu, mode
+@cindex mode absolu
+@cindex hauteurs, valeurs absolues
+@cindex noms de note absolus
-@example
-\set Score.skipBars = ##t
-@end example
+Jusqu'ici nous n'avons utilisé que le mode @code{\relative} pour
+définir les hauteurs de notes. Si c'est souvent le moyen le plus
+simple de saisir la musique au clavier, il existe une autre façon de
+procéder : le mode de hauteurs absolues.
-@noindent
-Cette commande règle la propriété @code{skipBars} dans le contexte
-@code{Score} à vrai (@code{##t}). En faisant précéder la musique plus haut
-du silence et de cette option, on obtient
+Si vous omettez la commande @code{\relative}, LilyPond considérera
+toutes les hauteurs comme des hauteurs absolues. Un @code{c'} désigne
+toujours le do central, un @code{b} se situe une seconde en dessous
+du do central, et un @code{g,} est situé sur la première ligne de
+la portée en clé de fa.
-@lilypond[quote,ragged-right]
-\transpose f c' \relative c {
- \time 2/4
- \set Score.skipBars = ##t
- R2*3
- r4 f8 a cis4 f e d
+@lilypond[verbatim,quote]
+{
+ \clef bass
+ c' b g, g,
+ g, f, f c'
}
@end lilypond
+Voici une gamme sur 4 octaves :
-On crée le conducteur en combinant toutes les parties. En
-supposant que l'autre voix soit dans l'expression @code{notesBasson} du fichier
-@file{musique-basson.ly}, le conducteur est composé des commandes
+@lilypond[verbatim,quote]
+{
+ \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
-@example
-\include "musique-cor.ly"
-\include "musique-basson.ly"
+Comme vous pouvez le voir, il faut beaucoup d'apostrophes pour écrire
+de la musique dans un registre aigu, comme le montre cet extrait de
+Mozart.
-<<
- \new Staff \notesCor
- \new Staff \notesBasson
->>
-@end example
+@lilypond[verbatim,quote]
+{
+ \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
-@noindent
-donnant pour résultat
+Toutes ces apostrophes rendent le fichier moins lisible, et surtout il
+est très probable d'oublier au moins une apostrophe au cours de la
+frappe. En mode @code{\relative}, le même exemple devient bien plus
+facile à lire et à saisir.
-@lilypond[quote,ragged-right]
-\relative c <<
- \new Staff {
- \time 2/4 R2*3
- r4 f8 a cis4 f e d
- }
- \new Staff {
- \clef bass
- r4 d,8 f | gis4 c | b bes |
- a8 e f4 | g d | gis f
- }
->>
+@lilypond[verbatim,quote]
+\relative c'' {
+ \key a \major
+ \time 6/8
+ cis8. d16 cis8 e4 e8
+ b8. cis16 b8 d4 d8
+}
@end lilypond
-De plus amples informations sur la gestion des parties et conducteurs
-se trouvent dans le manuel de notation, section @ref{Orchestral music}.
+Si d'aventure vous faites une erreur d'octaviation, le mode
+@code{\relative} la mettra en évidence : toutes les notes suivantes
+seront placées à la mauvaise octave. En mode de hauteurs absolues,
+une erreur isolée ne serait pas autant visible, et serait donc plus
+difficile à dénicher.
-Le réglage des variables d'exécution (« propriétés ») est abordé dans
-@ref{Changing context properties on the fly}.
+Cependant, le mode de hauteurs absolues reste utile pour les musiques
+où les intervalles sont étendus, et plus encore pour les fichiers
+LilyPond créés par des programmes.
@node After the tutorial
-@section 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{Example
-templates}) et ajoutez-y des notes. Si vous voulez employer une notation que
-vous n'avez pas trouvé dans le tutoriel, consultez la référence de
-notation, en commençant par la @ref{Basic notation}. Si vous désirez écrire pour un
-ensemble instrumental non couvert par les @ref{Example templates},
-lisez la section @ref{Extending the templates}.
+Après avoir parcouru ce tutoriel, vous devriez essayer d'écrire un
+morceau ou deux. Commencez par copier l'un des modèles types et
+ajoutez-y des notes --- consultez les @ref{Templates}. Si vous voulez
+employer une notation que vous n'avez pas trouvé dans le tutoriel,
+consultez le manuel de notation, en commençant par la @ruser{Musical
+notation}. Si vous désirez écrire pour un ensemble instrumental non
+couvert par les modèles, 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.
-
+du manuel d'initiation. Rien ne s'oppose à ce que vous consultiez dès
+à présent ces chapitres, bien sûr ! Néanmoins, le reste du manuel
+d'initiation part du principe que vous avez déjà bien assimilé la
+syntaxe de base de LilyPond. Vous pouvez toujours survoler ces
+chapitres 3 à 5, et y revenir plus tard après avoir acquis de
+l'expérience.
+
+Dans ce tutoriel comme dans le reste de ce manuel, se trouve à chaque
+section un paragraphe @strong{Voir aussi} contenant des références
+vers d'autres sections : il est conseillé de ne pas les suivre en
+première lecture ; lorsque vous aurez lu l'ensemble du manuel
+d'initiation, vous pourrez en relisant certaines sections suivre ces
+références pour approfondir certains aspects.
+
+Si vous ne l'avez pas encore fait, lisez @ref{About the
+documentation}. Les sources de documentation et d'information sur
+LilyPond sont vastes, il est normal pour un débutant de ne pas savoir
+où chercher ; si vous passez quelques minutes à lire attentivement
+cette section, vous vous épargnerez certainement la frustration causée
+par des heures de recherches infructueuses.
projects / lilypond.git / blobdiff