@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
@ignore
- Translation of GIT committish: f413550b658b43fbea690fc060f872bce6bbc885
+ Translation of GIT committish: 1d859642df3a961f6675a70387069cbaa56d8ce9
When revising a translation, copy the HEAD committish of the
- version that you are working on. See TRANSLATION for details.
+ version that you are working on. For details, see the Contributors'
+ Guide, node Updating translation committishes..
@end ignore
-@c \version "2.12.0"
-
-@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
+@include included/generating-output.itexi
+@c \version "2.19.21"
@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
+@node Tutoriel
+@chapter Tutoriel
+@translationof Tutorial
-Ce tutoriel commence par une introduction au langage musical utilisé
+Ce tutoriel est 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.
+produire une partition.
@menu
-* First steps::
-* Single staff notation::
-* Multiple notes at once::
-* Songs::
-* Final touches::
+* Compilation d'un fichier::
+* Composition d'un fichier source::
+* Gestion des erreurs::
+* Bien lire le manuel::
@end menu
-@node First steps
-@section First steps
+@node Compilation d'un fichier
+@section Compilation d'un fichier
+@translationof Compiling a file
-Cette section présente les aspects élémentaires de l'utilisation de
-LilyPond.
+Nous allons ici parler de la @qq{compilation}, ou comment LilyPond
+traite le fichier source que vous avez écrit, pour en faire quelque
+chose d'imprimable.
@menu
-* Compiling a file::
-* Simple notation::
-* Working on input files::
-* How to read the manual::
+* Saisie de la musique::
+* MacOS X::
+* Windows::
+* Ligne de commande::
@end menu
-@node Compiling a file
-@subsection Compiling a file
+@node Saisie de la musique
+@subsection Saisie de la musique
+@translationof Entering input
@cindex compilation
@cindex exemple, premier
@cindex premier exemple
+@cindex casse, sensibilité à la
+@cindex sensibilité à la casse
+
+@menu
+* Production de la partition::
+@end menu
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.
+peut être joué par un séquenceur.
Voici un premier exemple simple de fichier source LilyPond.
@example
+\version "@w{@version{}}"
@{
c' e' g' e'
@}
@end lilypond
@c DIV specific
-Il est aussi possible d'utiliser les noms de notes français @samp{do
+Il est aussi possible d'utiliser les noms de notes français @qq{do
re mi fa sol la si}, en insérant au début du fichier la ligne
-@samp{\include "italiano.ly"}.
+@code{\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
+@w{@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 !
+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}.}
-
+documentation, consultez @ref{Bien lire le manuel}.}
@cindex casse, prise en compte de la
@cindex prise en compte de la casse
@cindex sensibilité à la casse
-De plus, LilyPond est @strong{sensible à la casse} : le code
-@w{@code{@{ c d e @}}} est valide, alors que @w{@code{@{ C D E @}}}
+De plus, LilyPond est @strong{sensible à la casse} : le code
+@w{@samp{@{ c d e @}}} est valide, alors que @w{@samp{@{ C D E @}}}
produira un message d'erreur.
@smallspace
-@subheading Entering music and viewing output
+@node Production de la partition
+@unnumberedsubsubsec Production de la partition
+@translationof Producing output
@cindex fichier PDF
@cindex PDF
@cindex partition, lire
@cindex lire la partition
@cindex éditeurs de texte
-@cindex LilyPond et MacOS X
-@cindex MacOS X et LilyPond
-@cindex LilyPond et Windows
-@cindex Windows et LilyPond
-@cindex LilyPond et Unix
-@cindex Unix et LilyPond
Dans cette section nous expliquerons quelles commandes exécuter et
comment voir ou imprimer le résultat produit par LilyPond.
+@itemize
+
+@item
+@ref{MacOS X, @sourceimage{logo-macosx,,,}}
+@ref{MacOS X, MacOS X} (graphique)
+
+@item
+@ref{Windows, @sourceimage{logo-windows,,,}}
+@ref{Windows, Microsoft Windows} (graphique)
+
+@item
+@ref{Ligne de commande, @sourceimage{logo-linux,,,}
+@sourceimage{logo-freebsd,,,}
+@sourceimage{logo-macosx,,,}
+@sourceimage{logo-windows,,,}
+}
+@ref{Ligne de commande, Tous systèmes} (ligne de commande)
+
+@end itemize
+
Notez qu'il existe plusieurs éditeurs de texte disponibles avec un bon
-support de LilyPond ; consultez @rprogram{Text editor support}.
+support de LilyPond ; consultez @rweb{Facilités d'édition}.
@warning{Le premier démarrage de LilyPond peut prendre une minute ou
deux, afin de générer la liste des polices du système. LilyPond démarre
en principe plus rapidement lors des exécutions suivantes.}
-@subsubheading MacOS X
+@node MacOS X
+@subsection 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.
+@cindex lancer LilyPond sous MacOS X
+@cindex MacOS X, lancer LilyPond
-À 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}.
+@lilypadOSX
-@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.
+@node Windows
+@subsection Windows
-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}.
+@cindex lancer LilyPond sous Windows
+@cindex Windows, lancer LilyPond
-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.
+@lilypadWindows
-@subsubheading UNIX
-Créez un fichier texte @file{test.ly} qui contient
+@node Ligne de commande
+@subsection Ligne de commande
+@translationof Command-line
-@verbatim
-{
- c' e' g' e'
-}
-@end verbatim
+@cindex lancer LilyPond sous Unix
+@cindex Unix, lancer LilyPond
-@noindent
-Pour traiter @file{test.ly}, entrez la commande suivante dans un
-terminal :
+@lilypadCommandLine
-@example
-lilypond test.ly
-@end example
-@noindent
-Vous verrez quelque chose ressemblant à
+@node Composition d'un fichier source
+@section Composition d'un fichier source
+@translationof How to write input files
-@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
+This section introduces some basic LilyPond syntax to help get you
+started writing input files.
-@c DIV specific
-@noindent
-Suivant votre installation, ces messages peuvent être traduits ou
-non.
-@c END DIV
+@menu
+* Notation simple::
+* Travail sur les fichiers d'entrée::
+@end menu
-@node Simple notation
-@subsection Simple notation
+@node Notation simple
+@subsection Notation simple
+@translationof Simple notation
@cindex simple, notation
@cindex notation simple
+@menu
+* Hauteurs::
+* Durées et rythme::
+* Silences::
+* Métrique::
+* Indication de tempo::
+* Clefs::
+* Tout ensemble::
+@end menu
+
Il y a certains éléments graphiques de notation que LilyPond ajoute
automatiquement. Dans l'exemple suivant, nous n'avons fourni que
quatre hauteurs, mais LilyPond a ajouté une clef, un chiffre de mesure
@noindent
Ces valeurs automatiques simplifient la saisie du code source dans
-bien des cas ; nous verrons plus loin comment les indiquer
+bien des cas ; nous verrons plus loin comment les indiquer
explicitement.
-@subheading Hauteurs
+@node Hauteurs
+@unnumberedsubsubsec Hauteurs
+@translationof Pitches
@cindex hauteurs
@cindex mode relatif
@funindex '
@funindex ,
-Glossaire musical : @rglos{pitch}, @rglos{interval},
-@rglos{scale}, @rglos{middle C}, @rglos{octave},
-@rglos{accidental}.
+Glossaire musicologique :
+@rglosnamed{pitch,hauteur},
+@rglosnamed{interval,intervalle},
+@rglosnamed{scale,gamme},
+@rglosnamed{middle C,do central},
+@rglos{octave},
+@rglosnamed{accidental,altération}.
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
+de chaque note est déterminée automatiquement de façon à ce qu'elle
+soit le 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
+\relative {
+ 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
-clef de sol et la clef de fa, puis est suivi par le ré le plus proche,
-et ainsi de suite. On peut bien sûr créer des mélodies avec de plus
-grands intervalles, toujours avec le mode @code{\relative} :
+suivent est placée à l'octave la plus proche de la note précédente --
+en d'autres termes, le premier @code{c} est le do central, entre la
+clef de sol et la clef de fa, puis est suivi par le @notation{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
+\relative {
+ 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.
+Remarquez que cet exemple ne commence plus sur le @notation{do
+central} : la première note -- le @code{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
+@w{@code{@bs{}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 :
+central :
@lilypond[verbatim,quote]
% one octave above middle C
-\relative c'' {
- e c a c
+\relative {
+ e'' c a c
}
@end lilypond
plus à une quarte descendante du si.
@lilypond[verbatim,quote]
-\relative c'' {
- b c % c is 1 staff space up, so is the c above
+\relative {
+ 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
}
@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.
+Notez que le calcul des octaves relatives @strong{ne tient pas compte
+des altérations} des notes, dièse bémol 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.
+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,
+\relative {
+ 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) @code{'} ou @code{,} ---
+Pour déplacer une note deux octaves (ou davantage !) plus haut ou plus
+bas, il suffit de mettre deux (ou davantage) @code{'} ou @code{,} --
attention cependant à bien mettre deux apostrophes @code{''}, et non
-un guillemet @code{"}@tie{}! C'est de cette même manière que l'on
-peut modifier la valeur de départ de @code{\relative c'}.
+un guillemet @code{"} ! C'est de cette même manière que l'on
+peut modifier la valeur de départ de @w{@code{\relative c'}}.
+@c " - keeps quotes in order for context-sensitive editor -td
-@subheading Durées et rythme
+@node Durées et rythme
+@unnumberedsubsubsec Durées et rythme
+@translationof Durations (rhythms)
@cindex note, durée
@cindex durées
@cindex note pointée
@cindex spécification des durées
-Glossaire musical : @rglos{beam}, @rglos{duration},
-@rglos{whole note}, @rglos{half note}, @rglos{quarter note},
-@rglos{dotted note}.
+Glossaire musicologique :
+@rglosnamed{beam,ligature},
+@rglosnamed{duration,durée},
+@rglosnamed{whole note,ronde},
+@rglosnamed{half note,blanche},
+@rglosnamed{quarter note,noire},
+@rglosnamed{dotted note,note pointée}.
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
+hauteur : @code{1} pour une @notation{ronde}, @code{2} pour une
+@notation{blanche}, @code{4} pour une @notation{noire} et ainsi de
suite. Les @notation{crochets} et @notation{liens} sont ajoutés
automatiquement.
est une noire.
@lilypond[verbatim,quote]
-\relative c'' {
- a1
+\relative {
+ a'1
a2 a4 a8 a
a16 a a a a32 a a a a64 a a a a a a a a2
}
la durée de base.
@lilypond[verbatim,quote]
-\relative c'' {
- a a a4. a8
+\relative {
+ a' a a4. a8
a8. a16 a a8. a8 a4.
}
@end lilypond
-@subheading Silences
+@node Silences
+@unnumberedsubsubsec Silences
+@translationof Rests
@cindex silences
@cindex notation des silences
-Glossaire musical : @rglos{rest}.
+Glossaire musicologique :
+@rglosnamed{rest,silence}.
On saisit un @notation{silence} tout comme une note, mais avec la
-lettre @samp{r} (pour @emph{rest}).
+lettre @code{r} (pour @emph{rest}).
@lilypond[verbatim,quote]
-\relative c'' {
- a r r2
+\relative {
+ a' r r2
r8 a r4 r4. r8
}
@end lilypond
-@subheading Métrique
+@node Métrique
+@unnumberedsubsubsec Métrique
+@translationof Time signature
@cindex métrique
+@cindex chiffre de mesure
@funindex \time
@funindex time
-Glossaire musical : @rglos{time signature}.
+Glossaire musicologique : @rglosnamed{time signature,métrique}.
La @notation{métrique}, aussi appelée @notation{chiffre de mesure},
-peut être définie à l'aide de la commande @code{\time} :
+peut être définie à l'aide de la commande @code{\time} :
+
+@lilypond[verbatim,quote]
+\relative {
+ \time 3/4
+ a'4 a a
+ \time 6/8
+ a4. a
+ \time 4/4
+ a4 a a a
+}
+@end lilypond
+
+
+@node Indication de tempo
+@unnumberedsubsubsec Indication de tempo
+@translationof Tempo marks
+
+@cindex tempo, indication
+@cindex indication du tempo
+@cindex métronome, indication
+@cindex indication métronomique
+
+@funindex \tempo
+@funindex tempo
+
+Glossaire musicologique :
+@rglosnamed{tempo indication,indication de tempo},
+@rglosnamed{metronome,métronome}.
+
+La commande @code{\tempo} permet de stipuler aussi bien le @emph{tempo}
+que le métronome :
@lilypond[verbatim,quote]
-\relative c'' {
+\relative {
\time 3/4
- a4 a a
+ \tempo "Andante"
+ a'4 a a
\time 6/8
+ \tempo 4. = 96
a4. a
\time 4/4
+ \tempo "Presto" 4 = 120
a4 a a a
}
@end lilypond
-@subheading Clef
+@node Clefs
+@unnumberedsubsubsec Clefs
+@translationof Clef
@cindex clef
@cindex clé
@funindex \clef
@funindex clef
-Glossaire musical : @rglos{clef}.
+Glossaire musicologique : @rglos{clef}.
La @notation{clef} peut être définie à l'aide de la commande
-@code{\clef} :
+@code{\clef} :
@lilypond[verbatim,quote]
-\relative c' {
- \clef treble
- c1
- \clef alto
+\relative {
+ \clef "treble"
+ c'1
+ \clef "alto"
c1
- \clef tenor
+ \clef "tenor"
c1
- \clef bass
+ \clef "bass"
c1
}
@end lilypond
-@subheading Tout ensemble
+@node Tout ensemble
+@unnumberedsubsubsec Tout ensemble
+@translationof All together
Voici un bref exemple qui rassemble tous les éléments que nous déjà
-vus :
+vus :
@lilypond[verbatim,quote]
-\relative c, {
+\relative {
+ \clef "bass"
\time 3/4
- \clef bass
- c2 e8 c' g'2.
- f4 e d c4 c, r4
+ c,2 e8 c'
+ g'2.
+ f4 e d
+ c4 c, r
}
@end lilypond
-
@seealso
-Manuel de notation : @ruser{Writing pitches},
-@ruser{Writing rhythms}, @ruser{Writing rests},
-@ruser{Time signature}, @ruser{Clef}.
+Manuel de notation :
+@ruser{Écriture des hauteurs de note},
+@ruser{Écriture du rythme},
+@ruser{Écriture des silences},
+@ruser{Gravure du rythme},
+@ruser{Gravure des hauteurs}.
-@node Working on input files
-@subsection Working on input files
+@node Travail sur les fichiers d'entrée
+@subsection Travail sur les fichiers d'entrée
+@translationof Working on input files
@cindex accolades
+@cindex commentaires
+@cindex ligne de commentaire
+@cindex bloc de commentaire
+@cindex casse, prise en compte de
+@cindex prise en compte de la casse
+@cindex sensibilité à la casse
+@cindex espaces multiples, insensibilité
+@cindex insensibilité aux espaces multiples
+@cindex expressions
+@cindex versionage
+@cindex version
+@cindex numéro de version
+
+@funindex \version
@funindex { ... }
+@funindex %
+@funindex %@{ ... %@}
Le traitement des fichiers source de LilyPond est semblable à celui du
code de nombreux langages de programmation. La casse est prise
en compte, et les caractères considérés comme espaces ont généralement
-peu d'importance. Les expressions sont délimitées par des accolades @{
-@}, et les commentaires par @code{%} ou @code{%@{ ... %@}}.
+peu d'importance. Les expressions sont délimitées par des accolades
+@code{@{ @}}, et les commentaires par @code{%} ou
+@w{@code{%@{ @dots{} @}}} .
-Si cette phrase vous paraît incompréhensible, ne vous en faites pas !
-Expliquons tous ces termes :
+Si cette phrase vous paraît incompréhensible, ne vous en faites pas !
+Expliquons tous ces termes :
@itemize
-@item @strong{La casse} :
-@cindex casse, prise en compte de
-@cindex prise en compte de la casse
-@cindex sensibilité à la casse
+@item
+@strong{La version} :
+Tout fichier LilyPond devrait porter mention de la version. Cette
+mention prend la forme d'une ligne décrivant le numéro de la version
+utilisée lors de la confection du fichier en question, comme ici :
+
+@example
+\version "@w{@version{}}"
+@end example
+
+Il est d'usage de porter cette mention au tout début du fichier
+LilyPond.
+
+Mentionner la version est important pour, au moins, les deux raisons
+suivantes : cela permet dans un premier temps de faciliter les
+opérations de mise à jour automatisée au fil de l'évolution de la
+syntaxe de LilyPond. Ensuite, cela met en évidence le minimum requis
+pour pouvoir compiler votre fichier.
+
+Si vous ne le mentionnez pas, Lilypond vous rappellera à l'ordre durant
+la compilation.
+
+@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 minuscule : @code{@{ c d e @}} est
-un code valide, alors que @code{@{ C D E @}} produira un message
+exemple, doivent être entrées en minuscule : @w{@code{@{ c d e @}}} est
+un code valide, alors que @w{@code{@{ C D E @}}} produira un message
d'erreur.
-@cindex espaces multiples, insensibilité
-@cindex insensibilité aux espaces multiples
+@item
+@strong{Les espaces multiples} :
+LilyPond ne tient pas compte du nombre d'espaces, de tabulations ou de
+retours à la ligne. @w{@code{@{ c d e @}}} a le même sens que
+@w{@code{@{ c d e @}}} ou que
-@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 @}
+@{ c4 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 :
+à prendre est d'indenter les blocs de code avec des doubles espaces :
@example
@{
- c d e
+ c4 d e
@}
@end example
-@cindex expressions
-
-@item @strong{Expressions musicales} :
-Tout morceau saisi dans LilyPond doit être placé entre @strong{@{
-accolades @}}. Ces caractères indiquent à LilyPond que ce bloc de
-texte représente une et une seule expression musicale, tout comme les
-parenthèses @samp{()} en mathématiques. Pour éviter toute ambiguïté,
-il est préférable d'entourer ces accolades d'espaces ou de retours à
-la ligne.
-
-Un appel de fonction --- @w{@code{\relative @{ @}}} par exemple ---
-compte également comme une seule expression musicale.
-
-@cindex commentaire
-@cindex commentaire de fin de ligne
-@cindex commentaire-bloc
-@cindex bloc de commentaire
-
-@funindex %
-@funindex %@{ ... %@}
-
-@item @strong{Les commentaires} :
-un commentaire est une indication pour tout lecteur humain d'un
-fichier source de musique ; il est ignoré par l'ordinateur, et n'a
-donc aucun effet sur la partition imprimée. On distingue deux types
+L'espace est néanmoins @strong{nécessaire} pour séparer nombre
+d'éléments syntaxiques les uns des autres. En d'autres termes, s'il est
+toujours possible d'@emph{ajouter} des espaces, il faut prendre garde à
+ne pas trop en @emph{supprimer}. En effet, l'absence d'une espace peut
+avoir des conséquences et entraîner une erreur ; aussi nous vous
+invitons à toujours insérer une espace avant et après chaque élément
+syntaxique, comme avant et après une accolade.
+
+@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 @code{()} 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{@bs{}relative c' @{ @dots{} @}}} par
+exemple -- compte également comme une seule expression musicale.
+
+@item
+@strong{Les commentaires} :
+Un commentaire est une indication pour tout lecteur humain d'un
+fichier source de musique ; il est ignoré lors de la compilation 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
+symbole @code{%} : 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.
@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
+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 :
+quelques usages possibles des commentaires :
@example
% voici les notes de "ah vous dirai-je maman"
@end itemize
+@node Gestion des erreurs
+@section Gestion des erreurs
+@translationof Dealing with errors
+
+@cindex dépannage
+
+Parfois, LilyPond ne produit pas le résultat escompté. Voici quelques
+pistes à suivre pour vous aider à éviter de telles déconvenues.
+
+@menu
+* Quand ça ne fonctionne pas::
+* Erreurs courantes::
+@end menu
+
+
+@node Quand ça ne fonctionne pas
+@subsection Quand ça ne fonctionne pas
+@translationof General troubleshooting tips
+
+Résoudre les problèmes rencontrés avec LilyPond est une gageure pour
+ceux qui ne connaissent que des interfaces graphiques puisque rien
+n'empèche de créer du code erroné. En pareil cas, il suffit souvent d'un
+peu de logique pour être en mesure d'identifier les causes du problème
+et le résoudre simplement. Le chapitre
+@rprogram{Résolution de problèmes} liste quelques directives à ce propos.
+
+
+@node Erreurs courantes
+@subsection Erreurs courantes
+@translationof Some common errors
+
+@cindex erreurs courantes
+@cindex courantes, erreurs
+
+Il peut arriver qu'un message d'erreur ne soit pas suffisamment
+explicite pour solutionner le problème. Quelques cas des plus courants
+sont répertoriés au chapitre
+@rprogram{Quelques erreurs des plus courantes}.
+
-@node How to read the manual
-@subsection How to read the manual
+@node Bien lire le manuel
+@section Bien lire le manuel
+@translationof How to read the manuals
+
+Nous allons voir ici comment consulter la documentation le plus
+efficacement possible. Nous en profiterons pour vous présenter quelques
+particularités de la domcumentation en ligne.
+
+@menu
+* Matériel incomplet::
+* Exemples cliquables::
+* Vue d'ensemble des manuels::
+@end menu
+
+
+@node Matériel incomplet
+@subsection Matériel incomplet
+@translationof Omitted material
@cindex bien lire le manuel
@cindex manuel, lecture
@cindex construction des fichiers, conseils
@cindex fichiers, conseils de construction
-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
+Comme nous l'avons vu dans @ref{Travail sur les fichiers d'entrée}, un
+code LilyPond doit être encadré par des accolades @{ @} ou bien par
+@w{@code{\relative c'' @{ @dots{} @}}}. 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 :
+affiché, mais @strong{à condition} d'ajouter
+@code{@w{\relative c'' @{ @}}} de la façon suivante :
@example
\relative c'' @{
@}
@end example
-Pourquoi avoir omis les accolades ? La plupart des exemples de ce
+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
+long. Il n'y a donc aucune raison d'ajouter @code{@w{\relative c'' @{
+@}}} à ces exemples -- en effet, il n'est pas possible d'insérer une
+expression @code{\relative} à l'intérieur d'une 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
+@node Exemples cliquables
+@subsection Exemples cliquables
+@translationof Clickable examples
-Beaucoup de gens apprennent à utiliser les programmes en les essayant
+Beaucoup de gens apprennent à utiliser les programmes en les essayant
et en bidouillant avec. C'est également possible avec LilyPond. Si
vous cliquez sur une image dans la version HTML de ce manuel, vous
verrez exactement le code LilyPond utilisé pour générer cette image.
-Essayez sur cette image :
+Essayez sur cette image :
@c no verbatim here
@c KEEP LY
@lilypond[quote,ragged-right]
-\relative c'' {
- c-\markup { \bold \huge { Cliquez ici. } }
+\relative {
+ c''-\markup { \bold \huge { Cliquez ici. } }
}
@end lilypond
@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
+d'imprimer ou de garder un lien vers @ruser{Aide-mémoire}, 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
-
-@cindex dièse
-@cindex double dièse
-@cindex dièse, double
-@cindex bémol
-@cindex double bémol
-@cindex bémol, double
-
-@funindex es
-@funindex b
-@funindex is
-@funindex d
-@funindex eses
-@funindex bb
-@funindex isis
-@funindex dd
-
-Glossaire musical : @rglos{sharp}, @rglos{flat}, @rglos{double sharp},
-@rglos{double flat}, @rglos{accidental}.
-
-Dans la notation par défaut, on obtient un @notation{dièse} en
-ajoutant @code{is} au nom de la note, et un @notation{bémol} en
-ajoutant @code{es}. Comme vous pouvez vous y attendre, un double
-dièse ou double bémol s'obtiennent en ajoutant @code{isis} ou
-@code{eses}. Cette syntaxe est dérivée de la convention de
-dénomination des notes dans les langues nordiques et germaniques,
-comme l'allemand ou le hollandais.
-
-@c DIV specific
-Cependant, si vous utilisez la commande @code{\include "italiano.ly"}
-pour entrer les noms de notes français au lieu des noms hollandais, il
-faudra ajouter un @code{d} pour obtenir un dièse, et un @code{b} pour
-un bémol. Le double dièse et le double bémol s'obtiennent en ajoutant
-respectivement @code{dd} et @code{bb}. Pour en savoir plus sur les
-autres langues disponibles, consultez @ruser{Note names in other
-languages}.
-@c END DIV
-
-@lilypond[verbatim,quote,relative=2]
-cis1 ees fisis, aeses
-@end lilypond
-
-@subheading Key signatures
-
-@cindex armure, définition de l'
-@cindex armure, altérations à l'
-@cindex altérations à l'armure
-@cindex majeur
-@cindex mineur
-
-@funindex \key
-@funindex key
-@funindex \major
-@funindex major
-@funindex \minor
-@funindex minor
-
-Glossaire musical : @rglos{key signature}, @rglos{major},
-@rglos{minor}.
-
-L'armure est déterminée par la commande @code{\key}, suivie d'une
-hauteur puis de @code{\major} (majeur) ou @code{\minor} (mineur).
-
-@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 d'une partition suit des règles, en particulier des règles
-d'indication des altérations accidentelles. Les hauteurs de note, en
-revanche, relèvent de ce que vous voulez entendre ; et, dans la mesure
-où la musique que vous entrez est censée être celle que vous voulez
-entendre, LilyPond, qui n'est chargé que de la gravure, ne les
-choisira pas à votre place.
-
-Dans cet exemple,
-
-@lilypond[verbatim,quote,relative=2]
-\key d \major
-d cis fis
-@end lilypond
-
-@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{b} ne veut pas dire @qq{Imprimez-moi un point noir sur
-la troisième ligne de la portée.} Cela signifie plutôt : @qq{Ici se
-trouve une note dont la hauteur est un si naturel.} Avec une armure
-de la bémol majeur, ce si est flanqué d'un bécarre accidentel :
-
-@lilypond[verbatim,quote,relative=2]
-\key aes \major
-b
-@end lilypond
-
-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
-
-@funindex ~
-@funindex ( ... )
-@funindex \( ... \)
-
-@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é.
-@c slur = "il zon" (articulation). jcm
-@c phrasing slur = "ils ont des chapeaux ronds" (phrase). jcm
-
-Glossaire musical : @rglos{slur}, @rglos{phrasing}.
-
-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 @emph{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 @emph{legato} indique une articulation de plusieurs notes,
-éventuellement en grand nombre. Les liaisons de tenue peuvent être
-enchâssées dans un @emph{legato} ou un phrasé.
-
-@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
-
-@funindex ^
-@funindex _
-
-Glossaire musical : @rglos{fingering}.
-
-De même, des indications de doigté peuvent être ajoutées à une note en
-utilisant un tiret (@samp{-}) et le chiffre à écrire :
-
-@lilypond[verbatim,quote,relative=2]
-c-3 e-5 b-2 a-1
-@end lilypond
-
-Articulations et doigtés sont habituellement placés automatiquement,
-mais vous pouvez spécifier leur positionnement en utilisant @samp{^} (en
-haut) ou @samp{_} (en bas). Vous pouvez aussi utiliser plusieurs
-articulations sur la même note. Dans la plupart des cas, cependant,
-il est bon de laisser LilyPond déterminer l'emplacement de
-l'articulation.
-
-@lilypond[verbatim,quote,relative=2]
-c_-^1 d^. f^4_2-> e^-_+
-@end lilypond
-
-@subheading Dynamics
-
-@funindex \f
-@funindex \ff
-@funindex \mp
-@funindex \p
-@funindex \mf
-@funindex \pp
-@funindex \<
-@funindex <
-@funindex \>
-@funindex >
-@funindex \!
-@funindex !
-
-Glossaire musical : @rglos{dynamics}, @rglos{crescendo},
-@rglos{decrescendo}.
-
-On obtient un signe de @notation{nuance} en ajoutant à la note les
-lettres du signe, précédées d'un anti-slash @samp{\} :
-
-@lilypond[verbatim,quote,relative=2]
-c\ff c\mf c\p c\pp
-@end lilypond
-
-@cindex 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
-
-@cindex texte, ajout de
-@cindex ajout de texte
-@cindex étiquette
-
-@funindex \markup
-@funindex markup
-
-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 lihature
-@cindex ligatures automatiques
-@cindex ligatures manuelles
-@cindex ligatures explicites
-
-@funindex [ ... ]
-@funindex [
-@funindex ]
-@funindex \autoBeamOff
-@funindex autoBeamOff
-@funindex \autoBeamOn
-@funindex autoBeamOn
+@node Vue d'ensemble des manuels
+@subsection Vue d'ensemble des manuels
+@translationof Overview of manuals
-Glossaire musical : @rglos{beam}.
+La documentation de LilyPond est relativement abondante. Ceci peut
+dérouter les nouveaux utilisateurs qui ne savent pas par quoi commencer
+ou bien sont tentés de faire l'impasse sur des passages importants.
-Toutes les barres de ligature sont dessinées automatiquement :
+@warning{Nous vous invitons à ne pas faire l'impasse sur les chapitres
+importants de notre documentation, au risque de vous retrouver
+complètement perdu lorsque vous aborderez d'autres parties.}
-@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 automatiques 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
-
-@subheading Partial measure
-
-@cindex levée
-@cindex anacrouse
-@cindex mesure incomplète
-
-@funindex \partial
-@funindex partial
-
-Glossaire musical : @rglos{anacrusis}.
-
-On crée une levée (ou anacrouse) avec la commande @code{\partial},
-suivie d'une durée : @code{\partial 4} produit une levée d'une noire
-et @code{\partial 8} d'une croche.
-
-@lilypond[verbatim,quote,relative=2]
-\partial 8
-f8 c2 d
-@end lilypond
-
-@subheading Tuplets
-
-@cindex nolets
-@cindex triolets
-
-@funindex \times
-@funindex times
-
-Glossaire musical : @rglos{note value}, @rglos{triplet}.
-
-Les @notation{nolets} sont créés avec la commande @code{\times}, qui
-prend deux arguments : une fraction et une expression musicale. La
-durée des notes de l'expression musicale est multipliée par la
-fraction. Par exemple les notes d'un @notation{triolet} durent les
-deux tiers de la durée de leur notation réelle, cette fraction est
-donc de 2/3 pour les triolets :
-
-@lilypond[verbatim,quote,relative=2]
-\times 2/3 { f8 g a }
-\times 2/3 { c r c }
-\times 2/3 { f,8 g16[ a g a] }
-\times 2/3 { d4 a8 }
-@end lilypond
-
-@subheading Grace notes
-
-@cindex notes d'ornement
-@cindex ornementation
-@cindex appoggiature
-@cindex acciaccature
-
-@funindex \grace
-@funindex grace
-@funindex \acciaccatura
-@funindex acciaccatura
-@funindex \appoggiatura
-@funindex acciaccatura
+@itemize
-Glossaire musical : @rglos{grace notes}, @rglos{acciaccatura},
-@rglos{appoggiatura}.
+@item
+@strong{Avant de vous lancer dans @emph{quoi que ce soit}}, lisez le
+@ref{Tutoriel} contenu dans le manuel d'initiation ainsi que les
+@ref{Bases de notation musicale}. Si vous y trouvez des termes que vous
+ne connaissez pas, n'hésitez pas à consulter le
+@rglosnamed{Top, Glossaire}.
-Des @notation{notes d'ornement} s'obtiennent en appliquant la commande
-@code{\grace}, @code{\appoggiatura} ou @code{\acciaccatura} à une
-expression musicale :
+@item
+@strong{Avant de vous lancer dans la réalisation d'une partition
+complète}, lisez le chapitre @ref{Concepts fondamentaux} du manuel
+d'initiation. Vous pourrez alors vous reporter aux parties qui vous
+intéresseront dans le @rusernamed{Top, Manuel de notation}.
-@lilypond[verbatim,quote,relative=2]
-c2 \grace { a32[ b] } c2
-c2 \appoggiatura b16 c2
-c2 \acciaccatura b16 c2
-@end lilypond
+@item
+@strong{Avant de modifier les réglages par défaut}, consultez le
+chapitre @ref{Retouche de partition} du manuel d'initiation.
+@item
+@strong{Avant de vous lancer dans un projet d'envergure}, lisez le
+chapitre @rprogram{Suggestions pour la saisie de fichiers LilyPond} du
+manuel d'utilisation.
-@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
-
-@subheading Analogy: mathematical expressions
-
-@cindex expression
-
-Ce mécanisme est similaire aux formules mathématiques : une grosse
-formule est créée en assemblant plusieurs petites formules. De telles
-formules sont appelées expressions, elles ont une définition
-récursive, de telle sorte que vous pouvez fabriquer des expressions
-arbitrairement longues et complexes. Par exemple :
-
-@example
-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
-
-@cindex portées multiples
-@cindex polyphonie
-@cindex combinaison d'expressions en parallèle
-@cindex parallèles, expressions
-@cindex expressions parallèles
-@cindex hauteur relative et musique simultanée
-@cindex musique simultanée et hauteur relative
-@cindex hauteur relative et expressions parallèles
-@cindex expressions parallèles et hauteur relative
-
-@funindex <<
-@funindex >>
-@funindex << ... >>
-
-Glossaire musical : @rglos{polyphony}.
-
-Cette technique est utile pour de la musique @notation{polyphonique}.
-Pour entrer une musique avec plusieurs voix ou plusieurs portées, nous
-pouvons aussi combiner @emph{en parallèle} les expressions : deux voix
-qui doivent être jouées en même temps, sont entrées comme une
-combinaison simultanée de deux expressions. Une expression musicale
-@qq{simultanée} est formée en entourant les expressions entre @code{<<}
-et @code{>>}. Dans l'exemple suivant, trois expressions (contenant
-chacune deux notes distinctes) sont combinées simultanément.
-
-@lilypond[verbatim,quote]
-\relative c'' {
- <<
- { a4 g }
- { f e }
- { d b }
- >>
-}
-@end lilypond
-
-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
-
-@cindex multiples portées
-@cindex portées multiples
-@cindex contexte
-@cindex contexte de notation
-@cindex notation, contexte
-
-@funindex \new Staff
-@funindex new Staff
-@funindex Staff
-@funindex \new
-@funindex new
-@funindex Score
-@funindex Voice
-@funindex Lyrics
-@funindex ChordNames
-
-Comme nous l'avons vu dans @ref{Music expressions explained}, un
-fichier d'entrée LilyPond est fait d'expressions musicales. Si la
-partition commence par plusieurs expressions simultanées, LilyPond
-créera plusieurs portées. Cependant, il est plus facile de prévoir le
-nombre de portées si on les crée explicitement, ce que nous allons
-voir.
-
-Pour créer plus d'une portée, on ajoute @code{\new Staff} au début de
-chaque partie de la musique constituant une portée. Ces éléments
-@code{Staff} sont ensuite combinés en parallèle avec @code{<<} et
-@code{>>}, comme ci-dessous.
-
-@lilypond[verbatim,quote]
-\relative c'' {
- <<
- \new Staff { \clef treble c }
- \new Staff { \clef bass c,, }
- >>
-}
-@end lilypond
-
-
-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
-@cindex chœur, système pour
-@cindex système pour chœur
-@cindex système
-@cindex portées, regroupement de
-@cindex regroupement de portées
-
-@funindex PianoStaff
-@funindex GrandStaff
-@funindex ChoirStaff
-
-Glossaire musical : @rglos{brace}.
-
-La musique pour piano s'écrit sur deux portées reliées par une
-@notation{accolade}. La gravure de ce type de portée est semblable à
-l'exemple de musique polyphonique de @ref{Multiple staves}, mais
-maintenant cette expression entière est interprétée dans un contexte
-@code{PianoStaff} :
-
-@example
-\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 and other multi-staff instruments},
-@ruser{Displaying staves}.
-
-
-@node Combining notes into chords
-@subsection Combining notes into chords
-
-@cindex accords, notes simultanées
-@cindex accords et durée
-
-@funindex <
-@funindex >
-@funindex < ... >
-
-Glossaire musical : @rglos{chord}.
-
-Nous avons vu précédemment comment combiner des notes simultanément,
-en les encadrant par des angles doubles @code{<<} et @code{>>}. Pour
-produire des accords simples, c'est-à-dire une superposition de notes
-de même durée, on encadre les hauteurs de notes par des angles simples
-@code{<} et @code{>}, et on écrit la durée juste après.
-
-@lilypond[verbatim,quote,relative=2]
-r4 <c e g>4 <c f a>2
-@end lilypond
-
-Beaucoup d'éléments de notation que l'on peut attacher à une note
-simple, comme une liaison, un crochet indiquant un début ou une fin de
-lien, un signe d'articulation, peuvent être également attachés à un
-accord : il faut ajouter ces indications après les hauteurs et la
-durée, donc @emph{à l'extérieur} des angles.
-
-@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
-@cindex silence invisible
-@cindex invisible, silence
-
-@funindex << ... \\ ... >>
-@funindex <<
-@funindex \\
-@funindex >>
-
-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, autrement dit avec @code{@{...@}}, puis en combinant
-simultanément les voix et en les séparant par @code{\\}.
-
-@lilypond[verbatim,quote,relative=2]
-<<
- { a4 g2 f4~ f4 } \\
- { r4 g4 f2 f4 }
->>
-@end lilypond
-
-Pour l'écriture de musique polyphonique, les silences invisibles
-s'avèrent bien pratiques : ce sont des silences qui ne s'impriment pas.
-Ils sont utiles pour remplir des voix qui, temporairement, ne jouent
-rien. Voici le même exemple que ci-dessus, avec un silence invisible
-@code{s} (pour @emph{skip}) à la place d'un silence normal @code{r} :
-
-@lilypond[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
-
-@funindex \addlyrics
-@funindex addlyrics
-
-Glossaire musical : @rglos{lyrics}.
-
-Prenons une mélodie toute simple, la comptine @emph{Girls and boys
-come out to play}.
-
-@lilypond[verbatim,quote]
-\relative c'' {
- \key g \major
- \time 6/8
- d4 b8 c4 a8 d4 b8 g4
-}
-@end lilypond
-
-Des @notation{paroles} peuvent être associées à ces notes, en les
-combinant avec la commande @code{\addlyrics}. On entre les paroles en
-séparant chaque syllable par un espace :
-
-@lilypond[verbatim,quote]
-<<
- \relative c'' {
- \key g \major
- \time 6/8
- d4 b8 c4 a8 d4 b8 g4
- }
- \addlyrics {
- Girls and boys come out to play,
- }
->>
-@end lilypond
-
-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)
-@cindex paroles, alignement des
-@cindex alignement des paroles
-@cindex paroles, mot de plusieurs syllabes
-
-Glossaire musical : @rglos{melisma}, @rglos{extender line}.
-
-La ligne suivante de la comptine précédente est @emph{The moon doth
-shine as bright as day}. Ajoutons-la au code.
-
-@lilypond[verbatim,quote]
-<<
- \relative c'' {
- \key g \major
- \time 6/8
- d4 b8 c4 a8 d4 b8 g4
- g8 a4 b8 c b a d4 b8 g4.
- }
- \addlyrics {
- Girls and boys come out to play,
- The moon doth shine as bright as day;
- }
->>
-@end lilypond
-
-Remarquez que les paroles ajoutées ne s'alignent pas bien avec les
-notes. Le mot @emph{shine} devrait être chanté sur deux notes au lieu
-d'une. On appelle ceci un @notation{mélisme} : il s'agit d'une seule
-syllabe chantée sur plus d'une note. Il existe plusieurs façons
-d'étaler une sylabe sur plusieurs notes, la plus simple étant de lier
-les notes du mélisme. Pour les détails, consultez @ref{Ties and
-slurs}.
-
-@lilypond[verbatim,quote]
-<<
- \relative c'' {
- \key g \major
- \time 6/8
- d4 b8 c4 a8 d4 b8 g4
- g8 a4 b8 c( b) a d4 b8 g4.
- }
- \addlyrics {
- Girls and boys come out to play,
- The moon doth shine as bright as day;
- }
->>
-@end lilypond
-
-Les paroles sont maintenant correctement alignées, mais les liens de
-croche automatiques ne conviennent pas pour les notes au-dessus de
-@emph{shine as}. On peut les corriger en ajoutant des liens de croche
-manuels, pour ceci consultez @ref{Automatic and manual beams}.
-
-@lilypond[verbatim,quote]
-<<
- \relative c'' {
- \key g \major
- \time 6/8
- d4 b8 c4 a8 d4 b8 g4
- g8 a4 b8 c([ b]) a d4 b8 g4.
- }
- \addlyrics {
- Girls and boys come out to play,
- The moon doth shine as bright as day;
- }
->>
-@end lilypond
-
-Au lieu d'utiliser une liaison, on peut indiquer le mélisme dans les
-paroles en insérant un caractère souligné @code{_} pour chaque note du
-mélisme sauf la première.
-
-@lilypond[verbatim,quote]
-<<
- \relative c'' {
- \key g \major
- \time 6/8
- d4 b8 c4 a8 d4 b8 g4
- g8 a4 b8 c[ b] a d4 b8 g4.
- }
- \addlyrics {
- Girls and boys come out to play,
- The moon doth shine _ as bright as day;
- }
->>
-@end lilypond
-
-Si une syllabe s'étend sur un grand nombre de notes ou une note très
-longue, on représente souvent le mélisme par un @notation{trait de
-prolongation}, qu'on entre avec @code{__}. L'exemple suivant montre
-les trois premières mesures de la plainte de Didon, extraite de
-@emph{Didon et Énée} de Purcell.
-
-@lilypond[verbatim,quote]
-<<
- \relative c'' {
- \key g \minor
- \time 3/2
- g2 a bes bes( a)
- b c4.( bes8 a4. g8 fis4.) g8 fis1
- }
- \addlyrics {
- When I am laid,
- am laid __ in earth,
- }
->>
-@end lilypond
-
-Aucun exemple jusqu'à présent n'a utilisé de mots de plus d'une
-syllabe. Dans des paroles, de tels mots sont écrits en syllabes
-séparées par des traits d'union. Avec LilyPond, on utilise deux
-tirets pour produire un trait d'union centré entre deux syllabes.
-L'exemple suivant montre tout ce que nous avons vu jusqu'à maintenant
-sur l'alignement de paroles à une mélodie.
-
-@c no ragged-right here because otherwise the hyphens get lost,
-@c but the example is long enough to avoid looking strange.
-@lilypond[verbatim,quote,noragged-right]
-<<
- \relative c' {
- \key g \major
- \time 3/4
- \partial 4
- d4 g4 g a8( b) g4 g4
- b8( c) d4 d e4 c2
- }
- \addlyrics {
- A -- way in a __ man -- ger,
- no __ crib for a bed, __
- }
->>
-@end lilypond
-
-Avec certaines paroles, en particulier en italien, il se produit la
-situation inverse : il peut y avoir plusieurs syllabes sur une seule
-note. On réalise ceci avec LilyPond grâce à un caractère souligné
-@code{_} sans espace entre les syllabes, ou alors en groupant les
-syllabes avec des guillemets. L'exemple suivant est extrait de l'air
-de Figaro @emph{Largo al factotum}, dans @emph{Figaro} de Rossini, où
-la syllabe @emph{al} est chantée sur la même note que @emph{go}.
-
-@c no ragged-right here because otherwise the hyphens get lost,
-@c but the example is long enough to avoid looking strange.
-@lilypond[verbatim,quote,noragged-right]
-<<
- \relative c' {
- \clef bass
- \key c \major
- \time 6/8
- c4.~ c8 d b c([ d]) b c d b c
- }
- \addlyrics {
- Lar -- go_al fac -- to -- tum del -- la cit -- tà
- }
->>
-@end lilypond
-
-
-@seealso
-Manuel de notation : @ruser{Vocal music}.
-
-
-@node Lyrics to multiple staves
-@subsection Lyrics to multiple staves
-
-@cindex paroles et portées mutiples
-@cindex portées multiples et paroles
-
-La méthode simple d'ajout de paroles avec @code{\addlyrics} peut être
-également utilisée pour placer des paroles sous plusieurs portées.
-L'exemple suivant est extrait de @emph{Judas Macchabée} de Händel.
-
-@lilypond[verbatim,quote]
-<<
- \relative c'' {
- \key f \major
- \time 6/8
- \partial 8
- c8 c([ bes]) a a([ g]) f f'4. b, c4.~ c4
- }
- \addlyrics {
- Let flee -- cy flocks the hills a -- dorn, __
- }
- \relative c' {
- \key f \major
- \time 6/8
- \partial 8
- r8 r4. r4 c8 a'([ g]) f f([ e]) d e([ d]) c bes'4
- }
- \addlyrics {
- Let flee -- cy flocks the hills a -- dorn,
- }
->>
-@end lilypond
-
-Pour produire des partitions plus complexes ou plus longues que cet
-exemple simple, il est vivement conseillé de séparer la structure de
-la partition des notes et paroles, grâce à des variables. Ceci sera
-détaillé plus loin dans @ref{Organizing pieces with variables}.
-
-
-@seealso
-Manuel de notation : @ruser{Vocal music}.
-
-
-@node Final touches
-@section Final touches
-
-L'ultime section de ce tutoriel montre comment ajouter une touche
-finale à des morceaux simples, et constitue une introduction au reste
-du manuel.
-
-@menu
-* Organizing pieces with variables::
-* Version number::
-* Adding titles::
-* Absolute note names::
-* After the tutorial::
-@end menu
-
-
-@node Organizing pieces with variables
-@subsection Organizing pieces with variables
-
-@cindex variables
-@cindex variables, definition
-@cindex identificateurs
-@cindex macros
-@cindex assignation de variables
-@cindex utilisation de variables
-@cindex variables, utilisation de
-@cindex variables, caractères autorisés dans les
-@cindex caractères autorisés dans les variables
-
-Lorsque l'on combine tous les éléments étudiés précédemment pour
-écrire des partitions plus longues, les expressions musicales prennent
-de l'ampleur et, dans le cas des pièces polyphoniques, deviennent
-profondément imbriquées, jusqu'au point où il devient difficile de se
-repérer dans le fichier source. Cet inconvénient peut être résolu par
-l'utilisation de @emph{variables}.
-
-En utilisant des variables, parfois appelées identificateurs ou
-macros, on peut scinder des expressions musicales complexes en des
-expressions plus simples. Une variable se définit comme suit :
-
-@example
-musiqueToto = @{ @dots{} @}
-@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 version
-@cindex versionage
-@cindex numéro de version
-@cindex version, numéro de
-@cindex mise à jour
-@cindex future mise à jour
-@cindex mise à jour de fichiers
-@cindex fichiers, mise à jour de
-
-@funindex \version
-@funindex version
-@funindex convert-ly
-
-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
-@rprogram{Updating files with convert-ly}.
-
-
-@node Adding titles
-@subsection Adding titles
-
-@cindex titre
-@cindex en-têtes
-@cindex bloc d'en-tête
-
-@funindex \header
-@funindex header
-
-On indique les informations bibliographiques --- nom du morceau, du
-compositeur, numéro d'opus@dots{} --- dans un bloc à part, le bloc
-d'en-tête @code{\header}, qui existe indépendamment de l'expression
-musicale principale. Le bloc @code{\header} est habituellement placé
-en début de fichier, après le numéro de version.
-
-@example
-\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
-
-@cindex notes, nom des
-@cindex absolu, mode
-@cindex mode absolu
-@cindex hauteurs, valeurs absolues
-@cindex noms de note absolus
-
-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, et serait donc 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 recherches infructueuses.
+@end itemize
projects / lilypond.git / blobdiff