]> git.donarmstrong.com Git - lilypond.git/blob - Documentation/fr/learning/common-notation.itely
s/appogiatura/appoggiatura/.
[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: 88a5dbc589b0d0434f8e640467b5ab57d14dc461
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: J.-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.
389
390 @lilypond[verbatim,quote]
391 \relative { g'4\( g8( a) b( c) b4\) }
392 @end lilypond
393
394 @c @ smallspace
395
396
397 @node Attention aux types de liaison
398 @unnumberedsubsubsec Attention aux types de liaison
399 @translationof Warnings slurs vs. ties
400
401
402 @cindex liaisons d'articulation et de prolongation, différences
403
404 Glossaire musicologique :
405 @rglos{articulation}, @rglosnamed{slur,liaison},
406 @rglosnamed{tie,liaison de tenue}.
407
408 Une liaison d'articulation ou de phrasé ressemble à une liaison de
409 prolongation, mais n'a pas la même signification.  Alors qu'une
410 liaison de prolongation ne peut relier que deux notes de même hauteur,
411 le @emph{legato} indique une articulation de plusieurs notes,
412 éventuellement en grand nombre.  Les liaisons de tenue peuvent être
413 enchâssées dans un @emph{legato} ou un phrasé.
414
415 @lilypond[verbatim,quote]
416 \relative { c''4(~ c8 d~ 4 e) }
417 @end lilypond
418
419 @seealso
420 Manuel de notation :
421 @ruser{Liaisons de prolongation},
422 @ruser{Liaisons d'articulation},
423 @ruser{Liaisons de phrasé}.
424
425
426 @node Articulations et nuances
427 @subsection Articulations et nuances
428 @translationof Articulation and dynamics
429
430 @menu
431 * Articulation::
432 * Doigté::
433 * Nuance::
434 @end menu
435
436
437 @node Articulation
438 @unnumberedsubsubsec Articulation
439 @translationof Articulations
440
441 @cindex articulation
442 @cindex accents
443 @cindex staccato
444
445 Glossaire musicologique :
446 @rglos{articulation}.
447
448 Des @notation{articulations} peuvent être ajoutées à une note, au moyen
449 d'un tiret @code{-} suivi d'un caractère :
450
451 @lilypond[verbatim,quote]
452 \relative {
453   c''4-^ c-+ c-- c-!
454   c4-> c-. c2-_
455 }
456 @end lilypond
457
458
459 @node Doigté
460 @unnumberedsubsubsec Doigté
461 @translationof Fingerings
462
463 @cindex doigtés
464
465 @funindex ^
466 @funindex _
467
468 Glossaire musicologique :
469 @rglosnamed{fingering,doigté}.
470
471 De même, des indications de doigté peuvent être ajoutées à une note en
472 utilisant un tiret (@samp{-}) et le chiffre à écrire :
473
474 @lilypond[verbatim,quote]
475 \relative { c''4-3 e-5 b-2 a-1 }
476 @end lilypond
477
478 Articulations et doigtés sont habituellement placés automatiquement,
479 mais vous pouvez spécifier leur positionnement en utilisant @code{^} (en
480 haut) ou @code{_} (en bas).  Vous pouvez aussi utiliser plusieurs
481 articulations sur la même note.  Dans la plupart des cas, cependant,
482 il est bon de laisser LilyPond déterminer l'emplacement de
483 l'articulation.
484
485 @lilypond[verbatim,quote]
486 \relative { c''4_-^1 d^. f^4_2-> e^-_+ }
487 @end lilypond
488
489
490 @node Nuance
491 @unnumberedsubsubsec Nuance
492 @translationof Dynamics
493
494 @cindex nuances
495 @cindex decrescendo
496 @cindex crescendo
497
498 @funindex \f
499 @funindex \ff
500 @funindex \mp
501 @funindex \p
502 @funindex \mf
503 @funindex \pp
504 @funindex \<
505 @funindex <
506 @funindex \>
507 @funindex >
508 @funindex \!
509 @funindex !
510
511 Glossaire musicologique :
512 @rglosnamed{dynamics,nuances},
513 @rglos{crescendo},
514 @rglos{decrescendo}.
515
516 On obtient un signe de @notation{nuance} en ajoutant à la note les
517 lettres du signe, précédées d'un anti-slash @code{\} :
518
519 @lilypond[verbatim,quote]
520 \relative { c''4\ff c\mf c\p c\pp }
521 @end lilypond
522
523 @cindex nuances
524 @cindex decrescendo
525 @cindex crescendo
526
527 @c Pluriel des termes musicaux italiens :
528 @c selon Littré, plutôt à la française (en "-os" qu'en "-i")
529
530 @notation{Crescendos} et @notation{decrescendos} débutent avec les
531 commandes @code{\<} et @code{\>}.  Ils se terminent soit par une
532 nuance d'arrivée, par exemple @code{\f}, soit par la commande
533 @code{\!} :
534
535 @lilypond[verbatim,quote]
536 \relative { c''4\< c\ff\> c c\! }
537 @end lilypond
538
539 @seealso
540 Manuel de notation :
541 @ruser{Articulations et ornements},
542 @ruser{Doigtés},
543 @ruser{Nuances}.
544
545
546 @node Ajout de texte
547 @subsection Ajout de texte
548 @translationof Adding text
549
550 @cindex texte, ajout de
551 @cindex ajout de texte
552 @cindex étiquette
553
554 @funindex \markup
555 @funindex markup
556
557 On peut ajouter du texte à une partition :
558
559 @lilypond[verbatim,quote,fragment]
560 c''2^"espr" a'_"legato"
561 @end lilypond
562
563 Pour mettre en forme du texte, on utilise la commande @code{\markup} :
564
565 @lilypond[verbatim,quote,fragment]
566 c''2^\markup { \bold espr }
567 a'2_\markup {
568   \dynamic f \italic \small { 2nd } \hspace #0.1 \dynamic p
569 }
570 @end lilypond
571
572 @seealso
573 Manuel de notation :
574 @ruser{Ajout de texte}.
575
576
577 @node Barres de ligature automatiques et manuelles
578 @subsection Barres de ligature automatiques et manuelles
579 @translationof Automatic and manual beams
580
581 @cindex ligature
582 @cindex barre de ligature
583 @cindex ligatures automatiques
584 @cindex ligatures manuelles
585 @cindex ligatures explicites
586
587 @funindex [ ... ]
588 @funindex [
589 @funindex ]
590 @funindex \autoBeamOff
591 @funindex autoBeamOff
592 @funindex \autoBeamOn
593 @funindex autoBeamOn
594
595 Glossaire musicologique :
596 @rglosnamed{beam,ligature}.
597
598 Toutes les barres de ligature sont dessinées automatiquement :
599
600 @lilypond[verbatim,quote]
601 \relative { a'8 ais d ees r d c16 b a8 }
602 @end lilypond
603
604 @noindent
605 Lorsqu'on n'aime pas la manière dont les notes sont automatiquement
606 groupées, il est possible de les ligaturer manuellement, en marquant la
607 première note à attacher d'un crochet ouvrant @code{[} et la dernière
608 d'un crochet fermant @code{]}.
609
610 @lilypond[verbatim,quote]
611 \relative { a'8[ ais] d[ ees r d] c16 b a8 }
612 @end lilypond
613
614 Pour désactiver les barres de ligature automatiques pour des passages
615 entiers, utilisez la commande @code{\autoBeamOff}, et utilisez
616 @code{\autoBeamOn} pour les réactiver.
617
618 @lilypond[verbatim,quote]
619 \relative {
620   \autoBeamOff
621   a'8 c b4 d8. c16 b4 |
622   \autoBeamOn
623   a8 c b4 d8. c16 b4 |
624 }
625 @end lilypond
626
627 @seealso
628 Manuel de notation :
629 @ruser{Barres de ligature automatiques},
630 @ruser{Barres de ligature manuelles}.
631
632
633 @node Commandes rythmiques avancées
634 @subsection Commandes rythmiques avancées
635 @translationof Advanced rhythmic commands
636
637 @menu
638 * Mesure incomplète::
639 * N-olet::
640 * Note d'ornement::
641 @end menu
642
643
644 @node Mesure incomplète
645 @unnumberedsubsubsec Mesure incomplète
646 @translationof Partial measure
647
648 @cindex levée
649 @cindex anacrouse
650 @cindex mesure incomplète
651
652 @funindex \partial
653 @funindex partial
654
655 Glossaire musicologique : @rglosnamed{anacrusis,anacrouse}.
656
657 On crée une levée (ou anacrouse) avec la commande @code{\partial},
658 suivie d'une durée : @code{\partial 4} produit une levée d'une
659 noire et @code{\partial 8} d'une croche.
660
661 @lilypond[verbatim,quote]
662 \relative {
663   \partial 8 f''8 |
664   c2 d |
665 }
666 @end lilypond
667
668
669 @node N-olet
670 @unnumberedsubsubsec N-olet
671 @translationof Tuplets
672
673 @cindex n-olets
674 @cindex triolets
675
676 @funindex \tuplet
677 @funindex tuplet
678
679 Glossaire musicologique : @rglosnamed{note value,valeur d'une note},
680 @rglosnamed{triplet,triolet}.
681
682 Les @notation{n-olets} sont créés avec la commande @code{\tuplet}, qui
683 prend deux arguments : une fraction et une expression musicale. La
684 fraction représente le nombre de notes du n-olet à inscrire dans la durée
685 normalement attribuée à un certain nombre de notes de même valeur. Dans
686 le cas de triolets, par exemple, trois notes recouvrent la même durée
687 que deux ; un @notation{triolet} portera donc une fraction de 3/2.
688
689 @lilypond[verbatim,quote]
690 \relative {
691   \tuplet 3/2 { f''8 g a }
692   \tuplet 3/2 { c8 r c }
693   \tuplet 3/2 { f,8 g16[ a g a] }
694   \tuplet 3/2 { d4 a8 }
695 }
696 @end lilypond
697
698
699 @node Note d'ornement
700 @unnumberedsubsubsec Note d'ornement
701 @translationof Grace notes
702
703 @cindex notes d'ornement
704 @cindex ornementation
705 @cindex appoggiature
706 @cindex acciaccature
707
708 @funindex \grace
709 @funindex grace
710 @funindex \acciaccatura
711 @funindex acciaccatura
712 @funindex \appoggiatura
713 @funindex acciaccatura
714
715 Glossaire musicologique :
716 @rglosnamed{grace notes,ornements},
717 @rglosnamed{acciaccatura,acciaccature},
718 @rglosnamed{appoggiatura,appoggiature}.
719
720 Des @notation{notes d'ornement} s'obtiennent en appliquant la commande
721 @code{\grace}, @code{\appoggiatura} ou @code{\acciaccatura} à une
722 expression musicale :
723
724 @lilypond[verbatim,quote]
725 \relative {
726   c''2 \grace { a32 b } c2 |
727   c2 \appoggiatura b16 c2 |
728   c2 \acciaccatura b16 c2 |
729 }
730 @end lilypond
731
732 @seealso
733 Manuel de notation :
734 @ruser{Notes d'ornement},
735 @ruser{N-olets},
736 @ruser{Levées}.
737
738
739 @node Notes simultanées
740 @section Notes simultanées
741 @translationof Multiple notes at once
742
743 Cette section traite de situations où l'on a plus d'une note à la
744 fois : plusieurs instruments, plusieurs voix ou portées pour un
745 même instrument (le piano, par exemple), et les accords.
746
747 En théorie musicale, la polyphonie désigne une musique constituée de
748 plusieurs voix ; dans LilyPond, ce terme désigne les situations où
749 il y a plus d'une voix sur une même portée.
750
751 @menu
752 * Les expressions musicales en clair::
753 * Plusieurs portées::
754 * Regroupements de portées::
755 * Combinaison de notes en accords::
756 * Polyphonie sur une portée::
757 @end menu
758
759
760 @node Les expressions musicales en clair
761 @subsection Les expressions musicales en clair
762 @translationof Music expressions explained
763
764 @cindex expression musicale
765
766 @menu
767 * Analogie avec les expressions mathématiques::
768 * Expressions musicales simultanées -- plusieurs portées::
769 * Expressions musicales simultanées -- une seule portée::
770 @end menu
771
772 Dans les fichiers source LilyPond, la musique est représentée par ce
773 qu'on appelle des @emph{expressions musicales}.  En soi, une seule note
774 peut constituer une expression musicale :
775
776 @lilypond[verbatim,quote,fragment]
777 a'4
778 @end lilypond
779
780 Mettre un groupe de notes entre accolades crée une nouvelle expression
781 musicale, appelée @emph{expression musicale composée}.  En voici un
782 exemple avec deux notes :
783
784 @lilypond[verbatim,quote]
785 \relative { a'4 g4 }
786 @end lilypond
787
788 La mise entre accolades d'une séquence d'expressions musicales -- des
789 notes par exemple -- signifie qu'elles doivent être jouées
790 successivement, les unes après les autres.  Le résultat est une
791 expression, qui peut elle-même être regroupée séquentiellement avec
792 d'autres expressions.  Ici, l'expression de l'exemple précédent est
793 combinée à deux notes :
794
795 @lilypond[verbatim,quote]
796 \relative { { a'4 g } f g }
797 @end lilypond
798
799
800 @node Analogie avec les expressions mathématiques
801 @unnumberedsubsubsec Analogie avec les expressions mathématiques
802 @translationof Analogy mathematical expressions
803
804 @cindex expression
805
806 Ce mécanisme est similaire aux formules mathématiques : une grosse
807 formule est créée en assemblant plusieurs petites formules.  De telles
808 formules sont appelées expressions, elles ont une définition
809 récursive, de telle sorte que vous pouvez fabriquer des expressions
810 arbitrairement longues et complexes.  Par exemple :
811
812 @example
813 1
814
815 1 + 2
816
817 (1 + 2) * 3
818
819 ((1 + 2) * 3) / (4 * 5)
820 @end example
821
822 Ceci est une suite d'expressions, où chacune est contenue dans la
823 suivante.  Les expressions les plus simples sont les nombres, et de
824 plus grandes expressions sont produites en combinant des expressions
825 avec des opérateurs -- comme @code{+}, @code{*} et @code{/} -- et
826 des parenthèses.  Tout comme les expressions mathématiques, les
827 expressions musicales peuvent être imbriquées avec une profondeur
828 arbitraire, ce qui est nécessaire pour des partitions complexes comme
829 de la musique polyphonique.
830
831
832 @node Expressions musicales simultanées -- plusieurs portées
833 @unnumberedsubsubsec Expressions musicales simultanées -- plusieurs portées
834 @translationof Simultaneous music expressions multiple staves
835
836 @cindex portées multiples
837 @cindex polyphonie
838 @cindex combinaison d'expressions en parallèle
839 @cindex parallèles, expressions
840 @cindex expressions parallèles
841 @cindex hauteur relative et musique simultanée
842 @cindex musique simultanée et hauteur relative
843 @cindex hauteur relative et expressions parallèles
844 @cindex expressions parallèles et hauteur relative
845
846 @funindex <<
847 @funindex >>
848 @funindex << ... >>
849
850 Glossaire musicologique : @rglosnamed{polyphony,polyphonie}.
851
852 Cette technique est utile pour de la musique @notation{polyphonique}.
853 Pour entrer une musique avec plusieurs voix ou plusieurs portées, nous
854 pouvons aussi combiner @emph{en parallèle} les expressions : deux
855 voix qui doivent être jouées en même temps, sont entrées comme une
856 combinaison simultanée de deux expressions.  Une expression musicale
857 @qq{simultanée} est formée en entourant les expressions entre @code{<<}
858 et @code{>>}.  Dans l'exemple suivant, trois expressions (contenant
859 chacune deux notes distinctes) sont combinées simultanément.
860
861 @lilypond[verbatim,quote]
862 <<
863   \relative { a'2 g }
864   \relative { f'2 e }
865   \relative { d'2 b }
866 >>
867 @end lilypond
868
869 Notez que nous avons ici indenté chaque niveau du fichier d'entrée
870 avec un nombre d'espaces différent.  LilyPond se moque -- ou presque
871 -- de l'espace qu'il peut y avoir ou non au début d'une ligne, mais
872 un code bien indenté est bien plus lisible par des humains.
873
874 @warning{La hauteur de chaque note saisie est relative à la précédente ;
875 seule la première première note verra sa hauteur déterminée relativement
876 au au @code{c''} de la commande @code{@bs{}relative} de départ.}
877
878
879 @node Expressions musicales simultanées -- une seule portée
880 @unnumberedsubsubsec Expressions musicales simultanées -- une seule portée
881 @translationof Simultaneous music expressions single staff
882
883 Pour déterminer le nombre de portées, LilyPond regarde le début de la
884 première expression.  Si c'est une seule note, une seule portée est
885 produite ; si c'est une expression simultanée, plusieurs portées sont
886 produites.  Nous avons dans l'exemple ci-dessous une expression
887 complexe ; dans la mesure où elle débute par une note seule, elle sera
888 produite sur une unique portée.
889
890 @lilypond[verbatim,quote]
891 \relative {
892   c''2 <<c e>> |
893   << { e2 f } { c <<b d>> } >> |
894 }
895 @end lilypond
896
897
898 @node Plusieurs portées
899 @subsection Plusieurs portées
900 @translationof Multiple staves
901
902 @cindex multiples portées
903 @cindex portées multiples
904 @cindex contexte
905 @cindex contexte de notation
906 @cindex notation, contexte
907
908 @funindex \new Staff
909 @funindex new Staff
910 @funindex Staff
911 @funindex \new
912 @funindex new
913 @funindex Score
914 @funindex Voice
915 @funindex Lyrics
916 @funindex ChordNames
917
918 Comme nous l'avons vu dans @ref{Les expressions musicales en clair}, un
919 fichier d'entrée LilyPond est fait d'expressions musicales.  Si la
920 partition commence par plusieurs expressions simultanées, LilyPond
921 créera plusieurs portées.  Cependant, il est plus facile de prévoir le
922 nombre de portées si on les crée explicitement, ce que nous allons
923 voir.
924
925 Pour créer plus d'une portée, on ajoute @code{\new Staff} au début de
926 chaque partie de la musique constituant une portée.  Ces éléments
927 @code{Staff} sont ensuite combinés en parallèle avec @code{<<} et
928 @code{>>}, comme ci-dessous.
929
930 @lilypond[verbatim,quote]
931 <<
932   \new Staff { \clef "treble" c''4 }
933   \new Staff { \clef "bass" c4 }
934 >>
935 @end lilypond
936
937 La commande @code{\new} introduit un @qq{contexte de notation}.  Un
938 contexte de notation est un environnement dans lequel les événements
939 musicaux -- comme les notes ou les commandes @code{\clef} -- sont
940 interprétés.  Pour des pièces simples, ces contextes sont créés
941 automatiquement.  Pour des pièces plus complexes, il est préférable de
942 spécifier explicitement les contextes, afin de s'assurer que chaque
943 fragment aura sa propre portée.
944
945 Il existe différents types de contextes.  Les contextes @code{Score}
946 (partition), @code{Staff} (portée) et @code{Voice} (voix) gèrent la
947 notation de la mélodie, alors que @code{Lyrics} gère les paroles et
948 @code{ChordNames} imprime des noms d'accord.
949
950 En terme de syntaxe, ajouter @code{\new} devant une expression
951 musicale crée une plus grande expression musicale.  En reprenant la
952 comparaison précédente, cela ressemble au signe @emph{moins} en
953 mathématiques.  La formule @math{(4+5)} est une expression, donc
954 @math{-(4+5)} constitue une plus grande expression.
955
956 Les chiffres de métrique indiqués sur une portée affectent toutes les
957 autres portées.  En revanche l'armure d'une portée n'affecte @emph{pas}
958 les autres portées.  Ces caractéristiques par défaut se justifient par
959 le fait que l'utilisation d'instruments transpositeurs est bien plus
960 fréquente que la musique polyrythmique.
961
962 @lilypond[verbatim,quote]
963 <<
964   \new Staff { \clef "treble" \key d \major \time 3/4 c''4 }
965   \new Staff { \clef "bass" c4 }
966 >>
967 @end lilypond
968
969
970 @node Regroupements de portées
971 @subsection Regroupements de portées
972 @translationof Staff groups
973
974 @cindex portée double
975 @cindex portée pour piano
976 @cindex piano, portée pour
977 @cindex clavier, portée pour
978 @cindex chœur, système pour
979 @cindex système pour chœur
980 @cindex système
981 @cindex portées, regroupement de
982 @cindex regroupement de portées
983
984 @funindex PianoStaff
985 @funindex GrandStaff
986 @funindex ChoirStaff
987
988 Glossaire musicologique :
989 @rglosnamed{brace,accolade},
990 @rglosnamed{staff,portée},
991 @rglosnamed{system,système}.
992
993 La musique pour piano s'écrit sur deux portées reliées par une
994 @notation{accolade}.  La gravure de ce type de portée est semblable à
995 l'exemple de musique polyphonique de @ref{Plusieurs portées}, mais
996 maintenant cette expression entière est interprétée dans un contexte
997 @code{PianoStaff} :
998
999 @example
1000 \new PianoStaff <<
1001   \new Staff @dots{}
1002   \new Staff @dots{}
1003 >>
1004 @end example
1005
1006 Voici un bref exemple :
1007
1008 @lilypond[verbatim,quote]
1009 \new PianoStaff <<
1010   \new Staff \relative { \time 2/4 c''4 e | g g, | }
1011   \new Staff \relative { \clef "bass" c4 c' | e c | }
1012 >>
1013 @end lilypond
1014
1015 Vous pouvez générer d'autres formes de regroupement, avec
1016 @code{\new GrandStaff} pour une partition d'orchestre, ou
1017 @code{\new ChoirStaff} qui sied particulièrement aux partitions
1018 chorales.  Chacun de ces regroupements constitue un contexte à part
1019 entière, avec ses particularités, tant au niveau du signe qui regroupe
1020 les portées au sein d'un @notation{système} qu'au niveau de l'étendue
1021 des barres de mesure.
1022
1023 @seealso
1024 Manuel de notation :
1025 @ruser{Instruments utilisant des portées multiples},
1026 @ruser{Gravure des portées}.
1027
1028
1029 @node Combinaison de notes en accords
1030 @subsection Combinaison de notes en accords
1031 @translationof Combining notes into chords
1032
1033 @cindex accords, notes simultanées
1034 @cindex accords et durée
1035
1036 @funindex <
1037 @funindex >
1038 @funindex < ... >
1039
1040 Glossaire musicologique : @rglosnamed{chord,accord}.
1041
1042 Nous avons vu précédemment comment combiner des notes simultanément,
1043 en les encadrant par des chevrons doubles @code{<<} et @code{>>}.  Pour
1044 produire des accords simples, c'est-à-dire une superposition de notes
1045 de même durée, on encadre les hauteurs de notes par des chevrons simples
1046 @code{<} et @code{>}, et on écrit la durée juste après.
1047
1048 @lilypond[verbatim,quote]
1049 \relative { r4 <c'' e g> <c f a>2 }
1050 @end lilypond
1051
1052 Beaucoup d'éléments de notation que l'on peut attacher à une note
1053 simple, comme une liaison, un crochet indiquant un début ou une fin de
1054 lien, un signe d'articulation, peuvent être également attachés à un
1055 accord : il faut ajouter ces indications après les hauteurs et la
1056 durée, donc @emph{à l'extérieur} des chevrons.
1057
1058 @lilypond[verbatim,quote]
1059 \relative {
1060   r4 <c'' e g>~ <c f a>2 |
1061   <c e g>8[ <c f a> <c e g> <c f a>]
1062     <c e g>8\>[ <c f a> <c f a> <c e g>]\! |
1063   r4 <c e g>8.\p <c f a>16( <c e g>4-. <c f a>) |
1064 }
1065 @end lilypond
1066
1067 @seealso
1068 Manuel de notation :
1069 @ruser{Notes en accords}.
1070
1071
1072 @node Polyphonie sur une portée
1073 @subsection Polyphonie sur une portée
1074 @translationof Single staff polyphony
1075
1076 @cindex polyphonie
1077 @cindex voix multiples sur une portée
1078 @cindex multiples voix sur une portée
1079 @cindex silence invisible
1080 @cindex invisible, silence
1081
1082 @funindex << ... \\ ... >>
1083 @funindex <<
1084 @funindex \\
1085 @funindex >>
1086
1087 Bien que LilyPond gère la musique polyphonique sans difficulté, cela
1088 fait appel à des concepts que nous n'avons pas encore abordés.  C'est la
1089 raison pour laquelle nous ne nous étendrons pas tout de suite sur ce
1090 sujet et préférons vous inciter à consulter les chapitres dédiés à
1091 l'étude de ces concepts.
1092
1093 @seealso
1094 Manuel d'initiation :
1095 @ref{Les voix contiennent la musique}.
1096
1097 Manuel de notation :
1098 @ruser{Notes simultanées}.
1099
1100
1101 @node Chansons
1102 @section Chansons
1103 @translationof Songs
1104
1105 Cette section présente l'écriture vocale et les partitions de variété.
1106
1107 @menu
1108 * Écriture de chants simples::
1109 * Alignement des paroles sur une mélodie::
1110 * Paroles pour plusieurs portées::
1111 @end menu
1112
1113
1114 @node Écriture de chants simples
1115 @subsection Écriture de chants simples
1116 @translationof Setting simple songs
1117
1118 @cindex paroles
1119 @cindex chansons
1120
1121 @funindex \addlyrics
1122 @funindex addlyrics
1123
1124 Glossaire musicologique : @rglos{lyrics}.
1125
1126 Prenons une mélodie toute simple, la comptine @emph{Girls and boys
1127 come out to play}.
1128
1129 @lilypond[verbatim,quote]
1130 \relative {
1131   \key g \major
1132   \time 6/8
1133   d''4 b8 c4 a8 | d4 b8 g4
1134 }
1135 @end lilypond
1136
1137 Des @notation{paroles} peuvent être associées à ces notes, en les
1138 combinant avec la commande @code{\addlyrics}.  On entre les paroles en
1139 séparant chaque syllable par une espace :
1140
1141 @lilypond[verbatim,quote]
1142 <<
1143   \relative {
1144     \key g \major
1145     \time 6/8
1146     d''4 b8 c4 a8 | d4 b8 g4
1147   }
1148   \addlyrics {
1149     Girls and boys come out to play,
1150   }
1151 >>
1152 @end lilypond
1153
1154 Notez les doubles chevrons @code{<< @dots{} >>} encadrant toute la
1155 pièce ; ils indiquent simplement que la musique et les paroles se
1156 produisent en même temps.
1157
1158
1159 @node Alignement des paroles sur une mélodie
1160 @subsection Alignement des paroles sur une mélodie
1161 @translationof Aligning lyrics to a melody
1162
1163 @cindex mélisme
1164 @cindex ligne d'extension
1165 @cindex trait d'union (paroles)
1166 @cindex caractère souligné (paroles)
1167 @cindex paroles, alignement des
1168 @cindex alignement des paroles
1169 @cindex paroles, mot de plusieurs syllabes
1170
1171 Glossaire musicologique : @rglosnamed{melisma,mélisme},
1172 @rglosnamed{extender line,ligne d'extension}.
1173
1174 La deuxième ligne de la comptine précédente est @emph{The moon doth
1175 shine as bright as day}.  Ajoutons-la au code.
1176
1177 @lilypond[verbatim,quote]
1178 <<
1179   \relative {
1180     \key g \major
1181     \time 6/8
1182     d''4 b8 c4 a8 | d4 b8 g4 g8 |
1183     a4 b8 c b a | d4 b8 g4. |
1184   }
1185   \addlyrics {
1186     Girls and boys come out to play,
1187     The moon doth shine as bright as day;
1188   }
1189 >>
1190 @end lilypond
1191
1192 Remarquez comme les paroles ajoutées ne s'alignent pas bien avec les
1193 notes.  Le mot @emph{shine} devrait être chanté sur deux notes au lieu
1194 d'une.  On appelle ceci un @notation{mélisme} : il s'agit d'une seule
1195 syllabe chantée sur plus d'une note.  Il existe plusieurs façons
1196 d'étaler une syllabe sur plusieurs notes, la plus simple étant de lier
1197 les notes du mélisme.  Pour les détails, consultez @ref{Liaisons}.
1198
1199 @lilypond[verbatim,quote]
1200 <<
1201   \relative {
1202     \key g \major
1203     \time 6/8
1204     d''4 b8 c4 a8 | d4 b8 g4 g8 |
1205     a4 b8 c( b) a | d4 b8 g4. |
1206   }
1207   \addlyrics {
1208     Girls and boys come out to play,
1209     The moon doth shine as bright as day;
1210   }
1211 >>
1212 @end lilypond
1213
1214 Les paroles sont maintenant correctement alignées, mais les liens de
1215 croche automatiques ne conviennent pas pour les notes au-dessus de
1216 @emph{shine as}.  On peut les corriger en ajoutant des liens de croche
1217 manuels ; pour ceci consultez
1218 @ref{Barres de ligature automatiques et manuelles}.
1219
1220 @lilypond[verbatim,quote]
1221 <<
1222   \relative {
1223     \key g \major
1224     \time 6/8
1225     d''4 b8 c4 a8 | d4 b8 g4 g8 |
1226     a4 b8 c([ b]) a | d4 b8 g4. |
1227   }
1228   \addlyrics {
1229     Girls and boys come out to play,
1230     The moon doth shine as bright as day;
1231   }
1232 >>
1233 @end lilypond
1234
1235 Au lieu d'utiliser une liaison, on peut indiquer le mélisme dans les
1236 paroles en insérant un caractère souligné @code{_} pour chaque note du
1237 mélisme sauf la première.
1238
1239 @lilypond[verbatim,quote]
1240 <<
1241   \relative {
1242     \key g \major
1243     \time 6/8
1244     d''4 b8 c4 a8 | d4 b8 g4 g8 |
1245     a4 b8 c[ b] a | d4 b8 g4. |
1246   }
1247   \addlyrics {
1248     Girls and boys come out to play,
1249     The moon doth shine _ as bright as day;
1250   }
1251 >>
1252 @end lilypond
1253
1254 Si une syllabe s'étend sur un grand nombre de notes ou une note très
1255 longue, on représente souvent le mélisme par un @notation{trait de
1256 prolongation}, qu'on entre avec double caractère souligné @code{__}.
1257 L'exemple suivant montre les trois premières mesures de la plainte de
1258 Didon, extraite de @notation{Didon et Énée} de Purcell.
1259
1260 @lilypond[verbatim,quote]
1261 <<
1262   \relative {
1263     \key g \minor
1264     \time 3/2
1265    g'2 a bes | bes2( a) b2 |
1266     c4.( bes8 a4. g8 fis4.) g8 | fis1
1267   }
1268   \addlyrics {
1269     When I am laid,
1270     am laid __ in earth,
1271   }
1272 >>
1273 @end lilypond
1274
1275 Aucun exemple jusqu'à présent n'a utilisé de mots de plus d'une
1276 syllabe.  Dans des paroles, de tels mots sont écrits en syllabes
1277 séparées par des traits d'union.  Avec LilyPond, on utilise deux
1278 tirets pour produire un trait d'union centré entre deux syllabes.
1279 L'exemple suivant montre tout ce que nous avons vu jusqu'à maintenant
1280 sur l'alignement de paroles à une mélodie.
1281
1282 @c no ragged-right here because otherwise the hyphens get lost,
1283 @c but the example is long enough to avoid looking strange.
1284 @lilypond[verbatim,quote,noragged-right]
1285 <<
1286   \relative {
1287     \key g \major
1288     \time 3/4
1289     \partial 4
1290     d'4 | g4 g a8( b) | g4 g b8( c) |
1291     d4 d e | c2
1292   }
1293   \addlyrics {
1294     A -- way in a __ man -- ger,
1295     no __ crib for a bed, __
1296   }
1297 >>
1298 @end lilypond
1299
1300 Avec certaines paroles, en particulier en italien, il se produit la
1301 situation inverse : il peut y avoir plusieurs syllabes sur une seule
1302 note.  On réalise ceci avec LilyPond grâce à un caractère souligné
1303 @code{_} sans espace entre les syllabes, ou alors en groupant les
1304 syllabes avec des guillemets.  L'exemple suivant est extrait de l'air de
1305 Figaro @emph{Largo al factotum}, dans @notation{Figaro} de Rossini, où
1306 la syllabe @emph{al} est chantée sur la même note que @emph{go}.
1307
1308 @c no ragged-right here because otherwise the hyphens get lost,
1309 @c but the example is long enough to avoid looking strange.
1310 @lilypond[verbatim,quote,noragged-right]
1311 <<
1312   \relative {
1313     \clef bass
1314     \key c \major
1315     \time 6/8
1316     c'4.~ 8 d b | c8([ d]) b c d b | c8
1317   }
1318   \addlyrics {
1319     Lar -- go_al fac -- to -- tum del -- la cit -- tà
1320   }
1321 >>
1322 @end lilypond
1323
1324 @seealso
1325 Manuel de notation :
1326 @ruser{Musique vocale}.
1327
1328
1329 @node Paroles pour plusieurs portées
1330 @subsection Paroles pour plusieurs portées
1331 @translationof Lyrics to multiple staves
1332
1333 @cindex paroles et portées multiples
1334 @cindex portées multiples et paroles
1335
1336 La méthode simple d'ajout de paroles avec @code{\addlyrics} peut être
1337 également utilisée pour placer des paroles sous plusieurs portées.
1338 L'exemple suivant est extrait de @emph{Judas Macchabée} de Händel.
1339
1340 @lilypond[verbatim,quote]
1341 <<
1342   \relative {
1343     \key f \major
1344     \time 6/8
1345     \partial 8
1346     c''8 | c8([ bes]) a a([ g]) f | f'4. b, | c4.~ 4
1347   }
1348   \addlyrics {
1349     Let flee -- cy flocks the hills a -- dorn, __
1350   }
1351   \relative {
1352     \key f \major
1353     \time 6/8
1354     \partial 8
1355     r8 | r4. r4 c'8 | a'8([ g]) f f([ e]) d | e8([ d]) c bes'4
1356   }
1357   \addlyrics {
1358     Let flee -- cy flocks the hills a -- dorn,
1359   }
1360 >>
1361 @end lilypond
1362
1363 Pour produire des partitions plus complexes ou plus longues que cet
1364 exemple simple, il est vivement conseillé de séparer la structure de
1365 la partition des notes et paroles, grâce à des variables.  Ceci sera
1366 détaillé plus loin dans
1367 @ref{Organisation du code source avec des variables}.
1368
1369 @seealso
1370 Manuel de notation :
1371 @ruser{Musique vocale}.
1372
1373
1374 @node Dernières précisions
1375 @section Dernières précisions
1376 @translationof Final touches
1377
1378 L'ultime section de ce tutoriel montre comment ajouter une touche
1379 finale à des morceaux simples, et constitue une introduction au reste
1380 du manuel.
1381
1382 @menu
1383 * Organisation du code source avec des variables::
1384 * Ajout de titres::
1385 * Noms de note absolus::
1386 * Après le tutoriel::
1387 @end menu
1388
1389
1390 @node Organisation du code source avec des variables
1391 @subsection Organisation du code source avec des variables
1392 @translationof Organizing pieces with variables
1393
1394 @cindex variables
1395 @cindex variables, définition
1396 @cindex identificateurs
1397 @cindex macros
1398 @cindex assignation de variables
1399 @cindex utilisation de variables
1400 @cindex variables, utilisation de
1401 @cindex variables, caractères autorisés dans les
1402 @cindex caractères autorisés dans les variables
1403
1404 Lorsque l'on combine tous les éléments étudiés précédemment pour
1405 écrire des partitions plus longues, les expressions musicales prennent
1406 de l'ampleur et, dans le cas des pièces polyphoniques, deviennent
1407 profondément imbriquées, jusqu'au point où il devient difficile de se
1408 repérer dans le fichier source.  Cet inconvénient peut être résolu par
1409 l'utilisation de @emph{variables}.
1410
1411 En utilisant des variables, parfois appelées identificateurs ou
1412 macros, on peut scinder des expressions musicales complexes en des
1413 expressions plus simples.  Une variable se définit comme suit :
1414
1415 @example
1416 musiqueToto = @{ @dots{} @}
1417 @end example
1418
1419 Le contenu de l'expression musicale @code{musiqueToto} pourra être
1420 utilisé plus loin en faisant précéder son nom d'un anti-slash,
1421 c'est-à-dire @code{\musiqueToto}, tout comme n'importe quelle commande
1422 LilyPond.  Toute variable doit être définie @emph{avant} son
1423 utilisation dans une autre expression musicale.
1424
1425 @lilypond[verbatim,quote]
1426 violin = \new Staff {
1427   \relative {
1428     a'4 b c b
1429   }
1430 }
1431
1432 cello = \new Staff {
1433   \relative {
1434     \clef bass
1435     e2 d
1436   }
1437 }
1438
1439 {
1440   <<
1441     \violin
1442     \cello
1443   >>
1444 }
1445 @end lilypond
1446
1447 @noindent
1448 Par convention, un nom de variable ne comporte que des caractères
1449 alphabétiques non accentués, aucun nombre ni tiret.
1450
1451 On peut utiliser une variable déjà définie autant de fois que l'on
1452 veut, y compris dans la définition d'une nouvelle variable ; par
1453 exemple, cela peut servir à saisir un motif qu'une seule fois, même
1454 s'il se répète un grand nombre de fois dans la pièce.
1455
1456 @lilypond[verbatim,quote]
1457 tripletA = \tuplet 3/2 { c,8 e g }
1458 barA = { \tripletA \tripletA \tripletA \tripletA }
1459
1460 \relative c'' {
1461  \barA \barA
1462 }
1463 @end lilypond
1464
1465 Il est possible d'utiliser des variables de types variés.  Par exemple,
1466
1467 @example
1468 largeur = 4.5\cm
1469 nom = "Wendy"
1470 aFivePaper = \paper @{ paperheight = 21.0 \cm @}
1471 @end example
1472
1473 En fonction de son contenu, un identificateur peut être utilisé à
1474 différents endroits.  L'exemple suivant utilise les variables définies
1475 ci-dessus.
1476
1477 @example
1478 \paper @{
1479   \aFivePaper
1480   line-width = \largeur
1481 @}
1482
1483 @{
1484   c4^\nom
1485 @}
1486 @end example
1487
1488
1489 @node Ajout de titres
1490 @subsection Ajout de titres
1491 @translationof Adding titles
1492
1493 @cindex titre
1494 @cindex en-têtes
1495 @cindex bloc d'en-tête
1496
1497 @funindex \header
1498 @funindex header
1499
1500 On indique les informations bibliographiques -- nom du morceau, du
1501 compositeur, numéro d'opus@dots{} -- dans un bloc à part, le bloc
1502 d'en-tête @code{\header}, qui existe indépendamment de l'expression
1503 musicale principale.  Le bloc @code{\header} est habituellement placé
1504 en début de fichier, après le numéro de version.
1505
1506 @example
1507 \version @w{"@version{}"}
1508
1509 \header @{
1510   title = "Symphonie"
1511   composer = "Moi"
1512   opus = "Op. 9"
1513 @}
1514
1515 @{
1516  @dots{} la musique @dots{}
1517 @}
1518 @end example
1519
1520 Quand LilyPond traite le fichier, le titre et le compositeur sont
1521 imprimés au début de la partition.  Vous trouverez plus d'informations
1522 sur les titres à la section
1523 @ruser{Création de titres et entête ou pied de page}.
1524
1525
1526 @node Noms de note absolus
1527 @subsection Noms de note absolus
1528 @translationof Absolute note names
1529
1530 @cindex notes, nom des
1531 @cindex absolu, mode
1532 @cindex mode absolu
1533 @cindex hauteurs, valeurs absolues
1534 @cindex noms de note absolus
1535
1536 Jusqu'ici nous avons utilisé le mode @code{\relative} pour définir les
1537 hauteurs de notes.  Si c'est souvent le moyen le plus simple de saisir
1538 la musique au clavier, il existe une autre façon de procéder : le mode
1539 de hauteurs absolues.
1540
1541 Si vous omettez la commande @code{\relative}, LilyPond considérera
1542 toutes les hauteurs comme des hauteurs absolues.  Un @code{c'} désigne
1543 toujours le do central, un @code{b} se situe une seconde en dessous
1544 du do central, et un @code{g,} est situé sur la première ligne de
1545 la portée en clé de fa.
1546
1547 @lilypond[verbatim,quote]
1548 {
1549   \clef "bass"
1550   c'4 b g, g, |
1551   g,4 f, f c' |
1552 }
1553 @end lilypond
1554
1555 Voici une gamme sur quatre octaves :
1556
1557 Il faut beaucoup d'apostrophes pour écrire de la musique dans un
1558 registre aigu, comme le montre cet extrait de Mozart.
1559
1560 @lilypond[verbatim,quote]
1561 {
1562   \key a \major
1563   \time 6/8
1564   cis''8. d''16 cis''8 e''4 e''8 |
1565   b'8. cis''16 b'8 d''4 d''8 |
1566 }
1567 @end lilypond
1568
1569 @funindex \fixed
1570
1571 Les indications doctaves communes peuvent ne s'indiquer qu'une seule
1572 fois, en faisant suivre la commande @code{\fixed} d'une hauteur de
1573 référence :
1574
1575 @lilypond[verbatim,quote]
1576 \fixed c'' {
1577   \key a \major
1578   \time 6/8
1579   cis8. d16 cis8 e4 e8 |
1580   b,8. cis16 b,8 d4 d8 |
1581 }
1582 @end lilypond
1583
1584 Avec un @code{\relative}, le même exemple ne recquiert pas d'indicatin
1585 d'octave puisque la mélodie progresse sur des intervalles ne dépassant
1586 pas la tierce.
1587
1588 @lilypond[verbatim,quote]
1589 \relative {
1590   \key a \major
1591   \time 6/8
1592   cis''8. d16 cis8 e4 e8 |
1593   b8. cis16 b8 d4 d8 |
1594 }
1595 @end lilypond
1596
1597 Si d'aventure vous faites une erreur d'octaviation, le mode
1598 @code{\relative} la mettra en évidence : toutes les notes suivantes
1599 seront placées à la mauvaise octave.  En mode de hauteurs absolues,
1600 une erreur isolée ne serait pas autant visible, et serait donc plus
1601 difficile à dénicher.
1602
1603 Cependant, le mode de hauteurs absolues reste utile pour les musiques
1604 où les intervalles sont étendus, et plus encore pour les fichiers
1605 LilyPond créés par des programmes.  Recopier des fragments en hauteurs
1606 absolues permet d'en préserver les octaves.
1607
1608 La musiqeu peut être agencée de manière plutôt complexe.  Dans le cas
1609 d'une imbrication de commandes @code{\relative}, chacune des sections
1610 est indépendante de l'autre :
1611
1612 @lilypond[verbatim,quote]
1613 \relative { c'4 \relative { f'' g } c }
1614 @end lilypond
1615
1616 @funindex \absolute
1617
1618 Des hauteurs absolues peuvent tout à fait se trouver au sein d'un bloc
1619 en mode relatif, dès lors qu'une instruction @code{\fixed c} exclut
1620 explicitement de la musique relative le fragment en question :
1621
1622 @lilypond[verbatim,quote]
1623 \relative {
1624   c'4 \fixed c { f'' g'' } c |
1625   c4 \fixed c'' { f g } c
1626 }
1627 @end lilypond
1628
1629
1630 @node Après le tutoriel
1631 @subsection Après le tutoriel
1632 @translationof After the tutorial
1633
1634 Après avoir parcouru ce tutoriel, vous devriez essayer d'écrire un
1635 morceau ou deux.  Commencez par copier l'un des modèles types et
1636 ajoutez-y des notes -- consultez les @ref{Modèles}.  Si vous voulez
1637 employer une notation que vous n'avez pas trouvé dans le tutoriel,
1638 consultez le manuel de notation, en commençant par la
1639 @ruser{Notation musicale générale}.  Si vous désirez écrire pour un
1640 ensemble instrumental non couvert par les modèles, lisez la section
1641 @ref{Extension des modèles}.
1642
1643 Après avoir écrit quelques pièces courtes, lisez les chapitres 3 à 5
1644 du manuel d'initiation.  Rien ne s'oppose à ce que vous consultiez dès
1645 à présent ces chapitres, bien sûr ! Néanmoins, le reste du manuel
1646 d'initiation part du principe que vous avez déjà bien assimilé la
1647 syntaxe de base de LilyPond.  Vous pouvez toujours survoler ces
1648 chapitres 3 à 5, et y revenir plus tard après avoir acquis de
1649 l'expérience.
1650
1651 Dans ce tutoriel comme dans le reste de ce manuel, se trouve à chaque
1652 section un paragraphe @strong{Voir aussi} contenant des références
1653 vers d'autres sections : il est conseillé de ne pas les suivre en
1654 première lecture ; lorsque vous aurez lu l'ensemble du manuel
1655 d'initiation, vous pourrez en relisant certaines sections suivre ces
1656 références pour approfondir certains aspects.
1657
1658 Si vous ne l'avez pas encore fait, lisez
1659 @ref{Vue d'ensemble des manuels}.  Les sources de documentation et
1660 d'information sur LilyPond sont vastes, il est normal pour un débutant
1661 de ne pas savoir où chercher ; si vous passez quelques minutes à
1662 lire attentivement cette section, vous vous épargnerez certainement la
1663 frustration causée par des heures de recherches infructueuses.