1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
2 @c This file is part of lilypond.tely
4 Translation of GIT committish: 8bf657e5c944bd8da26af01d6a021b48e74ff10a
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. See TRANSLATION for details.
16 * Automated engraving::
17 * What symbols to engrave?::
18 * Music representation::
19 * Example applications::
27 L'art de la typographie musicale se nomme la @emph{gravure}. Ce terme
28 est issu du processus traditionnel d'impression musicale. Il y a
29 seulement quelques dizaines d'années, on faisait les partitions en
30 coupant et en embossant une plaque de zinc ou d'étain en image miroir.
31 Cette plaque était ensuite encrée, les dépressions créées par les
32 creux et les bosses retenant l'encre. Une image était formée en
33 pressant du papier sur la plaque. La découpe et l'embossage étaient
34 entièrement faits à la main. Il était pénible d'appliquer une
35 correction, quand celle-ci n'était pas impossible, la gravure devait
36 donc être parfaite du premier coup. La gravure demandait une
37 qualification hautement spécialisée : un artisan devait accomplir
38 environ cinq ans de formation avant de mériter le titre de maître
39 graveur, et il lui fallait cinq années d'expérience supplémentaires
40 pour devenir vraiment habile.
42 De nos jours, toutes les partitions récentes sont produites avec des
43 ordinateurs. Ceci a des avantages évidents : le coût des impressions
44 a diminué, et le travail d'éditeur peut être envoyé par courriel.
45 Malheureusement, l'utilisation dominante des ordinateurs a également
46 diminué la qualité graphique des partitions. L'impression
47 informatisée leur donne un aspect fade et mécanique qui les rend
50 @c introduce illustrating aspects of engraving, font...
51 Les images ci-dessous illustrent la différence entre la gravure
52 traditionelle et l'impression typique par ordinateur, et la troisème
53 image montre comment LilyPond mime l'aspect traditionnel. L'image de
54 gauche est une numérisation d'un symbole bémol d'une édition publiée
55 en 2000. Celle du centre montre un bémol d'une gravure à la main de
56 l'édition Bärenreiter de la même musique. L'image de gauche illustre
57 des défauts typiques de l'impression informatique : les lignes de
58 portée sont minces, l'épaisseur de trait du bémol est la même que les
59 lignes fines, et il y a un aspect rigide avec des angles pointus. Par
60 contraste, le bémol Bärenreiter possède un aspect gras et arrondi,
61 presque voluptueux. Notre symbole bémol est créé, entre autres, à
62 partir de celui-là. Il est arrondi, et son épaisseur de trait
63 s'harmonise avec nos lignes de portée, lesquelles sont également plus
64 épaisses que celles de l'édition informatique.
66 @multitable @columnfractions .125 .25 .25 .25 .125
70 @image{henle-flat-gray,,4cm}
73 @image{henle-flat-gray,,,png}
78 @image{baer-flat-gray,,4cm}
81 @image{baer-flat-gray,,,png}
86 @image{lily-flat-bw,,4cm}
89 @image{lily-flat-bw,,,png}
93 @c workaround for makeinfo-4.6: line breaks and multi-column cookies
94 @image{henle-flat-bw,,,png} @image{baer-flat-bw,,,png}
95 @image{lily-flat-bw,,,png}
103 Fonte Feta de LilyPond (2003)
108 @cindex musical symbols
113 @c introduce illustrating aspects of engraving, spacing...
114 En matière d'espacement, la répartition de l'espace devrait refléter
115 les durées entre les notes. Cependant, beaucoup de partitions
116 modernes se contentent des durées avec une précision mathématique, ce
117 qui mène à de mauvais résultats. Dans l'exemple suivant, un motif est
118 imprimé deux fois : une fois en utilisant un espacement mathématique
119 exact, et une autre fois avec des corrections. Pouvez-vous les
122 @cindex optical spacing
123 @c file spacing-optical.
124 @c need to include it here, because we want two images.
145 \override NoteSpacing #'stem-spacing-correction = #0.6
170 \override NoteSpacing #'stem-spacing-correction = #0.0
171 \override NoteSpacing #'same-direction-correction = #0.0
172 \override StaffSpacing #'stem-spacing-correction = #0.0
178 @cindex regular rhythms
179 @cindex regular spacing
181 L'extrait n'utilise que des notes de même durée ; l'espacement devrait
182 le refléter. Malheureusement, notre oeil nous trompe quelque peu ; il
183 ne se contente pas de remarquer la distance entre les têtes de notes,
184 il prend en compte également la distance entre les hampes
185 consécutives. Ainsi, par compensation, les notes avec une combinaison
186 @qq{hampe vers le haut}/@/@qq{hampe vers le bas} doivent être éloignées
187 l'une de l'autre, et les notes avec une combinaison @qq{hampe vers le
188 bas}/@/@qq{hampe vers le haut} rapprochées, le tout dépendant de la
189 position verticale des notes. Les deux premières mesures sont
190 imprimées avec cette correction, les deux suivantes sans. Les notes
191 dans les deux dernières mesures forment des blocs de notes @qq{hampe
192 vers le bas}/@/@qq{hampe vers le haut}.
196 Les musiciens sont généralement plus absorbés par l'exécution que par
197 l'étude de l'aspect graphique d'une partition, donc discutailler sur
198 les détails typographiques peut paraître peu important. Il n'en est
199 rien. Dans de longues pièces avec des rythmes monotones, les
200 corrections d'espacement engendrent de subtiles variations dans la
201 mise en forme de chaque ligne, donnant à chacune une signature
202 visuelle distincte. Sans cette signature, toutes les lignes auraient
203 le même aspect, et ressembleraient à un labyrinthe. Si un musicien
204 regarde ailleurs un instant ou se déconcentre momentanement, il peut
205 avoir du mal à se retrouver sur la page.
207 De même, l'aspect robuste des symboles sur d'épaisses lignes de
208 portées ressort mieux quand la partition est éloignée du lecteur,
209 comme sur un pupitre par exemple. Une organisation minutieuse des
210 espaces vides permet de minimiser l'espace qu'occupe la musique, tout
211 en évitant que les symboles s'amassent les uns contre les autres. le
212 résultat permet de réduire le nombre de pages à tourner, ce qui est un
215 Ceci est une caractéristique commune à toute typographie. La
216 disposition doit être belle, non seulement pour des raisons
217 esthétiques, mais également pour l'aide apportée au lecteur dans la
218 tâche qu'il doit accomplir. Pour du matériel d'exécution comme les
219 partitions de musique, cela prend une double importance : les
220 musiciens ont une quantité limitée d'attention. Moins ils en ont
221 besoin pour lire, plus ils peuvent se concentrer sur la musique
222 elle-même. Autrement dit, une meilleure typographie permet une
223 meilleure interprétation.
225 Ces exemples démontrent que la typographie musicale est un art subtil
226 et complexe, et que la produire demande une expertise considérable,
227 que les musiciens n'ont généralement pas. LilyPond représente notre
228 effort pour apporter l'excellence graphique de la gravure à la main à
229 l'ère de l'ordinateur, et la rendre accessible à tous les musiciens.
230 Nous avons conçu nos algorithmes, fontes et paramètres de programme
231 pour retrouver la qualité d'édition des anciennes partitions que nous
232 aimons tant lire et jouer.
236 @node Automated engraving
237 @section Automated engraving
239 Comment pouvons-nous implémenter la typographie ? Si les artisans ont
240 besoin de plus de dix ans pour devenir de vrais maîtres, comment nous,
241 simples programmeurs, pourrions-nous jamais écrire un programme pour
244 La réponse est : nous ne le pouvons pas. La typographie se base sur
245 le jugement visuel humain, donc les humains ne peuvent pas être
246 complètement remplacés. Si LilyPond arrive à résoudre la plupart des
247 situations correctement, ce sera déjà une grande avancée sur les
248 logiciels existants. Les autres situations peuvent être résolues à la
249 main. Au fil des ans, le logiciel peut être affiné pour faire de plus
250 en plus de choses automatiquement, pour que les ajustements manuels
251 soient de moins en moins nécessaires.
253 Quand nous avons commencé, nous avons écrit le programme Lilypond
254 entièrement dans le language de programmation C++ ; les fonctions du
255 programme étaient figées par les développeurs. Ceci s'est avéré
256 insatisfaisant pour plusieurs raisons :
259 @item Quand Lilypond fait des erreurs,
260 les utilisateurs ont besoin de contredire les décisions de formatage.
261 Les utilisateurs doivent donc avoir accès au moteur de formatage. Par
262 conséquent, les règles et les propriétés ne peuvent pas être fixées
263 par nous au moment de la compilation, mais doivent être accessibles
264 aux utilisateurs au moment de l'exécution.
266 @item La gravure est une question de jugement visuel, et donc de goût.
267 Aussi bien informés que nous le sommes, les utilisateurs peuvent être
268 en désaccord avec nos décisions personnelles. Par conséquent, les
269 définitions du modèle typographique doivent également être accessibles
272 @item Enfin, nous affinons continuellement les algorithmes de formatage,
273 donc nous avons besoin d'une approche souple des règles. Le language
274 C++ oblige à une certaine méthode de groupage des règles qui ne
275 convient pas bien au fonctionnement de la notation musicale.
278 Ces problèmes ont été résolus en intégrant un interpréteur pour le
279 language de programmation Scheme, et en réécrivant des parties de
280 LilyPond en Scheme. L'architecture actuelle de formatage est
281 construite autour de la notion d'objets graphiques, décrits par des
282 fonctions et des variables Scheme. Cette architecture comprend les
283 règles de formatage, le style typographique, et des décisions
284 individuelles de formatage. L'utilisateur a un accès direct à la
285 plupart de ces contrôles.
287 Les variables Scheme contrôlent les décisions de mise en page. Par
288 exemple, beaucoup d'objets graphiques ont une variable de direction
289 qui encode le choix entre haut et bas (ou gauche et droite). Vous
290 pouvez voir ici deux accords, avec des accents, et des arpèges. Dans
291 le premier accord, les objets graphiques sont tous dirigés vers le bas
292 (ou la gauche). Dans le second accord ils sont tous dirigés vers le
295 @lilypond[quote,ragged-right]
297 \override SpacingSpanner #'spacing-increment = #3
298 \override TimeSignature #'transparent = ##t
300 \stemDown <e g b>4_>-\arpeggio
301 \override Arpeggio #'direction = #RIGHT
302 \stemUp <e g b>4^>-\arpeggio
307 Le processus de formatage d'une partition consiste à lire et écrire
308 les variables d'objets graphiques. Certaines variables ont une valeur
309 prédéfinie. Par exemple, l'épaisseur d'un grand nombre de lignes --
310 une caractéristique du style typographique -- est une variable avec
311 une valeur prédéfinie. Vous êtes libres d'altérer cette valeur, ce
312 qui vous donne une partition avec une impression typographique
315 @lilypond[quote,ragged-right]
318 c'4-~ c'16 as g f e16 g bes c' des'4
323 \override Beam #'thickness = #0.3
324 \override Stem #'thickness = #0.5
325 \override Bar #'thickness = #3.6
326 \override Tie #'thickness = #2.2
327 \override StaffSymbol #'thickness = #3.0
328 \override Tie #'extra-offset = #'(0 . 0.3)
334 Les règles de formatage ont aussi des variables prédéfinies : chaque
335 objet possède des variables contenant des procédures. Ces procédures
336 exécutent le formatage, et en les substituant par d'autres, nous
337 pouvons changer l'apparence des objets. Dans l'exemple suivant, la
338 règle du choix de têtes de notes est changée au cours de l'extrait de
341 @lilypond[quote,ragged-right]
342 #(set-global-staff-size 30)
344 #(define (mc-squared grob orig current)
345 (let* ((interfaces (ly:grob-interfaces grob))
346 (pos (ly:grob-property grob 'staff-position)))
347 (if (memq 'note-head-interface interfaces)
349 (ly:grob-set-property! grob 'stencil ly:text-interface::print)
350 (ly:grob-set-property! grob 'font-family 'roman)
351 (ly:grob-set-property! grob 'text
352 (make-raise-markup -0.5
354 ((-5) (make-simple-markup "m"))
355 ((-3) (make-simple-markup "c "))
356 ((-2) (make-smaller-markup (make-bold-markup "2")))
357 (else (make-simple-markup "bla")))))))))
359 \new Voice \relative c' {
361 \set autoBeaming = ##f
364 \once \override NoteHead #'stencil = #ly:note-head::brew-ez-stencil
365 \once \override NoteHead #'font-size = #-7
366 \once \override NoteHead #'font-family = #'sans
367 \once \override NoteHead #'font-series = #'bold
369 \once \override NoteHead #'style = #'cross
371 \applyOutput #'Voice #mc-squared
374 { d8[ es-( fis^^ g] fis2-) }
375 \repeat unfold 5 { \applyOutput #'Voice #mc-squared s8 }
382 @node What symbols to engrave?
383 @section What symbols to engrave?
388 Le processus de formatage décide où placer les symboles. Cependant,
389 cela ne peut être fait qu'à partir du moment où il a été décidé
390 @emph{quels} symbols doivent être imprimés, c'est-à-dire quelle
393 La notation musicale usuelle est un système d'écriture qui a évolué à
394 travers les dix derniers siècles. La forme qui est aujourd'hui
395 communément utilisée date du début de la Renaissance. Bien que la
396 forme basique --- les têtes de notes sur une portée de cinq lignes ---
397 n'a pas changé, les détails continuent d'évoluer pour exprimer les
398 innovations de la notation contemporaine. Par conséquent, elle
399 comprend quelque 500 ans de musique, avec des applications allant des
400 mélodies monodiques à de monstrueux contrepoints pour grand orchestre.
402 Comment pouvons nous appréhender un tel monstre à plusieurs têtes, et
403 le confiner dans l'espace réduit d'un programme informatique ? Notre
404 solution consiste à diviser le problème de la notation --- par
405 opposition à la gravure, ou typographie --- en morceaux digestes et
406 programmables : chaque type de symbole est géré par un module séparé,
407 couramment appelé greffon@footnote{traduction de l'anglais
408 @emph{plug-in}.}. Chaque greffon est entièrement modulaire et
409 indépendant, et donc peut être développé et amélioré séparément. De
410 tels greffons sont nommées @code{graveur}s@footnote{@code{engraver}s
411 en anglais.}, par analogie avec les artisans qui traduisent les idées
412 musicales en symboles graphiques.
414 Dans l'exemple suivant, voyons comment nous commençons avec un greffon
415 pour les têtes de notes, le graveur de têtes de note
416 (@code{Note_heads_engraver}) :
418 @lilypond[quote,ragged-right]
419 \include "engraver-example.ily"
426 \remove "Stem_engraver"
427 \remove "Phrasing_slur_engraver"
428 \remove "Slur_engraver"
429 \remove "Script_engraver"
430 \remove "Beam_engraver"
431 \remove "Auto_beam_engraver"
435 \remove "Accidental_engraver"
436 \remove "Key_engraver"
437 \remove "Clef_engraver"
438 \remove "Bar_engraver"
439 \remove "Time_signature_engraver"
440 \remove "Staff_symbol_engraver"
441 \consists "Pitch_squash_engraver"
448 Ensuite, le graveur du symbole de portée
449 (@code{Staff_symbol_engraver}) ajoute la portée
451 @lilypond[quote,ragged-right]
452 \include "engraver-example.ily"
459 \remove "Stem_engraver"
460 \remove "Phrasing_slur_engraver"
461 \remove "Slur_engraver"
462 \remove "Script_engraver"
463 \remove "Beam_engraver"
464 \remove "Auto_beam_engraver"
468 \remove "Accidental_engraver"
469 \remove "Key_engraver"
470 \remove "Clef_engraver"
471 \remove "Bar_engraver"
472 \consists "Pitch_squash_engraver"
473 \remove "Time_signature_engraver"
480 le graveur de clef (@code{Clef_engraver}) définit un point de
481 référence pour la portée
483 @lilypond[quote,ragged-right]
484 \include "engraver-example.ily"
491 \remove "Stem_engraver"
492 \remove "Phrasing_slur_engraver"
493 \remove "Slur_engraver"
494 \remove "Script_engraver"
495 \remove "Beam_engraver"
496 \remove "Auto_beam_engraver"
500 \remove "Accidental_engraver"
501 \remove "Key_engraver"
502 \remove "Bar_engraver"
503 \remove "Time_signature_engraver"
510 et le graveur de hampes (@code{Stem_engraver}) ajoute les hampes :
512 @lilypond[quote,ragged-right]
513 \include "engraver-example.ily"
520 \remove "Phrasing_slur_engraver"
521 \remove "Slur_engraver"
522 \remove "Script_engraver"
523 \remove "Beam_engraver"
524 \remove "Auto_beam_engraver"
528 \remove "Accidental_engraver"
529 \remove "Key_engraver"
530 \remove "Bar_engraver"
531 \remove "Time_signature_engraver"
537 Le graveur de hampe est notifié de chaque tête de note qui survient.
538 Chaque fois qu'une tête de note --- plusieurs pour un accord --- est
539 rencontrée, un objet hampe est créé et connecté à la tête de note. En
540 ajoutant des graveurs pour les barres de ligature, les liaisons, les
541 accents, les altérations accidentelles, les barres de mesure, la
542 métrique, et les armures, nous obtenons un jeu de notation complet.
544 @lilypond[quote,ragged-right]
545 \include "engraver-example.ily"
549 Ce système fonctionne bien pour de la musique monodique, mais qu'en
550 est-il de la polyphonie ? En notation polyphonique, plusieurs voix
551 peuvent partager une portée.
553 @lilypond[quote,ragged-right]
554 \include "engraver-example.ily"
555 \new Staff << \topVoice \\ \botVoice >>
558 Dans cette situation, la portée et les altérations accidentelles sont
559 partagées, mais les hampes, liaisons etc., sont spécifiques à chaque
560 voix. Par conséquent, les graveurs doivent être groupés. Les
561 graveurs des têtes de notes, hampes, liaisons etc., vont dans un
562 groupe appelé @qq{contexte de Voix} @footnote{@q{Voice context} en
563 anglais, @q{Voice} commence par une majuscule comme tous les noms de
564 contexte dans le programme LilyPond.}, alors que les graveurs des clés,
565 altérations accidentelles, barres de mesure etc., vont dans un groupe
566 appelé @qq{contexte de Portée}. Dans le cas de la polyphonie, un seul
567 contexte de Portée contient plusieurs contextes de Voix. De même,
568 plusieurs contextes de Portée peuvent être inclus dans un seul
569 contexte de Partition. Le contexte de Partition est le contexte de
570 notation de plus haut niveau.
574 Program reference: @internalsref{Contexts}.
576 @lilypond[quote,ragged-right]
577 \include "engraver-example.ily"
580 \new Staff << \topVoice \\ \botVoice >>
581 \new Staff << \pah \\ \hoom >>
586 @node Music representation
587 @section Music representation
589 Idéalement, le format d'entrée pour n'importe quel système de
590 formatage est une description abstraite du contenu. Dans ce cas-ci,
591 ce serait la musique elle-même. Cela pose un formidable problème :
592 comment pouvons-nous définir ce que la musique est réellement ? Plutôt
593 que d'essayer de trouver une réponse, nous avons renversé la question.
594 Nous écrivons un logiciel capable de produire de la musique écrite, et
595 adaptons le format pour atteindre la plus grande concision possible.
596 Quand le format ne peut plus être simplifé, il nous reste par
597 définition le contenu lui-même. Notre logiciel sert de définition
598 formelle d'un document de musique.
600 La syntaxe est également l'interface utilisateur pour LilyPond, par
601 conséquent il est facile de saisir
608 c'est-à-dire un do central noire et, juste au-dessus un ré croche
610 @lilypond[quote,fragment]
614 Sur une échelle microscopique, une telle syntaxe est facile à
615 utiliser. A plus grande échelle, la syntaxe a besoin aussi de
616 structure. Comment serait-il possible autrement de rentrer des
617 pièces complexes comme des symphonies ou des opéras? La structure
618 est formée par le concept d'expression musicale : en combinant
619 de petits fragments de musique pour en former de plus grands, on peut
620 exprimer de la musique plus complexe. Par exemple
622 @lilypond[quote,verbatim,fragment,relative=1]
627 Des accord peuvent être construits avec @code{<<} et @code{>>} autour
630 @c < > is not a music expression,
631 @c so we use <<>> iso. <> to drive home the point of
632 @c expressions. Don't change this back --hwn.
637 @lilypond[quote,fragment,relative=1]
638 \new Voice { <<c4 d4 e>> }
642 Cette expression est mise dans une séquence en l'encadrant avec des
643 accolades @code{@{@tie{}@dots{}@tie{}@}}
646 @{ f4 <<c4 d4 e4>> @}
649 @lilypond[quote,relative=1,fragment]
654 Ceci est également une expression, et peut donc encore une fois
655 être combinée avec d'autres expressions simultanées (une blanche)
656 en utilisant <<, @code{\\}, et >>
659 << g2 \\ @{ f4 <<c4 d4 e4>> @} >>
662 @lilypond[quote,fragment,relative=2]
663 \new Voice { << g2 \\ { f4 <<c d e>> } >> }
666 De telles strucutres récursives peuvent être spécifiées formellement
667 et de manière ordonnée dans une grammaire indépendante de tout
668 contexte. Le code d'analyse est aussi générée à partir de cette
669 grammaire. Autrement dit, la syntaxe de LilyPond est définie
670 clairement et sans ambiguités.
672 L'interface utilisateur et la syntaxe sont ce que les gens voient et
673 manipulent le plus. Elles sont e npartie une affaire de goût, et
674 aussi sujettes à beaucoup de discussions. Même si ces discussions sur
675 les goûts ont leur mérite, elles ne sont pas très productives. D'un
676 point de vue plus large sur LilyPond, l'importance de la syntaxe est
677 minime : il est facile d'inventer une syntaxe concise, alors qu'écrire
678 un code de formatage décent est beaucoup plus difficile. Ceci est
679 également illustré par le nombre de lignes de codes pour les
680 composants respectifs : l'analyse et la représentation représentent
681 moins de 10% du code source.
683 @node Example applications
684 @section Example applications
686 Nous avons conçu Lilypond comme une expérimentation visant à
687 concentrer l'art de la gravure musicale dans un logiciel. Grâce à
688 tout ce dur labeur, le programme peut maintenant être utilisé pour
689 accomplir des travaux utiles. L'application la plus simple est
690 d'imprimer des notes :
692 @lilypond[quote,relative=1,fragment]
693 \time 2/4 c4 c g'4 g a4 a g2
697 En ajoutant des noms d'accords et des paroles, nous obtenons
698 une partition de chanson :
700 @lilypond[quote,ragged-right]
702 \chords { c2 c f2 c }
703 \new Staff \relative c' { \time 2/4 c4 c g'4 g a4 a g2 }
704 \new Lyrics \lyricmode { twin4 kle twin kle lit tle star2 }
708 La notation polyphonique et la musique pour piano peuvent également
709 être générées. L'exemple suivant associe quelques constructions
712 @lilypondfile[quote,ragged-right]{screech-boink.ly}
714 Les extraits exposés ici ont tous été écrits à la main, mais ce n'est
715 pas une obligation. Puisque le moteur de formatage est en grande
716 partie automatique, il peut servir de sortie pour d'autres programmes
717 qui manipulent la musique. Par exemple, il peut être utilisé pour
718 convertir des bases de données d'extraits musicaux en images pour des
719 sites Internet et des présentations multimédias.
721 Ce manuel montre également une application : le format d'entrée est du
722 texte, et peut donc facilement être intégrés dans d'autres formats
723 basés sur le texte comme @LaTeX{}, HTML, ou dans le cas de ce manuel,
724 Texinfo. À l'aide d'un programme spécial, les extraits de code
725 peuvent être remplacés par des images de musiques dans les fichiers de
726 sortie PDF ou HTML. Cela donne la possibilité de mélanger de la
727 musique et du texte dans les documents.
731 @node About this manual
732 @section About this manual
734 Le manuel est divisé en quatres livres.
736 @subsubheading Manuel d'apprentissage
738 Ce livre explique comment débuter avec LilyPond, et expose de manière
739 simple quelques concepts clés.
747 @emph{@ref{Tutorial}}
748 propose une introduction en douceur à la typographie musicale.
749 Les utilisateurs débutants sont invités à commencer ici.
752 @emph{@ref{Putting it all together}}
753 explique des concepts généraux du format de ficheir ly. Si vous n'êtes
754 pas certain de l'endroit où placer une commande, lisez ce chapitre !
757 @emph{@ref{Working on LilyPond projects}}
758 montre des utilisations pratiques de LilyPond et donne des conseils
759 afin d'éviter les problèmes les plus courants.
762 @emph{@ref{Tweaking output}}
763 est une introduction aux retouches de gravure avec LilyPond.
768 @subsubheading Manuel de référence
770 Ce livre détaille toutes les commandes LilyPond produisant une notation
771 musicale. La lecture de ce livre requiert une bonne compréhension des
772 concepts exposés dans le manuel d'apprentissage.
777 @emph{@ref{Basic notation}}
778 traite de sujets groupés par type de notation. Cette section
779 détaille la notation de base, qui sera utile dans la plupart des
780 projets de partition.
783 @emph{@ref{Instrument-specific notation}}
784 traite de sujets groupés par type de notation. Cette section détaille
785 des notations spéciales qui ne seront utiles que pour des types
786 particuliers d'instruments ou la voix.
789 @emph{@ref{Advanced notation}}
790 traite de sujets groupés par type de notation. Cette section
791 donne des précisions à propos de notations compliquées et
795 @emph{@ref{Changing defaults}}
796 explique comment ajuster finement la mise en page.
799 @emph{@ref{Non-musical notation}}
800 traite de sorties non musicales comme les titres, les mouvements
801 multiples, et la sélection des instruments MIDI.
804 @emph{@ref{Spacing issues}}
805 traite de sujets affectant la sortie globale, comme sélectionner
806 la taille de papier ou spécifier les sauts de page.
809 @emph{@ref{Interfaces for programmers}}
810 explique comment créer des fonctions de musique.
815 @subsubheading Utilisation du programme
817 Ce livre explique comment exécuter le programme et comment intégrer les
818 partitions LilyPond dans d'autres programmes.
823 @emph{@ref{Running LilyPond}}
824 montre comment lancer LilyPond et ses programmes auxiliaires. De
825 plus, cette section explique comment mettre à jour des fichiers
826 source écrits pour d'anciennes versions de LilyPond.
829 @emph{@ref{LilyPond-book}}
830 explique comment créer des documents intégrant des exemples musicaux,
834 @emph{@ref{Converting from other formats}}
835 explique comment exécuter les programmes de conversion. Ces programmes
836 sont livrés avec le paquetage Lilypond, et convertissent une variété
837 de formats musicaux vers le format @code{.ly}.
842 @subsubheading Annexes
844 Ce livre contient des tables de référence pratiques.
852 @emph{@ref{Literature list}}
853 contient un choix de livres de référence utiles pour ceux qui veulent
854 en savoir plus sur la notation et la gravure.
858 @emph{@ref{Scheme tutorial}}
859 propose une courte introduction à Scheme, le langage de programmation
860 utilisé dans les fonctions de musique.
866 @emph{@ref{Notation manual tables}}
867 sont un ensemble de tableaux montrant les noms d'accord, les
868 instruments MIDI, les noms de couleur, et la police Feta.
872 @emph{@ref{Templates}}
873 de pièces LilyPond. Copiez et collez un modèle
874 dans un fichier, ajoutez les notes, et c'est prêt !
878 @emph{@ref{Cheat sheet}}
879 est une référence pratique des commandes LilyPond les plus courantes.
883 @emph{@ref{LilyPond command index}}
884 est un index de toutes les @code{\commandes} LilyPond.
888 @emph{@ref{LilyPond index}}
889 est un index complet.
893 @subsubheading Autre documentation
895 D'autres documents constituent de précieuses sources d'information.
900 @cindex langues étrangères
904 Le glossaire de musique explique les termes musicaux, et inclut
905 les traductions vers divers languages. C'est un document séparé,
906 disponible aux formats HTML et PDF.
909 Le @ref{Top,glossaire musical,,music-glossary} explique les termes
910 musicaux et inclut les traductions vers divers languages. Il est
911 également disponible au format PDF.
913 Si vous n'êtes pas familier avec la notation musicale ou la
914 terminologie, il est conseillé de consulter le glossaire, notamment
915 pour les parties non encore traduites de la documentation.
917 @cindex exemples de code
922 @uref{source/input/lsr/collated-files.html,Exemples de code}
927 sont une vaste sélection de petits exemples montrant des trucs, astuces
928 et fonctionnalités particulières de LilyPond. La plupart de ces
929 exemples sont également disponibles sur le
930 @uref{http://lsr.dsi.unimi.it/,LilyPond Snippet Repository}. Ce site
931 Web possède également le manuel de LilyPond avec une fonctionnalité de
937 référence du programme
940 @ref{Top,référence du programme,,lilypond-internals}.
942 est un ensemble de pages HTML étroitement liées entre elles, qui
943 documente les moindres petits détails de chaque classe, objet et
944 fonction de LilyPond. Cette documentation est produite directement à
945 partir des définitions de formatage utilisées.
947 Presque toutes les fonctions de formatage utilisées en interne sont
948 directement disponibles pour l'utilisateur. Par exemple, toutes les
949 variables qui contrôlent les épaisseurs, les distances etc., peuvent
950 être modifiées dans les fichiers d'entrée. Il y a un grand nombre
951 d'options de formatage, et elles sont toutes décrites dans ce
952 document. Chaque section du manuel de notation a une section @b{Voir
953 aussi} qui réfère à la documentation générée automatiquement. Dans la
954 documentation au format HTML, ces sous-sections ont des liens
959 Lorsque vous serez un utilisateur expérimenté, vous pourrez consulter le
960 manuel comme une référence : il y a un index complet@footnote{Si vous
961 cherchez quelque chose sans le trouver dans la documentation, c'est un
962 bogue. Dans ce cas, merci d'envoyer un rapport de bogue.}, mais le
963 manuel est aussi disponible en
965 une seule grande page,
968 @uref{source/Documentation/user/lilypond-big-page.html, une seule grande
971 ce qui facilite la recherche avec la fonction de recherche de votre
974 Dans tous les documents HTML qui incluent des fragments musicaux,
975 le code Lilypond utilisé pour produire l'image peut être vu en
978 L'emplacement des fichiers de documentation mentionné ici peut varier
979 d'un système à l'autre. De temps en temps, ce manuel fait référence aux
980 fichiers d'exemple et d'initialisation. Tout au long de ce manuel, nous
981 donnons les emplacements des fichiers d'entrée relativement au
982 répértoire racine de l'archive source. Par exemple,
983 @file{input/@/test/@/bla@/.ly} peut référer au fichier
984 @file{lilypond@/2.x.y/@/input/@/test/@/bla@/.ly}. Dans les paquets
985 binaires pour les plateformes Unix, la documentation et les exemples se
986 trouvent généralement sous @file{/usr/@/share/@/doc/@/lilypond/}. Les
987 fichiers d'initialisation, par exemple @file{scm/@/lily@/.scm}, ou
988 @file{ly/@/engraver@/-init@/.ly}, se trouvent généralement dans le
989 répértoire @file{/usr/@/share/@/lilypond/}.
994 @cindex lilypond-internals
995 @cindex documentation du fonctionnement interne
997 @cindex étendre lilypond
1000 Pour finir, ce manuel et les autres sont disponibles en ligne, à la
1001 fois aux formats PDF et HTML, à partir du site Web, accessible
1002 à l'adresse @uref{http://@/www@/.lilypond@/.org/}.