1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
2 @c This file is part of web.texi
4 Translation of GIT committish: 45d5c47caba98ccd97dadbc44234c8de1f3570ab
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. For details, see the Contributors'
8 Guide, node Updating translation committishes..
11 @c Translators: John Mandereau
12 @c Translation checkers: Jean-Charles Malahieude
16 @translationof Manuals
18 @macro details{reference}
20 (@ref{\reference\, détails de \reference\})
25 @divClass{heading-center}
27 @heading Documentation pour LilyPond @version
30 @heading Documentation pour LilyPond @versionStable
35 @divClass{link-headings}
37 @divClass{column-center-top}
38 @subheading Introduction
43 @ref{Entrée sous forme de texte} :
44 LilyPond est un système de gravure musicale @strong{en mode texte}. Si
45 vous ne savez pas du tout ce que ça veut dire, lisez tout d'abord
49 @ifWebLinks{@manualStableLearningSplitNoName-fr,@rlearningnamed{Top,Initiation}}
50 une introduction pas-à-pas à LilyPond.
54 @ifWebLinks{@manualStableGlossarySplitNoName,@rglosnamed{Top,Glossaire}}
55 @emph{(lecture optionnelle)} répertoire de définition et de traduction
56 de termes musicaux, utile en particulier pour connaître les termes
61 @ifWebLinks{@manualStableEssaySplitNoName-fr,@ressaynamed{Top,Essai}}
62 @emph{(lecture optionnelle)} essai sur la conception des processus de
63 gravure d'après l'esthétique et la technique de la gravure
64 traditionnelle avec poinçons et plaques de plomb.
71 @divClass{column-left-top}
72 @subheading Utilisation courante
77 @ifWebLinks{@manualStableNotationSplitNoName-fr,@rusernamed{Top,Notation}}
78 partie la plus importante de la documentation, ce manuel fournit toutes
79 les informations détaillées dont vous aurez besoin en matière de notation.
83 @ifWebLinks{@manualStableUsageSplitNoName-fr,@rprogramnamed{Top,Utilisation}}
84 présentation des différentes composantes de LilyPond, ainsi que les
85 particularités de certains systèmes d'exploitation.
89 @ifWebLinks{@manualStableSnippetsSplitNoName,@rlsrnamed{Top,Morceaux choisis}}
90 courts extraits, trucs, modèles et autres exemples.
91 @details{Morceaux choisis}
98 @divClass{column-right-top}
99 @subheading Utilisation ponctuelle
105 la Foire Aux Questions.
113 @ifWebLinks{@manualStableChangesSplitNoName,@rchangesnamed{Top,Nouveautés}}
114 changements depuis la dernière version stable.
118 @ifWebLinks{@manualStableExtendingSplitNoName,@rextendnamed{Top,Extension}}
119 programmation avancée d'ajustements et retouches dans LilyPond.
123 @ifWebLinks{@manualStableInternalsSplitNoName,@rinternalsnamed{Top,Propriétés internes}}
124 information sur les structures internes de LilyPond, nécessaire en
125 particulier pour élaborer des retouches.
126 @details{Propriétés internes}
133 @divClass{column-center-bottom}
134 @subheading Autre documentation
140 liens rapides, manuels téléchargeables, et documentation des anciennes
145 état des traductions pour les lecteurs non anglophones.
148 @uref{http://lsr@/.di@/.unimi@/.it,LilyPond Snippet Repository} :
149 collection d'exemples, trucs et astuces élaborés par des utilisateurs.
152 @uref{http://bit.ly/LilyPondBeginners,Tutoriels vidéo} : Ben Lemon,
153 utilisateur de LilyPond, a mis en ligne sur son @emph{blog} plusieurs
154 tutoriels destinés aux nouveaux utilisateurs.
157 @ref{Développement} :
158 manuels pour la version de développement.
162 ces manuels sont publiés sous la licence GNU de documentation libre FDL.
168 @divClass{column-center-bottom}
169 @subheading Format des manuels
171 Les manuels de LilyPond sont disponibles sous différents formats : HTML
172 multifichiers, fichier monolithique HTML ou PDF.@*
173 Le HTML découpé en plusieurs fichiers est tout à fait adapté à une
174 consultation en ligne. Les formats HTML en fichier unique -- certains
175 ont une taille conséquente -- contiennent l'intégralité d'un manuel sur
176 une seule page. Les exemplaires PDF sont plutôt destinés au
177 téléchargement pour consultation hors ligne. Ces trois formats sont
178 accessibles en suivant le lien « détail de@dots{} » de chacun des manuels.
187 * Initiation:: Premiers pas
188 * Glossaire:: Glossaire musicologique multilingue
189 * Essai:: Pourquoi LilyPond
190 * Notation:: Référence en matière de notation
191 * Utilisation:: Les différentes composantes de LilyPond
192 * Morceaux choisis:: Exemples de code, trucs et astuces
193 * FAQ:: Foire aux questions
194 * Web:: Le site de LilyPond
195 * Nouveautés:: Ce qui change au fil des versions
196 * Extension:: Programmation au sein de LilyPond
197 * Propriétés internes:: Références du programme
198 * Traductions:: État d'avancement des différentes traductions
199 * Tous:: Tous les manuels
206 @c TRANSLATORS, most of the text in this file came from
207 @c LM 1.1 About the documentation (before this section was
208 @c removed in July 2009).
211 @unnumberedsec Initiation
212 @translationof Learning
214 @divClass{column-left-top}
215 @subheading Manuel d'initiation
217 Ce manuel explique comment débuter avec LilyPond, et expose de manière
218 simple quelques concepts clés. Il est conseillé de lire ces chapitres
221 Dans ce manuel se trouve à chaque section un paragraphe @strong{Voir
222 aussi} contenant des références vers d'autres sections : il est
223 conseillé de ne pas les suivre en première lecture ; lorsque vous
224 aurez lu l'ensemble du manuel d'initiation, vous pourrez en relisant
225 certaines sections suivre ces références pour approfondir certains
229 @divClass{column-right-bottom}
231 @docLinks{Initiation, learning,
232 @rlearningnamed{Top,Initiation},
233 @manualStableLearningSplit-fr,
234 @manualStableLearningBig-fr, @w{3 MB},
235 @manualStableLearningPdf-fr, @w{5 MB}}
241 @unnumberedsec Glossaire
242 @translationof Glossary
244 @divClass{column-left-top}
245 @subheading Glossaire
247 Ce document explique en anglais des termes musicaux, et donne leur
248 traduction dans diverses langues. Si vous n'êtes pas familier avec la
249 notation et la terminologie musicales, il est conseillé de consulter le
250 glossaire, notamment pour les parties non encore traduites de la
255 @divClass{column-right-bottom}
257 @docLinks{Glossaire musical, music-glossary,
258 @rglosnamed{Top,Glossaire musical},
259 @manualStableGlossarySplit,
260 @manualStableGlossaryBig, @w{1 MB},
261 @manualStableGlossaryPdf, @w{1,5 MB}}
270 @divClass{column-left-top}
273 Ce document résume l'histoire de la typographie musicale, puis examine
274 les techniques de gravure à l'œuvre dans LilyPond. Il inclut également
275 des comparaisons entre LilyPond et d'autres logiciels de notation
278 @warning{il est plus facile d'examiner les détails typographiques dans
279 l'édition de ce manuel au format PDF, car elle peut être vue à une plus
284 @divClass{column-right-bottom}
286 @docLinks{Essai, essay,
287 @ressaynamed{Top,Essai},
288 @manualStableEssaySplit-fr,
289 @manualStableEssayBig-fr, @w{1 MB},
290 @manualStableEssayPdf-fr, @w{2 MB}}
296 @unnumberedsec Notation
297 @translationof Notation
299 @divClass{column-left-top}
300 @subheading Manuel de notation
302 Ce manuel détaille toutes les commandes LilyPond produisant une notation
303 musicale. La lecture de cet ouvrage requiert une bonne compréhension des
304 concepts exposés dans le manuel d'initiation.
306 @warning{L'utilisation optimale du manuel de notation requiert une
307 familiarité avec les concepts et fonctions de base exposés dans le
308 manuel d'initiation, ainsi que les concepts musicaux exposés dans le
313 @divClass{column-right-bottom}
315 @docLinks{Notation, notation,
316 @rusernamed{Top,Notation},
317 @manualStableNotationSplit-fr,
318 @manualStableNotationBig-fr, @w{9 MB},
319 @manualStableNotationPdf-fr, @w{35 MB}}
325 @unnumberedsec Utilisation
328 @divClass{column-left-top}
329 @subheading Manuel d'utilisation des programmes
331 Ce manuel explique l'exécution des programmes et l'intégration de
332 partitions LilyPond dans d'autres programmes, et suggère des « bonnes
333 pratiques » pour une utilisation plus efficace. Sa lecture est
334 recommandée avant d'aborder de grands projets.
338 @divClass{column-right-bottom}
340 @docLinks{Utilisation des programmes, usage,
341 @rprogramnamed{Top,Utilisation des programmes},
342 @manualStableUsageSplit-fr,
343 @manualStableUsageBig-fr, @w{400 KB},
344 @manualStableUsagePdf-fr, @w{650 KB}}
349 @node Morceaux choisis
350 @unnumberedsec Morceaux choisis
351 @translationof Snippets
353 @divClass{column-left-top}
354 @subheading Morceaux choisis
356 Il s'agit d'une sélection de petits exemples montrant des trucs,
357 astuces et fonctionnalités particulières de LilyPond, issus de
358 @uref{http://lsr@/.di@/.unimi@/.it,LilyPond Snippet Repository}
359 (LSR). Tous ces exemples sont dans le domaine public.
361 Notez bien que cette annexe n'est en aucune manière un miroir ou même
362 une partie du LSR. Dans la mesure où le LSR repose sur une version
363 stable de LilyPond, les exemples illustrant des fonctionnalités
364 introduites dans la dernière version de développement ne peuvent y
365 figurer ; c'est pourquoi vous les trouverez dans le répertoire
366 @file{Documentation/snippets/new/} des sources de LilyPond.
368 La liste des exemples correspondant à chacun des sous-chapitres du
369 manuel de notation est accessible par des liens dans le paragraphe
373 @divClass{column-right-bottom}
375 @docLinks{Morceaux choisis, snippets,
376 @rlsrnamed{Top, Morceaux choisis},
377 @manualStableSnippetsSplit,
378 @manualStableSnippetsBig, @w{1,5 MB},
379 @manualStableSnippetsPdf, @w{12,5 MB}}
388 @divClass{column-center-top}
389 @subheading Foire aux questions
391 @subsubheading Où sont la vue graphique, les menus et barres d'outils ?
393 LilyPond demande que la musique soit écrite comme du texte. Lisez la
394 partie intitulée @ref{Entrée sous forme de texte}.
397 @subsubheading La documentation est si longue ! Dois-je vraiment la lire ?
399 Vous devez lire le @ref{Initiation,manuel d'initiation}. Pour le reste
400 de la documentation, vous n'avez besoin de lire que ce qui est en
401 rapport avec la notation musicale que vous voulez produire.
404 @subsubheading Ça fait encore beaucoup à lire ! Ai-je besoin de lire tout cela ?
406 C'est vous qui voyez ; les raisons pour lesquelles vous souhaitez
407 utiliser LilyPond se trouvent peut-être dans notre @ref{Introduction}.
411 @divClass{column-center-bottom}
412 @subheading Questions d'utilisation
414 @subsubheading Quelque chose ne fonctionne pas ! Comment je le répare ?
416 C'est expliqué dans @rprogram{Résolution de problèmes}.
419 @subsubheading Pourquoi changez-vous la syntaxe ?
421 C'est expliqué dans @rprogram{LilyPond est une langue vivante}.
430 @divClass{column-left-top}
433 Ce document fournit des informations générales sur LilyPond et sur les
434 outils de la communauté, c'est-à-dire les listes de discussion, les
435 rapports de bogues et le développement.
439 @divClass{column-right-bottom}
442 @subsubheading La version que vous consultez actuellement
444 @divClass{keep-bullets}
450 @subsubheading Web de la version @versionDevel
454 @manualDevelWebSplit-fr,
455 @manualDevelWebBig-fr, @w{2,5 MB},
456 @manualDevelWebPdf-fr, @w{3,5 MB}}
462 @unnumberedsec Nouveautés
463 @translationof Changes
465 @divClass{column-left-top}
466 @subheading Nouveautés
468 C'est une liste des changements visibles pour l'utilisateur et des
469 nouvelles fonctionnalités de LilyPond depuis la dernière version stable.
473 @divClass{column-right-bottom}
475 @docLinks{Nouveautés, changes,
476 @rchcangesnamed{Top,Nouveautés},
477 @manualStableChangesSplit,
478 @manualStableChangesBig, @w{90 KB},
479 @manualStableChangesPdf, @w{80 KB}}
485 @unnumberedsec Extension
486 @translationof Extending
488 @divClass{column-left-top}
489 @subheading Extension des fonctionnalités de LilyPond
491 Ce manuel vous donnera des pistes en matière de programmation avancée
492 d’ajustements et retouches dans LilyPond.
496 @divClass{column-right-bottom}
498 @docLinks{Extension, extending,
499 @rextendnamed{Top,Extension},
500 @manualStableExtendingSplit-fr,
501 @manualStableExtendingBig-fr, @w{300 KB},
502 @manualStableExtendingPdf-fr, @w{500 KB}}
507 @node Propriétés internes
508 @unnumberedsec Propriétés internes
509 @translationof Internals
511 @divClass{column-left-top}
512 @subheading Référence des propriétés internes
514 C'est un ensemble de pages étroitement liées entre elles, qui documente
515 les moindres petits détails de chaque classe, objet et fonction de
516 LilyPond. Cette documentation est produite directement à partir des
517 définitions de formatage du code source. Elle n'est à ce jour
518 disponible qu'en anglais.
520 Presque toutes les fonctions de formatage utilisées en interne sont
521 directement disponibles pour l'utilisateur. Par exemple, toutes les
522 variables qui contrôlent les épaisseurs, les distances, etc. peuvent
523 être modifiées dans les fichiers d'entrée. Il y a un grand nombre
524 d'options de formatage, et elles sont toutes décrites dans ce document.
525 Chaque section du manuel de notation a un paragraphe @b{Voir aussi}, qui
526 renvoie à la documentation générée automatiquement.
530 @divClass{column-right-bottom}
532 @docLinks{Référence des propriétés internes, internals,
533 @rinternalsnamed{Top,Référence des propriétés internes},
534 @manualStableInternalsSplit,
535 @manualStableInternalsBig, @w{3 MB},
536 @manualStableInternalsPdf, @w{4 MB}}
542 @unnumberedsec Traductions
543 @translationof Translated
545 @divClass{column-center-bottom}
546 @subheading État des traductions
548 @include translations.itexi
557 @divClass{column-left-top}
558 @subheading Versions disponibles au téléchargement
561 L'intégrale de la documentation est disponible sous forme d'archive à
562 l'adresse @uref{http://lilypond.org}
566 @divClass{keep-bullets}
569 @item @doctarballStable-fr
578 @divClass{column-right-bottom}
579 @subheading Versions stables antérieures
581 @divClass{keep-bullets}
584 @item @uref{http://lilypond.org/doc/v2.16/Documentation/web/manuals,
585 LilyPond 2.16 Documentation}
587 @item @uref{http://lilypond.org/doc/v2.14/Documentation/web/manuals.fr.html,
588 LilyPond 2.14 Documentation}
590 @item @uref{http://lilypond.org/doc/v2.12/Documentation/index.fr.html,
591 LilyPond 2.12 Documentation}
593 @item @uref{http://lilypond.org/doc/v2.10/Documentation/,
594 LilyPond 2.10 Documentation}
596 @item @uref{http://lilypond.org/doc/v2.8/Documentation/,
597 LilyPond 2.8 Documentation}
599 @item @uref{http://lilypond.org/doc/v2.6/Documentation/,
600 LilyPond 2.6 Documentation}
602 @item @uref{http://lilypond.org/doc/v2.4/Documentation/out-www/,
603 LilyPond 2.4 Documentation}
605 @item @uref{http://lilypond.org/doc/v2.2/Documentation/out-www/,
606 LilyPond 2.2 Documentation}
608 @item @uref{http://lilypond.org/doc/v2.0/Documentation/out-www/,
609 LilyPond 2.0 Documentation}
611 @item @uref{http://lilypond.org/doc/v1.8/Documentation/out-www/,
612 LilyPond 1.8 Documentation}
614 @item @uref{http://lilypond.org/doc/v1.6/Documentation/out-www/,
615 LilyPond 1.6 Documentation}
625 @divClass{column-center-top}
626 @subheading Licence de la documentation
628 La documentation de GNU LilyPond est publiée selon les termes de la
629 @emph{GNU Free Documentation License}. Une brève introduction à cette
630 licence ainsi que les motifs qui nous ont fait l'adopter se trouvent à
631 la page @ref{Liberté}.
635 @divClass{column-center-bottom}
636 @subheading GNU Free Documentation License 1.1