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