1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
3 Translation of GIT committish: 7eee2a7382029cc29cc069f93a431758ae8a13b7
5 When revising a translation, copy the HEAD committish of the
6 version that you are working on. See TRANSLATION for details.
12 Tutorial guidelines: (different from policy.txt!)
13 - unless you have a really good reason, use either
14 @lilypond[verbatim,quote]
16 @lilypond[verbatim,quote,relative=2]
18 Don't use any other relative=X commands.
20 - use "aes" and "ees" instead of "as" and "es". I know it's not
21 correct Dutch naming, but let's not confuse people with this
22 until we get to the Basic notation chapter.
24 - Add "Music Glossary: @rglos{foo}" to the *top* of the relevant
25 portions of the tutorial.
30 @c Translators: Nicolas Grandclaude, Ludovic Sardain, Gauvain Pocentek
31 @c Translation checkers: Jean-Charles Malahieude, Valentin Villenave, John Mandereau
32 @c Translation status: post-GDP
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 input files::
61 * How to read the manual::
65 @node Compiling a file
66 @subsection Compiling a file
69 @cindex exemple, premier
70 @cindex premier exemple
72 Pour créer une partition avec LilyPond, on écrit un fichier texte,
73 appelé fichier source, qui décrit la notation musicale. La
74 @emph{compilation} de ce fichier source par LilyPond produit un
75 fichier graphique imprimable, et si on le désire un fichier MIDI qui
76 peut être joué par un séquenceur.
78 Voici un premier exemple simple de fichier source LilyPond.
87 La compilation de ce fichier donnera quelque chose de sembable à
90 @c in this case we don't want verbatim
98 Il est aussi possible d'utiliser les noms de notes français @qq{@w{do
99 re mi fa sol la si}}, en insérant au début du fichier la ligne
100 @code{\include@tie{}"italiano.ly"}.
103 @warning{Tout extrait de code LilyPond doit être entouré d'une
104 @strong{@{ paire d'accolades @}}. De plus, pour éviter toute
105 ambiguïté, il est préférable d'entourer les accolades par des espaces
106 ou retours à la ligne. Bien que certains exemples de ce manuel ne
107 comportent pas d'accolades, ne les oubliez pas dans vos partitions !
108 Pour plus d'informations sur l'affichage des exemples de cette
109 documentation, consultez @ref{How to read the manual}.}
112 @cindex casse, prise en compte de la
113 @cindex prise en compte de la casse
114 @cindex sensibilité à la casse
116 De plus, LilyPond est @strong{sensible à la casse} : le code
117 @w{@code{@{ c d e @}}} est valide, alors que @w{@code{@{ C D E @}}}
118 produira un message d'erreur.
122 @subheading Entering music and viewing output
126 @cindex partition, lire
127 @cindex lire la partition
128 @cindex éditeurs de texte
129 @cindex LilyPond et MacOS X
130 @cindex MacOS X et LilyPond
131 @cindex LilyPond et Windows
132 @cindex Windows et LilyPond
133 @cindex LilyPond et Unix
134 @cindex Unix et LilyPond
136 Dans cette section nous expliquerons quelles commandes exécuter et
137 comment voir ou imprimer le résultat produit par LilyPond.
139 Notez qu'il existe plusieurs éditeurs de texte disponibles avec un bon
140 support de LilyPond ; consultez @rprogram{Text editor support}.
142 @warning{Le premier démarrage de LilyPond peut prendre une minute ou
143 deux, afin de générer la liste des polices du système. LilyPond démarre
144 en principe plus rapidement lors des exécutions suivantes.}
147 @subsubheading MacOS X
149 Si vous double-cliquez sur @code{LilyPond.app}, un fichier d'exemple
150 s'ouvrira. Sauvegardez-le, par exemple, sous @file{test.ly} sur votre
151 bureau, puis traitez-le avec la commande de menu
152 @w{@code{Compile > Typeset File}}. Le fichier PDF résultant sera alors
155 À l'avenir, vous aurez certainement recours aux commandes @qq{Nouveau}
156 ou @qq{Ouvrir}. Vous devez enregistrer votre fichier avant de lancer
157 la gravure de la partition par LilyPond. Si une erreur apparaît
158 pendant le traitement, vous la trouverez dans la fenêtre @qq{log}.
160 @subsubheading Windows
162 Sous Windows, double-cliquez sur l'icône LilyPond qui se trouve sur le
163 bureau, un fichier d'exemple s'ouvre dans un simple éditeur de texte.
164 Enregistrez-le, par exemple en tant que @file{test.ly} sur le bureau,
165 puis double-cliquez sur son icône (qui montre une note de musique)
166 pour le traiter. Après quelques secondes, vous obtiendrez un fichier
167 @file{test.pdf} sur le bureau, fichier que vous pourrez ouvrir pour
168 voir la partition gravée. Une autre méthode pour lancer le traitement
169 du fichier @file{test.ly} est de le glisser avec votre souris sur
172 Pour modifier un fichier @file{.ly} existant, faites un clic droit
173 dessus et sélectionnez @qq{Éditer la source}. Pour partir d'un
174 fichier vide, lancez l'éditeur en ouvrant un fichier existant et
175 utilisez la commande @qq{New} du menu @qq{File}.
177 En double-cliquant sur le fichier, vous obtiendrez, en plus du fichier
178 PDF, un fichier @file{.log} qui récapitule les opérations que LilyPond
179 a effectuées sur votre fichier. Si une erreur survient, vous en
180 trouverez les détails dans ce fichier.
184 Créez un fichier texte @file{test.ly} qui contient
193 Pour traiter @file{test.ly}, entrez la commande suivante dans un
201 Vous verrez quelque chose ressemblant à
205 GNU LilyPond @version{}
206 Traitement de « test.ly »
208 Interprétation en cours de la musique...
209 Pré-traitement des éléments graphiques...
210 Détermination du nombre optimal de pages...
211 Répartition de la musique sur une page...
212 Dessin des systèmes...
213 Sortie mise en page vers « test.ps »...
214 Conversion à « ./test.pdf »...
219 Suivant votre installation, ces messages peuvent être traduits ou
224 @node Simple notation
225 @subsection Simple notation
227 @cindex simple, notation
228 @cindex notation simple
230 Il y a certains éléments graphiques de notation que LilyPond ajoute
231 automatiquement. Dans l'exemple suivant, nous n'avons fourni que
232 quatre hauteurs, mais LilyPond a ajouté une clef, un chiffre de mesure
235 @lilypond[verbatim,quote]
242 Ces valeurs automatiques simplifient la saisie du code source dans
243 bien des cas ; nous verrons plus loin comment les indiquer
253 @cindex altérations et mode relatif
254 @cindex mode relatif et altérations
261 Glossaire musical : @rglos{pitch}, @rglos{interval},
262 @rglos{scale}, @rglos{middle C}, @rglos{octave},
265 Le moyen le plus simple d'entrer des notes est d'utiliser le mode
266 d'octaves relatives, ou mode @code{\relative}. Dans ce mode, l'octave
267 de chaque note est sélectionnée automatiquement de façon à ce qu'elle
268 soit la plus proche possible de la note précédente, c'est-à-dire de
269 façon à ce que l'intervalle avec la note précédente soit au plus d'une
270 quarte. Commençons par saisir une partition très simple, à savoir une
273 @lilypond[verbatim,quote]
274 % set the starting point to middle C
281 La note de départ est le @notation{do central}. Chacune des notes qui
282 suivent est placée à l'octave la plus proche de la note précédente ---
283 en d'autres termes, le premier @code{c} est le do central, entre la
284 clef de sol et la clef de fa, puis est suivi par le ré le plus proche,
285 et ainsi de suite. On peut bien sûr créer des mélodies avec de plus
286 grands intervalles, toujours avec le mode @code{\relative} :
288 @lilypond[verbatim,quote]
296 Remarquez que cet exemple ne commence plus sur le do central : la
297 première note --- le @code{d} --- est le ré qui en est le plus proche.
299 Dans l'exemple suivant, on remplace @code{c'} dans la commande
300 @code{@w{\relative c' @{}} par @code{c''}, afin de calculer l'octave de
301 la première note par rapport au do situé une octave au-dessus du do
304 @lilypond[verbatim,quote]
305 % one octave above middle C
311 Le mode d'octaves relatives peut être déroutant au début, mais c'est
312 souvent la façon la plus économique de saisir les hauteurs en
313 utilisant le clavier de l'ordinateur de façon classique. Détaillons
314 dans un exemple le calcul des octaves relatives. En partant d'un si
315 sur la troisième ligne de la clé de sol, un do, un ré ou un mi sans
316 indication d'octave particulière seront placés juste au-dessus du si,
317 c'est-à-dire au plus à une quarte ascendante du si, alors qu'un la, un
318 sol ou un fa seront placés juste en-dessous du si, c'est-à-dire au
319 plus à une quarte descendante du si.
321 @lilypond[verbatim,quote]
323 b c % c is 1 staff space up, so is the c above
324 b d % d is 2 up or 5 down, so is the d above
325 b e % e is 3 up or 4 down, so is the e above
326 b a % a is 6 up or 1 down, so is the a below
327 b g % g is 5 up or 2 down, so is the g below
328 b f % f is 4 up or 3 down, so is the f below
332 Notez que le calcul des octaves relatives @strong{ne tient pas compte
333 des altérations} des notes, dièses bémols ou bécarre.
335 Pour obtenir des intervalles supérieurs à une quarte, on peut ajouter
336 des apostrophes @code{'} --- qui font chacune monter la hauteur d'une
337 octave --- ou des virgules @code{,} --- qui font chacune descendre la
338 hauteur d'une octave --- au nom de la note.
340 @lilypond[verbatim,quote]
348 Pour déplacer une note deux octaves (ou davantage !) plus haut ou plus
349 bas, il suffit de mettre deux (ou davantage) @code{'} ou @code{,} ---
350 attention cependant à bien mettre deux apostrophes @code{''}, et non
351 un guillemet @code{"}@tie{}! C'est de cette même manière que l'on
352 peut modifier la valeur de départ de @code{@w{\relative c'}}.
355 @subheading Durées et rythme
364 @cindex spécification des durées
366 Glossaire musical : @rglos{beam}, @rglos{duration},
367 @rglos{whole note}, @rglos{half note}, @rglos{quarter note},
370 La @notation{durée} d'une note est indiquée par un nombre qui suit sa
371 hauteur : @code{1} pour une @notation{ronde}, @code{2} pour une
372 @notation{blanche}, @code{4} pour une @notation{noire} et ainsi de
373 suite. Les @notation{crochets} et @notation{liens} sont ajoutés
376 Si aucune durée n'est indiquée pour une note, la dernière durée entrée
377 est utilisée. En l'absence d'indication de durée, la première note
380 @lilypond[verbatim,quote]
384 a16 a a a a32 a a a a64 a a a a a a a a2
388 Une @notation{note pointée} s'obtient en ajoutant un point @code{.} à
389 la valeur rythmique. Le point doit être précédé d'un nombre spécifiant
392 @lilypond[verbatim,quote]
403 @cindex notation des silences
405 Glossaire musical : @rglos{rest}.
407 On saisit un @notation{silence} tout comme une note, mais avec la
408 lettre @code{r} (pour @emph{rest}).
410 @lilypond[verbatim,quote]
421 @cindex chiffre de mesure
426 Glossaire musical : @rglos{time signature}.
428 La @notation{métrique}, aussi appelée @notation{chiffre de mesure},
429 peut être définie à l'aide de la commande @code{\time} :
431 @lilypond[verbatim,quote]
454 Glossaire musical : @rglos{clef}.
456 La @notation{clef} peut être définie à l'aide de la commande
459 @lilypond[verbatim,quote]
473 @subheading Tout ensemble
475 Voici un bref exemple qui rassemble tous les éléments que nous déjà
478 @lilypond[verbatim,quote]
489 Manuel de notation : @ruser{Writing pitches},
490 @ruser{Writing rhythms}, @ruser{Writing rests},
491 @ruser{Time signature}, @ruser{Clef}.
494 @node Working on input files
495 @subsection Working on input files
497 Le traitement des fichiers source de LilyPond est semblable à celui du
498 code de nombreux langages de programmation. La casse est prise
499 en compte, et les caractères considérés comme espaces ont généralement
500 peu d'importance. Les expressions sont délimitées par des accolades @{
501 @}, et les commentaires par @code{%} ou @code{%@{ ... %@}}.
503 Si cette phrase vous paraît incompréhensible, ne vous en faites pas !
504 Expliquons tous ces termes :
508 @cindex casse, prise en compte de
509 @cindex prise en compte de la casse
510 @cindex sensibilité à la casse
514 LilyPond est sensible à la casse, c'est à dire qu'une lettre capitale
515 n'a pas la même valeur qu'une lettre minuscule. Les notes, par
516 exemple, doivent être entrées en minuscule : @code{@{ c d e @}} est
517 un code valide, alors que @code{@{ C D E @}} produira un message
520 @cindex espaces multiples, insensibilité
521 @cindex insensibilité aux espaces multiples
523 @item @strong{Les espaces multiples} :
524 LilyPond ne tient pas compte du nombre d'espaces, ou de retours à la
525 ligne. @code{@{ c d e @}} a le
526 même sens que @code{@{ c @tie{} @tie{} d @tie{} e @}} ou que
534 Bien sûr, ce dernier exemple est illisible. Une bonne habitude
535 à prendre est d'indenter les blocs de code avec soit des tabulations
536 soit des doubles espaces :
548 @item @strong{Expressions musicales} :
549 Tout morceau saisi dans LilyPond doit être placé entre @strong{@{
550 accolades @}}. Ces caractères indiquent à LilyPond que ce bloc de
551 texte représente une et une seule expression musicale, tout comme les
552 parenthèses @code{()} en mathématiques. Pour éviter toute ambiguïté,
553 il est préférable d'entourer ces accolades d'espaces ou de retours à
556 Un appel de fonction --- @w{@code{\relative @{ @}}} par exemple ---
557 compte également comme une seule expression musicale.
560 @cindex commentaire de fin de ligne
561 @cindex commentaire-bloc
562 @cindex bloc de commentaire
565 @funindex %@{ ... %@}
567 @item @strong{Les commentaires} :
568 Un commentaire est une indication pour tout lecteur humain d'un
569 fichier source de musique ; il est ignoré par l'ordinateur, et n'a
570 donc aucun effet sur la partition imprimée. On distingue deux types
571 de commentaires. Le commentaire de fin de ligne, introduit par le
572 symbole @code{%} : tout ce qui suit ce symbole sur la même ligne sera
573 ignoré. Par convention, un commentaire qui occupe une ligne entière
574 se place juste @emph{au-dessus} de la ligne à laquelle il fait
579 % ce commentaire fait référence aux si
583 Le bloc de commentaire, qui peut occuper plusieurs lignes, voire toute
584 une section : tout ce qui se trouve entre @code{%@{} et @code{%@}} est
585 ignoré. Les blocs de commentaires ne peuvent s'imbriquer, ce qui
586 signifie que vous ne pouvez pas placer un commentaire-bloc à
587 l'intérieur d'un autre commentaire-bloc. Si jamais vous essayez, vous
588 verrez que la première occurence de @code{%@}} terminera @qq{les
589 @emph{deux} commentaires-blocs}. Le fragment suivant met en évidence
590 quelques usages possibles des commentaires :
593 % voici les notes de "ah vous dirai-je maman"
597 Ces lignes et les notes qui suivent
598 seront ignorées, car elles se trouvent
599 dans un bloc de commentaire.
609 @node How to read the manual
610 @subsection How to read the manual
612 @cindex bien lire le manuel
613 @cindex manuel, lecture
614 @cindex compulser le manuel
615 @cindex exemples cliquables
616 @cindex cliquables, exemples
617 @cindex conseils de construction des fichiers
619 @cindex construction des fichiers, conseils
620 @cindex fichiers, conseils de construction
622 Comme nous l'avons vu dans @ref{Working on input files}, un code
623 LilyPond doit être encadré par des accolades @{ @} ou bien par
624 @code{@w{\relative c'' @{ ... @}}}. Cependant, dans la suite de ce
625 manuel, la plupart des exemples ne feront pas apparaître ces signes.
627 Pour reproduire les exemples, vous pouvez copier et coller le code
628 affiché, mais @strong{à condition} d'ajouter
629 @code{@w{\relative c'' @{ @}}} de la façon suivante :
633 ...collez ici votre exemple...
637 Pourquoi avoir omis les accolades ? La plupart des exemples de ce
638 manuel peuvent être insérés au milieu d'un morceau de musique plus
639 long. Il n'y a donc aucune raison d'ajouter @code{@w{\relative c'' @{
640 @}}} à ces exemples --- en effet, il n'est pas possible d'insérer une
641 expression @code{\relative} à l'intérieur d'un autre expression
642 @code{\relative}. Si nous mettions tous nos exemples dans une
643 expression @code{\relative}, vous ne pourriez plus copier un bref
644 exemple de la documentation pour le coller dans vos pièces.
647 @subheading Exemples cliquables
649 Beaucoup de gens apprennent à utiliser les programmes en les essayant
650 et en bidouillant avec. C'est également possible avec LilyPond. Si
651 vous cliquez sur une image dans la version HTML de ce manuel, vous
652 verrez exactement le code LilyPond utilisé pour générer cette image.
653 Essayez sur cette image :
657 @lilypond[quote,ragged-right]
659 c-\markup { \bold \huge { Cliquez ici. } }
663 En copiant-collant le code à partir du commentaire @qq{ly snippet}
664 vers un fichier test, vous aurez un modèle de base pour faire vos
665 expériences. Pour obtenir une gravure à l'identique, copiez tout le
666 code à partir de @qq{Start cut-&-pastable section}.
668 @c No longer in the text in English, but should we really
671 Si vous apprenez de cette façon, vous aurez probablement envie
672 d'imprimer ou de garder un lien vers @ruser{Cheat sheet}, tableau
673 qui répertorie les commandes usuelles pour une consultation rapide.
678 Vous trouverez plus de conseils pour construire des fichiers source
679 dans @ref{Suggestions for writing LilyPond input files}. Cependant,
680 lors d'une première lecture il est préférable de terminer d'abord la
684 @node Single staff notation
685 @section Single staff notation
687 Cette section présente la notation courante dont on a besoin pour
688 écrire une voix sur une portée.
691 * Accidentals and key signatures::
693 * Articulation and dynamics::
695 * Automatic and manual beams::
696 * Advanced rhythmic commands::
700 @node Accidentals and key signatures
701 @subsection Accidentals and key signatures
703 @subheading Accidentals
708 @cindex dièse, double
711 @cindex bémol, double
718 Glossaire musical : @rglos{sharp}, @rglos{flat}, @rglos{double sharp},
719 @rglos{double flat}, @rglos{accidental}.
721 Dans la notation par défaut, on obtient un @notation{dièse} en
722 ajoutant @code{is} au nom de la note, et un @notation{bémol} en
723 ajoutant @code{es}. Comme vous pouvez vous y attendre, un double
724 dièse ou double bémol s'obtiennent en ajoutant @code{isis} ou
725 @code{eses}. Cette syntaxe est dérivée de la convention de
726 dénomination des notes dans les langues nordiques et germaniques,
727 comme l'allemand ou le hollandais.
730 Cependant, si vous utilisez la commande
731 @code{@w{\include@tie{}"italiano.ly"}} pour entrer les noms de notes
732 français au lieu des noms hollandais, il faudra ajouter un @code{d} pour
733 obtenir un dièse, et un @code{b} pour un bémol. Le double dièse et le
734 double bémol s'obtiennent en ajoutant respectivement @code{dd} et
735 @code{bb}. Pour en savoir plus sur les autres langues disponibles,
736 consultez @ruser{Note names in other languages}.
739 @lilypond[verbatim,quote,relative=2]
740 cis1 ees fisis, aeses
743 @subheading Key signatures
745 @cindex armure, définition de l'
746 @cindex armure, altérations à l'
747 @cindex altérations à l'armure
758 Glossaire musical : @rglos{key signature}, @rglos{major},
761 L'armure est déterminée par la commande @code{\key}, suivie d'une
762 hauteur puis de @code{\major} (majeur) ou @code{\minor} (mineur).
764 @lilypond[verbatim,quote,relative=2]
773 @subheading Warning: key signatures and pitches
775 Glossaire musical : @rglos{accidental}, @rglos{key signature},
776 @rglos{pitch}, @rglos{flat}, @rglos{natural}, @rglos{sharp},
777 @rglos{transposition}.
779 La combinaison de l'@notation{armure} et des hauteurs de note --- y
780 compris les altérations --- permet à LilyPond de déterminer dans quel
781 cas imprimer des @notation{altérations accidentelles}. L'armure
782 n'affecte que les altérations @emph{imprimées}, et non les hauteurs
783 réelles ! Cette fonctionnalité est souvent source de confusion pour
784 les nouveaux utilisateurs, aussi expliquons-la en détail.
786 LilyPond fait une distinction nette entre le contenu musical et la
787 mise en forme. L'altération d'une note --- @notation{bémol},
788 @notation{bécarre} ou @notation{dièse} --- fait partie de sa hauteur,
789 et relève donc du contenu musical. La gravure ou non d'une altération
790 accidentelle --- un @emph{signe} bémol, bécarre ou dièse --- devant la
791 note correspondante est une question qui relève de la mise en forme.
792 La gravure d'une partition suit des règles, en particulier des règles
793 d'indication des altérations accidentelles. Les hauteurs de note, en
794 revanche, relèvent de ce que vous voulez entendre ; et, dans la mesure
795 où la musique que vous entrez est censée être celle que vous voulez
796 entendre, LilyPond, qui n'est chargé que de la gravure, ne les
797 choisira pas à votre place.
801 @lilypond[verbatim,quote,relative=2]
807 aucune note n'a d'altération accidentelle, et pourtant vous devrez
808 entrer le @code{is} pour les notes @code{cis} et @code{fis}.
810 Le code @code{b} ne veut pas dire @qq{Imprimez-moi un point noir sur
811 la troisième ligne de la portée.} Cela signifie plutôt : @qq{Ici se
812 trouve une note dont la hauteur est un si naturel.} Avec une armure
813 de la bémol majeur, ce @code{si} est flanqué d'un bécarre accidentel :
815 @lilypond[verbatim,quote,relative=2]
820 Ajouter explicitement toutes les altérations demande un peu plus
821 d'effort dans la phase de saisie, mais cela facilite grandement la
822 @notation{transposition}. De plus, les altérations accidentelles
823 peuvent ainsi être imprimées suivant plusieurs conventions. Pour
824 connaître les différentes manières dont les altérations accidentelles
825 peuvent être imprimées, consultez @ruser{Automatic accidentals}.
829 Manuel de notation : @ruser{Note names in other languages},
830 @ruser{Accidentals}, @ruser{Automatic accidentals},
831 @ruser{Key signature}.
833 Glossaire musical : @rglos{Pitch names}.
837 @subsection Ties and slurs
839 @cindex liaisons de prolongation
840 @cindex liaisons de tenue
841 @cindex prolongation, liaisons de
842 @cindex durée, liaisons de
843 @cindex tenue, liaisons de
851 Glossaire musical : @rglos{tie}.
853 Pour créer une liaison de prolongation@footnote{parfois aussi appelée
854 liaison de tenue}, on ajoute un tilde @code{~} à la première note
857 @lilypond[verbatim,quote,relative=2]
862 @cindex liaisons d'articulation
863 @cindex articulation, liaisons d'
867 @c Le terme de "slur" a deux sens en français : articulation et phrasé.
868 @c Je garde ici le terme "legato", tel qu'il apparaît dans le texte original,
869 @c car c'est celui qui me semble le plus couramment employé.
870 @c slur = "il zon" (articulation). jcm
871 @c phrasing slur = "ils ont des chapeaux ronds" (phrase). jcm
873 Glossaire musical : @rglos{slur}, @rglos{phrasing}.
875 Une liaison d'articulation ou @emph{legato} peut englober
876 plusieurs notes. Les notes de départ et d'arrivée sont suivies
877 respectivement d'un signe @code{(} et @code{)}.
879 @lilypond[verbatim,quote,relative=2]
880 d4( c16) cis( d e c cis d) e( d4)
883 @cindex liaisons de phrasé
884 @cindex phrasé, liaisons de
886 @subheading Phrasing slurs
888 De plus longues liaisons, dites de phrasé, sont délimitées par @code{\(} et
889 @code{\)}. Il est possible d'avoir en même temps des legatos et des
890 phrasés, mais pas plusieurs liaisons de phrasé ou de @emph{legato} à la fois.
892 @lilypond[verbatim,quote,relative=2]
893 a8(\( ais b c) cis2 b'2 a4 cis,\)
898 @cindex liaisons d'articulation et de prolongation, différences
899 @subheading Warnings: slurs vs. ties
901 Glossaire musical : @rglos{articulation}, @rglos{slur}, @rglos{tie}.
903 Une liaison d'articulation ou de phrasé ressemble à une liaison de
904 prolongation, mais n'a pas la même signification. Alors qu'une
905 liaison de prolongation ne peut relier que deux notes de même hauteur,
906 le @emph{legato} indique une articulation de plusieurs notes,
907 éventuellement en grand nombre. Les liaisons de tenue peuvent être
908 enchâssées dans un @emph{legato} ou un phrasé.
910 @lilypond[verbatim,quote,relative=2]
911 c2~( c8 fis fis4 ~ fis2 g2)
916 Manuel de notation : @ruser{Ties}, @ruser{Slurs},
917 @ruser{Phrasing slurs}.
920 @node Articulation and dynamics
921 @subsection Articulation and dynamics
923 @subheading Articulations
929 Glossaire musical : @rglos{articulation}.
931 Des @notation{articulations} peuvent être ajoutées à une note, au moyen
932 d'un tiret @code{-} suivi d'un caractère :
934 @lilypond[verbatim,quote,relative=2]
935 c-. c-- c-> c-^ c-+ c-_
938 @subheading Fingerings
945 Glossaire musical : @rglos{fingering}.
947 De même, des indications de doigté peuvent être ajoutées à une note en
948 utilisant un tiret (@samp{-}) et le chiffre à écrire :
950 @lilypond[verbatim,quote,relative=2]
954 Articulations et doigtés sont habituellement placés automatiquement,
955 mais vous pouvez spécifier leur positionnement en utilisant @code{^} (en
956 haut) ou @code{_} (en bas). Vous pouvez aussi utiliser plusieurs
957 articulations sur la même note. Dans la plupart des cas, cependant,
958 il est bon de laisser LilyPond déterminer l'emplacement de
961 @lilypond[verbatim,quote,relative=2]
962 c_-^1 d^. f^4_2-> e^-_+
980 Glossaire musical : @rglos{dynamics}, @rglos{crescendo},
983 On obtient un signe de @notation{nuance} en ajoutant à la note les
984 lettres du signe, précédées d'un anti-slash @code{\} :
986 @lilypond[verbatim,quote,relative=2]
994 @c Pluriel des termes musicaux italiens :
995 @c selon Littré, plutôt à la française (en "-os" qu'en "-i")
997 @notation{Crescendos} et @notation{decrescendos} débutent avec les
998 commandes @code{\<} et @code{\>}. Ils se terminent soit par une
999 nuance d'arrivée, par exemple @code{\f}, soit par la commande
1002 @lilypond[verbatim,quote,relative=2]
1003 c2\< c2\ff\> c2 c2\!
1008 Manuel de notation : @ruser{Articulations and ornamentations},
1009 @ruser{Fingering instructions}, @ruser{Dynamics}.
1013 @subsection Adding text
1015 @cindex texte, ajout de
1016 @cindex ajout de texte
1022 On peut ajouter du texte à une partition :
1024 @lilypond[verbatim,quote,relative=2]
1025 c1^"espr" a_"legato"
1028 Pour mettre en forme du texte, on utilise la commande @code{markup} :
1030 @lilypond[verbatim,quote,relative=2]
1031 c1^\markup{ \bold espr}
1033 \dynamic f \italic \small { 2nd } \hspace #0.1 \dynamic p
1039 Manuel de notation : @ruser{Writing text}.
1042 @node Automatic and manual beams
1043 @subsection Automatic and manual beams
1046 @cindex barre de ligature
1047 @cindex ligatures automatiques
1048 @cindex ligatures manuelles
1049 @cindex ligatures explicites
1054 @funindex \autoBeamOff
1055 @funindex autoBeamOff
1056 @funindex \autoBeamOn
1057 @funindex autoBeamOn
1059 Glossaire musical : @rglos{beam}.
1061 Toutes les barres de ligature sont dessinées automatiquement :
1063 @lilypond[verbatim,quote,relative=2]
1064 a8 ais d ees r d c16 b a8
1068 Lorsqu'on n'aime pas la manière dont les notes sont automatiquement
1069 groupées, il est possible de les ligaturer manuellement, en marquant la
1070 première note à attacher d'un crochet ouvrant @code{[} et la dernière
1071 d'un crochet fermant @code{]}.
1073 @lilypond[verbatim,quote,relative=2]
1074 a8[ ais] d[ ees r d] a b
1077 Pour désactiver les barres de ligature automatiques pour des passages
1078 entiers, utilisez la commande @code{\autoBeamOff}, et utilisez
1079 @code{\autoBeamOn} pour les réactiver.
1081 @lilypond[verbatim,quote,relative=2]
1090 Manuel de notation : @ruser{Automatic beams}, @ruser{Manual beams}.
1093 @node Advanced rhythmic commands
1094 @subsection Advanced rhythmic commands
1096 @subheading Partial measure
1100 @cindex mesure incomplète
1105 Glossaire musical : @rglos{anacrusis}.
1107 On crée une levée (ou anacrouse) avec la commande @code{\partial},
1108 suivie d'une durée : @code{\partial 4} produit une levée d'une noire
1109 et @code{\partial 8} d'une croche.
1111 @lilypond[verbatim,quote,relative=2]
1124 Glossaire musical : @rglos{note value}, @rglos{triplet}.
1126 Les @notation{nolets} sont créés avec la commande @code{\times}, qui
1127 prend deux arguments : une fraction et une expression musicale. La
1128 durée des notes de l'expression musicale est multipliée par la
1129 fraction. Par exemple les notes d'un @notation{triolet} durent les
1130 deux tiers de la durée de leur notation réelle, cette fraction est
1131 donc de 2/3 pour les triolets :
1133 @lilypond[verbatim,quote,relative=2]
1134 \times 2/3 { f8 g a }
1135 \times 2/3 { c r c }
1136 \times 2/3 { f,8 g16[ a g a] }
1137 \times 2/3 { d4 a8 }
1140 @subheading Grace notes
1142 @cindex notes d'ornement
1143 @cindex ornementation
1144 @cindex appoggiature
1145 @cindex acciaccature
1149 @funindex \acciaccatura
1150 @funindex acciaccatura
1151 @funindex \appoggiatura
1152 @funindex acciaccatura
1154 Glossaire musical : @rglos{grace notes}, @rglos{acciaccatura},
1155 @rglos{appoggiatura}.
1157 Des @notation{notes d'ornement} s'obtiennent en appliquant la commande
1158 @code{\grace}, @code{\appoggiatura} ou @code{\acciaccatura} à une
1159 expression musicale :
1161 @lilypond[verbatim,quote,relative=2]
1162 c2 \grace { a32[ b] } c2
1163 c2 \appoggiatura b16 c2
1164 c2 \acciaccatura b16 c2
1169 Manuel de notation : @ruser{Grace notes}, @ruser{Tuplets},
1173 @node Multiple notes at once
1174 @section Multiple notes at once
1176 Cette section traite de situations où l'on a plus d'une note à la fois :
1177 plusieurs instruments, plusieurs voix ou portées pour un même
1178 instrument (le piano, par exemple), et les accords.
1180 En théorie musicale, la polyphonie désigne une musique constituée de
1181 plusieurs voix ; dans LilyPond, ce terme désigne les situations où il
1182 y a plus d'une voix sur une même portée.
1185 * Music expressions explained::
1188 * Combining notes into chords::
1189 * Single staff polyphony::
1193 @node Music expressions explained
1194 @subsection Music expressions explained
1196 @cindex expression musicale
1198 Dans les fichiers source LilyPond, la musique est représentée par ce
1199 qu'on appelle des @emph{expressions musicales}. En soi, une seule note
1200 peut constituer une expression musicale :
1202 @lilypond[verbatim,quote,relative=2]
1206 Mettre un groupe de notes entre accolades crée une nouvelle expression
1207 musicale, appelée @emph{expression musicale composée}. En voici un
1208 exemple avec deux notes :
1210 @lilypond[verbatim,quote,relative=2]
1214 La mise entre accolades d'une séquence d'expressions musicales --- des
1215 notes par exemple --- signifie qu'elles doivent être jouées
1216 successivement, les unes après les autres. Le résultat est une
1217 expression, qui peut elle-même être regroupée séquentiellement avec
1218 d'autres expressions. Ici, l'expression de l'exemple précédent est
1219 combinée à deux notes :
1221 @lilypond[verbatim,quote,relative=2]
1225 @subheading Analogy: mathematical expressions
1229 Ce mécanisme est similaire aux formules mathématiques : une grosse
1230 formule est créée en assemblant plusieurs petites formules. De telles
1231 formules sont appelées expressions, elles ont une définition
1232 récursive, de telle sorte que vous pouvez fabriquer des expressions
1233 arbitrairement longues et complexes. Par exemple :
1242 ((1 + 2) * 3) / (4 * 5)
1245 Ceci est une suite d'expressions, où chacune est contenue dans la
1246 suivante. Les expressions les plus simples sont les nombres, et de
1247 plus grandes expressions sont produites en combinant des expressions
1248 avec des opérateurs --- comme @code{+}, @code{*} et @code{/} --- et
1249 des parenthèses. Tout comme les expressions mathématiques, les
1250 expressions musicales peuvent être imbriquées avec une profondeur
1251 arbitraire, ce qui est nécessaire pour des partitions complexes comme
1252 de la musique polyphonique.
1255 @subheading Simultaneous music expressions: multiple staves
1257 @cindex portées multiples
1259 @cindex combinaison d'expressions en parallèle
1260 @cindex parallèles, expressions
1261 @cindex expressions parallèles
1262 @cindex hauteur relative et musique simultanée
1263 @cindex musique simultanée et hauteur relative
1264 @cindex hauteur relative et expressions parallèles
1265 @cindex expressions parallèles et hauteur relative
1271 Glossaire musical : @rglos{polyphony}.
1273 Cette technique est utile pour de la musique @notation{polyphonique}.
1274 Pour entrer une musique avec plusieurs voix ou plusieurs portées, nous
1275 pouvons aussi combiner @emph{en parallèle} les expressions : deux voix
1276 qui doivent être jouées en même temps, sont entrées comme une
1277 combinaison simultanée de deux expressions. Une expression musicale
1278 @qq{simultanée} est formée en entourant les expressions entre @code{<<}
1279 et @code{>>}. Dans l'exemple suivant, trois expressions (contenant
1280 chacune deux notes distinctes) sont combinées simultanément.
1282 @lilypond[verbatim,quote]
1292 Notez que nous avons ici indenté chaque niveau du fichier d'entrée
1293 avec un nombre d'espaces différent. LilyPond se moque --- ou presque
1294 --- de l'espace qu'il peut y avoir ou non au début d'une ligne, mais
1295 un code bien indenté est bien plus lisible par des humains.
1297 @warning{la hauteur de chaque note saisie est relative à la précédente,
1298 mais pas au @code{c''} de la commande @code{\relative} de départ.}
1301 @subheading Simultaneous music expressions: single staff
1303 Pour déterminer le nombre de portées, LilyPond regarde le début
1304 de la première expression. Si c'est une seule note, une seule portée
1305 est produite ; si c'est une expression simultanée, plusieurs portées
1308 @lilypond[verbatim,quote]
1311 << { e f } { c <<b d>> } >>
1316 @node Multiple staves
1317 @subsection Multiple staves
1319 @cindex multiples portées
1320 @cindex portées multiples
1322 @cindex contexte de notation
1323 @cindex notation, contexte
1325 @funindex \new Staff
1333 @funindex ChordNames
1335 Comme nous l'avons vu dans @ref{Music expressions explained}, un
1336 fichier d'entrée LilyPond est fait d'expressions musicales. Si la
1337 partition commence par plusieurs expressions simultanées, LilyPond
1338 créera plusieurs portées. Cependant, il est plus facile de prévoir le
1339 nombre de portées si on les crée explicitement, ce que nous allons
1342 Pour créer plus d'une portée, on ajoute @code{\new Staff} au début de
1343 chaque partie de la musique constituant une portée. Ces éléments
1344 @code{Staff} sont ensuite combinés en parallèle avec @code{<<} et
1345 @code{>>}, comme ci-dessous.
1347 @lilypond[verbatim,quote]
1350 \new Staff { \clef treble c }
1351 \new Staff { \clef bass c,, }
1357 La commande @code{\new} introduit un @qq{contexte de notation}. Un
1358 contexte de notation est un environnement dans lequel les événements
1359 musicaux --- comme les notes ou les commandes @code{\clef} --- sont
1360 interprétés. Pour des pièces simples, ces contextes sont créés
1361 automatiquement. Pour des pièces plus complexes, il est préférable de
1362 spécifier explicitement les contextes, afin de s'assurer que chaque
1363 fragment aura sa propre portée.
1365 Il existe différents types de contextes. Les contextes @code{Score}
1366 (partition), @code{Staff} (portée) et @code{Voice} (voix) gèrent la
1367 notation de la mélodie, alors que @code{Lyrics} gère les paroles et
1368 @code{ChordNames} imprime des noms d'accords.
1370 En terme de syntaxe, ajouter @code{\new} devant une expression
1371 musicale crée une plus grande expression musicale. En reprenant la
1372 comparaison précédente, cela ressemble au signe @emph{moins} en
1373 mathématiques. La formule @math{(4+5)} est une expression, donc
1374 @math{-(4+5)} constitue une plus grande expression.
1376 Les chiffres de métrique indiqués sur une portée affectent toutes les
1377 autres portées@footnote{Ce comportement peut être modifié si
1378 nécessaire, voir @ruser{Polymetric notation}}. En revanche l'armure
1379 d'une portée n'affecte @emph{pas} les autres portées. Ces
1380 caractéristiques par défaut se justifient par le fait que
1381 l'utilisation d'instruments transpositeurs est bien plus fréquente que
1382 la musique polyrythmique.
1384 @lilypond[verbatim,quote]
1387 \new Staff { \clef treble \key d \major \time 3/4 c }
1388 \new Staff { \clef bass c,, }
1395 @subsection Staff groups
1397 @cindex portée double
1398 @cindex portée pour piano
1399 @cindex piano, portée pour
1400 @cindex clavier, portée pour
1401 @cindex chœur, système pour
1402 @cindex système pour chœur
1404 @cindex portées, regroupement de
1405 @cindex regroupement de portées
1407 @funindex PianoStaff
1408 @funindex GrandStaff
1409 @funindex ChoirStaff
1411 Glossaire musical : @rglos{brace}.
1413 La musique pour piano s'écrit sur deux portées reliées par une
1414 @notation{accolade}. La gravure de ce type de portée est semblable à
1415 l'exemple de musique polyphonique de @ref{Multiple staves}, mais
1416 maintenant cette expression entière est interprétée dans un contexte
1426 Voici un bref exemple :
1428 @lilypond[verbatim,quote]
1431 \new Staff { \time 2/4 c4 e g g, }
1432 \new Staff { \clef bass c,, c' e c }
1437 Vous pouvez générer d'autres de regroupement, avec
1438 @code{\new GrandStaff} pour un e partition d'orchestre, ou
1439 @w{@code{\new ChoirStaff}} qui sied particulièrement aux partitions
1440 chorales. Chacun de ces regroupements constituent un contexte à part
1441 entière, avec ses particularités, tant au niveau du signe qui regroupe
1442 les portées au sein d'un @notation{système} qu'au niveau de l'étendue
1443 des barres de mesure.
1447 Manuel de notation : @ruser{Keyboard and other multi-staff instruments},
1448 @ruser{Displaying staves}.
1451 @node Combining notes into chords
1452 @subsection Combining notes into chords
1454 @cindex accords, notes simultanées
1455 @cindex accords et durée
1461 Glossaire musical : @rglos{chord}.
1463 Nous avons vu précédemment comment combiner des notes simultanément,
1464 en les encadrant par des chevrons doubles @code{<<} et @code{>>}. Pour
1465 produire des accords simples, c'est-à-dire une superposition de notes
1466 de même durée, on encadre les hauteurs de notes par des chevrons simples
1467 @code{<} et @code{>}, et on écrit la durée juste après.
1469 @lilypond[verbatim,quote,relative=2]
1470 r4 <c e g>4 <c f a>2
1473 Beaucoup d'éléments de notation que l'on peut attacher à une note
1474 simple, comme une liaison, un crochet indiquant un début ou une fin de
1475 lien, un signe d'articulation, peuvent être également attachés à un
1476 accord : il faut ajouter ces indications après les hauteurs et la
1477 durée, donc @emph{à l'extérieur} des chevrons.
1479 @lilypond[verbatim,quote,relative=2]
1480 r4 <c e g>8[ <c f a>]~ <c f a>2
1481 r4 <c e g>8( <c e g>\> <c e g>4 <c f a>\!)
1485 @node Single staff polyphony
1486 @subsection Single staff polyphony
1489 @cindex voix multiples sur une portée
1490 @cindex silence invisible
1491 @cindex invisible, silence
1493 @funindex << ... \\ ... >>
1498 Bien que LilyPond gère la musique polyphonique sans difficulté, cela
1499 fait appel à des concepts que nous n'avons pas encore abordés. C'est la
1500 raison pour laquelle nous ne nous étendrons pas tout de suite sur ce
1501 sujet et préférons vous inciter à consulter les chapitres dédiés à
1502 l'étude de ces concepts.
1505 Learning Manual: @ref{Voices contain music}.
1507 Manuel de notation : @ruser{Simultaneous notes}.
1513 Cette section présente l'écriture vocale et les partitions de variété.
1516 * Setting simple songs::
1517 * Aligning lyrics to a melody::
1518 * Lyrics to multiple staves::
1522 @node Setting simple songs
1523 @subsection Setting simple songs
1528 @funindex \addlyrics
1531 Glossaire musical : @rglos{lyrics}.
1533 Prenons une mélodie toute simple, la comptine @emph{Girls and boys
1536 @lilypond[verbatim,quote]
1540 d4 b8 c4 a8 d4 b8 g4
1544 Des @notation{paroles} peuvent être associées à ces notes, en les
1545 combinant avec la commande @code{\addlyrics}. On entre les paroles en
1546 séparant chaque syllable par un espace :
1548 @lilypond[verbatim,quote]
1553 d4 b8 c4 a8 d4 b8 g4
1556 Girls and boys come out to play,
1561 Remarquez les accolades embrassant la musique et celles embrassant les
1562 paroles, ainsi que les doubles chevrons encadrant toute la pièce ; ces
1563 derniers indiquent simplement que la musique et les paroles se
1564 produisent en même temps.
1567 @node Aligning lyrics to a melody
1568 @subsection Aligning lyrics to a melody
1571 @cindex ligne d'extension
1572 @cindex trait d'union (paroles)
1573 @cindex caractère souligné (paroles)
1574 @cindex paroles, alignement des
1575 @cindex alignement des paroles
1576 @cindex paroles, mot de plusieurs syllabes
1578 Glossaire musical : @rglos{melisma}, @rglos{extender line}.
1580 La deuxième ligne de la comptine précédente est @emph{The moon doth
1581 shine as bright as day}. Ajoutons-la au code.
1583 @lilypond[verbatim,quote]
1588 d4 b8 c4 a8 d4 b8 g4
1589 g8 a4 b8 c b a d4 b8 g4.
1592 Girls and boys come out to play,
1593 The moon doth shine as bright as day;
1598 Remarquez que les paroles ajoutées ne s'alignent pas bien avec les
1599 notes. Le mot @emph{shine} devrait être chanté sur deux notes au lieu
1600 d'une. On appelle ceci un @notation{mélisme} : il s'agit d'une seule
1601 syllabe chantée sur plus d'une note. Il existe plusieurs façons
1602 d'étaler une sylabe sur plusieurs notes, la plus simple étant de lier
1603 les notes du mélisme. Pour les détails, consultez @ref{Ties and
1606 @lilypond[verbatim,quote]
1611 d4 b8 c4 a8 d4 b8 g4
1612 g8 a4 b8 c( b) a d4 b8 g4.
1615 Girls and boys come out to play,
1616 The moon doth shine as bright as day;
1621 Les paroles sont maintenant correctement alignées, mais les liens de
1622 croche automatiques ne conviennent pas pour les notes au-dessus de
1623 @emph{shine as}. On peut les corriger en ajoutant des liens de croche
1624 manuels, pour ceci consultez @ref{Automatic and manual beams}.
1626 @lilypond[verbatim,quote]
1631 d4 b8 c4 a8 d4 b8 g4
1632 g8 a4 b8 c([ b]) a d4 b8 g4.
1635 Girls and boys come out to play,
1636 The moon doth shine as bright as day;
1641 Au lieu d'utiliser une liaison, on peut indiquer le mélisme dans les
1642 paroles en insérant un caractère souligné @code{_} pour chaque note du
1643 mélisme sauf la première.
1645 @lilypond[verbatim,quote]
1650 d4 b8 c4 a8 d4 b8 g4
1651 g8 a4 b8 c[ b] a d4 b8 g4.
1654 Girls and boys come out to play,
1655 The moon doth shine _ as bright as day;
1660 Si une syllabe s'étend sur un grand nombre de notes ou une note très
1661 longue, on représente souvent le mélisme par un @notation{trait de
1662 prolongation}, qu'on entre avec @code{__}. L'exemple suivant montre
1663 les trois premières mesures de la plainte de Didon, extraite de
1664 @notation{Didon et Énée} de Purcell.
1666 @lilypond[verbatim,quote]
1672 b c4.( bes8 a4. g8 fis4.) g8 fis1
1676 am laid __ in earth,
1681 Aucun exemple jusqu'à présent n'a utilisé de mots de plus d'une
1682 syllabe. Dans des paroles, de tels mots sont écrits en syllabes
1683 séparées par des traits d'union. Avec LilyPond, on utilise deux
1684 tirets pour produire un trait d'union centré entre deux syllabes.
1685 L'exemple suivant montre tout ce que nous avons vu jusqu'à maintenant
1686 sur l'alignement de paroles à une mélodie.
1688 @c no ragged-right here because otherwise the hyphens get lost,
1689 @c but the example is long enough to avoid looking strange.
1690 @lilypond[verbatim,quote,noragged-right]
1696 d4 g4 g a8( b) g4 g4
1700 A -- way in a __ man -- ger,
1701 no __ crib for a bed, __
1706 Avec certaines paroles, en particulier en italien, il se produit la
1707 situation inverse : il peut y avoir plusieurs syllabes sur une seule
1708 note. On réalise ceci avec LilyPond grâce à un caractère souligné
1709 @code{_} sans espace entre les syllabes, ou alors en groupant les
1710 syllabes avec des guillemets. L'exemple suivant est extrait de l'air
1711 de Figaro @emph{Largo al factotum}, dans @emph{Figaro} de Rossini, où
1712 la syllabe @emph{al} est chantée sur la même note que @emph{go}.
1714 @c no ragged-right here because otherwise the hyphens get lost,
1715 @c but the example is long enough to avoid looking strange.
1716 @lilypond[verbatim,quote,noragged-right]
1722 c4.~ c8 d b c([ d]) b c d b c
1725 Lar -- go_al fac -- to -- tum del -- la cit -- tà
1732 Manuel de notation : @ruser{Vocal music}.
1735 @node Lyrics to multiple staves
1736 @subsection Lyrics to multiple staves
1738 @cindex paroles et portées mutiples
1739 @cindex portées multiples et paroles
1741 La méthode simple d'ajout de paroles avec @code{\addlyrics} peut être
1742 également utilisée pour placer des paroles sous plusieurs portées.
1743 L'exemple suivant est extrait de @emph{Judas Macchabée} de Händel.
1745 @lilypond[verbatim,quote]
1751 c8 c([ bes]) a a([ g]) f f'4. b, c4.~ c4
1754 Let flee -- cy flocks the hills a -- dorn, __
1760 r8 r4. r4 c8 a'([ g]) f f([ e]) d e([ d]) c bes'4
1763 Let flee -- cy flocks the hills a -- dorn,
1768 Pour produire des partitions plus complexes ou plus longues que cet
1769 exemple simple, il est vivement conseillé de séparer la structure de
1770 la partition des notes et paroles, grâce à des variables. Ceci sera
1771 détaillé plus loin dans @ref{Organizing pieces with variables}.
1775 Manuel de notation : @ruser{Vocal music}.
1779 @section Final touches
1781 L'ultime section de ce tutoriel montre comment ajouter une touche
1782 finale à des morceaux simples, et constitue une introduction au reste
1786 * Organizing pieces with variables::
1789 * Absolute note names::
1790 * After the tutorial::
1794 @node Organizing pieces with variables
1795 @subsection Organizing pieces with variables
1798 @cindex variables, définition
1799 @cindex identificateurs
1801 @cindex assignation de variables
1802 @cindex utilisation de variables
1803 @cindex variables, utilisation de
1804 @cindex variables, caractères autorisés dans les
1805 @cindex caractères autorisés dans les variables
1807 Lorsque l'on combine tous les éléments étudiés précédemment pour
1808 écrire des partitions plus longues, les expressions musicales prennent
1809 de l'ampleur et, dans le cas des pièces polyphoniques, deviennent
1810 profondément imbriquées, jusqu'au point où il devient difficile de se
1811 repérer dans le fichier source. Cet inconvénient peut être résolu par
1812 l'utilisation de @emph{variables}.
1814 En utilisant des variables, parfois appelées identificateurs ou
1815 macros, on peut scinder des expressions musicales complexes en des
1816 expressions plus simples. Une variable se définit comme suit :
1819 musiqueToto = @{ @dots{} @}
1822 Le contenu de l'expression musicale @code{musiqueToto} pourra être
1823 utilisé plus loin en faisant précéder son nom d'un anti-slash,
1824 c'est-à-dire @code{\musiqueToto}, tout comme n'importe quelle commande
1825 LilyPond. Toute variable doit être définie @emph{avant} son
1826 utilisation dans une autre expression musicale.
1828 @lilypond[verbatim,quote]
1829 violin = \new Staff {
1834 cello = \new Staff {
1849 Le nom d'une variable ne doit comporter que des caractères
1850 alphabétiques non accentués, aucun nombre ni tiret ne sont autorisés.
1852 On peut utiliser une variable déjà définie autant de fois que l'on
1853 veut, y compris dans la définition d'une nouvelle variable ; par
1854 exemple, cela peut servir à saisir un motif qu'une seule fois, même
1855 s'il se répète un grand nombre de fois dans la pièce.
1857 @lilypond[verbatim,quote]
1858 tripletA = \times 2/3 { c,8 e g }
1859 barA = { \tripletA \tripletA \tripletA \tripletA }
1866 Il est possible d'utiliser des variables de types variés. Par exemple,
1871 aFivePaper = \paper @{ paperheight = 21.0 \cm @}
1874 En fonction de son contenu, un identificateur peut être utilisé à
1875 différents endroits. L'exemple suivant utilise les variable définies
1887 @node Version number
1888 @subsection Version number
1892 @cindex numéro de version
1893 @cindex version, numéro de
1895 @cindex future mise à jour
1896 @cindex mise à jour de fichiers
1897 @cindex fichiers, mise à jour de
1901 @funindex convert-ly
1903 La déclaration @code{\version} stipule le numéro de la version de
1904 LilyPond pour laquelle le fichier a été écrit :
1907 \version @w{"@version{}"}
1911 Par convention, on place cette instruction en début de fichier.
1913 Cette instruction permet de faciliter les mises à jour futures de
1914 LilyPond. Les changements de syntaxe au fil des versions sont gérés
1915 avec un programme dédié, @command{convert-ly}, qui utilise la valeur
1916 de @code{\version} pour déterminer les règles de conversion à
1917 appliquer au fichier source. Pour plus d'informations, consultez
1918 @rprogram{Updating files with convert-ly}.
1922 @subsection Adding titles
1926 @cindex bloc d'en-tête
1931 On indique les informations bibliographiques --- nom du morceau, du
1932 compositeur, numéro d'opus@dots{} --- dans un bloc à part, le bloc
1933 d'en-tête @code{\header}, qui existe indépendamment de l'expression
1934 musicale principale. Le bloc @code{\header} est habituellement placé
1935 en début de fichier, après le numéro de version.
1938 \version @w{"@version{}"}
1946 @dots{} la musique @dots{}
1950 Quand LilyPond traite le fichier, le titre et le compositeur sont
1951 imprimés au début de la partition. Vous trouverez plus d'informations
1952 sur les titres à la section @ruser{Creating titles}.
1955 @node Absolute note names
1956 @subsection Absolute note names
1958 @cindex notes, nom des
1959 @cindex absolu, mode
1961 @cindex hauteurs, valeurs absolues
1962 @cindex noms de note absolus
1964 Jusqu'ici nous n'avons utilisé que le mode @code{\relative} pour
1965 définir les hauteurs de notes. Si c'est souvent le moyen le plus
1966 simple de saisir la musique au clavier, il existe une autre façon de
1967 procéder : le mode de hauteurs absolues.
1969 Si vous omettez la commande @code{\relative}, LilyPond considérera
1970 toutes les hauteurs comme des hauteurs absolues. Un @code{c'} désigne
1971 toujours le do central, un @code{b} se situe une seconde en dessous
1972 du do central, et un @code{g,} est situé sur la première ligne de
1973 la portée en clé de fa.
1975 @lilypond[verbatim,quote]
1983 Voici une gamme sur 4 octaves :
1985 @lilypond[verbatim,quote]
2000 Comme vous pouvez le voir, il faut beaucoup d'apostrophes pour écrire
2001 de la musique dans un registre aigu, comme le montre cet extrait de
2004 @lilypond[verbatim,quote]
2008 cis''8. d''16 cis''8 e''4 e''8
2009 b'8. cis''16 b'8 d''4 d''8
2013 Toutes ces apostrophes rendent le fichier moins lisible, et surtout il
2014 est très probable d'oublier au moins une apostrophe au cours de la
2015 frappe. En mode @code{\relative}, le même exemple devient bien plus
2016 facile à lire et à saisir.
2018 @lilypond[verbatim,quote]
2022 cis8. d16 cis8 e4 e8
2027 Si d'aventure vous faites une erreur d'octaviation, le mode
2028 @code{\relative} la mettra en évidence : toutes les notes suivantes
2029 seront placées à la mauvaise octave. En mode de hauteurs absolues,
2030 une erreur isolée ne serait pas autant visible, et serait donc plus
2031 difficile à dénicher.
2033 Cependant, le mode de hauteurs absolues reste utile pour les musiques
2034 où les intervalles sont étendus, et plus encore pour les fichiers
2035 LilyPond créés par des programmes.
2038 @node After the tutorial
2039 @subsection After the tutorial
2041 Après avoir parcouru ce tutoriel, vous devriez essayer d'écrire un
2042 morceau ou deux. Commencez par copier l'un des modèles types et
2043 ajoutez-y des notes --- consultez les @ref{Templates}. Si vous voulez
2044 employer une notation que vous n'avez pas trouvé dans le tutoriel,
2045 consultez le manuel de notation, en commençant par la @ruser{Musical
2046 notation}. Si vous désirez écrire pour un ensemble instrumental non
2047 couvert par les modèles, lisez la section @ref{Extending the
2050 Après avoir écrit quelques pièces courtes, lisez les chapitres 3 à 5
2051 du manuel d'initiation. Rien ne s'oppose à ce que vous consultiez dès
2052 à présent ces chapitres, bien sûr ! Néanmoins, le reste du manuel
2053 d'initiation part du principe que vous avez déjà bien assimilé la
2054 syntaxe de base de LilyPond. Vous pouvez toujours survoler ces
2055 chapitres 3 à 5, et y revenir plus tard après avoir acquis de
2058 Dans ce tutoriel comme dans le reste de ce manuel, se trouve à chaque
2059 section un paragraphe @strong{Voir aussi} contenant des références
2060 vers d'autres sections : il est conseillé de ne pas les suivre en
2061 première lecture ; lorsque vous aurez lu l'ensemble du manuel
2062 d'initiation, vous pourrez en relisant certaines sections suivre ces
2063 références pour approfondir certains aspects.
2065 Si vous ne l'avez pas encore fait, lisez @ref{About the
2066 documentation}. Les sources de documentation et d'information sur
2067 LilyPond sont vastes, il est normal pour un débutant de ne pas savoir
2068 où chercher ; si vous passez quelques minutes à lire attentivement
2069 cette section, vous vous épargnerez certainement la frustration causée
2070 par des heures de recherches infructueuses.