1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
2 @c This file is part of lilypond-learning.tely
4 Translation of GIT committish: 7eee2a7382029cc29cc069f93a431758ae8a13b7
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. See TRANSLATION for details.
13 Tutorial guidelines: (different from policy.txt!)
14 - unless you have a really good reason, use either
15 @lilypond[verbatim,quote]
17 @lilypond[verbatim,quote,relative=2]
19 Don't use any other relative=X commands.
21 - use "aes" and "ees" instead of "as" and "es". I know it's not
22 correct Dutch naming, but let's not confuse people with this
23 until we get to the Basic notation chapter.
25 - Add "Music Glossary: @rglos{foo}" to the *top* of the relevant
26 portions of the tutorial.
31 @c Translators: Nicolas Grandclaude, Ludovic Sardain, Gauvain Pocentek
32 @c Translation checkers: Jean-Charles Malahieude, Valentin Villenave, John Mandereau
33 @c Translation status: post-GDP
38 Ce tutoriel commence par une introduction au langage musical utilisé
39 par LilyPond, qui vous permettra de faire fonctionner le logiciel pour
40 produire une partition. Après ce premier contact, nous verrons comment
41 créer des partitions utilisant une notation musicale courante.
45 * Single staff notation::
46 * Multiple notes at once::
55 Cette section présente les aspects élémentaires de l'utilisation de
61 * Working on input files::
62 * How to read the manual::
66 @node Compiling a file
67 @subsection Compiling a file
70 @cindex exemple, premier
71 @cindex premier exemple
73 Pour créer une partition avec LilyPond, on écrit un fichier texte,
74 appelé fichier source, qui décrit la notation musicale. La
75 @emph{compilation} de ce fichier source par LilyPond produit un
76 fichier graphique imprimable, et si on le désire un fichier MIDI qui
77 peut être joué par un séquenceur.
79 Voici un premier exemple simple de fichier source LilyPond.
88 La compilation de ce fichier donnera quelque chose de sembable à
91 @c in this case we don't want verbatim
99 Il est aussi possible d'utiliser les noms de notes français @qq{@w{do
100 re mi fa sol la si}}, en insérant au début du fichier la ligne
101 @code{\include@tie{}"italiano.ly"}.
104 @warning{Tout extrait de code LilyPond doit être entouré d'une
105 @strong{@{ paire d'accolades @}}. De plus, pour éviter toute
106 ambiguïté, il est préférable d'entourer les accolades par des espaces
107 ou retours à la ligne. Bien que certains exemples de ce manuel ne
108 comportent pas d'accolades, ne les oubliez pas dans vos partitions !
109 Pour plus d'informations sur l'affichage des exemples de cette
110 documentation, consultez @ref{How to read the manual}.}
113 @cindex casse, prise en compte de la
114 @cindex prise en compte de la casse
115 @cindex sensibilité à la casse
117 De plus, LilyPond est @strong{sensible à la casse} : le code
118 @w{@code{@{ c d e @}}} est valide, alors que @w{@code{@{ C D E @}}}
119 produira un message d'erreur.
123 @subheading Entering music and viewing output
127 @cindex partition, lire
128 @cindex lire la partition
129 @cindex éditeurs de texte
130 @cindex LilyPond et MacOS X
131 @cindex MacOS X et LilyPond
132 @cindex LilyPond et Windows
133 @cindex Windows et LilyPond
134 @cindex LilyPond et Unix
135 @cindex Unix et LilyPond
137 Dans cette section nous expliquerons quelles commandes exécuter et
138 comment voir ou imprimer le résultat produit par LilyPond.
140 Notez qu'il existe plusieurs éditeurs de texte disponibles avec un bon
141 support de LilyPond ; consultez @rprogram{Text editor support}.
143 @warning{Le premier démarrage de LilyPond peut prendre une minute ou
144 deux, afin de générer la liste des polices du système. LilyPond démarre
145 en principe plus rapidement lors des exécutions suivantes.}
148 @subsubheading MacOS X
150 Si vous double-cliquez sur @code{LilyPond.app}, un fichier d'exemple
151 s'ouvrira. Sauvegardez-le, par exemple, sous @file{test.ly} sur votre
152 bureau, puis traitez-le avec la commande de menu
153 @w{@code{Compile > Typeset File}}. Le fichier PDF résultant sera alors
156 À l'avenir, vous aurez certainement recours aux commandes @qq{Nouveau}
157 ou @qq{Ouvrir}. Vous devez enregistrer votre fichier avant de lancer
158 la gravure de la partition par LilyPond. Si une erreur apparaît
159 pendant le traitement, vous la trouverez dans la fenêtre @qq{log}.
161 @subsubheading Windows
163 Sous Windows, double-cliquez sur l'icône LilyPond qui se trouve sur le
164 bureau, un fichier d'exemple s'ouvre dans un simple éditeur de texte.
165 Enregistrez-le, par exemple en tant que @file{test.ly} sur le bureau,
166 puis double-cliquez sur son icône (qui montre une note de musique)
167 pour le traiter. Après quelques secondes, vous obtiendrez un fichier
168 @file{test.pdf} sur le bureau, fichier que vous pourrez ouvrir pour
169 voir la partition gravée. Une autre méthode pour lancer le traitement
170 du fichier @file{test.ly} est de le glisser avec votre souris sur
173 Pour modifier un fichier @file{.ly} existant, faites un clic droit
174 dessus et sélectionnez @qq{Éditer la source}. Pour partir d'un
175 fichier vide, lancez l'éditeur en ouvrant un fichier existant et
176 utilisez la commande @qq{New} du menu @qq{File}.
178 En double-cliquant sur le fichier, vous obtiendrez, en plus du fichier
179 PDF, un fichier @file{.log} qui récapitule les opérations que LilyPond
180 a effectuées sur votre fichier. Si une erreur survient, vous en
181 trouverez les détails dans ce fichier.
185 Créez un fichier texte @file{test.ly} qui contient
194 Pour traiter @file{test.ly}, entrez la commande suivante dans un
202 Vous verrez quelque chose ressemblant à
206 GNU LilyPond @version{}
207 Traitement de « test.ly »
209 Interprétation en cours de la musique...
210 Pré-traitement des éléments graphiques...
211 Détermination du nombre optimal de pages...
212 Répartition de la musique sur une page...
213 Dessin des systèmes...
214 Sortie mise en page vers « test.ps »...
215 Conversion à « ./test.pdf »...
220 Suivant votre installation, ces messages peuvent être traduits ou
225 @node Simple notation
226 @subsection Simple notation
228 @cindex simple, notation
229 @cindex notation simple
231 Il y a certains éléments graphiques de notation que LilyPond ajoute
232 automatiquement. Dans l'exemple suivant, nous n'avons fourni que
233 quatre hauteurs, mais LilyPond a ajouté une clef, un chiffre de mesure
236 @lilypond[verbatim,quote]
243 Ces valeurs automatiques simplifient la saisie du code source dans
244 bien des cas ; nous verrons plus loin comment les indiquer
254 @cindex altérations et mode relatif
255 @cindex mode relatif et altérations
262 Glossaire musical : @rglos{pitch}, @rglos{interval},
263 @rglos{scale}, @rglos{middle C}, @rglos{octave},
266 Le moyen le plus simple d'entrer des notes est d'utiliser le mode
267 d'octaves relatives, ou mode @code{\relative}. Dans ce mode, l'octave
268 de chaque note est sélectionnée automatiquement de façon à ce qu'elle
269 soit la plus proche possible de la note précédente, c'est-à-dire de
270 façon à ce que l'intervalle avec la note précédente soit au plus d'une
271 quarte. Commençons par saisir une partition très simple, à savoir une
274 @lilypond[verbatim,quote]
275 % set the starting point to middle C
282 La note de départ est le @notation{do central}. Chacune des notes qui
283 suivent est placée à l'octave la plus proche de la note précédente ---
284 en d'autres termes, le premier @code{c} est le do central, entre la
285 clef de sol et la clef de fa, puis est suivi par le ré le plus proche,
286 et ainsi de suite. On peut bien sûr créer des mélodies avec de plus
287 grands intervalles, toujours avec le mode @code{\relative} :
289 @lilypond[verbatim,quote]
297 Remarquez que cet exemple ne commence plus sur le do central : la
298 première note --- le @code{d} --- est le ré qui en est le plus proche.
300 Dans l'exemple suivant, on remplace @code{c'} dans la commande
301 @code{@w{\relative c' @{}} par @code{c''}, afin de calculer l'octave de
302 la première note par rapport au do situé une octave au-dessus du do
305 @lilypond[verbatim,quote]
306 % one octave above middle C
312 Le mode d'octaves relatives peut être déroutant au début, mais c'est
313 souvent la façon la plus économique de saisir les hauteurs en
314 utilisant le clavier de l'ordinateur de façon classique. Détaillons
315 dans un exemple le calcul des octaves relatives. En partant d'un si
316 sur la troisième ligne de la clé de sol, un do, un ré ou un mi sans
317 indication d'octave particulière seront placés juste au-dessus du si,
318 c'est-à-dire au plus à une quarte ascendante du si, alors qu'un la, un
319 sol ou un fa seront placés juste en-dessous du si, c'est-à-dire au
320 plus à une quarte descendante du si.
322 @lilypond[verbatim,quote]
324 b c % c is 1 staff space up, so is the c above
325 b d % d is 2 up or 5 down, so is the d above
326 b e % e is 3 up or 4 down, so is the e above
327 b a % a is 6 up or 1 down, so is the a below
328 b g % g is 5 up or 2 down, so is the g below
329 b f % f is 4 up or 3 down, so is the f below
333 Notez que le calcul des octaves relatives @strong{ne tient pas compte
334 des altérations} des notes, dièses bémols ou bécarre.
336 Pour obtenir des intervalles supérieurs à une quarte, on peut ajouter
337 des apostrophes @code{'} --- qui font chacune monter la hauteur d'une
338 octave --- ou des virgules @code{,} --- qui font chacune descendre la
339 hauteur d'une octave --- au nom de la note.
341 @lilypond[verbatim,quote]
349 Pour déplacer une note deux octaves (ou davantage !) plus haut ou plus
350 bas, il suffit de mettre deux (ou davantage) @code{'} ou @code{,} ---
351 attention cependant à bien mettre deux apostrophes @code{''}, et non
352 un guillemet @code{"}@tie{}! C'est de cette même manière que l'on
353 peut modifier la valeur de départ de @code{@w{\relative c'}}.
356 @subheading Durées et rythme
365 @cindex spécification des durées
367 Glossaire musical : @rglos{beam}, @rglos{duration},
368 @rglos{whole note}, @rglos{half note}, @rglos{quarter note},
371 La @notation{durée} d'une note est indiquée par un nombre qui suit sa
372 hauteur : @code{1} pour une @notation{ronde}, @code{2} pour une
373 @notation{blanche}, @code{4} pour une @notation{noire} et ainsi de
374 suite. Les @notation{crochets} et @notation{liens} sont ajoutés
377 Si aucune durée n'est indiquée pour une note, la dernière durée entrée
378 est utilisée. En l'absence d'indication de durée, la première note
381 @lilypond[verbatim,quote]
385 a16 a a a a32 a a a a64 a a a a a a a a2
389 Une @notation{note pointée} s'obtient en ajoutant un point @code{.} à
390 la valeur rythmique. Le point doit être précédé d'un nombre spécifiant
393 @lilypond[verbatim,quote]
404 @cindex notation des silences
406 Glossaire musical : @rglos{rest}.
408 On saisit un @notation{silence} tout comme une note, mais avec la
409 lettre @code{r} (pour @emph{rest}).
411 @lilypond[verbatim,quote]
422 @cindex chiffre de mesure
427 Glossaire musical : @rglos{time signature}.
429 La @notation{métrique}, aussi appelée @notation{chiffre de mesure},
430 peut être définie à l'aide de la commande @code{\time} :
432 @lilypond[verbatim,quote]
455 Glossaire musical : @rglos{clef}.
457 La @notation{clef} peut être définie à l'aide de la commande
460 @lilypond[verbatim,quote]
474 @subheading Tout ensemble
476 Voici un bref exemple qui rassemble tous les éléments que nous déjà
479 @lilypond[verbatim,quote]
490 Manuel de notation : @ruser{Writing pitches},
491 @ruser{Writing rhythms}, @ruser{Writing rests},
492 @ruser{Time signature}, @ruser{Clef}.
495 @node Working on input files
496 @subsection Working on input files
498 Le traitement des fichiers source de LilyPond est semblable à celui du
499 code de nombreux langages de programmation. La casse est prise
500 en compte, et les caractères considérés comme espaces ont généralement
501 peu d'importance. Les expressions sont délimitées par des accolades @{
502 @}, et les commentaires par @code{%} ou @code{%@{ ... %@}}.
504 Si cette phrase vous paraît incompréhensible, ne vous en faites pas !
505 Expliquons tous ces termes :
509 @cindex casse, prise en compte de
510 @cindex prise en compte de la casse
511 @cindex sensibilité à la casse
515 LilyPond est sensible à la casse, c'est à dire qu'une lettre capitale
516 n'a pas la même valeur qu'une lettre minuscule. Les notes, par
517 exemple, doivent être entrées en minuscule : @code{@{ c d e @}} est
518 un code valide, alors que @code{@{ C D E @}} produira un message
521 @cindex espaces multiples, insensibilité
522 @cindex insensibilité aux espaces multiples
524 @item @strong{Les espaces multiples} :
525 LilyPond ne tient pas compte du nombre d'espaces, ou de retours à la
526 ligne. @code{@{ c d e @}} a le
527 même sens que @code{@{ c @tie{} @tie{} d @tie{} e @}} ou que
535 Bien sûr, ce dernier exemple est illisible. Une bonne habitude
536 à prendre est d'indenter les blocs de code avec soit des tabulations
537 soit des doubles espaces :
549 @item @strong{Expressions musicales} :
550 Tout morceau saisi dans LilyPond doit être placé entre @strong{@{
551 accolades @}}. Ces caractères indiquent à LilyPond que ce bloc de
552 texte représente une et une seule expression musicale, tout comme les
553 parenthèses @code{()} en mathématiques. Pour éviter toute ambiguïté,
554 il est préférable d'entourer ces accolades d'espaces ou de retours à
557 Un appel de fonction --- @w{@code{\relative @{ @}}} par exemple ---
558 compte également comme une seule expression musicale.
561 @cindex commentaire de fin de ligne
562 @cindex commentaire-bloc
563 @cindex bloc de commentaire
566 @funindex %@{ ... %@}
568 @item @strong{Les commentaires} :
569 Un commentaire est une indication pour tout lecteur humain d'un
570 fichier source de musique ; il est ignoré par l'ordinateur, et n'a
571 donc aucun effet sur la partition imprimée. On distingue deux types
572 de commentaires. Le commentaire de fin de ligne, introduit par le
573 symbole @code{%} : tout ce qui suit ce symbole sur la même ligne sera
574 ignoré. Par convention, un commentaire qui occupe une ligne entière
575 se place juste @emph{au-dessus} de la ligne à laquelle il fait
580 % ce commentaire fait référence aux si
584 Le bloc de commentaire, qui peut occuper plusieurs lignes, voire toute
585 une section : tout ce qui se trouve entre @code{%@{} et @code{%@}} est
586 ignoré. Les blocs de commentaires ne peuvent s'imbriquer, ce qui
587 signifie que vous ne pouvez pas placer un commentaire-bloc à
588 l'intérieur d'un autre commentaire-bloc. Si jamais vous essayez, vous
589 verrez que la première occurence de @code{%@}} terminera @qq{les
590 @emph{deux} commentaires-blocs}. Le fragment suivant met en évidence
591 quelques usages possibles des commentaires :
594 % voici les notes de "ah vous dirai-je maman"
598 Ces lignes et les notes qui suivent
599 seront ignorées, car elles se trouvent
600 dans un bloc de commentaire.
610 @node How to read the manual
611 @subsection How to read the manual
613 @cindex bien lire le manuel
614 @cindex manuel, lecture
615 @cindex compulser le manuel
616 @cindex exemples cliquables
617 @cindex cliquables, exemples
618 @cindex conseils de construction des fichiers
620 @cindex construction des fichiers, conseils
621 @cindex fichiers, conseils de construction
623 Comme nous l'avons vu dans @ref{Working on input files}, un code
624 LilyPond doit être encadré par des accolades @{ @} ou bien par
625 @code{@w{\relative c'' @{ ... @}}}. Cependant, dans la suite de ce
626 manuel, la plupart des exemples ne feront pas apparaître ces signes.
628 Pour reproduire les exemples, vous pouvez copier et coller le code
629 affiché, mais @strong{à condition} d'ajouter
630 @code{@w{\relative c'' @{ @}}} de la façon suivante :
634 ...collez ici votre exemple...
638 Pourquoi avoir omis les accolades ? La plupart des exemples de ce
639 manuel peuvent être insérés au milieu d'un morceau de musique plus
640 long. Il n'y a donc aucune raison d'ajouter @code{@w{\relative c'' @{
641 @}}} à ces exemples --- en effet, il n'est pas possible d'insérer une
642 expression @code{\relative} à l'intérieur d'un autre expression
643 @code{\relative}. Si nous mettions tous nos exemples dans une
644 expression @code{\relative}, vous ne pourriez plus copier un bref
645 exemple de la documentation pour le coller dans vos pièces.
648 @subheading Exemples cliquables
650 Beaucoup de gens apprennent à utiliser les programmes en les essayant
651 et en bidouillant avec. C'est également possible avec LilyPond. Si
652 vous cliquez sur une image dans la version HTML de ce manuel, vous
653 verrez exactement le code LilyPond utilisé pour générer cette image.
654 Essayez sur cette image :
658 @lilypond[quote,ragged-right]
660 c-\markup { \bold \huge { Cliquez ici. } }
664 En copiant-collant le code à partir du commentaire @qq{ly snippet}
665 vers un fichier test, vous aurez un modèle de base pour faire vos
666 expériences. Pour obtenir une gravure à l'identique, copiez tout le
667 code à partir de @qq{Start cut-&-pastable section}.
669 @c No longer in the text in English, but should we really
672 Si vous apprenez de cette façon, vous aurez probablement envie
673 d'imprimer ou de garder un lien vers @ruser{Cheat sheet}, tableau
674 qui répertorie les commandes usuelles pour une consultation rapide.
679 Vous trouverez plus de conseils pour construire des fichiers source
680 dans @ref{Suggestions for writing LilyPond input files}. Cependant,
681 lors d'une première lecture il est préférable de terminer d'abord la
685 @node Single staff notation
686 @section Single staff notation
688 Cette section présente la notation courante dont on a besoin pour
689 écrire une voix sur une portée.
692 * Accidentals and key signatures::
694 * Articulation and dynamics::
696 * Automatic and manual beams::
697 * Advanced rhythmic commands::
701 @node Accidentals and key signatures
702 @subsection Accidentals and key signatures
704 @subheading Accidentals
709 @cindex dièse, double
712 @cindex bémol, double
719 Glossaire musical : @rglos{sharp}, @rglos{flat}, @rglos{double sharp},
720 @rglos{double flat}, @rglos{accidental}.
722 Dans la notation par défaut, on obtient un @notation{dièse} en
723 ajoutant @code{is} au nom de la note, et un @notation{bémol} en
724 ajoutant @code{es}. Comme vous pouvez vous y attendre, un double
725 dièse ou double bémol s'obtiennent en ajoutant @code{isis} ou
726 @code{eses}. Cette syntaxe est dérivée de la convention de
727 dénomination des notes dans les langues nordiques et germaniques,
728 comme l'allemand ou le hollandais.
731 Cependant, si vous utilisez la commande
732 @code{@w{\include@tie{}"italiano.ly"}} pour entrer les noms de notes
733 français au lieu des noms hollandais, il faudra ajouter un @code{d} pour
734 obtenir un dièse, et un @code{b} pour un bémol. Le double dièse et le
735 double bémol s'obtiennent en ajoutant respectivement @code{dd} et
736 @code{bb}. Pour en savoir plus sur les autres langues disponibles,
737 consultez @ruser{Note names in other languages}.
740 @lilypond[verbatim,quote,relative=2]
741 cis1 ees fisis, aeses
744 @subheading Key signatures
746 @cindex armure, définition de l'
747 @cindex armure, altérations à l'
748 @cindex altérations à l'armure
759 Glossaire musical : @rglos{key signature}, @rglos{major},
762 L'armure est déterminée par la commande @code{\key}, suivie d'une
763 hauteur puis de @code{\major} (majeur) ou @code{\minor} (mineur).
765 @lilypond[verbatim,quote,relative=2]
774 @subheading Warning: key signatures and pitches
776 Glossaire musical : @rglos{accidental}, @rglos{key signature},
777 @rglos{pitch}, @rglos{flat}, @rglos{natural}, @rglos{sharp},
778 @rglos{transposition}.
780 La combinaison de l'@notation{armure} et des hauteurs de note --- y
781 compris les altérations --- permet à LilyPond de déterminer dans quel
782 cas imprimer des @notation{altérations accidentelles}. L'armure
783 n'affecte que les altérations @emph{imprimées}, et non les hauteurs
784 réelles ! Cette fonctionnalité est souvent source de confusion pour
785 les nouveaux utilisateurs, aussi expliquons-la en détail.
787 LilyPond fait une distinction nette entre le contenu musical et la
788 mise en forme. L'altération d'une note --- @notation{bémol},
789 @notation{bécarre} ou @notation{dièse} --- fait partie de sa hauteur,
790 et relève donc du contenu musical. La gravure ou non d'une altération
791 accidentelle --- un @emph{signe} bémol, bécarre ou dièse --- devant la
792 note correspondante est une question qui relève de la mise en forme.
793 La gravure d'une partition suit des règles, en particulier des règles
794 d'indication des altérations accidentelles. Les hauteurs de note, en
795 revanche, relèvent de ce que vous voulez entendre ; et, dans la mesure
796 où la musique que vous entrez est censée être celle que vous voulez
797 entendre, LilyPond, qui n'est chargé que de la gravure, ne les
798 choisira pas à votre place.
802 @lilypond[verbatim,quote,relative=2]
808 aucune note n'a d'altération accidentelle, et pourtant vous devrez
809 entrer le @code{is} pour les notes @code{cis} et @code{fis}.
811 Le code @code{b} ne veut pas dire @qq{Imprimez-moi un point noir sur
812 la troisième ligne de la portée.} Cela signifie plutôt : @qq{Ici se
813 trouve une note dont la hauteur est un si naturel.} Avec une armure
814 de la bémol majeur, ce @code{si} est flanqué d'un bécarre accidentel :
816 @lilypond[verbatim,quote,relative=2]
821 Ajouter explicitement toutes les altérations demande un peu plus
822 d'effort dans la phase de saisie, mais cela facilite grandement la
823 @notation{transposition}. De plus, les altérations accidentelles
824 peuvent ainsi être imprimées suivant plusieurs conventions. Pour
825 connaître les différentes manières dont les altérations accidentelles
826 peuvent être imprimées, consultez @ruser{Automatic accidentals}.
830 Manuel de notation : @ruser{Note names in other languages},
831 @ruser{Accidentals}, @ruser{Automatic accidentals},
832 @ruser{Key signature}.
834 Glossaire musical : @rglos{Pitch names}.
838 @subsection Ties and slurs
840 @cindex liaisons de prolongation
841 @cindex liaisons de tenue
842 @cindex prolongation, liaisons de
843 @cindex durée, liaisons de
844 @cindex tenue, liaisons de
852 Glossaire musical : @rglos{tie}.
854 Pour créer une liaison de prolongation@footnote{parfois aussi appelée
855 liaison de tenue}, on ajoute un tilde @code{~} à la première note
858 @lilypond[verbatim,quote,relative=2]
863 @cindex liaisons d'articulation
864 @cindex articulation, liaisons d'
868 @c Le terme de "slur" a deux sens en français : articulation et phrasé.
869 @c Je garde ici le terme "legato", tel qu'il apparaît dans le texte original,
870 @c car c'est celui qui me semble le plus couramment employé.
871 @c slur = "il zon" (articulation). jcm
872 @c phrasing slur = "ils ont des chapeaux ronds" (phrase). jcm
874 Glossaire musical : @rglos{slur}, @rglos{phrasing}.
876 Une liaison d'articulation ou @emph{legato} peut englober
877 plusieurs notes. Les notes de départ et d'arrivée sont suivies
878 respectivement d'un signe @code{(} et @code{)}.
880 @lilypond[verbatim,quote,relative=2]
881 d4( c16) cis( d e c cis d) e( d4)
884 @cindex liaisons de phrasé
885 @cindex phrasé, liaisons de
887 @subheading Phrasing slurs
889 De plus longues liaisons, dites de phrasé, sont délimitées par @code{\(} et
890 @code{\)}. Il est possible d'avoir en même temps des legatos et des
891 phrasés, mais pas plusieurs liaisons de phrasé ou de @emph{legato} à la fois.
893 @lilypond[verbatim,quote,relative=2]
894 a8(\( ais b c) cis2 b'2 a4 cis,\)
899 @cindex liaisons d'articulation et de prolongation, différences
900 @subheading Warnings: slurs vs. ties
902 Glossaire musical : @rglos{articulation}, @rglos{slur}, @rglos{tie}.
904 Une liaison d'articulation ou de phrasé ressemble à une liaison de
905 prolongation, mais n'a pas la même signification. Alors qu'une
906 liaison de prolongation ne peut relier que deux notes de même hauteur,
907 le @emph{legato} indique une articulation de plusieurs notes,
908 éventuellement en grand nombre. Les liaisons de tenue peuvent être
909 enchâssées dans un @emph{legato} ou un phrasé.
911 @lilypond[verbatim,quote,relative=2]
912 c2~( c8 fis fis4 ~ fis2 g2)
917 Manuel de notation : @ruser{Ties}, @ruser{Slurs},
918 @ruser{Phrasing slurs}.
921 @node Articulation and dynamics
922 @subsection Articulation and dynamics
924 @subheading Articulations
930 Glossaire musical : @rglos{articulation}.
932 Des @notation{articulations} peuvent être ajoutées à une note, au moyen
933 d'un tiret @code{-} suivi d'un caractère :
935 @lilypond[verbatim,quote,relative=2]
936 c-. c-- c-> c-^ c-+ c-_
939 @subheading Fingerings
946 Glossaire musical : @rglos{fingering}.
948 De même, des indications de doigté peuvent être ajoutées à une note en
949 utilisant un tiret (@samp{-}) et le chiffre à écrire :
951 @lilypond[verbatim,quote,relative=2]
955 Articulations et doigtés sont habituellement placés automatiquement,
956 mais vous pouvez spécifier leur positionnement en utilisant @code{^} (en
957 haut) ou @code{_} (en bas). Vous pouvez aussi utiliser plusieurs
958 articulations sur la même note. Dans la plupart des cas, cependant,
959 il est bon de laisser LilyPond déterminer l'emplacement de
962 @lilypond[verbatim,quote,relative=2]
963 c_-^1 d^. f^4_2-> e^-_+
981 Glossaire musical : @rglos{dynamics}, @rglos{crescendo},
984 On obtient un signe de @notation{nuance} en ajoutant à la note les
985 lettres du signe, précédées d'un anti-slash @code{\} :
987 @lilypond[verbatim,quote,relative=2]
995 @c Pluriel des termes musicaux italiens :
996 @c selon Littré, plutôt à la française (en "-os" qu'en "-i")
998 @notation{Crescendos} et @notation{decrescendos} débutent avec les
999 commandes @code{\<} et @code{\>}. Ils se terminent soit par une
1000 nuance d'arrivée, par exemple @code{\f}, soit par la commande
1003 @lilypond[verbatim,quote,relative=2]
1004 c2\< c2\ff\> c2 c2\!
1009 Manuel de notation : @ruser{Articulations and ornamentations},
1010 @ruser{Fingering instructions}, @ruser{Dynamics}.
1014 @subsection Adding text
1016 @cindex texte, ajout de
1017 @cindex ajout de texte
1023 On peut ajouter du texte à une partition :
1025 @lilypond[verbatim,quote,relative=2]
1026 c1^"espr" a_"legato"
1029 Pour mettre en forme du texte, on utilise la commande @code{markup} :
1031 @lilypond[verbatim,quote,relative=2]
1032 c1^\markup{ \bold espr}
1034 \dynamic f \italic \small { 2nd } \hspace #0.1 \dynamic p
1040 Manuel de notation : @ruser{Writing text}.
1043 @node Automatic and manual beams
1044 @subsection Automatic and manual beams
1047 @cindex barre de ligature
1048 @cindex ligatures automatiques
1049 @cindex ligatures manuelles
1050 @cindex ligatures explicites
1055 @funindex \autoBeamOff
1056 @funindex autoBeamOff
1057 @funindex \autoBeamOn
1058 @funindex autoBeamOn
1060 Glossaire musical : @rglos{beam}.
1062 Toutes les barres de ligature sont dessinées automatiquement :
1064 @lilypond[verbatim,quote,relative=2]
1065 a8 ais d ees r d c16 b a8
1069 Lorsqu'on n'aime pas la manière dont les notes sont automatiquement
1070 groupées, il est possible de les ligaturer manuellement, en marquant la
1071 première note à attacher d'un crochet ouvrant @code{[} et la dernière
1072 d'un crochet fermant @code{]}.
1074 @lilypond[verbatim,quote,relative=2]
1075 a8[ ais] d[ ees r d] a b
1078 Pour désactiver les barres de ligature automatiques pour des passages
1079 entiers, utilisez la commande @code{\autoBeamOff}, et utilisez
1080 @code{\autoBeamOn} pour les réactiver.
1082 @lilypond[verbatim,quote,relative=2]
1091 Manuel de notation : @ruser{Automatic beams}, @ruser{Manual beams}.
1094 @node Advanced rhythmic commands
1095 @subsection Advanced rhythmic commands
1097 @subheading Partial measure
1101 @cindex mesure incomplète
1106 Glossaire musical : @rglos{anacrusis}.
1108 On crée une levée (ou anacrouse) avec la commande @code{\partial},
1109 suivie d'une durée : @code{\partial 4} produit une levée d'une noire
1110 et @code{\partial 8} d'une croche.
1112 @lilypond[verbatim,quote,relative=2]
1125 Glossaire musical : @rglos{note value}, @rglos{triplet}.
1127 Les @notation{nolets} sont créés avec la commande @code{\times}, qui
1128 prend deux arguments : une fraction et une expression musicale. La
1129 durée des notes de l'expression musicale est multipliée par la
1130 fraction. Par exemple les notes d'un @notation{triolet} durent les
1131 deux tiers de la durée de leur notation réelle, cette fraction est
1132 donc de 2/3 pour les triolets :
1134 @lilypond[verbatim,quote,relative=2]
1135 \times 2/3 { f8 g a }
1136 \times 2/3 { c r c }
1137 \times 2/3 { f,8 g16[ a g a] }
1138 \times 2/3 { d4 a8 }
1141 @subheading Grace notes
1143 @cindex notes d'ornement
1144 @cindex ornementation
1145 @cindex appoggiature
1146 @cindex acciaccature
1150 @funindex \acciaccatura
1151 @funindex acciaccatura
1152 @funindex \appoggiatura
1153 @funindex acciaccatura
1155 Glossaire musical : @rglos{grace notes}, @rglos{acciaccatura},
1156 @rglos{appoggiatura}.
1158 Des @notation{notes d'ornement} s'obtiennent en appliquant la commande
1159 @code{\grace}, @code{\appoggiatura} ou @code{\acciaccatura} à une
1160 expression musicale :
1162 @lilypond[verbatim,quote,relative=2]
1163 c2 \grace { a32[ b] } c2
1164 c2 \appoggiatura b16 c2
1165 c2 \acciaccatura b16 c2
1170 Manuel de notation : @ruser{Grace notes}, @ruser{Tuplets},
1174 @node Multiple notes at once
1175 @section Multiple notes at once
1177 Cette section traite de situations où l'on a plus d'une note à la fois :
1178 plusieurs instruments, plusieurs voix ou portées pour un même
1179 instrument (le piano, par exemple), et les accords.
1181 En théorie musicale, la polyphonie désigne une musique constituée de
1182 plusieurs voix ; dans LilyPond, ce terme désigne les situations où il
1183 y a plus d'une voix sur une même portée.
1186 * Music expressions explained::
1189 * Combining notes into chords::
1190 * Single staff polyphony::
1194 @node Music expressions explained
1195 @subsection Music expressions explained
1197 @cindex expression musicale
1199 Dans les fichiers source LilyPond, la musique est représentée par ce
1200 qu'on appelle des @emph{expressions musicales}. En soi, une seule note
1201 peut constituer une expression musicale :
1203 @lilypond[verbatim,quote,relative=2]
1207 Mettre un groupe de notes entre accolades crée une nouvelle expression
1208 musicale, appelée @emph{expression musicale composée}. En voici un
1209 exemple avec deux notes :
1211 @lilypond[verbatim,quote,relative=2]
1215 La mise entre accolades d'une séquence d'expressions musicales --- des
1216 notes par exemple --- signifie qu'elles doivent être jouées
1217 successivement, les unes après les autres. Le résultat est une
1218 expression, qui peut elle-même être regroupée séquentiellement avec
1219 d'autres expressions. Ici, l'expression de l'exemple précédent est
1220 combinée à deux notes :
1222 @lilypond[verbatim,quote,relative=2]
1226 @subheading Analogy: mathematical expressions
1230 Ce mécanisme est similaire aux formules mathématiques : une grosse
1231 formule est créée en assemblant plusieurs petites formules. De telles
1232 formules sont appelées expressions, elles ont une définition
1233 récursive, de telle sorte que vous pouvez fabriquer des expressions
1234 arbitrairement longues et complexes. Par exemple :
1243 ((1 + 2) * 3) / (4 * 5)
1246 Ceci est une suite d'expressions, où chacune est contenue dans la
1247 suivante. Les expressions les plus simples sont les nombres, et de
1248 plus grandes expressions sont produites en combinant des expressions
1249 avec des opérateurs --- comme @code{+}, @code{*} et @code{/} --- et
1250 des parenthèses. Tout comme les expressions mathématiques, les
1251 expressions musicales peuvent être imbriquées avec une profondeur
1252 arbitraire, ce qui est nécessaire pour des partitions complexes comme
1253 de la musique polyphonique.
1256 @subheading Simultaneous music expressions: multiple staves
1258 @cindex portées multiples
1260 @cindex combinaison d'expressions en parallèle
1261 @cindex parallèles, expressions
1262 @cindex expressions parallèles
1263 @cindex hauteur relative et musique simultanée
1264 @cindex musique simultanée et hauteur relative
1265 @cindex hauteur relative et expressions parallèles
1266 @cindex expressions parallèles et hauteur relative
1272 Glossaire musical : @rglos{polyphony}.
1274 Cette technique est utile pour de la musique @notation{polyphonique}.
1275 Pour entrer une musique avec plusieurs voix ou plusieurs portées, nous
1276 pouvons aussi combiner @emph{en parallèle} les expressions : deux voix
1277 qui doivent être jouées en même temps, sont entrées comme une
1278 combinaison simultanée de deux expressions. Une expression musicale
1279 @qq{simultanée} est formée en entourant les expressions entre @code{<<}
1280 et @code{>>}. Dans l'exemple suivant, trois expressions (contenant
1281 chacune deux notes distinctes) sont combinées simultanément.
1283 @lilypond[verbatim,quote]
1293 Notez que nous avons ici indenté chaque niveau du fichier d'entrée
1294 avec un nombre d'espaces différent. LilyPond se moque --- ou presque
1295 --- de l'espace qu'il peut y avoir ou non au début d'une ligne, mais
1296 un code bien indenté est bien plus lisible par des humains.
1298 @warning{la hauteur de chaque note saisie est relative à la précédente,
1299 mais pas au @code{c''} de la commande @code{\relative} de départ.}
1302 @subheading Simultaneous music expressions: single staff
1304 Pour déterminer le nombre de portées, LilyPond regarde le début
1305 de la première expression. Si c'est une seule note, une seule portée
1306 est produite ; si c'est une expression simultanée, plusieurs portées
1309 @lilypond[verbatim,quote]
1312 << { e f } { c <<b d>> } >>
1317 @node Multiple staves
1318 @subsection Multiple staves
1320 @cindex multiples portées
1321 @cindex portées multiples
1323 @cindex contexte de notation
1324 @cindex notation, contexte
1326 @funindex \new Staff
1334 @funindex ChordNames
1336 Comme nous l'avons vu dans @ref{Music expressions explained}, un
1337 fichier d'entrée LilyPond est fait d'expressions musicales. Si la
1338 partition commence par plusieurs expressions simultanées, LilyPond
1339 créera plusieurs portées. Cependant, il est plus facile de prévoir le
1340 nombre de portées si on les crée explicitement, ce que nous allons
1343 Pour créer plus d'une portée, on ajoute @code{\new Staff} au début de
1344 chaque partie de la musique constituant une portée. Ces éléments
1345 @code{Staff} sont ensuite combinés en parallèle avec @code{<<} et
1346 @code{>>}, comme ci-dessous.
1348 @lilypond[verbatim,quote]
1351 \new Staff { \clef treble c }
1352 \new Staff { \clef bass c,, }
1358 La commande @code{\new} introduit un @qq{contexte de notation}. Un
1359 contexte de notation est un environnement dans lequel les événements
1360 musicaux --- comme les notes ou les commandes @code{\clef} --- sont
1361 interprétés. Pour des pièces simples, ces contextes sont créés
1362 automatiquement. Pour des pièces plus complexes, il est préférable de
1363 spécifier explicitement les contextes, afin de s'assurer que chaque
1364 fragment aura sa propre portée.
1366 Il existe différents types de contextes. Les contextes @code{Score}
1367 (partition), @code{Staff} (portée) et @code{Voice} (voix) gèrent la
1368 notation de la mélodie, alors que @code{Lyrics} gère les paroles et
1369 @code{ChordNames} imprime des noms d'accords.
1371 En terme de syntaxe, ajouter @code{\new} devant une expression
1372 musicale crée une plus grande expression musicale. En reprenant la
1373 comparaison précédente, cela ressemble au signe @emph{moins} en
1374 mathématiques. La formule @math{(4+5)} est une expression, donc
1375 @math{-(4+5)} constitue une plus grande expression.
1377 Les chiffres de métrique indiqués sur une portée affectent toutes les
1378 autres portées@footnote{Ce comportement peut être modifié si
1379 nécessaire, voir @ruser{Polymetric notation}}. En revanche l'armure
1380 d'une portée n'affecte @emph{pas} les autres portées. Ces
1381 caractéristiques par défaut se justifient par le fait que
1382 l'utilisation d'instruments transpositeurs est bien plus fréquente que
1383 la musique polyrythmique.
1385 @lilypond[verbatim,quote]
1388 \new Staff { \clef treble \key d \major \time 3/4 c }
1389 \new Staff { \clef bass c,, }
1396 @subsection Staff groups
1398 @cindex portée double
1399 @cindex portée pour piano
1400 @cindex piano, portée pour
1401 @cindex clavier, portée pour
1402 @cindex chœur, système pour
1403 @cindex système pour chœur
1405 @cindex portées, regroupement de
1406 @cindex regroupement de portées
1408 @funindex PianoStaff
1409 @funindex GrandStaff
1410 @funindex ChoirStaff
1412 Glossaire musical : @rglos{brace}.
1414 La musique pour piano s'écrit sur deux portées reliées par une
1415 @notation{accolade}. La gravure de ce type de portée est semblable à
1416 l'exemple de musique polyphonique de @ref{Multiple staves}, mais
1417 maintenant cette expression entière est interprétée dans un contexte
1427 Voici un bref exemple :
1429 @lilypond[verbatim,quote]
1432 \new Staff { \time 2/4 c4 e g g, }
1433 \new Staff { \clef bass c,, c' e c }
1438 Vous pouvez générer d'autres de regroupement, avec
1439 @code{\new GrandStaff} pour un e partition d'orchestre, ou
1440 @w{@code{\new ChoirStaff}} qui sied particulièrement aux partitions
1441 chorales. Chacun de ces regroupements constituent un contexte à part
1442 entière, avec ses particularités, tant au niveau du signe qui regroupe
1443 les portées au sein d'un @notation{système} qu'au niveau de l'étendue
1444 des barres de mesure.
1448 Manuel de notation : @ruser{Keyboard and other multi-staff instruments},
1449 @ruser{Displaying staves}.
1452 @node Combining notes into chords
1453 @subsection Combining notes into chords
1455 @cindex accords, notes simultanées
1456 @cindex accords et durée
1462 Glossaire musical : @rglos{chord}.
1464 Nous avons vu précédemment comment combiner des notes simultanément,
1465 en les encadrant par des chevrons doubles @code{<<} et @code{>>}. Pour
1466 produire des accords simples, c'est-à-dire une superposition de notes
1467 de même durée, on encadre les hauteurs de notes par des chevrons simples
1468 @code{<} et @code{>}, et on écrit la durée juste après.
1470 @lilypond[verbatim,quote,relative=2]
1471 r4 <c e g>4 <c f a>2
1474 Beaucoup d'éléments de notation que l'on peut attacher à une note
1475 simple, comme une liaison, un crochet indiquant un début ou une fin de
1476 lien, un signe d'articulation, peuvent être également attachés à un
1477 accord : il faut ajouter ces indications après les hauteurs et la
1478 durée, donc @emph{à l'extérieur} des chevrons.
1480 @lilypond[verbatim,quote,relative=2]
1481 r4 <c e g>8[ <c f a>]~ <c f a>2
1482 r4 <c e g>8( <c e g>\> <c e g>4 <c f a>\!)
1486 @node Single staff polyphony
1487 @subsection Single staff polyphony
1490 @cindex voix multiples sur une portée
1491 @cindex silence invisible
1492 @cindex invisible, silence
1494 @funindex << ... \\ ... >>
1499 Bien que LilyPond gère la musique polyphonique sans difficulté, cela
1500 fait appel à des concepts que nous n'avons pas encore abordés. C'est la
1501 raison pour laquelle nous ne nous étendrons pas tout de suite sur ce
1502 sujet et préférons vous inciter à consulter les chapitres dédiés à
1503 l'étude de ces concepts.
1506 Learning Manual: @ref{Voices contain music}.
1508 Manuel de notation : @ruser{Simultaneous notes}.
1514 Cette section présente l'écriture vocale et les partitions de variété.
1517 * Setting simple songs::
1518 * Aligning lyrics to a melody::
1519 * Lyrics to multiple staves::
1523 @node Setting simple songs
1524 @subsection Setting simple songs
1529 @funindex \addlyrics
1532 Glossaire musical : @rglos{lyrics}.
1534 Prenons une mélodie toute simple, la comptine @emph{Girls and boys
1537 @lilypond[verbatim,quote]
1541 d4 b8 c4 a8 d4 b8 g4
1545 Des @notation{paroles} peuvent être associées à ces notes, en les
1546 combinant avec la commande @code{\addlyrics}. On entre les paroles en
1547 séparant chaque syllable par un espace :
1549 @lilypond[verbatim,quote]
1554 d4 b8 c4 a8 d4 b8 g4
1557 Girls and boys come out to play,
1562 Remarquez les accolades embrassant la musique et celles embrassant les
1563 paroles, ainsi que les doubles chevrons encadrant toute la pièce ; ces
1564 derniers indiquent simplement que la musique et les paroles se
1565 produisent en même temps.
1568 @node Aligning lyrics to a melody
1569 @subsection Aligning lyrics to a melody
1572 @cindex ligne d'extension
1573 @cindex trait d'union (paroles)
1574 @cindex caractère souligné (paroles)
1575 @cindex paroles, alignement des
1576 @cindex alignement des paroles
1577 @cindex paroles, mot de plusieurs syllabes
1579 Glossaire musical : @rglos{melisma}, @rglos{extender line}.
1581 La deuxième ligne de la comptine précédente est @emph{The moon doth
1582 shine as bright as day}. Ajoutons-la au code.
1584 @lilypond[verbatim,quote]
1589 d4 b8 c4 a8 d4 b8 g4
1590 g8 a4 b8 c b a d4 b8 g4.
1593 Girls and boys come out to play,
1594 The moon doth shine as bright as day;
1599 Remarquez que les paroles ajoutées ne s'alignent pas bien avec les
1600 notes. Le mot @emph{shine} devrait être chanté sur deux notes au lieu
1601 d'une. On appelle ceci un @notation{mélisme} : il s'agit d'une seule
1602 syllabe chantée sur plus d'une note. Il existe plusieurs façons
1603 d'étaler une sylabe sur plusieurs notes, la plus simple étant de lier
1604 les notes du mélisme. Pour les détails, consultez @ref{Ties and
1607 @lilypond[verbatim,quote]
1612 d4 b8 c4 a8 d4 b8 g4
1613 g8 a4 b8 c( b) a d4 b8 g4.
1616 Girls and boys come out to play,
1617 The moon doth shine as bright as day;
1622 Les paroles sont maintenant correctement alignées, mais les liens de
1623 croche automatiques ne conviennent pas pour les notes au-dessus de
1624 @emph{shine as}. On peut les corriger en ajoutant des liens de croche
1625 manuels, pour ceci consultez @ref{Automatic and manual beams}.
1627 @lilypond[verbatim,quote]
1632 d4 b8 c4 a8 d4 b8 g4
1633 g8 a4 b8 c([ b]) a d4 b8 g4.
1636 Girls and boys come out to play,
1637 The moon doth shine as bright as day;
1642 Au lieu d'utiliser une liaison, on peut indiquer le mélisme dans les
1643 paroles en insérant un caractère souligné @code{_} pour chaque note du
1644 mélisme sauf la première.
1646 @lilypond[verbatim,quote]
1651 d4 b8 c4 a8 d4 b8 g4
1652 g8 a4 b8 c[ b] a d4 b8 g4.
1655 Girls and boys come out to play,
1656 The moon doth shine _ as bright as day;
1661 Si une syllabe s'étend sur un grand nombre de notes ou une note très
1662 longue, on représente souvent le mélisme par un @notation{trait de
1663 prolongation}, qu'on entre avec @code{__}. L'exemple suivant montre
1664 les trois premières mesures de la plainte de Didon, extraite de
1665 @notation{Didon et Énée} de Purcell.
1667 @lilypond[verbatim,quote]
1673 b c4.( bes8 a4. g8 fis4.) g8 fis1
1677 am laid __ in earth,
1682 Aucun exemple jusqu'à présent n'a utilisé de mots de plus d'une
1683 syllabe. Dans des paroles, de tels mots sont écrits en syllabes
1684 séparées par des traits d'union. Avec LilyPond, on utilise deux
1685 tirets pour produire un trait d'union centré entre deux syllabes.
1686 L'exemple suivant montre tout ce que nous avons vu jusqu'à maintenant
1687 sur l'alignement de paroles à une mélodie.
1689 @c no ragged-right here because otherwise the hyphens get lost,
1690 @c but the example is long enough to avoid looking strange.
1691 @lilypond[verbatim,quote,noragged-right]
1697 d4 g4 g a8( b) g4 g4
1701 A -- way in a __ man -- ger,
1702 no __ crib for a bed, __
1707 Avec certaines paroles, en particulier en italien, il se produit la
1708 situation inverse : il peut y avoir plusieurs syllabes sur une seule
1709 note. On réalise ceci avec LilyPond grâce à un caractère souligné
1710 @code{_} sans espace entre les syllabes, ou alors en groupant les
1711 syllabes avec des guillemets. L'exemple suivant est extrait de l'air
1712 de Figaro @emph{Largo al factotum}, dans @emph{Figaro} de Rossini, où
1713 la syllabe @emph{al} est chantée sur la même note que @emph{go}.
1715 @c no ragged-right here because otherwise the hyphens get lost,
1716 @c but the example is long enough to avoid looking strange.
1717 @lilypond[verbatim,quote,noragged-right]
1723 c4.~ c8 d b c([ d]) b c d b c
1726 Lar -- go_al fac -- to -- tum del -- la cit -- tà
1733 Manuel de notation : @ruser{Vocal music}.
1736 @node Lyrics to multiple staves
1737 @subsection Lyrics to multiple staves
1739 @cindex paroles et portées mutiples
1740 @cindex portées multiples et paroles
1742 La méthode simple d'ajout de paroles avec @code{\addlyrics} peut être
1743 également utilisée pour placer des paroles sous plusieurs portées.
1744 L'exemple suivant est extrait de @emph{Judas Macchabée} de Händel.
1746 @lilypond[verbatim,quote]
1752 c8 c([ bes]) a a([ g]) f f'4. b, c4.~ c4
1755 Let flee -- cy flocks the hills a -- dorn, __
1761 r8 r4. r4 c8 a'([ g]) f f([ e]) d e([ d]) c bes'4
1764 Let flee -- cy flocks the hills a -- dorn,
1769 Pour produire des partitions plus complexes ou plus longues que cet
1770 exemple simple, il est vivement conseillé de séparer la structure de
1771 la partition des notes et paroles, grâce à des variables. Ceci sera
1772 détaillé plus loin dans @ref{Organizing pieces with variables}.
1776 Manuel de notation : @ruser{Vocal music}.
1780 @section Final touches
1782 L'ultime section de ce tutoriel montre comment ajouter une touche
1783 finale à des morceaux simples, et constitue une introduction au reste
1787 * Organizing pieces with variables::
1790 * Absolute note names::
1791 * After the tutorial::
1795 @node Organizing pieces with variables
1796 @subsection Organizing pieces with variables
1799 @cindex variables, définition
1800 @cindex identificateurs
1802 @cindex assignation de variables
1803 @cindex utilisation de variables
1804 @cindex variables, utilisation de
1805 @cindex variables, caractères autorisés dans les
1806 @cindex caractères autorisés dans les variables
1808 Lorsque l'on combine tous les éléments étudiés précédemment pour
1809 écrire des partitions plus longues, les expressions musicales prennent
1810 de l'ampleur et, dans le cas des pièces polyphoniques, deviennent
1811 profondément imbriquées, jusqu'au point où il devient difficile de se
1812 repérer dans le fichier source. Cet inconvénient peut être résolu par
1813 l'utilisation de @emph{variables}.
1815 En utilisant des variables, parfois appelées identificateurs ou
1816 macros, on peut scinder des expressions musicales complexes en des
1817 expressions plus simples. Une variable se définit comme suit :
1820 musiqueToto = @{ @dots{} @}
1823 Le contenu de l'expression musicale @code{musiqueToto} pourra être
1824 utilisé plus loin en faisant précéder son nom d'un anti-slash,
1825 c'est-à-dire @code{\musiqueToto}, tout comme n'importe quelle commande
1826 LilyPond. Toute variable doit être définie @emph{avant} son
1827 utilisation dans une autre expression musicale.
1829 @lilypond[verbatim,quote]
1830 violin = \new Staff {
1835 cello = \new Staff {
1850 Le nom d'une variable ne doit comporter que des caractères
1851 alphabétiques non accentués, aucun nombre ni tiret ne sont autorisés.
1853 On peut utiliser une variable déjà définie autant de fois que l'on
1854 veut, y compris dans la définition d'une nouvelle variable ; par
1855 exemple, cela peut servir à saisir un motif qu'une seule fois, même
1856 s'il se répète un grand nombre de fois dans la pièce.
1858 @lilypond[verbatim,quote]
1859 tripletA = \times 2/3 { c,8 e g }
1860 barA = { \tripletA \tripletA \tripletA \tripletA }
1867 Il est possible d'utiliser des variables de types variés. Par exemple,
1872 aFivePaper = \paper @{ paperheight = 21.0 \cm @}
1875 En fonction de son contenu, un identificateur peut être utilisé à
1876 différents endroits. L'exemple suivant utilise les variable définies
1888 @node Version number
1889 @subsection Version number
1893 @cindex numéro de version
1894 @cindex version, numéro de
1896 @cindex future mise à jour
1897 @cindex mise à jour de fichiers
1898 @cindex fichiers, mise à jour de
1902 @funindex convert-ly
1904 La déclaration @code{\version} stipule le numéro de la version de
1905 LilyPond pour laquelle le fichier a été écrit :
1908 \version @w{"@version{}"}
1912 Par convention, on place cette instruction en début de fichier.
1914 Cette instruction permet de faciliter les mises à jour futures de
1915 LilyPond. Les changements de syntaxe au fil des versions sont gérés
1916 avec un programme dédié, @command{convert-ly}, qui utilise la valeur
1917 de @code{\version} pour déterminer les règles de conversion à
1918 appliquer au fichier source. Pour plus d'informations, consultez
1919 @rprogram{Updating files with convert-ly}.
1923 @subsection Adding titles
1927 @cindex bloc d'en-tête
1932 On indique les informations bibliographiques --- nom du morceau, du
1933 compositeur, numéro d'opus@dots{} --- dans un bloc à part, le bloc
1934 d'en-tête @code{\header}, qui existe indépendamment de l'expression
1935 musicale principale. Le bloc @code{\header} est habituellement placé
1936 en début de fichier, après le numéro de version.
1939 \version @w{"@version{}"}
1947 @dots{} la musique @dots{}
1951 Quand LilyPond traite le fichier, le titre et le compositeur sont
1952 imprimés au début de la partition. Vous trouverez plus d'informations
1953 sur les titres à la section @ruser{Creating titles}.
1956 @node Absolute note names
1957 @subsection Absolute note names
1959 @cindex notes, nom des
1960 @cindex absolu, mode
1962 @cindex hauteurs, valeurs absolues
1963 @cindex noms de note absolus
1965 Jusqu'ici nous n'avons utilisé que le mode @code{\relative} pour
1966 définir les hauteurs de notes. Si c'est souvent le moyen le plus
1967 simple de saisir la musique au clavier, il existe une autre façon de
1968 procéder : le mode de hauteurs absolues.
1970 Si vous omettez la commande @code{\relative}, LilyPond considérera
1971 toutes les hauteurs comme des hauteurs absolues. Un @code{c'} désigne
1972 toujours le do central, un @code{b} se situe une seconde en dessous
1973 du do central, et un @code{g,} est situé sur la première ligne de
1974 la portée en clé de fa.
1976 @lilypond[verbatim,quote]
1984 Voici une gamme sur 4 octaves :
1986 @lilypond[verbatim,quote]
2001 Comme vous pouvez le voir, il faut beaucoup d'apostrophes pour écrire
2002 de la musique dans un registre aigu, comme le montre cet extrait de
2005 @lilypond[verbatim,quote]
2009 cis''8. d''16 cis''8 e''4 e''8
2010 b'8. cis''16 b'8 d''4 d''8
2014 Toutes ces apostrophes rendent le fichier moins lisible, et surtout il
2015 est très probable d'oublier au moins une apostrophe au cours de la
2016 frappe. En mode @code{\relative}, le même exemple devient bien plus
2017 facile à lire et à saisir.
2019 @lilypond[verbatim,quote]
2023 cis8. d16 cis8 e4 e8
2028 Si d'aventure vous faites une erreur d'octaviation, le mode
2029 @code{\relative} la mettra en évidence : toutes les notes suivantes
2030 seront placées à la mauvaise octave. En mode de hauteurs absolues,
2031 une erreur isolée ne serait pas autant visible, et serait donc plus
2032 difficile à dénicher.
2034 Cependant, le mode de hauteurs absolues reste utile pour les musiques
2035 où les intervalles sont étendus, et plus encore pour les fichiers
2036 LilyPond créés par des programmes.
2039 @node After the tutorial
2040 @subsection After the tutorial
2042 Après avoir parcouru ce tutoriel, vous devriez essayer d'écrire un
2043 morceau ou deux. Commencez par copier l'un des modèles types et
2044 ajoutez-y des notes --- consultez les @ref{Templates}. Si vous voulez
2045 employer une notation que vous n'avez pas trouvé dans le tutoriel,
2046 consultez le manuel de notation, en commençant par la @ruser{Musical
2047 notation}. Si vous désirez écrire pour un ensemble instrumental non
2048 couvert par les modèles, lisez la section @ref{Extending the
2051 Après avoir écrit quelques pièces courtes, lisez les chapitres 3 à 5
2052 du manuel d'initiation. Rien ne s'oppose à ce que vous consultiez dès
2053 à présent ces chapitres, bien sûr ! Néanmoins, le reste du manuel
2054 d'initiation part du principe que vous avez déjà bien assimilé la
2055 syntaxe de base de LilyPond. Vous pouvez toujours survoler ces
2056 chapitres 3 à 5, et y revenir plus tard après avoir acquis de
2059 Dans ce tutoriel comme dans le reste de ce manuel, se trouve à chaque
2060 section un paragraphe @strong{Voir aussi} contenant des références
2061 vers d'autres sections : il est conseillé de ne pas les suivre en
2062 première lecture ; lorsque vous aurez lu l'ensemble du manuel
2063 d'initiation, vous pourrez en relisant certaines sections suivre ces
2064 références pour approfondir certains aspects.
2066 Si vous ne l'avez pas encore fait, lisez @ref{About the
2067 documentation}. Les sources de documentation et d'information sur
2068 LilyPond sont vastes, il est normal pour un débutant de ne pas savoir
2069 où chercher ; si vous passez quelques minutes à lire attentivement
2070 cette section, vous vous épargnerez certainement la frustration causée
2071 par des heures de recherches infructueuses.