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
36 @translationof Tutorial
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 * Notation sur une seule portée::
48 * Dernières précisions::
54 @translationof First steps
56 Cette section présente les aspects élémentaires de l'utilisation de
60 * Compilation d'un fichier::
62 * Travail sur les fichiers d'entrée::
63 * Bien lire le manuel::
67 @node Compilation d'un fichier
68 @subsection Compilation d'un fichier
69 @translationof Compiling a file
72 @cindex exemple, premier
73 @cindex premier exemple
75 Pour créer une partition avec LilyPond, on écrit un fichier texte,
76 appelé fichier source, qui décrit la notation musicale. La
77 @emph{compilation} de ce fichier source par LilyPond produit un
78 fichier graphique imprimable, et si on le désire un fichier MIDI qui
79 peut être joué par un séquenceur.
81 Voici un premier exemple simple de fichier source LilyPond.
90 La compilation de ce fichier donnera quelque chose de sembable à
93 @c in this case we don't want verbatim
101 Il est aussi possible d'utiliser les noms de notes français @qq{@w{do
102 re mi fa sol la si}}, en insérant au début du fichier la ligne
103 @code{\include@tie{}"italiano.ly"}.
106 @warning{Tout extrait de code LilyPond doit être entouré d'une
107 @strong{@{ paire d'accolades @}}. De plus, pour éviter toute
108 ambiguïté, il est préférable d'entourer les accolades par des espaces
109 ou retours à la ligne. Bien que certains exemples de ce manuel ne
110 comportent pas d'accolades, ne les oubliez pas dans vos partitions !
111 Pour plus d'informations sur l'affichage des exemples de cette
112 documentation, consultez @ref{Bien lire le manuel}.}
115 @cindex casse, prise en compte de la
116 @cindex prise en compte de la casse
117 @cindex sensibilité à la casse
119 De plus, LilyPond est @strong{sensible à la casse} : le code
120 @w{@code{@{ c d e @}}} est valide, alors que @w{@code{@{ C D E @}}}
121 produira un message d'erreur.
125 @subheading Saisie de la musique et visualisation de la partition produite
129 @cindex partition, lire
130 @cindex lire la partition
131 @cindex éditeurs de texte
132 @cindex LilyPond et MacOS X
133 @cindex MacOS X et LilyPond
134 @cindex LilyPond et Windows
135 @cindex Windows et LilyPond
136 @cindex LilyPond et Unix
137 @cindex Unix et LilyPond
139 Dans cette section nous expliquerons quelles commandes exécuter et
140 comment voir ou imprimer le résultat produit par LilyPond.
142 Notez qu'il existe plusieurs éditeurs de texte disponibles avec un bon
143 support de LilyPond ; consultez @rprogram{LilyPond et les éditeurs de texte}.
145 @warning{Le premier démarrage de LilyPond peut prendre une minute ou
146 deux, afin de générer la liste des polices du système. LilyPond démarre
147 en principe plus rapidement lors des exécutions suivantes.}
150 @subsubheading MacOS X
152 Si vous double-cliquez sur @code{LilyPond.app}, un fichier d'exemple
153 s'ouvrira. Sauvegardez-le, par exemple, sous @file{test.ly} sur votre
154 bureau, puis traitez-le avec la commande de menu
155 @w{@code{Compile > Typeset File}}. Le fichier PDF résultant sera alors
158 À l'avenir, vous aurez certainement recours aux commandes @qq{Nouveau}
159 ou @qq{Ouvrir}. Vous devez enregistrer votre fichier avant de lancer
160 la gravure de la partition par LilyPond. Si une erreur apparaît
161 pendant le traitement, vous la trouverez dans la fenêtre @qq{log}.
163 @subsubheading Windows
165 Sous Windows, double-cliquez sur l'icône LilyPond qui se trouve sur le
166 bureau, un fichier d'exemple s'ouvre dans un simple éditeur de texte.
167 Enregistrez-le, par exemple en tant que @file{test.ly} sur le bureau,
168 puis double-cliquez sur son icône (qui montre une note de musique)
169 pour le traiter. Après quelques secondes, vous obtiendrez un fichier
170 @file{test.pdf} sur le bureau, fichier que vous pourrez ouvrir pour
171 voir la partition gravée. Une autre méthode pour lancer le traitement
172 du fichier @file{test.ly} est de le glisser avec votre souris sur
175 Pour modifier un fichier @file{.ly} existant, faites un clic droit
176 dessus et sélectionnez @qq{Éditer la source}. Pour partir d'un
177 fichier vide, lancez l'éditeur en ouvrant un fichier existant et
178 utilisez la commande @qq{New} du menu @qq{File}.
180 En double-cliquant sur le fichier, vous obtiendrez, en plus du fichier
181 PDF, un fichier @file{.log} qui récapitule les opérations que LilyPond
182 a effectuées sur votre fichier. Si une erreur survient, vous en
183 trouverez les détails dans ce fichier.
187 Créez un fichier texte @file{test.ly} qui contient
196 Pour traiter @file{test.ly}, entrez la commande suivante dans un
204 Vous verrez quelque chose ressemblant à
208 GNU LilyPond @version{}
209 Traitement de « test.ly »
211 Interprétation en cours de la musique...
212 Pré-traitement des éléments graphiques...
213 Détermination du nombre optimal de pages...
214 Répartition de la musique sur une page...
215 Dessin des systèmes...
216 Sortie mise en page vers « test.ps »...
217 Conversion à « ./test.pdf »...
222 Suivant votre installation, ces messages peuvent être traduits ou
227 @node Notation simple
228 @subsection Notation simple
229 @translationof Simple notation
231 @cindex simple, notation
232 @cindex notation simple
234 Il y a certains éléments graphiques de notation que LilyPond ajoute
235 automatiquement. Dans l'exemple suivant, nous n'avons fourni que
236 quatre hauteurs, mais LilyPond a ajouté une clef, un chiffre de mesure
239 @lilypond[verbatim,quote]
246 Ces valeurs automatiques simplifient la saisie du code source dans
247 bien des cas ; nous verrons plus loin comment les indiquer
257 @cindex altérations et mode relatif
258 @cindex mode relatif et altérations
265 Glossaire musical : @rglos{pitch}, @rglos{interval},
266 @rglos{scale}, @rglos{middle C}, @rglos{octave},
269 Le moyen le plus simple d'entrer des notes est d'utiliser le mode
270 d'octaves relatives, ou mode @code{\relative}. Dans ce mode, l'octave
271 de chaque note est sélectionnée automatiquement de façon à ce qu'elle
272 soit la plus proche possible de la note précédente, c'est-à-dire de
273 façon à ce que l'intervalle avec la note précédente soit au plus d'une
274 quarte. Commençons par saisir une partition très simple, à savoir une
277 @lilypond[verbatim,quote]
278 % set the starting point to middle C
285 La note de départ est le @notation{do central}. Chacune des notes qui
286 suivent est placée à l'octave la plus proche de la note précédente ---
287 en d'autres termes, le premier @code{c} est le do central, entre la
288 clef de sol et la clef de fa, puis est suivi par le ré le plus proche,
289 et ainsi de suite. On peut bien sûr créer des mélodies avec de plus
290 grands intervalles, toujours avec le mode @code{\relative} :
292 @lilypond[verbatim,quote]
300 Remarquez que cet exemple ne commence plus sur le do central : la
301 première note --- le @code{d} --- est le ré qui en est le plus proche.
303 Dans l'exemple suivant, on remplace @code{c'} dans la commande
304 @code{@w{\relative c' @{}} par @code{c''}, afin de calculer l'octave de
305 la première note par rapport au do situé une octave au-dessus du do
308 @lilypond[verbatim,quote]
309 % one octave above middle C
315 Le mode d'octaves relatives peut être déroutant au début, mais c'est
316 souvent la façon la plus économique de saisir les hauteurs en
317 utilisant le clavier de l'ordinateur de façon classique. Détaillons
318 dans un exemple le calcul des octaves relatives. En partant d'un si
319 sur la troisième ligne de la clé de sol, un do, un ré ou un mi sans
320 indication d'octave particulière seront placés juste au-dessus du si,
321 c'est-à-dire au plus à une quarte ascendante du si, alors qu'un la, un
322 sol ou un fa seront placés juste en-dessous du si, c'est-à-dire au
323 plus à une quarte descendante du si.
325 @lilypond[verbatim,quote]
327 b c % c is 1 staff space up, so is the c above
328 b d % d is 2 up or 5 down, so is the d above
329 b e % e is 3 up or 4 down, so is the e above
330 b a % a is 6 up or 1 down, so is the a below
331 b g % g is 5 up or 2 down, so is the g below
332 b f % f is 4 up or 3 down, so is the f below
336 Notez que le calcul des octaves relatives @strong{ne tient pas compte
337 des altérations} des notes, dièses bémols ou bécarre.
339 Pour obtenir des intervalles supérieurs à une quarte, on peut ajouter
340 des apostrophes @code{'} --- qui font chacune monter la hauteur d'une
341 octave --- ou des virgules @code{,} --- qui font chacune descendre la
342 hauteur d'une octave --- au nom de la note.
344 @lilypond[verbatim,quote]
352 Pour déplacer une note deux octaves (ou davantage !) plus haut ou plus
353 bas, il suffit de mettre deux (ou davantage) @code{'} ou @code{,} ---
354 attention cependant à bien mettre deux apostrophes @code{''}, et non
355 un guillemet @code{"}@tie{}! C'est de cette même manière que l'on
356 peut modifier la valeur de départ de @code{@w{\relative c'}}.
359 @subheading Durées et rythme
368 @cindex spécification des durées
370 Glossaire musical : @rglos{beam}, @rglos{duration},
371 @rglos{whole note}, @rglos{half note}, @rglos{quarter note},
374 La @notation{durée} d'une note est indiquée par un nombre qui suit sa
375 hauteur : @code{1} pour une @notation{ronde}, @code{2} pour une
376 @notation{blanche}, @code{4} pour une @notation{noire} et ainsi de
377 suite. Les @notation{crochets} et @notation{liens} sont ajoutés
380 Si aucune durée n'est indiquée pour une note, la dernière durée entrée
381 est utilisée. En l'absence d'indication de durée, la première note
384 @lilypond[verbatim,quote]
388 a16 a a a a32 a a a a64 a a a a a a a a2
392 Une @notation{note pointée} s'obtient en ajoutant un point @code{.} à
393 la valeur rythmique. Le point doit être précédé d'un nombre spécifiant
396 @lilypond[verbatim,quote]
407 @cindex notation des silences
409 Glossaire musical : @rglos{rest}.
411 On saisit un @notation{silence} tout comme une note, mais avec la
412 lettre @code{r} (pour @emph{rest}).
414 @lilypond[verbatim,quote]
425 @cindex chiffre de mesure
430 Glossaire musical : @rglos{time signature}.
432 La @notation{métrique}, aussi appelée @notation{chiffre de mesure},
433 peut être définie à l'aide de la commande @code{\time} :
435 @lilypond[verbatim,quote]
458 Glossaire musical : @rglos{clef}.
460 La @notation{clef} peut être définie à l'aide de la commande
463 @lilypond[verbatim,quote]
477 @subheading Tout ensemble
479 Voici un bref exemple qui rassemble tous les éléments que nous déjà
482 @lilypond[verbatim,quote]
493 Manuel de notation : @ruser{Écriture des hauteurs de note},
494 @ruser{Écriture du rythme}, @ruser{Écriture des silences},
495 @ruser{Métrique}, @ruser{Clefs}.
498 @node Travail sur les fichiers d'entrée
499 @subsection Travail sur les fichiers d'entrée
500 @translationof Working on input files
502 Le traitement des fichiers source de LilyPond est semblable à celui du
503 code de nombreux langages de programmation. La casse est prise
504 en compte, et les caractères considérés comme espaces ont généralement
505 peu d'importance. Les expressions sont délimitées par des accolades @{
506 @}, et les commentaires par @code{%} ou @code{%@{ ... %@}}.
508 Si cette phrase vous paraît incompréhensible, ne vous en faites pas !
509 Expliquons tous ces termes :
513 @cindex casse, prise en compte de
514 @cindex prise en compte de la casse
515 @cindex sensibilité à la casse
519 LilyPond est sensible à la casse, c'est à dire qu'une lettre capitale
520 n'a pas la même valeur qu'une lettre minuscule. Les notes, par
521 exemple, doivent être entrées en minuscule : @code{@{ c d e @}} est
522 un code valide, alors que @code{@{ C D E @}} produira un message
525 @cindex espaces multiples, insensibilité
526 @cindex insensibilité aux espaces multiples
528 @item @strong{Les espaces multiples} :
529 LilyPond ne tient pas compte du nombre d'espaces, ou de retours à la
530 ligne. @code{@{ c d e @}} a le
531 même sens que @code{@{ c @tie{} @tie{} d @tie{} e @}} ou que
539 Bien sûr, ce dernier exemple est illisible. Une bonne habitude
540 à prendre est d'indenter les blocs de code avec soit des tabulations
541 soit des doubles espaces :
553 @item @strong{Expressions musicales} :
554 Tout morceau saisi dans LilyPond doit être placé entre @strong{@{
555 accolades @}}. Ces caractères indiquent à LilyPond que ce bloc de
556 texte représente une et une seule expression musicale, tout comme les
557 parenthèses @code{()} en mathématiques. Pour éviter toute ambiguïté,
558 il est préférable d'entourer ces accolades d'espaces ou de retours à
561 Un appel de fonction --- @w{@code{\relative @{ @}}} par exemple ---
562 compte également comme une seule expression musicale.
565 @cindex commentaire de fin de ligne
566 @cindex commentaire-bloc
567 @cindex bloc de commentaire
570 @funindex %@{ ... %@}
572 @item @strong{Les commentaires} :
573 Un commentaire est une indication pour tout lecteur humain d'un
574 fichier source de musique ; il est ignoré par l'ordinateur, et n'a
575 donc aucun effet sur la partition imprimée. On distingue deux types
576 de commentaires. Le commentaire de fin de ligne, introduit par le
577 symbole @code{%} : tout ce qui suit ce symbole sur la même ligne sera
578 ignoré. Par convention, un commentaire qui occupe une ligne entière
579 se place juste @emph{au-dessus} de la ligne à laquelle il fait
584 % ce commentaire fait référence aux si
588 Le bloc de commentaire, qui peut occuper plusieurs lignes, voire toute
589 une section : tout ce qui se trouve entre @code{%@{} et @code{%@}} est
590 ignoré. Les blocs de commentaires ne peuvent s'imbriquer, ce qui
591 signifie que vous ne pouvez pas placer un commentaire-bloc à
592 l'intérieur d'un autre commentaire-bloc. Si jamais vous essayez, vous
593 verrez que la première occurence de @code{%@}} terminera @qq{les
594 @emph{deux} commentaires-blocs}. Le fragment suivant met en évidence
595 quelques usages possibles des commentaires :
598 % voici les notes de "ah vous dirai-je maman"
602 Ces lignes et les notes qui suivent
603 seront ignorées, car elles se trouvent
604 dans un bloc de commentaire.
614 @node Bien lire le manuel
615 @subsection Bien lire le manuel
616 @translationof How to read the manual
618 @cindex bien lire le manuel
619 @cindex manuel, lecture
620 @cindex compulser le manuel
621 @cindex exemples cliquables
622 @cindex cliquables, exemples
623 @cindex conseils de construction des fichiers
625 @cindex construction des fichiers, conseils
626 @cindex fichiers, conseils de construction
628 Comme nous l'avons vu dans @ref{Travail sur les fichiers d'entrée}, un code
629 LilyPond doit être encadré par des accolades @{ @} ou bien par
630 @code{@w{\relative c'' @{ ... @}}}. Cependant, dans la suite de ce
631 manuel, la plupart des exemples ne feront pas apparaître ces signes.
633 Pour reproduire les exemples, vous pouvez copier et coller le code
634 affiché, mais @strong{à condition} d'ajouter
635 @code{@w{\relative c'' @{ @}}} de la façon suivante :
639 ...collez ici votre exemple...
643 Pourquoi avoir omis les accolades ? La plupart des exemples de ce
644 manuel peuvent être insérés au milieu d'un morceau de musique plus
645 long. Il n'y a donc aucune raison d'ajouter @code{@w{\relative c'' @{
646 @}}} à ces exemples --- en effet, il n'est pas possible d'insérer une
647 expression @code{\relative} à l'intérieur d'un autre expression
648 @code{\relative}. Si nous mettions tous nos exemples dans une
649 expression @code{\relative}, vous ne pourriez plus copier un bref
650 exemple de la documentation pour le coller dans vos pièces.
653 @subheading Exemples cliquables
655 Beaucoup de gens apprennent à utiliser les programmes en les essayant
656 et en bidouillant avec. C'est également possible avec LilyPond. Si
657 vous cliquez sur une image dans la version HTML de ce manuel, vous
658 verrez exactement le code LilyPond utilisé pour générer cette image.
659 Essayez sur cette image :
663 @lilypond[quote,ragged-right]
665 c-\markup { \bold \huge { Cliquez ici. } }
669 En copiant-collant le code à partir du commentaire @qq{ly snippet}
670 vers un fichier test, vous aurez un modèle de base pour faire vos
671 expériences. Pour obtenir une gravure à l'identique, copiez tout le
672 code à partir de @qq{Start cut-&-pastable section}.
674 @c No longer in the text in English, but should we really
677 Si vous apprenez de cette façon, vous aurez probablement envie
678 d'imprimer ou de garder un lien vers @ruser{Aide-mémoire}, tableau
679 qui répertorie les commandes usuelles pour une consultation rapide.
684 Vous trouverez plus de conseils pour construire des fichiers source
685 dans @ref{Suggestions pour la saisie de fichiers LilyPond}. Cependant,
686 lors d'une première lecture il est préférable de terminer d'abord la
690 @node Notation sur une seule portée
691 @section Notation sur une seule portée
692 @translationof Single staff notation
694 Cette section présente la notation courante dont on a besoin pour
695 écrire une voix sur une portée.
698 * Altérations et armure::
700 * Articulations et nuances::
702 * Barres de ligature automatiques et manuelles::
703 * Commandes rythmiques avancées::
707 @node Altérations et armure
708 @subsection Altérations et armure
709 @translationof Accidentals and key signatures
711 @subheading Altérations
716 @cindex dièse, double
719 @cindex bémol, double
726 Glossaire musical : @rglos{sharp}, @rglos{flat}, @rglos{double sharp},
727 @rglos{double flat}, @rglos{accidental}.
729 Dans la notation par défaut, on obtient un @notation{dièse} en
730 ajoutant @code{is} au nom de la note, et un @notation{bémol} en
731 ajoutant @code{es}. Comme vous pouvez vous y attendre, un double
732 dièse ou double bémol s'obtiennent en ajoutant @code{isis} ou
733 @code{eses}. Cette syntaxe est dérivée de la convention de
734 dénomination des notes dans les langues nordiques et germaniques,
735 comme l'allemand ou le hollandais.
738 Cependant, si vous utilisez la commande
739 @code{@w{\include@tie{}"italiano.ly"}} pour entrer les noms de notes
740 français au lieu des noms hollandais, il faudra ajouter un @code{d} pour
741 obtenir un dièse, et un @code{b} pour un bémol. Le double dièse et le
742 double bémol s'obtiennent en ajoutant respectivement @code{dd} et
743 @code{bb}. Pour en savoir plus sur les autres langues disponibles,
744 consultez @ruser{Noms de note dans d'autres langues}.
747 @lilypond[verbatim,quote,relative=2]
748 cis1 ees fisis, aeses
753 @cindex armure, définition de l'
754 @cindex armure, altérations à l'
755 @cindex altérations à l'armure
766 Glossaire musical : @rglos{key signature}, @rglos{major},
769 L'armure est déterminée par la commande @code{\key}, suivie d'une
770 hauteur puis de @code{\major} (majeur) ou @code{\minor} (mineur).
772 @lilypond[verbatim,quote,relative=2]
781 @subheading Attention aux armures et aux hauteurs
783 Glossaire musical : @rglos{accidental}, @rglos{key signature},
784 @rglos{pitch}, @rglos{flat}, @rglos{natural}, @rglos{sharp},
785 @rglos{transposition}.
787 La combinaison de l'@notation{armure} et des hauteurs de note --- y
788 compris les altérations --- permet à LilyPond de déterminer dans quel
789 cas imprimer des @notation{altérations accidentelles}. L'armure
790 n'affecte que les altérations @emph{imprimées}, et non les hauteurs
791 réelles ! Cette fonctionnalité est souvent source de confusion pour
792 les nouveaux utilisateurs, aussi expliquons-la en détail.
794 LilyPond fait une distinction nette entre le contenu musical et la
795 mise en forme. L'altération d'une note --- @notation{bémol},
796 @notation{bécarre} ou @notation{dièse} --- fait partie de sa hauteur,
797 et relève donc du contenu musical. La gravure ou non d'une altération
798 accidentelle --- un @emph{signe} bémol, bécarre ou dièse --- devant la
799 note correspondante est une question qui relève de la mise en forme.
800 La gravure d'une partition suit des règles, en particulier des règles
801 d'indication des altérations accidentelles. Les hauteurs de note, en
802 revanche, relèvent de ce que vous voulez entendre ; et, dans la mesure
803 où la musique que vous entrez est censée être celle que vous voulez
804 entendre, LilyPond, qui n'est chargé que de la gravure, ne les
805 choisira pas à votre place.
809 @lilypond[verbatim,quote,relative=2]
815 aucune note n'a d'altération accidentelle, et pourtant vous devrez
816 entrer le @code{is} pour les notes @code{cis} et @code{fis}.
818 Le code @code{b} ne veut pas dire @qq{Imprimez-moi un point noir sur
819 la troisième ligne de la portée.} Cela signifie plutôt : @qq{Ici se
820 trouve une note dont la hauteur est un si naturel.} Avec une armure
821 de la bémol majeur, ce @code{si} est flanqué d'un bécarre accidentel :
823 @lilypond[verbatim,quote,relative=2]
828 Ajouter explicitement toutes les altérations demande un peu plus
829 d'effort dans la phase de saisie, mais cela facilite grandement la
830 @notation{transposition}. De plus, les altérations accidentelles
831 peuvent ainsi être imprimées suivant plusieurs conventions. Pour
832 connaître les différentes manières dont les altérations accidentelles
833 peuvent être imprimées, consultez @ruser{Altérations accidentelles automatiques}.
837 Manuel de notation : @ruser{Noms de note dans d'autres langues},
838 @ruser{Altérations}, @ruser{Altérations accidentelles automatiques},
841 Glossaire musical : @rglos{Pitch names}.
846 @translationof Ties and slurs
848 @cindex liaisons de prolongation
849 @cindex liaisons de tenue
850 @cindex prolongation, liaisons de
851 @cindex durée, liaisons de
852 @cindex tenue, liaisons de
858 @subheading Liaisons de prolongation
860 Glossaire musical : @rglos{tie}.
862 Pour créer une liaison de prolongation@footnote{parfois aussi appelée
863 liaison de tenue}, on ajoute un tilde @code{~} à la première note
866 @lilypond[verbatim,quote,relative=2]
871 @cindex liaisons d'articulation
872 @cindex articulation, liaisons d'
874 @subheading Liaisons d'articulation
876 @c Le terme de "slur" a deux sens en français : articulation et phrasé.
877 @c Je garde ici le terme "legato", tel qu'il apparaît dans le texte original,
878 @c car c'est celui qui me semble le plus couramment employé.
879 @c slur = "il zon" (articulation). jcm
880 @c phrasing slur = "ils ont des chapeaux ronds" (phrase). jcm
882 Glossaire musical : @rglos{slur}, @rglos{phrasing}.
884 Une liaison d'articulation ou @emph{legato} peut englober
885 plusieurs notes. Les notes de départ et d'arrivée sont suivies
886 respectivement d'un signe @code{(} et @code{)}.
888 @lilypond[verbatim,quote,relative=2]
889 d4( c16) cis( d e c cis d) e( d4)
892 @cindex liaisons de phrasé
893 @cindex phrasé, liaisons de
895 @subheading Liaisons de phrasé
897 De plus longues liaisons, dites de phrasé, sont délimitées par @code{\(} et
898 @code{\)}. Il est possible d'avoir en même temps des legatos et des
899 phrasés, mais pas plusieurs liaisons de phrasé ou de @emph{legato} à la fois.
901 @lilypond[verbatim,quote,relative=2]
902 a8(\( ais b c) cis2 b'2 a4 cis,\)
907 @cindex liaisons d'articulation et de prolongation, différences
908 @subheading Attention aux types de liaison
910 Glossaire musical : @rglos{articulation}, @rglos{slur}, @rglos{tie}.
912 Une liaison d'articulation ou de phrasé ressemble à une liaison de
913 prolongation, mais n'a pas la même signification. Alors qu'une
914 liaison de prolongation ne peut relier que deux notes de même hauteur,
915 le @emph{legato} indique une articulation de plusieurs notes,
916 éventuellement en grand nombre. Les liaisons de tenue peuvent être
917 enchâssées dans un @emph{legato} ou un phrasé.
919 @lilypond[verbatim,quote,relative=2]
920 c2~( c8 fis fis4 ~ fis2 g2)
925 Manuel de notation : @ruser{Liaisons de prolongation}, @ruser{Liaisons d'articulation},
926 @ruser{Liaisons de phrasé}.
929 @node Articulations et nuances
930 @subsection Articulations et nuances
931 @translationof Articulation and dynamics
933 @subheading Articulations
939 Glossaire musical : @rglos{articulation}.
941 Des @notation{articulations} peuvent être ajoutées à une note, au moyen
942 d'un tiret @code{-} suivi d'un caractère :
944 @lilypond[verbatim,quote,relative=2]
945 c-. c-- c-> c-^ c-+ c-_
955 Glossaire musical : @rglos{fingering}.
957 De même, des indications de doigté peuvent être ajoutées à une note en
958 utilisant un tiret (@samp{-}) et le chiffre à écrire :
960 @lilypond[verbatim,quote,relative=2]
964 Articulations et doigtés sont habituellement placés automatiquement,
965 mais vous pouvez spécifier leur positionnement en utilisant @code{^} (en
966 haut) ou @code{_} (en bas). Vous pouvez aussi utiliser plusieurs
967 articulations sur la même note. Dans la plupart des cas, cependant,
968 il est bon de laisser LilyPond déterminer l'emplacement de
971 @lilypond[verbatim,quote,relative=2]
972 c_-^1 d^. f^4_2-> e^-_+
990 Glossaire musical : @rglos{dynamics}, @rglos{crescendo},
993 On obtient un signe de @notation{nuance} en ajoutant à la note les
994 lettres du signe, précédées d'un anti-slash @code{\} :
996 @lilypond[verbatim,quote,relative=2]
1004 @c Pluriel des termes musicaux italiens :
1005 @c selon Littré, plutôt à la française (en "-os" qu'en "-i")
1007 @notation{Crescendos} et @notation{decrescendos} débutent avec les
1008 commandes @code{\<} et @code{\>}. Ils se terminent soit par une
1009 nuance d'arrivée, par exemple @code{\f}, soit par la commande
1012 @lilypond[verbatim,quote,relative=2]
1013 c2\< c2\ff\> c2 c2\!
1018 Manuel de notation : @ruser{Articulations et ornements},
1019 @ruser{Doigtés}, @ruser{Nuances}.
1022 @node Ajout de texte
1023 @subsection Ajout de texte
1024 @translationof Adding text
1026 @cindex texte, ajout de
1027 @cindex ajout de texte
1033 On peut ajouter du texte à une partition :
1035 @lilypond[verbatim,quote,relative=2]
1036 c1^"espr" a_"legato"
1039 Pour mettre en forme du texte, on utilise la commande @code{markup} :
1041 @lilypond[verbatim,quote,relative=2]
1042 c1^\markup{ \bold espr}
1044 \dynamic f \italic \small { 2nd } \hspace #0.1 \dynamic p
1050 Manuel de notation : @ruser{Ajout de texte}.
1053 @node Barres de ligature automatiques et manuelles
1054 @subsection Barres de ligature automatiques et manuelles
1055 @translationof Automatic and manual beams
1058 @cindex barre de ligature
1059 @cindex ligatures automatiques
1060 @cindex ligatures manuelles
1061 @cindex ligatures explicites
1066 @funindex \autoBeamOff
1067 @funindex autoBeamOff
1068 @funindex \autoBeamOn
1069 @funindex autoBeamOn
1071 Glossaire musical : @rglos{beam}.
1073 Toutes les barres de ligature sont dessinées automatiquement :
1075 @lilypond[verbatim,quote,relative=2]
1076 a8 ais d ees r d c16 b a8
1080 Lorsqu'on n'aime pas la manière dont les notes sont automatiquement
1081 groupées, il est possible de les ligaturer manuellement, en marquant la
1082 première note à attacher d'un crochet ouvrant @code{[} et la dernière
1083 d'un crochet fermant @code{]}.
1085 @lilypond[verbatim,quote,relative=2]
1086 a8[ ais] d[ ees r d] a b
1089 Pour désactiver les barres de ligature automatiques pour des passages
1090 entiers, utilisez la commande @code{\autoBeamOff}, et utilisez
1091 @code{\autoBeamOn} pour les réactiver.
1093 @lilypond[verbatim,quote,relative=2]
1102 Manuel de notation : @ruser{Barres de ligature automatiques}, @ruser{Barres de ligature manuelles}.
1105 @node Commandes rythmiques avancées
1106 @subsection Commandes rythmiques avancées
1107 @translationof Advanced rhythmic commands
1109 @subheading Mesure incomplète
1113 @cindex mesure incomplète
1118 Glossaire musical : @rglos{anacrusis}.
1120 On crée une levée (ou anacrouse) avec la commande @code{\partial},
1121 suivie d'une durée : @code{\partial 4} produit une levée d'une noire
1122 et @code{\partial 8} d'une croche.
1124 @lilypond[verbatim,quote,relative=2]
1137 Glossaire musical : @rglos{note value}, @rglos{triplet}.
1139 Les @notation{nolets} sont créés avec la commande @code{\times}, qui
1140 prend deux arguments : une fraction et une expression musicale. La
1141 durée des notes de l'expression musicale est multipliée par la
1142 fraction. Par exemple les notes d'un @notation{triolet} durent les
1143 deux tiers de la durée de leur notation réelle, cette fraction est
1144 donc de 2/3 pour les triolets :
1146 @lilypond[verbatim,quote,relative=2]
1147 \times 2/3 { f8 g a }
1148 \times 2/3 { c r c }
1149 \times 2/3 { f,8 g16[ a g a] }
1150 \times 2/3 { d4 a8 }
1153 @subheading Notes d'ornement
1155 @cindex notes d'ornement
1156 @cindex ornementation
1157 @cindex appoggiature
1158 @cindex acciaccature
1162 @funindex \acciaccatura
1163 @funindex acciaccatura
1164 @funindex \appoggiatura
1165 @funindex acciaccatura
1167 Glossaire musical : @rglos{grace notes}, @rglos{acciaccatura},
1168 @rglos{appoggiatura}.
1170 Des @notation{notes d'ornement} s'obtiennent en appliquant la commande
1171 @code{\grace}, @code{\appoggiatura} ou @code{\acciaccatura} à une
1172 expression musicale :
1174 @lilypond[verbatim,quote,relative=2]
1175 c2 \grace { a32[ b] } c2
1176 c2 \appoggiatura b16 c2
1177 c2 \acciaccatura b16 c2
1182 Manuel de notation : @ruser{Notes d'ornement}, @ruser{Nolets},
1186 @node Notes simultanées
1187 @section Notes simultanées
1188 @translationof Multiple notes at once
1190 Cette section traite de situations où l'on a plus d'une note à la fois :
1191 plusieurs instruments, plusieurs voix ou portées pour un même
1192 instrument (le piano, par exemple), et les accords.
1194 En théorie musicale, la polyphonie désigne une musique constituée de
1195 plusieurs voix ; dans LilyPond, ce terme désigne les situations où il
1196 y a plus d'une voix sur une même portée.
1199 * Les expressions musicales en clair::
1200 * Plusieurs portées::
1201 * Regroupements de portées::
1202 * Combinaison de notes en accords::
1203 * Polyphonie sur une portée::
1207 @node Les expressions musicales en clair
1208 @subsection Les expressions musicales en clair
1209 @translationof Music expressions explained
1211 @cindex expression musicale
1213 Dans les fichiers source LilyPond, la musique est représentée par ce
1214 qu'on appelle des @emph{expressions musicales}. En soi, une seule note
1215 peut constituer une expression musicale :
1217 @lilypond[verbatim,quote,relative=2]
1221 Mettre un groupe de notes entre accolades crée une nouvelle expression
1222 musicale, appelée @emph{expression musicale composée}. En voici un
1223 exemple avec deux notes :
1225 @lilypond[verbatim,quote,relative=2]
1229 La mise entre accolades d'une séquence d'expressions musicales --- des
1230 notes par exemple --- signifie qu'elles doivent être jouées
1231 successivement, les unes après les autres. Le résultat est une
1232 expression, qui peut elle-même être regroupée séquentiellement avec
1233 d'autres expressions. Ici, l'expression de l'exemple précédent est
1234 combinée à deux notes :
1236 @lilypond[verbatim,quote,relative=2]
1240 @subheading Analogie avec les expressions mathématiques
1244 Ce mécanisme est similaire aux formules mathématiques : une grosse
1245 formule est créée en assemblant plusieurs petites formules. De telles
1246 formules sont appelées expressions, elles ont une définition
1247 récursive, de telle sorte que vous pouvez fabriquer des expressions
1248 arbitrairement longues et complexes. Par exemple :
1257 ((1 + 2) * 3) / (4 * 5)
1260 Ceci est une suite d'expressions, où chacune est contenue dans la
1261 suivante. Les expressions les plus simples sont les nombres, et de
1262 plus grandes expressions sont produites en combinant des expressions
1263 avec des opérateurs --- comme @code{+}, @code{*} et @code{/} --- et
1264 des parenthèses. Tout comme les expressions mathématiques, les
1265 expressions musicales peuvent être imbriquées avec une profondeur
1266 arbitraire, ce qui est nécessaire pour des partitions complexes comme
1267 de la musique polyphonique.
1270 @subheading Expressions musicales simultanées -- plusieurs portées
1272 @cindex portées multiples
1274 @cindex combinaison d'expressions en parallèle
1275 @cindex parallèles, expressions
1276 @cindex expressions parallèles
1277 @cindex hauteur relative et musique simultanée
1278 @cindex musique simultanée et hauteur relative
1279 @cindex hauteur relative et expressions parallèles
1280 @cindex expressions parallèles et hauteur relative
1286 Glossaire musical : @rglos{polyphony}.
1288 Cette technique est utile pour de la musique @notation{polyphonique}.
1289 Pour entrer une musique avec plusieurs voix ou plusieurs portées, nous
1290 pouvons aussi combiner @emph{en parallèle} les expressions : deux voix
1291 qui doivent être jouées en même temps, sont entrées comme une
1292 combinaison simultanée de deux expressions. Une expression musicale
1293 @qq{simultanée} est formée en entourant les expressions entre @code{<<}
1294 et @code{>>}. Dans l'exemple suivant, trois expressions (contenant
1295 chacune deux notes distinctes) sont combinées simultanément.
1297 @lilypond[verbatim,quote]
1307 Notez que nous avons ici indenté chaque niveau du fichier d'entrée
1308 avec un nombre d'espaces différent. LilyPond se moque --- ou presque
1309 --- de l'espace qu'il peut y avoir ou non au début d'une ligne, mais
1310 un code bien indenté est bien plus lisible par des humains.
1312 @warning{la hauteur de chaque note saisie est relative à la précédente,
1313 mais pas au @code{c''} de la commande @code{\relative} de départ.}
1316 @subheading Expressions musicales simultanées -- une seule portée
1318 Pour déterminer le nombre de portées, LilyPond regarde le début
1319 de la première expression. Si c'est une seule note, une seule portée
1320 est produite ; si c'est une expression simultanée, plusieurs portées
1323 @lilypond[verbatim,quote]
1326 << { e f } { c <<b d>> } >>
1331 @node Plusieurs portées
1332 @subsection Plusieurs portées
1333 @translationof Multiple staves
1335 @cindex multiples portées
1336 @cindex portées multiples
1338 @cindex contexte de notation
1339 @cindex notation, contexte
1341 @funindex \new Staff
1349 @funindex ChordNames
1351 Comme nous l'avons vu dans @ref{Les expressions musicales en clair}, un
1352 fichier d'entrée LilyPond est fait d'expressions musicales. Si la
1353 partition commence par plusieurs expressions simultanées, LilyPond
1354 créera plusieurs portées. Cependant, il est plus facile de prévoir le
1355 nombre de portées si on les crée explicitement, ce que nous allons
1358 Pour créer plus d'une portée, on ajoute @code{\new Staff} au début de
1359 chaque partie de la musique constituant une portée. Ces éléments
1360 @code{Staff} sont ensuite combinés en parallèle avec @code{<<} et
1361 @code{>>}, comme ci-dessous.
1363 @lilypond[verbatim,quote]
1366 \new Staff { \clef treble c }
1367 \new Staff { \clef bass c,, }
1373 La commande @code{\new} introduit un @qq{contexte de notation}. Un
1374 contexte de notation est un environnement dans lequel les événements
1375 musicaux --- comme les notes ou les commandes @code{\clef} --- sont
1376 interprétés. Pour des pièces simples, ces contextes sont créés
1377 automatiquement. Pour des pièces plus complexes, il est préférable de
1378 spécifier explicitement les contextes, afin de s'assurer que chaque
1379 fragment aura sa propre portée.
1381 Il existe différents types de contextes. Les contextes @code{Score}
1382 (partition), @code{Staff} (portée) et @code{Voice} (voix) gèrent la
1383 notation de la mélodie, alors que @code{Lyrics} gère les paroles et
1384 @code{ChordNames} imprime des noms d'accords.
1386 En terme de syntaxe, ajouter @code{\new} devant une expression
1387 musicale crée une plus grande expression musicale. En reprenant la
1388 comparaison précédente, cela ressemble au signe @emph{moins} en
1389 mathématiques. La formule @math{(4+5)} est une expression, donc
1390 @math{-(4+5)} constitue une plus grande expression.
1392 Les chiffres de métrique indiqués sur une portée affectent toutes les
1393 autres portées@footnote{Ce comportement peut être modifié si
1394 nécessaire, voir @ruser{Notation polymétrique}}. En revanche l'armure
1395 d'une portée n'affecte @emph{pas} les autres portées. Ces
1396 caractéristiques par défaut se justifient par le fait que
1397 l'utilisation d'instruments transpositeurs est bien plus fréquente que
1398 la musique polyrythmique.
1400 @lilypond[verbatim,quote]
1403 \new Staff { \clef treble \key d \major \time 3/4 c }
1404 \new Staff { \clef bass c,, }
1410 @node Regroupements de portées
1411 @subsection Regroupements de portées
1412 @translationof Staff groups
1414 @cindex portée double
1415 @cindex portée pour piano
1416 @cindex piano, portée pour
1417 @cindex clavier, portée pour
1418 @cindex chœur, système pour
1419 @cindex système pour chœur
1421 @cindex portées, regroupement de
1422 @cindex regroupement de portées
1424 @funindex PianoStaff
1425 @funindex GrandStaff
1426 @funindex ChoirStaff
1428 Glossaire musical : @rglos{brace}.
1430 La musique pour piano s'écrit sur deux portées reliées par une
1431 @notation{accolade}. La gravure de ce type de portée est semblable à
1432 l'exemple de musique polyphonique de @ref{Plusieurs portées}, mais
1433 maintenant cette expression entière est interprétée dans un contexte
1443 Voici un bref exemple :
1445 @lilypond[verbatim,quote]
1448 \new Staff { \time 2/4 c4 e g g, }
1449 \new Staff { \clef bass c,, c' e c }
1454 Vous pouvez générer d'autres de regroupement, avec
1455 @code{\new GrandStaff} pour un e partition d'orchestre, ou
1456 @w{@code{\new ChoirStaff}} qui sied particulièrement aux partitions
1457 chorales. Chacun de ces regroupements constituent un contexte à part
1458 entière, avec ses particularités, tant au niveau du signe qui regroupe
1459 les portées au sein d'un @notation{système} qu'au niveau de l'étendue
1460 des barres de mesure.
1464 Manuel de notation : @ruser{Instruments utilisant des portées multiples},
1465 @ruser{Gravure des portées}.
1468 @node Combinaison de notes en accords
1469 @subsection Combinaison de notes en accords
1470 @translationof Combining notes into chords
1472 @cindex accords, notes simultanées
1473 @cindex accords et durée
1479 Glossaire musical : @rglos{chord}.
1481 Nous avons vu précédemment comment combiner des notes simultanément,
1482 en les encadrant par des chevrons doubles @code{<<} et @code{>>}. Pour
1483 produire des accords simples, c'est-à-dire une superposition de notes
1484 de même durée, on encadre les hauteurs de notes par des chevrons simples
1485 @code{<} et @code{>}, et on écrit la durée juste après.
1487 @lilypond[verbatim,quote,relative=2]
1488 r4 <c e g>4 <c f a>2
1491 Beaucoup d'éléments de notation que l'on peut attacher à une note
1492 simple, comme une liaison, un crochet indiquant un début ou une fin de
1493 lien, un signe d'articulation, peuvent être également attachés à un
1494 accord : il faut ajouter ces indications après les hauteurs et la
1495 durée, donc @emph{à l'extérieur} des chevrons.
1497 @lilypond[verbatim,quote,relative=2]
1498 r4 <c e g>8[ <c f a>]~ <c f a>2
1499 r4 <c e g>8( <c e g>\> <c e g>4 <c f a>\!)
1503 @node Polyphonie sur une portée
1504 @subsection Polyphonie sur une portée
1505 @translationof Single staff polyphony
1508 @cindex voix multiples sur une portée
1509 @cindex silence invisible
1510 @cindex invisible, silence
1512 @funindex << ... \\ ... >>
1517 Bien que LilyPond gère la musique polyphonique sans difficulté, cela
1518 fait appel à des concepts que nous n'avons pas encore abordés. C'est la
1519 raison pour laquelle nous ne nous étendrons pas tout de suite sur ce
1520 sujet et préférons vous inciter à consulter les chapitres dédiés à
1521 l'étude de ces concepts.
1524 Learning Manual: @ref{Les voix contiennent la musique}.
1526 Manuel de notation : @ruser{Notes simultanées}.
1531 @translationof Songs
1533 Cette section présente l'écriture vocale et les partitions de variété.
1536 * Écriture de chants simples::
1537 * Alignement des paroles sur une mélodie::
1538 * Paroles pour plusieurs portées::
1542 @node Écriture de chants simples
1543 @subsection Écriture de chants simples
1544 @translationof Setting simple songs
1549 @funindex \addlyrics
1552 Glossaire musical : @rglos{lyrics}.
1554 Prenons une mélodie toute simple, la comptine @emph{Girls and boys
1557 @lilypond[verbatim,quote]
1561 d4 b8 c4 a8 d4 b8 g4
1565 Des @notation{paroles} peuvent être associées à ces notes, en les
1566 combinant avec la commande @code{\addlyrics}. On entre les paroles en
1567 séparant chaque syllable par un espace :
1569 @lilypond[verbatim,quote]
1574 d4 b8 c4 a8 d4 b8 g4
1577 Girls and boys come out to play,
1582 Remarquez les accolades embrassant la musique et celles embrassant les
1583 paroles, ainsi que les doubles chevrons encadrant toute la pièce ; ces
1584 derniers indiquent simplement que la musique et les paroles se
1585 produisent en même temps.
1588 @node Alignement des paroles sur une mélodie
1589 @subsection Alignement des paroles sur une mélodie
1590 @translationof Aligning lyrics to a melody
1593 @cindex ligne d'extension
1594 @cindex trait d'union (paroles)
1595 @cindex caractère souligné (paroles)
1596 @cindex paroles, alignement des
1597 @cindex alignement des paroles
1598 @cindex paroles, mot de plusieurs syllabes
1600 Glossaire musical : @rglos{melisma}, @rglos{extender line}.
1602 La deuxième ligne de la comptine précédente est @emph{The moon doth
1603 shine as bright as day}. Ajoutons-la au code.
1605 @lilypond[verbatim,quote]
1610 d4 b8 c4 a8 d4 b8 g4
1611 g8 a4 b8 c b a d4 b8 g4.
1614 Girls and boys come out to play,
1615 The moon doth shine as bright as day;
1620 Remarquez que les paroles ajoutées ne s'alignent pas bien avec les
1621 notes. Le mot @emph{shine} devrait être chanté sur deux notes au lieu
1622 d'une. On appelle ceci un @notation{mélisme} : il s'agit d'une seule
1623 syllabe chantée sur plus d'une note. Il existe plusieurs façons
1624 d'étaler une sylabe sur plusieurs notes, la plus simple étant de lier
1625 les notes du mélisme. Pour les détails, consultez @ref{Liaisons}.
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 Les paroles sont maintenant correctement alignées, mais les liens de
1643 croche automatiques ne conviennent pas pour les notes au-dessus de
1644 @emph{shine as}. On peut les corriger en ajoutant des liens de croche
1645 manuels, pour ceci consultez @ref{Barres de ligature automatiques et manuelles}.
1647 @lilypond[verbatim,quote]
1652 d4 b8 c4 a8 d4 b8 g4
1653 g8 a4 b8 c([ b]) a d4 b8 g4.
1656 Girls and boys come out to play,
1657 The moon doth shine as bright as day;
1662 Au lieu d'utiliser une liaison, on peut indiquer le mélisme dans les
1663 paroles en insérant un caractère souligné @code{_} pour chaque note du
1664 mélisme sauf la première.
1666 @lilypond[verbatim,quote]
1671 d4 b8 c4 a8 d4 b8 g4
1672 g8 a4 b8 c[ b] a d4 b8 g4.
1675 Girls and boys come out to play,
1676 The moon doth shine _ as bright as day;
1681 Si une syllabe s'étend sur un grand nombre de notes ou une note très
1682 longue, on représente souvent le mélisme par un @notation{trait de
1683 prolongation}, qu'on entre avec @code{__}. L'exemple suivant montre
1684 les trois premières mesures de la plainte de Didon, extraite de
1685 @notation{Didon et Énée} de Purcell.
1687 @lilypond[verbatim,quote]
1693 b c4.( bes8 a4. g8 fis4.) g8 fis1
1697 am laid __ in earth,
1702 Aucun exemple jusqu'à présent n'a utilisé de mots de plus d'une
1703 syllabe. Dans des paroles, de tels mots sont écrits en syllabes
1704 séparées par des traits d'union. Avec LilyPond, on utilise deux
1705 tirets pour produire un trait d'union centré entre deux syllabes.
1706 L'exemple suivant montre tout ce que nous avons vu jusqu'à maintenant
1707 sur l'alignement de paroles à une mélodie.
1709 @c no ragged-right here because otherwise the hyphens get lost,
1710 @c but the example is long enough to avoid looking strange.
1711 @lilypond[verbatim,quote,noragged-right]
1717 d4 g4 g a8( b) g4 g4
1721 A -- way in a __ man -- ger,
1722 no __ crib for a bed, __
1727 Avec certaines paroles, en particulier en italien, il se produit la
1728 situation inverse : il peut y avoir plusieurs syllabes sur une seule
1729 note. On réalise ceci avec LilyPond grâce à un caractère souligné
1730 @code{_} sans espace entre les syllabes, ou alors en groupant les
1731 syllabes avec des guillemets. L'exemple suivant est extrait de l'air
1732 de Figaro @emph{Largo al factotum}, dans @emph{Figaro} de Rossini, où
1733 la syllabe @emph{al} est chantée sur la même note que @emph{go}.
1735 @c no ragged-right here because otherwise the hyphens get lost,
1736 @c but the example is long enough to avoid looking strange.
1737 @lilypond[verbatim,quote,noragged-right]
1743 c4.~ c8 d b c([ d]) b c d b c
1746 Lar -- go_al fac -- to -- tum del -- la cit -- tà
1753 Manuel de notation : @ruser{Musique vocale}.
1756 @node Paroles pour plusieurs portées
1757 @subsection Paroles pour plusieurs portées
1758 @translationof Lyrics to multiple staves
1760 @cindex paroles et portées mutiples
1761 @cindex portées multiples et paroles
1763 La méthode simple d'ajout de paroles avec @code{\addlyrics} peut être
1764 également utilisée pour placer des paroles sous plusieurs portées.
1765 L'exemple suivant est extrait de @emph{Judas Macchabée} de Händel.
1767 @lilypond[verbatim,quote]
1773 c8 c([ bes]) a a([ g]) f f'4. b, c4.~ c4
1776 Let flee -- cy flocks the hills a -- dorn, __
1782 r8 r4. r4 c8 a'([ g]) f f([ e]) d e([ d]) c bes'4
1785 Let flee -- cy flocks the hills a -- dorn,
1790 Pour produire des partitions plus complexes ou plus longues que cet
1791 exemple simple, il est vivement conseillé de séparer la structure de
1792 la partition des notes et paroles, grâce à des variables. Ceci sera
1793 détaillé plus loin dans @ref{Organisation du code source avec des variables}.
1797 Manuel de notation : @ruser{Musique vocale}.
1800 @node Dernières précisions
1801 @section Dernières précisions
1802 @translationof Final touches
1804 L'ultime section de ce tutoriel montre comment ajouter une touche
1805 finale à des morceaux simples, et constitue une introduction au reste
1809 * Organisation du code source avec des variables::
1810 * Numéro de version::
1812 * Noms de note absolus::
1813 * Après le tutoriel::
1817 @node Organisation du code source avec des variables
1818 @subsection Organisation du code source avec des variables
1819 @translationof Organizing pieces with variables
1822 @cindex variables, définition
1823 @cindex identificateurs
1825 @cindex assignation de variables
1826 @cindex utilisation de variables
1827 @cindex variables, utilisation de
1828 @cindex variables, caractères autorisés dans les
1829 @cindex caractères autorisés dans les variables
1831 Lorsque l'on combine tous les éléments étudiés précédemment pour
1832 écrire des partitions plus longues, les expressions musicales prennent
1833 de l'ampleur et, dans le cas des pièces polyphoniques, deviennent
1834 profondément imbriquées, jusqu'au point où il devient difficile de se
1835 repérer dans le fichier source. Cet inconvénient peut être résolu par
1836 l'utilisation de @emph{variables}.
1838 En utilisant des variables, parfois appelées identificateurs ou
1839 macros, on peut scinder des expressions musicales complexes en des
1840 expressions plus simples. Une variable se définit comme suit :
1843 musiqueToto = @{ @dots{} @}
1846 Le contenu de l'expression musicale @code{musiqueToto} pourra être
1847 utilisé plus loin en faisant précéder son nom d'un anti-slash,
1848 c'est-à-dire @code{\musiqueToto}, tout comme n'importe quelle commande
1849 LilyPond. Toute variable doit être définie @emph{avant} son
1850 utilisation dans une autre expression musicale.
1852 @lilypond[verbatim,quote]
1853 violin = \new Staff {
1858 cello = \new Staff {
1873 Le nom d'une variable ne doit comporter que des caractères
1874 alphabétiques non accentués, aucun nombre ni tiret ne sont autorisés.
1876 On peut utiliser une variable déjà définie autant de fois que l'on
1877 veut, y compris dans la définition d'une nouvelle variable ; par
1878 exemple, cela peut servir à saisir un motif qu'une seule fois, même
1879 s'il se répète un grand nombre de fois dans la pièce.
1881 @lilypond[verbatim,quote]
1882 tripletA = \times 2/3 { c,8 e g }
1883 barA = { \tripletA \tripletA \tripletA \tripletA }
1890 Il est possible d'utiliser des variables de types variés. Par exemple,
1895 aFivePaper = \paper @{ paperheight = 21.0 \cm @}
1898 En fonction de son contenu, un identificateur peut être utilisé à
1899 différents endroits. L'exemple suivant utilise les variable définies
1911 @node Numéro de version
1912 @subsection Numéro de version
1913 @translationof Version number
1917 @cindex numéro de version
1918 @cindex version, numéro de
1920 @cindex future mise à jour
1921 @cindex mise à jour de fichiers
1922 @cindex fichiers, mise à jour de
1926 @funindex convert-ly
1928 La déclaration @code{\version} stipule le numéro de la version de
1929 LilyPond pour laquelle le fichier a été écrit :
1932 \version @w{"@version{}"}
1936 Par convention, on place cette instruction en début de fichier.
1938 Cette instruction permet de faciliter les mises à jour futures de
1939 LilyPond. Les changements de syntaxe au fil des versions sont gérés
1940 avec un programme dédié, @command{convert-ly}, qui utilise la valeur
1941 de @code{\version} pour déterminer les règles de conversion à
1942 appliquer au fichier source. Pour plus d'informations, consultez
1943 @rprogram{Mise à jour des fichiers avec convert-ly}.
1946 @node Ajout de titres
1947 @subsection Ajout de titres
1948 @translationof Adding titles
1952 @cindex bloc d'en-tête
1957 On indique les informations bibliographiques --- nom du morceau, du
1958 compositeur, numéro d'opus@dots{} --- dans un bloc à part, le bloc
1959 d'en-tête @code{\header}, qui existe indépendamment de l'expression
1960 musicale principale. Le bloc @code{\header} est habituellement placé
1961 en début de fichier, après le numéro de version.
1964 \version @w{"@version{}"}
1972 @dots{} la musique @dots{}
1976 Quand LilyPond traite le fichier, le titre et le compositeur sont
1977 imprimés au début de la partition. Vous trouverez plus d'informations
1978 sur les titres à la section @ruser{Création de titres}.
1981 @node Noms de note absolus
1982 @subsection Noms de note absolus
1983 @translationof Absolute note names
1985 @cindex notes, nom des
1986 @cindex absolu, mode
1988 @cindex hauteurs, valeurs absolues
1989 @cindex noms de note absolus
1991 Jusqu'ici nous n'avons utilisé que le mode @code{\relative} pour
1992 définir les hauteurs de notes. Si c'est souvent le moyen le plus
1993 simple de saisir la musique au clavier, il existe une autre façon de
1994 procéder : le mode de hauteurs absolues.
1996 Si vous omettez la commande @code{\relative}, LilyPond considérera
1997 toutes les hauteurs comme des hauteurs absolues. Un @code{c'} désigne
1998 toujours le do central, un @code{b} se situe une seconde en dessous
1999 du do central, et un @code{g,} est situé sur la première ligne de
2000 la portée en clé de fa.
2002 @lilypond[verbatim,quote]
2010 Voici une gamme sur 4 octaves :
2012 @lilypond[verbatim,quote]
2027 Comme vous pouvez le voir, il faut beaucoup d'apostrophes pour écrire
2028 de la musique dans un registre aigu, comme le montre cet extrait de
2031 @lilypond[verbatim,quote]
2035 cis''8. d''16 cis''8 e''4 e''8
2036 b'8. cis''16 b'8 d''4 d''8
2040 Toutes ces apostrophes rendent le fichier moins lisible, et surtout il
2041 est très probable d'oublier au moins une apostrophe au cours de la
2042 frappe. En mode @code{\relative}, le même exemple devient bien plus
2043 facile à lire et à saisir.
2045 @lilypond[verbatim,quote]
2049 cis8. d16 cis8 e4 e8
2054 Si d'aventure vous faites une erreur d'octaviation, le mode
2055 @code{\relative} la mettra en évidence : toutes les notes suivantes
2056 seront placées à la mauvaise octave. En mode de hauteurs absolues,
2057 une erreur isolée ne serait pas autant visible, et serait donc plus
2058 difficile à dénicher.
2060 Cependant, le mode de hauteurs absolues reste utile pour les musiques
2061 où les intervalles sont étendus, et plus encore pour les fichiers
2062 LilyPond créés par des programmes.
2065 @node Après le tutoriel
2066 @subsection Après le tutoriel
2067 @translationof After the tutorial
2069 Après avoir parcouru ce tutoriel, vous devriez essayer d'écrire un
2070 morceau ou deux. Commencez par copier l'un des modèles types et
2071 ajoutez-y des notes --- consultez les @ref{Modèles}. Si vous voulez
2072 employer une notation que vous n'avez pas trouvé dans le tutoriel,
2073 consultez le manuel de notation, en commençant par la @ruser{Notation musicale générale}. Si vous désirez écrire pour un ensemble instrumental non
2074 couvert par les modèles, lisez la section @ref{Extension des modèles}.
2076 Après avoir écrit quelques pièces courtes, lisez les chapitres 3 à 5
2077 du manuel d'initiation. Rien ne s'oppose à ce que vous consultiez dès
2078 à présent ces chapitres, bien sûr ! Néanmoins, le reste du manuel
2079 d'initiation part du principe que vous avez déjà bien assimilé la
2080 syntaxe de base de LilyPond. Vous pouvez toujours survoler ces
2081 chapitres 3 à 5, et y revenir plus tard après avoir acquis de
2084 Dans ce tutoriel comme dans le reste de ce manuel, se trouve à chaque
2085 section un paragraphe @strong{Voir aussi} contenant des références
2086 vers d'autres sections : il est conseillé de ne pas les suivre en
2087 première lecture ; lorsque vous aurez lu l'ensemble du manuel
2088 d'initiation, vous pourrez en relisant certaines sections suivre ces
2089 références pour approfondir certains aspects.
2091 Si vous ne l'avez pas encore fait, lisez @ref{À propos de la documentation}. Les sources de documentation et d'information sur
2092 LilyPond sont vastes, il est normal pour un débutant de ne pas savoir
2093 où chercher ; si vous passez quelques minutes à lire attentivement
2094 cette section, vous vous épargnerez certainement la frustration causée
2095 par des heures de recherches infructueuses.