1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
3 Translation of GIT committish: 95e6825ee09ca7f8eea87580301c8819ff1d571b
5 When revising a translation, copy the HEAD committish of the
6 version that you are working on. For details, see the Contributors'
7 Guide, node Updating translation committishes..
12 @c Translators: Nicolas Grandclaude, Ludovic Sardain, Gauvain Pocentek
13 @c Translation checkers: Jean-Charles Malahieude, Valentin Villenave, John Mandereau
14 @c Translation status: post-GDP
18 @translationof Tutorial
20 Ce tutoriel est une introduction au langage musical utilisé
21 par LilyPond, qui vous permettra de faire fonctionner le logiciel pour
22 produire une partition.
25 * Compilation d'un fichier::
27 * Travail sur les fichiers d'entrée::
28 * Bien lire le manuel::
32 @node Compilation d'un fichier
33 @section Compilation d'un fichier
34 @translationof Compiling a file
37 @cindex exemple, premier
38 @cindex premier exemple
40 Pour créer une partition avec LilyPond, on écrit un fichier texte,
41 appelé fichier source, qui décrit la notation musicale. La
42 @emph{compilation} de ce fichier source par LilyPond produit un
43 fichier graphique imprimable, et si on le désire un fichier MIDI qui
44 peut être joué par un séquenceur.
46 Voici un premier exemple simple de fichier source LilyPond.
55 La compilation de ce fichier donnera quelque chose de sembable à
58 @c in this case we don't want verbatim
66 Il est aussi possible d'utiliser les noms de notes français @qq{@w{do
67 re mi fa sol la si}}, en insérant au début du fichier la ligne
68 @w{@code{\include@tie{}"italiano.ly"}}.
71 @warning{Tout extrait de code LilyPond doit être entouré d'une
72 @strong{@{ paire d'accolades @}}. De plus, pour éviter toute
73 ambiguïté, il est préférable d'entourer les accolades par des espaces
74 ou retours à la ligne. Bien que certains exemples de ce manuel ne
75 comportent pas d'accolades, ne les oubliez pas dans vos partitions !
76 Pour plus d'informations sur l'affichage des exemples de cette
77 documentation, consultez @ref{Bien lire le manuel}.}
80 @cindex casse, prise en compte de la
81 @cindex prise en compte de la casse
82 @cindex sensibilité à la casse
84 De plus, LilyPond est @strong{sensible à la casse} : le code
85 @w{@code{@{ c d e @}}} est valide, alors que @w{@code{@{ C D E @}}}
86 produira un message d'erreur.
90 @subheading Saisie de la musique et visualisation de la partition produite
94 @cindex partition, lire
95 @cindex lire la partition
96 @cindex éditeurs de texte
97 @cindex LilyPond et MacOS X
98 @cindex MacOS X et LilyPond
99 @cindex LilyPond et Windows
100 @cindex Windows et LilyPond
101 @cindex LilyPond et Unix
102 @cindex Unix et LilyPond
104 Dans cette section nous expliquerons quelles commandes exécuter et
105 comment voir ou imprimer le résultat produit par LilyPond.
107 Notez qu'il existe plusieurs éditeurs de texte disponibles avec un bon
108 support de LilyPond ; consultez @rprogram{LilyPond et les éditeurs de texte}.
110 @warning{Le premier démarrage de LilyPond peut prendre une minute ou
111 deux, afin de générer la liste des polices du système. LilyPond démarre
112 en principe plus rapidement lors des exécutions suivantes.}
115 @subsubheading MacOS X
117 Si vous double-cliquez sur @code{LilyPond.app}, un fichier d'exemple
118 s'ouvrira. Sauvegardez-le, par exemple, sous @code{test.ly} sur votre
119 bureau, puis traitez-le avec la commande de menu
120 @w{@code{Compile > Typeset File}}. Le fichier PDF résultant sera alors
123 À l'avenir, vous aurez certainement recours aux commandes @qq{Nouveau}
124 ou @qq{Ouvrir}. Vous devez enregistrer votre fichier avant de lancer
125 la gravure de la partition par LilyPond. Si une erreur apparaît
126 pendant le traitement, vous la trouverez dans la fenêtre @qq{log}.
128 @subsubheading Windows
130 Sous Windows, double-cliquez sur l'icône LilyPond qui se trouve sur le
131 bureau, un fichier d'exemple s'ouvre dans un simple éditeur de texte.
132 Enregistrez-le, par exemple en tant que @code{test.ly} sur le bureau,
133 puis double-cliquez sur son icône (qui montre une note de musique)
134 pour le traiter. Après quelques secondes, vous obtiendrez un fichier
135 @code{test.pdf} sur le bureau, fichier que vous pourrez ouvrir pour
136 voir la partition gravée. Une autre méthode pour lancer le traitement
137 du fichier @code{test.ly} est de le glisser avec votre souris sur
140 Pour modifier un fichier @code{.ly} existant, faites un clic droit
141 dessus et sélectionnez @qq{Éditer la source}. Pour partir d'un
142 fichier vide, lancez l'éditeur en ouvrant un fichier existant et
143 utilisez la commande @qq{New} du menu @qq{File}.
145 En double-cliquant sur le fichier, vous obtiendrez, en plus du fichier
146 PDF, un fichier @code{.log} qui récapitule les opérations que LilyPond
147 a effectuées sur votre fichier. Si une erreur survient, vous en
148 trouverez les détails dans ce fichier.
152 Créez un fichier texte @code{test.ly} qui contient
161 Pour traiter @code{test.ly}, entrez la commande suivante dans un
169 Vous verrez quelque chose ressemblant à
173 GNU LilyPond @version{}
174 Traitement de « test.ly »
176 Interprétation en cours de la musique...
177 Pré-traitement des éléments graphiques...
178 Détermination du nombre optimal de pages...
179 Répartition de la musique sur une page...
180 Dessin des systèmes...
181 Sortie mise en page vers « test.ps »...
182 Conversion à « ./test.pdf »...
187 Suivant votre installation, ces messages peuvent être traduits ou
192 @node Notation simple
193 @section Notation simple
194 @translationof Simple notation
196 @cindex simple, notation
197 @cindex notation simple
199 Il y a certains éléments graphiques de notation que LilyPond ajoute
200 automatiquement. Dans l'exemple suivant, nous n'avons fourni que
201 quatre hauteurs, mais LilyPond a ajouté une clef, un chiffre de mesure
204 @lilypond[verbatim,quote]
211 Ces valeurs automatiques simplifient la saisie du code source dans
212 bien des cas ; nous verrons plus loin comment les indiquer
222 @cindex altérations et mode relatif
223 @cindex mode relatif et altérations
230 Glossaire musical : @rglos{pitch}, @rglos{interval},
231 @rglos{scale}, @rglos{middle C}, @rglos{octave},
234 Le moyen le plus simple d'entrer des notes est d'utiliser le mode
235 d'octaves relatives, ou mode @code{\relative}. Dans ce mode, l'octave
236 de chaque note est sélectionnée automatiquement de façon à ce qu'elle
237 soit le plus proche possible de la note précédente, c'est-à-dire de
238 façon à ce que l'intervalle avec la note précédente soit au plus d'une
239 quarte. Commençons par saisir une partition très simple, à savoir une
242 @lilypond[verbatim,quote]
243 % set the starting point to middle C
250 La note de départ est le @notation{do central}. Chacune des notes qui
251 suivent est placée à l'octave la plus proche de la note précédente --
252 en d'autres termes, le premier @code{c} est le do central, entre la
253 clef de sol et la clef de fa, puis est suivi par le @notation{ré} le
254 plus proche, et ainsi de suite. On peut bien sûr créer des mélodies
255 avec de plus grands intervalles, toujours avec le mode @code{\relative} :
257 @lilypond[verbatim,quote]
265 Remarquez que cet exemple ne commence plus sur le @notation{do central}
266 : la première note -- le @code{d} -- est le ré qui en est le plus proche.
268 Dans l'exemple suivant, on remplace @code{c'} dans la commande
269 @w{@code{\relative c' @{}} par @code{c''}, afin de calculer l'octave de
270 la première note par rapport au do situé une octave au-dessus du do
273 @lilypond[verbatim,quote]
274 % one octave above middle C
280 Le mode d'octaves relatives peut être déroutant au début, mais c'est
281 souvent la façon la plus économique de saisir les hauteurs en
282 utilisant le clavier de l'ordinateur de façon classique. Détaillons
283 dans un exemple le calcul des octaves relatives. En partant d'un si
284 sur la troisième ligne de la clé de sol, un do, un ré ou un mi sans
285 indication d'octave particulière seront placés juste au-dessus du si,
286 c'est-à-dire au plus à une quarte ascendante du si, alors qu'un la, un
287 sol ou un fa seront placés juste en-dessous du si, c'est-à-dire au
288 plus à une quarte descendante du si.
290 @lilypond[verbatim,quote]
292 b c % c is 1 staff space up, so is the c above
293 b d % d is 2 up or 5 down, so is the d above
294 b e % e is 3 up or 4 down, so is the e above
295 b a % a is 6 up or 1 down, so is the a below
296 b g % g is 5 up or 2 down, so is the g below
297 b f % f is 4 up or 3 down, so is the f below
301 Notez que le calcul des octaves relatives @strong{ne tient pas compte
302 des altérations} des notes, dièse bémol ou bécarre.
304 Pour obtenir des intervalles supérieurs à une quarte, on peut ajouter
305 des apostrophes @code{'} -- qui font chacune monter la hauteur d'une
306 octave -- ou des virgules @code{,} -- qui font chacune descendre la
307 hauteur d'une octave -- au nom de la note.
309 @lilypond[verbatim,quote]
317 Pour déplacer une note deux octaves (ou davantage !) plus haut ou plus
318 bas, il suffit de mettre deux (ou davantage) @code{'} ou @code{,} --
319 attention cependant à bien mettre deux apostrophes @code{''}, et non
320 un guillemet @code{"}@tie{}! C'est de cette même manière que l'on
321 peut modifier la valeur de départ de @w{@code{\relative c'}}.
324 @subheading Durées et rythme
333 @cindex spécification des durées
335 Glossaire musical : @rglos{beam}, @rglos{duration},
336 @rglos{whole note}, @rglos{half note}, @rglos{quarter note},
339 La @notation{durée} d'une note est indiquée par un nombre qui suit sa
340 hauteur : @code{1} pour une @notation{ronde}, @code{2} pour une
341 @notation{blanche}, @code{4} pour une @notation{noire} et ainsi de
342 suite. Les @notation{crochets} et @notation{liens} sont ajoutés
345 Si aucune durée n'est indiquée pour une note, la dernière durée entrée
346 est utilisée. En l'absence d'indication de durée, la première note
349 @lilypond[verbatim,quote]
353 a16 a a a a32 a a a a64 a a a a a a a a2
357 Une @notation{note pointée} s'obtient en ajoutant un point @code{.} à
358 la valeur rythmique. Le point doit être précédé d'un nombre spécifiant
361 @lilypond[verbatim,quote]
372 @cindex notation des silences
374 Glossaire musical : @rglos{rest}.
376 On saisit un @notation{silence} tout comme une note, mais avec la
377 lettre @code{r} (pour @emph{rest}).
379 @lilypond[verbatim,quote]
390 @cindex chiffre de mesure
395 Glossaire musical : @rglos{time signature}.
397 La @notation{métrique}, aussi appelée @notation{chiffre de mesure},
398 peut être définie à l'aide de la commande @code{\time} :
400 @lilypond[verbatim,quote]
423 Glossaire musical : @rglos{clef}.
425 La @notation{clef} peut être définie à l'aide de la commande
428 @lilypond[verbatim,quote]
442 @subheading Tout ensemble
444 Voici un bref exemple qui rassemble tous les éléments que nous déjà
447 @lilypond[verbatim,quote]
458 Manuel de notation : @ruser{Écriture des hauteurs de note},
459 @ruser{Écriture du rythme}, @ruser{Écriture des silences},
460 @ruser{Métrique}, @ruser{Clefs}.
463 @node Travail sur les fichiers d'entrée
464 @section Travail sur les fichiers d'entrée
465 @translationof Working on input files
467 Le traitement des fichiers source de LilyPond est semblable à celui du
468 code de nombreux langages de programmation. La casse est prise
469 en compte, et les caractères considérés comme espaces ont généralement
470 peu d'importance. Les expressions sont délimitées par des accolades @{
471 @}, et les commentaires par @code{%} ou @w{@code{%@{ dots{} @}}}.
473 Si cette phrase vous paraît incompréhensible, ne vous en faites pas !
474 Expliquons tous ces termes :
476 @cindex casse, prise en compte de
477 @cindex prise en compte de la casse
478 @cindex sensibilité à la casse
483 LilyPond est sensible à la casse, c'est à dire qu'une lettre capitale
484 n'a pas la même valeur qu'une lettre minuscule. Les notes, par
485 exemple, doivent être entrées en minuscule : @w{@code{@{ c d e @}}} est
486 un code valide, alors que @w{@code{@{ C D E @}}} produira un message
489 @cindex espaces multiples, insensibilité
490 @cindex insensibilité aux espaces multiples
492 @item @strong{Les espaces multiples} :
493 LilyPond ne tient pas compte du nombre d'espaces, ou de retours à la
494 ligne. @code{@{ c d e @}} a le
495 même sens que @code{@{ c @tie{} @tie{} d @tie{} e @}} ou que
503 Bien sûr, ce dernier exemple est illisible. Une bonne habitude
504 à prendre est d'indenter les blocs de code avec soit des tabulations
505 soit des doubles espaces :
517 @item @strong{Expressions musicales} :
518 Tout morceau saisi dans LilyPond doit être placé entre @strong{@{
519 accolades @}}. Ces caractères indiquent à LilyPond que ce bloc de
520 texte représente une et une seule expression musicale, tout comme les
521 parenthèses @code{()} en mathématiques. Pour éviter toute ambiguïté,
522 il est préférable d'entourer ces accolades d'espaces ou de retours à
525 Un appel de fonction -- @w{@code{\relative @{ @}}} par exemple --
526 compte également comme une seule expression musicale.
529 @cindex commentaire de fin de ligne
530 @cindex commentaire-bloc
531 @cindex bloc de commentaire
534 @funindex %@{ ... %@}
536 @item @strong{Les commentaires} :
537 Un commentaire est une indication pour tout lecteur humain d'un
538 fichier source de musique ; il est ignoré par l'ordinateur, et n'a
539 donc aucun effet sur la partition imprimée. On distingue deux types
540 de commentaires. Le commentaire de fin de ligne, introduit par le
541 symbole @code{%} : tout ce qui suit ce symbole sur la même ligne sera
542 ignoré. Par convention, un commentaire qui occupe une ligne entière
543 se place juste @emph{au-dessus} de la ligne à laquelle il fait
548 % ce commentaire fait référence aux si
552 Le bloc de commentaire, qui peut occuper plusieurs lignes, voire toute
553 une section : tout ce qui se trouve entre @code{%@{} et @code{%@}} est
554 ignoré. Les blocs de commentaires ne peuvent s'imbriquer, ce qui
555 signifie que vous ne pouvez pas placer un commentaire-bloc à
556 l'intérieur d'un autre commentaire-bloc. Si jamais vous essayez, vous
557 verrez que la première occurence de @code{%@}} terminera @qq{les
558 @emph{deux} commentaires-blocs}. Le fragment suivant met en évidence
559 quelques usages possibles des commentaires :
562 % voici les notes de "ah vous dirai-je maman"
566 Ces lignes et les notes qui suivent
567 seront ignorées, car elles se trouvent
568 dans un bloc de commentaire.
578 @node Bien lire le manuel
579 @section Bien lire le manuel
580 @translationof How to read the manual
582 @cindex bien lire le manuel
583 @cindex manuel, lecture
584 @cindex compulser le manuel
585 @cindex exemples cliquables
586 @cindex cliquables, exemples
587 @cindex conseils de construction des fichiers
589 @cindex construction des fichiers, conseils
590 @cindex fichiers, conseils de construction
592 Comme nous l'avons vu dans @ref{Travail sur les fichiers d'entrée}, un code
593 LilyPond doit être encadré par des accolades @{ @} ou bien par
594 @code{@w{\relative c'' @{ @dots{} @}}}. Cependant, dans la suite de ce
595 manuel, la plupart des exemples ne feront pas apparaître ces signes.
597 Pour reproduire les exemples, vous pouvez copier et coller le code
598 affiché, mais @strong{à condition} d'ajouter
599 @code{@w{\relative c'' @{ @}}} de la façon suivante :
603 ...collez ici votre exemple...
607 Pourquoi avoir omis les accolades ? La plupart des exemples de ce
608 manuel peuvent être insérés au milieu d'un morceau de musique plus
609 long. Il n'y a donc aucune raison d'ajouter @code{@w{\relative c'' @{
610 @}}} à ces exemples -- en effet, il n'est pas possible d'insérer une
611 expression @code{\relative} à l'intérieur d'une autre expression
612 @code{\relative}. Si nous mettions tous nos exemples dans une
613 expression @code{\relative}, vous ne pourriez plus copier un bref
614 exemple de la documentation pour le coller dans vos pièces.
617 @subheading Exemples cliquables
619 Beaucoup de gens apprennent à utiliser les programmes en les essayant
620 et en bidouillant avec. C'est également possible avec LilyPond. Si
621 vous cliquez sur une image dans la version HTML de ce manuel, vous
622 verrez exactement le code LilyPond utilisé pour générer cette image.
623 Essayez sur cette image :
627 @lilypond[quote,ragged-right]
629 c-\markup { \bold \huge { Cliquez ici. } }
633 En copiant-collant le code à partir du commentaire @qq{ly snippet}
634 vers un fichier test, vous aurez un modèle de base pour faire vos
635 expériences. Pour obtenir une gravure à l'identique, copiez tout le
636 code à partir de @qq{Start cut-&-pastable section}.
638 @c No longer in the text in English, but should we really
641 Si vous apprenez de cette façon, vous aurez probablement envie
642 d'imprimer ou de garder un lien vers @ruser{Aide-mémoire}, tableau
643 qui répertorie les commandes usuelles pour une consultation rapide.
648 Vous trouverez plus de conseils pour construire des fichiers source
649 dans @ref{Suggestions pour la saisie de fichiers LilyPond}. Cependant,
650 lors d'une première lecture il est préférable de terminer d'abord la