@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
@c This file is part of lilypond.tely
-@c
-@c Translation of GIT committish: 829be449be664ea765ed43f5d56b50b41e43b397
-@c
-@c When revising a translation, copy the HEAD committish of the
-@c version that you are working on. Use
-@c
-@c git-rev-list HEAD | head -1
-@c
-@c to discover that.
-
+@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 utilisé
-par LilyPond pour représenter la musique. Après ce premier contact,
-nous verrons comment produire une partition à imprimer. Vous serez
-alors capable de créer et d'imprimer vos propres partitions.
+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
+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
+Essayez sur cette image :
-@lilypond[fragment,quote,ragged-right,relative=2]
-c-\markup { \bold \huge { Click here. } }
+@c no verbatim here
+@c KEEP LY
+@lilypond[quote,ragged-right]
+\relative c'' {
+ c-\markup { \bold \huge { Cliquez ici. } }
+}
@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
+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
-pour une consultation 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
+Cette section présente sommairement la façon de travailler avec LilyPond.
+
+@menu
+* Compiling a file::
+* Simple notation::
+* Working on text files::
+* How to read the tutorial::
+@end menu
+
+
+@node Compiling a file
+@subsection Compiling a file
+
+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
@{
-c d e f g a b
+ c' e' g' e'
@}
@end example
@noindent
-le résultat ressemblera à
+le résultat ressemblera à
-@lilypond[fragment,quote,notime,relative=1]
-c d e f g a b
+@c in this case we don't want verbatim
+@lilypond[quote,ragged-right]
+{
+ 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
-Tout extrait de code LilyPond doit être entouré d'une @{paire
-d'accolades@}. Bien que la plupart des exemples de ce manuel n'en
-comportent pas, ne les oubliez pas dans vos compositions !
+@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 !
-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
+@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.
-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.
-
-@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 durée entrée est utilisée
-pour les notes suivantes. La valeur implicite de la première note
-dans les fichiers sources de la partition est la noire :
-
-@example
-a a8 a a2 a
-@end example
-
-@lilypond[fragment,quote,notime,relative=2]
-{ a a8 a a2 a s16_" " }
-@end lilypond
-
-
-On saisit un silence (@rglos{rest}) 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
-
-Ajouter un point @samp{.} après une durée permet d'obtenir une note
-pointée (@rglos{dotted note})
-
-@example
-a2. a4 a8. a16
-@end example
-
-@lilypond[fragment,quote,notime,relative=1]
-{ a2. a4 a8. a16 s16_" " }
-@end lilypond
-
-La métrique (@rglos{time signature}) est définie par
-la commande @code{\time}
-
-@example
-\time 3/4
-\time 6/8
-\time 4/4
-@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} est définie par la commande @code{\clef}
-
-@example
-\clef treble
-\clef bass
-\clef alto
-\clef tenor
-@end example
-
-@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
+@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 compiler
-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 alors 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, 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
+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 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
+@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
@c DIV specific
-Suivant votre installation, les messages peuvent être traduits.
+Suivant votre installation, ces messages peuvent être traduits.
@c END DIV
-@cindex DVI file
-@cindex Viewing music
-@cindex xdvi
+@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.}
-
-@node More about pitches
-@section More about pitches
+programme pour afficher et imprimer librement les fichiers PDF et PostScript.}
-Un dièse (@rglos{sharp}) s'obtient en ajoutant @samp{is} au nom de la
-note, un bémol (@rglos{flat}) en ajoutant @samp{es}. Comme vous pouvez
-vous y attendre, un double dièse ou double bémol est obtenu en
-ajoutant @samp{isis} ou @samp{eses}@footnote{Cette syntaxe est dérivée
-de la convention de dénomination des notes dans les langues nordiques
-et germaniques, comme l'allemand ou le hollandais.}.
-@c DIV specific
-Si vous utilisez la commande @samp{\include "catalan.ly"} pour entrer
-les noms de notes français au lieu des noms hollandais, il faudra
-ajouter un @samp{d} pour un dièse, et un @samp{b} pour un bèmol. Le
-double dièse et le double bémol s'obtiennent en ajoutant
-respectivement @samp{dd} et @samp{bb}
-@c END DIV
+@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 puis 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'
-@end lilypond
+@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}.
-@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[quote,ragged-right,verbatim]
+\relative c' {
+ c d e f
+ g a b c
+}
+@end lilypond
+La note de départ est @rglos{middle C}. Chacune des notes qui suivent
+est à moins d'une quarte de la note précédente --- en d'autres termes,
+le premier @samp{c} est le do 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 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'
+@lilypond[quote,ragged-right,verbatim]
+\relative c' {
+ d f a g
+ c b f d
+}
@end lilypond
@noindent
-si aucune note n'a d'altération accidentelle, vous devez
-cependant 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 juste
-en-dessous de la portée. » Cela signifie plutôt : « une note ayant la
-hauteur ré naturel. » Avec l'armure de la bémol majeur, ce ré sera flanqué
-d'un bécarre accidentel.
-
-@lilypond[quote,notime,fragment,relative=1,verbatim]
-\key as \major
-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 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.
+@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 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.
+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 prolongation, 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@footnote{parfois appelées aussi liens de croches}
-(@rglos{beam}), sont dessinées automatiquement :
-@lilypond[quote,fragment,relative=2,verbatim]
-a8 ais d es r d
-@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 ligatures, voir @ref{Manual beams}.
+@subheading Clef
-Voici comment se comportent ensemble 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\staff-space,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ù 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.
+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 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'}
+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 le mode
-d'« octaves relatives ». C'est la façon la plus commode de copier de
-la musique existante.
-
-En mode relatif, une note sans signe d'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.
+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
-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'}.
+@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 :
+@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.
-@lilypond[quote,notime,fragment,verbatim]
-\relative {
- c' f c g c
-}
-@end lilypond
+ g g f f e e d d c2
+%@}
+@end example
+@end itemize
-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
+Vous trouverez plus d'astuces pour organiser vos fichiers LilyPond dans
+@ruser{Suggestions for writing LilyPond files}.
-@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 How to read the tutorial
+@subsection How to read the tutorial
-@lilypond[quote,notime,verbatim,fragment]
-\relative c {
- c'' f, f c' c g' c,
-}
-@end lilypond
+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.
-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.
+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 :
-Pour plus d'information sur les octaves relatives, voir
-@ref{Relative octaves}, et @ref{Octave check}.
+@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 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 Music expressions explained
-@section Music expressions explained
+@node Single staff notation
+@section Single staff notation
+Cette section présente la notation courante dont on a besoin pour
+écrire une seule voix sur une seule portée.
-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 :
+@menu
+* Relative note names::
+* Accidentals and key signatures::
+* Ties and slurs::
+* Articulation and dynamics::
+* Automatic and manual beams::
+* Advanced rhythmic commands::
+@end menu
-@lilypond[fragment,quote,verbatim,relative=3]
-a4
-@end lilypond
-Mettre un groupe de notes entre accolades crée une nouvelle expression
-musicale :
+@node Relative note names
+@subsection Relative note names
-@lilypond[fragment,quote,verbatim,relative=3]
-{ a4 g4 }
-@end lilypond
+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.
-Placer une séquence d'expressions musicales -- des notes par exemple
--- entre accolades signifie qu'elles doivent être jouées
-successivement, les unes après les autres. Le résultat est une
-expression, qui peut elle-même être regroupée séquentiellement avec
-d'autres expressions. Ici, l'expression de l'exemple précédent est
-combinée à deux notes :
+Lilypond 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[fragment,quote,verbatim,relative=3]
-{ { a4 g } f g }
+@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+c2 fis
+c2 ges
@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.
-
-@lilypond[fragment,quote,verbatim,relative=3]
-<<
- { a4 g }
- { f e }
- { d b }
->>
-@end lilypond
+@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
-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
-1 + 2
+@node Accidentals and key signatures
+@subsection Accidentals and key signatures
-(1 + 2) * 3
+@subheading Accidentals
-((1 + 2) * 3) / (4 * 5)
-@end example
+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.}.
-@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.
+@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
-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.
+Pour en savoir plus sur les autres langues disponibles, voir @ruser{Note
+names in other languages}.
-@lilypond[fragment,quote,verbatim,relative=2]
-{
- c <<c e>>
- << { e f } { c <<b d>> } >>
-}
+@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+cis1 ees fisis, aeses
@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 armure, définition de
+@subheading Key signatures
-@example
-<<
- @{
- @dots{}
- @}
- @{
- @dots{}
- @}
->>
-@end example
+L'armure est déterminée par la commande @code{\key}, suivie d'une
+hauteur puis de @code{\major} (majeur) ou @code{\minor} (mineur) :
-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.
+@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+\key d \major
+a1
+\key c \minor
+a
+@end lilypond
-@node More staves
-@section More staves
+@sp 1
-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
+@subheading Warning: key signatures and pitches
-@lilypond[quote,fragment,verbatim]
-<<
- \new Staff { \clef treble c'' }
- \new Staff { \clef bass c }
->>
-@end lilypond
+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
-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.
+@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
-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.
+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.
-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.
+@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
-Nous pouvons maintenant écrire un morceau à deux portées :
-@c TODO: (c) status of this Paul McCartney (?) song (let's all stand together)
+@node Ties and slurs
+@subsection Ties and slurs
-@lilypond[fragment,quote,verbatim,ragged-right]
-\relative <<
- \new Staff {
- \time 3/4
- \clef treble
+@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.
- 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]
+g4~ g c2~
+c4 ~ c8 a8 ~ a2
@end lilypond
-Pour plus d'informations sur les contextes, voir leur description à
-@ref{Interpretation contexts}.
+@cindex liaisons d'articulation
+@subheading Slurs
+@c Le terme de "slur" a deux sens en français : articulation et phrasé.
+@c Je garde ici le terme "legato", tel qu'il apparaît dans le texte original,
+@c car c'est celui qui me semble le plus couramment employé.
+Une @rglos{slur} d'articulation (ou @qq{legato}) peut englober
+plusieurs notes. Les notes de départ et d'arrivée reçoivent
+respectivement un signe @samp{(} et @samp{)}.
-@node Adding articulation marks to notes
-@section Adding articulation marks to notes
+@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+d4( c16) cis( d e c cis d) e( d4)
+@end lilypond
-@cindex articulation
-@cindex accents
-@cindex staccato
+@cindex liaisons de phrasé
+@subheading Phrasing slurs
-Les articulations standard peuvent être ajoutées à une note en
-utilisant un tiret (@samp{-}) et un caractère :
+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.
-@lilypond[fragment,quote,verbatim,relative=2]
-c-. c-- c-> c-^ c-+ c-_
+@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+a8(\( ais b c) cis2 b'2 a4 cis,\)
@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 :
+@sp 1
-@lilypond[fragment,quote,verbatim,relative=2]
-c-3 e-5 b-2 a-1
-@end lilypond
+@cindex liaisons de phrasé et de prolongation, différences
+@subheading Warnings: slurs vs. ties
-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.
+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[fragment,quote,verbatim,relative=2]
-c_-^1 d^. f^4_2-> e^-_+
+@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+c2~( c8 fis fis4 ~ fis2 g2)
@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{\} :
+@seealso
+@quotation
+@table @asis
+@item @ruser{Ties},
+@item @ruser{Slurs},
+@item @ruser{Phrasing slurs}.
+@end table
+@end quotation
-@lilypond[fragment,quote,verbatim,relative=2]
-c\ff c\mf
-@end lilypond
-@cindex dynamics
-@cindex decrescendo
-@cindex crescendo
+@node Articulation and dynamics
+@subsection Articulation and dynamics
-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{\!} :
+@cindex articulation
+@cindex accents
+@cindex staccato
+@subheading Articulations
-@lilypond[fragment,quote,verbatim,relative=2]
-c2\< c2\ff\> c2 c2\!
-@end lilypond
+Des @rglos{articulation}s peuvent être ajoutées à une note, au moyen
+d'un tiret @samp{-} suivi d'un caractère :
+@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+c-. c-- c-> c-^ c-+ c-_
+@end lilypond
+@cindex 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 :
-@cindex slur
+@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+c-3 e-5 b-2 a-1
+@end lilypond
-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{)} :
+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.
-@lilypond[fragment,quote,fragment,relative=2,verbatim]
-d4( c16) cis( d e c cis d) e( d4)
+@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+c_-^1 d^. f^4_2-> e^-_+
@end lilypond
-@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 :
+@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{\} :
-@lilypond[quote,fragment,relative=2]
-c2~( c8 fis fis4 ~ fis2 g2)
+@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+c\ff c\mf c\p c\pp
@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.
+@cindex nuances
+@cindex decrescendo
+@cindex crescendo
-@lilypond[quote,fragment,relative=2,verbatim]
-a8(\( ais b c) cis2 b'2 a4 cis, c\)
-@end lilypond
+@c Pluriel des termes musicaux italiens :
+@c selon Littré, plutôt à la française (en "-os" qu'en "-i")
+Crescendos et decrescendos débutent avec les commandes @code{\<} et
+@code{\>}. Ils se terminent soit par une nuance d'arrivée, par exemple
+@code{\f}, soit par la commande @code{\!} :
-Pour plus d'informations sur les
+@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+c2\< c2\ff\> c2 c2\!
+@end lilypond
+@seealso
@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}.
+@item @ruser{Articulations}.
+@item @ruser{Fingering instructions}.
+@item @ruser{Dynamics}.
@end table
@end quotation
-@node Combining notes into chords
-@section Combining notes into chords
+@node Automatic and manual beams
+@subsection Automatic and manual beams
-@cindex chords
-Des accords peuvent être produits en entourant les hauteurs de note
-avec les angles gauche et droit -- @samp{<} et @samp{>} --
+@cindex ligatures manuelles
+Toutes les @rglos{beam} sont dessinées automatiquement :
-@lilypond[quote,relative=1,fragment,verbatim]
-r4 <c e g>4 <c f a>8
+@lilypond[quote,ragged-right,verbatim,fragment,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 @samp{[} et la dernière d'un @samp{]}.
-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[quote,relative=1,fragment,verbatim]
-r4 <c e g>8[ <c f a>]~ <c f a>
+@lilypond[quote,ragged-right,verbatim,fragment,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
-
-@lilypond[quote,relative=1,fragment]
-\slurUp
-r4 <c e g>8\>( <c e g> <c e g> <c f a>\!)
-@end lilypond
+@seealso
+@quotation
+@table @asis
+@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 Advanced rhythmic commands
-@section Advanced rhythmic commands
+@subsection Advanced rhythmic commands
+
+@cindex levée
+@cindex anacrouse
+@cindex mesure incomplète
+@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.
+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,relative=2,verbatim,fragment]
+@lilypond[quote,ragged-right,verbatim,fragment,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
+@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,verbatim,fragment]
+@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
-@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
+@cindex notes d'ornement
+@cindex ornementation
+@cindex appoggiature
+@subheading Grace notes
-@lilypond[quote,relative=2,verbatim,fragment]
-c4 \appoggiatura b16 c4
-c4 \acciaccatura b16 c4
-@end lilypond
-
-@noindent
+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} :
-Pour plus d'informations sur les
+@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+c2 \grace { a32[ b] } c2
+c2 \appoggiatura b16 c2
+c2 \acciaccatura b16 c2
+@end lilypond
+@seealso
@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}.
+@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'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 :
+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.
-
- 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.
+@menu
+* Music expressions explained::
+* Multiple staves::
+* Piano staves::
+* Combining notes into chords::
+* Single staff polyphony::
+@end menu
-@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 Music expressions explained
+@subsection Music expressions explained
-@example
-\version "2.10.0"
-@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, si tant est qu'elle soit
+correctement encadrée :
-@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.
+@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 associées à ces notes en les combinant avec le
-mot-clé @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 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}.
+(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 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 :
+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 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. 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é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
+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 de chanson :
+
+
+
+@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{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[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 de
-mise en forme 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'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,
+@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. Vous trouverez plus d'informations sur les
-titres à @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 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,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, les silences invisibles
-(spacer rests) s'avèrent bien pratiques ; ce sont des silences qui ne
-s'impriment pas. Ils sont utiles pour remplir des voix qui,
-temporairement, ne jouent rien. On peut voir ici le même exemple avec
-un silence espace invisible (@code{s}) à la place d'un silence normal
-(@code{r}) :
-
-@lilypond[quote,verbatim,relative=2,fragment]
-<< { a4 g2 f4~ f4 } \\
- { s4 g4 f2 f4 } >>
+s'avèrent bien pratiques : ce sont des silences qui ne s'impriment pas.
+Ils sont utiles pour remplir des voix qui, temporairement, ne jouent
+rien. On peut voir ici le même exemple avec un silence invisible
+(@code{s}) à la place d'un silence normal (@code{r}) :
+
+@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+<<
+ { a4 g2 f4~ f4 } \\
+ { s4 g4 f2 f4 }
+>>
@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 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}),
+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 à @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 :
-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.
+@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 identificateurs, il est
-possible de découper des expressions musicales complexes. Un identificateur
-se définit comme
+@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
-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)
-}
-{ \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 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.
+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 types variés.
-Par exemple,
+@lilypond[quote,verbatim,ragged-right]
+\chordmode { c2 f4:m g4:maj7 gis1:dim7 }
+@end lilypond
-@example
-largeur = 4.5\cm
-nom = "Wendy"
-papierACinq = \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'identificateur 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 @{
- \papierACinq
- line-width = \largeur
-@}
-@{ c4^\nom @}
-@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 :
+
+@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
-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.
+@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 An orchestral part
-@section An orchestral part
-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.
+@node Final touches
+@section Final touches
-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 :
+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
+
+
+@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
-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
+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 "musique-cor.ly"
+\version "2.11.38"
\header @{
- instrument = "Cor en fa"
+ title = "Symphonie"
+ composer = "Moi"
+ opus = "Op. 9"
@}
@{
- \transpose f c' \notesCor
+ @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 "musique-cor.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
-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 :
+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-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
+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. On peut l'obtenir en réglant une variable d'exécution
+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}). En faisant précéder la musique plus haut
-du silence et de cette option, on obtient
+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.
-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
+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 "musique-cor.ly"
-\include "musique-basson.ly"
-<<
- \new Staff \notesCor
- \new Staff \notesBasson
->>
+@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
-donnant pour résultat
+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.
+
+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 :
-Le réglage des variables d'exécution (« propriétés ») est abordé dans
-@ref{Changing context properties on the fly}.
+@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 copier l'un des modèles types (@ref{Example
-templates}) et ajoutez-y des notes. Si vous voulez employer une notation que
-vous n'avez pas trouvé dans le tutoriel, consultez la référence de
-notation, en commençant par la @ref{Basic notation}. Si vous désirez écrire pour un
-ensemble instrumental non couvert par les @ref{Example templates},
-lisez la section @ref{Extending the templates}.
-
-Après avoir écrit quelques pièces courtes, lisez les chapitres 3 à 5
-du manuel d'apprentissage. 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
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