1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
2 @c This file is part of lilypond.tely
4 Translation of GIT committish: 1f529784cd672e34f18e534eccf36280c330e934
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
37 Ce tutoriel commence par une introduction au langage musical utilisé
38 par LilyPond, qui vous permettra de faire fonctionner le logiciel pour
39 produire une partition. Après ce premier contact, nous verrons comment
40 créer des partitions utilisant une notation musicale courante.
44 * Single staff notation::
45 * Multiple notes at once::
54 Cette section présente les aspects élémentaires de l'utilisation de
60 * Working on text files::
61 * How to read the manual::
65 @node Compiling a file
66 @subsection Compiling a file
70 Pour créer une partition avec LilyPond, on écrit un fichier texte,
71 appelé fichier source, qui décrit la notation musicale. La
72 @emph{compilation} de ce fichier source par LilyPond produit un
73 fichier graphique imprimable, et si on le désire un fichier MIDI qui
74 peut être joué par un séquenceur. Voici un premier exemple simple de
75 fichier source LilyPond.
84 Le compilation de cette partition donnera quelque chose de sembable à
87 @c in this case we don't want verbatim
88 @lilypond[quote,ragged-right]
95 Il est aussi possible d'utiliser les noms de notes français @samp{do
96 re mi fa sol la si}, en insérant au début du fichier la ligne
97 @samp{\include "italiano.ly"}.
100 @warning{Tout extrait de code LilyPond doit être entouré d'une
101 @strong{@{ paire d'accolades @}}. De plus, pour éviter toute
102 ambiguïté, il est préférable d'entourer les accolades par des espaces
103 ou retours à la ligne. Bien que certains exemples de ce manuel ne
104 comportent pas d'accolades, ne les oubliez pas dans vos partitions !
105 Pour plus d'informations sur l'affichage des exemples de cette
106 documentation, consultez @ref{How to read the manual}.}
109 @cindex casse, prise en compte de
110 @cindex prise en compte de la casse
111 @cindex sensibilité à la casse
112 De plus, LilyPond est @strong{sensible à la casse} : le code
113 @w{@code{@{ c d e @}}} est valide, alors que @w{@code{@{ C D E @}}}
114 produira un message d'erreur.
118 @subheading Entering music and viewing output
122 @cindex partition, lire
123 @cindex lire la partition
125 Dans cette section nous expliquerons quelles commandes exécuter et
126 comment voir ou imprimer le résultat produit par LilyPond.
128 Notez qu'il existe plusieurs éditeurs de texte disponibles avec un bon
129 support de LilyPond ; consultez @rprogram{Text editor support}.
131 @warning{Le premier démarrage de LilyPond peut prendre une minute ou
132 deux, afin de faire la liste des polices du système. LilyPond démarre
133 en principe plus rapidement lors des exécutions suivantes.}
136 @subsubheading MacOS X
138 Si vous double-cliquez sur @code{LilyPond.app}, un fichier d'exemple
139 s'ouvrira. Sauvegardez-le, par exemple, sous @file{test.ly} sur votre
140 bureau, puis traitez-le avec la commande de menu @samp{Compile >
141 Typeset File}. Le fichier PDF résultant sera alors affiché à l'écran.
143 À l'avenir, vous aurez certainement recours aux commandes @qq{Nouveau}
144 ou @qq{Ouvrir}. Vous devez enregistrer votre fichier avant de lancer
145 la gravure de la partition par LilyPond. Si une erreur apparaît
146 pendant le traitement, vous la trouverez dans la fenêtre @qq{log}.
148 @subsubheading Windows
150 Sous Windows, double-cliquez sur l'icône LilyPond qui se trouve sur le
151 bureau, un fichier d'exemple s'ouvre dans un simple éditeur de texte.
152 Enregistrez-le, par exemple en tant que @file{test.ly} sur le bureau,
153 puis double-cliquez sur son icône (qui montre une note de musique)
154 pour le traiter. Après quelques secondes, vous obtiendrez un fichier
155 @file{test.pdf} sur le bureau, fichier que vous pourrez ouvrir pour
156 voir la partition gravée. Une autre méthode pour lancer le traitement
157 du fichier @file{test.ly} est de le glisser avec votre souris sur
160 Pour modifier un fichier @file{.ly} existant, faites un clic droit
161 dessus et sélectionnez @qq{Éditer la source}. Pour partir d'un
162 fichier vide, lancez l'éditeur en ouvrant un fichier existant et
163 utilisez la commande @qq{New} du menu @qq{File}.
165 En double-cliquant sur le fichier, vous obtiendrez, en plus du fichier
166 PDF, un fichier @file{.log} qui récapitule les opérations que LilyPond
167 a effectuées sur votre fichier. Si une erreur survient, vous en
168 trouverez les détails dans ce fichier.
172 Créez un fichier texte @file{test.ly} qui contient
181 Pour traiter @file{test.ly}, entrez la commande suivante dans un
189 Vous verrez quelque chose ressemblant à
193 GNU LilyPond @version{}
194 Traitement de « test.ly »
196 Interprétation en cours de la musique...
197 Pré-traitement des éléments graphiques...
198 Détermination du nombre optimal de pages...
199 Répartition de la musique sur une page...
200 Dessin des systèmes...
201 Sortie mise en page vers « test.ps »...
202 Conversion à « ./test.pdf »...
207 Suivant votre installation, ces messages peuvent être traduits ou
212 @node Simple notation
213 @subsection Simple notation
215 Il y a certains éléments graphiques de notation que LilyPond ajoute
216 automatiquement. Dans l'exemple suivant, nous n'avons fourni que
217 quatre hauteurs, mais LilyPond a ajouté une clé, un chiffre de mesure
220 @lilypond[quote,ragged-right,verbatim]
227 Ces valeurs automatiques simplifient la saisie du code source dans
228 bien des cas ; nous verrons plus loin comment les indiquer
234 Glossaire musical : @rglos{pitch}, @rglos{interval},
235 @rglos{scale}, @rglos{middle C}, @rglos{octave},
238 Le moyen le plus simple d'entrer des notes est d'utiliser le mode
239 d'octaves relatives, ou mode @code{\relative}. Dans ce mode, l'octave
240 de chaque note est sélectionnée automatiquement de façon à ce qu'elle
241 soit la plus proche possible de la note précédente, c'est-à-dire de
242 façon à ce que l'intervalle avec la note précédente soit au plus d'une
243 quarte. Commençons par saisir une partition très simple, à savoir une
246 @lilypond[quote,ragged-right,verbatim]
247 \relative c' { % set the starting point to middle C
253 La note de départ est le @notation{do central}. Chacune des notes qui
254 suivent est placée à l'octave la plus proche de la note précédente ---
255 en d'autres termes, le premier @samp{c} est le do central, entre la
256 clé de sol et la clé de fa, puis est suivi par le ré le plus proche,
257 et ainsi de suite. On peut bien sûr créer des mélodies avec de plus
258 grands intervalles, toujours avec le mode @code{\relative} :
260 @lilypond[quote,ragged-right,verbatim]
268 Remarquez que cet exemple ne commence plus sur le do central : la
269 première note --- le @samp{d} --- est le ré qui en est le plus proche.
271 Dans l'exemple suivant, on remplace @code{c'} dans la commande
272 @w{@code{\relative c'}} par @code{c''}, afin de calculer l'octave de
273 la première note par rapport au do situé une octave au-dessus du do
276 @lilypond[verbatim,quote,ragged-right]
277 \relative c'' { % one octave above middle C
282 Le mode d'octaves relatives peut être déroutant au début, mais c'est
283 souvent la façon la plus économique de saisir les hauteurs en
284 utilisant le clavier de l'ordinateur de façon classique. Détaillons
285 sur un exemple le calcul des octaves relatives. En partant d'un si
286 sur la troisième ligne de la clé de sol, un do, un ré ou un mi sans
287 indication d'octave particulière seront placés juste au-dessus du si,
288 c'est-à-dire au plus à une quarte ascendante du si, alors qu'un la, un
289 sol ou un fa seront placés juste en-dessous du si, c'est-à-dire au
290 plus à une quarte descendante du si.
292 @lilypond[verbatim,quote,ragged-right]
294 b c % c is 1 staff space up, so is the c above
295 b d % d is 2 up or 5 down, so is the d above
296 b e % e is 3 up or 4 down, so is the e above
297 b a % a is 6 up or 1 down, so is the a below
298 b g % g is 5 up or 2 down, so is the g below
299 b f % f is 4 up or 3 down, so is the f below
303 Notez que le calcul des octaves relatives @strong{ne dépend pas des
304 altérations} des notes, dièses bémols ou bécarre.
306 Pour obtenir des intervalles supérieurs à une quarte, on peut ajouter
307 des apostrophes @code{'} --- qui font chacune monter la hauteur d'une
308 octave --- ou des virgules @code{,} --- qui font chacune descendre la
309 hauteur d'une octave --- au nom de la note.
311 @lilypond[quote,ragged-right,verbatim]
319 Pour déplacer une note deux octaves (ou davantage !) plus haut ou plus
320 bas, il suffit de mettre deux (ou davantage) de @code{'} ou ou @code{,} ---
321 attention cependant à bien mettre deux apostrophes @code{''}, et non
322 un guillemet @code{"}@tie{}! C'est de cette même manière que l'on
323 peut modifier la valeur de départ de @code{\relative c'}.
326 @subheading Durées et rythme
328 Glossaire musical : @rglos{beam}, @rglos{duration},
329 @rglos{whole note}, @rglos{half note}, @rglos{quarter note},
332 La @notation{durée} d'une note est indiquée par un nombre qui suit sa
333 hauteur : @samp{1} pour une @notation{ronde}, @samp{2} pour une
334 @notation{blanche}, @samp{4} pour une @notation{noire} et ainsi de
335 suite. Les @notation{crochets} et @notation{liens} sont ajoutées
338 Si aucune durée n'est indiquée pour une note, la dernière durée entrée
339 est utilisée. En l'absence d'indication de durée, la première note
342 @lilypond[verbatim,quote,ragged-right]
346 a16 a a a a32 a a a a64 a a a a a a a a2
350 Une @notation{note pointée} s'obtient en ajoutant un point @code{.} à
351 la valeur rythmique. Le point doit être précédé d'un nombre de durée.
353 @lilypond[verbatim,quote,ragged-right]
363 Glossaire musical : @rglos{rest}.
365 On saisit un @notation{silence} tout comme une note, mais avec la
368 @lilypond[verbatim,quote,ragged-right]
378 Glossaire musical : @rglos{time signature}.
380 La @notation{métrique}, aussi appelée @notation{chiffre de mesure},
381 peut être définie à l'aide de la commande @code{\time} :
383 @lilypond[verbatim,quote,ragged-right]
397 Glossaire musical : @rglos{clef}.
399 La @notation{clef} peut être définie à l'aide de la commande
402 @lilypond[verbatim,quote,ragged-right]
416 @subheading Tout ensemble
418 Voici un bref exemple qui rassemble tous les éléments que nous déjà
421 @lilypond[verbatim,quote,ragged-right]
432 Manuel de notation : @ruser{Writing pitches},
433 @ruser{Writing rhythms}, @ruser{Writing rests},
434 @ruser{Time signature}, @ruser{Clef}.
437 @node Working on text files
438 @subsection Working on text files
440 Le traitement des fichiers source de LilyPond est semblable à celui du
441 code de nombreux langages de programmation. La casse est prise
442 en compte, et les caractères considérés comme espaces ont généralement
443 peu d'importance. Les expressions sont délimitées par des accolades @{
444 @}, et les commentaires par @code{%} ou @code{%@{ ... %@}}.
446 Si cette phrase vous paraît incompréhensible, ne vous en faites pas !
447 Expliquons tous ces termes :
451 @cindex casse, prise en compte de
452 @cindex prise en compte de la casse
453 @cindex sensibilité à la casse
454 @item @strong{La casse} :
455 LilyPond est sensible à la casse, c'est à dire qu'une lettre capitale
456 n'a pas la même valeur qu'une lettre minuscule. Les notes, par
457 exemple, doivent être entrées en minuscules : @code{@{ c d e @}} est
458 un code valide, alors que @code{@{ C D E @}} produira un message
461 @item @strong{Les espaces multiples} :
462 LilyPond ne tient pas compte du nombre d'espaces, ou de retours à la
463 ligne. @code{@{ c d e @}} a le
464 même sens que @code{@{ c @tie{} @tie{} d @tie{} e @}} ou que
472 Bien sûr, ce dernier exemple est illisible. Une bonne habitude
473 à prendre est d'indenter les blocs de code avec soit des tabulations
474 soit des doubles espaces :
482 @item @strong{Expressions musicales} :
483 Tout morceau saisi dans LilyPond doit être placé entre @strong{@{
484 accolades @}}. Ces caractères indiquent à LilyPond que ce bloc de
485 texte représente une et une seule expression musicale, tout comme les
486 parenthèses @samp{()} en mathématiques. Pour éviter toute ambiguïté,
487 il est préférable d'entourer ces accolades d'espaces ou de retours à
490 Un appel de fonction --- @w{@code{\relative @{ @}}} par exemple ---
491 compte également comme une seule expression musicale.
494 @cindex commentaire de fin de ligne
495 @cindex commentaire-bloc
496 @cindex bloc de commentaire
497 @item @strong{Les commentaires} :
498 un commentaire est une indication pour tout lecteur humain d'un
499 fichier source de musique ; il est ignoré par l'ordinateur, et n'a
500 donc aucun effet sur la partition imprimée. On distingue deux types
501 de commentaires. Le commentaire de fin de ligne, introduit par le
502 symbole @samp{%} : tout ce qui suit ce symbole sur la même ligne sera
503 ignoré. Par convention, un commentaire qui occupe une ligne entière
504 se place juste @emph{au-dessus} de la ligne à laquelle il fait
509 % ce commentaire fait référence aux sis
513 Le bloc de commentaire, qui peut occuper plusieurs lignes voire toute
514 une section : tout ce qui se trouve entre @code{%@{} et @code{%@}} est
515 ignoré. Les blocs de commentaires ne peuvent s'imbriquer, ce qui
516 signifie que vous ne pouvez pas placer un commentaire-bloc à
517 l'intérieur d'un autre commentaire-bloc. Si jamais vous essayez, vous
518 verrez que la première occurence de @code{%@}} terminera @qq{les
519 @emph{deux} commentaires-blocs}. Le fragment suivant met en évidence
520 quelques usages possibles des commentaires :
523 % voici les notes de "ah vous dirai-je maman"
527 Ces lignes et les notes qui suivent
528 seront ignorées, car elles se trouvent
529 dans un bloc de commentaire.
539 @node How to read the manual
540 @subsection How to read the manual
542 Comme nous l'avons vu dans @ref{Working on text files}, un code
543 LilyPond doit être encadré par des accolades @{ @} ou bien par
544 @code{\relative c'' @{ ... @}}. Cependant, dans la suite de ce
545 manuel, la plupart des exemples ne feront pas apparaître ces signes.
547 Pour reproduire les exemples, vous pouvez copier et coller le code
548 affiché, mais @strong{à condition} d'ajouter @code{\relative c'' @{
549 @}} de la façon suivante :
553 ...collez ici votre exemple...
557 Pourquoi avoir omis les accolades ? La plupart des exemples de ce
558 manuel peuvent être insérés au milieu d'un morceau de musique plus
559 long. Il n'y a donc aucune raison d'ajouter @code{\relative c'' @{
560 @}} à ces exemples --- en effet, il n'est pas possible d'insérer une
561 expression @code{\relative} à l'intérieur d'un autre expression
562 @code{\relative}. Si nous mettions tous nos exemples dans une
563 expression @code{\relative}, vous ne pourriez plus copier un bref
564 exemple de la documentation pour le coller dans vos pièces.
567 @subheading Exemples cliquables
569 Beaucoup de gens apprennent à utiliser les programmes en les essayant
570 et en bidouillant avec. C'est également possible avec LilyPond. Si
571 vous cliquez sur une image dans la version HTML de ce manuel, vous
572 verrez exactement le code LilyPond utilisé pour générer cette image.
573 Essayez sur cette image :
577 @lilypond[quote,ragged-right]
579 c-\markup { \bold \huge { Cliquez ici. } }
583 En copiant-collant le code à partir du commentaire @qq{ly snippet}
584 vers un fichier test, vous aurez un modèle de base pour faire vos
585 expériences. Pour obtenir une gravure à l'identique, copiez tout le
586 code à partir de @qq{Start cut-&-pastable section}.
588 @c No longer in the text in English, but should we really
591 Si vous apprenez de cette façon, vous aurez probablement envie
592 d'imprimer ou de garder un lien vers @ruser{Cheat sheet}, tableau
593 qui répertorie les commandes usuelles pour une consultation rapide.
598 Vous trouverez plus de conseils pour construire des fichiers source
599 dans @ref{Suggestions for writing LilyPond input files}. Cependant,
600 lors d'une première lecture il est préférable de terminer d'abord la
604 @node Single staff notation
605 @section Single staff notation
607 Cette section présente la notation courante dont on a besoin pour
608 écrire une voix sur une portée.
611 * Accidentals and key signatures::
613 * Articulation and dynamics::
615 * Automatic and manual beams::
616 * Advanced rhythmic commands::
620 @node Accidentals and key signatures
621 @subsection Accidentals and key signatures
623 @subheading Accidentals
625 Glossaire musical : @rglos{sharp}, @rglos{flat}, @rglos{double sharp},
626 @rglos{double flat}, @rglos{accidental}.
628 Dans la notation par défaut, on obtient un @notation{dièse} en
629 ajoutant @code{is} au nom de la note, et un @notation{bémol} en
630 ajoutant @code{es}. Comme vous pouvez vous y attendre, un double
631 dièse ou double bémol s'obtiennent en ajoutant @code{isis} ou
632 @code{eses}. Cette syntaxe est dérivée de la convention de
633 dénomination des notes dans les langues nordiques et germaniques,
634 comme l'allemand ou le hollandais.
637 Cependant, si vous utilisez la commande @code{\include "italiano.ly"}
638 pour entrer les noms de notes français au lieu des noms hollandais, il
639 faudra ajouter un @code{d} pour obtenir un dièse, et un @code{b} pour
640 un bémol. Le double dièse et le double bémol s'obtiennent en ajoutant
641 respectivement @code{dd} et @code{bb}. Pour en savoir plus sur les
642 autres langues disponibles, consultez @ruser{Note names in other
646 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
647 cis1 ees fisis, aeses
650 @cindex armure, définition de l'
651 @cindex armure, altérations à l'
652 @cindex altérations à l'armure
653 @subheading Key signatures
655 L'armure est déterminée par la commande @code{\key}, suivie d'une
656 hauteur puis de @code{\major} (majeur) ou @code{\minor} (mineur).
658 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
667 @subheading Warning: key signatures and pitches
669 Glossaire musical : @rglos{accidental}, @rglos{key signature},
670 @rglos{pitch}, @rglos{flat}, @rglos{natural}, @rglos{sharp},
671 @rglos{transposition}.
673 La combinaison de l'@notation{armure} et des hauteurs de note --- y
674 compris les altérations --- permet à LilyPond de déterminer dans quel
675 cas imprimer des @notation{altérations accidentelles}. L'armure
676 n'affecte que les altérations @emph{imprimées}, et non les hauteurs
677 réelles ! Cette fonctionnalité est souvent source de confusion pour
678 les nouveaux utilisateurs, aussi expliquons-la en détail.
680 LilyPond fait une distinction nette entre le contenu musical et la
681 mise en forme. L'altération d'une note --- @notation{bémol},
682 @notation{bécarre} ou @notation{dièse} --- fait partie de sa hauteur,
683 et relève donc du contenu musical. La gravure ou non d'une altération
684 accidentelle --- un @emph{signe} bémol, bécarre ou dièse --- devant la
685 note correspondante est une question qui relève de la mise en forme.
686 La gravure une partition suit des règles, en particulier des règles
687 d'indication des altérations accidentelles. Les hauteurs de note, en
688 revanche, relèvent de ce que vous voulez entendre ; et, dans la mesure
689 où la musique que vous entrez est censée être celle que vous voulez
690 entendre, LilyPond, qui n'est chargé que de la gravure, ne les
691 choisira pas à votre place.
695 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
701 aucune note n'a d'altération accidentelle, et pourtant vous devrez
702 entrer le @code{is} pour les notes @code{cis} et @code{fis}.
704 Le code @code{e} ne veut pas dire @qq{Imprimez-moi un point noir sur
705 la première ligne de la portée.} Cela signifie plutôt : @qq{Ici se
706 trouve une note dont la hauteur est un mi naturel.} Avec une armure
707 de la bémol majeur, ce mi est flanqué d'un bécarre accidentel :
709 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
714 Ajouter explicitement toutes les altérations demande un peu plus
715 d'effort dans la phase de saisie, mais cela facilite grandement la
716 @notation{transposition}. De plus, les altérations accidentelles
717 peuvent ainsi être imprimées suivant plusieurs conventions. Pour
718 connaître les différentes manières dont les altérations accidentelles
719 peuvent être imprimées, consultez @ruser{Automatic accidentals}.
723 Manuel de notation : @ruser{Note names in other languages},
724 @ruser{Accidentals}, @ruser{Automatic accidentals},
725 @ruser{Key signature}.
727 Glossaire musical : @rglos{Pitch names}.
730 @subsection Ties and slurs
732 @cindex liaisons de prolongation
733 @cindex liaisons de tenue
734 @cindex prolongation, liaisons de
735 @cindex durée, liaisons de
736 @cindex tenue, liaisons de
739 Glossaire musical : @rglos{tie}.
741 Pour créer une liaison de prolongation@footnote{parfois aussi appelée
742 liaison de tenue}, on ajoute un tilde @code{~} à la première note
745 @lilypond[verbatim,quote,relative=2]
750 @cindex liaisons d'articulation
751 @cindex articulation, liaisons d'
754 @c Le terme de "slur" a deux sens en français : articulation et phrasé.
755 @c Je garde ici le terme "legato", tel qu'il apparaît dans le texte original,
756 @c car c'est celui qui me semble le plus couramment employé.
758 Glossaire musical : @rglos{slur}.
760 Une liaison d'articulation ou @emph{legato} peut englober
761 plusieurs notes. Les notes de départ et d'arrivée sont suivies
762 respectivement d'un signe @samp{(} et @samp{)}.
764 @lilypond[verbatim,quote,relative=2]
765 d4( c16) cis( d e c cis d) e( d4)
768 @cindex liaisons de phrasé
769 @cindex phrasé, liaisons de
771 @subheading Phrasing slurs
773 De plus longues liaisons, dites de phrasé, sont délimitées par @code{\(} et
774 @code{\)}. Il est possible d'avoir en même temps des legatos et des
775 phrasés, mais pas plusieurs liaisons de phrasé ou de legato à la fois.
777 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
778 a8(\( ais b c) cis2 b'2 a4 cis,\)
783 @cindex liaisons d'articulation et de prolongation, différences
784 @subheading Warnings: slurs vs. ties
786 Glossaire musical : @rglos{articulation}, @rglos{slur}, @rglos{tie}.
788 Une liaison d'articulation ou de phrasé ressemble à une liaison de
789 prolongation, mais n'a pas la même signification. Alors qu'une
790 liaison de prolongation ne peut relier que deux notes de même hauteur,
791 le legato indique une articulation de plusieurs notes, éventuellement
792 en grand nombre. Les liaisons de tenue peuvent être enchâssées dans
793 un legato ou un phrasé.
795 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
796 c2~( c8 fis fis4 ~ fis2 g2)
801 Manuel de notation : @ruser{Ties}, @ruser{Slurs},
802 @ruser{Phrasing slurs}.
804 @node Articulation and dynamics
805 @subsection Articulation and dynamics
810 @subheading Articulations
812 Glossaire musical : @rglos{articulation}.
814 Des @notation{articulations} peuvent être ajoutées à une note, au moyen
815 d'un tiret @code{-} suivi d'un caractère :
817 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
818 c-. c-- c-> c-^ c-+ c-_
822 @subheading Fingerings
824 Glossaire musical : @rglos{fingering}.
826 De même, des indications de doigté peuvent être ajoutées à une note en
827 utilisant un tiret (@samp{-}) et le chiffre à écrire :
829 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
833 Articulations et doigtés sont habituellement placés automatiquement,
834 mais vous pouvez indiquer une direction en utilisant @samp{^} (en
835 haut) ou @samp{_} (en bas). Vous pouvez aussi utiliser plusieurs
836 articulations sur la même note. Dans la plupart des cas, cependant,
837 il est bon de laisser LilyPond déterminer l'emplacement de
840 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
841 c_-^1 d^. f^4_2-> e^-_+
846 Glossaire musical : @rglos{dynamics}, @rglos{crescendo},
849 On obtient un signe de @notation{nuance} en ajoutant à la note les
850 lettres du signe, précédées d'un anti-slash @samp{\} :
852 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
860 @c Pluriel des termes musicaux italiens :
861 @c selon Littré, plutôt à la française (en "-os" qu'en "-i")
863 @notation{Crescendos} et @notation{decrescendos} débutent avec les
864 commandes @code{\<} et @code{\>}. Ils se terminent soit par une
865 nuance d'arrivée, par exemple @code{\f}, soit par la commande
868 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
874 Manuel de notation : @ruser{Articulations and ornamentations},
875 @ruser{Fingering instructions}, @ruser{Dynamics}.
879 @subsection Adding text
881 On peut ajouter du texte à une partition :
883 @lilypond[verbatim,quote,relative=2]
887 Pour mettre en forme du texte, on utilise la commande @code{markup} :
889 @lilypond[verbatim,quote,relative=2]
890 c1^\markup{ \bold espr}
892 \dynamic f \italic \small { 2nd } \hspace #0.1 \dynamic p
898 Manuel de notation : @ruser{Writing text}.
901 @node Automatic and manual beams
902 @subsection Automatic and manual beams
904 @cindex ligatures manuelles
906 Glossaire musical : @rglos{beam}.
908 Toutes les barres de ligature sont dessinées automatiquement :
910 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
911 a8 ais d ees r d c16 b a8
915 Lorsqu'on n'aime pas la manière dont les notes sont automatiquement
916 groupées, il est possible de les ligaturer manuellement, en marquant la
917 première note à attacher d'un crochet ouvrant @code{[} et la dernière
918 d'un crochet fermant @code{]}.
920 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
921 a8[ ais] d[ ees r d] a b
924 Pour désactiver les barres de ligature automatqiues pour des passages
925 entiers, utilisez la commande @code{\autoBeamOff}, et utilisez
926 @code{\autoBeamOn} pour les réactiver.
928 @lilypond[verbatim,quote,relative=2]
937 Manuel de notation : @ruser{Automatic beams}, @ruser{Manual beams}.
940 @node Advanced rhythmic commands
941 @subsection Advanced rhythmic commands
945 @cindex mesure incomplète
946 @subheading Partial measure
948 Glossaire musical : @rglos{anacrusis}.
950 On crée une levée (ou anacrouse) avec la commande @code{\partial},
951 suivie d'une durée : @code{\partial 4} produit une levée d'une noire
952 et @code{\partial 8} d'une croche.
954 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
963 Glossaire musical : @rglos{note value}, @rglos{triplet}.
965 Les @notation{nolets} sont créés avec la commande @code{\times}, qui
966 prend deux arguments : une fraction et une expression musicale. La
967 durée des notes de l'expression musicale est multipliée par la
968 fraction. Par exemple les notes d'un @notation{triolet} durent les
969 deux tiers de la durée de leur notation réelle, cette fraction est
970 donc de 2/3 pour les triolets :
972 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
973 \times 2/3 { f8 g a }
975 \times 2/3 { f,8 g16[ a g a] }
979 @cindex notes d'ornement
980 @cindex ornementation
983 @subheading Grace notes
985 Glossaire musical : @rglos{grace notes}, @rglos{acciaccatura},
986 @rglos{appoggiatura}.
988 Des @notation{notes d'ornement} s'obtiennent en appliquant la commande
989 @code{\grace}, @code{\appoggiatura} ou @code{\acciaccatura} à une
990 expression musicale :
992 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
993 c2 \grace { a32[ b] } c2
994 c2 \appoggiatura b16 c2
995 c2 \acciaccatura b16 c2
1000 Manuel de notation : @ruser{Grace notes}, @ruser{Tuplets},
1004 @node Multiple notes at once
1005 @section Multiple notes at once
1007 Cette section traite de situations où l'on a plus d'une note à la fois :
1008 plusieurs instruments, plusieurs voix ou portées pour un même
1009 instrument (le piano, par exemple), et les accords.
1011 En théorie musicale, la polyphonie désigne une musique constituée de
1012 plusieurs voix ; dans LilyPond, ce terme désigne les situations où il
1013 y a plus d'une voix sur une même portée.
1016 * Music expressions explained::
1019 * Combining notes into chords::
1020 * Single staff polyphony::
1024 @node Music expressions explained
1025 @subsection Music expressions explained
1027 @cindex expression musicale
1029 Dans les fichiers source LilyPond, la musique est représentée par ce
1030 qu'on appelle des @emph{expressions musicales}. En soi, une seule note
1031 peut constituer une expression musicale :
1033 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
1037 Mettre un groupe de notes entre accolades crée une nouvelle expression
1038 musicale, appelée @emph{expression musicale composée}. En voici un
1039 exemple avec deux notes :
1041 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
1045 La mise entre accolades d'une séquence d'expressions musicales --- des
1046 notes par exemple --- signifie qu'elles doivent être jouées
1047 successivement, les unes après les autres. Le résultat est une
1048 expression, qui peut elle-même être regroupée séquentiellement avec
1049 d'autres expressions. Ici, l'expression de l'exemple précédent est
1050 combinée à deux notes :
1052 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
1057 @subheading Analogy: mathematical expressions
1059 Ce mécanisme est similaire aux formules mathématiques : une grosse
1060 formule est créée en assemblant plusieurs petites formules. De telles
1061 formules sont appelées expressions, elles ont une définition
1062 récursive, de telle sorte que vous pouvez fabriquer des expressions
1063 arbitrairement longues et complexes. Par exemple :
1072 ((1 + 2) * 3) / (4 * 5)
1075 Ceci est une suite d'expressions, où chacune est contenue dans la
1076 suivante. Les expressions les plus simples sont les nombres, et de
1077 plus grandes expressions sont produites en combinant des expressions
1078 avec des opérateurs --- comme @samp{+}, @samp{*} et @samp{/} --- et
1079 des parenthèses. Tout comme les expressions mathématiques, les
1080 expressions musicales peuvent être imbriquées avec une profondeur
1081 arbitraire, ce qui est nécessaire pour des partitions complexes comme
1082 de la musique polyphonique.
1085 @subheading Simultaneous music expressions: multiple staves
1087 Glossaire musical : @rglos{polyphony}.
1089 Cette technique est utile pour de la musique @notation{polyphonique}.
1090 Pour entrer une musique avec plusieurs voix ou plusieurs portées, nous
1091 pouvons aussi combiner @emph{en parallèle} les expressions : deux voix
1092 qui doivent être jouées en même temps, sont entrées comme une
1093 combinaison simultanée de deux expressions. Une expression musicale
1094 @qq{simultanée} est formée en entourant les expressions entre @code{<<}
1095 et @code{>>}. Dans l'exemple suivant, trois expressions (contenant
1096 chacune deux notes distinctes) sont combinées simultanément.
1098 @lilypond[quote,ragged-right,verbatim]
1108 Notez que nous avons ici indenté chaque niveau du fichier d'entrée
1109 avec un nombre d'espaces différent. LilyPond se moque --- ou presque
1110 --- de l'espace qu'il peut y avoir ou non au début d'une ligne, mais
1111 un code bien indenté est bien plus lisible par des humains.
1113 @warning{la hauteur de chaque note saisie est relative à la précédente,
1114 mais pas au @code{c''} de la commande @code{\relative} de départ.}
1117 @subheading Simultaneous music expressions: single staff
1119 Pour déterminer le nombre de portées, LilyPond regarde le début
1120 de la première expression. Si c'est une seule note, une seule portée
1121 est produite ; si c'est une expression simultanée, plusieurs portées
1124 @lilypond[quote,ragged-right,verbatim]
1127 << { e f } { c <<b d>> } >>
1132 @node Multiple staves
1133 @subsection Multiple staves
1135 Comme nous l'avons vu dans @ref{Music expressions explained}, un
1136 fichier d'entrée LilyPond est fait d'expressions musicales. Si la
1137 partition commence par plusieurs expressions simultanées, LilyPond
1138 créera plusieurs portées. Cependant, il est plus facile de prévoir le
1139 nombre de portées si on les crée explicitement, ce que nous allons
1142 Pour créer plus d'une portée, on ajoute @code{\new Staff} au début de
1143 chaque partie de la musique constituant une portée. Ces éléments
1144 @code{Staff} sont ensuite combinés en parallèle avec @code{<<} et
1145 @code{>>}, comme ci-dessous.
1147 @lilypond[quote,ragged-right,verbatim]
1150 \new Staff { \clef treble c }
1151 \new Staff { \clef bass c,, }
1157 La commande @code{\new} introduit un @qq{contexte de notation}. Un
1158 contexte de notation est un environnement dans lequel les événements
1159 musicaux --- comme les notes ou les commandes @code{\clef} --- sont
1160 interprétés. Pour des pièces simples, ces contextes sont créés
1161 automatiquement. Pour des pièces plus complexes, il est préférable de
1162 spécifier explicitement les contextes, afin de s'assurer que chaque
1163 fragment aura sa propre portée.
1165 Il existe différents types de contextes. Les contextes @code{Score}
1166 (partition), @code{Staff} (portée) et @code{Voice} (voix) gèrent la
1167 notation de la mélodie, alors que @code{Lyrics} gère les paroles et
1168 @code{ChordNames} imprime des noms d'accords.
1170 En termes de syntaxe, ajouter @code{\new} devant une expression
1171 musicale crée une plus grande expression musicale. En reprenant la
1172 comparaison précédente, cela ressemble au signe @emph{moins} en
1173 mathématiques. La formule @math{(4+5)} est une expression, donc
1174 @math{-(4+5)} est une plus grande expression.
1176 Les chiffres de métrique indiqués sur une portée affectent toutes les
1177 autres portées@footnote{Ce comportement peut être modifié si
1178 nécessaire, voir @ruser{Polymetric notation}.}. En revanche l'armure
1179 d'une portée n'affecte @emph{pas} les autres portées. Ces
1180 caractéristiques par défaut se justifient par le fait que
1181 l'utilisation d'instruments transpositeurs est bien plus fréquente que
1182 la musique polyrythmique.
1184 @lilypond[verbatim,quote]
1187 \new Staff { \clef treble \time 3/4 c }
1188 \new Staff { \clef bass \key d \major c,, }
1195 @subsection Staff groups
1197 @cindex portée double
1198 @cindex portée pour piano
1199 @cindex piano, portée pour
1200 @cindex clavier, portée pour
1202 Glossaire musical : @rglos{brace}.
1204 La musique pour piano s'écrit sur deux portées reliées par une
1205 @notation{accolade}. La gravure de ce type de portée est semblable à
1206 l'exemple de musique polyphonique de @ref{Multiple staves}, mais
1207 maintenant cette expression entière est interprétée dans un contexte
1217 Voici un bref exemple :
1219 @lilypond[quote,ragged-right,verbatim]
1222 \new Staff { \time 2/4 c4 e g g, }
1223 \new Staff { \clef bass c,, c' e c }
1230 Manuel de notation : @ruser{Keyboard instruments},
1231 @ruser{Displaying staves}.
1234 @node Combining notes into chords
1235 @subsection Combining notes into chords
1237 @cindex accords, notes simultanées
1239 Glossaire musical : @rglos{chord}.
1241 Nous avons vu précédemment comment combiner des notes simultanément,
1242 en les encadrant par des angles doubles @code{<<} et @code{>>}. Pour
1243 produire des accords simples, c'est-à-dire une superposition de notes
1244 de même durée, on encadre les hauteurs de notes par des angles simples
1245 @code{<} et @code{>}, et on écrit la durée juste après.
1247 @lilypond[verbatim,quote,relative=2]
1248 r4 <c e g>4 <c f a>2
1251 Beaucoup d'éléments de notation que l'on peut attacher à une note
1252 simple, comme une liaison, un crochet indiquat un début ou fin de
1253 lien, un signe d'articulation, peuvent être également attachés à un
1254 accord : il faut ajouter ces indications après les hauteurs et la
1255 durée, donc @emph{à l'extérieur} des angles.
1257 @lilypond[verbatim,quote,relative=2]
1258 r4 <c e g>8[ <c f a>]~ <c f a>2
1259 r4 <c e g>8( <c e g>\> <c e g>4 <c f a>\!)
1263 @node Single staff polyphony
1264 @subsection Single staff polyphony
1267 @cindex voix multiples sur une portée
1268 Quand différentes lignes mélodiques sont combinées sur une seule et même
1269 portée, elles sont imprimées comme des voix polyphoniques ; chaque voix
1270 a ses propre hampes@footnote{familièrement appelées queues de note.},
1271 liaisons et ligatures, la voix supérieure ayant les hampes vers le haut,
1272 la voix inférieure vers le bas.
1274 On réalise ce type de partition en entrant chaque voix comme une
1275 séquence, @emph{i.e.} avec @code{@{...@}}, puis en combinant
1276 simultanément les voix et en les séparant par @code{\\}.
1278 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
1285 Pour l'écriture de musique polyphonique, les silences invisibles
1286 s'avèrent bien pratiques : ce sont des silences qui ne s'impriment pas.
1287 Ils sont utiles pour remplir des voix qui, temporairement, ne jouent
1288 rien. Voici le même exemple que ci-dessus, avec un silence invisible
1289 @code{s} à la place d'un silence normal @code{r} :
1291 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
1299 Là encore, ces expressions peuvent s'imbriquer arbitrairement :
1301 @lilypond[quote,fragment,verbatim,relative=2,fragment]
1309 { <c g>1 ~ <c g>4 } \\
1317 Manuel de notation : @ruser{Simultaneous notes}.
1323 Cette section présente l'écriture vocale et les partitions de variété.
1326 * Setting simple songs::
1327 * Aligning lyrics to a melody::
1328 * Lyrics to multiple staves::
1332 @node Setting simple songs
1333 @subsection Setting simple songs
1338 Glossaire musical : @rglos{lyrics}.
1340 Prenons une mélodie toute simple, la comptine @emph{Girls and boys
1343 @lilypond[quote,ragged-right,verbatim]
1350 Des @notation{paroles} peuvent être associées à ces notes, en les
1351 combinant avec la commande @code{\addlyrics}. On entre les paroles en
1352 séparant chaque syllable par un espace :
1354 @lilypond[quote,ragged-right,verbatim]
1360 \addlyrics { One day this shall be free }
1364 Remarquez les accolades embrassant la musique et celles embrassant les
1365 paroles, ainsi que les angles doubles encadrant toute la pièce ; ces
1366 derniers indiquent simplement que la musique et les paroles se
1367 produisent en même temps.
1370 @node Aligning lyrics to a melody
1371 @subsection Aligning lyrics to a melody
1374 @cindex ligne d'extension
1375 @cindex trait d'union (paroles)
1376 @cindex caractère souligné (paroles)
1377 Glossaire musical : @rglos{melisma}, @rglos{extender line}.
1379 La ligne suivante de la comptine précédente est @emph{The moon doth
1380 shine as bright as day}. Ajoutons-la au code.
1382 @lilypond[verbatim,quote]
1387 d4 b8 c4 a8 d4 b8 g4
1388 g8 a4 b8 c b a d4 b8 g4.
1391 Girls and boys come out to play,
1392 The moon doth shine as bright as day;
1397 Remarquez que les paroles ajoutées ne s'alignent pas bien avec les
1398 notes. Le mot @emph{shine} devrait être chanté sur deux notes au lieu
1399 d'une. On appelle ceci un @notation{mélisme} : il s'agit d'une seule
1400 syllabe chantée sur plus d'une note. Il existe plusieurs façons
1401 d'étaler une sylabe sur plusieurs notes, la plus simple étant de lier
1402 les notes du mélisme. Pour les détails, consultez @ref{Ties and
1405 @lilypond[verbatim,quote]
1410 d4 b8 c4 a8 d4 b8 g4
1411 g8 a4 b8 c( b) a d4 b8 g4.
1414 Girls and boys come out to play,
1415 The moon doth shine as bright as day;
1420 Les paroles sont maintenant correctement alignées, mais les liens de
1421 croche automatiques ne conviennent pas pour les notes au-dessus de
1422 @emph{shine as}. On peut les corriger en ajoutant des liens de croche
1423 manuels, pour ceci consultez @ref{Automatic and manual beams}.
1425 @lilypond[verbatim,quote]
1430 d4 b8 c4 a8 d4 b8 g4
1431 g8 a4 b8 c([ b]) a d4 b8 g4.
1434 Girls and boys come out to play,
1435 The moon doth shine as bright as day;
1440 Au lieu d'utiliser une liaison, on peut indiquer le mélisme dans les
1441 paroles en insérant un caractère souligné @code{_} pour chaque note du
1442 mélisme sauf la première.
1444 @lilypond[verbatim,quote]
1449 d4 b8 c4 a8 d4 b8 g4
1450 g8 a4 b8 c[ b] a d4 b8 g4.
1453 Girls and boys come out to play,
1454 The moon doth shine _ as bright as day;
1459 Si une syllabe s'étend sur un grand nombre de notes ou une note très
1460 longue, on représente souvent le mélisme par un @notation{trait de
1461 prolongation}, qu'on entre avec @code{__}. L'exemple suivant montre
1462 les trois premières mesures de la plainte de Didon, extraite de
1463 @emph{Didon et Énée} de Purcell.
1465 @lilypond[verbatim,quote]
1471 b c4.( bes8 a4. g8 fis4.) g8 fis1
1475 am laid __ in earth,
1480 Aucun exemple jusqu'à présent n'a utilisé de mots de plus d'une
1481 syllabe. Dans des paroles, de tels mots sont écrits en syllabes
1482 séparées par des traits d'union. Avec LilyPond, on utilise deux
1483 tirets pour produire un trait d'union centré entre deux syllabes.
1484 L'exemple suivant montre tout ce que nous avons vu jusqu'à maintenant
1485 sur l'alignement de paroles à une mélodie.
1487 @c no ragged-right here because otherwise the hyphens get lost,
1488 @c but the example is long enough to avoid looking strange.
1489 @lilypond[verbatim,quote,noragged-right]
1495 d4 g4 g a8( b) g4 g4
1499 A -- way in a __ man -- ger,
1500 no __ crib for a bed, __
1505 Avec certaines paroles, en particulier en italien, il se produit la
1506 situation inverse : il peut y avoir plusieurs syllabes sur une seule
1507 note. On réalise ceci avec LilyPond grâce à un caractère souligné
1508 @code{_} sans espace entre les syllabes, ou alors en groupant les
1509 syllabes avec des guillemets. L'exemple suivant est extrait de l'air
1510 de Figaro @emph{Largo al factotum}, dans @emph{Figaro} de Rossini, où
1511 la syllabe @emph{al} est chantée sur la même note que @emph{go}.
1513 @c no ragged-right here because otherwise the hyphens get lost,
1514 @c but the example is long enough to avoid looking strange.
1515 @lilypond[verbatim,quote,noragged-right]
1521 c4.~ c8 d b c([ d]) b c d b c
1524 Lar -- go_al fac -- to -- tum del -- la cit -- tà
1531 Manuel de notation : @ruser{Vocal music}.
1534 @node Lyrics to multiple staves
1535 @subsection Lyrics to multiple staves
1537 La méthode simple d'ajout de paroles avec @code{\addlyrics} peut être
1538 également utilisée pour placer des paroles sous plusieurs portées.
1539 L'exemple suivant est extrait de @emph{Judas Macchabée} de Händel.
1541 @lilypond[verbatim,quote]
1547 c8 c([ bes]) a a([ g]) f f'4. b, c4.~ c4
1550 Let flee -- cy flocks the hills a -- dorn, __
1556 r8 r4. r4 c8 a'([ g]) f f([ e]) d e([ d]) c bes'4
1559 Let flee -- cy flocks the hills a -- dorn,
1564 Pour produire des partitions plus complexes ou plus longues que cet
1565 exemple simple, il est vivement conseillé de séparer la structure de
1566 la partition des notes et paroles, grâce à des variables. Ceci sera
1567 détaillé plus loin dans @ref{Organizing pieces with variables}.
1571 Manuel de notation : @ruser{Vocal music}.
1576 @section Final touches
1578 L'ultime section de ce tutoriel montre comment ajouter une touche
1579 finale à des morceaux simples, et constitue une introduction au reste
1583 * Organizing pieces with variables::
1586 * Absolute note names::
1587 * After the tutorial::
1591 @node Organizing pieces with variables
1592 @subsection Organizing pieces with variables
1594 Lorsque l'on combine tous les éléments étudiés précédemment pour
1595 écrire des partitions plus longues, les expressions musicales prennent
1596 de l'ampleur et, dans le cas des pièces polyphoniques, deviennent
1597 profondément imbriquées, jusqu'au point où il devient difficile de se
1598 repérer dans le fichier source. Cet inconvénient peut être résolu par
1599 l'utilisation de @emph{variables}.
1601 En utilisant des variables, parfois appelées identificateurs ou
1602 macros, on peut scinder des expressions musicales complexes en des
1603 expressions plus simples. Une variable se définit comme suit :
1606 musiqueToto = @{ @dots{} @}
1609 Le contenu de l'expression musicale @code{musiqueToto} pourra être
1610 utilisé plus loin en faisant précéder son nom d'un anti-slash,
1611 c'est-à-dire @code{\musiqueToto}, tout comme n'importe quelle commande
1612 LilyPond. Toute variable doit être définie @emph{avant} son
1613 utilisation dans une autre expression musicale.
1615 @lilypond[quote,verbatim,ragged-right]
1616 violin = \new Staff { \relative c'' {
1619 cello = \new Staff { \relative c {
1632 Le nom d'une variable ne doit comporter que des caractères
1633 alphabétiques non accentués, aucun nombre ni tiret ne sont autorisés.
1635 On peut utiliser une variable déjà définie autant de fois que l'on
1636 veut, y compris dans la définition d'une nouvelle variable ; par
1637 exemple, cela peut servir à saisir un motif qu'une seule fois, même
1638 s'il se répète un grand nombre de fois dans la pièce.
1640 @lilypond[verbatim,quote]
1641 tripletA = \times 2/3 { c,8 e g }
1642 barA = { \tripletA \tripletA \tripletA \tripletA }
1649 Il est possible d'utiliser des variables de types variés. Par exemple,
1654 aFivePaper = \paper @{ paperheight = 21.0 \cm @}
1657 En fonction de son contenu, un identificateur peut être utilisé à
1658 différents endroits. L'exemple suivant utilise les variable définies
1670 @node Version number
1671 @subsection Version number
1674 La déclaration @code{\version} stipule le numéro de la version de
1675 LilyPond pour laquelle le fichier a été écrit :
1678 \version @w{"@version{}"}
1682 Par convention, on place cette instruction en début de fichier.
1684 Cette instruction permet de faciliter les mises à jour futures de
1685 LilyPond. Les changements de syntaxe au fil des versions sont gérés
1686 avec un programme dédié, @command{convert-ly}, qui utilise la valeur
1687 de @code{\version} pour déterminer les règles de conversion à
1688 appliquer au fichier source. Pour plus d'informations, consultez voir
1689 @rprogram{Updating files with convert-ly}.
1693 @subsection Adding titles
1695 On indique les informations bibliographiques --- nom du morceau, du
1696 compositeur, numéro d'opus... --- dans un bloc à part, le bloc
1697 d'en-tête @code{\header}, qui existe indépendamment de l'expression
1698 musicale principale. Le bloc @code{\header} est habituellement placé
1699 en début de fichier, après le numéro de version.
1702 \version @w{"@version{}"}
1710 @dots{} la musique @dots{}
1714 Quand LilyPond traite le fichier, le titre et le compositeur sont
1715 imprimés au début de la partition. Vous trouverez plus d'informations
1716 sur les titres à la section @ruser{Creating titles}.
1719 @node Absolute note names
1720 @subsection Absolute note names
1722 Jusqu'ici nous n'avons utilisé que le mode @code{\relative} pour
1723 définir les hauteurs de notes. Si c'est souvent le moyen le plus
1724 simple de saisir la musique au clavier, il existe une autre façon de
1725 procéder : le mode de hauteurs absolues.
1727 Si vous omettez la commande @code{\relative}, LilyPond considérera
1728 toutes les hauteurs comme des hauteurs absolues. Un @code{c'} désigne
1729 toujours le do central, un @code{b} se situe une seconde en dessous
1730 du do central, et un @code{g,} est situé sur la première ligne de
1731 la portée en clé de fa.
1733 @lilypond[quote,verbatim,ragged-right]
1741 Voici une gamme sur 4 octaves :
1743 @lilypond[quote,verbatim,ragged-right]
1758 Comme vous pouvez le voir, il faut beaucoup d'apostrophes pour écrire
1759 de la musique dans un registre aigu, comme le montre cet extrait de
1762 @lilypond[quote,verbatim,ragged-right]
1766 cis''8. d''16 cis''8 e''4 e''8
1767 b'8. cis''16 b'8 d''4 d''8
1771 Toutes ces apostrophes rendent le fichier moins lisible, et surtout il
1772 est très probable d'oublier au moins une apostrophe au cours de la
1773 frappe. En mode @code{\relative}, le même exemple devient bien plus
1774 facile à lire et à saisir.
1776 @lilypond[quote,verbatim,ragged-right]
1780 cis8. d16 cis8 e4 e8
1785 Si d'aventure vous faites une erreur d'octaviation, le mode
1786 @code{\relative} la mettra en évidence : toutes les notes suivantes
1787 seront placées à la mauvaise octave. En mode de hauteurs absolues,
1788 une erreur isolée ne serait pas autant visible, donc serait plus
1789 difficile à dénicher.
1791 Cependant, le mode de hauteurs absolues reste utile pour les musiques
1792 où les intervalles sont étendus, et plus encore pour les fichiers
1793 LilyPond créés par des programmes.
1796 @node After the tutorial
1797 @subsection After the tutorial
1799 Après avoir parcouru ce tutoriel, vous devriez essayer d'écrire un
1800 morceau ou deux. Commencez par copier l'un des modèles types et
1801 ajoutez-y des notes --- consultez les @ref{Templates}. Si vous voulez
1802 employer une notation que vous n'avez pas trouvé dans le tutoriel,
1803 consultez le manuel de notation, en commençant par la @ruser{Musical
1804 notation}. Si vous désirez écrire pour un ensemble instrumental non
1805 couvert par les modèles, lisez la section @ref{Extending the
1808 Après avoir écrit quelques pièces courtes, lisez les chapitres 3 à 5
1809 du manuel d'initiation. Rien ne s'oppose à ce que vous consultiez dès
1810 à présent ces chapitres, bien sûr ! Néanmoins, le reste du manuel
1811 d'initiation part du principe que vous avez déjà bien assimilé la
1812 syntaxe de base de LilyPond. Vous pouvez toujours survoler ces
1813 chapitres 3 à 5, et y revenir plus tard après avoir acquis de
1816 Si vous ne l'avez pas encore fait, lisez @ref{About the
1817 documentation}. Les sources de documentation et d'information sur
1818 LilyPond sont vastes, il est normal pour un débutant de ne pas savoir
1819 où chercher ; si vous passez quelques minutes à lire attentivement
1820 cette section, vous vous épargnerez certainement la frustration causée
1821 par des heures de recherche infructueuses.