1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
2 @c This file is part of lilypond.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
22 * Automated engraving::
23 * What symbols to engrave?::
24 * Music representation::
25 * Example applications::
33 L'art de la typographie musicale se nomme la @emph{gravure}. Ce terme
34 est issu du processus traditionnel d'impression musicale. Il y a
35 seulement quelques dizaines d'années, on faisait les partitions en
36 coupant et en embossant une plaque de zinc ou d'étain en image miroir.
37 Cette plaque était ensuite encrée, les dépressions créées par les
38 creux et les bosses retenant l'encre. Une image était formée en
39 pressant du papier sur la plaque. La découpe et l'embossage étaient
40 entièrement faits à la main. Il était pénible d'appliquer une
41 correction, quand celle-ci n'était pas impossible, la gravure devait
42 donc être parfaite du premier coup. La gravure demandait une
43 qualification hautement spécialisée : un artisan devait accomplir
44 environ cinq ans de formation avant de mériter le titre de maître
45 graveur, et il lui fallait cinq années d'expérience supplémentaires
46 pour devenir vraiment habile.
48 De nos jours, toutes les partitions récentes sont produites avec des
49 ordinateurs. Ceci a des avantages évidents : le coût des impressions
50 a diminué, et le travail d'éditeur peut être envoyé par courriel.
51 Malheureusement, l'utilisation dominante des ordinateurs a également
52 diminué la qualité graphique des partitions. L'impression
53 informatisée leur donne un aspect fade et mécanique qui les rend
56 @c introduce illustrating aspects of engraving, font...
57 Les images ci-dessous illustrent la différence entre la gravure
58 traditionelle et l'impression typique par ordinateur, et la troisème
59 image montre comment LilyPond mime l'aspect traditionnel. L'image de
60 gauche est une numérisation d'un symbole bémol d'une édition publiée
61 en 2000. Celle du centre montre un bémol d'une gravure à la main de
62 l'édition Bärenreiter de la même musique. L'image de gauche illustre
63 des défauts typiques de l'impression informatique : les lignes de
64 portée sont minces, l'épaisseur de trait du bémol est la même que les
65 lignes fines, et il y a un aspect rigide avec des angles pointus. Par
66 contraste, le bémol Bärenreiter possède un aspect gras et arrondi,
67 presque voluptueux. Notre symbole bémol est créé, entre autres, à
68 partir de celui-là. Il est arrondi, et son épaisseur de trait
69 s'harmonise avec nos lignes de portée, lesquelles sont également plus
70 épaisses que celles de l'édition informatique.
72 @multitable @columnfractions .125 .25 .25 .25 .125
76 @image{henle-flat-gray,,4cm}
79 @image{henle-flat-gray,,,png}
84 @image{baer-flat-gray,,4cm}
87 @image{baer-flat-gray,,,png}
92 @image{lily-flat-bw,,4cm}
95 @image{lily-flat-bw,,,png}
99 @c workaround for makeinfo-4.6: line breaks and multi-column cookies
100 @image{henle-flat-bw,,,png} @image{baer-flat-bw,,,png}
101 @image{lily-flat-bw,,,png}
109 Fonte Feta de LilyPond (2003)
114 @cindex symboles musicaux
117 @cindex épaisseur des caractères
120 @c introduce illustrating aspects of engraving, spacing...
121 En matière d'espacement, la répartition de l'espace devrait refléter
122 les durées entre les notes. Cependant, beaucoup de partitions
123 modernes se contentent des durées avec une précision mathématique, ce
124 qui mène à de mauvais résultats. Dans l'exemple suivant, un motif est
125 imprimé deux fois : une fois en utilisant un espacement mathématique
126 exact, et une autre fois avec des corrections. Pouvez-vous les
129 @cindex espacement optique
130 @c file spacing-optical.
131 @c need to include it here, because we want two images.
152 \override NoteSpacing #'stem-spacing-correction = #0.6
177 \override NoteSpacing #'stem-spacing-correction = #0.0
178 \override NoteSpacing #'same-direction-correction = #0.0
179 \override StaffSpacing #'stem-spacing-correction = #0.0
185 @cindex régulier, rythme
186 @cindex régulier, espacement
187 @cindex espacement régulier
189 L'extrait n'utilise que des notes de même durée ; l'espacement devrait
190 le refléter. Malheureusement, notre oeil nous trompe quelque peu ; il
191 ne se contente pas de remarquer la distance entre les têtes de notes,
192 il prend en compte également la distance entre les hampes
193 consécutives. Ainsi, par compensation, les notes avec une combinaison
194 @qq{hampe vers le haut}/@/@qq{hampe vers le bas} doivent être éloignées
195 l'une de l'autre, et les notes avec une combinaison @qq{hampe vers le
196 bas}/@/@qq{hampe vers le haut} rapprochées, le tout dépendant de la
197 position verticale des notes. Les deux premières mesures sont
198 imprimées avec cette correction, les deux suivantes sans. Les notes
199 dans les deux dernières mesures forment des blocs de notes @qq{hampe
200 vers le bas}/@/@qq{hampe vers le haut}.
204 Les musiciens sont généralement plus absorbés par l'exécution que par
205 l'étude de l'aspect graphique d'une partition, donc discutailler sur
206 les détails typographiques peut paraître peu important. Il n'en est
207 rien. Dans de longues pièces avec des rythmes monotones, les
208 corrections d'espacement engendrent de subtiles variations dans la
209 mise en forme de chaque ligne, donnant à chacune une signature
210 visuelle distincte. Sans cette signature, toutes les lignes auraient
211 le même aspect, et ressembleraient à un labyrinthe. Si un musicien
212 regarde ailleurs un instant ou se déconcentre momentanement, il peut
213 avoir du mal à se retrouver sur la page.
215 De même, l'aspect robuste des symboles sur d'épaisses lignes de
216 portée ressort mieux quand la partition est éloignée du lecteur,
217 comme sur un pupitre par exemple. Une organisation minutieuse des
218 espaces vides permet de minimiser l'espace qu'occupe la musique, tout
219 en évitant que les symboles s'amassent les uns contre les autres. Le
220 résultat permet de réduire le nombre de pages à tourner, ce qui est un
223 Ceci est une caractéristique commune à toute typographie. La
224 disposition doit être belle, non seulement pour des raisons
225 esthétiques, mais également pour l'aide apportée au lecteur dans la
226 tâche qu'il doit accomplir. Pour du matériel d'exécution comme les
227 partitions de musique, cela prend une double importance : les
228 musiciens ont une quantité limitée d'attention. Moins ils en ont
229 besoin pour lire, plus ils peuvent se concentrer sur la musique
230 elle-même. Autrement dit, une meilleure typographie permet une
231 meilleure interprétation.
233 Ces exemples démontrent que la typographie musicale est un art subtil
234 et complexe, et que la produire demande une expertise considérable,
235 que les musiciens n'ont généralement pas. LilyPond représente notre
236 effort pour apporter l'excellence graphique de la gravure à la main à
237 l'ère de l'ordinateur, et la rendre accessible à tous les musiciens.
238 Nous avons conçu nos algorithmes, fontes et paramètres de programme
239 pour retrouver la qualité d'édition des anciennes partitions que nous
240 aimons tant lire et jouer.
244 @node Automated engraving
245 @section Automated engraving
247 Comment pouvons-nous implémenter la typographie ? Si les artisans ont
248 besoin de plus de dix ans pour devenir de vrais maîtres, comment nous,
249 simples programmeurs, pourrions-nous jamais écrire un programme pour
252 La réponse est : nous ne le pouvons pas. La typographie se base sur
253 le jugement visuel humain, donc les humains ne peuvent pas être
254 complètement remplacés. Si LilyPond arrive à résoudre la plupart des
255 situations correctement, ce sera déjà une grande avancée sur les
256 logiciels existants. Les autres situations peuvent être résolues à la
257 main. Au fil des ans, le logiciel peut être affiné pour faire de plus
258 en plus de choses automatiquement, pour que les ajustements manuels
259 soient de moins en moins nécessaires.
261 Quand nous avons commencé, nous avons écrit le programme Lilypond
262 entièrement dans le language de programmation C++ ; les fonctions du
263 programme étaient figées par les développeurs. Ceci s'est avéré
264 insatisfaisant pour plusieurs raisons :
267 @item Quand Lilypond fait des erreurs,
268 les utilisateurs ont besoin de contredire les décisions de formatage.
269 Les utilisateurs doivent donc avoir accès au moteur de formatage. Par
270 conséquent, les règles et les propriétés ne peuvent pas être fixées
271 par nous au moment de la compilation, mais doivent être accessibles
272 aux utilisateurs au moment de l'exécution.
274 @item La gravure est une question de jugement visuel, et donc de goût.
275 Aussi bien informés que nous le sommes, les utilisateurs peuvent être
276 en désaccord avec nos décisions personnelles. Par conséquent, les
277 définitions du modèle typographique doivent également être accessibles
280 @item Enfin, nous affinons continuellement les algorithmes de formatage,
281 donc nous avons besoin d'une approche souple des règles. Le language
282 C++ oblige à une certaine méthode de groupage des règles qui ne
283 convient pas bien au fonctionnement de la notation musicale.
286 Ces problèmes ont été résolus en intégrant un interpréteur pour le
287 language de programmation Scheme, et en réécrivant des parties de
288 LilyPond en Scheme. L'architecture actuelle de formatage est
289 construite autour de la notion d'objets graphiques, décrits par des
290 fonctions et des variables Scheme. Cette architecture comprend les
291 règles de formatage, le style typographique, et des décisions
292 individuelles de formatage. L'utilisateur a un accès direct à la
293 plupart de ces contrôles.
295 Les variables Scheme contrôlent les décisions de mise en page. Par
296 exemple, beaucoup d'objets graphiques ont une variable de direction
297 qui encode le choix entre haut et bas (ou gauche et droite). Vous
298 pouvez voir ici deux accords, avec des accents, et des arpèges. Dans
299 le premier accord, les objets graphiques sont tous dirigés vers le bas
300 (ou la gauche). Dans le second accord ils sont tous dirigés vers le
303 @lilypond[quote,ragged-right]
305 \override SpacingSpanner #'spacing-increment = #3
306 \override TimeSignature #'transparent = ##t
308 \stemDown <e g b>4_>-\arpeggio
309 \override Arpeggio #'direction = #RIGHT
310 \stemUp <e g b>4^>-\arpeggio
315 Le processus de formatage d'une partition consiste à lire et écrire
316 les variables d'objets graphiques. Certaines variables ont une valeur
317 prédéfinie. Par exemple, l'épaisseur d'un grand nombre de lignes --
318 une caractéristique du style typographique -- est une variable avec
319 une valeur prédéfinie. Vous êtes libres d'altérer cette valeur, ce
320 qui vous donne une partition avec une impression typographique
323 @lilypond[quote,ragged-right]
326 c'4-~ c'16 as g f e16 g bes c' des'4
331 \override Beam #'thickness = #0.3
332 \override Stem #'thickness = #0.5
333 \override Bar #'thickness = #3.6
334 \override Tie #'thickness = #2.2
335 \override StaffSymbol #'thickness = #3.0
336 \override Tie #'extra-offset = #'(0 . 0.3)
342 Les règles de formatage ont aussi des variables prédéfinies : chaque
343 objet possède des variables contenant des procédures. Ces procédures
344 exécutent le formatage, et en les substituant par d'autres, nous
345 pouvons changer l'apparence des objets. Dans l'exemple suivant, la
346 règle du choix de têtes de notes est changée au cours de l'extrait de
349 @lilypond[quote,ragged-right]
350 #(set-global-staff-size 30)
352 #(define (mc-squared grob orig current)
353 (let* ((interfaces (ly:grob-interfaces grob))
354 (pos (ly:grob-property grob 'staff-position)))
355 (if (memq 'note-head-interface interfaces)
357 (ly:grob-set-property! grob 'stencil ly:text-interface::print)
358 (ly:grob-set-property! grob 'font-family 'roman)
359 (ly:grob-set-property! grob 'text
360 (make-raise-markup -0.5
362 ((-5) (make-simple-markup "m"))
363 ((-3) (make-simple-markup "c "))
364 ((-2) (make-smaller-markup (make-bold-markup "2")))
365 (else (make-simple-markup "bla")))))))))
367 \new Voice \relative c' {
369 \set autoBeaming = ##f
372 \once \override NoteHead #'stencil = #ly:note-head::brew-ez-stencil
373 \once \override NoteHead #'font-size = #-7
374 \once \override NoteHead #'font-family = #'sans
375 \once \override NoteHead #'font-series = #'bold
377 \once \override NoteHead #'style = #'cross
379 \applyOutput #'Voice #mc-squared
382 { d8[ es-( fis^^ g] fis2-) }
383 \repeat unfold 5 { \applyOutput #'Voice #mc-squared s8 }
390 @node What symbols to engrave?
391 @section What symbols to engrave?
396 Le processus de formatage décide où placer les symboles. Cependant,
397 cela ne peut être fait qu'à partir du moment où il a été décidé
398 @emph{quels} symboles doivent être imprimés, c'est-à-dire quelle
401 La notation musicale usuelle est un système d'écriture qui a évolué à
402 travers les dix derniers siècles. La forme qui est aujourd'hui
403 communément utilisée date du début de la Renaissance. Bien que la forme
404 basique --- les têtes de notes sur une portée de cinq lignes --- n'a pas
405 changé, les détails continuent d'évoluer pour exprimer les innovations
406 de la notation contemporaine. Par conséquent, elle comprend quelque 500
407 ans de musique, avec des applications allant des mélodies monodiques à
408 de monstrueux contrepoints pour grand orchestre.
410 Comment pouvons nous appréhender un tel monstre à plusieurs têtes, et le
411 confiner dans l'espace réduit d'un programme informatique ? Notre
412 solution consiste à diviser le problème de la notation --- par
413 opposition à la gravure, ou typographie --- en morceaux digestes et
414 programmables : chaque type de symbole est géré par un module séparé,
415 couramment appelé greffon@footnote{traduction de l'anglais
416 @emph{plug-in}.}. Chaque greffon est entièrement modulaire et
417 indépendant, et donc peut être développé et amélioré séparément. De
418 tels greffons sont nommés @code{graveur}s@footnote{@code{engraver}s en
419 anglais.}, par analogie avec les artisans qui traduisent les idées
420 musicales en symboles graphiques.
422 Dans l'exemple suivant, voyons comment nous commençons avec un greffon
423 pour les têtes de notes, le graveur de têtes de note
424 (@code{Note_heads_engraver}) :
426 @lilypond[quote,ragged-right]
427 \include "engraver-example.ily"
434 \remove "Stem_engraver"
435 \remove "Phrasing_slur_engraver"
436 \remove "Slur_engraver"
437 \remove "Script_engraver"
438 \remove "Beam_engraver"
439 \remove "Auto_beam_engraver"
443 \remove "Accidental_engraver"
444 \remove "Key_engraver"
445 \remove "Clef_engraver"
446 \remove "Bar_engraver"
447 \remove "Time_signature_engraver"
448 \remove "Staff_symbol_engraver"
449 \consists "Pitch_squash_engraver"
456 Ensuite, le graveur du symbole de portée
457 (@code{Staff_symbol_engraver}) ajoute la portée
459 @lilypond[quote,ragged-right]
460 \include "engraver-example.ily"
467 \remove "Stem_engraver"
468 \remove "Phrasing_slur_engraver"
469 \remove "Slur_engraver"
470 \remove "Script_engraver"
471 \remove "Beam_engraver"
472 \remove "Auto_beam_engraver"
476 \remove "Accidental_engraver"
477 \remove "Key_engraver"
478 \remove "Clef_engraver"
479 \remove "Bar_engraver"
480 \consists "Pitch_squash_engraver"
481 \remove "Time_signature_engraver"
488 le graveur de clef (@code{Clef_engraver}) définit un point de
489 référence pour la portée
491 @lilypond[quote,ragged-right]
492 \include "engraver-example.ily"
499 \remove "Stem_engraver"
500 \remove "Phrasing_slur_engraver"
501 \remove "Slur_engraver"
502 \remove "Script_engraver"
503 \remove "Beam_engraver"
504 \remove "Auto_beam_engraver"
508 \remove "Accidental_engraver"
509 \remove "Key_engraver"
510 \remove "Bar_engraver"
511 \remove "Time_signature_engraver"
518 et le graveur de hampes (@code{Stem_engraver}) ajoute les hampes :
520 @lilypond[quote,ragged-right]
521 \include "engraver-example.ily"
528 \remove "Phrasing_slur_engraver"
529 \remove "Slur_engraver"
530 \remove "Script_engraver"
531 \remove "Beam_engraver"
532 \remove "Auto_beam_engraver"
536 \remove "Accidental_engraver"
537 \remove "Key_engraver"
538 \remove "Bar_engraver"
539 \remove "Time_signature_engraver"
545 Le graveur de hampe est notifié de chaque tête de note qui survient.
546 Chaque fois qu'une tête de note --- plusieurs pour un accord --- est
547 rencontrée, un objet hampe est créé et connecté à la tête de note. En
548 ajoutant des graveurs pour les barres de ligature, les liaisons, les
549 accents, les altérations accidentelles, les barres de mesure, la
550 métrique, et les armures, nous obtenons un jeu de notation complet.
552 @lilypond[quote,ragged-right]
553 \include "engraver-example.ily"
557 Ce système fonctionne bien pour de la musique monodique, mais qu'en
558 est-il de la polyphonie ? En notation polyphonique, plusieurs voix
559 peuvent partager une portée.
561 @lilypond[quote,ragged-right]
562 \include "engraver-example.ily"
563 \new Staff << \topVoice \\ \botVoice >>
566 Dans cette situation, la portée et les altérations accidentelles sont
567 partagées, mais les hampes, liaisons etc., sont spécifiques à chaque
568 voix. Par conséquent, les graveurs doivent être groupés. Les
569 graveurs des têtes de notes, hampes, liaisons etc., vont dans un
570 groupe appelé @qq{contexte de Voix} @footnote{@q{Voice context} en
571 anglais, @q{Voice} commence par une majuscule comme tous les noms de
572 contexte dans le programme LilyPond.}, alors que les graveurs des clés,
573 altérations accidentelles, barres de mesure etc., vont dans un groupe
574 appelé @qq{contexte de Portée}. Dans le cas de la polyphonie, un seul
575 contexte de Portée contient plusieurs contextes de Voix. De même,
576 plusieurs contextes de Portée peuvent être inclus dans un seul
577 contexte de Partition. Le contexte de Partition est le contexte de
578 notation de plus haut niveau.
582 Program reference: @internalsref{Contexts}.
584 @lilypond[quote,ragged-right]
585 \include "engraver-example.ily"
588 \new Staff << \topVoice \\ \botVoice >>
589 \new Staff << \pah \\ \hoom >>
594 @node Music representation
595 @section Music representation
597 Idéalement, le format d'entrée pour n'importe quel système de
598 formatage est une description abstraite du contenu. Dans ce cas-ci,
599 ce serait la musique elle-même. Cela pose un formidable problème :
600 comment pouvons-nous définir ce que la musique est réellement ? Plutôt
601 que d'essayer de trouver une réponse, nous avons renversé la question.
602 Nous écrivons un logiciel capable de produire de la musique écrite, et
603 adaptons le format pour atteindre la plus grande concision possible.
604 Quand le format ne peut plus être simplifé, il nous reste par
605 définition le contenu lui-même. Notre logiciel sert de définition
606 formelle d'un document de musique.
608 La syntaxe est également l'interface utilisateur pour LilyPond, par
609 conséquent il est facile de saisir
616 c'est-à-dire un do central noire et, juste au-dessus un ré croche
618 @lilypond[quote,fragment]
622 Sur une échelle microscopique, une telle syntaxe est facile à
623 utiliser. A plus grande échelle, la syntaxe a besoin aussi de
624 structure. Comment serait-il possible autrement de rentrer des
625 pièces complexes comme des symphonies ou des opéras ? La structure
626 est formée par le concept d'expression musicale : en combinant
627 de petits fragments de musique pour en former de plus grands, on peut
628 exprimer de la musique plus complexe. Par exemple
630 @lilypond[quote,verbatim,fragment,relative=1]
635 Des accord peuvent être construits avec @code{<<} et @code{>>} autour
638 @c < > is not a music expression,
639 @c so we use <<>> iso. <> to drive home the point of
640 @c expressions. Don't change this back --hwn.
645 @lilypond[quote,fragment,relative=1]
646 \new Voice { <<c4 d4 e>> }
650 Cette expression est mise dans une séquence grace à l'encadrement par
651 des accolades @code{@{@tie{}@dots{}@tie{}@}}
654 @{ f4 <<c4 d4 e4>> @}
657 @lilypond[quote,relative=1,fragment]
662 Ceci est également une expression, et peut donc encore une fois
663 être combinée avec d'autres expressions simultanées (une blanche)
664 en utilisant <<, @code{\\}, et >>
667 << g2 \\ @{ f4 <<c4 d4 e4>> @} >>
670 @lilypond[quote,fragment,relative=2]
671 \new Voice { << g2 \\ { f4 <<c d e>> } >> }
674 De telles strucutres récursives peuvent être spécifiées formellement
675 et de manière ordonnée dans une grammaire indépendante de tout
676 contexte. Le code d'analyse est aussi générée à partir de cette
677 grammaire. Autrement dit, la syntaxe de LilyPond est définie
678 clairement et sans ambiguité.
680 L'interface utilisateur et la syntaxe sont ce que les gens voient et
681 manipulent le plus. Elles sont en partie une affaire de goût, et
682 aussi sujettes à beaucoup de discussions. Même si ces discussions sur
683 les goûts ont leur mérite, elles ne sont pas très productives. D'un
684 point de vue plus large sur LilyPond, l'importance de la syntaxe est
685 minime : il est facile d'inventer une syntaxe concise, alors qu'écrire
686 un code de formatage décent est beaucoup plus difficile. Ceci est
687 également illustré par le nombre de lignes de codes pour les
688 composants respectifs : l'analyse et la représentation constituent
689 moins de 10% du code source.
691 @node Example applications
692 @section Example applications
694 Nous avons conçu LilyPond comme une expérimentation visant à
695 concentrer l'art de la gravure musicale dans un logiciel. Grâce à
696 tout ce dur labeur, le programme peut maintenant être utilisé pour
697 accomplir des travaux utiles. L'application la plus simple est
698 d'imprimer des notes :
700 @lilypond[quote,relative=1,fragment]
701 \time 2/4 c4 c g'4 g a4 a g2
705 En ajoutant des noms d'accords et des paroles, nous obtenons
706 une partition de chanson :
708 @lilypond[quote,ragged-right]
710 \chords { c2 c f2 c }
711 \new Staff \relative c' { \time 2/4 c4 c g'4 g a4 a g2 }
712 \new Lyrics \lyricmode { twin4 kle twin kle lit tle star2 }
716 La notation polyphonique et la musique pour piano peuvent également
717 être générées. L'exemple suivant associe quelques constructions
720 @lilypondfile[quote,ragged-right]{screech-boink.ly}
722 Les extraits exposés ici ont tous été écrits à la main, mais ce n'est
723 pas une obligation. Puisque le moteur de formatage est en grande
724 partie automatique, il peut servir de sortie pour d'autres programmes
725 qui manipulent la musique. Par exemple, il peut être utilisé pour
726 convertir des bases de données d'extraits musicaux en images pour des
727 sites Internet et des présentations multimédias.
729 Ce manuel montre également une application : le format d'entrée est du
730 texte, et peut donc facilement être intégré dans d'autres formats
731 basés sur le texte comme @LaTeX{}, HTML, ou dans le cas de ce manuel,
732 Texinfo. À l'aide d'un programme spécial, les extraits de code
733 peuvent être remplacés par des images de musiques dans les fichiers de
734 sortie PDF ou HTML. Cela donne la possibilité de mélanger de la
735 musique et du texte dans les documents.
739 @node About this manual
740 @section About this manual
742 Deux manuels traitent de LilyPond : le @emph{manuel de l'utilisateur}
743 --- que vous lisez actuellement --- et le @emph{manuel d'utilisation du
746 @subheading Manuel de l'utilisateur
748 Ce manuel se divise en trois livres.
749 @c pourquoi pas "tomes" au lieu de "livres" ? -John M.
751 @subsubheading Manuel d'apprentissage
753 Ce livre explique comment débuter avec LilyPond, et expose de manière
754 simple quelques concepts clés. Il est conseillé de lire ces chapitres
763 @emph{@ruser{Tutorial}}
764 propose une introduction en douceur à la typographie musicale.
765 Les utilisateurs débutants sont invités à commencer ici.
768 @emph{@ruser{Putting it all together}}
769 explique des concepts généraux du format de fichier ly. Si vous n'êtes
770 pas certain de l'endroit où placer une commande, lisez ce chapitre !
773 @emph{@ruser{Working on LilyPond projects}}
774 montre des utilisations pratiques de LilyPond et donne des conseils
775 afin d'éviter les problèmes les plus courants.
778 @emph{@ruser{Tweaking output}}
779 est une introduction aux retouches de gravure avec LilyPond.
784 @subsubheading Manuel de référence
786 Ce livre détaille toutes les commandes LilyPond produisant une notation
787 musicale. La lecture de cet ouvrage requiert une bonne compréhension des
788 concepts exposés dans le manuel d'apprentissage.
793 @emph{@ruser{Basic notation}}
794 traite de sujets groupés par type de notation. Cette section
795 détaille la notation de base, qui sera utile dans la plupart des
796 projets de partition.
799 @emph{@ruser{Instrument-specific notation}}
800 traite de sujets groupés par type de notation. Cette section détaille
801 des notations spéciales qui ne seront utiles que pour des types
802 particuliers d'instruments ou la voix.
805 @emph{@ruser{Advanced notation}}
806 traite de sujets groupés par type de notation. Cette section
807 donne des précisions à propos de notations compliquées et
811 @emph{@ruser{Changing defaults}}
812 explique comment ajuster finement la mise en page.
815 @emph{@ruser{Non-musical notation}}
816 traite de sorties non musicales comme les titres, les mouvements
817 multiples, et la sélection des instruments MIDI.
820 @emph{@ruser{Spacing issues}}
821 traite de sujets affectant la sortie globale, comme sélectionner
822 la taille de papier ou spécifier les sauts de page.
825 @emph{@ruser{Interfaces for programmers}}
826 explique comment créer des fonctions de musique.
831 @subsubheading Annexes
833 Ce livre contient des tables de référence pratiques.
835 @c Nous avons besoin d'ecrivez tous ca, aprez GDP est fini. -gp
843 @emph{@ruser{Literature list}}
844 contient un choix de livres de référence utiles pour ceux qui veulent
845 en savoir plus sur la notation et la gravure.
849 @emph{@ruser{Scheme tutorial}}
850 propose une courte introduction à Scheme, le langage de programmation
851 utilisé dans les fonctions de musique.
857 @emph{@ruser{Notation manual tables}}
858 sont un ensemble de tableaux montrant les noms d'accord, les
859 instruments MIDI, les noms de couleur, et la police Feta.
863 @emph{@ruser{Templates}}
864 de pièces LilyPond. Copiez et collez un modèle
865 dans un fichier, ajoutez les notes, et c'est prêt !
869 @emph{@ruser{Cheat sheet}}
870 est une référence pratique des commandes LilyPond les plus courantes.
874 @emph{@ruser{LilyPond command index}}
875 est un index de toutes les @code{\commandes} LilyPond.
879 @emph{@ruser{LilyPond index}}
880 est un index complet.
884 @subheading Utilisation du programme
886 Ce livre explique l'exécution du programme et l'intégration de
887 partitions LilyPond dans d'autres programmes.
892 @emph{@rprogram{Install}}
893 explique l'installation (et pour les personnes intéressées la
894 compilation) de LilyPond.
897 @emph{@rprogram{Running LilyPond}}
898 documente le lancement de LilyPond et de ses programmes auxiliaires. De
899 plus, cette section explique la mise à jour de fichiers source écrits
900 pour d'anciennes versions de LilyPond.
903 @emph{@rprogram{LilyPond-book}}
904 détaille la création de documents intégrant des exemples musicaux,
908 @emph{@rprogram{Converting from other formats}}
909 explique l'exécution des programmes de conversion. Ces programmes sont
910 livrés avec le paquetage LilyPond, et convertissent divers formats
911 musicaux vers le format @code{.ly}.
917 @subsubheading Autre documentation
919 D'autres documents constituent de précieuses sources d'information.
924 @cindex langues étrangères
928 Le glossaire de musique explique les termes musicaux, et inclut
929 leur traduction dans diverses langues. C'est un document séparé,
930 disponible aux formats HTML et PDF.
933 Le @ruser{Top,glossaire musical,,music-glossary} explique les termes
934 musicaux et inclut les traductions dans diverses langues. Il est
935 également disponible au format PDF.
937 Si vous n'êtes pas familier avec la notation musicale ou la
938 terminologie, il est conseillé de consulter le glossaire, notamment
939 pour les parties non encore traduites de la documentation.
941 @cindex exemples de code
946 @uref{source/input/lsr/collated-files.html,Exemples de code}
951 sont une vaste sélection de petits exemples montrant des trucs, astuces
952 et fonctionnalités particulières de LilyPond. La plupart de ces
953 exemples sont également disponibles sur le
954 @uref{http://lsr.dsi.unimi.it/,LilyPond Snippet Repository}. Ce site
955 Web possède également le manuel de LilyPond avec une fonctionnalité de
961 référence du programme
964 @ruser{Top,référence du programme,,lilypond-internals}.
966 est un ensemble de pages HTML étroitement liées entre elles, qui
967 documente les moindres petits détails de chaque classe, objet et
968 fonction de LilyPond. Cette documentation est produite directement à
969 partir des définitions de formatage utilisées.
971 Presque toutes les fonctions de formatage utilisées en interne sont
972 directement disponibles pour l'utilisateur. Par exemple, toutes les
973 variables qui contrôlent les épaisseurs, les distances etc., peuvent
974 être modifiées dans les fichiers d'entrée. Il y a un grand nombre
975 d'options de formatage, et elles sont toutes décrites dans ce
976 document. Chaque section du manuel de notation a une section @b{Voir
977 aussi} qui renvoie à la documentation générée automatiquement. Dans la
978 documentation au format HTML, ces sous-sections ont des liens
983 Lorsque vous serez un utilisateur expérimenté, vous pourrez consulter le
984 manuel comme une référence : il y a un index complet@footnote{Si vous
985 cherchez quelque chose sans le trouver dans la documentation, c'est un
986 bogue. Dans ce cas, merci d'envoyer un rapport de bogue.}, mais le
987 manuel est aussi disponible en
989 une seule grande page,
992 @uref{source/Documentation/user/lilypond-big-page.html, une seule grande
995 ce qui facilite la recherche avec la fonction de recherche de votre
998 Dans tous les documents HTML qui incluent des fragments musicaux,
999 le code Lilypond utilisé pour produire l'image peut être vu en
1002 L'emplacement des fichiers de documentation mentionnés ici peut varier
1003 d'un système à l'autre. De temps en temps, ce manuel fait référence aux
1004 fichiers d'exemple et d'initialisation. Tout au long de ce manuel, nous
1005 donnons les emplacements des fichiers d'entrée relativement au
1006 répértoire racine de l'archive source. Par exemple,
1007 @file{input/@/test/@/bla@/.ly} peut référer au fichier
1008 @file{lilypond@/2.x.y/@/input/@/test/@/bla@/.ly}. Dans les paquets
1009 binaires pour les plateformes Unix, la documentation et les exemples se
1010 trouvent généralement sous @file{/usr/@/share/@/doc/@/lilypond/}. Les
1011 fichiers d'initialisation, par exemple @file{scm/@/lily@/.scm}, ou
1012 @file{ly/@/engraver@/-init@/.ly}, se trouvent généralement dans le
1013 répértoire @file{/usr/@/share/@/lilypond/}.
1018 @cindex lilypond-internals
1019 @cindex documentation du fonctionnement interne
1021 @cindex étendre lilypond
1024 Pour finir, ce manuel et les autres sont disponibles en ligne, à la
1025 fois aux formats PDF et HTML, à partir du site Web, accessible
1026 à l'adresse @uref{http://@/www@/.lilypond@/.org/}.