1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
2 @c This file is part of lilypond-kearning.tely
4 Translation of GIT committish: 27af34a245b02a6b89c9af3becefcfe676b2e19d
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. See TRANSLATION for details.
12 @c Translators: Ludovic Sardain, John Mandereau
13 @c Translation checkers: Jean-Charles Malahieude, Jean-Yves Baudais
19 Ce chapitre constitue une première présentation de LilyPond et de sa
24 * About the documentation::
31 Cette partie présente les objectifs de LilyPond ainsi que son
36 * Automated engraving::
37 * What symbols to engrave?::
38 * Music representation::
39 * Example applications::
44 @unnumberedsubsec Engraving
46 L'art de la typographie musicale se nomme la @emph{gravure}. Ce terme
47 est issu du processus traditionnel d'impression musicale. Il y a
48 seulement quelques dizaines d'années, on faisait les partitions en
49 coupant et en embossant une plaque de zinc ou d'étain en image miroir.
50 Cette plaque était ensuite encrée, les dépressions créées par les
51 creux et les bosses retenant l'encre. Une image était formée en
52 pressant du papier sur la plaque. La découpe et l'embossage étaient
53 entièrement faits à la main. Il était pénible d'appliquer une
54 correction, quand celle-ci n'était pas impossible, la gravure devait
55 donc être parfaite du premier coup. La gravure demandait une
56 qualification hautement spécialisée : un artisan devait accomplir
57 environ cinq ans de formation avant de mériter le titre de maître
58 graveur, et il lui fallait cinq années d'expérience supplémentaires
59 pour devenir vraiment habile.
61 De nos jours, toutes les partitions récentes sont produites avec des
62 ordinateurs. Ceci a des avantages évidents : le coût des impressions
63 a diminué, et le travail d'éditeur peut être envoyé par courriel.
64 Malheureusement, l'utilisation dominante des ordinateurs a également
65 diminué la qualité graphique des partitions. L'impression
66 informatisée leur donne un aspect fade et mécanique qui les rend
69 @c introduce illustrating aspects of engraving, font...
70 Les images ci-dessous illustrent la différence entre la gravure
71 traditionelle et l'impression typique par ordinateur, et la troisème
72 image montre comment LilyPond mime l'aspect traditionnel. L'image de
73 gauche est une numérisation d'un symbole bémol d'une édition publiée
74 en 2000. Celle du centre montre un bémol d'une gravure à la main de
75 l'édition Bärenreiter de la même musique. L'image de gauche illustre
76 des défauts typiques de l'impression informatique : les lignes de
77 portée sont minces, l'épaisseur de trait du bémol est la même que les
78 lignes fines, et il y a un aspect rigide avec des angles pointus. Par
79 contraste, le bémol Bärenreiter possède un aspect gras et arrondi,
80 presque voluptueux. Notre symbole bémol est créé, entre autres, à
81 partir de celui-là. Il est arrondi, et son épaisseur de trait
82 s'harmonise avec nos lignes de portée, lesquelles sont également plus
83 épaisses que celles de l'édition informatique.
85 @multitable @columnfractions .125 .25 .25 .25 .125
89 @image{henle-flat-gray,,4cm}
92 @image{henle-flat-gray,,,png}
97 @image{baer-flat-gray,,4cm}
100 @image{baer-flat-gray,,,png}
105 @image{lily-flat-bw,,4cm}
108 @image{lily-flat-bw,,,png}
112 @image{lilypond/henle-flat-bw,,,png} @image{lilypond/baer-flat-bw,,,png}
113 @image{lilypond/lily-flat-bw,,,png}
121 Fonte Feta de LilyPond (2003)
126 @cindex symboles musicaux
129 @cindex épaisseur des caractères
132 @c introduce illustrating aspects of engraving, spacing...
133 En matière d'espacement, la répartition de l'espace devrait refléter
134 les durées entre les notes. Cependant, beaucoup de partitions
135 modernes se contentent des durées avec une précision mathématique, ce
136 qui mène à de mauvais résultats. Dans l'exemple suivant, un motif est
137 imprimé deux fois : une fois en utilisant un espacement mathématique
138 exact, et une autre fois avec des corrections. Pouvez-vous les
141 @cindex espacement optique
142 @c file spacing-optical.
143 @c need to include it here, because we want two images.
164 \override NoteSpacing #'stem-spacing-correction = #0.6
189 \override NoteSpacing #'stem-spacing-correction = #0.0
190 \override NoteSpacing #'same-direction-correction = #0.0
191 \override StaffSpacing #'stem-spacing-correction = #0.0
197 @cindex régulier, rythme
198 @cindex régulier, espacement
199 @cindex espacement régulier
201 L'extrait n'utilise que des notes de même durée ; l'espacement devrait
202 le refléter. Malheureusement, notre oeil nous trompe quelque peu ; il
203 ne se contente pas de remarquer la distance entre les têtes de notes,
204 il prend en compte également la distance entre les hampes
205 consécutives. Ainsi, par compensation, les notes avec une combinaison
206 @qq{hampe vers le haut}/@/@qq{hampe vers le bas} doivent être éloignées
207 l'une de l'autre, et les notes avec une combinaison @qq{hampe vers le
208 bas}/@/@qq{hampe vers le haut} rapprochées, le tout dépendant de la
209 position verticale des notes. Les deux premières mesures sont
210 imprimées avec cette correction, les deux suivantes sans. Les notes
211 dans les deux dernières mesures forment des blocs de notes @qq{hampe
212 vers le bas}/@/@qq{hampe vers le haut}.
216 Les musiciens sont généralement plus absorbés par l'exécution que par
217 l'étude de l'aspect graphique d'une partition, donc discutailler sur
218 les détails typographiques peut paraître peu important. Il n'en est
219 rien. Dans de longues pièces avec des rythmes monotones, les
220 corrections d'espacement engendrent de subtiles variations dans la
221 mise en forme de chaque ligne, donnant à chacune une signature
222 visuelle distincte. Sans cette signature, toutes les lignes auraient
223 le même aspect, et ressembleraient à un labyrinthe. Si un musicien
224 regarde ailleurs un instant ou se déconcentre momentanement, il peut
225 avoir du mal à se retrouver sur la page.
227 De même, l'aspect robuste des symboles sur d'épaisses lignes de
228 portée ressort mieux quand la partition est éloignée du lecteur,
229 comme sur un pupitre par exemple. Une organisation minutieuse des
230 espaces vides permet de minimiser l'espace qu'occupe la musique, tout
231 en évitant que les symboles s'amassent les uns contre les autres. Le
232 résultat permet de réduire le nombre de pages à tourner, ce qui est un
235 Ceci est une caractéristique commune à toute typographie. La
236 disposition doit être belle, non seulement pour des raisons
237 esthétiques, mais également pour l'aide apportée au lecteur dans la
238 tâche qu'il doit accomplir. Pour du matériel d'exécution comme les
239 partitions de musique, cela prend une double importance : les
240 musiciens ont une quantité limitée d'attention. Moins ils en ont
241 besoin pour lire, plus ils peuvent se concentrer sur la musique
242 elle-même. Autrement dit, une meilleure typographie permet une
243 meilleure interprétation.
245 Ces exemples démontrent que la typographie musicale est un art subtil
246 et complexe, et que la produire demande une expertise considérable,
247 que les musiciens n'ont généralement pas. LilyPond représente notre
248 effort pour apporter l'excellence graphique de la gravure à la main à
249 l'ère de l'ordinateur, et la rendre accessible à tous les musiciens.
250 Nous avons conçu nos algorithmes, fontes et paramètres de programme
251 pour retrouver la qualité d'édition des anciennes partitions que nous
252 aimons tant lire et jouer.
256 @node Automated engraving
257 @unnumberedsubsec Automated engraving
259 Comment pouvons-nous implémenter la typographie ? Si les artisans ont
260 besoin de plus de dix ans pour devenir de vrais maîtres, comment nous,
261 simples programmeurs, pourrions-nous jamais écrire un programme pour
264 La réponse est : nous ne le pouvons pas. La typographie se base sur
265 le jugement visuel humain, donc les humains ne peuvent pas être
266 complètement remplacés. Si LilyPond arrive à résoudre la plupart des
267 situations correctement, ce sera déjà une grande avancée sur les
268 logiciels existants. Les autres situations peuvent être résolues à la
269 main. Au fil des ans, le logiciel peut être affiné pour faire de plus
270 en plus de choses automatiquement, pour que les ajustements manuels
271 soient de moins en moins nécessaires.
273 Quand nous avons commencé, nous avons écrit le programme Lilypond
274 entièrement dans le language de programmation C++ ; les fonctions du
275 programme étaient figées par les développeurs. Ceci s'est avéré
276 insatisfaisant pour plusieurs raisons :
279 @item Quand Lilypond fait des erreurs,
280 les utilisateurs ont besoin de contredire les décisions de formatage.
281 Les utilisateurs doivent donc avoir accès au moteur de formatage. Par
282 conséquent, les règles et les propriétés ne peuvent pas être fixées
283 par nous au moment de la compilation, mais doivent être accessibles
284 aux utilisateurs au moment de l'exécution.
286 @item La gravure est une question de jugement visuel, et donc de goût.
287 Aussi bien informés que nous le sommes, les utilisateurs peuvent être
288 en désaccord avec nos décisions personnelles. Par conséquent, les
289 définitions du modèle typographique doivent également être accessibles
292 @item Enfin, nous affinons continuellement les algorithmes de formatage,
293 donc nous avons besoin d'une approche souple des règles. Le language
294 C++ oblige à une certaine méthode de groupage des règles qui ne
295 convient pas bien au fonctionnement de la notation musicale.
298 Ces problèmes ont été résolus en intégrant un interpréteur pour le
299 language de programmation Scheme, et en réécrivant des parties de
300 LilyPond en Scheme. L'architecture actuelle de formatage est
301 construite autour de la notion d'objets graphiques, décrits par des
302 fonctions et des variables Scheme. Cette architecture comprend les
303 règles de formatage, le style typographique, et des décisions
304 individuelles de formatage. L'utilisateur a un accès direct à la
305 plupart de ces contrôles.
307 Les variables Scheme contrôlent les décisions de mise en page. Par
308 exemple, beaucoup d'objets graphiques ont une variable de direction
309 qui encode le choix entre haut et bas (ou gauche et droite). Vous
310 pouvez voir ici deux accords, avec des accents, et des arpèges. Dans
311 le premier accord, les objets graphiques sont tous dirigés vers le bas
312 (ou la gauche). Dans le second accord ils sont tous dirigés vers le
315 @lilypond[quote,ragged-right]
317 \override SpacingSpanner #'spacing-increment = #3
318 \override TimeSignature #'transparent = ##t
320 \stemDown <e g b>4_>-\arpeggio
321 \override Arpeggio #'direction = #RIGHT
322 \stemUp <e g b>4^>-\arpeggio
327 Le processus de formatage d'une partition consiste à lire et écrire
328 les variables d'objets graphiques. Certaines variables ont une valeur
329 prédéfinie. Par exemple, l'épaisseur d'un grand nombre de lignes --
330 une caractéristique du style typographique -- est une variable avec
331 une valeur prédéfinie. Vous êtes libres d'altérer cette valeur, ce
332 qui vous donne une partition avec une impression typographique
335 @lilypond[quote,ragged-right]
338 c'4-~ c'16 as g f e16 g bes c' des'4
343 \override Beam #'thickness = #0.3
344 \override Stem #'thickness = #0.5
345 \override Bar #'thickness = #3.6
346 \override Tie #'thickness = #2.2
347 \override StaffSymbol #'thickness = #3.0
348 \override Tie #'extra-offset = #'(0 . 0.3)
354 Les règles de formatage ont aussi des variables prédéfinies : chaque
355 objet possède des variables contenant des procédures. Ces procédures
356 exécutent le formatage, et en les substituant par d'autres, nous
357 pouvons changer l'apparence des objets. Dans l'exemple suivant, la
358 règle du choix de têtes de notes est changée au cours de l'extrait de
361 @lilypond[quote,ragged-right]
362 #(set-global-staff-size 30)
364 #(define (mc-squared grob orig current)
365 (let* ((interfaces (ly:grob-interfaces grob))
366 (pos (ly:grob-property grob 'staff-position)))
367 (if (memq 'note-head-interface interfaces)
369 (ly:grob-set-property! grob 'stencil ly:text-interface::print)
370 (ly:grob-set-property! grob 'font-family 'roman)
371 (ly:grob-set-property! grob 'text
372 (make-raise-markup -0.5
374 ((-5) (make-simple-markup "m"))
375 ((-3) (make-simple-markup "c "))
376 ((-2) (make-smaller-markup (make-bold-markup "2")))
377 (else (make-simple-markup "bla")))))))))
379 \new Voice \relative c' {
381 \set autoBeaming = ##f
384 \once \override NoteHead #'stencil = #ly:note-head::brew-ez-stencil
385 \once \override NoteHead #'font-size = #-7
386 \once \override NoteHead #'font-family = #'sans
387 \once \override NoteHead #'font-series = #'bold
389 \once \override NoteHead #'style = #'cross
391 \applyOutput #'Voice #mc-squared
394 { d8[ es-( fis^^ g] fis2-) }
395 \repeat unfold 5 { \applyOutput #'Voice #mc-squared s8 }
402 @node What symbols to engrave?
403 @unnumberedsubsec What symbols to engrave?
408 Le processus de formatage décide où placer les symboles. Cependant,
409 cela ne peut être fait qu'à partir du moment où il a été décidé
410 @emph{quels} symboles doivent être imprimés, c'est-à-dire quelle
413 La notation musicale usuelle est un système d'écriture qui a évolué à
414 travers les dix derniers siècles. La forme qui est aujourd'hui
415 communément utilisée date du début de la Renaissance. Bien que la forme
416 basique --- les têtes de notes sur une portée de cinq lignes --- n'a pas
417 changé, les détails continuent d'évoluer pour exprimer les innovations
418 de la notation contemporaine. Par conséquent, elle comprend quelque 500
419 ans de musique, avec des applications allant des mélodies monodiques à
420 de monstrueux contrepoints pour grand orchestre.
422 Comment pouvons nous appréhender un tel monstre à plusieurs têtes, et le
423 confiner dans l'espace réduit d'un programme informatique ? Notre
424 solution consiste à diviser le problème de la notation --- par
425 opposition à la gravure, ou typographie --- en morceaux digestes et
426 programmables : chaque type de symbole est géré par un module séparé,
427 couramment appelé greffon@footnote{traduction de l'anglais
428 @emph{plug-in}.}. Chaque greffon est entièrement modulaire et
429 indépendant, et donc peut être développé et amélioré séparément. De
430 tels greffons sont nommés @code{graveur}s@footnote{@code{engraver}s en
431 anglais.}, par analogie avec les artisans qui traduisent les idées
432 musicales en symboles graphiques.
434 Dans l'exemple suivant, voyons comment nous commençons avec un greffon
435 pour les têtes de notes, le graveur de têtes de note
436 (@code{Note_heads_engraver}) :
438 @lilypond[quote,ragged-right]
439 \include "engraver-example.ily"
446 \remove "Stem_engraver"
447 \remove "Phrasing_slur_engraver"
448 \remove "Slur_engraver"
449 \remove "Script_engraver"
450 \remove "Beam_engraver"
451 \remove "Auto_beam_engraver"
455 \remove "Accidental_engraver"
456 \remove "Key_engraver"
457 \remove "Clef_engraver"
458 \remove "Bar_engraver"
459 \remove "Time_signature_engraver"
460 \remove "Staff_symbol_engraver"
461 \consists "Pitch_squash_engraver"
468 Ensuite, le graveur du symbole de portée
469 (@code{Staff_symbol_engraver}) ajoute la portée
471 @lilypond[quote,ragged-right]
472 \include "engraver-example.ily"
479 \remove "Stem_engraver"
480 \remove "Phrasing_slur_engraver"
481 \remove "Slur_engraver"
482 \remove "Script_engraver"
483 \remove "Beam_engraver"
484 \remove "Auto_beam_engraver"
488 \remove "Accidental_engraver"
489 \remove "Key_engraver"
490 \remove "Clef_engraver"
491 \remove "Bar_engraver"
492 \consists "Pitch_squash_engraver"
493 \remove "Time_signature_engraver"
500 le graveur de clef (@code{Clef_engraver}) définit un point de
501 référence pour la portée
503 @lilypond[quote,ragged-right]
504 \include "engraver-example.ily"
511 \remove "Stem_engraver"
512 \remove "Phrasing_slur_engraver"
513 \remove "Slur_engraver"
514 \remove "Script_engraver"
515 \remove "Beam_engraver"
516 \remove "Auto_beam_engraver"
520 \remove "Accidental_engraver"
521 \remove "Key_engraver"
522 \remove "Bar_engraver"
523 \remove "Time_signature_engraver"
530 et le graveur de hampes (@code{Stem_engraver}) ajoute les hampes :
532 @lilypond[quote,ragged-right]
533 \include "engraver-example.ily"
540 \remove "Phrasing_slur_engraver"
541 \remove "Slur_engraver"
542 \remove "Script_engraver"
543 \remove "Beam_engraver"
544 \remove "Auto_beam_engraver"
548 \remove "Accidental_engraver"
549 \remove "Key_engraver"
550 \remove "Bar_engraver"
551 \remove "Time_signature_engraver"
558 Le graveur de hampe est notifié de chaque tête de note qui survient.
559 Chaque fois qu'une tête de note --- plusieurs pour un accord --- est
560 rencontrée, un objet hampe est créé et connecté à la tête de note. En
561 ajoutant des graveurs pour les barres de ligature, les liaisons, les
562 accents, les altérations accidentelles, les barres de mesure, la
563 métrique, et les armures, nous obtenons un jeu de notation complet.
565 @lilypond[quote,ragged-right]
566 \include "engraver-example.ily"
570 Ce système fonctionne bien pour de la musique monodique, mais qu'en
571 est-il de la polyphonie ? En notation polyphonique, plusieurs voix
572 peuvent partager une portée.
574 @lilypond[quote,ragged-right]
575 \include "engraver-example.ily"
576 \new Staff << \topVoice \\ \botVoice >>
579 Dans cette situation, la portée et les altérations accidentelles sont
580 partagées, mais les hampes, liaisons etc., sont spécifiques à chaque
581 voix. Par conséquent, les graveurs doivent être groupés. Les
582 graveurs des têtes de notes, hampes, liaisons etc., vont dans un
583 groupe appelé @qq{contexte de Voix} @footnote{@q{Voice context} en
584 anglais, @q{Voice} commence par une majuscule comme tous les noms de
585 contexte dans le programme LilyPond.}, alors que les graveurs des clés,
586 altérations accidentelles, barres de mesure etc., vont dans un groupe
587 appelé @qq{contexte de Portée}. Dans le cas de la polyphonie, un seul
588 contexte de Portée contient plusieurs contextes de Voix. De même,
589 plusieurs contextes de Portée peuvent être inclus dans un seul
590 contexte de Partition. Le contexte de Partition est le contexte de
591 notation de plus haut niveau.
595 Program reference: @rinternals{Contexts}.
597 @lilypond[quote,ragged-right]
598 \include "engraver-example.ily"
601 \new Staff << \topVoice \\ \botVoice >>
602 \new Staff << \pah \\ \hoom >>
607 @node Music representation
608 @unnumberedsubsec Music representation
610 Idéalement, le format d'entrée pour n'importe quel système de
611 formatage est une description abstraite du contenu. Dans ce cas-ci,
612 ce serait la musique elle-même. Cela pose un formidable problème :
613 comment pouvons-nous définir ce que la musique est réellement ? Plutôt
614 que d'essayer de trouver une réponse, nous avons renversé la question.
615 Nous écrivons un logiciel capable de produire de la musique écrite, et
616 adaptons le format pour atteindre la plus grande concision possible.
617 Quand le format ne peut plus être simplifé, il nous reste par
618 définition le contenu lui-même. Notre logiciel sert de définition
619 formelle d'un document de musique.
621 La syntaxe est également l'interface utilisateur pour LilyPond, par
622 conséquent il est facile de saisir
631 c'est-à-dire un do central noire et, juste au-dessus un ré croche
639 Sur une échelle microscopique, une telle syntaxe est facile à
640 utiliser. A plus grande échelle, la syntaxe a besoin aussi de
641 structure. Comment serait-il possible autrement de rentrer des
642 pièces complexes comme des symphonies ou des opéras ? La structure
643 est formée par le concept d'expression musicale : en combinant
644 de petits fragments de musique pour en former de plus grands, on peut
645 exprimer de la musique plus complexe. Par exemple
647 @lilypond[quote,verbatim,fragment,relative=1]
652 Des accord peuvent être construits avec @code{<<} et @code{>>} autour
655 @c < > is not a music expression,
656 @c so we use <<>> iso. <> to drive home the point of
657 @c expressions. Don't change this back --hwn.
659 @c FIXME: change this. I can explain it better. -gp
664 @lilypond[quote,fragment,relative=1]
665 \new Voice { <<c4 d4 e>> }
669 Cette expression est mise dans une séquence grace à l'encadrement par
670 des accolades @code{@{@tie{}@dots{}@tie{}@}}
673 @{ f4 <<c4 d4 e4>> @}
676 @lilypond[quote,relative=1,fragment]
681 Ceci est également une expression, et peut donc encore une fois
682 être combinée avec d'autres expressions simultanées (une blanche)
683 en utilisant <<, @code{\\}, et >>
686 << g2 \\ @{ f4 <<c4 d4 e4>> @} >>
689 @lilypond[quote,fragment,relative=2]
690 \new Voice { << g2 \\ { f4 <<c d e>> } >> }
693 De telles strucutres récursives peuvent être spécifiées formellement
694 et de manière ordonnée dans une grammaire indépendante de tout
695 contexte. Le code d'analyse est aussi générée à partir de cette
696 grammaire. Autrement dit, la syntaxe de LilyPond est définie
697 clairement et sans ambiguité.
699 L'interface utilisateur et la syntaxe sont ce que les gens voient et
700 manipulent le plus. Elles sont en partie une affaire de goût, et
701 aussi sujettes à beaucoup de discussions. Même si ces discussions sur
702 les goûts ont leur mérite, elles ne sont pas très productives. D'un
703 point de vue plus large sur LilyPond, l'importance de la syntaxe est
704 minime : il est facile d'inventer une syntaxe concise, alors qu'écrire
705 un code de formatage décent est beaucoup plus difficile. Ceci est
706 également illustré par le nombre de lignes de codes pour les
707 composants respectifs : l'analyse et la représentation constituent
708 moins de 10% du code source.
710 @node Example applications
711 @unnumberedsubsec Example applications
713 Nous avons conçu LilyPond comme une expérimentation visant à
714 concentrer l'art de la gravure musicale dans un logiciel. Grâce à
715 tout ce dur labeur, le programme peut maintenant être utilisé pour
716 accomplir des travaux utiles. L'application la plus simple est
717 d'imprimer des notes :
719 @lilypond[quote,relative=1]
727 En ajoutant des noms d'accords et des paroles, nous obtenons
728 une partition de chanson :
730 @lilypond[quote,ragged-right]
732 \chords { c2 c f2 c }
733 \new Staff \relative c' { \time 2/4 c4 c g'4 g a4 a g2 }
734 \new Lyrics \lyricmode { twin4 kle twin kle lit tle star2 }
738 La notation polyphonique et la musique pour piano peuvent également
739 être générées. L'exemple suivant associe quelques constructions
742 @lilypondfile[quote,ragged-right]{screech-boink.ly}
744 Les extraits exposés ici ont tous été écrits à la main, mais ce n'est
745 pas une obligation. Puisque le moteur de formatage est en grande
746 partie automatique, il peut servir de sortie pour d'autres programmes
747 qui manipulent la musique. Par exemple, il peut être utilisé pour
748 convertir des bases de données d'extraits musicaux en images pour des
749 sites Internet et des présentations multimédias.
751 Ce manuel montre également une application : le format d'entrée est du
752 texte, et peut donc facilement être intégré dans d'autres formats
753 basés sur le texte comme @LaTeX{}, HTML, ou dans le cas de ce manuel,
754 Texinfo. À l'aide d'un programme spécial, les extraits de code
755 peuvent être remplacés par des images de musiques dans les fichiers de
756 sortie PDF ou HTML. Cela donne la possibilité de mélanger de la
757 musique et du texte dans les documents.
761 @node About the documentation
762 @section About the documentation
764 Cette partie présente les différents volumes de la documentation.
766 @c leave these lines wrapping around. It's some texinfo 4.12 thing. -gp
768 * About the Learning Manual (LM):: introduction à LilyPond, ce volume
769 explique en profondeur comment créer de la notation.
771 * About the Music Glossary (MG):: ce volume explique de nombreux termes
772 musicaux et en donne la traduction dans d'autres langues.
774 * About the Notation Reference (NR):: ce volume représente le cœur de
775 la documentation. Il fournit des informations détaillées sur la
776 manière de créer de la notation. La lecture de cet ouvrage requiert
777 une bonne compréhension des concepts exposés dans le manuel
780 * About the Application Usage (AU):: ce volume traite des différentes
781 composantes de LilyPond ainsi que des particularités selon les
784 * About the Snippet List (SL):: ce volume constitue une collection
785 d'extraits réalisés avec LilyPond.
787 * About the Internals Reference (IR):: ce volume est la source
788 d'information sur le fonctionnement interne de LilyPond. Il constitue
789 la base des ressources nécessaires à l'élaboration de retouches.
791 * Other documentation:: d'autres sources de documentation sont
792 disponibles, telles que les notes d'actualité et les archives des
798 @node About the Learning Manual (LM)
799 @unnumberedsubsec About the Learning Manual (LM)
801 Ce volume explique comment débuter avec LilyPond, et expose de manière
802 simple quelques concepts clés. Il est conseillé de lire ces chapitres
809 le pourquoi du comment de LilyPond.
813 introduction en douceur à la typographie musicale.
814 Les utilisateurs débutants sont invités à commencer ici.
817 @ref{Fundamental concepts} :
818 concepts généraux du format de fichier @code{ly} spécifique à
819 LilyPond. Si vous n'êtes pas certain de l'endroit où placer une
820 commande, lisez ce chapitre !
823 @ref{Tweaking output} :
824 introduction aux retouches de gravure avec LilyPond.
827 @ref{Working on LilyPond projects} :
828 utilisations pratiques de LilyPond, et conseils
829 afin d'éviter les problèmes les plus courants. À lire absolument avant
830 de se lancer dans des travaux d'envergure.
834 Ce volume contient aussi des annexes que vous pouvez consulter au gré de
841 de pièces LilyPond. Copiez et collez un modèle
842 dans un fichier, ajoutez les notes, et c'est prêt !
845 @ref{Scheme tutorial} :
846 courte introduction à Scheme, le langage de programmation
847 utilisé dans les fonctions de musique. Ces quelques lignes vous
848 aideront à construire des retouches avancées ; nombre d'utilisateurs n'ont
849 jamais touché à Scheme.
854 @node About the Music Glossary (MG)
855 @unnumberedsubsec About the Music Glossary (MG)
860 @cindex langues étrangères
864 @ref{Top,Music Glossary,,music-glossary} : explication des termes
865 musicaux et traduction dans diverses langues. Il est
866 également disponible au format PDF.
867 Si vous n'êtes pas familier avec la notation musicale ou la
868 terminologie, il est conseillé de consulter le glossaire, notamment
869 pour les parties non encore traduites de la documentation.
874 @node About the Notation Reference (NR)
875 @unnumberedsubsec About the Notation Reference (NR)
877 Ce volume détaille toutes les commandes LilyPond produisant une notation
878 musicale. La lecture de cet ouvrage requiert une bonne compréhension des
879 concepts exposés dans le manuel d'apprentissage.
884 @ruser{Musical notation} :
885 sujets groupés par type de notation. Cette partie
886 détaille la notation de base, qui sera utile dans la plupart des
887 projets de partition.
890 @ruser{Specialist notation} :
891 sujets groupés par type de notation. Cette partie détaille
892 des spécificités concernant certains instruments ou la voix.
895 @ruser{Input syntax} :
896 informations généralistes quant aux fichiers LilyPond et
897 comment contrôler les sorties.
900 @ruser{Spacing issues} :
901 sujets affectant la sortie globale, comme sélectionner
902 la taille de papier ou spécifier les sauts de page.
905 @ruser{Changing defaults} :
906 comment, grace aux retouches, obtenir de Lilypond
907 presque tout ce que vous désirez.
910 @ruser{Interfaces for programmers} :
911 comment créer des fonctions de musique à l'aide de Scheme.
915 Ce volume contient aussi des annexes que vous pouvez consulter au gré de
921 @ruser{Literature list} :
922 choix de livres de référence utiles pour ceux qui veulent
923 en savoir plus sur la notation et la gravure.
926 @ruser{Notation manual tables} :
927 ensemble de tableaux montrant les noms d'accord, les
928 instruments MIDI, les noms de couleur, et la police Feta.
931 @ruser{Cheat sheet} :
932 référence pratique des commandes LilyPond les plus courantes.
935 @ruser{LilyPond command index} :
936 index de toutes les @code{\commandes} LilyPond.
939 @ruser{LilyPond index} :
944 @node About the Application Usage (AU)
945 @unnumberedsubsec About the Application Usage (AU)
947 Ce volume explique l'exécution du programme et l'intégration de
948 partitions LilyPond dans d'autres programmes.
954 comment installer de LilyPond, et pour ceux que cela intéresse,
959 comment configurer votre ordinateur pour une utilisation optimale
960 de LilyPond, y compris avec certains éditeurs de tecte.
963 @rprogram{Running LilyPond} :
964 comment lancer LilyPond et ses programmes auxiliaires. De
965 plus, cette partie explique comment effectuer la mise à jour de fichiers
966 source écrits avec d'anciennes versions de LilyPond.
969 @rprogram{LilyPond-book} :
970 comment créer des documents intégrant des exemples musicaux,
974 @rprogram{Converting from other formats} :
975 comment exécuter les programmes de conversion. Ces programmes sont
976 livrés avec le paquetage LilyPond, et convertissent divers formats
977 musicaux vers le format @code{.ly}.
982 @node About the Snippet List (SL)
983 @unnumberedsubsec About the Snippet List (SL)
988 @c FIXME: check on kainhofer.
989 @ref{Top,LilyPond Snippet List,,lilypond-snippets} :
990 il s'agit d'une sélection de petits exemples montrant des trucs,
991 astuces et fonctionnalités particulières de LilyPond, issus de
992 @uref{http://lsr@/.dsi@/.unimi@/.it,LilyPond Snippet Repository}, abrégé
993 sous la forme de LSR. Ils sont dans le domaine public.
995 Notez bien que cette annexe n'est en aucune manière un mirroir du LSR.
996 Dans la mesure où le LSR repose sur une version stable de LilyPond, un
997 exemple qui illustrerait de nouvelles fonctionnalités de la version de
998 développement devrait y être ajouté isolément. C'est la raison pour
999 laquelle vous le trouverez alors dans le répertoire @file{input/new/}
1000 des sources de LilyPond.
1002 La liste des exemples correspondant à chacun des sous-chapitres du
1003 Manuel de notation est accessible par un lien au paragraphe
1004 @strong{Voir aussi}.
1007 @node About the Internals Reference (IR)
1008 @unnumberedsubsec About the Internals Reference (IR)
1017 référence du programme
1020 @ref{Top,Internals Reference,,lilypond-internals}
1022 est un ensemble de pages HTML étroitement liées entre elles, qui
1023 documente les moindres petits détails de chaque classe, objet et
1024 fonction de LilyPond. Cette documentation est produite directement à
1025 partir des définitions de formatage utilisées.
1027 Presque toutes les fonctions de formatage utilisées en interne sont
1028 directement disponibles pour l'utilisateur. Par exemple, toutes les
1029 variables qui contrôlent les épaisseurs, les distances etc., peuvent
1030 être modifiées dans les fichiers d'entrée. Il y a un grand nombre
1031 d'options de formatage, et elles sont toutes décrites dans ce
1032 document. Chaque section du manuel de notation a un paragraphe @b{Voir
1033 aussi} qui renvoie à la documentation générée automatiquement. Dans la
1034 documentation au format HTML, ces paragraphes disposent de liens
1040 @node Other documentation
1041 @unnumberedsubsec Other documentation
1043 FIXME: most of this should go higher up. Discuss News, mailist
1046 There are a number of other places which may be very valuable.
1048 Lorsque vous serez un utilisateur expérimenté, vous pourrez consulter le
1049 manuel comme une référence : il y a un index complet@footnote{Si vous
1050 cherchez quelque chose sans le trouver dans la documentation, c'est un
1051 bogue. Dans ce cas, merci d'envoyer un rapport de bogue.}, mais le
1052 manuel est aussi disponible en
1054 une seule grande page,
1057 @uref{source/Documentation/user/lilypond-big-page.html, une seule grande
1060 ce qui facilite la recherche avec la fonction adéquate de votre
1063 Dans tous les documents HTML qui incluent des fragments musicaux,
1064 le code Lilypond utilisé pour produire l'image est accessible par un
1067 L'emplacement des fichiers de documentation mentionnés ici peut varier
1068 d'un système à l'autre. De temps en temps, ce manuel fait référence aux
1069 fichiers d'exemple et d'initialisation. Tout au long de ce manuel, nous
1070 donnons les emplacements des fichiers d'entrée relativement au
1071 répértoire racine de l'archive source. Par exemple,
1072 @file{input/@/test/@/bla@/.ly} peut référer au fichier
1073 @file{lilypond@/2.x.y/@/input/@/test/@/bla@/.ly}. Dans les paquets
1074 binaires pour les plateformes Unix, la documentation et les exemples se
1075 trouvent généralement sous @file{/usr/@/share/@/doc/@/lilypond/}. Les
1076 fichiers d'initialisation, par exemple @file{scm/@/lily@/.scm}, ou
1077 @file{ly/@/engraver@/-init@/.ly}, se trouvent généralement dans le
1078 répértoire @file{/usr/@/share/@/lilypond/}.
1083 @cindex lilypond-internals
1084 @cindex documentation du fonctionnement interne
1086 @cindex étendre lilypond
1089 Pour finir, ce manuel et les autres sont disponibles en ligne, à la
1090 fois aux formats PDF et HTML, à partir du site Web, accessible
1091 à l'adresse @uref{http://@/www@/.lilypond@/.org/}.