@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
@c This file is part of lilypond.tely
-
+@ignore
+ Translation of GIT committish: 71b67137f76fa4e8aede58299630369f616004d9
+
+ When revising a translation, copy the HEAD committish of the
+ version that you are working on. See TRANSLATION for details.
+@end ignore
+
+@ignore
+Tutorial guidelines:
+- unless you have a really good reason, use either
+ @l ilypond[quote,ragged-right,verbatim]
+ or
+ @l ilypond[quote,ragged-right,verbatim,fragment,relative=2]
+ (without spaces)
+ Don't use any other relative=X commands (make it a non-fragment
+ example), and don't use fragment without relative=2.
+- use "aes" and "ees" instead of "as" and "aes". I know it's not
+ correct Dutch naming, but let's not confuse people with this until
+ we get to the Basic notation chapter.
+@end ignore
+
+
+
+@c old info that will probably be removed.
@c TODO:
@c * more details about running lilypond; error messages,
@c compiling/viewing (emacs?)
@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
+
+
+@node Tutorial
@chapter Tutorial
-Ce tutoriel commence par une courte introduction au langage d'écriture
-de la musique avec LilyPond. Après ce premier contact, nous verrons
-comment produire une partition à imprimer. Vous serez alors capable de
-créer et d'imprimer vos propres partitions.
+Ce tutoriel commence par une introduction au langage musical utilisé
+par LilyPond, qui vous permettra de faire fonctionner le logiciel pour
+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 jouant avec. Ceci est également possible avec LilyPond. Si
+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 que nous avons utilisé pour
-générer cette image.
-Essayez sur cette image
+verrez exactement le code LilyPond utilisé pour générer cette image.
+Essayez sur cette image :
-@lilypond[fragment,quote,ragged-right,relative=2]
-c-\markup { \bold \huge { Cliquer ici. } }
+@c no verbatim here
+@c KEEP LY
+@lilypond[quote,ragged-right]
+\relative c'' {
+ c-\markup { \bold \huge { Cliquez ici. } }
+}
@end lilypond
-@end ifhtml
-En coupant et en collant l'itégralité du code dans un fichier test, vous aurez
-un modèle pour démarrer les expérimentations. Si vous apprenez de cette
-façon, vous aurez probablement envie d'imprimer ou de créer un lien
-vers
-@ifhtml
-la
+En copiant et en collant tout le code de l'extrait ly dans un fichier
+test, vous aurez un modèle de base pour faire vos expériences. Si vous
+apprenez de cette façon, vous aurez probablement envie d'imprimer ou de
+garder un lien vers l'@ruser{Cheat sheet}, tableau qui répertorie les
+commandes usuelles pour une consultation rapide.
@end ifhtml
-@ref{Cheat sheet}, tableau qui répertorie les commandes usuelles
-et constitue une référence rapide.
@menu
-* First steps::
-* Running LilyPond for the first time::
-* 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::
+* First steps::
+* Single staff notation::
+* Multiple notes at once::
+* Songs::
+* Final touches::
@end menu
@node First steps
@section First steps
-Le premier exemple montre comment écrire la partition la plus
-élémentaire qui soit, une gamme (@rglos{scale}). Une @rglos{note} peut
-être entrée en tapant son nom, de @samp{a} à @samp{g}. Donc si vous entrez
-
-@example
-@{
-c d e f g a b
-@}
-@end example
-
-@noindent
-le résultat ressemblera à
-
-@lilypond[fragment,quote,notime,relative=1]
-c d e f g a b
-@end lilypond
-
-@footnote{NdT : il est aussi possible d'utiliser les noms
-de notes do re mi fa sol la si, en insérant au début du fichier
-@samp{\include "catalan.ly"}}
-
-Toue partie de code LilyPond doit être entouré d'une @{paire
-d'accolades@}. Bien que la plupart des exemples de ce manuel n'en
-comportent pas, ne les oubliez pas dans vos compositions !
-
-De plus, de nombreux exemples utilisent les mode @code{relative}. Ceci
-est expliqué à la section @ref{Octave entry} ; sachez dès à présent
-que certains exemples devraient être libellés sous la forme
-@code{\relative @{ @emph{...musique...} @}}.
-De nombreux exemples ont aussi été « raccourcis » pour économiser la
-place, grace à la commande @code{\paper @{ ragged-right = ##t @}}.
-
-@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.
-
-La valeur (@rglos{duration}) d'une note est spécifiée par un nombre
-qui suit le nom de cette note. @samp{1} pour une ronde (@rglos{whole
-note}), @samp{2} pour une blanche (@rglos{half note}), @samp{4} pour
-une noire (@rglos{quarter note}) et ainsi de suite.
-
-@example
-a1 a2 a4 a16 a32
-@end example
-
-@lilypond[fragment,quote,notime,relative=2]
-\set Staff.autoBeaming = ##f
-{ a1 a2 a4 a16 a32 s16_" " }
-@end lilypond
-
-Si aucune durée n'est spécifiée, la dernière entrée est utilisée pour les
-notes suivantes. La valeur par défaut de la première note d'une partition
-est la noire.
-
-@example
-a a8 a a2 a
-@end example
-
-@lilypond[fragment,quote,notime,relative=2]
-{ a a8 a a2 a s16_" " }
-@end lilypond
-
-
-Un silence (@rglos{rest}) se saisi tout comme une note, mais avec le
-caractère @samp{r}.
-
-@example
-r2 r4 r8 r16
-@end example
-
-@lilypond[fragment,quote,notime]
-r2 r4 r8 r16 s16_" "
-@end lilypond
+Cette section présente sommairement la façon de travailler avec LilyPond.
-Ajouter un point @samp{.} après une durée permet d'obtenir une note
-pointée (@rglos{dotted note}).
+@menu
+* Compiling a file::
+* Simple notation::
+* Working on text files::
+* How to read the tutorial::
+@end menu
-@example
-a2. a4 a8. a16
-@end example
-@lilypond[fragment,quote,notime,relative=1]
-{ a2. a4 a8. a16 s16_" " }
-@end lilypond
+@node Compiling a file
+@subsection Compiling a file
-Le chiffrage de la mesure (@rglos{time signature}) peut se définir à
-l'aide de la commande @code{\time}.
+Le premier exemple montre comment débuter avec LilyPond. Pour créer
+une partition, on écrit un fichier de texte qui décrit la notation
+musicale. Par exemple, si l'on écrit
@example
-\time 3/4
-\time 6/8
-\time 4/4
+@{
+ c' e' g' e'
+@}
@end example
-@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_" "
-@end lilypond
-
-La @rglos{clef} peut être réglée avec la commande @code{\clef}.
-
-@example
-\clef treble
-\clef bass
-\clef alto
-\clef tenor
-@end example
+@noindent
+le résultat ressemblera à
-@lilypond[fragment,quote,notime]
-\clef treble
-s4_" "
-\clef bass
-s4_" "
-\clef alto
-s4_" "
-\clef tenor
-s16_" "
+@c in this case we don't want verbatim
+@lilypond[quote,ragged-right]
+{
+ c' e' g' e'
+}
@end lilypond
-Pensez bien à encadrer les notes et commandes avec des accolades
-@code{@{@tie{}@dots{}@tie{}@}} pour pouvoir obtenir un résultat imprimable.
+@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 "italiano.ly"}
+@c END DIV
-@c @li @lilypond[fragment,quote,noindent,linewidth=55\staffspace]
-@lilypond[fragment,quote,noindent,verbatim]
-\time 3/4
-\clef bass
-c2 e4 g2.
-f4 e d c2 r4
-@end lilypond
+@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 !
-Pour plus d'informations sur
+@cindex casse, prise en compte de
+De plus, LilyPond est sensible à la casse. @code{ @{ c d e @} } est
+un code valide ; @code{ @{ C D E @} } produira un message d'erreur.
-@quotation
-@table @asis
-@item Définir des hauteurs et des durées
-voir
-@ref{Pitches}, et @ref{Durations}.
-@item les clefs
-see @ref{Clef}.
-@item les silences
-see @ref{Rests}.
-@item les chiffrages de mesure et autres commandes liées au temps
-see @ref{Time signature}.
-@end table
-@end quotation
+@sp 1
+@subheading Entering music and viewing output
-@node Running LilyPond for the first time
-@section Running LilyPond for the first time
+Dans cette section nous expliquerons quelles commandes exécuter et
+comment voir ou imprimer le résultat de LilyPond.
-@c cheesy title to avoid clash with chapter name.
+@subsubheading MacOS X
-Dans la section précédente, nous avons vu quelles sortes d'éléments
-peut contenir un fichier LilyPond. Dans cette section nous
-expliquerons quelles commandes exécuter et comment voir ou imprimer le
-résultat de LilyPond. Si vous n'avez jamais utilisé
-LilyPond, voulez tester votre installation ou souhaitez exécuter
-vous-même un fichier d'exemple, lisez cette section.
+Si vous double-cliquez sur @code{LilyPond.app}, un fichier d'exemple
+s'ouvrira. Sauvegardez-le, par exemple, sous @file{test.ly} sur votre
+bureau, et traitez-le ensuite avec la commande du menu @samp{Compile >
+Typeset File}. Le fichier PDF résultant sera alors affiché sur votre
+écran.
-@unnumberedsubsec MacOS X
+Notez que le premier démarrage peut prendre une minute ou deux, car
+toutes les polices système doivent être d'abord analysées.
-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 affiché sur votre écran.
+À l'avenir, vous aurez certainement recours aux commandes @qq{Nouveau}
+ou @qq{Ouvrir}. Vous devez enregistrer votre fichier avant de lancer
+la création de la partition. Si une erreur advient pendant le
+traitement, vous la trouverez dans la fenêtre @qq{log}.
-Prenez note que le premier démarrage prend une minute ou deux
-car toutes les polices systèmes doivent être d'abord analysées.
+@subsubheading Windows
-@unnumberedsubsec Windows
+Sous Windows, lorsque vous double-cliquez sur l'icône LilyPond qui se
+trouve sur le Bureau, un fichier d'exemple s'ouvre dans un simple
+éditeur de texte. Enregistrez-le, par exemple en tant que
+@file{test.ly} sur votre Bureau, puis double-cliquez sur son icône
+(qui montre une note de musique) pour le traiter. Après quelques
+secondes, vous obtiendrez un fichier @file{test.pdf} sur votre Bureau,
+fichier que vous pourrez ouvrir pour voir la partition imprimée. Une
+autre méthode pour lancer le traitement du fichier @file{test.ly} est
+de le glisser avec votre souris sur l'icône de LilyPond.
-Sous Windows, démarrez un éditeur de texte @footnote{N'importe quel
-éditeur simple ou orienté programmation fera l'affaire, comme
-Notepad. N'utilisez pas de traitement de texte car ceux-ci insèrent
-des codes de formatage qui posent problème à LilyPond.} et entrez
+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}.
-@verbatim
-@{ c'4 e' g' @}
-@end verbatim
+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, c'est ce
+fichier qu'il vous faudra étudier.
-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.
+Notez qu'il existe d'autres éditeurs de texte, certains disposant d'un
+meilleur support pour LilyPond ; reportez-vous à @rprogram{Text editor support}.
+@subsubheading Unix
-@unnumberedsubsec Unix
-Commencez par ouvrir une fenêtre de terminal et lancez un éditeur de
-texte. Par exemple, vous pouvez ouvrir un xterm et exécuter
-@code{joe}. @footnote{Des fichiers de macros pour les fans de VIM et un
-@code{LilyPond-mode} pour les fans d'Emacs existent. S'ils ne sont pas
-encore installés, consultez le fichier @file{INSTALL.txt}.} Dans votre
+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{Il existe des fichiers de macros pour les fans
+de VIM et un
+@code{LilyPond-mode} pour les fans d'Emacs. S'ils ne sont pas
+encore installés, consultez le fichier @file{INSTALL.txt}. L'outil
+d'édition le plus facile d'utilisation est de loin
+@file{LilyPondTool}. Vous trouverez plus d'informations dans
+@rprogram{Text editor support}.} Dans votre
éditeur, entrez le texte suivant et sauvegardez le fichier sous
@file{test.ly}
@verbatim
-@{ c'4 e' g' @}
+{
+ c' e' g' e'
+}
@end verbatim
@noindent
-Pour traiter @file{test.ly}, procédez comme ceci :
+Pour traiter @file{test.ly}, procédez comme ceci :
@example
lilypond test.ly
@end example
@noindent
-Vous verrez quelque chose ressemblant à :
+Vous verrez quelque chose ressemblant à :
@example
lilypond test.ly
GNU LilyPond 2.10.0
Processing `test.ly'
Parsing...
-Interpreting music... [1]
+Interpreting music... [1]
Preprocessing graphical objects...
-Calculating line breaks... [2]
+Calculating line breaks... [2]
Layout output to `test.ps'...
Converting to `test.pdf'...
@end example
-@cindex DVI file
-@cindex Viewing music
-@cindex xdvi
+@c DIV specific
+Suivant votre installation, ces messages peuvent être traduits.
+@c END DIV
+
+@cindex fichier PDF
+@cindex visionnage de la musique
+
@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
+De tout cela résulte un 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.}
-
-@footnote{NdT : suivant votre installation, les messages
-peuvent être traduits.}
+programme pour afficher et imprimer librement les fichiers PDF et PostScript.}
-@node More about pitches
-@section More about pitches
-Un dièse (@rglos{sharp}) s'obtient en ajoutant @samp{is} au nom
-de la note, un bémol (@rglos{flat}) en ajoutant @samp{es}. Comme
-vous pouvez vous y attendre, un double dièse ou double bémol est
-obtenu en ajoutant @samp{isis} ou @samp{eses}@footnote{Cette syntaxe
-est dérivée de la convention de dénomination des notes dans les langues
-nordiques et germaniques, comme l'allemand ou le hollandais.}.
-@footnote{NdT : si vous utilisez la commande décrite plus haut
-pour utiliser do ré mi à la place des lettres, il faudra ajouter un
-@samp{d} pour un dièse, et un @samp{b} pour un bèmol. Le double dièse
-et le double bémol s'obtiennent en ajoutant respectivement @samp{dd} et @samp{bb}}
+@node Simple notation
+@subsection Simple notation
-@example
-cis1 ees fisis aeses
-@end example
+Il y a certains éléments graphiques que LilyPond ajoute
+automatiquement. Dans l'exemple suivant, nous n'avons fourni que
+quatre hauteurs, mais LilyPond a ajouté une clé, un chiffre de mesure
+et du rythme.
-@lilypond[fragment,quote,notime]
-\set Score.timing = ##f
-\transpose c c' { cis1 ees fisis aeses s16_" " }
+@lilypond[quote,ragged-right,verbatim]
+{
+ c' e' g' e'
+}
@end lilypond
-@cindex key signature, setting
-L'armure est déterminée par la commande @code{\key}, suivie d'une
-hauteur et de @code{\major} (majeur) ou @code{\minor} (mineur).
+@noindent
+Ce comportement peut être modifié, mais dans bien des cas ces
+attributions automatiques s'avèrent utiles.
-@example
-\key d \major
-g1
-\key c \minor
-g
-@end example
-@lilypond[fragment,quote,notime,fragment]
-\key d \major
-g'1
-\key c \minor
-g'
+@subheading Pitches
+Le moyen le plus simple d'entrer des notes est d'utiliser le mode
+@code{\relative}. Avec ce mode, l'@rglos{interval} entre la note et
+celle qui la précède est supposé inférieur ou égal à une
+@rglos{fourth}. Commençons par entrer la partition la plus
+élémentaire qui soit, une @rglos{scale}.
+
+@lilypond[quote,ragged-right,verbatim]
+\relative c' {
+ c d e f
+ g a b c
+}
@end lilypond
-@noindent
-Les armures fixées par des hauteurs (y compris les altérations)
-permettent de déterminer quand afficher les altérations
-accidentelles. Cette fonctionnalité est souvent source
-de confusion pour les nouveaux utilisateurs, aussi expliquons la
-plus en détails.
-
-
-LilyPond fait une distinction entre le contenu musical et la mise
-en page. L'altération (bémol, bécarre ou dièse) d'une note fait
-partie de sa hauteur, et donc du contenu musical. La présence d'une
-altération accidentelle (un @emph{signe} bémol, bécarre ou dièse) devant
-la note correspondante est question de mise en page. La mise
-en page est quelque chose qui obéit à des règles ; les signes
-accidentels sont donc automatiquement imprimés suivant ces règles. Les
-hauteurs de note contenues dans votre musique font partie des éléments
-artistiques, et les altérations ne sont pas ajoutées automatiquement,
-même si vous devez entrer ce que vous voulez entendre.
-
-Dans cet exemple :
-
-@lilypond[quote,notime,fragment]
-\key d \major
-d' cis' fis'
+La note de départ est @rglos{middle C}. Chacune des notes qui suivent
+est à moins d'une quarte de la note précédente --- en d'autres termes,
+le premier @samp{c} est le do central, entre la clé de sol et
+la clé de fa, puis est suivi par le ré le plus proche, et ainsi de
+suite. On peut bien sûr créer des mélodies d'intervalles plus étendus :
+
+@lilypond[quote,ragged-right,verbatim]
+\relative c' {
+ d f a g
+ c b f d
+}
@end lilypond
@noindent
-si aucune note n'a une altération accidentelle explicite, vous devez
-cependant les entrer :
+Comme vous l'aurez remarqué, cet exemple ne commence plus sur le do du
+milieu. La première note --- le @samp{d} --- est le ré qui en est le
+plus proche.
-@example
-\key d \major
-d cis fis
-@end example
+Pour ajouter des intervalles supérieurs à une quarte, il suffit
+d'indiquer si la note est à l'octave supérieure ou inférieure, en
+ajoutant respectivement une apostrophe @code{'} ou une virgule
+@code{,} au nom de la note.
-@noindent
-Le code @samp{d} ne veut pas dire « imprimer un point noir sur la
-portée. » Cela signifie plutôt : « une note ayant la hauteur ré
-naturel. »
-Avec l'armure en la bémol majeur, il y aura un signe accidentel.
-
-@lilypond[quote,notime,fragment,relative=1,verbatim]
-\key as \major
-d
+@lilypond[quote,ragged-right,verbatim]
+\relative c'' {
+ a a, c' f,
+ g g'' a,, f'
+}
@end lilypond
-Ajouter explicitement toutes les altérations requiert un peu plus
-d'effort en cours de saisie, mais l'avantage est que la transposition
-sera facilitée. De plus les signes accidentels peuvent être imprimés suivant
-plusieurs conventions. Regardez @ref{Automatic accidentals} pour
-d'autres exemples sur la manière dont les signes accidentels peuvent
-être imprimés suivant différentes règles.
+@noindent
+Pour déplacer une note deux octaves (ou davantage !) plus haut ou plus
+bas, il suffit de mettre plusieurs @code{''} ou plusieurs @code{,,} ---
+attention cependant à bien mettre deux apostrophes @code{''}, et non
+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'}.
-Pour plus d'informations sur
+@subheading Durations (rhythms)
-@quotation
-@table @asis
-@item les altérations accidentelles
-voir @ref{Automatic accidentals}.
+La @rglos{duration} d'une note est indiquée par un nombre
+qui suit son nom : @samp{1} pour une @rglos{whole
+note}, @samp{2} pour une @rglos{half note}, @samp{4} pour
+une @rglos{quarter note} et ainsi de suite. Les hampes sont
+ajoutées automatiquement.
-@item les armures
-voir @ref{Key signature}.
-@end table
-@end quotation
+@lilypond[quote,ragged-right,verbatim]
+\relative c'' {
+ a1
+ a2 a4 a8 a
+ a16 a a a a32 a a a a64 a a a a a a a a2
+}
+@end lilypond
-@node Entering ties
-@section Entering ties
+@noindent
+Si aucune durée n'est indiquée, la dernière durée entrée sera utilisée
+pour les notes suivantes. En l'absence d'indication, la première note
+est une noire.
-@cindex tie
-Une liaison entre deux notes de même hauteur (@rglos{tie}) est créée
-en ajoutant un tilde @samp{~} à la suite de la première note à être liée.
+Une @rglos{dotted note} s'obtient en ajoutant un point @samp{.} à
+la valeur rythmique.
-@lilypond[quote,notime,fragment,verbatim,relative=3]
-g4~ g a2~ a4
+@lilypond[quote,ragged-right,verbatim]
+\relative c'' {
+ a a a4. a8
+ a8. a16 a a8. a8 a4.
+}
@end lilypond
-Pour plus d'informations sur les liaisons de durées, voir @ref{Ties}.
+@subheading Rests
+On saisit un @rglos{rest} tout comme une note, mais avec le
+caractère @samp{r}.
-@node Automatic and manual beams
-@section Automatic and manual beams
+@lilypond[quote,ragged-right,verbatim]
+\relative c'' {
+ a r r2
+ r8 a r4 r4. r8
+}
+@end lilypond
-@cindex beams, by hand
-Toutes les ligatures (@rglos{beam}), ou liens de croches, sont dessinées
-automatiquement.
-@lilypond[quote,fragment,relative=2,verbatim]
-a8 ais d es r d
-@end lilypond
+@subheading Time signature
-@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{]}.
+La @rglos{time signature} peut être définie à l'aide de la commande
+@code{\time} :
-@lilypond[quote,fragment,relative=2,verbatim]
-a8[ ais] d[ es r d]
+@lilypond[quote,ragged-right,verbatim]
+\relative c'' {
+ \time 3/4
+ a4 a a
+ \time 6/8
+ a4. a
+ \time 4/4
+ a4 a a a
+}
@end lilypond
-Pour plus d'informations sur les liens de croches, voir @ref{Manual beams}.
+@subheading Clef
-Voici comment se comportent armures, altérations accidentelles et
-liaisons :
+La @rglos{clef} peut être définie à l'aide de la commande @code{\clef} :
-@lilypond[fragment,quote,noindent,line-width=50\staffspace,verbatim]
-\relative c'' {
- \time 4/4
- \key g \minor
+@lilypond[quote,ragged-right,verbatim]
+\relative c' {
\clef treble
- r4 r8 a8 gis4 b
- a8 d4.~ d e,8
- fis4 fis8 fis8 eis4 a8 gis~
- gis2 r2
+ c1
+ \clef alto
+ c1
+ \clef tenor
+ c1
+ \clef bass
+ c1
}
@end lilypond
-@cindex accidentals
+@subheading All together
-@noindent
-Il y a plusieurs points intéressants à noter dans cet exemple. Les
-barres de mesure et les liens de croches sont dessinés automatiquement.
-Les sauts de ligne sont calculés automatiquement ; peu importe où ils
-se situent dans le fichier source. Enfin, l'ordre dans lequel
-l'indicateur de mesure, l'armure et les changements de clefs sont
-saisis n'a pas d'importance ; dans la sortie imprimable, ils sont
-organisés suivant les conventions standard de notation.
+Voici un bref exemple qui montre tous ces éléments ensemble :
+@lilypond[quote,ragged-right,verbatim]
+\relative c, {
+ \time 3/4
+ \clef bass
+ c2 e8 c' g'2.
+ f4 e d c4 c, r4
+}
+@end lilypond
+@seealso
+@quotation
+@table @asis
+@item Entrer des hauteurs et des durées
+voir @ruser{Pitches} and @ruser{Durations}.
+@item Les silences
+voir @ruser{Rests}.
+@item Les chiffres de mesure et autres commandes de métrique
+voir @ruser{Time signature}.
+@item Les clés
+voir @ruser{Clef}.
+@end table
+@end quotation
-@node Octave entry
-@section Octave entry
+@node Working on text files
+@subsection Working on text files
-@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...
+Le traitement des fichiers source de LilyPond est semblable à celui du
+code de nombreux langages de programmation répandus : la casse est prise
+en compte, et les caractères considérés comme espaces ont généralement
+peu d'importance. Les expressions sont délimitées par des accolades @{
+@}, et les commentaires par @code{%} ou @code{%@{ ... %@}}.
-@c better to have this just before the `octaves are bad' snipped
-@c but we'd need to remove the ', from \key and tie
-Pour hausser une note d'une octave, ajoutez lui une apostrophe
-@code{'} ; pour la baisser d'une octave, ajoutez lui une virgule
-@code{,}. Le do entre la clef de sol et la clef de fa est @code{c'}.
+Si cette phrase vous paraît incompréhensible, ne vous en faites pas !
+Tous ces termes vont être expliqués :
-@lilypond[quote,notime,fragment,verbatim]
-c'4 c'' c''' \clef bass c c,
-@end lilypond
+@itemize
-Un exemple de l'utilisation des apostrophes dans ce fragment de Mozart
+@cindex casse, prise en compte de
+@item @strong{La casse} :
+LilyPond est sensible à la casse, c'est à dire qu'une lettre capitale
+n'a pas la même valeur qu'une lettre minuscule. Les notes, par
+exemple, doivent être entrées en minuscules : @code{@{ c d e @}} est
+un code valide, alors que @code{@{ C D E @}} produira un message
+d'erreur.
-@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
-@end lilypond
+@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
-Cet exemple montre qu'il faut beaucoup d'apostrophes pour écrire de
-la musique dans un registre aigu. Ceci rend le fichier moins
-lisible, et c'est une source d'erreurs. La solution consiste à utiliser
-les « octaves relatives ». C'est la façon la plus commode pour copier de
-la musique existante.
+Bien sûr, ce dernier exemple est difficile à lire. Une bonne habitude
+à prendre est d'indenter les blocs de code avec soit des tabulations
+soit des doubles espaces :
+@example
+@{
+ c d e
+@}
+@end example
-En mode relatif, une note sans signe d'octavation (c'est à dire @code{'} ou
-@code{,} après la note) est interprétée de manière à ce qu'elle soit la
-plus proche de la note précédente. Par exemple, @samp{c f} monte, alors
-que @samp{c g} descend.
+@item @strong{Expressions musicales} :
+Tout morceau saisi dans LilyPond doit être placé entre @strong{@{
+accolades @}}. Ces caractères indiquent à LilyPond que ce bloc de
+texte est une et une seule expression musicale, tout comme les
+parenthèses @samp{()} en mathématiques. Il est préférable, pour
+éviter toute ambiguïté, d'entourer tous ces crochets d'espaces, à
+moins qu'ils se trouvent au début ou à la fin d'une ligne.
+
+Une fonction --- @code{\relative @{ @}} par exemple --- compte
+également comme une seule expression musicale.
+
+@cindex commentaires
+@cindex commentaire de fin de ligne
+@cindex commentaire-bloc
+@item @strong{Les commentaires} :
+Un commentaire est une indication pour tout lecteur humain d'un
+fichier de musique ; il est ignoré par l'ordinateur, et n'a donc aucun
+effet sur la partition imprimée. On distingue deux types de
+commentaires :
+@itemize @bullet
+@item la ligne de commentaire, introduite par le symbole @samp{%} :
+tout ce qui suit ce symbole sur cette ligne sera ignoré.
+@item le bloc de commentaire, qui peut être de plusieurs lignes voire
+de toute une section : tout ce qui se trouve entre @code{%@{} et
+@code{%@}} est ignoré. Les blocs de commentaires ne peuvent s'imbriquer.
+@end itemize
+Le fragment suivant met en évidence quelques usages possibles des commentaires :
-Pour utiliser le mode relatif, ajouter @code{\relative} avant la pièce de
-musique.
-La première note est choisie relativement en fonction du do medium
-@c no , for this sentence
-(cad. @code{c'}).
+@example
+% voici les notes de "ah vous dirai-je maman"
+ c4 c g' g a a g2
+%@{
+ Ces lignes et les notes qui suivent
+ seront ignorées, car elles se trouvent
+ dans un bloc de commentaire.
+ g g f f e e d d c2
+%@}
+@end example
-@lilypond[quote,notime,fragment,verbatim]
-\relative {
- c' f c g c
-}
-@end lilypond
+@end itemize
+Vous trouverez plus d'astuces pour organiser vos fichiers LilyPond dans
+@ruser{Suggestions for writing LilyPond files}.
-Puisque la plupart de la musique utilise de petits intervalles, les pièces
-peuvent être écrites en mode relatif, sans pratiquement utiliser de signes
-d'octavation. L'exemple précédent est entré comme ceci :
-@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
+@node How to read the tutorial
+@subsection How to read the tutorial
-@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 sont faits en ajoutant les signes d'octavation.
+Comme nous l'avons vu dans @ruser{Working on text files}, un code
+LilyPond doit être encadré par des @{ @} ou bien par @code{\relative
+c'' @{ ... @}} afin d'être compris. Cependant, dans la suite de ce
+manuel, la plupart des exemples ne feront pas apparaître ces signes.
-@lilypond[quote,notime,verbatim,fragment]
-\relative c {
- c'' f, f c' c g' c,
-}
-@end lilypond
+Si vous consultez la documentation au format HTML, et que vous
+souhaitez voir la source exacte d'un exemple, il vous suffit de
+cliquer sur l'image. Si vous ne disposez pas de la version HTML, il
+vous est possible de simplement copier et coller le code affiché, mais
+@strong{à condition} d'ajouter @code{\relative c'' @{ @}} de la façon
+suivante :
-En résumé, apostrophes et virgules ne déterminent pas la
-hauteur absolue d'une note dans le mode @code{\relative}. La hauteur de la
-note est relative à la précédente, et modifier l'octave d'une seule
-note changera l'octave des suivantes.
+@example
+\relative c'' @{
+ ... collez ici votre exemple...
+@}
+@end example
-Pour plus d'information sur les octaves relatives, voir @ref{Relative
-octaves}, et @ref{Octave check}.
+Pourquoi avoir omis les accolades ? La plupart des exemples de ce
+manuel peuvent être insérés au milieu d'un morceau de musique plus
+long. Il n'y a donc aucune raison d'ajouter @code{\relative c'' @{
+@}} à ces exemples --- en effet, il n'est pas possible d'insérer un
+@code{\relative} à l'intérieur d'un autre @code{\relative}. Il vous
+serait donc devenu impossible de copier un bref exemple de la
+documentation et de le coller dans une pièce de votre cru.
+@node Single staff notation
+@section Single staff notation
-@node Music expressions explained
-@section Music expressions explained
+Cette section présente la notation courante dont on a besoin pour
+écrire une seule voix sur une seule portée.
+@menu
+* Relative note names::
+* Accidentals and key signatures::
+* Ties and slurs::
+* Articulation and dynamics::
+* Automatic and manual beams::
+* Advanced rhythmic commands::
+@end menu
-Dans les fichiers LilyPond, la musique est représentée par ce qu'on
-appelle des @emph{expressions musicales}. Nous en avons déjà vu dans
-les quelques exemples précédents ; une seule note constitue une
-expression musicale.
-@lilypond[fragment,quote,verbatim,relative=3]
-a4
-@end lilypond
+@node Relative note names
+@subsection Relative note names
-Mettre un groupe de notes entre accolades crée une nouvelle expression
-musicale.
+Comme nous l'avons vu dans @ruser{Simple notation}, LilyPond calcule la
+hauteur de chaque note en fonction de la précédente@footnote{Il existe
+un autre mode de saisie des hauteurs, le mode @ruser{Absolute note
+names}, mais en pratique il est bien plus aisé et sûr d'avoir recours
+au mode de hauteurs relatives.}. Si aucune indication supplémentaire
+d'octaviation n'est ajoutée, il en concluera que chaque hauteur est
+située à une quarte au plus de la note précédente.
-@lilypond[fragment,quote,verbatim,relative=3]
-{ a4 g4 }
+Lilypond tient compte des intervalles induits par les noms des notes
+--- en d'autres termes, une quarte augmentée n'est @emph{pas}
+équivalente à une quinte diminuée. Ainsi, si l'on part d'un Do, un Fa
+dièse sera placé au-dessus, tandis qu'un Sol bémol sera placé
+au-dessous.
+
+@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+c2 fis
+c2 ges
@end lilypond
-Placer un groupe d'expressions musicales (ex: des notes) entre accolades
-signifie qu'elles doivent être jouées en une seule phrase. Le résultat
-est une expression, qui peut être regroupé avec d'autres expressions
-séquentiellement. Ici, l'expression de l'expemple précédent est
-combiné à deux notes :
+@seealso
+@quotation
+@table @asis
+@item Les hauteurs de note relatives
+voir @ruser{Relative octaves}.
+@item Les vérifications d'octaves
+voir @ruser{Octave check}.
+@end table
+@end quotation
-@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
-combinons les expressions en parallèle. Deux voix qui doivent être
-jouées en même temps, sont entrées comme une combinaison simultanée de
-deux phrases. Une expression musicale « simultanée » est formée en
-entourant les expressions entre @code{<<} et @code{>>}. Dans l'exemple
-suivant, trois phrases (contenant chacune deux notes séparées) sont
-combinées simultanément.
-@lilypond[fragment,quote,verbatim,relative=3]
-<<
- { a4 g }
- { f e }
- { d b }
->>
-@end lilypond
+@node Accidentals and key signatures
+@subsection Accidentals and key signatures
-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 arbitrairement des expressions
-complexes et importantes. Par exemple,
+@subheading Accidentals
-@example
-1
+Dans la notation par défaut, un @rglos{sharp} s'obtient en ajoutant
+@samp{is} au nom de la note, et un @rglos{flat} en ajoutant @samp{es}.
+Comme vous pouvez vous y attendre, un double dièse ou double bémol est
+alors obtenu en ajoutant @samp{isis} ou @samp{eses}@footnote{Cette
+syntaxe est dérivée de la convention de dénomination des notes dans
+les langues nordiques et germaniques, comme l'allemand ou le
+hollandais.}.
-1 + 2
+@c DIV specific
+Cependant, si vous utilisez la commande @samp{\include "italiano.ly"}
+pour entrer les noms de notes français au lieu des noms hollandais, il
+faudra ajouter un @samp{d} pour un dièse, et un @samp{b} pour un
+bémol. Le double dièse et le double bémol s'obtiennent en ajoutant
+respectivement @samp{dd} et @samp{bb}
+@c END DIV
-(1 + 2) * 3
+Pour en savoir plus sur les autres langues disponibles, voir @ruser{Note
+names in other languages}.
-((1 + 2) * 3) / (4 * 5)
-@end example
+@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+cis1 ees fisis, aeses
+@end lilypond
-@cindex expression
-@cindex music expression
-Ceci est une suite d'expressions, où chacune est contenue dans la
-suivante. Les expressions les plus simples sont les nombres, et les plus
-conséquentes sont faites en combinant des expressions avec des
-opérateurs (comme @samp{+}, @samp{*} et @samp{/}) et des
-parenthèses. Tout comme les expressions mathématiques, les expressions
-musicales peuvent être profondément imbriquées, ce qui est nécessaire
-pour de la musique complexe comme des partitions polyphoniques.
-
-Notez que cet exemple ne comporte qu'une seule portée, contrairement à
-l'exemple précédent qui contenait trois portées séparées. C'est parce que
-l'exemple commence par une note seule. Pour déterminer le nombre de
-portées, LilyPond regarde le premier élément. Si c'est une seule note, il
-y a une portée ; en cas d'expressions simultanées, il y aura
-plus d'une portée.
-
-@lilypond[fragment,quote,verbatim,relative=2]
-{
- c <<c e>>
- << { e f } { c <<b d>> } >>
-}
+@cindex armure, définition de
+@subheading Key signatures
+
+L'armure est déterminée par la commande @code{\key}, suivie d'une
+hauteur puis de @code{\major} (majeur) ou @code{\minor} (mineur) :
+
+@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+\key d \major
+a1
+\key c \minor
+a
@end lilypond
-On s'y perd souvent avec des fichiers musicaux comprenant de nombreuses
-imbrications, tant pour leur création que pour leur maintenance. Une
-convention permet d'éviter cette confusion : l'indentation. Pour
-entrer un fichier avec de nombreux emboîtements d'accolades et de
-crochets, il est d'usage d'avoir recours à une indentation qui indique
-le niveau de profondeur. Formatter la musique de telle manière en
-facilite la lecture et vous aide à insérer le bon nombre de caractère
-ferment une expression. Par exemple,
+@sp 1
+
+@subheading Warning: key signatures and pitches
+
+La combinaison de l'armure et des hauteurs de note --- y compris les
+altérations --- permet à LilyPond de déterminer dans quel cas afficher
+les altérations accidentelles. L'armure n'affecte que les altérations
+@emph{imprimées}, et non les hauteurs réelles ! Cette fonctionnalité
+est souvent source de confusion pour les nouveaux utilisateurs, aussi
+expliquons-la en détail.
+
+LilyPond fait une nette distinction entre le contenu musical et la
+mise en forme. L'altération d'une note --- bémol, bécarre ou dièse
+--- fait partie de sa hauteur, et relève donc du contenu musical. La
+présence ou non d'une altération accidentelle --- un @emph{signe}
+bémol, bécarre ou dièse --- devant la note correspondante est une
+question qui relève de la mise en page. Mettre en page une partition
+se fait selon des règles ; les altérations accidentelles seront donc
+automatiquement imprimées suivant ces règles. Les hauteurs de note,
+en revanche, relèvent de ce que vous voulez entendre ; et, dans la
+mesure où la musique que vous entrez est censée être celle que vous
+voulez entendre, LilyPond (qui n'est chargé que de la gravure) ne les
+choisira pas à votre place.
+
+Dans cet exemple,
+
+@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+\key d \major
+d cis fis
+@end lilypond
-@example
-<<
- @{
- @dots{}
- @}
- @{
- @dots{}
- @}
->>
-@end example
+@noindent
+aucune note n'a d'altération accidentelle, et pourtant vous devrez
+entrer le @samp{is} pour les notes @code{cis} et @code{fis}.
+
+Le code @samp{d} ne veut pas dire @qq{Imprimez-moi un point noir juste
+en-dessous de la portée.} Cela signifie plutôt : @qq{Ici se trouve
+une note dont la
+hauteur est un ré naturel.} Avec l'armure de la bémol majeur, ce ré
+sera flanqué
+d'un bécarre accidentel :
+
+@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+\key aes \major
+e
+@end lilypond
-Certains éditeurs disposent d'un mode spécifique pour taper des
-fichiers LilyPond qui peut aider à l'indentation du fichier source.
-Voir la section @ref{Editor support} pour plus d'informations.
+Ajouter explicitement toutes les altérations requiert un peu plus
+d'effort dans la phase de saisie, mais la transposition en sera
+grandement facilitée.
+De plus les altérations accidentelles
+peuvent être imprimées suivant plusieurs conventions. Regardez
+@ruser{Automatic accidentals} pour connaître les différentes manières dont les
+altérations accidentelles peuvent être imprimées, suivant les règles
+que vous choisirez.
+
+@seealso
+@quotation
+@table @asis
+@item Les altérations
+voir @ruser{Accidentals} and @ruser{Automatic accidentals}.
+@item Les armures
+voir @ruser{Key signature}.
+@end table
+@end quotation
-@node More staves
-@section More staves
-Pour imprimer plus d'une portée, chaque partie de la musique faisant
-l'objet d'une portée distincte est entrée en la faisant précéder de
-@code{\new Staff}. Ces éléments @code{Staff} sont combinés en parallèle avec
-@code{<<} et @code{>>} comme ci-dessous :
+@node Ties and slurs
+@subsection Ties and slurs
-@lilypond[quote,fragment,verbatim]
-<<
- \new Staff { \clef treble c'' }
- \new Staff { \clef bass c }
->>
-@end lilypond
+@cindex liaisons de prolongation
+@subheading Ties
+Une @rglos{tie}@footnote{parfois aussi appelée liaison de
+tenue} se crée en ajoutant un tilde @samp{~} à la première note liée.
+@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+g4~ g c2~
+c4 ~ c8 a8 ~ a2
+@end lilypond
-La commande @code{\new} introduit un « contexte de notation.» Un contexte
-de notation est un environnement dans lequel les évènements musicaux
-(comme les notes ou les commandes @code{\clef}) sont interprétés.
-Pour des pièces simples, ces contectes sont créés automatiquement. Pour
-des œuvres plus complexes, il est préférable de marquer les contextes
-explicitement. Cela assure que chaque fragment aura sa propre portée.
+@cindex liaisons d'articulation
+@subheading Slurs
-Il existe différents types de contextes. Portée (@code{Staff}), Voix
-(@code{Voice}) et partition (@code{Score}) gèreent la notation de la
-mélodie, alors que @code{Lyrics} gère les paroles et @code{ChordNames}
-imprime le nom des accords.
+@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é.
-En matière de syntaxe, faire précéder une expression musicale de
-@code{\new} crée une plus grosse expression musicale. Pour conserver la
-comparaison, cela ressemble au « moins » en mathématiques. La formule
-@math{(4+5)} est une expression, donc @math{-(4+5)} est une plus grosse
-expression.
+Une @rglos{slur} d'articulation (ou @qq{legato}) peut englober
+plusieurs notes. Les notes de départ et d'arrivée reçoivent
+respectivement un signe @samp{(} et @samp{)}.
-Nous pouvons maintenant écrire une mélodie à deux portées.
+@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+d4( c16) cis( d e c cis d) e( d4)
+@end lilypond
-@c TODO: (c) status of this Paul McCartney (?) song (let's all stand together)
+@cindex liaisons de phrasé
+@subheading Phrasing slurs
-@lilypond[fragment,quote,verbatim,ragged-right]
-\relative <<
- \new Staff {
- \time 3/4
- \clef treble
+De plus longues liaisons, dites de phrasé, sont délimitées par @code{\(} et
+@code{\)}. Il est possible d'avoir en même temps des legatos et des
+phrasés, mais pas plusieurs liaisons de phrasé ou de legato à la fois.
- 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[quote,ragged-right,verbatim,fragment,relative=2]
+a8(\( ais b c) cis2 b'2 a4 cis,\)
@end lilypond
-Pour plus d'informations sur les contextes voir leur description dans
-@ref{Interpretation contexts}.
+@sp 1
+
+@cindex liaisons de phrasé et de prolongation, différences
+@subheading Warnings: slurs vs. ties
+Une liaison d'articulation ou de phrasé ressemble à une liaison de
+tenue, mais n'a pas la même signification. Alors qu'une liaison de
+tenue ne peut relier que deux notes de même hauteur, le legato indique
+une articulation de plusieurs notes, éventuellement nombreuses. Les
+liaisons de tenue peuvent être enchâssées dans un legato ou un phrasé.
+
+@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+c2~( c8 fis fis4 ~ fis2 g2)
+@end lilypond
+
+@seealso
+@quotation
+@table @asis
+@item @ruser{Ties},
+@item @ruser{Slurs},
+@item @ruser{Phrasing slurs}.
+@end table
+@end quotation
-@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 accents standards peuvent être ajoutés à une note en utilisant un tiret
-(@samp{-}) et un caractère.
+Des @rglos{articulation}s peuvent être ajoutées à une note, au moyen
+d'un tiret @samp{-} suivi d'un caractère :
-@lilypond[fragment,quote,verbatim,relative=2]
-c-. c-- c-> c-^ c-+ c-_
+@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+c-. c-- c-> c-^ c-+ c-_
@end lilypond
-@cindex fingering
-De la même manière, les indications de doigté peuvent être ajoutées à
-une note en utilisant un tiret (@samp{-}) et le chiffre à écrire.
+@cindex doigtés
+@subheading Fingerings
+De même, des indications de doigté peuvent être ajoutées à une note en
+utilisant un tiret (@samp{-}) et le chiffre à écrire :
-@lilypond[fragment,quote,verbatim,relative=2]
+@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
c-3 e-5 b-2 a-1
@end lilypond
Articulations et doigtés sont habituellement placés automatiquement,
-mais vous pouvez spécifier l'emplacement en utilisant @samp{^} (en haut)
-ou @samp{_} (en bas). Vous pouvez aussi utiliser plusieurs articulations
-sur la même note. Dans la plupart des cas, cependant, il est mieux de
-laisser LilyPond déterminer l'emplacement de l'articulation.
+mais vous pouvez spécifier une direction en utilisant @samp{^} (en haut)
+ou @samp{_} (en bas). Vous pouvez aussi utiliser plusieurs
+articulations sur la même note. Dans la plupart des cas, cependant, il
+est mieux de laisser LilyPond déterminer l'emplacement de
+l'articulation.
-@lilypond[fragment,quote,verbatim,relative=2]
+@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
c_-^1 d^. f^4_2-> e^-_+
@end lilypond
+@subheading Dynamics
Les signes de nuances sont obtenus en ajoutant à la note les noms des nuances,
-précédées d'un anti-slash (@samp{\}).
+précédées d'un anti-slash @samp{\} :
-@lilypond[fragment,quote,verbatim,relative=2]
-c\ff c\mf
+@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+c\ff c\mf c\p c\pp
@end lilypond
-@cindex dynamics
+@cindex nuances
@cindex decrescendo
@cindex crescendo
+@c Pluriel des termes musicaux italiens :
+@c selon Littré, plutôt à la française (en "-os" qu'en "-i")
+
Crescendos et decrescendos débutent avec les commandes @code{\<} et
-@code{\>}. Une nuance d'arrivée, par exemple @code{\f}, va finir le
-(de)crescendo. La commande @code{\!} peut aussi être utilisée pour la
-terminaison.
-Crescendi and decrescendi are started with the commands @code{\<} and
-@code{\>}. An ending dynamic, for example @code{\f}, will finish the
-(de)crescendo, or the command @code{\!} can be used
-
-@lilypond[fragment,quote,verbatim,relative=2]
+@code{\>}. Ils se terminent soit par une nuance d'arrivée, par exemple
+@code{\f}, soit par la commande @code{\!} :
+
+@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
c2\< c2\ff\> c2 c2\!
@end lilypond
+@seealso
+@quotation
+@table @asis
+@item @ruser{Articulations}.
+@item @ruser{Fingering instructions}.
+@item @ruser{Dynamics}.
+@end table
+@end quotation
-@cindex slur
-
-Une liaison d'articulation (@rglos{slur}) est une courbe tendue
-au-dessus de plusieurs notes. Elle indique un jeu legato. La note de
-départ et celle d'arrivée sont marquées respectivement par @samp{(} et
-@samp{)}.
-
-@lilypond[fragment,quote,fragment,relative=2,verbatim]
-d4( c16) cis( d e c cis d) e( d4)
-@end lilypond
+@node Automatic and manual beams
+@subsection Automatic and manual beams
-@cindex slurs versus ties
-Une liaison d'atriculation ressemble à une liaison de prolongation
-(@rglos{tie}), mais signifie signifie autre chose. Une liaison de
-prolongation fait durer la première note plus longtemps, et ne peut
-être utilisée que sur deux notes de même hauteur. Ces deux types de
-liaison peuvent être imbriqués.
+@cindex ligatures manuelles
+Toutes les @rglos{beam} sont dessinées automatiquement :
-@lilypond[quote,fragment,relative=2]
-c2~( c8 fis fis4 ~ fis2 g2)
+@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+a8 ais d ees r d c16 b a8
@end lilypond
-@cindex phrasing slurs
-Une liaison de phrasé peut être entrée avec @code{\(} et @code{\)},
-vous pouvez donc avoir simultanément des liaisons d'articulation et des
-liaisons de phrasé. Vous ne pouvez pas avoir simultanément plusieurs
-liaisons d'articulation ou simultanément plusieurs liaisons de phrasés.
+@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 @samp{[} et la dernière d'un @samp{]}.
-@lilypond[quote,fragment,relative=2,verbatim]
-a8(\( ais b c) cis2 b'2 a4 cis, c\)
+@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+a8[ ais] d[ ees r d] a b
@end lilypond
-
-Pour plus d'informations sur les
-
+@seealso
@quotation
@table @asis
-@item Doigtés
-voir @ref{Fingering instructions}.
-@item Articulations
-voir @ref{Articulations}.
-@item Liaisons
-voir @ref{Slurs}.
-@item Liaisons de phrasé
-voir @ref{Phrasing slurs}.
-@item Nuances
-voir @ref{Dynamics}.
+@item Groupements de notes et ligatures automatiques
+voir @ruser{Automatic beams}.
+@item Groupements et ligatures manuels
+voir @ruser{Manual beams}.
@end table
@end quotation
-@node Combining notes into chords
-@section Combining notes into chords
+@node Advanced rhythmic commands
+@subsection Advanced rhythmic commands
-@cindex chords
-Les accords peuvent être créés en entourant les notes avec les symboles
-@samp{<} et @samp{>}.
+@cindex levée
+@cindex anacrouse
+@cindex mesure incomplète
+@subheading Partial measure
-@lilypond[quote,relative=1,fragment,verbatim]
-r4 <c e g>4 <c f a>8
-@end lilypond
+Une levée (ou @rglos{anacrusis}) est entrée avec la commande
+@code{\partial}, suivie d'une durée : @code{\partial 4} est une levée
+d'une noire et @code{\partial 8} d'une croche.
+@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+\partial 8
+f8 c2 d
+@end lilypond
-Vous pouvez combiner les indications comme les liaisons et les liens de
-croches avec les accords. Ils doivent cependant être placés en
-dehors des symboles @samp{<} et @samp{>}
+@cindex nolets
+@cindex triolets
+@subheading Tuplets
+Les nolets sont créés avec la commande @code{\times}, qui prend deux
+arguments : une fraction et une expression musicale. La durée des notes
+de l'expression musicale est multipliée par la fraction. Par exemple
+les notes d'un triolet durent les deux tiers du temps de leur notation
+réelle, cette fraction est donc de 2/3 pour les triolets :
-@lilypond[quote,relative=1,fragment,verbatim]
-r4 <c e g>8[ <c f a>]~ <c f a>
+@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+\times 2/3 { f8 g a }
+\times 2/3 { c r c }
+\times 2/3 { f,8 g16[ a g a] }
+\times 2/3 { d4 a8 }
@end lilypond
-@example
-r4 <c e g>8\>( <c e g> <c e g> <c f a>\!)
-@end example
+@cindex notes d'ornement
+@cindex ornementation
+@cindex appoggiature
+@subheading Grace notes
-@lilypond[quote,relative=1,fragment]
-\slurUp
-r4 <c e g>8\>( <c e g> <c e g> <c f a>\!)
-@end lilypond
-
-
-@node Advanced rhythmic commands
-@section Advanced rhythmic commands
-
-@cindex pickup
-@cindex anacruse
-@cindex partial measure
-Une levée est entrée avec le mot-clef @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.
-
-@lilypond[quote,relative=2,verbatim,fragment]
-\partial 8
-f8 c2 d e
-@end lilypond
-
-@cindex tuplets
-@cindex triplets
-Les n-olets sont créés avec le mot-clef @code{\times}. Il prend deux
-arguments : une fraction et une de la musique. La durée de la partie
-musique est multipliée par la fraction. Les triolets ne prennent que
-2/3 du temps de leur notation réelle, cette fraction est donc de 2/3
-pour les triolets.
+Des notes d'ornement sont produites par la commande @code{\grace}, mais
+aussi en préfixant une expression musicale avec le mot-clé
+@code{\appoggiatura} ou @code{\acciaccatura} :
-@lilypond[quote,relative=1,verbatim,fragment]
-\times 2/3 { f8 g a }
-\times 2/3 { c r c }
-@end lilypond
-
-@cindex grace notes
-@cindex acciaccatura
-Les notes d'ornement sont aussi créées en préfixant une expression musicale
-avec le mot-clef @code{\appoggiatura} ou @code{\acciaccatura}.
-@cindex appoggiatura
-@cindex acciaccatura
-
-@lilypond[quote,relative=2,verbatim,fragment]
-c4 \appoggiatura b16 c4
-c4 \acciaccatura b16 c4
+@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+c2 \grace { a32[ b] } c2
+c2 \appoggiatura b16 c2
+c2 \acciaccatura b16 c2
@end lilypond
-@noindent
-
-Pour plus d'informations sur les
-
+@seealso
@quotation
@table @asis
-@item Ornementations
-voir @ref{Grace notes},
-@item N-olets
-voir @ref{Tuplets},
-@item Mesures partielles
-voir @ref{Partial measures}.
+@item Notes d'ornement
+voir @ruser{Grace notes},
+@item nolets
+voir @ruser{Tuplets},
+@item levées
+voir @ruser{Partial measures}.
@end table
@end quotation
-@node Commenting input files
-@section Commenting input files
+@node Multiple notes at once
+@section Multiple notes at once
-@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'aura donc
-aucun effet sur la sortie imprimable. Il existe deux types
-de commentaires. Le symbole pourcent @samp{%} introduit un commentaire
-d'une ligne ; après @code{%}, le reste de la ligne est ignoré. Un bloc de
-commentaire marque une section entière dans le fichier d'entrée. Tout ce
-qui est à l'intérieur de @code{%@{} et @code{%@}} est ignoré. Le fragment
-suivant montre les utilisations possible des commentaires.
+Cette section traite des situations où l'on a plus d'une note à la fois
+: plusieurs instruments, plusieurs portées pour un même instrument (le
+piano, par exemple), et les accords.
-@example
-% mélodie de "ah vous dirais-je maman"
- c4 c g' g a a g2
+La polyphonie, en théorie musicale, est la notion d'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.
-%@{
- Cette ligne, et les notes ci-dessous
- sont ignorées, puisque'elles sont dans
- un bloc de commentaire.
-
- g g f f e e d d c2
-%@}
-@end example
+@menu
+* Music expressions explained::
+* Multiple staves::
+* Piano staves::
+* Combining notes into chords::
+* Single staff polyphony::
+@end menu
-@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.
-@cindex versioning
+@node Music expressions explained
+@subsection Music expressions explained
-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
+Dans les fichiers source LilyPond, la musique est représentée par ce
+qu'on appelle des @emph{expressions musicales}. En soi, une seule note
+peut constituer une expression musicale, si tant est qu'elle soit
+correctement encadrée :
-@example
-\version "2.10.0"
-@end example
-
-@noindent
-Ces annotations permettent de faciliter les prochaines mises à jour de
-LilyPond. Les changements dans la syntaxe sont gérés avec un
-programme spécial, @file{convert-ly} (voir @ref{Updating files with
-convert-ly}), et il utilise @code{\version} pour déterminer les
-règles de conversion à appliquer au fichier.
+@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+a4
+@end lilypond
+Mettre un groupe de notes entre accolades crée une nouvelle expression
+musicale :
-@node Printing lyrics
-@section Printing lyrics
-@cindex lyrics
+@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+{ a4 g4 }
+@end lilypond
-@c TODO: (c) status of the Queen fragment.
+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 :
-@cindex Lyrics
-@cindex Songs
-Les paroles sont entrées en séparant chaque syllable par un espace.
+@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+{ { a4 g } f g }
+@end lilypond
-@example
-I want to break free
-@end example
+@subheading Simultaneous music expressions: multiple staves
-Voyons la mélodie
+Cette technique est utile pour de la musique polyphonique. Pour entrer
+une musique avec plusieurs voix ou plusieurs portées, nous pouvons aussi
+combiner en parallèle les expressions. Deux voix qui doivent être
+jouées en même temps, sont entrées comme une combinaison simultanée de
+deux expressions. Une expression musicale @q{simultanée} est formée en
+entourant les expressions entre @code{<<} et @code{>>}. Dans l'exemple
+suivant, trois expressions (contenant chacune deux notes distinctes)
+sont combinées simultanément.
-@lilypond[quote,verbatim,fragment,ragged-right]
-\relative {
- r4 c \times 2/3 { f g g }
- \times 2/3 { g4( a2) }
+@lilypond[quote,ragged-right,verbatim]
+\relative c'' {
+ <<
+ { a4 g }
+ { f e }
+ { d b }
+ >>
}
@end lilypond
-Les paroles peuvent être accolées à ces notes en les combinant avec le
-mot-clef @code{\addlyrics}
+Notez que nous avons ici indenté chaque niveau du fichier d'entrée avec
+un nombre d'espaces différent. LilyPond se moque de l'espace qu'il peut
+y avoir (ou pas) au début d'une ligne, mais en indentant votre code vous
+le rendrez bien plus facile à lire pour les humains.
-@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 }
->>
-@end lilypond
+@strong{Attention} : chaque note saisie est relative à la précédente,
+mais pas au @code{c''} de la commande @code{\relative} de départ.
-@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
-@example
-@{ I want to break free __ @}
-@end example
+@subheading Simultaneous music expressions: single staff
-@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 __ }
->>
+Pour déterminer le nombre de portées, LilyPond regarde le premier
+élément autre qu'une accolade. Si c'est une seule note, il y a une
+portée ; si c'est une expression simultanée, il y aura plus d'une
+portée.
+
+@lilypond[quote,ragged-right,verbatim]
+\relative c'' {
+ c2 <<c e>>
+ << { e f } { c <<b d>> } >>
+}
@end lilypond
-De la même manière, les séparations syllabiques d'un mot peuvent être entrées
-avec deux tirets (@code{-}), ce qui produit un tiret centré entre les deux
-syllabes.
+@cindex expression
+@cindex expression musicale
+@subheading Analogy: mathematical expressions
+
+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
-A -- le gri -- a
-@end example
+1
-@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 }
->>
-@end lilypond
+1 + 2
-Plus d'options, comme celle d'ajouter plusieurs lignes de paroles en dessous
-d'une même mélodie sont exposées dans @ref{Vocal music}.
+(1 + 2) * 3
+((1 + 2) * 3) / (4 * 5)
+@end example
-@node A lead sheet
-@section A lead sheet
+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.
-@cindex Lead sheets
-@cindex chords
-@cindex chord names
-@c TODO: revise this, \chords { } is shorter and more intuitive.
+@node Multiple staves
+@subsection Multiple staves
-Dans la variété, il est courant d'indiquer l'accompagnement par le
-nom des accords. De tels accords peuvent être entrés comme les notes,
+Comme nous l'avons vu dans @ruser{Music expressions explained}, un fichier
+d'entrée LilyPond est fait d'expressions musicales. Si la partition
+commence par plusieurs expressions simultanées, LilyPond créera
+plusieurs portées. Cependant, il est plus facile de voir ce qu'il
+advient si l'on crée explicitement chacune des portées.
-@lilypond[quote,verbatim,ragged-right]
-\chordmode { c2 f4. g8 }
+Pour créer plus d'une portée, chaque partie de la musique constituant
+une portée est entrée en la faisant précéder de @code{\new Staff}. Ces
+éléments @code{Staff} sont ensuite combinés en parallèle avec @code{<<}
+et @code{>>}, comme ceci :
+
+@lilypond[quote,ragged-right,verbatim]
+\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 indications après
-deux points. L'exemple suivant montre quelques indications usuelles.
+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. Cela assure que chaque fragment
+aura sa propre portée.
-@lilypond[quote,verbatim,ragged-right]
-\chordmode { c2 f4:m g4:maj7 gis1:dim7 }
-@end lilypond
+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.
-Pour la musique improvisée, les accords ne sont pas imprimés sur des
-portées mais comme des lignes à part entière. Ceci s'obtient en
-utilisant @code{\chords} à la place de @code{\chordmode}. La même
-syntaxe sera utilisé que dans le cas de@code{\chordmode}, mais le
-rendu des notes interviendra dans un contexte de @code{ChordNames},
-avec le résultat suivant.
+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 @qq{moins} en mathématiques. La
+formule @math{(4+5)} est une expression, donc @math{-(4+5)} est une plus
+grosse expression.
-@lilypond[quote,verbatim,ragged-right]
-\chords { c2 f4.:m g4.:maj7 gis8:dim7 }
+Les chiffres de métrique indiqués sur une portée affectent toutes les
+autres portées@footnote{Ce comportement peut être modifié si nécessaire,
+voir @ruser{Polymetric notation}.}. En revanche l'armure d'une portée
+n'affecte @emph{pas} les autres portées.
+
+@lilypond[quote,ragged-right,verbatim]
+\relative c'' {
+ <<
+ \new Staff { \clef treble \time 3/4 c }
+ \new Staff { \clef bass \key d \major c,, }
+ >>
+}
@end lilypond
-@cindex lead sheet
-Une fois assemblés, les accords, paroles et mélodie forment une
-partition d'improvisation :
+
+
+
+@node Piano staves
+@subsection Piano staves
+
+@cindex changement de portée manuel
+@cindex voix changeant manuellement de portée
+La musique pour piano s'écrit sur deux portées reliées par une accolade.
+Imprimer ce type de portée revient au même que dans l'exemple de musique
+polyphonique de @ruser{Multiple staves}, mais maintenant cette expression
+entière doit être interprétée dans un contexte @code{PianoStaff} :
@example
-<<
- \chords @{ @emph{chords} @}
- @emph{the melody}
- \addlyrics @{ @emph{the text} @}
+\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[quote,ragged-right,verbatim]
+\relative c'' {
+ \new PianoStaff <<
+ \new Staff { \time 2/4 c4 e g g, }
+ \new Staff { \clef bass c,, c' e c }
+ >>
+}
@end lilypond
-Une liste complète de modificateurs et d'autres options pour
-l'agencement des pages se trouve à la section @ref{Chords}.
+@seealso
+@quotation
+Voir @ruser{Piano music}.
+@end quotation
-@node Adding titles
-@section Adding titles
+@node Combining notes into chords
+@subsection Combining notes into chords
-Les informations bibliographiques sont entrées dans un bloc séparé, le
-bloc d'entête (@code{\header}). Le nom du morceau, son compositeur, etc, sont
-déterminés et affectés dans @code{\header@{@tie{}@dots{}@tie{}@}}.
-Le bloc @code{\header} est habituellement placé en début de fichier.
-Par exemple,
+@cindex accords
+Des accords peuvent être produits en entourant les hauteurs de notes
+par des angles gauche et droit --- @samp{<} et @samp{>} ---
-@example
-\header @{
- title = "Miniature"
- composer = "Igor Stravinsky"
-@}
+@lilypond[quote,fragment,verbatim,relative=2,fragment]
+r4 <c e g>4 <c f a>2
+@end lilypond
-@{ @dots{} @}
-@end example
+Vous pouvez combiner les indications comme les liaisons et les ligatures
+de croches avec les accords. Ils doivent cependant être placés en
+dehors des angles :
+@lilypond[quote,fragment,verbatim,relative=2,fragment]
+r4 <c e g>8[ <c f a>]~ <c f a>2
+@end lilypond
-Quand le fichier est traité, le titre et le compositeur sont imprimés en haut
-de la partition. Plus d'informations sur les titres peuvent être trouvées
-dans @ref{Creating titles}.
+@lilypond[quote,fragment,verbatim,relative=2,fragment]
+r4 <c e g>8\>( <c e g> <c e g>4 <c f a>\!)
+@end lilypond
@node Single staff polyphony
-@section Single staff polyphony
-
-@cindex polyphony
-@cindex multiple voices
-@cindex voices, more -- on a staff
-Quand différentes lignes mélodiques sont combinées sur une seule et
-même portée, elle sont imprimées comme des voix polyphoniques ; chaque
-voix a ses propre queues, liaisons et barres, la voix supérieure ayant
-les queues vers le haut, la voix du bas vers le bas.
-
-Saisir ce type de partition est réalisé en entrant chaque voix comme
-une chaine (avec @code{@{...@}}), et en les combinant simultanément
-en séparant les voix avec @code{\\}.
-
-@lilypond[quote,verbatim,relative=2,fragment]
-<< { a4 g2 f4~ f4 } \\
- { r4 g4 f2 f4 } >>
+@subsection Single staff polyphony
+
+@cindex polyphonie
+@cindex voix multiples sur une portée
+Quand différentes lignes mélodiques sont combinées sur une seule et même
+portée, elles sont imprimées comme des voix polyphoniques ; chaque voix
+a ses propre hampes@footnote{familièrement appelées queues de note.},
+liaisons et ligatures, la voix supérieure ayant les hampes vers le haut,
+la voix inférieure vers le bas.
+
+Ce type de partition est réalisé en entrant chaque voix comme une
+séquence (avec @code{@{...@}}), en combinant simultanément les voix et
+en les séparant par @code{\\} :
+
+
+@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+<<
+ { a4 g2 f4~ f4 } \\
+ { r4 g4 f2 f4 }
+>>
@end lilypond
-Pour l'écriture de musique polyphonique, des « blancs » (spacer rests)
-s'avèrent bien pratique ; ce sont des silences qui ne s'impriment pas. Ils
-sont utiles pour remplir les voix qui, temporairement, ne jouent pas. On peut
-voir ici le même exemple avec un « silence espace » (@code{s}) à la place
-d'un silence normal (@code{r}) :
+Pour l'écriture de musique polyphonique, les silences invisibles
+s'avèrent bien pratiques : ce sont des silences qui ne s'impriment pas.
+Ils sont utiles pour remplir des voix qui, temporairement, ne jouent
+rien. On peut voir ici le même exemple avec un silence invisible
+(@code{s}) à la place d'un silence normal (@code{r}) :
-@lilypond[quote,verbatim,relative=2,fragment]
-<< { a4 g2 f4~ f4 } \\
- { s4 g4 f2 f4 } >>
+@lilypond[quote,ragged-right,verbatim,fragment,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]
<<
>>
@end lilypond
-Plus de fonctionnalités sur l'écriture polyphonique sont décrites à la
-section @ref{Basic polyphony} du manuel.
+@seealso
+@quotation
+Voir @ruser{Basic polyphony}.
+@end quotation
-@node Piano staves
-@section Piano staves
+@node Songs
+@section Songs
-@cindex staff switch, manual
-@cindex cross staff voice, manual
-La musique pour piano s'écrit avec deux portées connectées par une
-accolade. Imprimer ce type de portée revient au même que dans l'exemple de
-musique polyphonique (@ref{More staves}),
+Cette section présente l'écriture vocale et les partitions de variété.
-@example
-<< \new Staff @{ @dots{} @}
- \new Staff @{ @dots{} @} >>
-@end example
+@menu
+* Printing lyrics::
+* A lead sheet::
+@end menu
-@noindent
-mais maintenant cette expression entière doit être interprétée dans un
-contexte @code{PianoStaff}
-@example
-\new PianoStaff << \new Staff @dots{} >>
-@end example
+@node Printing lyrics
+@subsection Printing lyrics
-Voici un petit exemple :
+@cindex paroles
+@cindex chansons
+Prenons une mélodie toute simple :
-@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 }
+@lilypond[quote,ragged-right,verbatim]
+\relative c'' {
+ a4 e c8 e r4
+ b2 c4( d)
+}
+@end lilypond
+
+Des paroles peuvent être associées à ces notes, en les combinant avec la
+commande @code{\addlyrics}. Les paroles sont entrées en séparant chaque
+syllable par un espace :
+
+@lilypond[quote,ragged-right,verbatim]
+<<
+ \relative c'' {
+ a4 e c8 e r4
+ b2 c4( d)
+ }
+ \addlyrics { One day this shall be free }
>>
@end lilypond
-Plus d'informations sur le formatage de la musique pour piano sont
-données dans @ref{Piano music}.
+@cindex mélisme
+@cindex ligne d'extension
+Cette mélodie se termine sur un @rglos{melisma}, c'est-à-dire qu'une
+seule syllable (@qq{free}) correspond à plus d'une note. Ceci est
+indiqué avec une @emph{ligne d'extension}. Elle est entrée avec deux
+caractères souligné (@code{_}), c'est-à-dire :
+@lilypond[quote,ragged-right,verbatim]
+<<
+ \relative c'' {
+ a4 e c8 e r4
+ b2 c4( d)
+ }
+ \addlyrics { One day this shall be free __ }
+>>
+@end lilypond
-@node Organizing larger pieces
-@section Organizing larger pieces
+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 :
-Quand tous les éléments discutés plus haut sont combinés ensemble pour
-produire un fichier plus volumineux, les blocs @code{\score}
-deviennent beaucoup plus gros parce que les expressions musicales
-sont plus longues et, dans le cas des pièces polyphoniques, très
-emboîtées. Ce type d'expression imposante finit par devenir peu maniable.
+@c no ragged-right here because otherwise the hypens get lost.
+@lilypond[quote,verbatim]
+<<
+ \relative c' {
+ \time 2/4
+ f4 f c c
+ }
+ \addlyrics { A -- le -- gri -- a }
+>>
+@end lilypond
-En utilisant des variables, appelées également identifiants, il est
-possible de découper les expressions musicales complexes. Un identificateur
-est assigné comme suit :
+@seealso
+@quotation
+Plus de possibilités, comme celle d'ajouter plusieurs lignes de paroles
+en dessous d'une même mélodie sont exposées dans @ruser{Vocal music}.
+@end quotation
-@example
-namedMusic = @{ @dots{} @}
-@end example
-@noindent
-Le contenu de l'expression musicale @code{NomDeLaVariable}, peut être
-rappelé plus loin en faisant précéder son nom d'un anti-slash, par exemple
-@code{\NomDeLaVariable}. Dans l'exemple suivant, un motif de deux notes est
-répété deux fois en utilisant la substitution par une variable.
-
-@lilypond[quote,ragged-right,verbatim,nofragment]
-seufzer = {
- e'4( dis'4)
-}
-{ \seufzer \seufzer }
+@node A lead sheet
+@subsection A lead sheet
+
+@cindex partition de chanson
+@cindex chanson, partition complète
+@cindex accords, noms
+@cindex noms d'accords
+
+En musique de variété, il est courant d'indiquer l'accompagnement par le
+nom des accords. De tels accords peuvent être entrés comme les notes :
+
+@lilypond[quote,ragged-right,verbatim]
+\chordmode { c2 f4. g8 }
@end lilypond
-Le nom d'un identifiant ne doit comporter que des caractères
-alphabétiques, et pas de nombre, souligné ou tiret. L'assignation
-doit être faite en dehors de la musique.
+Maintenant, chaque hauteur est lue comme la base de l'accord à la place
+de la note. Ce mode est activé avec @code{\chordmode}. D'autres
+accords peuvent être créés en ajoutant des modificateurs après deux
+points. L'exemple suivant montre quelques modificateurs usuels :
-Il est possible d'utiliser des variables de plusieurs types d'objet.
-Par exemple,
+@lilypond[quote,verbatim,ragged-right]
+\chordmode { c2 f4:m g4:maj7 gis1:dim7 }
+@end lilypond
-@example
-width = 4.5\cm
-name = "Wendy"
-aFivePaper = \paper @{ paperheight = 21.0 \cm @}
-@end example
+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 @code{ChordNames}, avec le
+résultat suivant :
-En fonction de son contenu, l'identifiant peut être utilisé à différents
-endroits. L'exemple suivant utilise la variable précédente :
+@lilypond[quote,verbatim,ragged-right]
+\chords { c2 f4.:m g4.:maj7 gis8:dim7 }
+@end lilypond
-@example
-\paper @{
- \aFivePaper
- line-width = \width
-@}
-@{ c4^\name @}
-@end example
+@cindex partition de chanson
+@cindex chanson, partition complète
+Une fois assemblés, les accords, paroles et mélodie forment une
+partition de chanson :
-Plus d'informations sur les recours possibles aux identifiants
-sont données dans le manuel technique, section @ref{Input variables
-and Scheme}.
-@c fixme: the ref is too technical.
+@lilypond[quote,verbatim,ragged-right]
+<<
+ \chords { c2 g:sus4 f e }
+ \relative c'' {
+ a4 e c8 e r4
+ b2 c4( d)
+ }
+ \addlyrics { One day this shall be free __ }
+>>
+@end lilypond
-@node An orchestral part
-@section An orchestral part
+@seealso
+@quotation
+Une liste complète de modificateurs et d'autres options de mise en forme
+se trouve à la section @ruser{Chords}.
+@end quotation
+
+
+@node Final touches
+@section Final touches
+
+L'ultime section de ce tutoriel montre comment ajouter une touche finale
+à des morceaux simples, et consititue une introduction au reste du
+manuel.
+
+@menu
+* Version number::
+* Adding titles::
+* Absolute note names::
+* Organizing pieces with identifiers::
+* After the tutorial::
+* How to read the manual::
+@end menu
-Pour la musique d'orchestre, toutes les notes sont imprimées deux fois.
-Une partition pour chaque pupître, et un conducteur pour le chef.
-Recourrir à des identifiants permet de s'épargner un double travail. La
-musique est entrée une seule fois, et enregistrée dans une variable. Le
-contenu de ces variables sera utilisé pour générer à la fois la
-partie d'instrument et le conducteur.
-Définir les notes dans un fichier spécial est très pratique. Par
-exemple, supposons que le fichier @file{horn-music.ly} contienne la
-partie d'un duo haubois/@/basson.
+@node Version number
+@subsection Version number
+
+@cindex versions
+La déclaration @code{\version} stipule le numéro de la version de
+LilyPond pour laquelle le fichier a été écrit,
@example
-hornNotes = \relative c @{
- \time 2/4
- r4 f8 a cis4 f e d
-@}
+\version @w{"@version{}"}
@end example
@noindent
-Puis, une partie individuelle est faite en mettant ce qui suit dans
-un fichier
+que l'on place par convention en début de fichier.
+
+Cette annotation permet de faciliter les prochaines mises à jour de
+LilyPond. Les changements dans la syntaxe sont gérés avec un programme
+spécial, @file{convert-ly} --- voir @rprogram{Updating files with convert-ly}
+--- et il utilise @code{\version} pour déterminer les règles de
+conversion à appliquer au fichier.
+
+
+@node Adding titles
+@subsection Adding titles
+
+Les informations bibliographiques (nom du morceau, du compositeur, etc)
+sont entrées dans un bloc séparé, le bloc d'en-tête (@code{\header}),
+qui existe indépendamment des expressions musicales principales. Le
+bloc @code{\header} est habituellement placé en début de fichier.
@example
-\include "horn-music.ly"
+\version "2.11.38"
\header @{
- instrument = "Horn in F"
+ title = "Symphonie"
+ composer = "Moi"
+ opus = "Op. 9"
@}
@{
- \transpose f c' \hornNotes
+ @dots{} music @dots{}
@}
@end example
+Quand le fichier est traité, le titre et le compositeur sont imprimés en
+haut de la partition. Vous trouverez plus d'informations sur les titres
+à @ruser{Creating titles}.
-La ligne
+@node Absolute note names
+@subsection Absolute note names
-@example
-\include "horn-music.ly"
-@end example
+Jusqu'ici nous n'avons utilisé que le mode @code{\relative} pour définir
+les hauteurs de notes. Si c'est effectivement le moyen le plus simple
+d'entrer la majeure partie de votre musique, il existe une autre façon
+de procéder : le mode des hauteurs absolues.
-@noindent
-substitue le contenu de @file{horn-music.ly} à cet endroit dans le
-fichier, ainsi @code{hornNotes} est définit pour ce qui suivra. La commande
-@code{\transpose f@tie{}c'} indique que l'argument, en l'occurence
-@code{\hornNotes}, doit être transposé une quinte au-dessus. Entendre
-@samp{fa} correspond à la notation @code{do'}, ce qui correspond à la
-transpostion d'un cor anglais en fa. La transposition peut être
-constatée dans la sortie suivante :
+Si vous omettez la commande @code{\relative}, LilyPond considérera
+toutes les hauteurs comme des hauteurs absolues. Un @code{c'} sera
+toujours un do du milieu, un @code{b} sera toujours une note au-dessous
+du précédent, et un @code{g,} sera toujours la note la plus grave dans
+la portée de clé de fa.
-@lilypond[quote,ragged-right]
-\transpose f c' \relative c {
- \time 2/4
- r4 f8 a cis4 f e d
+@lilypond[quote,verbatim,ragged-right]
+{
+ \clef bass
+ c' b g, g,
+ g, f, f c'
}
@end lilypond
-Dans la musique d'ensemble, il arrive souvent qu'une des voix ne joue
-pas pendant plusieurs mesures. Ceci est spécifié par un silence
-spécial, le silence multi-mesure (mesures à compter). Il est saisi
-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
+Voici une gamme sur 4 octaves :
-@example
-R2*3
-@end example
+@lilypond[quote,verbatim,ragged-right]
+{
+ \clef bass
+ c, d, e, f,
+ g, a, b, c
+ d e f g
+ a b c' d'
+ \clef treble
+ e' f' g' a'
+ b' c'' d'' e''
+ f'' g'' a'' b''
+ c'''1
+}
+@end lilypond
-Pour l'impression de parties séparées, ces silences multi-mesures doivent être
-condensés. Ceci est réalisé en réglant une variable « run-time »
+Comme vous pouvez le voir, il faut beaucoup d'apostrophes pour écrire de
+la musique dans un registre aigu. Regardez cet extrait de Mozart :
-@example
-\set Score.skipBars = ##t
-@end example
+@lilypond[quote,verbatim,ragged-right]
+{
+ \key a \major
+ \time 6/8
+ cis''8. d''16 cis''8 e''4 e''8
+ b'8. cis''16 b'8 d''4 d''8
+}
+@end lilypond
-@noindent
-Cette commande règle la propriété @code{skipBars} dans le contexte
-@code{Score} à vrai (@code{##t}). Faire précéder la musique plus haut
-par ce silence et cette option à la musique produit au résultat suivant
+Toutes ces apostrophes rendent le fichier moins lisible, et c'est donc
+une source d'erreurs. En mode @code{\relative}, le même exemple devient
+bien plus facile à lire :
-@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[quote,verbatim,ragged-right]
+\relative c'' {
+ \key a \major
+ \time 6/8
+ cis8. d16 cis8 e4 e8
+ b8. cis16 b8 d4 d8
}
@end lilypond
+Si d'aventure vous faites une erreur d'octaviation, le mode
+@code{\relative} la rendra frappante --- toutes les notes suivantes
+seront placées à la mauvaise octave. En mode de hauteurs absolues, une
+erreur isolée ne serait pas auntant visible, et donc aussi facile à
+dénicher.
-Le conducteur est créé en combinant ensemble toutes les parties. En
-supposant que l'autre voix soit dans @code{bassoonNotes} du fichier
-@file{bassoon-music.ly}, un conducteur est fait avec
+Cependant, le mode de hauteurs absolues reste utile pour les musiques où
+les intervalles sont étendus, surtout pour les fichiers LilyPond créés
+par ordinateur.
-@example
-\include "bassoon-music.ly"
-\include "horn-music.ly"
-<<
- \new Staff \hornNotes
- \new Staff \bassoonNotes
->>
+@node Organizing pieces with identifiers
+@subsection Organizing pieces with identifiers
+
+Lorsque l'on combine tous les éléments étudiés plus haut pour produire
+des fichiers plus volumineux, les blocs @code{\score} deviennent
+beaucoup plus gros parce que les expressions musicales sont plus longues
+et, dans le cas des pièces polyphoniques, profondément imbriquées. De
+telles expressions imposantes finissent par devenir peu maniables. Cet
+inconvénient peut être résolu par l'utilisation
+d'@emph{identificateurs}.
+
+En utilisant ces identificateurs, que l'on pourrait aussi appeler
+variables ou macros, il est possible de découper des expressions
+musicales complexes. Un identificateur se définit comme suit :
+
+@example
+MusiqueToto = @{ @dots{} @}
@end example
-@noindent
-leading to
+Le contenu de l'expression musicale @code{MusiqueToto} pourra être
+utilisé plus loin en faisant précéder son nom d'un anti-slash,
+c'est-à-dire @code{\MusiqueToto}, juste comme n'importe quelle commande
+LilyPond. Tous les identificateurs doivent être définis @emph{avant}
+l'expression musicale principale.
-@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[quote,verbatim,ragged-right]
+violin = \new Staff { \relative c'' {
+ a4 b c b
+}}
+cello = \new Staff { \relative c {
+ \clef bass
+ e2 d
+}}
+{
+ <<
+ \violin
+ \cello
+ >>
+}
@end lilypond
-De plus amples informations sur la gestion des parties et conducteurs
-se trouvent dans le manuel de notation, section @ref{Orchestral music}.
+@noindent
+Le nom d'un identificateur ne doit comporter que des caractères
+alphabétiques non accentués, aucun nombre ni tiret.
-Le réglage des variables « run-time » ("propriétés") est abordé dans
-@ref{Changing context properties on the fly}.
+Il est possible d'utiliser des variables de types variés. Par exemple,
+
+@example
+width = 4.5\cm
+name = "Wendy"
+aFivePaper = \paper @{ paperheight = 21.0 \cm @}
+@end example
+
+En fonction de son contenu, un identificateur peut être utilisé à
+différents endroits. L'exemple suivant utilise la variable ci-dessus :
+
+@example
+\paper @{
+ \aFivePaper
+ line-width = \width
+@}
+@{ c4^\name @}
+@end example
@node After the tutorial
-@section After the tutorial
-
-Après avoir parcouru ce tutoriel, vous devriez vous essayer à écrire
-un morceau ou deux. Commencez par l'une des matrices (@ref{Example
-templates}) et ajoutez-y des notes. Si vous utilisez une notation que
-vous n'avez pas trouvé dans le tutoriel, consultez la section Notation
-Reference (@ref{Basic notation}). Si vous désirez écrire pour un
-ensemble instrumental non couvert par les @ref{Example templates},
-lisez la section @ref{Extending the templates}.
-
-Après avoir écrit quelques pièces courtes, lisez les chapitres 3 à 5
-du utilisateur. Rien ne s'oppose à ce que vous consultiez dès à
+@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 @ruser{Templates} types et
+ajoutez-y des notes. Si vous voulez employer une notation que vous
+n'avez pas trouvé dans le tutoriel, consultez la référence de notation,
+en commençant par la @ruser{Basic notation}. Si vous désirez écrire pour
+un ensemble instrumental non couvert par les @ruser{Templates}, lisez la
+section @ruser{Extending the templates}.
+
+Après avoir écrit quelques pièces courtes, lisez les chapitres 3 à 5 du
+manuel d'apprentissage. Rien ne s'oppose à ce que vous consultiez dès à
présent les autres chapitres, bien sûr ! Néanmoins, le reste du manuel
-utilisateur part du principe que vous avez déjà bien assimilé la
-syntaxe de LilyPond. Vous pouvez toujours survoler le reste du manuel,
-et y revenir plus tard, ayant acquis de l'expérience.
-
+de l'utilisateur part du principe que vous avez déjà bien assimilé la
+syntaxe de LilyPond. Vous pouvez toujours survoler le reste du manuel,
+et y revenir plus tard après avoir acquis de l'expérience.
+
+@node How to read the manual
+@subsection How to read the manual
+
+Comme nous l'avons déjà vu dans @ruser{How to read the tutorial}, de
+nombreux exemples du tutoriel n'ont pas fait apparaître
+@code{\relative c'' @{ ... @}} dans l'extrait de code affiché.
+
+Dans le reste du manuel, les exemples utilisés sont encore beaucoup plus
+souples : parfois il leur manque le @code{\relative c'' @{ ... @}},
+mais d'autres fois ils ont recours à une autre hauteur de référence,
+telle que @code{c'} ou @code{c,,}), et dans certains cas c'est même
+l'exemple entier qui est en mode de hauteurs absolues ! Cependant, de
+telles ambiguïtés ne se trouvent que dans des contextes où les hauteurs
+n'ont que peu d'importance. Dans tous les exemples où elles en ont, le
+mode @code{\relative} ou absolu @code{@{ @}} est explicitement spécifié.
+
+Si vous ne vous y retrouvez toujours pas pour savoir quel code LilyPond
+produit précisément tel ou tel exemple, consultez la version HTML de ce
+manuel si ce n'est pas déjà le cas, et cliquez sur l'image de la
+partition. La source exacte utilisée pour générer ce manuel s'affichera
+alors.
+
+Pour en savoir plus sur l'organisation de la suite de ce manuel,
+reportez-vous à @ruser{About this manual}.
projects / lilypond.git / blobdiff