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

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

@c TODO:
@c   * more details about running lilypond; error messages,
@c     compiling/viewing (emacs?)
@c   * where to go from First steps+More basics?

@c  wherever possible, do not include index entries here; the
@c  index should point to stuff in the reference manual.  -gp

@c Your first LilyPond score in 10 minutes?

@node Tutorial   
@chapter Tutorial

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

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

@lilypond[fragment,quote,ragged-right,relative=2]
c-\markup { \bold \huge { Click here.  } }
@end lilypond
@end ifhtml

En copiant et en collant l'intégralité du code dans un fichier test,
vous aurez un modèle comme base pour expérimenter.  Si vous
apprenez de cette façon, vous aurez probablement envie d'imprimer ou
de créer un lien vers
@ifhtml
la
@end ifhtml
@ref{Cheat sheet}, tableau qui répertorie les commandes usuelles
pour une consultation rapide.

@menu
* First steps::                 
* Second steps::  
* More about pitches::          
* Entering ties::               
* Automatic and manual beams::  
* Octave entry::                
* Music expressions explained::  
* More staves::                 
* Adding articulation marks to notes::  
* Combining notes into chords::  
* Advanced rhythmic commands::   
* Commenting input files::      
* Printing lyrics::             
* A lead sheet::                
* Adding titles::               
* Single staff polyphony::      
* Piano staves::                
* Organizing larger pieces::    
* An orchestral part::          
* After the tutorial::
@end menu


@node First steps
@section First steps

Le premier exemple montre comment écrire la partition la plus
élémentaire qui soit, une gamme (@rglos{scale}).  Une @rglos{note} peut
être entrée en tapant son nom, de @samp{a} à @samp{g}.  Donc si vous
entrez

@example
@{
c' d' e' f' g' a' b' c''
@}
@end example

@noindent
le résultat ressemblera à 

@lilypond[quote]
{
c' d' e' f' g' a' b' c''
}
@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"}
@c END DIV

@emph{Attention :} tout extrait de code LilyPond doit être entouré
d'une @{paire d'accolades@}.  De plus, pour éviter toute ambiguïté, il
est préférable d'entourer les accolades par des espaces ou retours à
la ligne.  Bien que certains exemples de ce manuel ne comportent pas
d'accolades, ne les oubliez pas dans vos partitions !

@cindex Case sensitive
De plus, LilyPond est sensible à la casse.  @code{ @{ c d e @} } est
un code valide ; @code{ @{ C D E @} } produira un message d'erreur.

@unnumberedsubsec Entering music and viewing output

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

@unnumberedsubsubsec MacOS X

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.

Pour l'utilisation future de LilyPond, vous commencerez certainement
en sélectionnant « Nouveau » ou « Ouvrir ».

Notez que le premier démarrage peut prendre une minute ou deux, car
toutes les polices systèmes doivent être d'abord analysées.

@unnumberedsubsubsec Windows

Sous Windows, démarrez un éditeur de texte @footnote{N'importe quel
éditeur simple ou orienté programmation, qui prend en charge le codage
de caractères UTF-8, fera l'affaire, par exemple Notepad.  N'utilisez
pas de traitement de texte car ceux-ci insèrent des codes de formatage
qui posent problème à LilyPond.} et saisissez

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

Enregistrez-le sur le bureau sous @file{test.ly} et vérifiez bien
qu'il ne s'appelle pas @file{test.ly.TXT}.  Double-cliquez sur le
fichier @file{test.ly} pour le traiter et afficher le fichier
PDF résultant.


@unnumberedsubsubsec Unix

Commencez par ouvrir une fenêtre de terminal et un éditeur de
texte.  Par exemple, vous pouvez ouvrir un xterm et exécuter
@code{joe}.  @footnote{Des fichiers de macros pour les fans de VIM et un
@code{LilyPond-mode} pour les fans d'Emacs existent.   S'ils ne sont pas
encore installés, consultez le fichier @file{INSTALL.txt}.} Dans votre
éditeur, entrez le texte suivant et sauvegardez le fichier sous
@file{test.ly}

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

@noindent
Pour traiter @file{test.ly}, procédez comme ceci : 

@example
lilypond test.ly
@end example

@noindent
Vous verrez quelque chose ressemblant à :

@example
lilypond test.ly
GNU LilyPond 2.10.0
Processing `test.ly'
Parsing...
Interpreting music... [1]
Preprocessing graphical objects...
Calculating line breaks... [2]
Layout output to `test.ps'...
Converting to `test.pdf'...
@end example

@c DIV specific
Suivant votre installation, les messages peuvent être traduits.
@c END DIV

@cindex PDF file
@cindex Viewing music

@noindent
Le résultat est le fichier @file{test.pdf}, que vous pouvez imprimer
ou visualiser avec les outils standards de votre système
d'exploitation.  @footnote{Si votre système ne dispose pas des outils
nécessaires, vous pouvez essayer
@uref{http://@/www@/.cs@/.wisc@/.edu/@/~ghost/,Ghostscript}, un
programme pour voir et imprimer les fichiers PDF et PostScript.}


@node Second steps
@section Second steps

@emph{N'oubliez pas :} tout extrait de musique source LilyPond doit
être entouré d'@{accolades@}.  Pour éviter toute ambiguïté, il
est préférable d'entourer les accolades par des espaces ou retours à
la ligne.  Bien que certains exemples de ce manuel ne comportent pas
d'accolades, ne les oubliez pas dans vos partitions !

@c will be removed once the tutorial either explains \relative or
@c examples are fixed so they don't use it.  -gp
De plus, de nombreux exemples utilisent le mode @code{relative}.  Ceci
est expliqué à la section @ref{Octave entry} ; sachez dès à présent
que certains exemples devraient être libellés sous la forme 
@code{\relative @{ @emph{...musique...} @}}.
De nombreux exemples ont aussi été compressés horizontalement pour
économiser de la place, grace à la commande
@code{\paper @{ragged-right = ##t @}}. 

@cindex Case sensitive
Enfin, LilyPond est sensible à la casse.  @code{ @{ c d e @} } est
un code valide ; @code{ @{ C D E @} } produira un message d'erreur.

@c  End of latest re-write.  Since I have no life, I may do more
@c  work on this, but I'd really like to have a Doc Helper take
@c  over this task.  -gp

La durée (@rglos{duration}) d'une note est spécifiée par un nombre
qui suit le nom de cette note : @samp{1} pour une ronde (@rglos{whole
note}), @samp{2} pour une blanche (@rglos{half note}), @samp{4} pour
une noire (@rglos{quarter note}) et ainsi de suite.

@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


@node More about pitches
@section More about pitches 

Un dièse (@rglos{sharp}) s'obtient en ajoutant @samp{is} au nom de la
note, un bémol (@rglos{flat}) en ajoutant @samp{es}.  Comme vous pouvez
vous y attendre, un double dièse ou double bémol est obtenu en
ajoutant @samp{isis} ou @samp{eses}@footnote{Cette syntaxe est dérivée
de la convention de dénomination des notes dans les langues nordiques
et germaniques, comme l'allemand ou le hollandais.}.

@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

@example
cis1 ees fisis aeses
@end example

@lilypond[fragment,quote,notime]
\set Score.timing = ##f
\transpose c c' { cis1 ees fisis aeses s16_" " }
@end lilypond

@cindex key signature, setting
L'armure est déterminée par la commande @code{\key}, suivie d'une
hauteur puis de @code{\major} (majeur) ou @code{\minor} (mineur) :

@example
\key d \major
g1
\key c \minor
g
@end example

@lilypond[fragment,quote,notime,fragment]
\key d \major
g'1
\key c \minor
g'
@end lilypond

@noindent
La combinaison de l'armure et des hauteurs de note -- y compris les
altérations -- permet de déterminer dans quel cas afficher les
altérations accidentelles.  Cette fonctionnalité est souvent source de
confusion pour les nouveaux utilisateurs, aussi expliquons-la en
détail.


LilyPond fait une nette distinction entre le contenu musical et la
mise en forme.  L'altération d'une note -- bémol, bécarre ou dièse --
fait partie de sa hauteur, et donc du contenu musical.  La présence
d'une altération accidentelle -- un @emph{signe} bémol, bécarre ou
dièse -- devant la note correspondante est une question de mise en
page.  La mise en page est un processus qui obéit à des règles ; les
altérations accidentelles sont donc automatiquement imprimées suivant
ces règles.  Les hauteurs de note appartiennent à la musique que vous
entrez, et comme vous êtes sensé(e) entrer ce que vous voulez entendre,
LilyPond, qui n'est chargé que de la gravure, ne les choisit pas à
votre place.

Dans cet exemple

@lilypond[quote,notime,fragment]
\key d \major
d' cis' fis'
@end lilypond

@noindent
si aucune note n'a d'altération accidentelle, vous devez
cependant entrer

@example
\key d \major
d cis fis
@end example

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


Pour plus d'informations sur

@quotation
@table @asis
@item les altérations accidentelles
voir @ref{Automatic accidentals}.

@item les armures
voir @ref{Key signature}.
@end table
@end quotation

@node Entering ties
@section Entering ties

@cindex tie
Une liaison de prolongation@footnote{parfois aussi appelée liaison de
tenue.} (@rglos{tie}) est créée en ajoutant un tilde @samp{~} à
la suite de la première note liée.

@lilypond[quote,notime,fragment,verbatim,relative=3]
g4~ g a2~ a4
@end lilypond

Pour plus d'informations sur les liaisons de prolongation, voir @ref{Ties}.



@node Automatic and manual beams
@section Automatic and manual beams

@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

@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{]}.

@lilypond[quote,fragment,relative=2,verbatim]
a8[ ais] d[ es r d]
@end lilypond

Pour plus d'informations sur les ligatures, voir @ref{Manual beams}.


Voici comment se comportent ensemble armures, altérations
accidentelles et liaisons :

@lilypond[fragment,quote,noindent,line-width=50\staff-space,verbatim]
\relative c'' {
  \time 4/4
  \key g \minor
  \clef treble
  r4 r8 a8 gis4 b
  a8 d4.~ d e,8
  fis4 fis8 fis8 eis4 a8 gis~
  gis2 r2
}
@end lilypond

@cindex accidentals


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



@node Octave entry
@section Octave entry


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

@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'}

@lilypond[quote,notime,fragment,verbatim]
c'4 c'' c''' \clef bass c c,
@end lilypond

Un exemple de l'utilisation des apostrophes dans ce fragment de Mozart :

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

@noindent
Cet exemple montre qu'il faut beaucoup d'apostrophes pour écrire de la
musique dans un registre aigu.  Ceci rend le fichier moins lisible, et
c'est une source d'erreurs.  La solution consiste à utiliser le mode
d'« octaves relatives ».  C'est la façon la plus commode de copier de
la musique existante.

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

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'}.



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


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

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

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

En résumé, apostrophes et virgules ne déterminent pas la hauteur
absolue d'une note dans le mode @code{\relative}.  Au lieu de cela, la
hauteur de la note est relative à la précédente, et modifier l'octave
d'une seule note changera l'octave de toutes les notes suivantes.

Pour plus d'information sur les octaves relatives, voir
@ref{Relative octaves}, et @ref{Octave check}.


@node Music expressions explained
@section Music expressions explained


Dans les fichiers source LilyPond, la musique est représentée par ce qu'on
appelle des @emph{expressions musicales}.  Nous en avons déjà vu dans
les quelques exemples précédents ; une seule note constitue une
expression  musicale :

@lilypond[fragment,quote,verbatim,relative=3]
a4
@end lilypond

Mettre un groupe de notes entre accolades crée une nouvelle expression
musicale :

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

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

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

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

@lilypond[fragment,quote,verbatim,relative=3]
<<
  { a4 g }
  { f e }
  { d b }
>>
@end lilypond

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

(1 + 2) * 3

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

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

Notez que l'exemple suivant ne comporte qu'une seule portée,
contrairement à l'exemple précédent qui contenait trois portées
séparées.  C'est parce que l'exemple commence par une note seule.  Pour
déterminer le nombre de portées, LilyPond regarde le premier élément
qui n'est pas une accolade.  Si c'est une seule note, il y a une portée
; si c'est une expression simultanée, il y aura plus d'une portée.

@lilypond[fragment,quote,verbatim,relative=2]
{
  c <<c e>>
  << { e f } { c <<b d>> } >>
}
@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,

@example
<<
  @{
    @dots{}
  @}
  @{
    @dots{}
  @}
>>
@end example

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.

@node More staves
@section More staves

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

@lilypond[quote,fragment,verbatim]
<<
  \new Staff { \clef treble c'' }
  \new Staff { \clef bass c }
>>
@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.

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.

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.

Nous pouvons maintenant écrire un morceau à deux portées :

@c TODO: (c) status of this Paul McCartney (?) song (let's all stand together)

@lilypond[fragment,quote,verbatim,ragged-right]
\relative <<
  \new Staff {
    \time 3/4
    \clef treble

    e'2 d4 c2 b4 a8[ a]
    b[ b] g[ g] a2.
  }
  \new Staff {
     \clef bass
     c,,2 e4 g2.
     f4 e d c2.
  }
>>
@end lilypond

Pour plus d'informations sur les contextes, voir leur description à
@ref{Interpretation contexts}.



@node Adding articulation marks to notes
@section Adding articulation marks to notes

@cindex articulation
@cindex accents
@cindex staccato

Les articulations standard peuvent être ajoutées à une note en
utilisant un tiret (@samp{-}) et un caractère :

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

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

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

Articulations et doigtés sont habituellement placés automatiquement,
mais vous pouvez spécifier une direction en utilisant @samp{^} (en haut)
ou @samp{_} (en bas).  Vous pouvez aussi utiliser plusieurs articulations
sur la même note.  Dans la plupart des cas, cependant, il est mieux de
laisser LilyPond déterminer l'emplacement de l'articulation.

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

Les signes de nuances sont obtenus en ajoutant à la note les noms des nuances,
précédées d'un anti-slash @samp{\} :

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

@cindex dynamics
@cindex decrescendo
@cindex crescendo

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

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



@cindex slur

Une liaison d'articulation (@rglos{slur}) est une courbe tracée
au-dessus de plusieurs notes.  Elle indique un jeu legato.  Les notes de
départ et d'arrivée sont suivies respectivement par @samp{(} et
@samp{)} :

@lilypond[fragment,quote,fragment,relative=2,verbatim]
d4( c16) cis( d e c cis d) e( d4)
@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 :

@lilypond[quote,fragment,relative=2]
c2~( c8 fis fis4 ~ fis2 g2)
@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.

@lilypond[quote,fragment,relative=2,verbatim]
a8(\( ais b c) cis2 b'2 a4 cis, c\)
@end lilypond


Pour plus d'informations sur les

@quotation
@table @asis
@item doigtés
voir @ref{Fingering instructions}.
@item articulations
voir @ref{Articulations}.
@item liaisons d'articulation
voir @ref{Slurs}.
@item liaisons de phrasé
voir @ref{Phrasing slurs}.
@item nuances
voir @ref{Dynamics}.
@end table
@end quotation


@node Combining notes into chords
@section Combining notes into chords

@cindex chords
Des accords peuvent être produits en entourant les hauteurs de note
avec les angles gauche et droit -- @samp{<} et @samp{>} --

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


Vous pouvez combiner les indications comme les liaisons et les liens de
croches avec les accords.  Ils doivent cependant être placés en
dehors des angles :

@lilypond[quote,relative=1,fragment,verbatim]
r4 <c e g>8[ <c f a>]~ <c f a>
@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


@node Advanced rhythmic commands
@section Advanced rhythmic commands

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

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

@cindex tuplets
@cindex triplets
Les n-olets sont créés avec le mot-clef @code{\times}.  Celui-ci prend
deux arguments : une fraction et une expression musicale.  La durée des
notes de l'expression musicale est multipliée par la fraction.  Les
notes d'un triolet durent les deux tiers du temps de leur notation
réelle, cette fraction est donc de 2/3 pour les triolets :

@lilypond[quote,relative=1,verbatim,fragment]
\times 2/3 { f8 g a }
\times 2/3 { c r c }
@end lilypond

@cindex grace notes
@cindex acciaccatura
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

@lilypond[quote,relative=2,verbatim,fragment]
c4 \appoggiatura b16 c4
c4 \acciaccatura b16 c4
@end lilypond

@noindent

Pour plus d'informations sur les

@quotation
@table @asis
@item ornementations
voir @ref{Grace notes},
@item n-olets
voir @ref{Tuplets},
@item mesures incomplètes (levées)
voir @ref{Partial measures}.
@end table
@end quotation


@node Commenting input files
@section Commenting input files

@cindex comments
@cindex line comment
@cindex block comment
Un commentaire est une remarque à l'attention du lecteur du fichier
source ; il est ignoré lors de l'analyse du fichier, et n'a donc 
aucun effet sur la sortie imprimable.  Il existe deux types
de commentaires.  Le symbole pourcent @samp{%} introduit un commentaire
d'une ligne : après @code{%}, le reste de la ligne est ignoré.  Un bloc de
commentaire marque une section entière dans le fichier d'entrée.  Tout ce
qui est à l'intérieur de @code{%@{} et @code{%@}} est ignoré.  Le fragment
suivant montre les utilisations possible des commentaires :

@example
% mélodie de "ah vous dirais-je maman"
  c4 c g' g a a g2

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

@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 

@example
\version "2.10.0"
@end example

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


@node Printing lyrics
@section Printing lyrics
@cindex lyrics

@c TODO: (c) status of the Queen fragment.

@cindex Lyrics
@cindex Songs
Les paroles sont entrées en séparant chaque syllable par un espace :

@example
I want to break free
@end example

Voyons la mélodie

@lilypond[quote,verbatim,fragment,ragged-right]
\relative {
  r4 c \times 2/3 { f g g }
  \times 2/3 { g4( a2) }
}
@end lilypond

Les paroles peuvent être associées à ces notes en les combinant avec le
mot-clé @code{\addlyrics}

@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

@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

@lilypond[fragment,quote,ragged-right]
<<
  \relative {
    r4 c \times 2/3 { f g g }
    \times 2/3 { g4( a2) }
  }
  \addlyrics { I want to break free __ }
>>
@end lilypond

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 :

@example
A -- le gri -- a
@end example

@c no ragged-right here, because otherwise the hypens get lost.
@lilypond[fragment,quote]
<<
  \relative {
    \time 2/4
    f4 f c' c
  }
  \addlyrics { A -- le gri -- a }
>>
@end lilypond

Plus de possibilités, comme celle d'ajouter plusieurs lignes de
paroles en dessous d'une même mélodie sont exposées à
@ref{Vocal music}.


@node A lead sheet
@section A lead sheet

@cindex Lead sheets
@cindex chords
@cindex chord names

@c TODO: revise this, \chords { } is shorter and more intuitive.

Dans la musique de variété, il est courant d'indiquer l'accompagnement
par le nom des accords.  De tels accords peuvent être entrés comme les
notes :

@lilypond[quote,verbatim,ragged-right]
\chordmode { c2 f4. g8 }
@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 :

@lilypond[quote,verbatim,ragged-right]
\chordmode { c2 f4:m g4:maj7 gis1:dim7 }
@end lilypond

Pour la musique improvisée, les accords ne sont pas imprimés sur des
portées mais comme des lignes à part entière.  Ceci s'obtient en
utilisant @code{\chords} à la place de @code{\chordmode}.  La même
syntaxe sera utilisée que dans le cas de@code{\chordmode}, mais le
rendu des notes interviendra dans un contexte de @code{ChordNames},
avec le résultat suivant

@lilypond[quote,verbatim,ragged-right]
\chords { c2 f4.:m g4.:maj7 gis8:dim7 }
@end lilypond

@cindex lead sheet
Une fois assemblés, les accords, paroles et mélodie forment une
partition de chanson :

@example
<<
  \chords @{ @emph{les accords} @}
  @emph{la mélodie}
  \addlyrics @{ @emph{le texte} @}
>>
@}
@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 __ }
>>
@end lilypond

Une liste complète de modificateurs et d'autres options de
mise en forme se trouve à la section @ref{Chords}.


@node Adding titles
@section Adding titles

Les informations bibliographiques sont entrées dans un bloc séparé, le
bloc d'en-tête (@code{\header}).  Le nom du morceau, son compositeur, etc., sont
définis dans @code{\header@{@tie{}@dots{}@tie{}@}}.
Le bloc @code{\header} est habituellement placé en début de fichier.
Par exemple,

@example
\header @{
  title = "Miniature"
  composer = "Igor Stravinsky"
@}

@{ @dots{} @}
@end example


Quand le fichier est traité, le titre et le compositeur sont imprimés
en haut de la partition.  Vous trouverez plus d'informations sur les
titres à @ref{Creating titles}.


@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 } >>
@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 } >>
@end lilypond

@noindent
Encore une fois, ces expressions peuvent s'imbriquer arbitrairement :

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

Plus de fonctionnalités sur l'écriture polyphonique sont décrites à la
section @ref{Basic polyphony} du manuel.


@node Piano staves
@section Piano staves

@cindex staff switch, manual
@cindex cross staff voice, manual
La musique pour piano s'écrit avec deux portées reliées par une
accolade.  Imprimer ce type de portée revient au même que dans l'exemple de
musique polyphonique (@ref{More staves}),

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

@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

Voici un petit exemple :

@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 }
>>
@end lilypond

Plus d'informations sur le formatage de la musique pour piano sont
données à @ref{Piano music}.


@node Organizing larger pieces
@section Organizing larger pieces

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.

En utilisant des variables, appelées également identificateurs, il est
possible de découper des expressions musicales complexes.  Un identificateur
se définit comme

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

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

@example
largeur = 4.5\cm
nom = "Wendy"
papierACinq = \paper @{ paperheight = 21.0 \cm @}
@end example

En fonction de son contenu, l'identificateur peut être utilisé à différents
endroits.  L'exemple suivant utilise la variable précédente :

@example
\paper @{
  \papierACinq
  line-width = \largeur
@}
@{ c4^\nom @}
@end example

Vous trouverez plus d'informations sur les usages possibles des
identificateurs dans le manuel technique, section
@ref{Input variables and Scheme}.
@c fixme: the ref is too technical.


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

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 :

@example
notesCor = \relative c @{
  \time 2/4
  r4 f8 a cis4 f e d
@}
@end example

@noindent
Puis, une partie individuelle est créée en mettant ce qui suit dans
un fichier

@example
\include "musique-cor.ly"
\header @{
  instrument = "Cor en fa"
@}

@{
 \transpose f c' \notesCor
@}
@end example

La ligne

@example
\include "musique-cor.ly"
@end example

@noindent
indique à LilyPond de lire le contenu de @file{musique-cor.ly} à cet
endroit dans le fichier, ainsi @code{notesCor} est défini pour ce qui
suivra.  La commande @code{\transpose f@tie{}c'} indique que
l'argument, en l'occurence @code{\notesCor}, doit être transposé d'une
quinte ascendante.  Le son entendu @samp{fa} correspond à la note écrite
@code{do'}, ce qui correspond bien à la transpostion d'un cor en
fa.  La transposition peut être constatée dans la sortie suivante :

@lilypond[quote,ragged-right]
\transpose f c' \relative c {
  \time 2/4
  r4 f8 a cis4 f e d
}
@end lilypond

Dans la musique d'ensemble, il arrive souvent qu'une des voix ne joue
pas pendant plusieurs mesures.  Ceci est spécifié par un silence
spécial, le silence multi-mesures (mesures à compter).  Il est saisi
par une lettre capitale @samp{R} suivie d'une durée (@code{1}@tie{}pour une
ronde, @code{2}@tie{}pour une blanche, etc.).  En multipliant la durée, on
peut construire des silences plus longs.  Par exemple, ce silence dure
3@tie{}mesures à 2/4

@example
R2*3
@end example

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

@example
\set Score.skipBars = ##t
@end example

@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

@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
}
@end lilypond


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

@example
\include "musique-cor.ly"
\include "musique-basson.ly"

<<
  \new Staff \notesCor
  \new Staff \notesBasson
>>
@end example

@noindent
donnant pour résultat

@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
  }
>>
@end lilypond

De plus amples informations sur la gestion des parties et conducteurs
se trouvent dans le manuel de notation, section @ref{Orchestral music}.

Le réglage des variables d'exécution (« propriétés ») est abordé dans
@ref{Changing context properties on the fly}.


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

