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