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. See TRANSLATION for details.
11 @c Translators: Nicolas Grandclaude, Ludovic Sardain, Gauvain Pocentek
12 @c Translation checkers: Jean-Charles Malahieude, Valentin Villenave, John Mandereau
13 @c Translation status: post-GDP
17 @translationof Tutorial
19 Ce tutoriel est une introduction au langage musical utilisé
20 par LilyPond, qui vous permettra de faire fonctionner le logiciel pour
21 produire une partition.
24 * Compilation d'un fichier::
26 * Travail sur les fichiers d'entrée::
27 * Bien lire le manuel::
31 @node Compilation d'un fichier
32 @section Compilation d'un fichier
33 @translationof Compiling a file
36 @cindex exemple, premier
37 @cindex premier exemple
39 Pour créer une partition avec LilyPond, on écrit un fichier texte,
40 appelé fichier source, qui décrit la notation musicale. La
41 @emph{compilation} de ce fichier source par LilyPond produit un
42 fichier graphique imprimable, et si on le désire un fichier MIDI qui
43 peut être joué par un séquenceur.
45 Voici un premier exemple simple de fichier source LilyPond.
54 La compilation de ce fichier donnera quelque chose de sembable à
57 @c in this case we don't want verbatim
65 Il est aussi possible d'utiliser les noms de notes français @qq{@w{do
66 re mi fa sol la si}}, en insérant au début du fichier la ligne
67 @w{@code{\include@tie{}"italiano.ly"}}.
70 @warning{Tout extrait de code LilyPond doit être entouré d'une
71 @strong{@{ paire d'accolades @}}. De plus, pour éviter toute
72 ambiguïté, il est préférable d'entourer les accolades par des espaces
73 ou retours à la ligne. Bien que certains exemples de ce manuel ne
74 comportent pas d'accolades, ne les oubliez pas dans vos partitions !
75 Pour plus d'informations sur l'affichage des exemples de cette
76 documentation, consultez @ref{Bien lire le manuel}.}
79 @cindex casse, prise en compte de la
80 @cindex prise en compte de la casse
81 @cindex sensibilité à la casse
83 De plus, LilyPond est @strong{sensible à la casse} : le code
84 @w{@code{@{ c d e @}}} est valide, alors que @w{@code{@{ C D E @}}}
85 produira un message d'erreur.
89 @subheading Saisie de la musique et visualisation de la partition produite
93 @cindex partition, lire
94 @cindex lire la partition
95 @cindex éditeurs de texte
96 @cindex LilyPond et MacOS X
97 @cindex MacOS X et LilyPond
98 @cindex LilyPond et Windows
99 @cindex Windows et LilyPond
100 @cindex LilyPond et Unix
101 @cindex Unix et LilyPond
103 Dans cette section nous expliquerons quelles commandes exécuter et
104 comment voir ou imprimer le résultat produit par LilyPond.
106 Notez qu'il existe plusieurs éditeurs de texte disponibles avec un bon
107 support de LilyPond ; consultez @rprogram{LilyPond et les éditeurs de texte}.
109 @warning{Le premier démarrage de LilyPond peut prendre une minute ou
110 deux, afin de générer la liste des polices du système. LilyPond démarre
111 en principe plus rapidement lors des exécutions suivantes.}
114 @subsubheading MacOS X
116 Si vous double-cliquez sur @code{LilyPond.app}, un fichier d'exemple
117 s'ouvrira. Sauvegardez-le, par exemple, sous @code{test.ly} sur votre
118 bureau, puis traitez-le avec la commande de menu
119 @w{@code{Compile > Typeset File}}. Le fichier PDF résultant sera alors
122 À l'avenir, vous aurez certainement recours aux commandes @qq{Nouveau}
123 ou @qq{Ouvrir}. Vous devez enregistrer votre fichier avant de lancer
124 la gravure de la partition par LilyPond. Si une erreur apparaît
125 pendant le traitement, vous la trouverez dans la fenêtre @qq{log}.
127 @subsubheading Windows
129 Sous Windows, double-cliquez sur l'icône LilyPond qui se trouve sur le
130 bureau, un fichier d'exemple s'ouvre dans un simple éditeur de texte.
131 Enregistrez-le, par exemple en tant que @code{test.ly} sur le bureau,
132 puis double-cliquez sur son icône (qui montre une note de musique)
133 pour le traiter. Après quelques secondes, vous obtiendrez un fichier
134 @code{test.pdf} sur le bureau, fichier que vous pourrez ouvrir pour
135 voir la partition gravée. Une autre méthode pour lancer le traitement
136 du fichier @code{test.ly} est de le glisser avec votre souris sur
139 Pour modifier un fichier @code{.ly} existant, faites un clic droit
140 dessus et sélectionnez @qq{Éditer la source}. Pour partir d'un
141 fichier vide, lancez l'éditeur en ouvrant un fichier existant et
142 utilisez la commande @qq{New} du menu @qq{File}.
144 En double-cliquant sur le fichier, vous obtiendrez, en plus du fichier
145 PDF, un fichier @code{.log} qui récapitule les opérations que LilyPond
146 a effectuées sur votre fichier. Si une erreur survient, vous en
147 trouverez les détails dans ce fichier.
151 Créez un fichier texte @code{test.ly} qui contient
160 Pour traiter @code{test.ly}, entrez la commande suivante dans un
168 Vous verrez quelque chose ressemblant à
172 GNU LilyPond @version{}
173 Traitement de « test.ly »
175 Interprétation en cours de la musique...
176 Pré-traitement des éléments graphiques...
177 Détermination du nombre optimal de pages...
178 Répartition de la musique sur une page...
179 Dessin des systèmes...
180 Sortie mise en page vers « test.ps »...
181 Conversion à « ./test.pdf »...
186 Suivant votre installation, ces messages peuvent être traduits ou
191 @node Notation simple
192 @section Notation simple
193 @translationof Simple notation
195 @cindex simple, notation
196 @cindex notation simple
198 Il y a certains éléments graphiques de notation que LilyPond ajoute
199 automatiquement. Dans l'exemple suivant, nous n'avons fourni que
200 quatre hauteurs, mais LilyPond a ajouté une clef, un chiffre de mesure
203 @lilypond[verbatim,quote]
210 Ces valeurs automatiques simplifient la saisie du code source dans
211 bien des cas ; nous verrons plus loin comment les indiquer
221 @cindex altérations et mode relatif
222 @cindex mode relatif et altérations
229 Glossaire musical : @rglos{pitch}, @rglos{interval},
230 @rglos{scale}, @rglos{middle C}, @rglos{octave},
233 Le moyen le plus simple d'entrer des notes est d'utiliser le mode
234 d'octaves relatives, ou mode @code{\relative}. Dans ce mode, l'octave
235 de chaque note est sélectionnée automatiquement de façon à ce qu'elle
236 soit le plus proche possible de la note précédente, c'est-à-dire de
237 façon à ce que l'intervalle avec la note précédente soit au plus d'une
238 quarte. Commençons par saisir une partition très simple, à savoir une
241 @lilypond[verbatim,quote]
242 % set the starting point to middle C
249 La note de départ est le @notation{do central}. Chacune des notes qui
250 suivent est placée à l'octave la plus proche de la note précédente --
251 en d'autres termes, le premier @code{c} est le do central, entre la
252 clef de sol et la clef de fa, puis est suivi par le @notation{ré} le
253 plus proche, et ainsi de suite. On peut bien sûr créer des mélodies
254 avec de plus grands intervalles, toujours avec le mode @code{\relative} :
256 @lilypond[verbatim,quote]
264 Remarquez que cet exemple ne commence plus sur le @notation{do central}
265 : la première note -- le @code{d} -- est le ré qui en est le plus proche.
267 Dans l'exemple suivant, on remplace @code{c'} dans la commande
268 @w{@code{\relative c' @{}} par @code{c''}, afin de calculer l'octave de
269 la première note par rapport au do situé une octave au-dessus du do
272 @lilypond[verbatim,quote]
273 % one octave above middle C
279 Le mode d'octaves relatives peut être déroutant au début, mais c'est
280 souvent la façon la plus économique de saisir les hauteurs en
281 utilisant le clavier de l'ordinateur de façon classique. Détaillons
282 dans un exemple le calcul des octaves relatives. En partant d'un si
283 sur la troisième ligne de la clé de sol, un do, un ré ou un mi sans
284 indication d'octave particulière seront placés juste au-dessus du si,
285 c'est-à-dire au plus à une quarte ascendante du si, alors qu'un la, un
286 sol ou un fa seront placés juste en-dessous du si, c'est-à-dire au
287 plus à une quarte descendante du si.
289 @lilypond[verbatim,quote]
291 b c % c is 1 staff space up, so is the c above
292 b d % d is 2 up or 5 down, so is the d above
293 b e % e is 3 up or 4 down, so is the e above
294 b a % a is 6 up or 1 down, so is the a below
295 b g % g is 5 up or 2 down, so is the g below
296 b f % f is 4 up or 3 down, so is the f below
300 Notez que le calcul des octaves relatives @strong{ne tient pas compte
301 des altérations} des notes, dièse bémol ou bécarre.
303 Pour obtenir des intervalles supérieurs à une quarte, on peut ajouter
304 des apostrophes @code{'} -- qui font chacune monter la hauteur d'une
305 octave -- ou des virgules @code{,} -- qui font chacune descendre la
306 hauteur d'une octave -- au nom de la note.
308 @lilypond[verbatim,quote]
316 Pour déplacer une note deux octaves (ou davantage !) plus haut ou plus
317 bas, il suffit de mettre deux (ou davantage) @code{'} ou @code{,} --
318 attention cependant à bien mettre deux apostrophes @code{''}, et non
319 un guillemet @code{"}@tie{}! C'est de cette même manière que l'on
320 peut modifier la valeur de départ de @w{@code{\relative c'}}.
323 @subheading Durées et rythme
332 @cindex spécification des durées
334 Glossaire musical : @rglos{beam}, @rglos{duration},
335 @rglos{whole note}, @rglos{half note}, @rglos{quarter note},
338 La @notation{durée} d'une note est indiquée par un nombre qui suit sa
339 hauteur : @code{1} pour une @notation{ronde}, @code{2} pour une
340 @notation{blanche}, @code{4} pour une @notation{noire} et ainsi de
341 suite. Les @notation{crochets} et @notation{liens} sont ajoutés
344 Si aucune durée n'est indiquée pour une note, la dernière durée entrée
345 est utilisée. En l'absence d'indication de durée, la première note
348 @lilypond[verbatim,quote]
352 a16 a a a a32 a a a a64 a a a a a a a a2
356 Une @notation{note pointée} s'obtient en ajoutant un point @code{.} à
357 la valeur rythmique. Le point doit être précédé d'un nombre spécifiant
360 @lilypond[verbatim,quote]
371 @cindex notation des silences
373 Glossaire musical : @rglos{rest}.
375 On saisit un @notation{silence} tout comme une note, mais avec la
376 lettre @code{r} (pour @emph{rest}).
378 @lilypond[verbatim,quote]
389 @cindex chiffre de mesure
394 Glossaire musical : @rglos{time signature}.
396 La @notation{métrique}, aussi appelée @notation{chiffre de mesure},
397 peut être définie à l'aide de la commande @code{\time} :
399 @lilypond[verbatim,quote]
422 Glossaire musical : @rglos{clef}.
424 La @notation{clef} peut être définie à l'aide de la commande
427 @lilypond[verbatim,quote]
441 @subheading Tout ensemble
443 Voici un bref exemple qui rassemble tous les éléments que nous déjà
446 @lilypond[verbatim,quote]
457 Manuel de notation : @ruser{Écriture des hauteurs de note},
458 @ruser{Écriture du rythme}, @ruser{Écriture des silences},
459 @ruser{Métrique}, @ruser{Clefs}.
462 @node Travail sur les fichiers d'entrée
463 @section Travail sur les fichiers d'entrée
464 @translationof Working on input files
466 Le traitement des fichiers source de LilyPond est semblable à celui du
467 code de nombreux langages de programmation. La casse est prise
468 en compte, et les caractères considérés comme espaces ont généralement
469 peu d'importance. Les expressions sont délimitées par des accolades @{
470 @}, et les commentaires par @code{%} ou @w{@code{%@{ dots{} @}}}.
472 Si cette phrase vous paraît incompréhensible, ne vous en faites pas !
473 Expliquons tous ces termes :
475 @cindex casse, prise en compte de
476 @cindex prise en compte de la casse
477 @cindex sensibilité à la casse
482 LilyPond est sensible à la casse, c'est à dire qu'une lettre capitale
483 n'a pas la même valeur qu'une lettre minuscule. Les notes, par
484 exemple, doivent être entrées en minuscule : @w{@code{@{ c d e @}}} est
485 un code valide, alors que @w{@code{@{ C D E @}}} produira un message
488 @cindex espaces multiples, insensibilité
489 @cindex insensibilité aux espaces multiples
491 @item @strong{Les espaces multiples} :
492 LilyPond ne tient pas compte du nombre d'espaces, ou de retours à la
493 ligne. @code{@{ c d e @}} a le
494 même sens que @code{@{ c @tie{} @tie{} d @tie{} e @}} ou que
502 Bien sûr, ce dernier exemple est illisible. Une bonne habitude
503 à prendre est d'indenter les blocs de code avec soit des tabulations
504 soit des doubles espaces :
516 @item @strong{Expressions musicales} :
517 Tout morceau saisi dans LilyPond doit être placé entre @strong{@{
518 accolades @}}. Ces caractères indiquent à LilyPond que ce bloc de
519 texte représente une et une seule expression musicale, tout comme les
520 parenthèses @code{()} en mathématiques. Pour éviter toute ambiguïté,
521 il est préférable d'entourer ces accolades d'espaces ou de retours à
524 Un appel de fonction -- @w{@code{\relative @{ @}}} par exemple --
525 compte également comme une seule expression musicale.
528 @cindex commentaire de fin de ligne
529 @cindex commentaire-bloc
530 @cindex bloc de commentaire
533 @funindex %@{ ... %@}
535 @item @strong{Les commentaires} :
536 Un commentaire est une indication pour tout lecteur humain d'un
537 fichier source de musique ; il est ignoré par l'ordinateur, et n'a
538 donc aucun effet sur la partition imprimée. On distingue deux types
539 de commentaires. Le commentaire de fin de ligne, introduit par le
540 symbole @code{%} : tout ce qui suit ce symbole sur la même ligne sera
541 ignoré. Par convention, un commentaire qui occupe une ligne entière
542 se place juste @emph{au-dessus} de la ligne à laquelle il fait
547 % ce commentaire fait référence aux si
551 Le bloc de commentaire, qui peut occuper plusieurs lignes, voire toute
552 une section : tout ce qui se trouve entre @code{%@{} et @code{%@}} est
553 ignoré. Les blocs de commentaires ne peuvent s'imbriquer, ce qui
554 signifie que vous ne pouvez pas placer un commentaire-bloc à
555 l'intérieur d'un autre commentaire-bloc. Si jamais vous essayez, vous
556 verrez que la première occurence de @code{%@}} terminera @qq{les
557 @emph{deux} commentaires-blocs}. Le fragment suivant met en évidence
558 quelques usages possibles des commentaires :
561 % voici les notes de "ah vous dirai-je maman"
565 Ces lignes et les notes qui suivent
566 seront ignorées, car elles se trouvent
567 dans un bloc de commentaire.
577 @node Bien lire le manuel
578 @section Bien lire le manuel
579 @translationof How to read the manual
581 @cindex bien lire le manuel
582 @cindex manuel, lecture
583 @cindex compulser le manuel
584 @cindex exemples cliquables
585 @cindex cliquables, exemples
586 @cindex conseils de construction des fichiers
588 @cindex construction des fichiers, conseils
589 @cindex fichiers, conseils de construction
591 Comme nous l'avons vu dans @ref{Travail sur les fichiers d'entrée}, un code
592 LilyPond doit être encadré par des accolades @{ @} ou bien par
593 @code{@w{\relative c'' @{ @dots{} @}}}. Cependant, dans la suite de ce
594 manuel, la plupart des exemples ne feront pas apparaître ces signes.
596 Pour reproduire les exemples, vous pouvez copier et coller le code
597 affiché, mais @strong{à condition} d'ajouter
598 @code{@w{\relative c'' @{ @}}} de la façon suivante :
602 ...collez ici votre exemple...
606 Pourquoi avoir omis les accolades ? La plupart des exemples de ce
607 manuel peuvent être insérés au milieu d'un morceau de musique plus
608 long. Il n'y a donc aucune raison d'ajouter @code{@w{\relative c'' @{
609 @}}} à ces exemples -- en effet, il n'est pas possible d'insérer une
610 expression @code{\relative} à l'intérieur d'une autre expression
611 @code{\relative}. Si nous mettions tous nos exemples dans une
612 expression @code{\relative}, vous ne pourriez plus copier un bref
613 exemple de la documentation pour le coller dans vos pièces.
616 @subheading Exemples cliquables
618 Beaucoup de gens apprennent à utiliser les programmes en les essayant
619 et en bidouillant avec. C'est également possible avec LilyPond. Si
620 vous cliquez sur une image dans la version HTML de ce manuel, vous
621 verrez exactement le code LilyPond utilisé pour générer cette image.
622 Essayez sur cette image :
626 @lilypond[quote,ragged-right]
628 c-\markup { \bold \huge { Cliquez ici. } }
632 En copiant-collant le code à partir du commentaire @qq{ly snippet}
633 vers un fichier test, vous aurez un modèle de base pour faire vos
634 expériences. Pour obtenir une gravure à l'identique, copiez tout le
635 code à partir de @qq{Start cut-&-pastable section}.
637 @c No longer in the text in English, but should we really
640 Si vous apprenez de cette façon, vous aurez probablement envie
641 d'imprimer ou de garder un lien vers @ruser{Aide-mémoire}, tableau
642 qui répertorie les commandes usuelles pour une consultation rapide.
647 Vous trouverez plus de conseils pour construire des fichiers source
648 dans @ref{Suggestions pour la saisie de fichiers LilyPond}. Cependant,
649 lors d'une première lecture il est préférable de terminer d'abord la