1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
2 @c This file is part of lilypond.tely
4 Translation of GIT committish: 0b3b41414fa52672d7d9416c265cd8d0568eef13
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. See TRANSLATION for details.
13 Tutorial guidelines: (different from policy.txt!)
14 - unless you have a really good reason, use either
15 @lilypond[verbatim,quote]
17 @lilypond[verbatim,quote,relative=2]
19 Don't use any other relative=X commands.
21 - use "aes" and "ees" instead of "as" and "es". I know it's not
22 correct Dutch naming, but let's not confuse people with this
23 until we get to the Basic notation chapter.
25 - Add "Music Glossary: @rglos{foo}" to the *top* of the relevant
26 portions of the tutorial.
31 @c Translators: Nicolas Grandclaude, Ludovic Sardain, Gauvain Pocentek
32 @c Translation checkers: Jean-Charles Malahieude, Valentin Villenave, John Mandereau
33 @c Translation status: post-GDP
38 Ce tutoriel commence par une introduction au langage musical utilisé
39 par LilyPond, qui vous permettra de faire fonctionner le logiciel pour
40 produire une partition. Après ce premier contact, nous verrons comment
41 créer des partitions utilisant une notation musicale courante.
45 * Single staff notation::
46 * Multiple notes at once::
55 Cette section présente les aspects élémentaires de l'utilisation de
61 * Working on text files::
62 * How to read the manual::
66 @node Compiling a file
67 @subsection Compiling a file
71 Pour créer une partition avec LilyPond, on écrit un fichier texte,
72 appelé fichier source, qui décrit la notation musicale. La
73 @emph{compilation} de ce fichier source par LilyPond produit un
74 fichier graphique imprimable, et si on le désire un fichier MIDI qui
75 peut être joué par un séquenceur. Voici un premier exemple simple de
76 fichier source LilyPond.
85 Le compilation de cette partition donnera quelque chose de sembable à
88 @c in this case we don't want verbatim
89 @lilypond[quote,ragged-right]
96 Il est aussi possible d'utiliser les noms de notes français @samp{do
97 re mi fa sol la si}, en insérant au début du fichier la ligne
98 @samp{\include "italiano.ly"}.
101 @warning{Tout extrait de code LilyPond doit être entouré d'une
102 @strong{@{ paire d'accolades @}}. De plus, pour éviter toute
103 ambiguïté, il est préférable d'entourer les accolades par des espaces
104 ou retours à la ligne. Bien que certains exemples de ce manuel ne
105 comportent pas d'accolades, ne les oubliez pas dans vos partitions !
106 Pour plus d'informations sur l'affichage des exemples de cette
107 documentation, consultez @ref{How to read the manual}.}
110 @cindex casse, prise en compte de
111 @cindex prise en compte de la casse
112 @cindex sensibilité à la casse
113 De plus, LilyPond est @strong{sensible à la casse} : le code
114 @w{@code{@{ c d e @}}} est valide, alors que @w{@code{@{ C D E @}}}
115 produira un message d'erreur.
119 @subheading Entering music and viewing output
123 @cindex partition, lire
124 @cindex lire la partition
126 Dans cette section nous expliquerons quelles commandes exécuter et
127 comment voir ou imprimer le résultat produit par LilyPond.
129 Notez qu'il existe plusieurs éditeurs de texte disponibles avec un bon
130 support de LilyPond ; consultez @rprogram{Text editor support}.
132 @warning{Le premier démarrage de LilyPond peut prendre une minute ou
133 deux, afin de faire la liste des polices du système. LilyPond démarre
134 en principe plus rapidement lors des exécutions suivantes.}
137 @subsubheading MacOS X
139 Si vous double-cliquez sur @code{LilyPond.app}, un fichier d'exemple
140 s'ouvrira. Sauvegardez-le, par exemple, sous @file{test.ly} sur votre
141 bureau, puis traitez-le avec la commande de menu @samp{Compile >
142 Typeset File}. Le fichier PDF résultant sera alors affiché à l'écran.
144 À l'avenir, vous aurez certainement recours aux commandes @qq{Nouveau}
145 ou @qq{Ouvrir}. Vous devez enregistrer votre fichier avant de lancer
146 la gravure de la partition par LilyPond. Si une erreur apparaît
147 pendant le traitement, vous la trouverez dans la fenêtre @qq{log}.
149 @subsubheading Windows
151 Sous Windows, double-cliquez sur l'icône LilyPond qui se trouve sur le
152 bureau, un fichier d'exemple s'ouvre dans un simple éditeur de texte.
153 Enregistrez-le, par exemple en tant que @file{test.ly} sur le bureau,
154 puis double-cliquez sur son icône (qui montre une note de musique)
155 pour le traiter. Après quelques secondes, vous obtiendrez un fichier
156 @file{test.pdf} sur le bureau, fichier que vous pourrez ouvrir pour
157 voir la partition gravée. Une autre méthode pour lancer le traitement
158 du fichier @file{test.ly} est de le glisser avec votre souris sur
161 Pour modifier un fichier @file{.ly} existant, faites un clic droit
162 dessus et sélectionnez @qq{Éditer la source}. Pour partir d'un
163 fichier vide, lancez l'éditeur en ouvrant un fichier existant et
164 utilisez la commande @qq{New} du menu @qq{File}.
166 En double-cliquant sur le fichier, vous obtiendrez, en plus du fichier
167 PDF, un fichier @file{.log} qui récapitule les opérations que LilyPond
168 a effectuées sur votre fichier. Si une erreur survient, vous en
169 trouverez les détails dans ce fichier.
173 Créez un fichier texte @file{test.ly} qui contient
182 Pour traiter @file{test.ly}, entrez la commande suivante dans un
190 Vous verrez quelque chose ressemblant à
194 GNU LilyPond @version{}
195 Traitement de « test.ly »
197 Interprétation en cours de la musique...
198 Pré-traitement des éléments graphiques...
199 Détermination du nombre optimal de pages...
200 Répartition de la musique sur une page...
201 Dessin des systèmes...
202 Sortie mise en page vers « test.ps »...
203 Conversion à « ./test.pdf »...
208 Suivant votre installation, ces messages peuvent être traduits ou
213 @node Simple notation
214 @subsection Simple notation
216 Il y a certains éléments graphiques de notation que LilyPond ajoute
217 automatiquement. Dans l'exemple suivant, nous n'avons fourni que
218 quatre hauteurs, mais LilyPond a ajouté une clé, un chiffre de mesure
221 @lilypond[quote,ragged-right,verbatim]
228 Ces valeurs automatiques simplifient la saisie du code source dans
229 bien des cas ; nous verrons plus loin comment les indiquer
235 Glossaire musical : @rglos{pitch}, @rglos{interval},
236 @rglos{scale}, @rglos{middle C}, @rglos{octave},
239 Le moyen le plus simple d'entrer des notes est d'utiliser le mode
240 d'octaves relatives, ou mode @code{\relative}. Dans ce mode, l'octave
241 de chaque note est sélectionnée automatiquement de façon à ce qu'elle
242 soit la plus proche possible de la note précédente, c'est-à-dire de
243 façon à ce que l'intervalle avec la note précédente soit au plus d'une
244 quarte. Commençons par saisir une partition très simple, à savoir une
247 @lilypond[quote,ragged-right,verbatim]
248 \relative c' { % set the starting point to middle C
254 La note de départ est le @notation{do central}. Chacune des notes qui
255 suivent est placée à l'octave la plus proche de la note précédente ---
256 en d'autres termes, le premier @samp{c} est le do central, entre la
257 clé de sol et la clé de fa, puis est suivi par le ré le plus proche,
258 et ainsi de suite. On peut bien sûr créer des mélodies avec de plus
259 grands intervalles, toujours avec le mode @code{\relative} :
261 @lilypond[quote,ragged-right,verbatim]
269 Remarquez que cet exemple ne commence plus sur le do central : la
270 première note --- le @samp{d} --- est le ré qui en est le plus proche.
272 Dans l'exemple suivant, on remplace @code{c'} dans la commande
273 @w{@code{\relative c'}} par @code{c''}, afin de calculer l'octave de
274 la première note par rapport au do situé une octave au-dessus du do
277 @lilypond[verbatim,quote,ragged-right]
278 \relative c'' { % one octave above middle C
283 Le mode d'octaves relatives peut être déroutant au début, mais c'est
284 souvent la façon la plus économique de saisir les hauteurs en
285 utilisant le clavier de l'ordinateur de façon classique. Détaillons
286 sur un exemple le calcul des octaves relatives. En partant d'un si
287 sur la troisième ligne de la clé de sol, un do, un ré ou un mi sans
288 indication d'octave particulière seront placés juste au-dessus du si,
289 c'est-à-dire au plus à une quarte ascendante du si, alors qu'un la, un
290 sol ou un fa seront placés juste en-dessous du si, c'est-à-dire au
291 plus à une quarte descendante du si.
293 @lilypond[verbatim,quote,ragged-right]
295 b c % c is 1 staff space up, so is the c above
296 b d % d is 2 up or 5 down, so is the d above
297 b e % e is 3 up or 4 down, so is the e above
298 b a % a is 6 up or 1 down, so is the a below
299 b g % g is 5 up or 2 down, so is the g below
300 b f % f is 4 up or 3 down, so is the f below
304 Notez que le calcul des octaves relatives @strong{ne dépend pas des
305 altérations} des notes, dièses bémols ou bécarre.
307 Pour obtenir des intervalles supérieurs à une quarte, on peut ajouter
308 des apostrophes @code{'} --- qui font chacune monter la hauteur d'une
309 octave --- ou des virgules @code{,} --- qui font chacune descendre la
310 hauteur d'une octave --- au nom de la note.
312 @lilypond[quote,ragged-right,verbatim]
320 Pour déplacer une note deux octaves (ou davantage !) plus haut ou plus
321 bas, il suffit de mettre deux (ou davantage) de @code{'} ou ou @code{,} ---
322 attention cependant à bien mettre deux apostrophes @code{''}, et non
323 un guillemet @code{"}@tie{}! C'est de cette même manière que l'on
324 peut modifier la valeur de départ de @code{\relative c'}.
327 @subheading Durées et rythme
329 Glossaire musical : @rglos{beam}, @rglos{duration},
330 @rglos{whole note}, @rglos{half note}, @rglos{quarter note},
333 La @notation{durée} d'une note est indiquée par un nombre qui suit sa
334 hauteur : @samp{1} pour une @notation{ronde}, @samp{2} pour une
335 @notation{blanche}, @samp{4} pour une @notation{noire} et ainsi de
336 suite. Les @notation{crochets} et @notation{liens} sont ajoutées
339 Si aucune durée n'est indiquée pour une note, la dernière durée entrée
340 est utilisée. En l'absence d'indication de durée, la première note
343 @lilypond[verbatim,quote,ragged-right]
347 a16 a a a a32 a a a a64 a a a a a a a a2
351 Une @notation{note pointée} s'obtient en ajoutant un point @code{.} à
352 la valeur rythmique. Le point doit être précédé d'un nombre de durée.
354 @lilypond[verbatim,quote,ragged-right]
364 Glossaire musical : @rglos{rest}.
366 On saisit un @notation{silence} tout comme une note, mais avec la
369 @lilypond[verbatim,quote,ragged-right]
379 Glossaire musical : @rglos{time signature}.
381 La @notation{métrique}, aussi appelée @notation{chiffre de mesure},
382 peut être définie à l'aide de la commande @code{\time} :
384 @lilypond[verbatim,quote,ragged-right]
398 Glossaire musical : @rglos{clef}.
400 La @notation{clef} peut être définie à l'aide de la commande
403 @lilypond[verbatim,quote,ragged-right]
417 @subheading Tout ensemble
419 Voici un bref exemple qui rassemble tous les éléments que nous déjà
422 @lilypond[verbatim,quote,ragged-right]
433 Manuel de notation : @ruser{Writing pitches},
434 @ruser{Writing rhythms}, @ruser{Writing rests},
435 @ruser{Time signature}, @ruser{Clef}.
438 @node Working on text files
439 @subsection Working on text files
441 Le traitement des fichiers source de LilyPond est semblable à celui du
442 code de nombreux langages de programmation. La casse est prise
443 en compte, et les caractères considérés comme espaces ont généralement
444 peu d'importance. Les expressions sont délimitées par des accolades @{
445 @}, et les commentaires par @code{%} ou @code{%@{ ... %@}}.
447 Si cette phrase vous paraît incompréhensible, ne vous en faites pas !
448 Expliquons tous ces termes :
452 @cindex casse, prise en compte de
453 @cindex prise en compte de la casse
454 @cindex sensibilité à la casse
455 @item @strong{La casse} :
456 LilyPond est sensible à la casse, c'est à dire qu'une lettre capitale
457 n'a pas la même valeur qu'une lettre minuscule. Les notes, par
458 exemple, doivent être entrées en minuscules : @code{@{ c d e @}} est
459 un code valide, alors que @code{@{ C D E @}} produira un message
462 @item @strong{Les espaces multiples} :
463 LilyPond ne tient pas compte du nombre d'espaces, ou de retours à la
464 ligne. @code{@{ c d e @}} a le
465 même sens que @code{@{ c @tie{} @tie{} d @tie{} e @}} ou que
473 Bien sûr, ce dernier exemple est illisible. Une bonne habitude
474 à prendre est d'indenter les blocs de code avec soit des tabulations
475 soit des doubles espaces :
483 @item @strong{Expressions musicales} :
484 Tout morceau saisi dans LilyPond doit être placé entre @strong{@{
485 accolades @}}. Ces caractères indiquent à LilyPond que ce bloc de
486 texte représente une et une seule expression musicale, tout comme les
487 parenthèses @samp{()} en mathématiques. Pour éviter toute ambiguïté,
488 il est préférable d'entourer ces accolades d'espaces ou de retours à
491 Un appel de fonction --- @w{@code{\relative @{ @}}} par exemple ---
492 compte également comme une seule expression musicale.
495 @cindex commentaire de fin de ligne
496 @cindex commentaire-bloc
497 @cindex bloc de commentaire
498 @item @strong{Les commentaires} :
499 un commentaire est une indication pour tout lecteur humain d'un
500 fichier source de musique ; il est ignoré par l'ordinateur, et n'a
501 donc aucun effet sur la partition imprimée. On distingue deux types
502 de commentaires. Le commentaire de fin de ligne, introduit par le
503 symbole @samp{%} : tout ce qui suit ce symbole sur la même ligne sera
504 ignoré. Par convention, un commentaire qui occupe une ligne entière
505 se place juste @emph{au-dessus} de la ligne à laquelle il fait
510 % ce commentaire fait référence aux sis
514 Le bloc de commentaire, qui peut occuper plusieurs lignes voire toute
515 une section : tout ce qui se trouve entre @code{%@{} et @code{%@}} est
516 ignoré. Les blocs de commentaires ne peuvent s'imbriquer, ce qui
517 signifie que vous ne pouvez pas placer un commentaire-bloc à
518 l'intérieur d'un autre commentaire-bloc. Si jamais vous essayez, vous
519 verrez que la première occurence de @code{%@}} terminera @qq{les
520 @emph{deux} commentaires-blocs}. Le fragment suivant met en évidence
521 quelques usages possibles des commentaires :
524 % voici les notes de "ah vous dirai-je maman"
528 Ces lignes et les notes qui suivent
529 seront ignorées, car elles se trouvent
530 dans un bloc de commentaire.
540 @node How to read the manual
541 @subsection How to read the manual
543 Comme nous l'avons vu dans @ref{Working on text files}, un code
544 LilyPond doit être encadré par des accolades @{ @} ou bien par
545 @code{\relative c'' @{ ... @}}. Cependant, dans la suite de ce
546 manuel, la plupart des exemples ne feront pas apparaître ces signes.
548 Pour reproduire les exemples, vous pouvez copier et coller le code
549 affiché, mais @strong{à condition} d'ajouter @code{\relative c'' @{
550 @}} de la façon suivante :
554 ...collez ici votre exemple...
558 Pourquoi avoir omis les accolades ? La plupart des exemples de ce
559 manuel peuvent être insérés au milieu d'un morceau de musique plus
560 long. Il n'y a donc aucune raison d'ajouter @code{\relative c'' @{
561 @}} à ces exemples --- en effet, il n'est pas possible d'insérer une
562 expression @code{\relative} à l'intérieur d'un autre expression
563 @code{\relative}. Si nous mettions tous nos exemples dans une
564 expression @code{\relative}, vous ne pourriez plus copier un bref
565 exemple de la documentation pour le coller dans vos pièces.
568 @subheading Exemples cliquables
570 Beaucoup de gens apprennent à utiliser les programmes en les essayant
571 et en bidouillant avec. C'est également possible avec LilyPond. Si
572 vous cliquez sur une image dans la version HTML de ce manuel, vous
573 verrez exactement le code LilyPond utilisé pour générer cette image.
574 Essayez sur cette image :
578 @lilypond[quote,ragged-right]
580 c-\markup { \bold \huge { Cliquez ici. } }
584 En copiant-collant le code à partir du commentaire @qq{ly snippet}
585 vers un fichier test, vous aurez un modèle de base pour faire vos
586 expériences. Pour obtenir une gravure à l'identique, copiez tout le
587 code à partir de @qq{Start cut-&-pastable section}.
589 @c No longer in the text in English, but should we really
592 Si vous apprenez de cette façon, vous aurez probablement envie
593 d'imprimer ou de garder un lien vers @ruser{Cheat sheet}, tableau
594 qui répertorie les commandes usuelles pour une consultation rapide.
599 Vous trouverez plus de conseils pour construire des fichiers source
600 dans @ref{Suggestions for writing LilyPond input files}. Cependant,
601 lors d'une première lecture il est préférable de terminer d'abord la
605 @node Single staff notation
606 @section Single staff notation
608 Cette section présente la notation courante dont on a besoin pour
609 écrire une voix sur une portée.
612 * Accidentals and key signatures::
614 * Articulation and dynamics::
616 * Automatic and manual beams::
617 * Advanced rhythmic commands::
621 @node Accidentals and key signatures
622 @subsection Accidentals and key signatures
624 @subheading Accidentals
626 Glossaire musical : @rglos{sharp}, @rglos{flat}, @rglos{double sharp},
627 @rglos{double flat}, @rglos{accidental}.
629 Dans la notation par défaut, on obtient un @notation{dièse} en
630 ajoutant @code{is} au nom de la note, et un @notation{bémol} en
631 ajoutant @code{es}. Comme vous pouvez vous y attendre, un double
632 dièse ou double bémol s'obtiennent en ajoutant @code{isis} ou
633 @code{eses}. Cette syntaxe est dérivée de la convention de
634 dénomination des notes dans les langues nordiques et germaniques,
635 comme l'allemand ou le hollandais.
638 Cependant, si vous utilisez la commande @code{\include "italiano.ly"}
639 pour entrer les noms de notes français au lieu des noms hollandais, il
640 faudra ajouter un @code{d} pour obtenir un dièse, et un @code{b} pour
641 un bémol. Le double dièse et le double bémol s'obtiennent en ajoutant
642 respectivement @code{dd} et @code{bb}. Pour en savoir plus sur les
643 autres langues disponibles, consultez @ruser{Note names in other
647 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
648 cis1 ees fisis, aeses
651 @cindex armure, définition de l'
652 @cindex armure, altérations à l'
653 @cindex altérations à l'armure
654 @subheading Key signatures
656 L'armure est déterminée par la commande @code{\key}, suivie d'une
657 hauteur puis de @code{\major} (majeur) ou @code{\minor} (mineur).
659 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
668 @subheading Warning: key signatures and pitches
670 Glossaire musical : @rglos{accidental}, @rglos{key signature},
671 @rglos{pitch}, @rglos{flat}, @rglos{natural}, @rglos{sharp},
672 @rglos{transposition}.
674 La combinaison de l'@notation{armure} et des hauteurs de note --- y
675 compris les altérations --- permet à LilyPond de déterminer dans quel
676 cas imprimer des @notation{altérations accidentelles}. L'armure
677 n'affecte que les altérations @emph{imprimées}, et non les hauteurs
678 réelles ! Cette fonctionnalité est souvent source de confusion pour
679 les nouveaux utilisateurs, aussi expliquons-la en détail.
681 LilyPond fait une distinction nette entre le contenu musical et la
682 mise en forme. L'altération d'une note --- @notation{bémol},
683 @notation{bécarre} ou @notation{dièse} --- fait partie de sa hauteur,
684 et relève donc du contenu musical. La gravure ou non d'une altération
685 accidentelle --- un @emph{signe} bémol, bécarre ou dièse --- devant la
686 note correspondante est une question qui relève de la mise en forme.
687 La gravure une partition suit des règles, en particulier des règles
688 d'indication des altérations accidentelles. Les hauteurs de note, en
689 revanche, relèvent de ce que vous voulez entendre ; et, dans la mesure
690 où la musique que vous entrez est censée être celle que vous voulez
691 entendre, LilyPond, qui n'est chargé que de la gravure, ne les
692 choisira pas à votre place.
696 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
702 aucune note n'a d'altération accidentelle, et pourtant vous devrez
703 entrer le @code{is} pour les notes @code{cis} et @code{fis}.
705 Le code @code{e} ne veut pas dire @qq{Imprimez-moi un point noir sur
706 la première ligne de la portée.} Cela signifie plutôt : @qq{Ici se
707 trouve une note dont la hauteur est un mi naturel.} Avec une armure
708 de la bémol majeur, ce mi est flanqué d'un bécarre accidentel :
710 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
715 Ajouter explicitement toutes les altérations demande un peu plus
716 d'effort dans la phase de saisie, mais cela facilite grandement la
717 @notation{transposition}. De plus, les altérations accidentelles
718 peuvent ainsi être imprimées suivant plusieurs conventions. Pour
719 connaître les différentes manières dont les altérations accidentelles
720 peuvent être imprimées, consultez @ruser{Automatic accidentals}.
724 Manuel de notation : @ruser{Note names in other languages},
725 @ruser{Accidentals}, @ruser{Automatic accidentals},
726 @ruser{Key signature}.
728 Glossaire musical : @rglos{Pitch names}.
731 @subsection Ties and slurs
733 @cindex liaisons de prolongation
734 @cindex liaisons de tenue
735 @cindex prolongation, liaisons de
736 @cindex durée, liaisons de
737 @cindex tenue, liaisons de
740 Glossaire musical : @rglos{tie}.
742 Pour créer une liaison de prolongation@footnote{parfois aussi appelée
743 liaison de tenue}, on ajoute un tilde @code{~} à la première note
746 @lilypond[verbatim,quote,relative=2]
751 @cindex liaisons d'articulation
752 @cindex articulation, liaisons d'
755 @c Le terme de "slur" a deux sens en français : articulation et phrasé.
756 @c Je garde ici le terme "legato", tel qu'il apparaît dans le texte original,
757 @c car c'est celui qui me semble le plus couramment employé.
759 Glossaire musical : @rglos{slur}.
761 Une liaison d'articulation ou @emph{legato} peut englober
762 plusieurs notes. Les notes de départ et d'arrivée sont suivies
763 respectivement d'un signe @samp{(} et @samp{)}.
765 @lilypond[verbatim,quote,relative=2]
766 d4( c16) cis( d e c cis d) e( d4)
769 @cindex liaisons de phrasé
770 @cindex phrasé, liaisons de
772 @subheading Phrasing slurs
774 De plus longues liaisons, dites de phrasé, sont délimitées par @code{\(} et
775 @code{\)}. Il est possible d'avoir en même temps des legatos et des
776 phrasés, mais pas plusieurs liaisons de phrasé ou de legato à la fois.
778 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
779 a8(\( ais b c) cis2 b'2 a4 cis,\)
784 @cindex liaisons d'articulation et de prolongation, différences
785 @subheading Warnings: slurs vs. ties
787 Glossaire musical : @rglos{articulation}, @rglos{slur}, @rglos{tie}.
789 Une liaison d'articulation ou de phrasé ressemble à une liaison de
790 prolongation, mais n'a pas la même signification. Alors qu'une
791 liaison de prolongation ne peut relier que deux notes de même hauteur,
792 le legato indique une articulation de plusieurs notes, éventuellement
793 en grand nombre. Les liaisons de tenue peuvent être enchâssées dans
794 un legato ou un phrasé.
796 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
797 c2~( c8 fis fis4 ~ fis2 g2)
802 Manuel de notation : @ruser{Ties}, @ruser{Slurs},
803 @ruser{Phrasing slurs}.
805 @node Articulation and dynamics
806 @subsection Articulation and dynamics
811 @subheading Articulations
813 Glossaire musical : @rglos{articulation}.
815 Des @notation{articulations} peuvent être ajoutées à une note, au moyen
816 d'un tiret @code{-} suivi d'un caractère :
818 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
819 c-. c-- c-> c-^ c-+ c-_
823 @subheading Fingerings
825 Glossaire musical : @rglos{fingering}.
827 De même, des indications de doigté peuvent être ajoutées à une note en
828 utilisant un tiret (@samp{-}) et le chiffre à écrire :
830 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
834 Articulations et doigtés sont habituellement placés automatiquement,
835 mais vous pouvez indiquer une direction en utilisant @samp{^} (en
836 haut) ou @samp{_} (en bas). Vous pouvez aussi utiliser plusieurs
837 articulations sur la même note. Dans la plupart des cas, cependant,
838 il est bon de laisser LilyPond déterminer l'emplacement de
841 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
842 c_-^1 d^. f^4_2-> e^-_+
847 Glossaire musical : @rglos{dynamics}, @rglos{crescendo},
850 On obtient un signe de @notation{nuance} en ajoutant à la note les
851 lettres du signe, précédées d'un anti-slash @samp{\} :
853 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
861 @c Pluriel des termes musicaux italiens :
862 @c selon Littré, plutôt à la française (en "-os" qu'en "-i")
864 @notation{Crescendos} et @notation{decrescendos} débutent avec les
865 commandes @code{\<} et @code{\>}. Ils se terminent soit par une
866 nuance d'arrivée, par exemple @code{\f}, soit par la commande
869 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
875 Manuel de notation : @ruser{Articulations and ornamentations},
876 @ruser{Fingering instructions}, @ruser{Dynamics}.
880 @subsection Adding text
882 On peut ajouter du texte à une partition :
884 @lilypond[verbatim,quote,relative=2]
888 Pour mettre en forme du texte, on utilise la commande @code{markup} :
890 @lilypond[verbatim,quote,relative=2]
891 c1^\markup{ \bold espr}
893 \dynamic f \italic \small { 2nd } \hspace #0.1 \dynamic p
899 Manuel de notation : @ruser{Writing text}.
902 @node Automatic and manual beams
903 @subsection Automatic and manual beams
905 @cindex ligatures manuelles
907 Glossaire musical : @rglos{beam}.
909 Toutes les barres de ligature sont dessinées automatiquement :
911 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
912 a8 ais d ees r d c16 b a8
916 Lorsqu'on n'aime pas la manière dont les notes sont automatiquement
917 groupées, il est possible de les ligaturer manuellement, en marquant la
918 première note à attacher d'un crochet ouvrant @code{[} et la dernière
919 d'un crochet fermant @code{]}.
921 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
922 a8[ ais] d[ ees r d] a b
925 Pour désactiver les barres de ligature automatqiues pour des passages
926 entiers, utilisez la commande @code{\autoBeamOff}, et utilisez
927 @code{\autoBeamOn} pour les réactiver.
929 @lilypond[verbatim,quote,relative=2]
938 Manuel de notation : @ruser{Automatic beams}, @ruser{Manual beams}.
941 @node Advanced rhythmic commands
942 @subsection Advanced rhythmic commands
946 @cindex mesure incomplète
947 @subheading Partial measure
949 Glossaire musical : @rglos{anacrusis}.
951 On crée une levée (ou anacrouse) avec la commande @code{\partial},
952 suivie d'une durée : @code{\partial 4} produit une levée d'une noire
953 et @code{\partial 8} d'une croche.
955 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
964 Glossaire musical : @rglos{note value}, @rglos{triplet}.
966 Les @notation{nolets} sont créés avec la commande @code{\times}, qui
967 prend deux arguments : une fraction et une expression musicale. La
968 durée des notes de l'expression musicale est multipliée par la
969 fraction. Par exemple les notes d'un @notation{triolet} durent les
970 deux tiers de la durée de leur notation réelle, cette fraction est
971 donc de 2/3 pour les triolets :
973 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
974 \times 2/3 { f8 g a }
976 \times 2/3 { f,8 g16[ a g a] }
980 @cindex notes d'ornement
981 @cindex ornementation
984 @subheading Grace notes
986 Glossaire musical : @rglos{grace notes}, @rglos{acciaccatura},
987 @rglos{appoggiatura}.
989 Des @notation{notes d'ornement} s'obtiennent en appliquant la commande
990 @code{\grace}, @code{\appoggiatura} ou @code{\acciaccatura} à une
991 expression musicale :
993 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
994 c2 \grace { a32[ b] } c2
995 c2 \appoggiatura b16 c2
996 c2 \acciaccatura b16 c2
1001 Manuel de notation : @ruser{Grace notes}, @ruser{Tuplets},
1005 @node Multiple notes at once
1006 @section Multiple notes at once
1008 Cette section traite de situations où l'on a plus d'une note à la fois :
1009 plusieurs instruments, plusieurs voix ou portées pour un même
1010 instrument (le piano, par exemple), et les accords.
1012 En théorie musicale, la polyphonie désigne une musique constituée de
1013 plusieurs voix ; dans LilyPond, ce terme désigne les situations où il
1014 y a plus d'une voix sur une même portée.
1017 * Music expressions explained::
1020 * Combining notes into chords::
1021 * Single staff polyphony::
1025 @node Music expressions explained
1026 @subsection Music expressions explained
1028 @cindex expression musicale
1030 Dans les fichiers source LilyPond, la musique est représentée par ce
1031 qu'on appelle des @emph{expressions musicales}. En soi, une seule note
1032 peut constituer une expression musicale :
1034 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
1038 Mettre un groupe de notes entre accolades crée une nouvelle expression
1039 musicale, appelée @emph{expression musicale composée}. En voici un
1040 exemple avec deux notes :
1042 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
1046 La mise entre accolades d'une séquence d'expressions musicales --- des
1047 notes par exemple --- signifie qu'elles doivent être jouées
1048 successivement, les unes après les autres. Le résultat est une
1049 expression, qui peut elle-même être regroupée séquentiellement avec
1050 d'autres expressions. Ici, l'expression de l'exemple précédent est
1051 combinée à deux notes :
1053 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
1058 @subheading Analogy: mathematical expressions
1060 Ce mécanisme est similaire aux formules mathématiques : une grosse
1061 formule est créée en assemblant plusieurs petites formules. De telles
1062 formules sont appelées expressions, elles ont une définition
1063 récursive, de telle sorte que vous pouvez fabriquer des expressions
1064 arbitrairement longues et complexes. Par exemple :
1073 ((1 + 2) * 3) / (4 * 5)
1076 Ceci est une suite d'expressions, où chacune est contenue dans la
1077 suivante. Les expressions les plus simples sont les nombres, et de
1078 plus grandes expressions sont produites en combinant des expressions
1079 avec des opérateurs --- comme @samp{+}, @samp{*} et @samp{/} --- et
1080 des parenthèses. Tout comme les expressions mathématiques, les
1081 expressions musicales peuvent être imbriquées avec une profondeur
1082 arbitraire, ce qui est nécessaire pour des partitions complexes comme
1083 de la musique polyphonique.
1086 @subheading Simultaneous music expressions: multiple staves
1088 Glossaire musical : @rglos{polyphony}.
1090 Cette technique est utile pour de la musique @notation{polyphonique}.
1091 Pour entrer une musique avec plusieurs voix ou plusieurs portées, nous
1092 pouvons aussi combiner @emph{en parallèle} les expressions : deux voix
1093 qui doivent être jouées en même temps, sont entrées comme une
1094 combinaison simultanée de deux expressions. Une expression musicale
1095 @qq{simultanée} est formée en entourant les expressions entre @code{<<}
1096 et @code{>>}. Dans l'exemple suivant, trois expressions (contenant
1097 chacune deux notes distinctes) sont combinées simultanément.
1099 @lilypond[quote,ragged-right,verbatim]
1109 Notez que nous avons ici indenté chaque niveau du fichier d'entrée
1110 avec un nombre d'espaces différent. LilyPond se moque --- ou presque
1111 --- de l'espace qu'il peut y avoir ou non au début d'une ligne, mais
1112 un code bien indenté est bien plus lisible par des humains.
1114 @warning{la hauteur de chaque note saisie est relative à la précédente,
1115 mais pas au @code{c''} de la commande @code{\relative} de départ.}
1118 @subheading Simultaneous music expressions: single staff
1120 Pour déterminer le nombre de portées, LilyPond regarde le début
1121 de la première expression. Si c'est une seule note, une seule portée
1122 est produite ; si c'est une expression simultanée, plusieurs portées
1125 @lilypond[quote,ragged-right,verbatim]
1128 << { e f } { c <<b d>> } >>
1133 @node Multiple staves
1134 @subsection Multiple staves
1136 Comme nous l'avons vu dans @ref{Music expressions explained}, un
1137 fichier d'entrée LilyPond est fait d'expressions musicales. Si la
1138 partition commence par plusieurs expressions simultanées, LilyPond
1139 créera plusieurs portées. Cependant, il est plus facile de prévoir le
1140 nombre de portées si on les crée explicitement, ce que nous allons
1143 Pour créer plus d'une portée, on ajoute @code{\new Staff} au début de
1144 chaque partie de la musique constituant une portée. Ces éléments
1145 @code{Staff} sont ensuite combinés en parallèle avec @code{<<} et
1146 @code{>>}, comme ci-dessous.
1148 @lilypond[quote,ragged-right,verbatim]
1151 \new Staff { \clef treble c }
1152 \new Staff { \clef bass c,, }
1158 La commande @code{\new} introduit un @qq{contexte de notation}. Un
1159 contexte de notation est un environnement dans lequel les événements
1160 musicaux --- comme les notes ou les commandes @code{\clef} --- sont
1161 interprétés. Pour des pièces simples, ces contextes sont créés
1162 automatiquement. Pour des pièces plus complexes, il est préférable de
1163 spécifier explicitement les contextes, afin de s'assurer que chaque
1164 fragment aura sa propre portée.
1166 Il existe différents types de contextes. Les contextes @code{Score}
1167 (partition), @code{Staff} (portée) et @code{Voice} (voix) gèrent la
1168 notation de la mélodie, alors que @code{Lyrics} gère les paroles et
1169 @code{ChordNames} imprime des noms d'accords.
1171 En termes de syntaxe, ajouter @code{\new} devant une expression
1172 musicale crée une plus grande expression musicale. En reprenant la
1173 comparaison précédente, cela ressemble au signe @emph{moins} en
1174 mathématiques. La formule @math{(4+5)} est une expression, donc
1175 @math{-(4+5)} est une plus grande expression.
1177 Les chiffres de métrique indiqués sur une portée affectent toutes les
1178 autres portées@footnote{Ce comportement peut être modifié si
1179 nécessaire, voir @ruser{Polymetric notation}.}. En revanche l'armure
1180 d'une portée n'affecte @emph{pas} les autres portées. Ces
1181 caractéristiques par défaut se justifient par le fait que
1182 l'utilisation d'instruments transpositeurs est bien plus fréquente que
1183 la musique polyrythmique.
1185 @lilypond[verbatim,quote]
1188 \new Staff { \clef treble \time 3/4 c }
1189 \new Staff { \clef bass \key d \major c,, }
1196 @subsection Staff groups
1198 @cindex portée double
1199 @cindex portée pour piano
1200 @cindex piano, portée pour
1201 @cindex clavier, portée pour
1203 Glossaire musical : @rglos{brace}.
1205 La musique pour piano s'écrit sur deux portées reliées par une
1206 @notation{accolade}. La gravure de ce type de portée est semblable à
1207 l'exemple de musique polyphonique de @ref{Multiple staves}, mais
1208 maintenant cette expression entière est interprétée dans un contexte
1218 Voici un bref exemple :
1220 @lilypond[quote,ragged-right,verbatim]
1223 \new Staff { \time 2/4 c4 e g g, }
1224 \new Staff { \clef bass c,, c' e c }
1231 Manuel de notation : @ruser{Keyboard instruments},
1232 @ruser{Displaying staves}.
1235 @node Combining notes into chords
1236 @subsection Combining notes into chords
1238 @cindex accords, notes simultanées
1240 Glossaire musical : @rglos{chord}.
1242 Nous avons vu précédemment comment combiner des notes simultanément,
1243 en les encadrant par des angles doubles @code{<<} et @code{>>}. Pour
1244 produire des accords simples, c'est-à-dire une superposition de notes
1245 de même durée, on encadre les hauteurs de notes par des angles simples
1246 @code{<} et @code{>}, et on écrit la durée juste après.
1248 @lilypond[verbatim,quote,relative=2]
1249 r4 <c e g>4 <c f a>2
1252 Beaucoup d'éléments de notation que l'on peut attacher à une note
1253 simple, comme une liaison, un crochet indiquat un début ou fin de
1254 lien, un signe d'articulation, peuvent être également attachés à un
1255 accord : il faut ajouter ces indications après les hauteurs et la
1256 durée, donc @emph{à l'extérieur} des angles.
1258 @lilypond[verbatim,quote,relative=2]
1259 r4 <c e g>8[ <c f a>]~ <c f a>2
1260 r4 <c e g>8( <c e g>\> <c e g>4 <c f a>\!)
1264 @node Single staff polyphony
1265 @subsection Single staff polyphony
1268 @cindex voix multiples sur une portée
1269 Quand différentes lignes mélodiques sont combinées sur une seule et même
1270 portée, elles sont imprimées comme des voix polyphoniques ; chaque voix
1271 a ses propre hampes@footnote{familièrement appelées queues de note.},
1272 liaisons et ligatures, la voix supérieure ayant les hampes vers le haut,
1273 la voix inférieure vers le bas.
1275 On réalise ce type de partition en entrant chaque voix comme une
1276 séquence, @emph{i.e.} avec @code{@{...@}}, puis en combinant
1277 simultanément les voix et en les séparant par @code{\\}.
1279 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
1286 Pour l'écriture de musique polyphonique, les silences invisibles
1287 s'avèrent bien pratiques : ce sont des silences qui ne s'impriment pas.
1288 Ils sont utiles pour remplir des voix qui, temporairement, ne jouent
1289 rien. Voici le même exemple que ci-dessus, avec un silence invisible
1290 @code{s} à la place d'un silence normal @code{r} :
1292 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
1300 Là encore, ces expressions peuvent s'imbriquer arbitrairement :
1302 @lilypond[quote,fragment,verbatim,relative=2,fragment]
1310 { <c g>1 ~ <c g>4 } \\
1318 Manuel de notation : @ruser{Simultaneous notes}.
1324 Cette section présente l'écriture vocale et les partitions de variété.
1327 * Setting simple songs::
1328 * Aligning lyrics to a melody::
1329 * Lyrics to multiple staves::
1333 @node Setting simple songs
1334 @subsection Setting simple songs
1339 Glossaire musical : @rglos{lyrics}.
1341 Prenons une mélodie toute simple, la comptine @emph{Girls and boys
1344 @lilypond[quote,ragged-right,verbatim]
1351 Des @notation{paroles} peuvent être associées à ces notes, en les
1352 combinant avec la commande @code{\addlyrics}. On entre les paroles en
1353 séparant chaque syllable par un espace :
1355 @lilypond[quote,ragged-right,verbatim]
1361 \addlyrics { One day this shall be free }
1365 Remarquez les accolades embrassant la musique et celles embrassant les
1366 paroles, ainsi que les angles doubles encadrant toute la pièce ; ces
1367 derniers indiquent simplement que la musique et les paroles se
1368 produisent en même temps.
1371 @node Aligning lyrics to a melody
1372 @subsection Aligning lyrics to a melody
1375 @cindex ligne d'extension
1376 @cindex trait d'union (paroles)
1377 @cindex caractère souligné (paroles)
1378 Glossaire musical : @rglos{melisma}, @rglos{extender line}.
1380 La ligne suivante de la comptine précédente est @emph{The moon doth
1381 shine as bright as day}. Ajoutons-la au code.
1383 @lilypond[verbatim,quote]
1388 d4 b8 c4 a8 d4 b8 g4
1389 g8 a4 b8 c b a d4 b8 g4.
1392 Girls and boys come out to play,
1393 The moon doth shine as bright as day;
1398 Remarquez que les paroles ajoutées ne s'alignent pas bien avec les
1399 notes. Le mot @emph{shine} devrait être chanté sur deux notes au lieu
1400 d'une. On appelle ceci un @notation{mélisme} : il s'agit d'une seule
1401 syllabe chantée sur plus d'une note. Il existe plusieurs façons
1402 d'étaler une sylabe sur plusieurs notes, la plus simple étant de lier
1403 les notes du mélisme. Pour les détails, consultez @ref{Ties and
1406 @lilypond[verbatim,quote]
1411 d4 b8 c4 a8 d4 b8 g4
1412 g8 a4 b8 c( b) a d4 b8 g4.
1415 Girls and boys come out to play,
1416 The moon doth shine as bright as day;
1421 Les paroles sont maintenant correctement alignées, mais les liens de
1422 croche automatiques ne conviennent pas pour les notes au-dessus de
1423 @emph{shine as}. On peut les corriger en ajoutant des liens de croche
1424 manuels, pour ceci consultez @ref{Automatic and manual beams}.
1426 @lilypond[verbatim,quote]
1431 d4 b8 c4 a8 d4 b8 g4
1432 g8 a4 b8 c([ b]) a d4 b8 g4.
1435 Girls and boys come out to play,
1436 The moon doth shine as bright as day;
1441 Au lieu d'utiliser une liaison, on peut indiquer le mélisme dans les
1442 paroles en insérant un caractère souligné @code{_} pour chaque note du
1443 mélisme sauf la première.
1445 @lilypond[verbatim,quote]
1450 d4 b8 c4 a8 d4 b8 g4
1451 g8 a4 b8 c[ b] a d4 b8 g4.
1454 Girls and boys come out to play,
1455 The moon doth shine _ as bright as day;
1460 Si une syllabe s'étend sur un grand nombre de notes ou une note très
1461 longue, on représente souvent le mélisme par un @notation{trait de
1462 prolongation}, qu'on entre avec @code{__}. L'exemple suivant montre
1463 les trois premières mesures de la plainte de Didon, extraite de
1464 @emph{Didon et Énée} de Purcell.
1466 @lilypond[verbatim,quote]
1472 b c4.( bes8 a4. g8 fis4.) g8 fis1
1476 am laid __ in earth,
1481 Aucun exemple jusqu'à présent n'a utilisé de mots de plus d'une
1482 syllabe. Dans des paroles, de tels mots sont écrits en syllabes
1483 séparées par des traits d'union. Avec LilyPond, on utilise deux
1484 tirets pour produire un trait d'union centré entre deux syllabes.
1485 L'exemple suivant montre tout ce que nous avons vu jusqu'à maintenant
1486 sur l'alignement de paroles à une mélodie.
1488 @c no ragged-right here because otherwise the hyphens get lost,
1489 @c but the example is long enough to avoid looking strange.
1490 @lilypond[verbatim,quote,noragged-right]
1496 d4 g4 g a8( b) g4 g4
1500 A -- way in a __ man -- ger,
1501 no __ crib for a bed, __
1506 Avec certaines paroles, en particulier en italien, il se produit la
1507 situation inverse : il peut y avoir plusieurs syllabes sur une seule
1508 note. On réalise ceci avec LilyPond grâce à un caractère souligné
1509 @code{_} sans espace entre les syllabes, ou alors en groupant les
1510 syllabes avec des guillemets. L'exemple suivant est extrait de l'air
1511 de Figaro @emph{Largo al factotum}, dans @emph{Figaro} de Rossini, où
1512 la syllabe @emph{al} est chantée sur la même note que @emph{go}.
1514 @c no ragged-right here because otherwise the hyphens get lost,
1515 @c but the example is long enough to avoid looking strange.
1516 @lilypond[verbatim,quote,noragged-right]
1522 c4.~ c8 d b c([ d]) b c d b c
1525 Lar -- go_al fac -- to -- tum del -- la cit -- tà
1532 Manuel de notation : @ruser{Vocal music}.
1535 @node Lyrics to multiple staves
1536 @subsection Lyrics to multiple staves
1538 La méthode simple d'ajout de paroles avec @code{\addlyrics} peut être
1539 également utilisée pour placer des paroles sous plusieurs portées.
1540 L'exemple suivant est extrait de @emph{Judas Macchabée} de Händel.
1542 @lilypond[verbatim,quote]
1548 c8 c([ bes]) a a([ g]) f f'4. b, c4.~ c4
1551 Let flee -- cy flocks the hills a -- dorn, __
1557 r8 r4. r4 c8 a'([ g]) f f([ e]) d e([ d]) c bes'4
1560 Let flee -- cy flocks the hills a -- dorn,
1565 Pour produire des partitions plus complexes ou plus longues que cet
1566 exemple simple, il est vivement conseillé de séparer la structure de
1567 la partition des notes et paroles, grâce à des variables. Ceci sera
1568 détaillé plus loin dans @ref{Organizing pieces with variables}.
1572 Manuel de notation : @ruser{Vocal music}.
1577 @section Final touches
1579 L'ultime section de ce tutoriel montre comment ajouter une touche
1580 finale à des morceaux simples, et constitue une introduction au reste
1584 * Organizing pieces with variables::
1587 * Absolute note names::
1588 * After the tutorial::
1592 @node Organizing pieces with variables
1593 @subsection Organizing pieces with variables
1595 Lorsque l'on combine tous les éléments étudiés précédemment pour
1596 écrire des partitions plus longues, les expressions musicales prennent
1597 de l'ampleur et, dans le cas des pièces polyphoniques, deviennent
1598 profondément imbriquées, jusqu'au point où il devient difficile de se
1599 repérer dans le fichier source. Cet inconvénient peut être résolu par
1600 l'utilisation de @emph{variables}.
1602 En utilisant des variables, parfois appelées identificateurs ou
1603 macros, on peut scinder des expressions musicales complexes en des
1604 expressions plus simples. Une variable se définit comme suit :
1607 musiqueToto = @{ @dots{} @}
1610 Le contenu de l'expression musicale @code{musiqueToto} pourra être
1611 utilisé plus loin en faisant précéder son nom d'un anti-slash,
1612 c'est-à-dire @code{\musiqueToto}, tout comme n'importe quelle commande
1613 LilyPond. Toute variable doit être définie @emph{avant} son
1614 utilisation dans une autre expression musicale.
1616 @lilypond[quote,verbatim,ragged-right]
1617 violin = \new Staff { \relative c'' {
1620 cello = \new Staff { \relative c {
1633 Le nom d'une variable ne doit comporter que des caractères
1634 alphabétiques non accentués, aucun nombre ni tiret ne sont autorisés.
1636 On peut utiliser une variable déjà définie autant de fois que l'on
1637 veut, y compris dans la définition d'une nouvelle variable ; par
1638 exemple, cela peut servir à saisir un motif qu'une seule fois, même
1639 s'il se répète un grand nombre de fois dans la pièce.
1641 @lilypond[verbatim,quote]
1642 tripletA = \times 2/3 { c,8 e g }
1643 barA = { \tripletA \tripletA \tripletA \tripletA }
1650 Il est possible d'utiliser des variables de types variés. Par exemple,
1655 aFivePaper = \paper @{ paperheight = 21.0 \cm @}
1658 En fonction de son contenu, un identificateur peut être utilisé à
1659 différents endroits. L'exemple suivant utilise les variable définies
1671 @node Version number
1672 @subsection Version number
1675 La déclaration @code{\version} stipule le numéro de la version de
1676 LilyPond pour laquelle le fichier a été écrit :
1679 \version @w{"@version{}"}
1683 Par convention, on place cette instruction en début de fichier.
1685 Cette instruction permet de faciliter les mises à jour futures de
1686 LilyPond. Les changements de syntaxe au fil des versions sont gérés
1687 avec un programme dédié, @command{convert-ly}, qui utilise la valeur
1688 de @code{\version} pour déterminer les règles de conversion à
1689 appliquer au fichier source. Pour plus d'informations, consultez voir
1690 @rprogram{Updating files with convert-ly}.
1694 @subsection Adding titles
1696 On indique les informations bibliographiques --- nom du morceau, du
1697 compositeur, numéro d'opus... --- dans un bloc à part, le bloc
1698 d'en-tête @code{\header}, qui existe indépendamment de l'expression
1699 musicale principale. Le bloc @code{\header} est habituellement placé
1700 en début de fichier, après le numéro de version.
1703 \version @w{"@version{}"}
1711 @dots{} la musique @dots{}
1715 Quand LilyPond traite le fichier, le titre et le compositeur sont
1716 imprimés au début de la partition. Vous trouverez plus d'informations
1717 sur les titres à la section @ruser{Creating titles}.
1720 @node Absolute note names
1721 @subsection Absolute note names
1723 Jusqu'ici nous n'avons utilisé que le mode @code{\relative} pour
1724 définir les hauteurs de notes. Si c'est souvent le moyen le plus
1725 simple de saisir la musique au clavier, il existe une autre façon de
1726 procéder : le mode de hauteurs absolues.
1728 Si vous omettez la commande @code{\relative}, LilyPond considérera
1729 toutes les hauteurs comme des hauteurs absolues. Un @code{c'} désigne
1730 toujours le do central, un @code{b} se situe une seconde en dessous
1731 du do central, et un @code{g,} est situé sur la première ligne de
1732 la portée en clé de fa.
1734 @lilypond[quote,verbatim,ragged-right]
1742 Voici une gamme sur 4 octaves :
1744 @lilypond[quote,verbatim,ragged-right]
1759 Comme vous pouvez le voir, il faut beaucoup d'apostrophes pour écrire
1760 de la musique dans un registre aigu, comme le montre cet extrait de
1763 @lilypond[quote,verbatim,ragged-right]
1767 cis''8. d''16 cis''8 e''4 e''8
1768 b'8. cis''16 b'8 d''4 d''8
1772 Toutes ces apostrophes rendent le fichier moins lisible, et surtout il
1773 est très probable d'oublier au moins une apostrophe au cours de la
1774 frappe. En mode @code{\relative}, le même exemple devient bien plus
1775 facile à lire et à saisir.
1777 @lilypond[quote,verbatim,ragged-right]
1781 cis8. d16 cis8 e4 e8
1786 Si d'aventure vous faites une erreur d'octaviation, le mode
1787 @code{\relative} la mettra en évidence : toutes les notes suivantes
1788 seront placées à la mauvaise octave. En mode de hauteurs absolues,
1789 une erreur isolée ne serait pas autant visible, donc serait plus
1790 difficile à dénicher.
1792 Cependant, le mode de hauteurs absolues reste utile pour les musiques
1793 où les intervalles sont étendus, et plus encore pour les fichiers
1794 LilyPond créés par des programmes.
1797 @node After the tutorial
1798 @subsection After the tutorial
1800 Après avoir parcouru ce tutoriel, vous devriez essayer d'écrire un
1801 morceau ou deux. Commencez par copier l'un des modèles types et
1802 ajoutez-y des notes --- consultez les @ref{Templates}. Si vous voulez
1803 employer une notation que vous n'avez pas trouvé dans le tutoriel,
1804 consultez le manuel de notation, en commençant par la @ruser{Musical
1805 notation}. Si vous désirez écrire pour un ensemble instrumental non
1806 couvert par les modèles, lisez la section @ref{Extending the
1809 Après avoir écrit quelques pièces courtes, lisez les chapitres 3 à 5
1810 du manuel d'initiation. Rien ne s'oppose à ce que vous consultiez dès
1811 à présent ces chapitres, bien sûr ! Néanmoins, le reste du manuel
1812 d'initiation part du principe que vous avez déjà bien assimilé la
1813 syntaxe de base de LilyPond. Vous pouvez toujours survoler ces
1814 chapitres 3 à 5, et y revenir plus tard après avoir acquis de
1817 Si vous ne l'avez pas encore fait, lisez @ref{About the
1818 documentation}. Les sources de documentation et d'information sur
1819 LilyPond sont vastes, il est normal pour un débutant de ne pas savoir
1820 où chercher ; si vous passez quelques minutes à lire attentivement
1821 cette section, vous vous épargnerez certainement la frustration causée
1822 par des heures de recherche infructueuses.