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