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