]> git.donarmstrong.com Git - lilypond.git/blob - Documentation/fr/learning/tutorial.itely
Merge branch 'lilypond/translation' of ssh://git.sv.gnu.org/srv/git/lilypond into...
[lilypond.git] / Documentation / fr / learning / tutorial.itely
1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
2
3 @ignore
4    Translation of GIT committish: 5f722f1688eff7436789f8ca011205bdb16c04b7
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 @include included/generating-output.itexi
12
13 @c \version "2.14.0"
14
15 @c Translators: Nicolas Grandclaude, Ludovic Sardain, Gauvain Pocentek
16 @c Translation checkers: Jean-Charles Malahieude, Valentin Villenave, John Mandereau
17 @c Translation status: post-GDP
18
19 @node Tutoriel
20 @chapter Tutoriel
21 @translationof Tutorial
22
23 Ce tutoriel est une introduction au langage musical utilisé
24 par LilyPond, qui vous permettra de faire fonctionner le logiciel pour
25 produire une partition.
26
27 @menu
28 * Compilation d'un fichier::
29 * Composition d'un fichier source::
30 * Gestion des erreurs::
31 * Bien lire le manuel::
32 @end menu
33
34
35 @node Compilation d'un fichier
36 @section Compilation d'un fichier
37 @translationof Compiling a file
38
39 Nous allons ici parler de la @qq{compilation}, ou comment LilyPond
40 traite le fichier source que vous avez écrit, pour en faire quelque
41 chose d'imprimable.
42
43 @menu
44 * Saisie de la musique::
45 * MacOS X::
46 * Windows::
47 * Ligne de commande::
48 @end menu
49
50 @node Saisie de la musique
51 @subsection Saisie de la musique
52 @translationof Entering input
53
54 @cindex compilation
55 @cindex exemple, premier
56 @cindex premier exemple
57
58 Pour créer une partition avec LilyPond, on écrit un fichier texte,
59 appelé fichier source, qui décrit la notation musicale. La
60 @emph{compilation} de ce fichier source par LilyPond produit un
61 fichier graphique imprimable, et si on le désire un fichier MIDI qui
62 peut être joué par un séquenceur.
63
64 Voici un premier exemple simple de fichier source LilyPond.
65
66 @example
67 \version "@w{@version{}}"
68 @{
69   c' e' g' e'
70 @}
71 @end example
72
73 @noindent
74 La compilation de ce fichier donnera quelque chose de sembable à
75 l'image ci-dessous.
76
77 @c  in this case we don't want verbatim
78 @lilypond[quote]
79 {
80   c' e' g' e'
81 }
82 @end lilypond
83
84 @c DIV specific
85 Il est aussi possible d'utiliser les noms de notes français @qq{@w{do
86 re mi fa sol la si}}, en insérant au début du fichier la ligne
87 @w{@code{\include@tie{}"italiano.ly"}}.
88 @c END DIV
89
90 @warning{Tout extrait de code LilyPond doit être entouré d'une
91 @w{@strong{@{ paire d'accolades @}}}.  De plus, pour éviter toute
92 ambiguïté, il est préférable d'entourer les accolades par des espaces
93 ou retours à la ligne.  Bien que certains exemples de ce manuel ne
94 comportent pas d'accolades, ne les oubliez pas dans vos partitions@tie{}!
95 Pour plus d'informations sur l'affichage des exemples de cette
96 documentation, consultez @ref{Bien lire le manuel}.}
97
98
99 @cindex casse, prise en compte de la
100 @cindex prise en compte de la casse
101 @cindex sensibilité à la casse
102
103 De plus, LilyPond est @strong{sensible à la casse}@tie{}: le code
104 @w{@samp{@{ c d e @}}} est valide, alors que @w{@samp{@{ C D E @}}}
105 produira un message d'erreur.
106
107 @smallspace
108
109 @subheading Production de la partition
110
111 @cindex fichier PDF
112 @cindex PDF
113 @cindex partition, lire
114 @cindex lire la partition
115 @cindex éditeurs de texte
116
117 Dans cette section nous expliquerons quelles commandes exécuter et
118 comment voir ou imprimer le résultat produit par LilyPond.
119
120 @itemize
121
122 @item
123 @ref{MacOS X, @sourceimage{logo-macosx,,,}}
124 @ref{MacOS X, MacOS X} (graphique)
125
126 @item
127 @ref{Windows, @sourceimage{logo-windows,,,}}
128 @ref{Windows, Microsoft Windows} (graphique)
129
130 @item
131 @ref{Ligne de commande, @sourceimage{logo-linux,,,}
132 @sourceimage{logo-freebsd,,,}
133 @sourceimage{logo-macosx,,,}
134 @sourceimage{logo-windows,,,}
135 }
136 @ref{Ligne de commande, Tous systèmes} (ligne de commande)
137
138 @end itemize
139
140 Notez qu'il existe plusieurs éditeurs de texte disponibles avec un bon
141 support de LilyPond@tie{}; consultez @rweb{Facilités d'édition}.
142
143 @warning{Le premier démarrage de LilyPond peut prendre une minute ou
144 deux, afin de générer la liste des polices du système.  LilyPond démarre
145 en principe plus rapidement lors des exécutions suivantes.}
146
147
148 @node MacOS X
149 @subsection MacOS X
150
151 @cindex lancer LilyPond sous MacOS X
152 @cindex MacOS X, lancer LilyPond
153
154 @lilypadOSX
155
156
157 @node Windows
158 @subsection Windows
159
160 @cindex lancer LilyPond sous Windows
161 @cindex Windows, lancer LilyPond
162
163 @lilypadWindows
164
165
166 @node Ligne de commande
167 @subsection Ligne de commande
168 @translationof Command-line
169
170 @cindex lancer LilyPond sous Unix
171 @cindex Unix, lancer LilyPond
172
173 @lilypadCommandLine
174
175
176 @node Composition d'un fichier source
177 @section Composition d'un fichier source
178 @translationof How to write input files
179
180 This section introduces some basic LilyPond syntax to help get you
181 started writing input files.
182
183 @menu
184 * Notation simple::
185 * Travail sur les fichiers d'entrée::
186 @end menu
187
188
189 @node Notation simple
190 @subsection Notation simple
191 @translationof Simple notation
192
193 @cindex simple, notation
194 @cindex notation simple
195
196 Il y a certains éléments graphiques de notation que LilyPond ajoute
197 automatiquement.  Dans l'exemple suivant, nous n'avons fourni que
198 quatre hauteurs, mais LilyPond a ajouté une clef, un chiffre de mesure
199 et du rythme.
200
201 @lilypond[verbatim,quote]
202 {
203   c' e' g' e'
204 }
205 @end lilypond
206
207 @noindent
208 Ces valeurs automatiques simplifient la saisie du code source dans
209 bien des cas ; nous verrons plus loin comment les indiquer
210 explicitement.
211
212
213 @subheading Hauteurs
214
215 @cindex hauteurs
216 @cindex mode relatif
217 @cindex apostrophe
218 @cindex virgule
219 @cindex altérations et mode relatif
220 @cindex mode relatif et altérations
221
222 @funindex \relative
223 @funindex relative
224 @funindex '
225 @funindex ,
226
227 Glossaire musicologique :
228 @rglosnamed{pitch,hauteur},
229 @rglosnamed{interval,intervalle},
230 @rglosnamed{scale,gamme},
231 @rglosnamed{middle C,do central},
232 @rglos{octave},
233 @rglosnamed{accidental,altération}.
234
235 Le moyen le plus simple d'entrer des notes est d'utiliser le mode
236 d'octaves relatives, ou mode @code{\relative}.  Dans ce mode, l'octave
237 de chaque note est déterminée automatiquement de façon à ce qu'elle
238 soit le plus proche possible de la note précédente, c'est-à-dire de
239 façon à ce que l'intervalle avec la note précédente soit au plus d'une
240 quarte.  Commençons par saisir une partition très simple, à savoir une
241 gamme.
242
243 @lilypond[verbatim,quote]
244 % set the starting point to middle C
245 \relative c' {
246   c d e f
247   g a b c
248 }
249 @end lilypond
250
251 La note de départ est le @notation{do central}.  Chacune des notes qui
252 suivent est placée à l'octave la plus proche de la note précédente --
253 en d'autres termes, le premier @code{c} est le do central, entre la
254 clef de sol et la clef de fa, puis est suivi par le @notation{ré} le
255 plus proche, et ainsi de suite.  On peut bien sûr créer des mélodies
256 avec de plus grands intervalles, toujours avec le mode
257 @code{\relative}@tie{}:
258
259 @lilypond[verbatim,quote]
260 \relative c' {
261   d f a g
262   c b f d
263 }
264 @end lilypond
265
266 @noindent
267 Remarquez que cet exemple ne commence plus sur le @notation{do
268 central}@tie{}: la première note -- le @code{d} -- est le ré qui en est
269 le plus proche.
270
271 Dans l'exemple suivant, on remplace @code{c'} dans la commande
272 @w{@code{@bs{}relative c'}} par @code{c''}, afin de calculer l'octave de
273 la première note par rapport au do situé une octave au-dessus du do
274 central@tie{}:
275
276 @lilypond[verbatim,quote]
277 % one octave above middle C
278 \relative c'' {
279   e c a c
280 }
281 @end lilypond
282
283 Le mode d'octaves relatives peut être déroutant au début, mais c'est
284 souvent la façon la plus économique de saisir les hauteurs en
285 utilisant le clavier de l'ordinateur de façon classique.  Détaillons
286 dans un exemple le calcul des octaves relatives.  En partant d'un si
287 sur la troisième ligne de la clé de sol, un do, un ré ou un mi sans
288 indication d'octave particulière seront placés juste au-dessus du si,
289 c'est-à-dire au plus à une quarte ascendante du si, alors qu'un la, un
290 sol ou un fa seront placés juste en-dessous du si, c'est-à-dire au
291 plus à une quarte descendante du si.
292
293 @lilypond[verbatim,quote]
294 \relative c'' {
295   b c  % c is 1 staff space up, so is the c above
296   b d  % d is 2 up or 5 down, so is the d above
297   b e  % e is 3 up or 4 down, so is the e above
298   b a  % a is 6 up or 1 down, so is the a below
299   b g  % g is 5 up or 2 down, so is the g below
300   b f  % f is 4 up or 3 down, so is the f below
301 }
302 @end lilypond
303
304 Notez que le calcul des octaves relatives @strong{ne tient pas compte
305 des altérations} des notes, dièse bémol ou bécarre.
306
307 Pour obtenir des intervalles supérieurs à une quarte, on peut ajouter
308 des apostrophes @code{'} -- qui font chacune monter la hauteur d'une
309 octave -- ou des virgules @code{,} -- qui font chacune descendre la
310 hauteur d'une octave -- au nom de la note.
311
312 @lilypond[verbatim,quote]
313 \relative c'' {
314   a a, c' f,
315   g g'' a,, f'
316 }
317 @end lilypond
318
319 @noindent
320 Pour déplacer une note deux octaves (ou davantage@tie{}!) plus haut ou plus
321 bas, il suffit de mettre deux (ou davantage) @code{'} ou @code{,} --
322 attention cependant à bien mettre deux apostrophes @code{''}, et non
323 un guillemet @code{"}@tie{}!  C'est de cette même manière que l'on
324 peut modifier la valeur de départ de @w{@code{\relative c'}}.
325 @c " - keeps quotes in order for context-sensitive editor -td
326
327
328 @subheading Durées et rythme
329
330 @cindex note, durée
331 @cindex durées
332 @cindex rhythmes
333 @cindex ronde
334 @cindex blanche
335 @cindex noire
336 @cindex note pointée
337 @cindex spécification des durées
338
339 Glossaire musicologique :
340 @rglosnamed{beam,ligature},
341 @rglosnamed{duration,durée},
342 @rglosnamed{whole note,ronde},
343 @rglosnamed{half note,blanche},
344 @rglosnamed{quarter note,noire},
345 @rglosnamed{dotted note,note pointée}.
346
347 La @notation{durée} d'une note est indiquée par un nombre qui suit sa
348 hauteur@tie{}: @code{1} pour une @notation{ronde}, @code{2} pour une
349 @notation{blanche}, @code{4} pour une @notation{noire} et ainsi de
350 suite.  Les @notation{crochets} et @notation{liens} sont ajoutés
351 automatiquement.
352
353 Si aucune durée n'est indiquée pour une note, la dernière durée entrée
354 est utilisée.  En l'absence d'indication de durée, la première note
355 est une noire.
356
357 @lilypond[verbatim,quote]
358 \relative c'' {
359   a1
360   a2 a4 a8 a
361   a16 a a a a32 a a a a64 a a a a a a a a2
362 }
363 @end lilypond
364
365 Une @notation{note pointée} s'obtient en ajoutant un point @code{.}  à
366 la valeur rythmique.  Le point doit être précédé d'un nombre spécifiant
367 la durée de base.
368
369 @lilypond[verbatim,quote]
370 \relative c'' {
371   a a a4. a8
372   a8. a16 a a8. a8 a4.
373 }
374 @end lilypond
375
376
377 @subheading Silences
378
379 @cindex silences
380 @cindex notation des silences
381
382 Glossaire musicologique :
383 @rglosnamed{rest,silence}.
384
385 On saisit un @notation{silence} tout comme une note, mais avec la
386 lettre @code{r} (pour @emph{rest}).
387
388 @lilypond[verbatim,quote]
389 \relative c'' {
390   a r r2
391   r8 a r4 r4. r8
392 }
393 @end lilypond
394
395
396 @subheading Métrique
397
398 @cindex métrique
399 @cindex chiffre de mesure
400
401 @funindex \time
402 @funindex time
403
404 Glossaire musicologique : @rglosnamed{time signature,métrique}.
405
406 La @notation{métrique}, aussi appelée @notation{chiffre de mesure},
407 peut être définie à l'aide de la commande @code{\time}@tie{}:
408
409 @lilypond[verbatim,quote]
410 \relative c'' {
411   \time 3/4
412   a4 a a
413   \time 6/8
414   a4. a
415   \time 4/4
416   a4 a a a
417 }
418 @end lilypond
419
420
421 @subheading Indication de tempo
422
423 @cindex tempo, indication
424 @cindex indication du tempo
425 @cindex métronome, indication
426 @cindex indication métronomique
427
428 @funindex \tempo
429 @funindex tempo
430
431 Glossaire musicologique :
432 @rglosnamed{tempo indication,indication de tempo},
433 @rglosnamed{metronome,métronome}.
434
435 La commande @code{\tempo} permet de stipuler aussi bien le @emph{tempo}
436 que le métronome@tie{}:
437
438 @lilypond[verbatim,quote]
439 \relative c'' {
440   \time 3/4
441   \tempo "Andante"
442   a4 a a
443   \time 6/8
444   \tempo 4. = 96
445   a4. a
446   \time 4/4
447   \tempo  "Presto" 4 = 120
448   a4 a a a
449 }
450 @end lilypond
451
452
453 @subheading Clefs
454
455 @cindex clef
456 @cindex clé
457 @cindex sol, clef de
458 @cindex ut, clef d'
459 @cindex fa, clef de
460
461 @funindex \clef
462 @funindex clef
463
464 Glossaire musicologique : @rglos{clef}.
465
466 La @notation{clef} peut être définie à l'aide de la commande
467 @code{\clef}@tie{}:
468
469 @lilypond[verbatim,quote]
470 \relative c' {
471   \clef "treble"
472   c1
473   \clef "alto"
474   c1
475   \clef "tenor"
476   c1
477   \clef "bass"
478   c1
479 }
480 @end lilypond
481
482
483 @subheading Tout ensemble
484
485 Voici un bref exemple qui rassemble tous les éléments que nous déjà
486 vus@tie{}:
487
488 @lilypond[verbatim,quote]
489 \relative c, {
490   \clef "bass"
491   \time 3/4
492   c2 e8 c'
493   g'2.
494   f4 e d
495   c4 c, r
496 }
497 @end lilypond
498
499
500 @seealso
501 Manuel de notation : @ruser{Écriture des hauteurs de note},
502 @ruser{Écriture du rythme}, @ruser{Écriture des silences},
503 @ruser{Gravure du rythme}, @ruser{Gravure des hauteurs}.
504
505
506 @node Travail sur les fichiers d'entrée
507 @subsection Travail sur les fichiers d'entrée
508 @translationof Working on input files
509
510 @cindex accolades
511 @cindex commentaires
512 @cindex ligne de commentaire
513 @cindex bloc de commentaire
514 @cindex casse, prise en compte de
515 @cindex prise en compte de la casse
516 @cindex sensibilité à la casse
517 @cindex espaces multiples, insensibilité
518 @cindex insensibilité aux espaces multiples
519 @cindex expressions
520 @cindex versionage
521 @cindex version
522 @cindex numéro de version
523
524 @funindex \version
525 @funindex { ... }
526 @funindex %
527 @funindex %@{ ... %@}
528
529 Le traitement des fichiers source de LilyPond est semblable à celui du
530 code de nombreux langages de programmation.  La casse est prise
531 en compte, et les caractères considérés comme espaces ont généralement
532 peu d'importance.  Les expressions sont délimitées par des accolades
533 @w{@code{@{ @}}}, et les commentaires par @code{%} ou
534 @w{@code{%@{ @dots{} @}}}@tie{}.
535
536 Si cette phrase vous paraît incompréhensible, ne vous en faites pas@tie{}!
537 Expliquons tous ces termes@tie{}:
538
539
540 @itemize
541
542 @item
543 @strong{La version} :
544 Tout fichier LilyPond devrait porter mention de la version.  Cette
545 mention prend la forme d'une ligne décrivant le numéro de la version
546 utilisée lors de la confection du fichier en question, comme ici@tie{}:
547
548 @example
549 \version "@w{@version{}}"
550 @end example
551
552 Il est d'usage de porter cette mention au tout début du fichier
553 LilyPond.
554
555 Mentionner la version est important pour, au moins, les deux raisons
556 suivantes@tie{}: cela permet dans un premier temps de faciliter les
557 opérations de mise à jour automatisée au fil de l'évolution de la
558 syntaxe de LilyPond.  Ensuite, cela met en évidence le minimum requis
559 pour pouvoir compiler votre fichier.
560
561 Si vous ne le mentionnez pas, Lilypond vous rappellera à l'ordre durant
562 la compilation.
563
564 @item
565 @strong{La casse} :
566 LilyPond est sensible à la casse, c'est à dire qu'une lettre capitale
567 n'a pas la même valeur qu'une lettre minuscule.  Les notes, par
568 exemple, doivent être entrées en minuscule : @w{@code{@{ c d e @}}} est
569 un code valide, alors que @w{@code{@{ C D E @}}} produira un message
570 d'erreur.
571
572 @item
573 @strong{Les espaces multiples} :
574 LilyPond ne tient pas compte du nombre d'espaces, de tabulations ou de
575 retours à la ligne.  @w{@code{@{ c d e @}}} a le même sens que
576 @w{@code{@{ c @tie{} @tie{} d @tie{} e @}}} ou que
577
578 @example
579 @{ c4                       d
580                    e   @}
581 @end example
582
583 @noindent
584 Bien sûr, ce dernier exemple est illisible.  Une bonne habitude
585 à prendre est d'indenter les blocs de code avec des doubles espaces@tie{}:
586
587 @example
588 @{
589   c4 d e
590 @}
591 @end example
592
593 L'espace est néanmoins @strong{nécessaire} pour séparer nombre
594 d'éléments syntaxiques les uns des autres.  En d'autres termes, s'il est
595 toujours possible d'@emph{ajouter} des espaces, il faut prendre garde à
596 ne pas trop en @emph{supprimer}.  En effet, l'absence d'une espace peut
597 avoir des conséquences et entraîner une erreur@tie{}; aussi nous vous
598 invitons à toujours insérer une espace avant et après chaque élément
599 syntaxique, comme avant et après une accolade.
600
601 @item
602 @strong{Expressions musicales} :
603 Tout morceau saisi dans LilyPond doit être placé entre
604 @strong{@{@tie{}accolades@tie{}@}}.  Ces caractères indiquent à LilyPond
605 que ce bloc de texte représente une et une seule expression musicale,
606 tout comme les parenthèses @code{()} en mathématiques.  Pour éviter
607 toute ambiguïté, il est préférable d'entourer ces accolades d'espaces ou
608 de retours à la ligne.
609
610 Un appel de fonction -- @w{@code{@bs{}relative c' @{ @dots{} @}}} par
611 exemple -- compte également comme une seule expression musicale.
612
613 @item
614 @strong{Les commentaires} :
615 Un commentaire est une indication pour tout lecteur humain d'un
616 fichier source de musique@tie{}; il est ignoré lors de la compilation et
617 n'a donc aucun effet sur la partition imprimée.  On distingue deux types
618 de commentaires.  Le commentaire de fin de ligne, introduit par le
619 symbole @code{%}@tie{}: tout ce qui suit ce symbole sur la même ligne sera
620 ignoré.  Par convention, un commentaire qui occupe une ligne entière
621 se place juste @emph{au-dessus} de la ligne à laquelle il fait
622 référence.
623
624 @example
625 a4 a a a
626 % ce commentaire fait référence aux si
627 b2 b
628 @end example
629
630 Le bloc de commentaire, qui peut occuper plusieurs lignes, voire toute
631 une section@tie{}: tout ce qui se trouve entre @code{%@{} et @code{%@}} est
632 ignoré.  Les blocs de commentaires ne peuvent s'imbriquer, ce qui
633 signifie que vous ne pouvez pas placer un commentaire-bloc à
634 l'intérieur d'un autre commentaire-bloc.  Si jamais vous essayez, vous
635 verrez que la première occurence de @code{%@}} terminera @qq{les
636 @emph{deux} commentaires-blocs}.  Le fragment suivant met en évidence
637 quelques usages possibles des commentaires@tie{}:
638
639 @example
640 % voici les notes de "ah vous dirai-je maman"
641  c4 c g' g a a g2
642
643 %@{
644    Ces lignes et les notes qui suivent
645    seront ignorées, car elles se trouvent
646    dans un bloc de commentaire.
647
648    f f e e d d c2
649 %@}
650 @end example
651
652 @end itemize
653
654
655 @node Gestion des erreurs
656 @section Gestion des erreurs
657 @translationof Dealing with errors
658
659 @cindex dépannage
660
661 Parfois, LilyPond ne produit pas le résultat escompté.  Voici quelques
662 pistes à suivre pour vous aider à éviter de telles déconvenues.
663
664
665 @menu
666 * Quand ça ne fonctionne pas::
667 * Erreurs courantes::
668 @end menu
669
670 @node Quand ça ne fonctionne pas
671 @subsection Quand ça ne fonctionne pas
672 @translationof General troubleshooting tips
673
674 Résoudre les problèmes rencontrés avec LilyPond est une gageure pour
675 ceux qui ne connaissent que des interfaces graphiques puisque rien
676 n'empèche de créer du code erroné.  En pareil cas, il suffit souvent d'un
677 peu de logique pour être en mesure d'identifier les causes du problème
678 et le résoudre simplement.  Le chapitre
679 @rprogram{Résolution de problèmes} liste quelques directives à ce propos.
680
681
682 @node Erreurs courantes
683 @subsection Erreurs courantes
684 @translationof Some common errors
685
686 @cindex erreurs courantes
687 @cindex courantes, erreurs
688
689 Il peut arriver qu'un message d'erreur ne soit pas suffisamment
690 explicite pour solutionner le problème.  Quelques cas des plus courants
691 sont répertoriés au chapitre
692 @rprogram{Quelques erreurs des plus courantes}.
693
694
695 @node Bien lire le manuel
696 @section Bien lire le manuel
697 @translationof How to read the manual
698
699 Nous allons voir ici comment consulter la documentation le plus
700 efficacement possible.  Nous en profiterons pour vous présenter quelques
701 particularités de la domcumentation en ligne.
702
703 @menu
704 * Matériel incomplet::
705 * Exemples cliquables::
706 * Vue d'ensemble des manuels::
707 @end menu
708
709
710 @node Matériel incomplet
711 @subsection Matériel incomplet
712 @translationof Omitted material
713
714
715 @cindex bien lire le manuel
716 @cindex manuel, lecture
717 @cindex compulser le manuel
718 @cindex exemples cliquables
719 @cindex cliquables, exemples
720 @cindex conseils de construction des fichiers
721 @cindex squelettes
722 @cindex construction des fichiers, conseils
723 @cindex fichiers, conseils de construction
724
725 Comme nous l'avons vu dans @ref{Travail sur les fichiers d'entrée}, un
726 code LilyPond doit être encadré par des accolades @{@tie{}@} ou bien par
727 @w{@code{\relative c'' @{ @dots{} @}}}.  Cependant, dans la suite de ce
728 manuel, la plupart des exemples ne feront pas apparaître ces signes.
729
730 Pour reproduire les exemples, vous pouvez copier et coller le code
731 affiché, mais @strong{à condition} d'ajouter
732 @code{@w{\relative c'' @{ @}}} de la façon suivante@tie{}:
733
734 @example
735 \relative c'' @{
736   ...collez ici votre exemple...
737 @}
738 @end example
739
740 Pourquoi avoir omis les accolades@tie{}?  La plupart des exemples de ce
741 manuel peuvent être insérés au milieu d'un morceau de musique plus
742 long.  Il n'y a donc aucune raison d'ajouter @code{@w{\relative c'' @{
743 @}}} à ces exemples -- en effet, il n'est pas possible d'insérer une
744 expression @code{\relative} à l'intérieur d'une autre expression
745 @code{\relative}.  Si nous mettions tous nos exemples dans une
746 expression @code{\relative}, vous ne pourriez plus copier un bref
747 exemple de la documentation pour le coller dans vos pièces.
748
749
750 @node Exemples cliquables
751 @subsection Exemples cliquables
752 @translationof Clickable examples
753
754 Beaucoup de gens apprennent à utiliser les programmes en les essayant
755 et en bidouillant avec.  C'est également possible avec LilyPond.  Si
756 vous cliquez sur une image dans la version HTML de ce manuel, vous
757 verrez exactement le code LilyPond utilisé pour générer cette image.
758 Essayez sur cette image@tie{}:
759
760 @c no verbatim here
761 @c KEEP LY
762 @lilypond[quote,ragged-right]
763 \relative c'' {
764   c-\markup { \bold \huge { Cliquez ici.  } }
765 }
766 @end lilypond
767
768 En copiant-collant le code à partir du commentaire @qq{ly snippet}
769 vers un fichier test, vous aurez un modèle de base pour faire vos
770 expériences.  Pour obtenir une gravure à l'identique, copiez tout le
771 code à partir de @qq{Start cut-&-pastable section}.
772
773 @c No longer in the text in English, but should we really
774 @c remove this? --jm
775 @ignore
776 Si vous apprenez de cette façon, vous aurez probablement envie
777 d'imprimer ou de garder un lien vers @ruser{Aide-mémoire}, tableau
778 qui répertorie les commandes usuelles pour une consultation rapide.
779 @end ignore
780
781 @node Vue d'ensemble des manuels
782 @subsection Vue d'ensemble des manuels
783 @translationof Overview of manuals
784
785 La documentation de LilyPond est relativement abondante.  Ceci peut
786 dérouter les nouveaux utilisateurs qui ne savent pas par quoi commencer
787 ou bien sont tentés de faire l'impasse sur des passages importants.
788
789 @warning{Nous vous invitons à ne pas faire l'impasse sur les chapitres
790 importants de notre documentation, au risque de vous retrouver
791 complètement perdu lorsque vous aborderez d'autres parties.}
792
793 @itemize
794
795 @item
796 @strong{Avant de vous lancer dans @emph{quoi que ce soit}}, lisez le
797 @ref{Tutoriel} contenu dans le manuel d'initiation ainsi que les
798 @ref{Bases de notation musicale}.  Si vous y trouvez des termes que vous
799 ne connaissez pas, n'hésitez pas à consulter le
800 @rglosnamed{Top, Glossaire}.
801
802 @item
803 @strong{Avant de vous lancer dans la réalisation d'une partition
804 complète}, lisez le chapitre @ref{Concepts fondamentaux} du manuel
805 d'initiation.  Vous pourrez alors vous reporter aux parties qui vous
806 intéresseront dans le @rusernamed{Top, Manuel de notation}.
807
808 @item
809 @strong{Avant de modifier les réglages par défaut}, consultez le
810 chapitre @ref{Retouche de partition} du manuel d'initiation.
811
812 @item
813 @strong{Avant de vous lancer dans un projet d'envergure}, lisez le
814 chapitre @rprogram{Suggestions pour la saisie de fichiers LilyPond} du
815 manuel d'utilisation.
816
817 @end itemize