]> git.donarmstrong.com Git - lilypond.git/blob - Documentation/fr/learning/common-notation.itely
Merge branch 'master' into translation
[lilypond.git] / Documentation / fr / learning / common-notation.itely
1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
2
3 @ignore
4    Translation of GIT committish: 9bdebf27dc4be7cf34976e3f44d9395d611305db
5
6    When revising a translation, copy the HEAD committish of the
7    version that you are working on.  For details, see the Contributors'
8     Guide, node Updating translation committishes..
9 @end ignore
10
11 @ignore
12 Tutorial guidelines:  (different from policy.txt!)
13 - unless you have a really good reason, use
14     @lilypond[verbatim,quote]
15
16 - use "aes" and "ees" instead of "as" and "es".  I know it's not
17   correct Dutch naming, but let's not confuse people with this
18   until we get to the Basic notation chapter.
19
20 - Add "Music Glossary: @rglos{foo}" to the *top* of the relevant
21   portions of the tutorial.
22
23 @end ignore
24
25 @c \version "2.19.21"
26
27 @c Translators: Nicolas Grandclaude, Ludovic Sardain, Gauvain Pocentek
28 @c Translation checkers: Jean-Charles Malahieude, Valentin Villenave, John Mandereau
29 @c Translation status: post-GDP
30
31 @node Bases de notation musicale
32 @chapter Bases de notation musicale
33 @translationof Common notation
34
35 Suite au premier contact avec le @ref{Tutoriel}, voyons comment
36 créer de belles partitions utilisant une notation musicale courante
37
38 @menu
39 * Notation sur une seule portée::
40 * Notes simultanées::
41 * Chansons::
42 * Dernières précisions::
43 @end menu
44
45
46 @node Notation sur une seule portée
47 @section Notation sur une seule portée
48 @translationof Single staff notation
49
50 Cette section présente la notation courante dont on a besoin pour
51 écrire une voix sur une portée.
52
53 @menu
54 * Barre et contrôle de mesure::
55 * Hauteurs et armure::
56 * Liaisons::
57 * Articulations et nuances::
58 * Ajout de texte::
59 * Barres de ligature automatiques et manuelles::
60 * Commandes rythmiques avancées::
61 @end menu
62
63
64 @node Barre et contrôle de mesure
65 @subsection Barre et contrôle de mesure
66 @translationof Bar lines and bar checks
67
68 @menu
69 * Barre de mesure::
70 * Contrôle de mesure::
71 @end menu
72
73
74 @node Barre de mesure
75 @unnumberedsubsubsec Barre de mesure
76 @translationof Bar lines
77
78 Les simples barres de mesure se placent automatiquement ; nul n'est
79 besoin de les saisir. D'autres types de barre de mesure sont accessibles
80 par la commande @code{\bar}, tels que @code{\bar "||"} pour une double
81 barre ou @code{\bar "|."} pour la barre finale.  Pour une liste des
82 différents styles de barre de mesure, voir
83 @ruser{Barres de mesure}.
84
85 @lilypond[verbatim,quote]
86 \relative { g'1 e1 \bar "||" c2. c'4 \bar "|." }
87 @end lilypond
88
89
90 @node Contrôle de mesure
91 @unnumberedsubsubsec Contrôle de mesure
92 @translationof Bar checks
93
94 Les contrôles de barre de mesure -- @emph{bar checks} en anglais -- ne
95 sont à priori pas strictement nécessaires.  Ils permettent cependant
96 d'indiquer directement dans le code saisi -- à l'aide d'une barre
97 verticale @code{|} -- l'emplacement des barres de mesure.  Grâce à ces
98 contrôleurs, LilyPond sera capable de déterminer si la durée que vous
99 avez attribuée aux notes correspondent bien à longueur de la mesure qui
100 les contient.  Les contrôles de mesure apportent aussi clarté et
101 organisation à votre code.
102
103 @c This example deliberately produces a warning
104 @lilypond[verbatim,quote]
105 \relative {
106 g'1 | e1 | c2. c' | g4 c g e | c4 r r2 |
107 }
108 @end lilypond
109
110 La compilation du code ci-dessus devrait vous afficher le message
111 suivant en console :
112
113 @example
114 Avertissement : échec du contrôle de mesure (barcheck) à 1/2
115  g'1 | e1 | c2. c'
116                    | g4 c g e | c4 r r2 |
117 @end example
118
119 Si la durée manquante est évitente au vu du rendu musical de cet exemple
120 minimaliste, l'avertissement émis en console ne manquera pas de porter à
121 votre attention l'absence du @code{4} à la troisième mesure.
122
123 @seealso
124 Manuel de notation :
125 @ruser{Barres de mesure},
126 @ruser{Vérification des limites et numéros de mesure}.
127
128
129 @node Hauteurs et armure
130 @subsection Hauteurs et armure
131 @translationof Pitches and key signatures
132
133 @menu
134 * Altérations::
135 * Armures::
136 * Attention aux armures et aux hauteurs::
137 @end menu
138
139 @warning{Si, comme nombre de nouveaux utilisateurs, vous avez du mal à
140 appréhender la notion de tonalité et d'armures dans LilyPond, consultez
141 la note à la fin de cette page.}
142
143 @node Altérations
144 @unnumberedsubsubsec Altérations
145 @translationof Pitch alterations
146
147 @cindex altérations
148 @cindex dièse
149 @cindex double dièse
150 @cindex dièse, double
151 @cindex bémol
152 @cindex double bémol
153 @cindex bémol, double
154 @cindex bécarre
155 @cindex naturel
156
157 @funindex es
158 @funindex is
159 @funindex eses
160 @funindex isis
161
162 Glossaire musicologique :
163 @rglosnamed{sharp,dièse}, @rglosnamed{flat,bémol},
164 @rglosnamed{double sharp,double dièse},
165 @rglosnamed{double flat,double bémol}, @rglosnamed{accidental,altération}.
166
167 LilyPond identifie le nom d'une note par sa hauteur.  Par exemple, un
168 @code{c} signifiera toujours @notation{do naturel}, quelle que soit la
169 tonalité ou l'armure.
170
171 Dans la notation par défaut, on obtient un @notation{dièse} en
172 ajoutant @code{is} au nom de la note, et un @notation{bémol} en
173 ajoutant @code{es}.  Comme vous pouvez vous y attendre, un double
174 dièse ou double bémol s'obtiennent en ajoutant @code{isis} ou
175 @code{eses}.  Cette syntaxe est dérivée de la convention de
176 dénomination des notes dans les langues nordiques et germaniques,
177 comme l'allemand ou le hollandais.
178
179 @c DIV specific
180 Cependant, si vous utilisez la commande @code{\language "italiano"} pour
181 entrer les noms de note français au lieu des noms hollandais, il faudra
182 ajouter un @code{d} pour obtenir un dièse, et un @code{b} pour un bémol.
183 Le double dièse et le double bémol s'obtiennent en ajoutant
184 respectivement @code{dd} et @code{bb}.  Pour en savoir plus sur les
185 autres langues disponibles, consultez
186 @ruser{Nom des notes dans d'autres langues}.
187 @c END DIV
188
189 @lilypond[verbatim,quote]
190 \relative { cis''1 ees fisis, aeses }
191 @end lilypond
192
193
194 @node Armures
195 @unnumberedsubsubsec Armures
196 @translationof Key signatures
197
198 @cindex armure, définition de l'
199 @cindex armure, altérations à l'
200 @cindex altérations à l'armure
201 @cindex majeur
202 @cindex mineur
203
204 @funindex \key
205 @funindex key
206 @funindex \major
207 @funindex major
208 @funindex \minor
209 @funindex minor
210
211 Glossaire musicologique :
212 @rglosnamed{key signature,armure}, @rglosnamed{major,majeur},
213 @rglosnamed{minor,mineur}.
214
215 L'armure est déterminée par la commande @code{\key}, suivie d'une
216 hauteur puis de @code{\major} (majeur) ou @code{\minor} (mineur).
217
218 @lilypond[verbatim,quote]
219 \relative {
220   \key d \major
221   d'4 fis a c |
222   \bar "||" \key c \minor
223   c,4 ees g b |
224 }
225 @end lilypond
226
227 @smallspace
228
229
230 @node Attention aux armures et aux hauteurs
231 @unnumberedsubsubsec Attention aux armures et aux hauteurs
232 @translationof Warning key signatures and pitches
233
234 Glossaire musicologique :
235 @rglosnamed{accidental,altération}, @rglosnamed{key signature,armure},
236 @rglosnamed{pitch,hauteur}, @rglosnamed{flat,bémol},
237 @rglosnamed{natural,bécarre}, @rglosnamed{sharp,dièse},
238 @rglos{transposition}, @rglosnamed{Pitch names,Noms de note}.
239
240 LilyPond fait une distinction nette entre le contenu musical et sa
241 représentation sur papier.  Un code tel que @code{d4 e fis2} définit la
242 hauteur et la durée de notes ; il s'agit du contenu.  L'armure, les
243 altérations « à la clef », fait partie de la représentation imprimée.
244 L'armure définit aussi des règles en matière de représentation des notes
245 imprimées.  LilyPond comparera chaque hauteur saisie avec l'armure pour
246 déterminer s'il est besoin d'imprimer une altération accidentelle.
247
248 La commande @code{\key} détermine l'armure, ce qui affectera la
249 représentation imprimée, et ne modifiera @b{en aucun cas} la hauteur
250 assignée à une note telle qu'un @code{c} que vous aurez saisi.
251
252 Dans cet exemple,
253
254 @lilypond[verbatim,quote]
255 \relative {
256   \key d \major
257   cis''4 d e fis
258 }
259 @end lilypond
260
261 @noindent
262 aucune note n'a d'altération accidentelle, et pourtant vous devrez
263 entrer le @code{is} pour les notes @code{cis} et @code{fis}.
264
265 Le code @code{b} ne veut pas dire @qq{Imprimez-moi un point noir sur
266 la troisième ligne de la portée.}  Cela signifie plutôt : @qq{Ici se
267 trouve une note dont la hauteur est un si naturel.}  Avec une armure
268 de la bémol majeur, ce @code{si} est flanqué d'un bécarre
269 accidentel :
270
271 @lilypond[verbatim,quote]
272 \relative {
273   \key aes \major
274   aes'4 c b c
275 }
276 @end lilypond
277
278 Prenons un autre exemple : imaginez-vous devant un piano ; dès
279 lors que vous voulez enfoncer l'une des touches noires, il vous faudra
280 @strong{ajouter} un @code{is} ou un @code{es} au nom de la note.
281
282 Ajouter explicitement toutes les altérations demande un peu plus
283 d'effort dans la phase de saisie, mais cela facilite grandement la
284 @notation{transposition}.  De plus, les altérations accidentelles
285 peuvent ainsi être imprimées suivant plusieurs conventions.  Pour
286 connaître les différentes manières dont les altérations accidentelles
287 peuvent être imprimées, consultez
288 @ruser{Altérations accidentelles automatiques}.
289
290 @seealso
291 Manuel de notation :
292 @ruser{Nom des notes dans d'autres langues},
293 @ruser{Altérations},
294 @ruser{Altérations accidentelles automatiques},
295 @ruser{Armure}.
296
297
298 @node Liaisons
299 @subsection Liaisons
300 @translationof Ties and slurs
301
302 @menu
303 * Liaisons de prolongation::
304 * Liaisons d'articulation::
305 * Liaisons de phrasé::
306 * Attention aux types de liaison::
307 @end menu
308
309 @cindex liaisons de prolongation
310 @cindex liaisons de tenue
311 @cindex prolongation, liaisons de
312 @cindex durée, liaisons de
313 @cindex tenue, liaisons de
314
315 @funindex ~
316 @funindex ( ... )
317 @funindex \( ... \)
318
319
320 @node Liaisons de prolongation
321 @unnumberedsubsubsec Liaisons de prolongation
322 @translationof Ties
323
324 Glossaire musicologique :
325 @rglosnamed{tie,liaison de tenue}.
326
327 Pour créer une liaison de prolongation -- parfois aussi appelée
328 liaison de tenue --, on ajoute un tilde @code{~} à la première note
329 liée.
330
331 @lilypond[verbatim,quote]
332 \relative { g'4~ g c2~ | c4~ c8 a~ a2 | }
333 @end lilypond
334
335 @cindex isolée, durée
336 @cindex durée isolée
337
338 Lorsque la hauteur ne change pas, ce qui est toujours le cas pour des
339 liaisons de tenue, les hauteurs suivantes peuvent être omises auquel cas
340 seules les durées successives seront mentionnées :
341
342 @lilypond[verbatim,quote]
343 \relative { g'4~ 4 c2~ | 4~ 8 a~ 2 | }
344 @end lilypond
345
346 Ce raccourci se révèle fort utile lors d'une succession de rythmes
347 appliqués à une même hauteur.  Notez bien qu'une espace entre une
348 hauteur isolée et une durée isolée aura pour effet de ne produire qu'une
349 seule note.  Autrement dit, @code{c4 a 8 8} sera interprété comme
350 @code{c4 a8 a8}, non comme @code{c4 a4 a8 a8} ; écrivez plutôt
351 @code{c4 a4 8 8}.
352
353 @node Liaisons d'articulation
354 @unnumberedsubsubsec Liaisons d'articulation
355 @translationof Slurs
356
357 @cindex liaisons d'articulation
358 @cindex articulation, liaisons d'
359 @cindex legato
360
361 @c Le terme de "slur" a deux sens en français : articulation et phrasé.
362 @c Je garde ici le terme "legato", tel qu'il apparaît dans le texte
363 @c original, car c'est celui qui me semble le plus couramment employé.
364 @c slur = "il zon" (articulation). jcm
365 @c phrasing slur = "ils ont des chapeaux ronds" (phrase). jcm
366
367 Glossaire musicologique :
368 @rglosnamed{slur,liaison}, @rglosnamed{phrasing,phrasé}.
369
370 Une liaison d'articulation ou @emph{legato} peut englober
371 plusieurs notes.  Les notes de départ et d'arrivée sont suivies
372 respectivement d'un signe @code{(} et @code{)}.
373
374 @lilypond[verbatim,quote]
375 \relative { d''4( c16) cis( d e c cis d) e( d4) }
376 @end lilypond
377
378
379 @node Liaisons de phrasé
380 @unnumberedsubsubsec Liaisons de phrasé
381 @translationof Phrasing slurs
382
383 @cindex liaisons de phrasé
384 @cindex phrasé, liaisons de
385
386 De plus longues liaisons, dites de phrasé, sont délimitées par @code{\(}
387 et @code{\)}.  Il est possible d'avoir en même temps des legatos et des
388 phrasés, mais pas plusieurs liaisons de phrasé ou de @emph{legato} à la
389 fois.
390
391 @lilypond[verbatim,quote]
392 \relative { g'4\( g8( a) b( c) b4\) }
393 @end lilypond
394
395 @c @ smallspace
396
397
398 @node Attention aux types de liaison
399 @unnumberedsubsubsec Attention aux types de liaison
400 @translationof Warnings slurs vs. ties
401
402
403 @cindex liaisons d'articulation et de prolongation, différences
404
405 Glossaire musicologique :
406 @rglos{articulation}, @rglosnamed{slur,liaison},
407 @rglosnamed{tie,liaison de tenue}.
408
409 Une liaison d'articulation ou de phrasé ressemble à une liaison de
410 prolongation, mais n'a pas la même signification.  Alors qu'une
411 liaison de prolongation ne peut relier que deux notes de même hauteur,
412 le @emph{legato} indique une articulation de plusieurs notes,
413 éventuellement en grand nombre.  Les liaisons de tenue peuvent être
414 enchâssées dans un @emph{legato} ou un phrasé.
415
416 @lilypond[verbatim,quote]
417 \relative { c''4(~ c8 d~ 4 e) }
418 @end lilypond
419
420 @seealso
421 Manuel de notation :
422 @ruser{Liaisons de prolongation},
423 @ruser{Liaisons d'articulation},
424 @ruser{Liaisons de phrasé}.
425
426
427 @node Articulations et nuances
428 @subsection Articulations et nuances
429 @translationof Articulation and dynamics
430
431 @menu
432 * Articulation::
433 * Doigté::
434 * Nuance::
435 @end menu
436
437
438 @node Articulation
439 @unnumberedsubsubsec Articulation
440 @translationof Articulations
441
442 @cindex articulation
443 @cindex accents
444 @cindex staccato
445
446 Glossaire musicologique :
447 @rglos{articulation}.
448
449 Des @notation{articulations} peuvent être ajoutées à une note, au moyen
450 d'un tiret @code{-} suivi d'un caractère :
451
452 @lilypond[verbatim,quote]
453 \relative {
454   c''4-^ c-+ c-- c-!
455   c4-> c-. c2-_
456 }
457 @end lilypond
458
459
460 @node Doigté
461 @unnumberedsubsubsec Doigté
462 @translationof Fingerings
463
464 @cindex doigtés
465
466 @funindex ^
467 @funindex _
468
469 Glossaire musicologique :
470 @rglosnamed{fingering,doigté}.
471
472 De même, des indications de doigté peuvent être ajoutées à une note en
473 utilisant un tiret (@samp{-}) et le chiffre à écrire :
474
475 @lilypond[verbatim,quote]
476 \relative { c''4-3 e-5 b-2 a-1 }
477 @end lilypond
478
479 Articulations et doigtés sont habituellement placés automatiquement,
480 mais vous pouvez spécifier leur positionnement en utilisant @code{^} (en
481 haut) ou @code{_} (en bas).  Vous pouvez aussi utiliser plusieurs
482 articulations sur la même note.  Dans la plupart des cas, cependant,
483 il est bon de laisser LilyPond déterminer l'emplacement de
484 l'articulation.
485
486 @lilypond[verbatim,quote]
487 \relative { c''4_-^1 d^. f^4_2-> e^-_+ }
488 @end lilypond
489
490
491 @node Nuance
492 @unnumberedsubsubsec Nuance
493 @translationof Dynamics
494
495 @cindex nuances
496 @cindex decrescendo
497 @cindex crescendo
498
499 @funindex \f
500 @funindex \ff
501 @funindex \mp
502 @funindex \p
503 @funindex \mf
504 @funindex \pp
505 @funindex \<
506 @funindex <
507 @funindex \>
508 @funindex >
509 @funindex \!
510 @funindex !
511
512 Glossaire musicologique :
513 @rglosnamed{dynamics,nuances},
514 @rglos{crescendo},
515 @rglos{decrescendo}.
516
517 On obtient un signe de @notation{nuance} en ajoutant à la note les
518 lettres du signe, précédées d'un anti-slash @code{\} :
519
520 @lilypond[verbatim,quote]
521 \relative { c''4\ff c\mf c\p c\pp }
522 @end lilypond
523
524 @cindex nuances
525 @cindex decrescendo
526 @cindex crescendo
527
528 @c Pluriel des termes musicaux italiens :
529 @c selon Littré, plutôt à la française (en "-os" qu'en "-i")
530
531 @notation{Crescendos} et @notation{decrescendos} débutent avec les
532 commandes @code{\<} et @code{\>}.  Ils se terminent soit par une
533 nuance d'arrivée, par exemple @code{\f}, soit par la commande
534 @code{\!} :
535
536 @lilypond[verbatim,quote]
537 \relative { c''4\< c\ff\> c c\! }
538 @end lilypond
539
540 @seealso
541 Manuel de notation :
542 @ruser{Articulations et ornements},
543 @ruser{Doigtés},
544 @ruser{Nuances}.
545
546
547 @node Ajout de texte
548 @subsection Ajout de texte
549 @translationof Adding text
550
551 @cindex texte, ajout de
552 @cindex ajout de texte
553 @cindex étiquette
554
555 @funindex \markup
556 @funindex markup
557
558 On peut ajouter du texte à une partition :
559
560 @lilypond[verbatim,quote,fragment]
561 c''2^"espr" a'_"legato"
562 @end lilypond
563
564 Pour mettre en forme du texte, on utilise la commande @code{\markup} :
565
566 @lilypond[verbatim,quote,fragment]
567 c''2^\markup { \bold espr }
568 a'2_\markup {
569   \dynamic f \italic \small { 2nd } \hspace #0.1 \dynamic p
570 }
571 @end lilypond
572
573 @seealso
574 Manuel de notation :
575 @ruser{Ajout de texte}.
576
577
578 @node Barres de ligature automatiques et manuelles
579 @subsection Barres de ligature automatiques et manuelles
580 @translationof Automatic and manual beams
581
582 @cindex ligature
583 @cindex barre de ligature
584 @cindex ligatures automatiques
585 @cindex ligatures manuelles
586 @cindex ligatures explicites
587
588 @funindex [ ... ]
589 @funindex [
590 @funindex ]
591 @funindex \autoBeamOff
592 @funindex autoBeamOff
593 @funindex \autoBeamOn
594 @funindex autoBeamOn
595
596 Glossaire musicologique :
597 @rglosnamed{beam,ligature}.
598
599 Toutes les barres de ligature sont dessinées automatiquement :
600
601 @lilypond[verbatim,quote]
602 \relative { a'8 ais d ees r d c16 b a8 }
603 @end lilypond
604
605 @noindent
606 Lorsqu'on n'aime pas la manière dont les notes sont automatiquement
607 groupées, il est possible de les ligaturer manuellement, en marquant la
608 première note à attacher d'un crochet ouvrant @code{[} et la dernière
609 d'un crochet fermant @code{]}.
610
611 @lilypond[verbatim,quote]
612 \relative { a'8[ ais] d[ ees r d] c16 b a8 }
613 @end lilypond
614
615 Pour désactiver les barres de ligature automatiques pour des passages
616 entiers, utilisez la commande @code{\autoBeamOff}, et utilisez
617 @code{\autoBeamOn} pour les réactiver.
618
619 @lilypond[verbatim,quote]
620 \relative {
621   \autoBeamOff
622   a'8 c b4 d8. c16 b4 |
623   \autoBeamOn
624   a8 c b4 d8. c16 b4 |
625 }
626 @end lilypond
627
628 @seealso
629 Manuel de notation :
630 @ruser{Barres de ligature automatiques},
631 @ruser{Barres de ligature manuelles}.
632
633
634 @node Commandes rythmiques avancées
635 @subsection Commandes rythmiques avancées
636 @translationof Advanced rhythmic commands
637
638 @menu
639 * Mesure incomplète::
640 * N-olet::
641 * Note d'ornement::
642 @end menu
643
644
645 @node Mesure incomplète
646 @unnumberedsubsubsec Mesure incomplète
647 @translationof Partial measure
648
649 @cindex levée
650 @cindex anacrouse
651 @cindex mesure incomplète
652
653 @funindex \partial
654 @funindex partial
655
656 Glossaire musicologique : @rglosnamed{anacrusis,anacrouse}.
657
658 On crée une levée (ou anacrouse) avec la commande @code{\partial},
659 suivie d'une durée : @code{\partial 4} produit une levée d'une
660 noire et @code{\partial 8} d'une croche.
661
662 @lilypond[verbatim,quote]
663 \relative {
664   \partial 8 f''8 |
665   c2 d |
666 }
667 @end lilypond
668
669
670 @node N-olet
671 @unnumberedsubsubsec N-olet
672 @translationof Tuplets
673
674 @cindex n-olets
675 @cindex triolets
676
677 @funindex \tuplet
678 @funindex tuplet
679
680 Glossaire musicologique : @rglosnamed{note value,valeur d'une note},
681 @rglosnamed{triplet,triolet}.
682
683 Les @notation{n-olets} sont créés avec la commande @code{\tuplet}, qui
684 prend deux arguments : une fraction et une expression musicale. La
685 fraction représente le nombre de notes du n-olet à inscrire dans la durée
686 normalement attribuée à un certain nombre de notes de même valeur. Dans
687 le cas de triolets, par exemple, trois notes recouvrent la même durée
688 que deux ; un @notation{triolet} portera donc une fraction de 3/2.
689
690 @lilypond[verbatim,quote]
691 \relative {
692   \tuplet 3/2 { f''8 g a }
693   \tuplet 3/2 { c8 r c }
694   \tuplet 3/2 { f,8 g16[ a g a] }
695   \tuplet 3/2 { d4 a8 }
696 }
697 @end lilypond
698
699
700 @node Note d'ornement
701 @unnumberedsubsubsec Note d'ornement
702 @translationof Grace notes
703
704 @cindex notes d'ornement
705 @cindex ornementation
706 @cindex appoggiature
707 @cindex acciaccature
708
709 @funindex \grace
710 @funindex grace
711 @funindex \acciaccatura
712 @funindex acciaccatura
713 @funindex \appoggiatura
714 @funindex acciaccatura
715
716 Glossaire musicologique :
717 @rglosnamed{grace notes,ornements},
718 @rglosnamed{acciaccatura,acciaccature},
719 @rglosnamed{appoggiatura,appogiature}.
720
721 Des @notation{notes d'ornement} s'obtiennent en appliquant la commande
722 @code{\grace}, @code{\appoggiatura} ou @code{\acciaccatura} à une
723 expression musicale :
724
725 @lilypond[verbatim,quote]
726 \relative {
727   c''2 \grace { a32 b } c2 |
728   c2 \appoggiatura b16 c2 |
729   c2 \acciaccatura b16 c2 |
730 }
731 @end lilypond
732
733 @seealso
734 Manuel de notation :
735 @ruser{Notes d'ornement},
736 @ruser{N-olets},
737 @ruser{Levées}.
738
739
740 @node Notes simultanées
741 @section Notes simultanées
742 @translationof Multiple notes at once
743
744 Cette section traite de situations où l'on a plus d'une note à la
745 fois : plusieurs instruments, plusieurs voix ou portées pour un
746 même instrument (le piano, par exemple), et les accords.
747
748 En théorie musicale, la polyphonie désigne une musique constituée de
749 plusieurs voix ; dans LilyPond, ce terme désigne les situations où
750 il y a plus d'une voix sur une même portée.
751
752 @menu
753 * Les expressions musicales en clair::
754 * Plusieurs portées::
755 * Regroupements de portées::
756 * Combinaison de notes en accords::
757 * Polyphonie sur une portée::
758 @end menu
759
760
761 @node Les expressions musicales en clair
762 @subsection Les expressions musicales en clair
763 @translationof Music expressions explained
764
765 @cindex expression musicale
766
767 @menu
768 * Analogie avec les expressions mathématiques::
769 * Expressions musicales simultanées -- plusieurs portées::
770 * Expressions musicales simultanées -- une seule portée::
771 @end menu
772
773 Dans les fichiers source LilyPond, la musique est représentée par ce
774 qu'on appelle des @emph{expressions musicales}.  En soi, une seule note
775 peut constituer une expression musicale :
776
777 @lilypond[verbatim,quote,fragment]
778 a'4
779 @end lilypond
780
781 Mettre un groupe de notes entre accolades crée une nouvelle expression
782 musicale, appelée @emph{expression musicale composée}.  En voici un
783 exemple avec deux notes :
784
785 @lilypond[verbatim,quote]
786 \relative { a'4 g4 }
787 @end lilypond
788
789 La mise entre accolades d'une séquence d'expressions musicales -- des
790 notes par exemple -- signifie qu'elles doivent être jouées
791 successivement, les unes après les autres.  Le résultat est une
792 expression, qui peut elle-même être regroupée séquentiellement avec
793 d'autres expressions.  Ici, l'expression de l'exemple précédent est
794 combinée à deux notes :
795
796 @lilypond[verbatim,quote]
797 \relative { { a'4 g } f g }
798 @end lilypond
799
800
801 @node Analogie avec les expressions mathématiques
802 @unnumberedsubsubsec Analogie avec les expressions mathématiques
803 @translationof Analogy mathematical expressions
804
805 @cindex expression
806
807 Ce mécanisme est similaire aux formules mathématiques : une grosse
808 formule est créée en assemblant plusieurs petites formules.  De telles
809 formules sont appelées expressions, elles ont une définition
810 récursive, de telle sorte que vous pouvez fabriquer des expressions
811 arbitrairement longues et complexes.  Par exemple :
812
813 @example
814 1
815
816 1 + 2
817
818 (1 + 2) * 3
819
820 ((1 + 2) * 3) / (4 * 5)
821 @end example
822
823 Ceci est une suite d'expressions, où chacune est contenue dans la
824 suivante.  Les expressions les plus simples sont les nombres, et de
825 plus grandes expressions sont produites en combinant des expressions
826 avec des opérateurs -- comme @code{+}, @code{*} et @code{/} -- et
827 des parenthèses.  Tout comme les expressions mathématiques, les
828 expressions musicales peuvent être imbriquées avec une profondeur
829 arbitraire, ce qui est nécessaire pour des partitions complexes comme
830 de la musique polyphonique.
831
832
833 @node Expressions musicales simultanées -- plusieurs portées
834 @unnumberedsubsubsec Expressions musicales simultanées -- plusieurs portées
835 @translationof Simultaneous music expressions multiple staves
836
837 @cindex portées multiples
838 @cindex polyphonie
839 @cindex combinaison d'expressions en parallèle
840 @cindex parallèles, expressions
841 @cindex expressions parallèles
842 @cindex hauteur relative et musique simultanée
843 @cindex musique simultanée et hauteur relative
844 @cindex hauteur relative et expressions parallèles
845 @cindex expressions parallèles et hauteur relative
846
847 @funindex <<
848 @funindex >>
849 @funindex << ... >>
850
851 Glossaire musicologique : @rglosnamed{polyphony,polyphonie}.
852
853 Cette technique est utile pour de la musique @notation{polyphonique}.
854 Pour entrer une musique avec plusieurs voix ou plusieurs portées, nous
855 pouvons aussi combiner @emph{en parallèle} les expressions : deux
856 voix qui doivent être jouées en même temps, sont entrées comme une
857 combinaison simultanée de deux expressions.  Une expression musicale
858 @qq{simultanée} est formée en entourant les expressions entre @code{<<}
859 et @code{>>}.  Dans l'exemple suivant, trois expressions (contenant
860 chacune deux notes distinctes) sont combinées simultanément.
861
862 @lilypond[verbatim,quote]
863 <<
864   \relative { a'2 g }
865   \relative { f'2 e }
866   \relative { d'2 b }
867 >>
868 @end lilypond
869
870 Notez que nous avons ici indenté chaque niveau du fichier d'entrée
871 avec un nombre d'espaces différent.  LilyPond se moque -- ou presque
872 -- de l'espace qu'il peut y avoir ou non au début d'une ligne, mais
873 un code bien indenté est bien plus lisible par des humains.
874
875 @warning{La hauteur de chaque note saisie est relative à la précédente ;
876 seule la première première note verra sa hauteur déterminée relativement
877 au au @code{c''} de la commande @code{@bs{}relative} de départ.}
878
879
880 @node Expressions musicales simultanées -- une seule portée
881 @unnumberedsubsubsec Expressions musicales simultanées -- une seule portée
882 @translationof Simultaneous music expressions single staff
883
884 Pour déterminer le nombre de portées, LilyPond regarde le début de la
885 première expression.  Si c'est une seule note, une seule portée est
886 produite ; si c'est une expression simultanée, plusieurs portées sont
887 produites.  Nous avons dans l'exemple ci-dessous une expression
888 complexe ; dans la mesure où elle débute par une note seule, elle sera
889 produite sur une unique portée.
890
891 @lilypond[verbatim,quote]
892 \relative {
893   c''2 <<c e>> |
894   << { e2 f } { c <<b d>> } >> |
895 }
896 @end lilypond
897
898
899 @node Plusieurs portées
900 @subsection Plusieurs portées
901 @translationof Multiple staves
902
903 @cindex multiples portées
904 @cindex portées multiples
905 @cindex contexte
906 @cindex contexte de notation
907 @cindex notation, contexte
908
909 @funindex \new Staff
910 @funindex new Staff
911 @funindex Staff
912 @funindex \new
913 @funindex new
914 @funindex Score
915 @funindex Voice
916 @funindex Lyrics
917 @funindex ChordNames
918
919 Comme nous l'avons vu dans @ref{Les expressions musicales en clair}, un
920 fichier d'entrée LilyPond est fait d'expressions musicales.  Si la
921 partition commence par plusieurs expressions simultanées, LilyPond
922 créera plusieurs portées.  Cependant, il est plus facile de prévoir le
923 nombre de portées si on les crée explicitement, ce que nous allons
924 voir.
925
926 Pour créer plus d'une portée, on ajoute @code{\new Staff} au début de
927 chaque partie de la musique constituant une portée.  Ces éléments
928 @code{Staff} sont ensuite combinés en parallèle avec @code{<<} et
929 @code{>>}, comme ci-dessous.
930
931 @lilypond[verbatim,quote]
932 <<
933   \new Staff { \clef "treble" c''4 }
934   \new Staff { \clef "bass" c4 }
935 >>
936 @end lilypond
937
938 La commande @code{\new} introduit un @qq{contexte de notation}.  Un
939 contexte de notation est un environnement dans lequel les événements
940 musicaux -- comme les notes ou les commandes @code{\clef} -- sont
941 interprétés.  Pour des pièces simples, ces contextes sont créés
942 automatiquement.  Pour des pièces plus complexes, il est préférable de
943 spécifier explicitement les contextes, afin de s'assurer que chaque
944 fragment aura sa propre portée.
945
946 Il existe différents types de contextes.  Les contextes @code{Score}
947 (partition), @code{Staff} (portée) et @code{Voice} (voix) gèrent la
948 notation de la mélodie, alors que @code{Lyrics} gère les paroles et
949 @code{ChordNames} imprime des noms d'accord.
950
951 En terme de syntaxe, ajouter @code{\new} devant une expression
952 musicale crée une plus grande expression musicale.  En reprenant la
953 comparaison précédente, cela ressemble au signe @emph{moins} en
954 mathématiques.  La formule @math{(4+5)} est une expression, donc
955 @math{-(4+5)} constitue une plus grande expression.
956
957 Les chiffres de métrique indiqués sur une portée affectent toutes les
958 autres portées.  En revanche l'armure d'une portée n'affecte @emph{pas}
959 les autres portées.  Ces caractéristiques par défaut se justifient par
960 le fait que l'utilisation d'instruments transpositeurs est bien plus
961 fréquente que la musique polyrythmique.
962
963 @lilypond[verbatim,quote]
964 <<
965   \new Staff { \clef "treble" \key d \major \time 3/4 c''4 }
966   \new Staff { \clef "bass" c4 }
967 >>
968 @end lilypond
969
970
971 @node Regroupements de portées
972 @subsection Regroupements de portées
973 @translationof Staff groups
974
975 @cindex portée double
976 @cindex portée pour piano
977 @cindex piano, portée pour
978 @cindex clavier, portée pour
979 @cindex chœur, système pour
980 @cindex système pour chœur
981 @cindex système
982 @cindex portées, regroupement de
983 @cindex regroupement de portées
984
985 @funindex PianoStaff
986 @funindex GrandStaff
987 @funindex ChoirStaff
988
989 Glossaire musicologique :
990 @rglosnamed{brace,accolade},
991 @rglosnamed{staff,portée},
992 @rglosnamed{system,système}.
993
994 La musique pour piano s'écrit sur deux portées reliées par une
995 @notation{accolade}.  La gravure de ce type de portée est semblable à
996 l'exemple de musique polyphonique de @ref{Plusieurs portées}, mais
997 maintenant cette expression entière est interprétée dans un contexte
998 @code{PianoStaff} :
999
1000 @example
1001 \new PianoStaff <<
1002   \new Staff @dots{}
1003   \new Staff @dots{}
1004 >>
1005 @end example
1006
1007 Voici un bref exemple :
1008
1009 @lilypond[verbatim,quote]
1010 \new PianoStaff <<
1011   \new Staff \relative { \time 2/4 c''4 e | g g, | }
1012   \new Staff \relative { \clef "bass" c4 c' | e c | }
1013 >>
1014 @end lilypond
1015
1016 Vous pouvez générer d'autres formes de regroupement, avec
1017 @code{\new GrandStaff} pour une partition d'orchestre, ou
1018 @code{\new ChoirStaff} qui sied particulièrement aux partitions
1019 chorales.  Chacun de ces regroupements constitue un contexte à part
1020 entière, avec ses particularités, tant au niveau du signe qui regroupe
1021 les portées au sein d'un @notation{système} qu'au niveau de l'étendue
1022 des barres de mesure.
1023
1024 @seealso
1025 Manuel de notation :
1026 @ruser{Instruments utilisant des portées multiples},
1027 @ruser{Gravure des portées}.
1028
1029
1030 @node Combinaison de notes en accords
1031 @subsection Combinaison de notes en accords
1032 @translationof Combining notes into chords
1033
1034 @cindex accords, notes simultanées
1035 @cindex accords et durée
1036
1037 @funindex <
1038 @funindex >
1039 @funindex < ... >
1040
1041 Glossaire musicologique : @rglosnamed{chord,accord}.
1042
1043 Nous avons vu précédemment comment combiner des notes simultanément,
1044 en les encadrant par des chevrons doubles @code{<<} et @code{>>}.  Pour
1045 produire des accords simples, c'est-à-dire une superposition de notes
1046 de même durée, on encadre les hauteurs de notes par des chevrons simples
1047 @code{<} et @code{>}, et on écrit la durée juste après.
1048
1049 @lilypond[verbatim,quote]
1050 \relative { r4 <c'' e g> <c f a>2 }
1051 @end lilypond
1052
1053 Beaucoup d'éléments de notation que l'on peut attacher à une note
1054 simple, comme une liaison, un crochet indiquant un début ou une fin de
1055 lien, un signe d'articulation, peuvent être également attachés à un
1056 accord : il faut ajouter ces indications après les hauteurs et la
1057 durée, donc @emph{à l'extérieur} des chevrons.
1058
1059 @lilypond[verbatim,quote]
1060 \relative {
1061   r4 <c'' e g>~ <c f a>2 |
1062   <c e g>8[ <c f a> <c e g> <c f a>]
1063     <c e g>8\>[ <c f a> <c f a> <c e g>]\! |
1064   r4 <c e g>8.\p <c f a>16( <c e g>4-. <c f a>) |
1065 }
1066 @end lilypond
1067
1068 @seealso
1069 Manuel de notation :
1070 @ruser{Notes en accords}.
1071
1072
1073 @node Polyphonie sur une portée
1074 @subsection Polyphonie sur une portée
1075 @translationof Single staff polyphony
1076
1077 @cindex polyphonie
1078 @cindex voix multiples sur une portée
1079 @cindex multiples voix sur une portée
1080 @cindex silence invisible
1081 @cindex invisible, silence
1082
1083 @funindex << ... \\ ... >>
1084 @funindex <<
1085 @funindex \\
1086 @funindex >>
1087
1088 Bien que LilyPond gère la musique polyphonique sans difficulté, cela
1089 fait appel à des concepts que nous n'avons pas encore abordés.  C'est la
1090 raison pour laquelle nous ne nous étendrons pas tout de suite sur ce
1091 sujet et préférons vous inciter à consulter les chapitres dédiés à
1092 l'étude de ces concepts.
1093
1094 @seealso
1095 Manuel d'initiation :
1096 @ref{Les voix contiennent la musique}.
1097
1098 Manuel de notation :
1099 @ruser{Notes simultanées}.
1100
1101
1102 @node Chansons
1103 @section Chansons
1104 @translationof Songs
1105
1106 Cette section présente l'écriture vocale et les partitions de variété.
1107
1108 @menu
1109 * Écriture de chants simples::
1110 * Alignement des paroles sur une mélodie::
1111 * Paroles pour plusieurs portées::
1112 @end menu
1113
1114
1115 @node Écriture de chants simples
1116 @subsection Écriture de chants simples
1117 @translationof Setting simple songs
1118
1119 @cindex paroles
1120 @cindex chansons
1121
1122 @funindex \addlyrics
1123 @funindex addlyrics
1124
1125 Glossaire musicologique : @rglos{lyrics}.
1126
1127 Prenons une mélodie toute simple, la comptine @emph{Girls and boys
1128 come out to play}.
1129
1130 @lilypond[verbatim,quote]
1131 \relative {
1132   \key g \major
1133   \time 6/8
1134   d''4 b8 c4 a8 | d4 b8 g4
1135 }
1136 @end lilypond
1137
1138 Des @notation{paroles} peuvent être associées à ces notes, en les
1139 combinant avec la commande @code{\addlyrics}.  On entre les paroles en
1140 séparant chaque syllable par une espace :
1141
1142 @lilypond[verbatim,quote]
1143 <<
1144   \relative {
1145     \key g \major
1146     \time 6/8
1147     d''4 b8 c4 a8 | d4 b8 g4
1148   }
1149   \addlyrics {
1150     Girls and boys come out to play,
1151   }
1152 >>
1153 @end lilypond
1154
1155 Notez les doubles chevrons @code{<< @dots{} >>} encadrant toute la
1156 pièce ; ils indiquent simplement que la musique et les paroles se
1157 produisent en même temps.
1158
1159
1160 @node Alignement des paroles sur une mélodie
1161 @subsection Alignement des paroles sur une mélodie
1162 @translationof Aligning lyrics to a melody
1163
1164 @cindex mélisme
1165 @cindex ligne d'extension
1166 @cindex trait d'union (paroles)
1167 @cindex caractère souligné (paroles)
1168 @cindex paroles, alignement des
1169 @cindex alignement des paroles
1170 @cindex paroles, mot de plusieurs syllabes
1171
1172 Glossaire musicologique : @rglosnamed{melisma,mélisme},
1173 @rglosnamed{extender line,ligne d'extension}.
1174
1175 La deuxième ligne de la comptine précédente est @emph{The moon doth
1176 shine as bright as day}.  Ajoutons-la au code.
1177
1178 @lilypond[verbatim,quote]
1179 <<
1180   \relative {
1181     \key g \major
1182     \time 6/8
1183     d''4 b8 c4 a8 | d4 b8 g4 g8 |
1184     a4 b8 c b a | d4 b8 g4. |
1185   }
1186   \addlyrics {
1187     Girls and boys come out to play,
1188     The moon doth shine as bright as day;
1189   }
1190 >>
1191 @end lilypond
1192
1193 Remarquez comme les paroles ajoutées ne s'alignent pas bien avec les
1194 notes.  Le mot @emph{shine} devrait être chanté sur deux notes au lieu
1195 d'une.  On appelle ceci un @notation{mélisme} : il s'agit d'une seule
1196 syllabe chantée sur plus d'une note.  Il existe plusieurs façons
1197 d'étaler une syllabe sur plusieurs notes, la plus simple étant de lier
1198 les notes du mélisme.  Pour les détails, consultez @ref{Liaisons}.
1199
1200 @lilypond[verbatim,quote]
1201 <<
1202   \relative {
1203     \key g \major
1204     \time 6/8
1205     d''4 b8 c4 a8 | d4 b8 g4 g8 |
1206     a4 b8 c( b) a | d4 b8 g4. |
1207   }
1208   \addlyrics {
1209     Girls and boys come out to play,
1210     The moon doth shine as bright as day;
1211   }
1212 >>
1213 @end lilypond
1214
1215 Les paroles sont maintenant correctement alignées, mais les liens de
1216 croche automatiques ne conviennent pas pour les notes au-dessus de
1217 @emph{shine as}.  On peut les corriger en ajoutant des liens de croche
1218 manuels ; pour ceci consultez
1219 @ref{Barres de ligature automatiques et manuelles}.
1220
1221 @lilypond[verbatim,quote]
1222 <<
1223   \relative {
1224     \key g \major
1225     \time 6/8
1226     d''4 b8 c4 a8 | d4 b8 g4 g8 |
1227     a4 b8 c([ b]) a | d4 b8 g4. |
1228   }
1229   \addlyrics {
1230     Girls and boys come out to play,
1231     The moon doth shine as bright as day;
1232   }
1233 >>
1234 @end lilypond
1235
1236 Au lieu d'utiliser une liaison, on peut indiquer le mélisme dans les
1237 paroles en insérant un caractère souligné @code{_} pour chaque note du
1238 mélisme sauf la première.
1239
1240 @lilypond[verbatim,quote]
1241 <<
1242   \relative {
1243     \key g \major
1244     \time 6/8
1245     d''4 b8 c4 a8 | d4 b8 g4 g8 |
1246     a4 b8 c[ b] a | d4 b8 g4. |
1247   }
1248   \addlyrics {
1249     Girls and boys come out to play,
1250     The moon doth shine _ as bright as day;
1251   }
1252 >>
1253 @end lilypond
1254
1255 Si une syllabe s'étend sur un grand nombre de notes ou une note très
1256 longue, on représente souvent le mélisme par un @notation{trait de
1257 prolongation}, qu'on entre avec double caractère souligné @code{__}.
1258 L'exemple suivant montre les trois premières mesures de la plainte de
1259 Didon, extraite de @notation{Didon et Énée} de Purcell.
1260
1261 @lilypond[verbatim,quote]
1262 <<
1263   \relative {
1264     \key g \minor
1265     \time 3/2
1266    g'2 a bes | bes2( a) b2 |
1267     c4.( bes8 a4. g8 fis4.) g8 | fis1
1268   }
1269   \addlyrics {
1270     When I am laid,
1271     am laid __ in earth,
1272   }
1273 >>
1274 @end lilypond
1275
1276 Aucun exemple jusqu'à présent n'a utilisé de mots de plus d'une
1277 syllabe.  Dans des paroles, de tels mots sont écrits en syllabes
1278 séparées par des traits d'union.  Avec LilyPond, on utilise deux
1279 tirets pour produire un trait d'union centré entre deux syllabes.
1280 L'exemple suivant montre tout ce que nous avons vu jusqu'à maintenant
1281 sur l'alignement de paroles à une mélodie.
1282
1283 @c no ragged-right here because otherwise the hyphens get lost,
1284 @c but the example is long enough to avoid looking strange.
1285 @lilypond[verbatim,quote,noragged-right]
1286 <<
1287   \relative {
1288     \key g \major
1289     \time 3/4
1290     \partial 4
1291     d'4 | g4 g a8( b) | g4 g b8( c) |
1292     d4 d e | c2
1293   }
1294   \addlyrics {
1295     A -- way in a __ man -- ger,
1296     no __ crib for a bed, __
1297   }
1298 >>
1299 @end lilypond
1300
1301 Avec certaines paroles, en particulier en italien, il se produit la
1302 situation inverse : il peut y avoir plusieurs syllabes sur une seule
1303 note.  On réalise ceci avec LilyPond grâce à un caractère souligné
1304 @code{_} sans espace entre les syllabes, ou alors en groupant les
1305 syllabes avec des guillemets.  L'exemple suivant est extrait de l'air de
1306 Figaro @emph{Largo al factotum}, dans @notation{Figaro} de Rossini, où
1307 la syllabe @emph{al} est chantée sur la même note que @emph{go}.
1308
1309 @c no ragged-right here because otherwise the hyphens get lost,
1310 @c but the example is long enough to avoid looking strange.
1311 @lilypond[verbatim,quote,noragged-right]
1312 <<
1313   \relative {
1314     \clef bass
1315     \key c \major
1316     \time 6/8
1317     c'4.~ 8 d b | c8([ d]) b c d b | c8
1318   }
1319   \addlyrics {
1320     Lar -- go_al fac -- to -- tum del -- la cit -- tà
1321   }
1322 >>
1323 @end lilypond
1324
1325 @seealso
1326 Manuel de notation :
1327 @ruser{Musique vocale}.
1328
1329
1330 @node Paroles pour plusieurs portées
1331 @subsection Paroles pour plusieurs portées
1332 @translationof Lyrics to multiple staves
1333
1334 @cindex paroles et portées multiples
1335 @cindex portées multiples et paroles
1336
1337 La méthode simple d'ajout de paroles avec @code{\addlyrics} peut être
1338 également utilisée pour placer des paroles sous plusieurs portées.
1339 L'exemple suivant est extrait de @emph{Judas Macchabée} de Händel.
1340
1341 @lilypond[verbatim,quote]
1342 <<
1343   \relative {
1344     \key f \major
1345     \time 6/8
1346     \partial 8
1347     c''8 | c8([ bes]) a a([ g]) f | f'4. b, | c4.~ 4
1348   }
1349   \addlyrics {
1350     Let flee -- cy flocks the hills a -- dorn, __
1351   }
1352   \relative {
1353     \key f \major
1354     \time 6/8
1355     \partial 8
1356     r8 | r4. r4 c'8 | a'8([ g]) f f([ e]) d | e8([ d]) c bes'4
1357   }
1358   \addlyrics {
1359     Let flee -- cy flocks the hills a -- dorn,
1360   }
1361 >>
1362 @end lilypond
1363
1364 Pour produire des partitions plus complexes ou plus longues que cet
1365 exemple simple, il est vivement conseillé de séparer la structure de
1366 la partition des notes et paroles, grâce à des variables.  Ceci sera
1367 détaillé plus loin dans
1368 @ref{Organisation du code source avec des variables}.
1369
1370 @seealso
1371 Manuel de notation :
1372 @ruser{Musique vocale}.
1373
1374
1375 @node Dernières précisions
1376 @section Dernières précisions
1377 @translationof Final touches
1378
1379 L'ultime section de ce tutoriel montre comment ajouter une touche
1380 finale à des morceaux simples, et constitue une introduction au reste
1381 du manuel.
1382
1383 @menu
1384 * Organisation du code source avec des variables::
1385 * Ajout de titres::
1386 * Noms de note absolus::
1387 * Après le tutoriel::
1388 @end menu
1389
1390
1391 @node Organisation du code source avec des variables
1392 @subsection Organisation du code source avec des variables
1393 @translationof Organizing pieces with variables
1394
1395 @cindex variables
1396 @cindex variables, définition
1397 @cindex identificateurs
1398 @cindex macros
1399 @cindex assignation de variables
1400 @cindex utilisation de variables
1401 @cindex variables, utilisation de
1402 @cindex variables, caractères autorisés dans les
1403 @cindex caractères autorisés dans les variables
1404
1405 Lorsque l'on combine tous les éléments étudiés précédemment pour
1406 écrire des partitions plus longues, les expressions musicales prennent
1407 de l'ampleur et, dans le cas des pièces polyphoniques, deviennent
1408 profondément imbriquées, jusqu'au point où il devient difficile de se
1409 repérer dans le fichier source.  Cet inconvénient peut être résolu par
1410 l'utilisation de @emph{variables}.
1411
1412 En utilisant des variables, parfois appelées identificateurs ou
1413 macros, on peut scinder des expressions musicales complexes en des
1414 expressions plus simples.  Une variable se définit comme suit :
1415
1416 @example
1417 musiqueToto = @{ @dots{} @}
1418 @end example
1419
1420 Le contenu de l'expression musicale @code{musiqueToto} pourra être
1421 utilisé plus loin en faisant précéder son nom d'un anti-slash,
1422 c'est-à-dire @code{\musiqueToto}, tout comme n'importe quelle commande
1423 LilyPond.  Toute variable doit être définie @emph{avant} son
1424 utilisation dans une autre expression musicale.
1425
1426 @lilypond[verbatim,quote]
1427 violin = \new Staff {
1428   \relative {
1429     a'4 b c b
1430   }
1431 }
1432
1433 cello = \new Staff {
1434   \relative {
1435     \clef bass
1436     e2 d
1437   }
1438 }
1439
1440 {
1441   <<
1442     \violin
1443     \cello
1444   >>
1445 }
1446 @end lilypond
1447
1448 @noindent
1449 Le nom d'une variable ne doit comporter que des caractères
1450 alphabétiques non accentués, aucun nombre ni tiret ne sont autorisés.
1451
1452 On peut utiliser une variable déjà définie autant de fois que l'on
1453 veut, y compris dans la définition d'une nouvelle variable ; par
1454 exemple, cela peut servir à saisir un motif qu'une seule fois, même
1455 s'il se répète un grand nombre de fois dans la pièce.
1456
1457 @lilypond[verbatim,quote]
1458 tripletA = \tuplet 3/2 { c,8 e g }
1459 barA = { \tripletA \tripletA \tripletA \tripletA }
1460
1461 \relative c'' {
1462  \barA \barA
1463 }
1464 @end lilypond
1465
1466 Il est possible d'utiliser des variables de types variés.  Par exemple,
1467
1468 @example
1469 largeur = 4.5\cm
1470 nom = "Wendy"
1471 aFivePaper = \paper @{ paperheight = 21.0 \cm @}
1472 @end example
1473
1474 En fonction de son contenu, un identificateur peut être utilisé à
1475 différents endroits.  L'exemple suivant utilise les variables définies
1476 ci-dessus.
1477
1478 @example
1479 \paper @{
1480   \aFivePaper
1481   line-width = \largeur
1482 @}
1483
1484 @{
1485   c4^\nom
1486 @}
1487 @end example
1488
1489
1490 @node Ajout de titres
1491 @subsection Ajout de titres
1492 @translationof Adding titles
1493
1494 @cindex titre
1495 @cindex en-têtes
1496 @cindex bloc d'en-tête
1497
1498 @funindex \header
1499 @funindex header
1500
1501 On indique les informations bibliographiques -- nom du morceau, du
1502 compositeur, numéro d'opus@dots{} -- dans un bloc à part, le bloc
1503 d'en-tête @code{\header}, qui existe indépendamment de l'expression
1504 musicale principale.  Le bloc @code{\header} est habituellement placé
1505 en début de fichier, après le numéro de version.
1506
1507 @example
1508 \version @w{"@version{}"}
1509
1510 \header @{
1511   title = "Symphonie"
1512   composer = "Moi"
1513   opus = "Op. 9"
1514 @}
1515
1516 @{
1517  @dots{} la musique @dots{}
1518 @}
1519 @end example
1520
1521 Quand LilyPond traite le fichier, le titre et le compositeur sont
1522 imprimés au début de la partition.  Vous trouverez plus d'informations
1523 sur les titres à la section
1524 @ruser{Création de titres et entête ou pied de page}.
1525
1526
1527 @node Noms de note absolus
1528 @subsection Noms de note absolus
1529 @translationof Absolute note names
1530
1531 @cindex notes, nom des
1532 @cindex absolu, mode
1533 @cindex mode absolu
1534 @cindex hauteurs, valeurs absolues
1535 @cindex noms de note absolus
1536
1537 Jusqu'ici nous avons utilisé le mode @code{\relative} pour définir les
1538 hauteurs de notes.  Si c'est souvent le moyen le plus simple de saisir
1539 la musique au clavier, il existe une autre façon de procéder : le mode
1540 de hauteurs absolues.
1541
1542 Si vous omettez la commande @code{\relative}, LilyPond considérera
1543 toutes les hauteurs comme des hauteurs absolues.  Un @code{c'} désigne
1544 toujours le do central, un @code{b} se situe une seconde en dessous
1545 du do central, et un @code{g,} est situé sur la première ligne de
1546 la portée en clé de fa.
1547
1548 @lilypond[verbatim,quote]
1549 {
1550   \clef "bass"
1551   c'4 b g, g, |
1552   g,4 f, f c' |
1553 }
1554 @end lilypond
1555
1556 Voici une gamme sur quatre octaves :
1557
1558 Il faut beaucoup d'apostrophes pour écrire de la musique dans un
1559 registre aigu, comme le montre cet extrait de Mozart.
1560
1561 @lilypond[verbatim,quote]
1562 {
1563   \key a \major
1564   \time 6/8
1565   cis''8. d''16 cis''8 e''4 e''8 |
1566   b'8. cis''16 b'8 d''4 d''8 |
1567 }
1568 @end lilypond
1569
1570 @funindex \fixed
1571
1572 Les indications doctaves communes peuvent ne s'indiquer qu'une seule
1573 fois, en faisant suivre la commande @code{\fixed} d'une hauteur de
1574 référence :
1575
1576 @lilypond[verbatim,quote]
1577 \fixed c'' {
1578   \key a \major
1579   \time 6/8
1580   cis8. d16 cis8 e4 e8 |
1581   b,8. cis16 b,8 d4 d8 |
1582 }
1583 @end lilypond
1584
1585 Avec un @code{\relative}, le même exemple ne recquiert pas d'indicatin
1586 d'octave puisque la mélodie progresse sur des intervalles ne dépassant
1587 pas la tierce.
1588
1589 @lilypond[verbatim,quote]
1590 \relative {
1591   \key a \major
1592   \time 6/8
1593   cis''8. d16 cis8 e4 e8 |
1594   b8. cis16 b8 d4 d8 |
1595 }
1596 @end lilypond
1597
1598 Si d'aventure vous faites une erreur d'octaviation, le mode
1599 @code{\relative} la mettra en évidence : toutes les notes suivantes
1600 seront placées à la mauvaise octave.  En mode de hauteurs absolues,
1601 une erreur isolée ne serait pas autant visible, et serait donc plus
1602 difficile à dénicher.
1603
1604 Cependant, le mode de hauteurs absolues reste utile pour les musiques
1605 où les intervalles sont étendus, et plus encore pour les fichiers
1606 LilyPond créés par des programmes.  Recopier des fragments en hauteurs
1607 absolues permet d'en préserver les octaves.
1608
1609 La musiqeu peut être agencée de manière plutôt complexe.  Dans le cas
1610 d'une imbrication de commandes @code{\relative}, chacune des sections
1611 est indépendante de l'autre :
1612
1613 @lilypond[verbatim,quote]
1614 \relative { c'4 \relative { f'' g } c }
1615 @end lilypond
1616
1617 @funindex \absolute
1618
1619 Des hauteurs absolues peuvent tout à fait se trouver au sein d'un bloc
1620 en mode relatif, dès lors qu'une instruction @code{\fixed c} exclut
1621 explicitement de la musique relative le fragment en question :
1622
1623 @lilypond[verbatim,quote]
1624 \relative {
1625   c'4 \fixed c { f'' g'' } c |
1626   c4 \fixed c'' { f g } c
1627 }
1628 @end lilypond
1629
1630
1631 @node Après le tutoriel
1632 @subsection Après le tutoriel
1633 @translationof After the tutorial
1634
1635 Après avoir parcouru ce tutoriel, vous devriez essayer d'écrire un
1636 morceau ou deux.  Commencez par copier l'un des modèles types et
1637 ajoutez-y des notes -- consultez les @ref{Modèles}.  Si vous voulez
1638 employer une notation que vous n'avez pas trouvé dans le tutoriel,
1639 consultez le manuel de notation, en commençant par la
1640 @ruser{Notation musicale générale}.  Si vous désirez écrire pour un
1641 ensemble instrumental non couvert par les modèles, lisez la section
1642 @ref{Extension des modèles}.
1643
1644 Après avoir écrit quelques pièces courtes, lisez les chapitres 3 à 5
1645 du manuel d'initiation.  Rien ne s'oppose à ce que vous consultiez dès
1646 à présent ces chapitres, bien sûr ! Néanmoins, le reste du manuel
1647 d'initiation part du principe que vous avez déjà bien assimilé la
1648 syntaxe de base de LilyPond.  Vous pouvez toujours survoler ces
1649 chapitres 3 à 5, et y revenir plus tard après avoir acquis de
1650 l'expérience.
1651
1652 Dans ce tutoriel comme dans le reste de ce manuel, se trouve à chaque
1653 section un paragraphe @strong{Voir aussi} contenant des références
1654 vers d'autres sections : il est conseillé de ne pas les suivre en
1655 première lecture ; lorsque vous aurez lu l'ensemble du manuel
1656 d'initiation, vous pourrez en relisant certaines sections suivre ces
1657 références pour approfondir certains aspects.
1658
1659 Si vous ne l'avez pas encore fait, lisez
1660 @ref{Vue d'ensemble des manuels}.  Les sources de documentation et
1661 d'information sur LilyPond sont vastes, il est normal pour un débutant
1662 de ne pas savoir où chercher ; si vous passez quelques minutes à
1663 lire attentivement cette section, vous vous épargnerez certainement la
1664 frustration causée par des heures de recherches infructueuses.