@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
@c This file is part of lilypond.tely
@ignore
   Translation of GIT committish: d7a9cbdc480e5b327ec53f287f22995e7a9c1a0f

   When revising a translation, copy the HEAD committish of the
   version that you are working on.  See TRANSLATION for details.
@end ignore

@c \version "2.11.51"

@ignore
Tutorial guidelines:  (different from policy.txt!)
- unless you have a really good reason, use either
    @lilypond[verbatim,quote]
  or
    @lilypond[verbatim,quote,relative=2]

  Don't use any other relative=X commands.

- use "aes" and "ees" instead of "as" and "es".  I know it's not
  correct Dutch naming, but let's not confuse people with this
  until we get to the Basic notation chapter.

- Add "Music Glossary: @rglos{foo}" to the *top* of the relevant
  portions of the tutorial.

@end ignore


@c Translators: Nicolas Grandclaude, Ludovic Sardain, Gauvain Pocentek
@c Translation checkers: Jean-Charles Malahieude, Valentin Villenave, John Mandereau
@c Translation status: post-GDP

@node Tutorial
@chapter Tutorial

Ce tutoriel commence par une introduction au langage musical utilisé
par LilyPond, qui vous permettra de faire fonctionner le logiciel pour
produire une partition.  Après ce premier contact, nous verrons comment
créer des partitions utilisant une notation musicale courante.

@menu
* First steps::
* Single staff notation::
* Multiple notes at once::
* Songs::
* Final touches::
@end menu


@node First steps
@section First steps

Cette section présente les aspects élémentaires de l'utilisation de
LilyPond.

@menu
* Compiling a file::
* Simple notation::
* Working on input files::
* How to read the manual::
@end menu


@node Compiling a file
@subsection Compiling a file

@cindex compilation

Pour créer une partition avec LilyPond, on écrit un fichier texte,
appelé fichier source, qui décrit la notation musicale. La
@emph{compilation} de ce fichier source par LilyPond produit un
fichier graphique imprimable, et si on le désire un fichier MIDI qui
peut être joué par un séquenceur.  Voici un premier exemple simple de
fichier source LilyPond.

@example
@{
  c' e' g' e'
@}
@end example

@noindent
Le compilation de cette partition donnera quelque chose de sembable à
l'image ci-dessous.

@c  in this case we don't want verbatim
@lilypond[quote]
{
  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 "italiano.ly"}.
@c END DIV

@warning{Tout extrait de code LilyPond doit être entouré d'une
@strong{@{ paire d'accolades @}}.  De plus, pour éviter toute
ambiguïté, il est préférable d'entourer les accolades par des espaces
ou retours à la ligne.  Bien que certains exemples de ce manuel ne
comportent pas d'accolades, ne les oubliez pas dans vos partitions !
Pour plus d'informations sur l'affichage des exemples de cette
documentation, consultez @ref{How to read the manual}.}


@cindex casse, prise en compte de
@cindex prise en compte de la casse
@cindex sensibilité à la casse
De plus, LilyPond est @strong{sensible à la casse} : le code
@w{@code{@{ c d e @}}} est valide, alors que @w{@code{@{ C D E @}}}
produira un message d'erreur.

@smallspace

@subheading Entering music and viewing output

@cindex fichier PDF
@cindex PDF
@cindex partition, lire
@cindex lire la partition

Dans cette section nous expliquerons quelles commandes exécuter et
comment voir ou imprimer le résultat produit par LilyPond.

Notez qu'il existe plusieurs éditeurs de texte disponibles avec un bon
support de LilyPond ; consultez @rprogram{Text editor support}.

@warning{Le premier démarrage de LilyPond peut prendre une minute ou
deux, afin de faire la liste des polices du système.  LilyPond démarre
en principe plus rapidement lors des exécutions suivantes.}


@subsubheading MacOS X

Si vous double-cliquez sur @code{LilyPond.app}, un fichier d'exemple
s'ouvrira.  Sauvegardez-le, par exemple, sous @file{test.ly} sur votre
bureau, puis traitez-le avec la commande de menu @samp{Compile >
Typeset File}.  Le fichier PDF résultant sera alors affiché à l'écran.

À l'avenir, vous aurez certainement recours aux commandes @qq{Nouveau}
ou @qq{Ouvrir}.  Vous devez enregistrer votre fichier avant de lancer
la gravure de la partition par LilyPond.  Si une erreur apparaît
pendant le traitement, vous la trouverez dans la fenêtre @qq{log}.

@subsubheading Windows

Sous Windows, double-cliquez sur l'icône LilyPond qui se trouve sur le
bureau, un fichier d'exemple s'ouvre dans un simple éditeur de texte.
Enregistrez-le, par exemple en tant que @file{test.ly} sur le bureau,
puis double-cliquez sur son icône (qui montre une note de musique)
pour le traiter.  Après quelques secondes, vous obtiendrez un fichier
@file{test.pdf} sur le bureau, fichier que vous pourrez ouvrir pour
voir la partition gravée.  Une autre méthode pour lancer le traitement
du fichier @file{test.ly} est de le glisser avec votre souris sur
l'icône de LilyPond.

Pour modifier un fichier @file{.ly} existant, faites un clic droit
dessus et sélectionnez @qq{Éditer la source}.  Pour partir d'un
fichier vide, lancez l'éditeur en ouvrant un fichier existant et
utilisez la commande @qq{New} du menu @qq{File}.

En double-cliquant sur le fichier, vous obtiendrez, en plus du fichier
PDF, un fichier @file{.log} qui récapitule les opérations que LilyPond
a effectuées sur votre fichier.  Si une erreur survient, vous en
trouverez les détails dans ce fichier.

@subsubheading UNIX

Créez un fichier texte @file{test.ly} qui contient

@verbatim
{
  c' e' g' e'
}
@end verbatim

@noindent
Pour traiter @file{test.ly}, entrez la commande suivante dans un
terminal :

@example
lilypond test.ly
@end example

@noindent
Vous verrez quelque chose ressemblant à

@example
lilypond test.ly
GNU LilyPond @version{}
Traitement de « test.ly »
Analyse...
Interprétation en cours de la musique...
Pré-traitement des éléments graphiques...
Détermination du nombre optimal de pages...
Répartition de la musique sur une page...
Dessin des systèmes...
Sortie mise en page vers « test.ps »...
Conversion à « ./test.pdf »...
@end example

@c DIV specific
@noindent
Suivant votre installation, ces messages peuvent être traduits ou
non.
@c END DIV


@node Simple notation
@subsection Simple notation

Il y a certains éléments graphiques de notation que LilyPond ajoute
automatiquement.  Dans l'exemple suivant, nous n'avons fourni que
quatre hauteurs, mais LilyPond a ajouté une clé, un chiffre de mesure
et du rythme.

@lilypond[verbatim,quote]
{
  c' e' g' e'
}
@end lilypond

@noindent
Ces valeurs automatiques simplifient la saisie du code source dans
bien des cas ; nous verrons plus loin comment les indiquer
explicitement.


@subheading Hauteurs

Glossaire musical : @rglos{pitch}, @rglos{interval},
@rglos{scale}, @rglos{middle C}, @rglos{octave},
@rglos{accidental}.

Le moyen le plus simple d'entrer des notes est d'utiliser le mode
d'octaves relatives, ou mode @code{\relative}.  Dans ce mode, l'octave
de chaque note est sélectionnée automatiquement de façon à ce qu'elle
soit la plus proche possible de la note précédente, c'est-à-dire de
façon à ce que l'intervalle avec la note précédente soit au plus d'une
quarte.  Commençons par saisir une partition très simple, à savoir une
gamme.

@lilypond[verbatim,quote]
% set the starting point to middle C
\relative c' {
  c d e f
  g a b c
}
@end lilypond

La note de départ est le @notation{do central}.  Chacune des notes qui
suivent est placée à l'octave la plus proche de la note précédente ---
en d'autres termes, le premier @samp{c} est le do central, entre la
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 avec de plus
grands intervalles, toujours avec le mode @code{\relative} :

@lilypond[verbatim,quote]
\relative c' {
  d f a g
  c b f d
}
@end lilypond

@noindent
Remarquez que cet exemple ne commence plus sur le do central : la
première note --- le @samp{d} --- est le ré qui en est le plus proche.

Dans l'exemple suivant, on remplace @code{c'} dans la commande
@w{@code{\relative c'}} par @code{c''}, afin de calculer l'octave de
la première note par rapport au do situé une octave au-dessus du do
central :

@lilypond[verbatim,quote]
% one octave above middle C
\relative c'' {
  e c a c
}
@end lilypond

Le mode d'octaves relatives peut être déroutant au début, mais c'est
souvent la façon la plus économique de saisir les hauteurs en
utilisant le clavier de l'ordinateur de façon classique.  Détaillons
sur un exemple le calcul des octaves relatives.  En partant d'un si
sur la troisième ligne de la clé de sol, un do, un ré ou un mi sans
indication d'octave particulière seront placés juste au-dessus du si,
c'est-à-dire au plus à une quarte ascendante du si, alors qu'un la, un
sol ou un fa seront placés juste en-dessous du si, c'est-à-dire au
plus à une quarte descendante du si.

@lilypond[verbatim,quote]
\relative c'' {
  b c  % c is 1 staff space up, so is the c above
  b d  % d is 2 up or 5 down, so is the d above
  b e  % e is 3 up or 4 down, so is the e above
  b a  % a is 6 up or 1 down, so is the a below
  b g  % g is 5 up or 2 down, so is the g below
  b f  % f is 4 up or 3 down, so is the f below
}
@end lilypond

Notez que le calcul des octaves relatives @strong{ne dépend pas des
altérations} des notes, dièses bémols ou bécarre.

Pour obtenir des intervalles supérieurs à une quarte, on peut ajouter
des apostrophes @code{'} --- qui font chacune monter la hauteur d'une
octave --- ou des virgules @code{,} --- qui font chacune descendre la
hauteur d'une octave --- au nom de la note.

@lilypond[verbatim,quote]
\relative c'' {
  a a, c' f,
  g g'' a,, f'
}
@end lilypond

@noindent
Pour déplacer une note deux octaves (ou davantage !) plus haut ou plus
bas, il suffit de mettre deux (ou davantage) de @code{'} ou ou @code{,} ---
attention cependant à bien mettre deux apostrophes @code{''}, et non
un guillemet @code{"}@tie{}!  C'est de cette même manière que l'on
peut modifier la valeur de départ de @code{\relative c'}.


@subheading Durées et rythme

Glossaire musical : @rglos{beam}, @rglos{duration},
@rglos{whole note}, @rglos{half note}, @rglos{quarter note},
@rglos{dotted note}.

La @notation{durée} d'une note est indiquée par un nombre qui suit sa
hauteur : @samp{1} pour une @notation{ronde}, @samp{2} pour une
@notation{blanche}, @samp{4} pour une @notation{noire} et ainsi de
suite.  Les @notation{crochets} et @notation{liens} sont ajoutées
automatiquement.

Si aucune durée n'est indiquée pour une note, la dernière durée entrée
est utilisée.  En l'absence d'indication de durée, la première note
est une noire.

@lilypond[verbatim,quote]
\relative c'' {
  a1
  a2 a4 a8 a
  a16 a a a a32 a a a a64 a a a a a a a a2
}
@end lilypond

Une @notation{note pointée} s'obtient en ajoutant un point @code{.}  à
la valeur rythmique.  Le point doit être précédé d'un nombre de durée.

@lilypond[verbatim,quote]
\relative c'' {
  a a a4. a8
  a8. a16 a a8. a8 a4.
}
@end lilypond


@subheading Silences

Glossaire musical : @rglos{rest}.

On saisit un @notation{silence} tout comme une note, mais avec la
lettre @samp{r}.

@lilypond[verbatim,quote]
\relative c'' {
  a r r2
  r8 a r4 r4. r8
}
@end lilypond


@subheading Métrique

Glossaire musical : @rglos{time signature}.

La @notation{métrique}, aussi appelée @notation{chiffre de mesure},
peut être définie à l'aide de la commande @code{\time} :

@lilypond[verbatim,quote]
\relative c'' {
  \time 3/4
  a4 a a
  \time 6/8
  a4. a
  \time 4/4
  a4 a a a
}
@end lilypond


@subheading Clef

Glossaire musical : @rglos{clef}.

La @notation{clef} peut être définie à l'aide de la commande
@code{\clef} :

@lilypond[verbatim,quote]
\relative c' {
  \clef treble
  c1
  \clef alto
  c1
  \clef tenor
  c1
  \clef bass
  c1
}
@end lilypond


@subheading Tout ensemble

Voici un bref exemple qui rassemble tous les éléments que nous déjà
vus :

@lilypond[verbatim,quote]
\relative c, {
  \time 3/4
  \clef bass
  c2 e8 c' g'2.
  f4 e d c4 c, r4
}
@end lilypond

@seealso

Manuel de notation : @ruser{Writing pitches},
@ruser{Writing rhythms}, @ruser{Writing rests},
@ruser{Time signature}, @ruser{Clef}.


@node Working on input files
@subsection Working on input files

Le traitement des fichiers source de LilyPond est semblable à celui du
code de nombreux langages de programmation.  La casse est prise
en compte, et les caractères considérés comme espaces ont généralement
peu d'importance.  Les expressions sont délimitées par des accolades @{
@}, et les commentaires par @code{%} ou @code{%@{ ... %@}}.

Si cette phrase vous paraît incompréhensible, ne vous en faites pas !
Expliquons tous ces termes :

@itemize

@cindex casse, prise en compte de
@cindex prise en compte de la casse
@cindex sensibilité à la casse
@item @strong{La casse} :
LilyPond est sensible à la casse, c'est à dire qu'une lettre capitale
n'a pas la même valeur qu'une lettre minuscule.  Les notes, par
exemple, doivent être entrées en minuscules : @code{@{ c d e @}} est
un code valide, alors que @code{@{ C D E @}} produira un message
d'erreur.

@item @strong{Les espaces multiples} :
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
Bien sûr, ce dernier exemple est illisible.  Une bonne habitude
à prendre est d'indenter les blocs de code avec soit des tabulations
soit des doubles espaces :

@example
@{
  c d e
@}
@end example

@item @strong{Expressions musicales} :
Tout morceau saisi dans LilyPond doit être placé entre @strong{@{
accolades @}}.  Ces caractères indiquent à LilyPond que ce bloc de
texte représente une et une seule expression musicale, tout comme les
parenthèses @samp{()} en mathématiques.  Pour éviter toute ambiguïté,
il est préférable d'entourer ces accolades d'espaces ou de retours à
la ligne.

Un appel de fonction --- @w{@code{\relative @{ @}}} par exemple ---
compte également comme une seule expression musicale.

@cindex commentaire
@cindex commentaire de fin de ligne
@cindex commentaire-bloc
@cindex bloc de commentaire
@item @strong{Les commentaires} :
un commentaire est une indication pour tout lecteur humain d'un
fichier source de musique ; il est ignoré par l'ordinateur, et n'a
donc aucun effet sur la partition imprimée.  On distingue deux types
de commentaires.  Le commentaire de fin de ligne, introduit par le
symbole @samp{%} : tout ce qui suit ce symbole sur la même ligne sera
ignoré.  Par convention, un commentaire qui occupe une ligne entière
se place juste @emph{au-dessus} de la ligne à laquelle il fait
référence.

@example
a4 a a a
% ce commentaire fait référence aux sis
b2 b
@end example

Le bloc de commentaire, qui peut occuper plusieurs lignes voire toute
une section : tout ce qui se trouve entre @code{%@{} et @code{%@}} est
ignoré.  Les blocs de commentaires ne peuvent s'imbriquer, ce qui
signifie que vous ne pouvez pas placer un commentaire-bloc à
l'intérieur d'un autre commentaire-bloc.  Si jamais vous essayez, vous
verrez que la première occurence de @code{%@}} terminera @qq{les
@emph{deux} commentaires-blocs}.  Le fragment suivant met en évidence
quelques usages possibles des commentaires :

@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.

   f f e e d d c2
%@}
@end example

@end itemize



@node How to read the manual
@subsection How to read the manual

Comme nous l'avons vu dans @ref{Working on input files}, un code
LilyPond doit être encadré par des accolades @{ @} ou bien par
@code{\relative c'' @{ ...  @}}.  Cependant, dans la suite de ce
manuel, la plupart des exemples ne feront pas apparaître ces signes.

Pour reproduire les exemples, vous pouvez copier et coller le code
affiché, mais @strong{à condition} d'ajouter @code{\relative c'' @{
@}} de la façon suivante :

@example
\relative c'' @{
  ...collez ici votre exemple...
@}
@end example

Pourquoi avoir omis les accolades ?  La plupart des exemples de ce
manuel peuvent être insérés au milieu d'un morceau de musique plus
long.  Il n'y a donc aucune raison d'ajouter @code{\relative c'' @{
@}} à ces exemples --- en effet, il n'est pas possible d'insérer une
expression @code{\relative} à l'intérieur d'un autre expression
@code{\relative}.  Si nous mettions tous nos exemples dans une
expression @code{\relative}, vous ne pourriez plus copier un bref
exemple de la documentation pour le coller dans vos pièces.


@subheading Exemples cliquables

Beaucoup de gens apprennent à  utiliser les programmes en les essayant
et en bidouillant avec.  C'est également possible avec LilyPond.  Si
vous cliquez sur une image dans la version HTML de ce manuel, vous
verrez exactement le code LilyPond utilisé pour générer cette image.
Essayez sur cette image :

@c no verbatim here
@c KEEP LY
@lilypond[quote,ragged-right]
\relative c'' {
  c-\markup { \bold \huge { Cliquez ici.  } }
}
@end lilypond

En copiant-collant le code à partir du commentaire @qq{ly snippet}
vers un fichier test, vous aurez un modèle de base pour faire vos
expériences.  Pour obtenir une gravure à l'identique, copiez tout le
code à partir de @qq{Start cut-&-pastable section}.

@c No longer in the text in English, but should we really
@c remove this? --jm
@ignore
Si vous apprenez de cette façon, vous aurez probablement envie
d'imprimer ou de garder un lien vers @ruser{Cheat sheet}, tableau
qui répertorie les commandes usuelles pour une consultation rapide.
@end ignore

@seealso

Vous trouverez plus de conseils pour construire des fichiers source
dans @ref{Suggestions for writing LilyPond input files}.  Cependant,
lors d'une première lecture il est préférable de terminer d'abord la
lecture du tutoriel.


@node Single staff notation
@section Single staff notation

Cette section présente la notation courante dont on a besoin pour
écrire une voix sur une portée.

@menu
* Accidentals and key signatures::
* Ties and slurs::
* Articulation and dynamics::
* Adding text::
* Automatic and manual beams::
* Advanced rhythmic commands::
@end menu


@node Accidentals and key signatures
@subsection Accidentals and key signatures

@subheading Accidentals

Glossaire musical : @rglos{sharp}, @rglos{flat}, @rglos{double sharp},
@rglos{double flat}, @rglos{accidental}.

Dans la notation par défaut, on obtient un @notation{dièse} en
ajoutant @code{is} au nom de la note, et un @notation{bémol} en
ajoutant @code{es}.  Comme vous pouvez vous y attendre, un double
dièse ou double bémol s'obtiennent en ajoutant @code{isis} ou
@code{eses}.  Cette syntaxe est dérivée de la convention de
dénomination des notes dans les langues nordiques et germaniques,
comme l'allemand ou le hollandais.

@c DIV specific
Cependant, si vous utilisez la commande @code{\include "italiano.ly"}
pour entrer les noms de notes français au lieu des noms hollandais, il
faudra ajouter un @code{d} pour obtenir un dièse, et un @code{b} pour
un bémol.  Le double dièse et le double bémol s'obtiennent en ajoutant
respectivement @code{dd} et @code{bb}.  Pour en savoir plus sur les
autres langues disponibles, consultez @ruser{Note names in other
languages}.
@c END DIV

@lilypond[verbatim,quote,relative=2]
cis1 ees fisis, aeses
@end lilypond

@cindex armure, définition de l'
@cindex armure, altérations à l'
@cindex altérations à l'armure
@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[verbatim,quote,relative=2]
\key d \major
a1
\key c \minor
a
@end lilypond

@smallspace

@subheading Warning: key signatures and pitches

Glossaire musical : @rglos{accidental}, @rglos{key signature},
@rglos{pitch}, @rglos{flat}, @rglos{natural}, @rglos{sharp},
@rglos{transposition}.

La combinaison de l'@notation{armure} et des hauteurs de note --- y
compris les altérations --- permet à LilyPond de déterminer dans quel
cas imprimer des @notation{altérations accidentelles}.  L'armure
n'affecte que les altérations @emph{imprimées}, et non les hauteurs
réelles ! Cette fonctionnalité est souvent source de confusion pour
les nouveaux utilisateurs, aussi expliquons-la en détail.

LilyPond fait une distinction nette entre le contenu musical et la
mise en forme.  L'altération d'une note --- @notation{bémol},
@notation{bécarre} ou @notation{dièse} --- fait partie de sa hauteur,
et relève donc du contenu musical.  La gravure ou non d'une altération
accidentelle --- un @emph{signe} bémol, bécarre ou dièse --- devant la
note correspondante est une question qui relève de la mise en forme.
La gravure une partition suit des règles, en particulier des règles
d'indication des altérations accidentelles.  Les hauteurs de note, en
revanche, relèvent de ce que vous voulez entendre ; et, dans la mesure
où la musique que vous entrez est censée être celle que vous voulez
entendre, LilyPond, qui n'est chargé que de la gravure, ne les
choisira pas à votre place.

Dans cet exemple,

@lilypond[verbatim,quote,relative=2]
\key d \major
d cis fis
@end lilypond

@noindent
aucune note n'a d'altération accidentelle, et pourtant vous devrez
entrer le @code{is} pour les notes @code{cis} et @code{fis}.

Le code @code{e} ne veut pas dire @qq{Imprimez-moi un point noir sur
la première ligne de la portée.}  Cela signifie plutôt : @qq{Ici se
trouve une note dont la hauteur est un mi naturel.}  Avec une armure
de la bémol majeur, ce mi est flanqué d'un bécarre accidentel :

@lilypond[verbatim,quote,relative=2]
\key aes \major
e
@end lilypond

Ajouter explicitement toutes les altérations demande un peu plus
d'effort dans la phase de saisie, mais cela facilite grandement la
@notation{transposition}.  De plus, les altérations accidentelles
peuvent ainsi être imprimées suivant plusieurs conventions.  Pour
connaître les différentes manières dont les altérations accidentelles
peuvent être imprimées, consultez @ruser{Automatic accidentals}.

@seealso

Manuel de notation : @ruser{Note names in other languages},
@ruser{Accidentals}, @ruser{Automatic accidentals},
@ruser{Key signature}.

Glossaire musical : @rglos{Pitch names}.

@node Ties and slurs
@subsection Ties and slurs

@cindex liaisons de prolongation
@cindex liaisons de tenue
@cindex prolongation, liaisons de
@cindex durée, liaisons de
@cindex tenue, liaisons de
@subheading Ties

Glossaire musical : @rglos{tie}.

Pour créer une liaison de prolongation@footnote{parfois aussi appelée
liaison de tenue}, on ajoute un tilde @code{~} à la première note
liée.

@lilypond[verbatim,quote,relative=2]
g4~ g c2~
c4 ~ c8 a8 ~ a2
@end lilypond

@cindex liaisons d'articulation
@cindex articulation, liaisons d'
@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é.

Glossaire musical : @rglos{slur}.

Une liaison d'articulation ou @emph{legato} peut englober
plusieurs notes.  Les notes de départ et d'arrivée sont suivies
respectivement d'un signe @samp{(} et @samp{)}.

@lilypond[verbatim,quote,relative=2]
d4( c16) cis( d e c cis d) e( d4)
@end lilypond

@cindex liaisons de phrasé
@cindex phrasé, liaisons de
@cindex legato
@subheading Phrasing slurs

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[verbatim,quote,relative=2]
a8(\( ais b c) cis2 b'2 a4 cis,\)
@end lilypond

@smallspace

@cindex liaisons d'articulation et de prolongation, différences
@subheading Warnings: slurs vs. ties

Glossaire musical : @rglos{articulation}, @rglos{slur}, @rglos{tie}.

Une liaison d'articulation ou de phrasé ressemble à une liaison de
prolongation, mais n'a pas la même signification.  Alors qu'une
liaison de prolongation ne peut relier que deux notes de même hauteur,
le legato indique une articulation de plusieurs notes, éventuellement
en grand nombre.  Les liaisons de tenue peuvent être enchâssées dans
un legato ou un phrasé.

@lilypond[verbatim,quote,relative=2]
c2~( c8 fis fis4 ~ fis2 g2)
@end lilypond

@seealso

Manuel de notation : @ruser{Ties}, @ruser{Slurs},
@ruser{Phrasing slurs}.

@node Articulation and dynamics
@subsection Articulation and dynamics

@cindex articulation
@cindex accents
@cindex staccato
@subheading Articulations

Glossaire musical : @rglos{articulation}.

Des @notation{articulations} peuvent être ajoutées à une note, au moyen
d'un tiret @code{-} suivi d'un caractère :

@lilypond[verbatim,quote,relative=2]
c-. c-- c-> c-^ c-+ c-_
@end lilypond

@cindex doigtés
@subheading Fingerings

Glossaire musical : @rglos{fingering}.

De même, des indications de doigté peuvent être ajoutées à une note en
utilisant un tiret (@samp{-}) et le chiffre à écrire :

@lilypond[verbatim,quote,relative=2]
c-3 e-5 b-2 a-1
@end lilypond

Articulations et doigtés sont habituellement placés automatiquement,
mais vous pouvez indiquer 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 bon de laisser LilyPond déterminer l'emplacement de
l'articulation.

@lilypond[verbatim,quote,relative=2]
c_-^1 d^. f^4_2-> e^-_+
@end lilypond

@subheading Dynamics

Glossaire musical : @rglos{dynamics}, @rglos{crescendo},
@rglos{decrescendo}.

On obtient un signe de @notation{nuance} en ajoutant à la note les
lettres du signe, précédées d'un anti-slash @samp{\} :

@lilypond[verbatim,quote,relative=2]
c\ff c\mf c\p c\pp
@end lilypond

@cindex nuances
@cindex decrescendo
@cindex crescendo

@c Pluriel des termes musicaux italiens :
@c selon Littré, plutôt à la française (en "-os" qu'en "-i")

@notation{Crescendos} et @notation{decrescendos} débutent avec les
commandes @code{\<} et @code{\>}.  Ils se terminent soit par une
nuance d'arrivée, par exemple @code{\f}, soit par la commande
@code{\!} :

@lilypond[verbatim,quote,relative=2]
c2\< c2\ff\> c2 c2\!
@end lilypond

@seealso

Manuel de notation : @ruser{Articulations and ornamentations},
@ruser{Fingering instructions}, @ruser{Dynamics}.


@node Adding text
@subsection Adding text

On peut ajouter du texte à une partition :

@lilypond[verbatim,quote,relative=2]
c1^"espr" a_"legato"
@end lilypond

Pour mettre en forme du texte, on utilise la commande @code{markup} :

@lilypond[verbatim,quote,relative=2]
c1^\markup{ \bold espr}
a1_\markup{
  \dynamic f \italic \small { 2nd } \hspace #0.1 \dynamic p
}
@end lilypond

@seealso

Manuel de notation : @ruser{Writing text}.


@node Automatic and manual beams
@subsection Automatic and manual beams

@cindex ligatures manuelles

Glossaire musical : @rglos{beam}.

Toutes les barres de ligature sont dessinées automatiquement :

@lilypond[verbatim,quote,relative=2]
a8 ais d ees r d c16 b a8
@end lilypond

@noindent
Lorsqu'on n'aime pas la manière dont les notes sont automatiquement
groupées, il est possible de les ligaturer manuellement, en marquant la
première note à attacher d'un crochet ouvrant @code{[} et la dernière
d'un crochet fermant @code{]}.

@lilypond[verbatim,quote,relative=2]
a8[ ais] d[ ees r d] a b
@end lilypond

Pour désactiver les barres de ligature automatqiues pour des passages
entiers, utilisez la commande @code{\autoBeamOff}, et utilisez
@code{\autoBeamOn} pour les réactiver.

@lilypond[verbatim,quote,relative=2]
\autoBeamOff
a8 c b4 d8. c16 b4
\autoBeamOn
a8 c b4 d8. c16 b4
@end lilypond

@seealso

Manuel de notation : @ruser{Automatic beams}, @ruser{Manual beams}.


@node Advanced rhythmic commands
@subsection Advanced rhythmic commands

@cindex levée
@cindex anacrouse
@cindex mesure incomplète
@subheading Partial measure

Glossaire musical : @rglos{anacrusis}.

On crée une levée (ou anacrouse) avec la commande @code{\partial},
suivie d'une durée : @code{\partial 4} produit une levée d'une noire
et @code{\partial 8} d'une croche.

@lilypond[verbatim,quote,relative=2]
\partial 8
f8 c2 d
@end lilypond

@cindex nolets
@cindex triolets
@subheading Tuplets

Glossaire musical : @rglos{note value}, @rglos{triplet}.

Les @notation{nolets} sont créés avec la commande @code{\times}, qui
prend deux arguments : une fraction et une expression musicale.  La
durée des notes de l'expression musicale est multipliée par la
fraction.  Par exemple les notes d'un @notation{triolet} durent les
deux tiers de la durée de leur notation réelle, cette fraction est
donc de 2/3 pour les triolets :

@lilypond[verbatim,quote,relative=2]
\times 2/3 { f8 g a }
\times 2/3 { c r c }
\times 2/3 { f,8 g16[ a g a] }
\times 2/3 { d4 a8 }
@end lilypond

@cindex notes d'ornement
@cindex ornementation
@cindex appoggiature
@cindex acciaccature
@subheading Grace notes

Glossaire musical : @rglos{grace notes}, @rglos{acciaccatura},
@rglos{appoggiatura}.

Des @notation{notes d'ornement} s'obtiennent en appliquant la commande
@code{\grace}, @code{\appoggiatura} ou @code{\acciaccatura} à une
expression musicale :

@lilypond[verbatim,quote,relative=2]
c2 \grace { a32[ b] } c2
c2 \appoggiatura b16 c2
c2 \acciaccatura b16 c2
@end lilypond

@seealso

Manuel de notation : @ruser{Grace notes}, @ruser{Tuplets},
@ruser{Upbeats}.


@node Multiple notes at once
@section Multiple notes at once

Cette section traite de situations où l'on a plus d'une note à la fois :
plusieurs instruments, plusieurs voix ou portées pour un même
instrument (le piano, par exemple), et les accords.

En théorie musicale, la polyphonie désigne une musique constituée de
plusieurs voix ; dans LilyPond, ce terme désigne les situations où il
y a plus d'une voix sur une même portée.

@menu
* Music expressions explained::
* Multiple staves::
* Staff groups::
* Combining notes into chords::
* Single staff polyphony::
@end menu


@node Music expressions explained
@subsection Music expressions explained

@cindex expression musicale

Dans les fichiers source LilyPond, la musique est représentée par ce
qu'on appelle des @emph{expressions musicales}.  En soi, une seule note
peut constituer une expression musicale :

@lilypond[verbatim,quote,relative=2]
a4
@end lilypond

Mettre un groupe de notes entre accolades crée une nouvelle expression
musicale, appelée @emph{expression musicale composée}.  En voici un
exemple avec deux notes :

@lilypond[verbatim,quote,relative=2]
{ a4 g4 }
@end lilypond

La mise entre accolades d'une séquence d'expressions musicales --- des
notes par exemple --- signifie qu'elles doivent être jouées
successivement, les unes après les autres.  Le résultat est une
expression, qui peut elle-même être regroupée séquentiellement avec
d'autres expressions.  Ici, l'expression de l'exemple précédent est
combinée à deux notes :

@lilypond[verbatim,quote,relative=2]
{ { a4 g } f g }
@end lilypond

@cindex expression
@subheading Analogy: mathematical expressions

Ce mécanisme est similaire aux formules mathématiques : une grosse
formule est créée en assemblant plusieurs petites formules.  De telles
formules sont appelées expressions, elles ont une définition
récursive, de telle sorte que vous pouvez fabriquer des expressions
arbitrairement longues et complexes.  Par exemple :

@example
1

1 + 2

(1 + 2) * 3

((1 + 2) * 3) / (4 * 5)
@end example

Ceci est une suite d'expressions, où chacune est contenue dans la
suivante.  Les expressions les plus simples sont les nombres, et de
plus grandes expressions sont produites en combinant des expressions
avec des opérateurs --- comme @samp{+}, @samp{*} et @samp{/} --- et
des parenthèses.  Tout comme les expressions mathématiques, les
expressions musicales peuvent être imbriquées avec une profondeur
arbitraire, ce qui est nécessaire pour des partitions complexes comme
de la musique polyphonique.


@subheading Simultaneous music expressions: multiple staves

Glossaire musical : @rglos{polyphony}.

Cette technique est utile pour de la musique @notation{polyphonique}.
Pour entrer une musique avec plusieurs voix ou plusieurs portées, nous
pouvons aussi combiner @emph{en parallèle} les expressions : deux voix
qui doivent être jouées en même temps, sont entrées comme une
combinaison simultanée de deux expressions.  Une expression musicale
@qq{simultanée} est formée en entourant les expressions entre @code{<<}
et @code{>>}.  Dans l'exemple suivant, trois expressions (contenant
chacune deux notes distinctes) sont combinées simultanément.

@lilypond[verbatim,quote]
\relative c'' {
  <<
    { a4 g }
    { f e }
    { d b }
  >>
}
@end lilypond

Notez que nous avons ici indenté chaque niveau du fichier d'entrée
avec un nombre d'espaces différent.  LilyPond se moque --- ou presque
--- de l'espace qu'il peut y avoir ou non au début d'une ligne, mais
un code bien indenté est bien plus lisible par des humains.

@warning{la hauteur de chaque note saisie est relative à la précédente,
mais pas au @code{c''} de la commande @code{\relative} de départ.}


@subheading Simultaneous music expressions: single staff

Pour déterminer le nombre de portées, LilyPond regarde le début
de la première expression.  Si c'est une seule note, une seule portée
est produite ; si c'est une expression simultanée, plusieurs portées
sont produites.

@lilypond[verbatim,quote]
\relative c'' {
  c2 <<c e>>
  << { e f } { c <<b d>> } >>
}
@end lilypond


@node Multiple staves
@subsection Multiple staves

Comme nous l'avons vu dans @ref{Music expressions explained}, un
fichier d'entrée LilyPond est fait d'expressions musicales.  Si la
partition commence par plusieurs expressions simultanées, LilyPond
créera plusieurs portées.  Cependant, il est plus facile de prévoir le
nombre de portées si on les crée explicitement, ce que nous allons
voir.

Pour créer plus d'une portée, on ajoute @code{\new Staff} au début de
chaque partie de la musique constituant une portée.  Ces éléments
@code{Staff} sont ensuite combinés en parallèle avec @code{<<} et
@code{>>}, comme ci-dessous.

@lilypond[verbatim,quote]
\relative c'' {
  <<
    \new Staff { \clef treble c }
    \new Staff { \clef bass c,, }
  >>
}
@end lilypond


La commande @code{\new} introduit un @qq{contexte de notation}.  Un
contexte de notation est un environnement dans lequel les événements
musicaux --- comme les notes ou les commandes @code{\clef} --- sont
interprétés.  Pour des pièces simples, ces contextes sont créés
automatiquement.  Pour des pièces plus complexes, il est préférable de
spécifier explicitement les contextes, afin de s'assurer que chaque
fragment aura sa propre portée.

Il existe différents types de contextes.  Les contextes @code{Score}
(partition), @code{Staff} (portée) et @code{Voice} (voix) gèrent la
notation de la mélodie, alors que @code{Lyrics} gère les paroles et
@code{ChordNames} imprime des noms d'accords.

En termes de syntaxe, ajouter @code{\new} devant une expression
musicale crée une plus grande expression musicale.  En reprenant la
comparaison précédente, cela ressemble au signe @emph{moins} en
mathématiques.  La formule @math{(4+5)} est une expression, donc
@math{-(4+5)} est une plus grande expression.

Les chiffres de métrique indiqués sur une portée affectent toutes les
autres portées@footnote{Ce comportement peut être modifié si
nécessaire, voir @ruser{Polymetric notation}.}.  En revanche l'armure
d'une portée n'affecte @emph{pas} les autres portées.  Ces
caractéristiques par défaut se justifient par le fait que
l'utilisation d'instruments transpositeurs est bien plus fréquente que
la musique polyrythmique.

@lilypond[verbatim,quote]
\relative c'' {
  <<
    \new Staff { \clef treble \key d \major \time 3/4 c }
    \new Staff { \clef bass c,, }
  >>
}
@end lilypond


@node Staff groups
@subsection Staff groups

@cindex portée double
@cindex portée pour piano
@cindex piano, portée pour
@cindex clavier, portée pour

Glossaire musical : @rglos{brace}.

La musique pour piano s'écrit sur deux portées reliées par une
@notation{accolade}.  La gravure de ce type de portée est semblable à
l'exemple de musique polyphonique de @ref{Multiple staves}, mais
maintenant cette expression entière est interprétée dans un contexte
@code{PianoStaff} :

@example
\new PianoStaff <<
  \new Staff @dots{}
  \new Staff @dots{}
>>
@end example

Voici un bref exemple :

@lilypond[verbatim,quote]
\relative c'' {
  \new PianoStaff <<
    \new Staff { \time 2/4 c4 e g g, }
    \new Staff { \clef bass c,, c' e c }
  >>
}
@end lilypond

@seealso

Manuel de notation : @ruser{Keyboard instruments},
@ruser{Displaying staves}.


@node Combining notes into chords
@subsection Combining notes into chords

@cindex accords, notes simultanées

Glossaire musical : @rglos{chord}.

Nous avons vu précédemment comment combiner des notes simultanément,
en les encadrant par des angles doubles @code{<<} et @code{>>}.  Pour
produire des accords simples, c'est-à-dire une superposition de notes
de même durée, on encadre les hauteurs de notes par des angles simples
@code{<} et @code{>}, et on écrit la durée juste après.

@lilypond[verbatim,quote,relative=2]
r4 <c e g>4 <c f a>2
@end lilypond

Beaucoup d'éléments de notation que l'on peut attacher à une note
simple, comme une liaison, un crochet indiquat un début ou fin de
lien, un signe d'articulation, peuvent être également attachés à un
accord : il faut ajouter ces indications après les hauteurs et la
durée, donc @emph{à l'extérieur} des angles.

@lilypond[verbatim,quote,relative=2]
r4 <c e g>8[ <c f a>]~ <c f a>2
r4 <c e g>8( <c e g>\> <c e g>4 <c f a>\!)
@end lilypond


@node Single staff polyphony
@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.

On réalise ce type de partition en entrant chaque voix comme une
séquence, @emph{i.e.} avec @code{@{...@}}, puis en combinant
simultanément les voix et en les séparant par @code{\\}.

@lilypond[verbatim,quote,relative=2]
<<
  { a4 g2 f4~ f4 } \\
  { r4 g4 f2 f4 }
>>
@end lilypond

Pour l'écriture de musique polyphonique, les silences invisibles
s'avèrent bien pratiques : ce sont des silences qui ne s'impriment pas.
Ils sont utiles pour remplir des voix qui, temporairement, ne jouent
rien.  Voici le même exemple que ci-dessus, avec un silence invisible
@code{s} à la place d'un silence normal @code{r} :

@lilypond[verbatim,quote,relative=2]
<<
  { a4 g2 f4~ f4 } \\
  { s4 g4 f2 f4 }
>>
@end lilypond

@noindent
Là encore, ces expressions peuvent s'imbriquer arbitrairement :

@lilypond[verbatim,quote,relative=2]
<<
  \new Staff <<
    { a4 g2 f4~ f4 } \\
    { s4 g4 f2 f4 }
  >>
  \new Staff <<
    \clef bass
    { <c g>1 ~ <c g>4 } \\
    { e,,4 d e2 ~ e4}
  >>
>>
@end lilypond

@seealso

Manuel de notation : @ruser{Simultaneous notes}.


@node Songs
@section Songs

Cette section présente l'écriture vocale et les partitions de variété.

@menu
* Setting simple songs::
* Aligning lyrics to a melody::
* Lyrics to multiple staves::
@end menu


@node Setting simple songs
@subsection Setting simple songs

@cindex paroles
@cindex chansons

Glossaire musical : @rglos{lyrics}.

Prenons une mélodie toute simple, la comptine @emph{Girls and boys
come out to play}.

@lilypond[verbatim,quote]
\relative c'' {
  \key g \major
  \time 6/8
  d4 b8 c4 a8 d4 b8 g4
}
@end lilypond

Des @notation{paroles} peuvent être associées à ces notes, en les
combinant avec la commande @code{\addlyrics}.  On entre les paroles en
séparant chaque syllable par un espace :

@lilypond[verbatim,quote]
<<
  \relative c'' {
    \key g \major
    \time 6/8
    d4 b8 c4 a8 d4 b8 g4
  }
  \addlyrics {
    Girls and boys come out to play,
  }
>>
@end lilypond

Remarquez les accolades embrassant la musique et celles embrassant les
paroles, ainsi que les angles doubles encadrant toute la pièce ; ces
derniers indiquent simplement que la musique et les paroles se
produisent en même temps.


@node Aligning lyrics to a melody
@subsection Aligning lyrics to a melody

@cindex mélisme
@cindex ligne d'extension
@cindex trait d'union (paroles)
@cindex caractère souligné (paroles)
Glossaire musical : @rglos{melisma}, @rglos{extender line}.

La ligne suivante de la comptine précédente est @emph{The moon doth
shine as bright as day}.  Ajoutons-la au code.

@lilypond[verbatim,quote]
<<
  \relative c'' {
    \key g \major
    \time 6/8
    d4 b8 c4 a8 d4 b8 g4
    g8 a4 b8 c b a d4 b8 g4.
  }
  \addlyrics {
    Girls and boys come out to play,
    The moon doth shine as bright as day;
  }
>>
@end lilypond

Remarquez que les paroles ajoutées ne s'alignent pas bien avec les
notes.  Le mot @emph{shine} devrait être chanté sur deux notes au lieu
d'une. On appelle ceci un @notation{mélisme} : il s'agit d'une seule
syllabe chantée sur plus d'une note.  Il existe plusieurs façons
d'étaler une sylabe sur plusieurs notes, la plus simple étant de lier
les notes du mélisme.  Pour les détails, consultez @ref{Ties and
slurs}.

@lilypond[verbatim,quote]
<<
  \relative c'' {
    \key g \major
    \time 6/8
    d4 b8 c4 a8 d4 b8 g4
    g8 a4 b8 c( b) a d4 b8 g4.
  }
  \addlyrics {
    Girls and boys come out to play,
    The moon doth shine as bright as day;
  }
>>
@end lilypond

Les paroles sont maintenant correctement alignées, mais les liens de
croche automatiques ne conviennent pas pour les notes au-dessus de
@emph{shine as}.  On peut les corriger en ajoutant des liens de croche
manuels, pour ceci consultez @ref{Automatic and manual beams}.

@lilypond[verbatim,quote]
<<
  \relative c'' {
    \key g \major
    \time 6/8
    d4 b8 c4 a8 d4 b8 g4
    g8 a4 b8 c([ b]) a d4 b8 g4.
  }
  \addlyrics {
    Girls and boys come out to play,
    The moon doth shine as bright as day;
  }
>>
@end lilypond

Au lieu d'utiliser une liaison, on peut indiquer le mélisme dans les
paroles en insérant un caractère souligné @code{_} pour chaque note du
mélisme sauf la première.

@lilypond[verbatim,quote]
<<
  \relative c'' {
    \key g \major
    \time 6/8
    d4 b8 c4 a8 d4 b8 g4
    g8 a4 b8 c[ b] a d4 b8 g4.
  }
  \addlyrics {
    Girls and boys come out to play,
    The moon doth shine _ as bright as day;
  }
>>
@end lilypond

Si une syllabe s'étend sur un grand nombre de notes ou une note très
longue, on représente souvent le mélisme par un @notation{trait de
prolongation}, qu'on entre avec @code{__}.  L'exemple suivant montre
les trois premières mesures de la plainte de Didon, extraite de
@emph{Didon et Énée} de Purcell.

@lilypond[verbatim,quote]
<<
  \relative c'' {
    \key g \minor
    \time 3/2
    g2 a bes bes( a)
    b c4.( bes8 a4. g8 fis4.) g8 fis1
  }
  \addlyrics {
    When I am laid,
    am laid __ in earth,
  }
>>
@end lilypond

Aucun exemple jusqu'à présent n'a utilisé de mots de plus d'une
syllabe.  Dans des paroles, de tels mots sont écrits en syllabes
séparées par des traits d'union.  Avec LilyPond, on utilise deux
tirets pour produire un trait d'union centré entre deux syllabes.
L'exemple suivant montre tout ce que nous avons vu jusqu'à maintenant
sur l'alignement de paroles à une mélodie.

@c no ragged-right here because otherwise the hyphens get lost,
@c but the example is long enough to avoid looking strange.
@lilypond[verbatim,quote,noragged-right]
<<
  \relative c' {
    \key g \major
    \time 3/4
    \partial 4
    d4 g4 g a8( b) g4 g4
    b8( c) d4 d e4 c2
  }
  \addlyrics {
    A -- way in a __ man -- ger,
    no __ crib for a bed, __
  }
>>
@end lilypond

Avec certaines paroles, en particulier en italien, il se produit la
situation inverse : il peut y avoir plusieurs syllabes sur une seule
note.  On réalise ceci avec LilyPond grâce à un caractère souligné
@code{_} sans espace entre les syllabes, ou alors en groupant les
syllabes avec des guillemets.  L'exemple suivant est extrait de l'air
de Figaro @emph{Largo al factotum}, dans @emph{Figaro} de Rossini, où
la syllabe @emph{al} est chantée sur la même note que @emph{go}.

@c no ragged-right here because otherwise the hyphens get lost,
@c but the example is long enough to avoid looking strange.
@lilypond[verbatim,quote,noragged-right]
<<
  \relative c' {
    \clef bass
    \key c \major
    \time 6/8
    c4.~ c8 d b c([ d]) b c d b c
  }
  \addlyrics {
    Lar -- go_al fac -- to -- tum del -- la cit -- tà
  }
>>
@end lilypond

@seealso

Manuel de notation : @ruser{Vocal music}.


@node Lyrics to multiple staves
@subsection Lyrics to multiple staves

La méthode simple d'ajout de paroles avec @code{\addlyrics} peut être
également utilisée pour placer des paroles sous plusieurs portées.
L'exemple suivant est extrait de @emph{Judas Macchabée} de Händel.

@lilypond[verbatim,quote]
<<
  \relative c'' {
    \key f \major
    \time 6/8
    \partial 8
    c8 c([ bes]) a a([ g]) f f'4. b, c4.~ c4
  }
  \addlyrics {
    Let flee -- cy flocks the hills a -- dorn, __
  }
  \relative c' {
    \key f \major
    \time 6/8
    \partial 8
    r8 r4. r4 c8 a'([ g]) f f([ e]) d e([ d]) c bes'4
  }
  \addlyrics {
    Let flee -- cy flocks the hills a -- dorn,
  }
>>
@end lilypond

Pour produire des partitions plus complexes ou plus longues que cet
exemple simple, il est vivement conseillé de séparer la structure de
la partition des notes et paroles, grâce à des variables.  Ceci sera
détaillé plus loin dans @ref{Organizing pieces with variables}.

@seealso

Manuel de notation : @ruser{Vocal music}.



@node Final touches
@section Final touches

L'ultime section de ce tutoriel montre comment ajouter une touche
finale à des morceaux simples, et constitue une introduction au reste
du manuel.

@menu
* Organizing pieces with variables::
* Version number::
* Adding titles::
* Absolute note names::
* After the tutorial::
@end menu


@node Organizing pieces with variables
@subsection Organizing pieces with variables

Lorsque l'on combine tous les éléments étudiés précédemment pour
écrire des partitions plus longues, les expressions musicales prennent
de l'ampleur et, dans le cas des pièces polyphoniques, deviennent
profondément imbriquées, jusqu'au point où il devient difficile de se
repérer dans le fichier source.  Cet inconvénient peut être résolu par
l'utilisation de @emph{variables}.

En utilisant des variables, parfois appelées identificateurs ou
macros, on peut scinder des expressions musicales complexes en des
expressions plus simples.  Une variable se définit comme suit :

@example
musiqueToto = @{ @dots{} @}
@end example

Le contenu de l'expression musicale @code{musiqueToto} pourra être
utilisé plus loin en faisant précéder son nom d'un anti-slash,
c'est-à-dire @code{\musiqueToto}, tout comme n'importe quelle commande
LilyPond.  Toute variable doit être définie @emph{avant} son
utilisation dans une autre expression musicale.

@lilypond[verbatim,quote]
violin = \new Staff {
  \relative c'' {
    a4 b c b
  }
}
cello = \new Staff {
  \relative c {
    \clef bass
    e2 d
  }
}
{
  <<
    \violin
    \cello
  >>
}
@end lilypond

@noindent
Le nom d'une variable ne doit comporter que des caractères
alphabétiques non accentués, aucun nombre ni tiret ne sont autorisés.

On peut utiliser une variable déjà définie autant de fois que l'on
veut, y compris dans la définition d'une nouvelle variable ; par
exemple, cela peut servir à saisir un motif qu'une seule fois, même
s'il se répète un grand nombre de fois dans la pièce.

@lilypond[verbatim,quote]
tripletA = \times 2/3 { c,8 e g }
barA = { \tripletA \tripletA \tripletA \tripletA }

\relative c'' {
 \barA \barA
}
@end lilypond

Il est possible d'utiliser des variables de types variés.  Par exemple,

@example
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 les variable définies
ci-dessus.

@example
\paper @{
  \aFivePaper
  line-width = \width
@}
@{ c4^\name @}
@end example


@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
\version @w{"@version{}"}
@end example

@noindent
Par convention, on place cette instruction en début de fichier.

Cette instruction permet de faciliter les mises à jour futures de
LilyPond.  Les changements de syntaxe au fil des versions sont gérés
avec un programme dédié, @command{convert-ly}, qui utilise la valeur
de @code{\version} pour déterminer les règles de conversion à
appliquer au fichier source.  Pour plus d'informations, consultez voir
@rprogram{Updating files with convert-ly}.


@node Adding titles
@subsection Adding titles

On indique les informations bibliographiques --- nom du morceau, du
compositeur, numéro d'opus... --- dans un bloc à part, le bloc
d'en-tête @code{\header}, qui existe indépendamment de l'expression
musicale principale.  Le bloc @code{\header} est habituellement placé
en début de fichier, après le numéro de version.

@example
\version @w{"@version{}"}
\header @{
  title = "Symphonie"
  composer = "Moi"
  opus = "Op. 9"
@}

@{
 @dots{} la musique @dots{}
@}
@end example

Quand LilyPond traite le fichier, le titre et le compositeur sont
imprimés au début de la partition.  Vous trouverez plus d'informations
sur les titres à la section @ruser{Creating titles}.


@node Absolute note names
@subsection Absolute note names

Jusqu'ici nous n'avons utilisé que le mode @code{\relative} pour
définir les hauteurs de notes.  Si c'est souvent le moyen le plus
simple de saisir la musique au clavier, il existe une autre façon de
procéder : le mode de hauteurs absolues.

Si vous omettez la commande @code{\relative}, LilyPond considérera
toutes les hauteurs comme des hauteurs absolues.  Un @code{c'} désigne
toujours le do central, un @code{b} se situe une seconde en dessous
du do central, et un @code{g,} est situé sur la première ligne de
la portée en clé de fa.

@lilypond[verbatim,quote]
{
  \clef bass
  c' b g, g,
  g, f, f c'
}
@end lilypond

Voici une gamme sur 4 octaves :

@lilypond[verbatim,quote]
{
  \clef bass
  c, d, e, f,
  g, a, b, c
  d e f g
  a b c' d'
  \clef treble
  e' f' g' a'
  b' c'' d'' e''
  f'' g'' a'' b''
  c'''1
}
@end lilypond

Comme vous pouvez le voir, il faut beaucoup d'apostrophes pour écrire
de la musique dans un registre aigu, comme le montre cet extrait de
Mozart.

@lilypond[verbatim,quote]
{
  \key a \major
  \time 6/8
  cis''8. d''16 cis''8 e''4 e''8
  b'8. cis''16 b'8 d''4 d''8
}
@end lilypond

Toutes ces apostrophes rendent le fichier moins lisible, et surtout il
est très probable d'oublier au moins une apostrophe au cours de la
frappe.  En mode @code{\relative}, le même exemple devient bien plus
facile à lire et à saisir.

@lilypond[verbatim,quote]
\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 mettra en évidence : toutes les notes suivantes
seront placées à la mauvaise octave.  En mode de hauteurs absolues,
une erreur isolée ne serait pas autant visible, donc serait plus
difficile à dénicher.

Cependant, le mode de hauteurs absolues reste utile pour les musiques
où les intervalles sont étendus, et plus encore pour les fichiers
LilyPond créés par des programmes.


@node After the tutorial
@subsection After the tutorial

Après avoir parcouru ce tutoriel, vous devriez essayer d'écrire un
morceau ou deux.  Commencez par copier l'un des modèles types et
ajoutez-y des notes --- consultez les @ref{Templates}.  Si vous voulez
employer une notation que vous n'avez pas trouvé dans le tutoriel,
consultez le manuel de notation, en commençant par la @ruser{Musical
notation}.  Si vous désirez écrire pour un ensemble instrumental non
couvert par les modèles, lisez la section @ref{Extending the
templates}.

Après avoir écrit quelques pièces courtes, lisez les chapitres 3 à 5
du manuel d'initiation.  Rien ne s'oppose à ce que vous consultiez dès
à présent ces chapitres, bien sûr ! Néanmoins, le reste du manuel
d'initiation part du principe que vous avez déjà bien assimilé la
syntaxe de base de LilyPond.  Vous pouvez toujours survoler ces
chapitres 3 à 5, et y revenir plus tard après avoir acquis de
l'expérience.

Dans ce tutoriel comme dans le reste de ce manuel, se trouve à chaque
section un paragraphe @strong{Voir aussi} contenant des références
vers d'autres sections : il est conseillé de ne pas les suivre en
première lecture ; lorsque vous aurez lu l'ensemble du manuel
d'initiation, vous pourrez en relisant certaines sections suivre ces
références pour approfondir certains aspects.

Si vous ne l'avez pas encore fait, lisez @ref{About the
documentation}.  Les sources de documentation et d'information sur
LilyPond sont vastes, il est normal pour un débutant de ne pas savoir
où chercher ; si vous passez quelques minutes à lire attentivement
cette section, vous vous épargnerez certainement la frustration causée
par des heures de recherche infructueuses.
