1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
2 @c This file is part of web.texi
4 Translation of GIT committish: 0ab366a101ef8c3439dd8d6ff6c634f70fa5f63b
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\}) @spanEnd
24 @divClass{heading-center}
26 @heading Documentation pour LilyPond @version
29 @heading Documentation pour LilyPond @versionStable
34 @divClass{link-headings}
36 @divClass{column-center-top}
37 @subheading Introduction
42 @ref{Entrée sous forme de texte}@tie{}:
43 LilyPond est un système de gravure musicale @strong{en mode texte}. Si
44 vous ne savez pas du tout ce que ça veut dire, lisez tout d'abord
48 @ifWebLinks{@manualStableLearningSplitNoName-fr,@rlearningnamed{Top,Initiation}}
49 une introduction pas-à-pas à LilyPond.
53 @ifWebLinks{@manualStableGlossarySplitNoName,@rglosnamed{Top,Glossaire}}
54 @emph{(lecture optionnelle)} répertoire de définition et de traduction
55 de termes musicaux, utile en particulier pour connaître les termes
60 @ifWebLinks{@manualStableEssaySplitNoName-fr,@ressaynamed{Top,Essai}}
61 @emph{(lecture optionnelle)} essai sur la conception des processus de
62 gravure d'après l'esthétique et la technique de la gravure
63 traditionnelle avec poinçons et plaques de plomb.
70 @divClass{column-left-top}
71 @subheading Utilisation courante
76 @ifWebLinks{@manualStableNotationSplitNoName-fr,@rusernamed{Top,Notation}}
77 partie la plus importante de la documentation, ce manuel fournit toutes
78 les informations détaillées dont vous aurez besoin en matière de notation.
82 @ifWebLinks{@manualStableUsageSplitNoName-fr,@rprogramnamed{Top,Utilisation}}
83 présentation des différentes composantes de LilyPond, ainsi que les
84 particularités de certains systèmes d'exploitation.
88 @ifWebLinks{@manualStableSnippetsSplitNoName-fr,@rlsrnamed{Top,Morceaux choisis}}
89 courts extraits, trucs, modèles et autres exemples.
90 @details{Morceaux choisis}
97 @divClass{column-right-top}
98 @subheading Utilisation ponctuelle
104 la Foire Aux Questions.
112 @ifWebLinks{@manualStableChangesSplitNoName,@rchangesnamed{Top,Nouveautés}}
113 changements depuis la dernière version stable.
117 @ifWebLinks{@manualStableExtendingSplitNoName,@rextendnamed{Top,Extension}}
118 programmation avancée d'ajustements et retouches dans LilyPond.
122 @ifWebLinks{@manualStableInternalsSplitNoName,@rinternalsnamed{Top,Propriétés internes}}
123 information sur les structures internes de LilyPond, nécessaire en
124 particulier pour élaborer des retouches.
125 @details{Propriétés internes}
132 @divClass{column-center-bottom}
133 @subheading Autre documentation
138 @ref{Traductions}@tie{}:
139 état des traductions pour les lecteurs non anglophones.
143 liens rapides, manuels téléchargeables, et documentation des anciennes
147 @ref{Développement}@tie{}:
148 manuels pour la version de développement.
152 ces manuels sont publiés sous la licence GNU de documentation libre FDL.
163 * Initiation:: Premiers pas
164 * Glossaire:: Glossaire musicologique multilingue
165 * Essai:: Pourquoi LilyPond
166 * Notation:: Référence en matière de notation
167 * Utilisation:: Les différentes composantes de LilyPond
168 * Morceaux choisis:: Exemples de code, trucs et astuces
169 * FAQ:: Foire aux questions
170 * Web:: Le site de LilyPond
171 * Nouveautés:: Ce qui change au fil des versions
172 * Extension:: Programmation au sein de LilyPond
173 * Propriétés internes:: Références du programme
174 * Traductions:: État d'avancement des différentes traductions
175 * Tous:: Tous les manuels
182 @c TRANSLATORS, most of the text in this file came from
183 @c LM 1.1 About the documentation (before this section was
184 @c removed in July 2009).
187 @unnumberedsec Initiation
188 @translationof Learning
190 @divClass{column-left-top}
191 @subheading Manuel d'initiation
193 Ce manuel explique comment débuter avec LilyPond, et expose de manière
194 simple quelques concepts clés. Il est conseillé de lire ces chapitres
197 Dans ce manuel se trouve à chaque section un paragraphe @strong{Voir
198 aussi} contenant des références vers d'autres sections@tie{}: il est
199 conseillé de ne pas les suivre en première lecture@tie{}; lorsque vous
200 aurez lu l'ensemble du manuel d'initiation, vous pourrez en relisant
201 certaines sections suivre ces références pour approfondir certains
205 @divClass{column-right-bottom}
207 @docLinks{Initiation, learning,
208 @rlearningnamed{Top,Initiation},
209 @manualStableLearningSplit-fr,
210 @manualStableLearningBig-fr, 1.5 MB,
211 @manualStableLearningPdf-fr, 3 MB}
217 @unnumberedsec Glossaire
218 @translationof Glossary
220 @divClass{column-left-top}
221 @subheading Glossaire
223 Ce document explique en anglais des termes musicaux, et donne leur
224 traduction dans diverses langues. Si vous n'êtes pas familier avec la
225 notation et la terminologie musicales, il est conseillé de consulter le
226 glossaire, notamment pour les parties non encore traduites de la
231 @divClass{column-right-bottom}
233 @docLinks{Glossaire musical, music-glossary,
234 @rglosnamed{Top,Glossaire musical},
235 @manualStableGlossarySplit,
236 @manualStableGlossaryBig, 1 MB,
237 @manualStableGlossaryPdf, 1.5 MB}
246 @divClass{column-left-top}
249 Ce document résume l'histoire de la typographie musicale, puis examine
250 les techniques de gravure à l'œuvre dans LilyPond. Il inclut également
251 des comparaisons entre LilyPond et d'autres logiciels de notation
254 @warning{il est plus facile d'examiner les détails typographiques dans
255 l'édition de ce manuel au format PDF, car elle peut être vue à une plus
260 @divClass{column-right-bottom}
262 @docLinks{Essai, essay,
263 @ressaynamed{Top,Essai},
264 @manualStableEssaySplit-fr,
265 @manualStableEssayBig-fr, 2 MB,
266 @manualStableEssayPdf-fr, 2.5 MB}
272 @unnumberedsec Notation
273 @translationof Notation
275 @divClass{column-left-top}
276 @subheading Manuel de notation
278 Ce manuel détaille toutes les commandes LilyPond produisant une notation
279 musicale. La lecture de cet ouvrage requiert une bonne compréhension des
280 concepts exposés dans le manuel d'initiation.
282 @warning{L'utilisation optimale du manuel de notation requiert une
283 familiarité avec les concepts et fonctions de base exposés dans le
284 manuel de notation, ainsi que les concepts musicaux exposés dans le
289 @divClass{column-right-bottom}
291 @docLinks{Notation, notation,
292 @rusernamed{Top,Notation},
293 @manualStableNotationSplit-fr,
294 @manualStableNotationBig-fr, 7 MB,
295 @manualStableNotationPdf-fr, 18 MB}
301 @unnumberedsec Utilisation
304 @divClass{column-left-top}
305 @subheading Manuel d'utilisation des programmes
307 Ce manuel explique l'exécution des programmes et l'intégration de
308 partitions LilyPond dans d'autres programmes, et suggère des @qq{bonnes
309 pratiques} pour une utilisation plus efficace. Sa lecture est
310 recommandée avant d'aborder de grands projets.
314 @divClass{column-right-bottom}
316 @docLinks{Utilisation des programmes, usage,
317 @rprogramnamed{Top,Utilisation des programmes},
318 @manualStableUsageSplit-fr,
319 @manualStableUsageBig-fr, 300 KB,
320 @manualStableUsagePdf-fr, 400 KB}
325 @node Morceaux choisis
326 @unnumberedsec Morceaux choisis
327 @translationof Snippets
329 @divClass{column-left-top}
330 @subheading Morceaux choisis
332 Il s'agit d'une sélection de petits exemples montrant des trucs,
333 astuces et fonctionnalités particulières de LilyPond, issus de
334 @uref{http://lsr@/.dsi@/.unimi@/.it,LilyPond Snippet Repository}
335 (LSR). Tous ces exemples sont dans le domaine public.
337 Notez bien que cette annexe n'est en aucune manière un miroir ou même
338 une partie du LSR. Dans la mesure où le LSR repose sur une version
339 stable de LilyPond, les exemples illustrant des fonctionnalités
340 introduites dans la dernière version de développement ne peuvent y
341 figurer@tie{}; c'est pourquoi vous les trouverez dans le répertoire
342 @file{Documentation/snippets/new/} des sources de LilyPond.
344 La liste des exemples correspondant à chacun des sous-chapitres du
345 manuel de notation est accessible par des liens dans le paragraphe
349 @divClass{column-right-bottom}
351 @docLinks{Morceaux choisis, snippets,
352 @rlsrnamed{Top, Morceaux choisis},
353 @manualStableSnippetsSplit,
354 @manualStableSnippetsBig, 2.5 MB,
355 @manualStableSnippetsPdf, 8 MB}
364 @divClass{column-center-top}
365 @subheading Foire aux questions
367 @subsubheading Où sont la vue graphique, les menus et barres d'outils ?
369 LilyPond demande que la musique soit écrite comme du texte. Lisez la
370 partie à propos de l'@ref{Entrée sous forme de texte}.
373 @subsubheading La documentation est si longue ! Dois-je vraiment la lire ?
375 Vous devez lire le @ref{Initiation,manuel d'initiation}. Pour le reste
376 de la documentation, vous n'avez besoin de lire que ce qui est en
377 rapport avec la notation musicale que vous voulez produire.
380 @subsubheading Ça fait encore beaucoup à lire ! Ai-je besoin de lire tout cela ?
382 C'est vous qui voyez@tie{}; les raisons pour lesquelles vous souhaitez
383 utiliser LilyPond se trouvent peut-être dans l'@ref{Introduction}.
387 @divClass{column-center-bottom}
388 @subheading Questions d'utilisation
390 @subsubheading Quelque chose ne fonctionne pas ! Comment je le répare ?
392 C'est expliqué dans @rprogram{Résolution de problèmes}.
395 @subsubheading Pourquoi changez-vous la syntaxe ?
397 C'est expliqué dans @rprogram{LilyPond une langue vivante}.
406 @divClass{column-left-top}
409 Ce document fournit des informations générales sur LilyPond et sur les
410 outils de la communauté, c'est-à-dire les listes de discussion, les
411 rapports de bogues et le développement.
415 @divClass{column-right-bottom}
418 @subsubheading La version que vous consultez actuellement
420 @divClass{keep-bullets}
426 @subsubheading Web de la version @versionDevel
430 @manualStableWebSplit-fr,
431 @manualStableWebBig-fr, 1 MB,
432 @manualStableWebPdf-fr, 2 MB}
438 @unnumberedsec Nouveautés
439 @translationof Changes
441 @divClass{column-left-top}
442 @subheading Nouveautés
444 C'est une liste des changements visibles pour l'utilisateur et des
445 nouvelles fonctionnalités de LilyPond depuis la dernière version stable.
449 @divClass{column-right-bottom}
451 @docLinks{Nouveautés, changes,
452 @rglosnamed{Top,Nouveautés},
453 @manualStableChangesSplit,
454 @manualStableChangesBig, 6 KB,
455 @manualStableChangesPdf, 200 KB}
461 @unnumberedsec Extension
462 @translationof Extending
464 @divClass{column-left-top}
465 @subheading Extension des fonctionnalités de LilyPond
467 Ce manuel (non traduit à ce jour) vous donnera des pistes en matière de
468 programmation avancée d’ajustements et retouches dans LilyPond.
472 @divClass{column-right-bottom}
474 @docLinks{Extension, extending,
475 @rextendnamed{Top,Extension},
476 @manualStableExtendingSplit,
477 @manualStableExtendingBig, 200 KB,
478 @manualStableExtendingPdf, 400 KB}
483 @node Propriétés internes
484 @unnumberedsec Propriétés internes
485 @translationof Internals
487 @divClass{column-left-top}
488 @subheading Référence des propriétés internes
490 C'est un ensemble de pages étroitement liées entre elles, qui documente
491 les moindres petits détails de chaque classe, objet et fonction de
492 LilyPond. Cette documentation est produite directement à partir des
493 définitions de formatage du code source.
495 Presque toutes les fonctions de formatage utilisées en interne sont
496 directement disponibles pour l'utilisateur. Par exemple, toutes les
497 variables qui contrôlent les épaisseurs, les distances etc., peuvent
498 être modifiées dans les fichiers d'entrée. Il y a un grand nombre
499 d'options de formatage, et elles sont toutes décrites dans ce document.
500 Chaque section du manuel de notation a un paragraphe @b{Voir aussi}, qui
501 renvoie à la documentation générée automatiquement.
505 @divClass{column-right-bottom}
507 @docLinks{Référence des propriétés internes, internals,
508 @rinternalsnamed{Top,Référence des propriétés internes},
509 @manualStableInternalsSplit,
510 @manualStableInternalsBig, 2.5 MB,
511 @manualStableInternalsPdf, 2.8 MB}
517 @unnumberedsec Traductions
518 @translationof Translated
520 @divClass{column-center-bottom}
521 @subheading État des traductions
523 @include translations.itexi
532 @divClass{column-left-top}
533 @subheading Versions disponibles au téléchargement
536 L'intégrale de la documentation est disponible sous forme d'archive à
537 l'adresse @uref{http://lilypond.org}
541 @divClass{keep-bullets}
544 @item @doctarballStable-fr
553 @divClass{column-right-bottom}
554 @subheading Versions stables antérieures
556 @divClass{keep-bullets}
559 @item @uref{http://lilypond.org/doc/v2.12/Documentation/,
560 LilyPond 2.12 Documentation}
562 @item @uref{http://lilypond.org/doc/v2.10/Documentation/,
563 LilyPond 2.10 Documentation}
565 @item @uref{http://lilypond.org/doc/v2.8/Documentation/,
566 LilyPond 2.8 Documentation}
568 @item @uref{http://lilypond.org/doc/v2.6/Documentation/,
569 LilyPond 2.6 Documentation}
571 @item @uref{http://lilypond.org/doc/v2.4/Documentation/out-www/,
572 LilyPond 2.4 Documentation}
574 @item @uref{http://lilypond.org/doc/v2.2/Documentation/out-www/,
575 LilyPond 2.2 Documentation}
577 @item @uref{http://lilypond.org/doc/v2.0/Documentation/out-www/,
578 LilyPond 2.0 Documentation}
580 @item @uref{http://lilypond.org/doc/v1.8/Documentation/out-www/,
581 LilyPond 1.8 Documentation}
583 @item @uref{http://lilypond.org/doc/v1.6/Documentation/out-www/,
584 LilyPond 1.6 Documentation}
594 @divClass{column-center-top}
595 @subheading Licence de la documentation
597 La documentation de GNU LilyPond est publiée selon les termes de la
598 @emph{GNU Free Documentation License}. Une brève introduction à cette
599 licence ainsi que les motifs qui nous ont fait l'adopter se trouvent à
600 la page @ref{Liberté}.
604 @divClass{column-center-bottom}
605 @subheading GNU Free Documentation License 1.1