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\})
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}@tie{}:
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
139 @ref{Traductions}@tie{}:
140 état des traductions pour les lecteurs non anglophones.
144 liens rapides, manuels téléchargeables, et documentation des anciennes
148 @ref{Développement}@tie{}:
149 manuels pour la version de développement.
153 ces manuels sont publiés sous la licence GNU de documentation libre FDL.
164 * Initiation:: Premiers pas
165 * Glossaire:: Glossaire musicologique multilingue
166 * Essai:: Pourquoi LilyPond
167 * Notation:: Référence en matière de notation
168 * Utilisation:: Les différentes composantes de LilyPond
169 * Morceaux choisis:: Exemples de code, trucs et astuces
170 * FAQ:: Foire aux questions
171 * Web:: Le site de LilyPond
172 * Nouveautés:: Ce qui change au fil des versions
173 * Extension:: Programmation au sein de LilyPond
174 * Propriétés internes:: Références du programme
175 * Traductions:: État d'avancement des différentes traductions
176 * Tous:: Tous les manuels
183 @c TRANSLATORS, most of the text in this file came from
184 @c LM 1.1 About the documentation (before this section was
185 @c removed in July 2009).
188 @unnumberedsec Initiation
189 @translationof Learning
191 @divClass{column-left-top}
192 @subheading Manuel d'initiation
194 Ce manuel explique comment débuter avec LilyPond, et expose de manière
195 simple quelques concepts clés. Il est conseillé de lire ces chapitres
198 Dans ce manuel se trouve à chaque section un paragraphe @strong{Voir
199 aussi} contenant des références vers d'autres sections@tie{}: il est
200 conseillé de ne pas les suivre en première lecture@tie{}; lorsque vous
201 aurez lu l'ensemble du manuel d'initiation, vous pourrez en relisant
202 certaines sections suivre ces références pour approfondir certains
206 @divClass{column-right-bottom}
208 @docLinks{Initiation, learning,
209 @rlearningnamed{Top,Initiation},
210 @manualStableLearningSplit-fr,
211 @manualStableLearningBig-fr, 1.5 MB,
212 @manualStableLearningPdf-fr, 3 MB}
218 @unnumberedsec Glossaire
219 @translationof Glossary
221 @divClass{column-left-top}
222 @subheading Glossaire
224 Ce document explique en anglais des termes musicaux, et donne leur
225 traduction dans diverses langues. Si vous n'êtes pas familier avec la
226 notation et la terminologie musicales, il est conseillé de consulter le
227 glossaire, notamment pour les parties non encore traduites de la
232 @divClass{column-right-bottom}
234 @docLinks{Glossaire musical, music-glossary,
235 @rglosnamed{Top,Glossaire musical},
236 @manualStableGlossarySplit,
237 @manualStableGlossaryBig, 1 MB,
238 @manualStableGlossaryPdf, 1.5 MB}
247 @divClass{column-left-top}
250 Ce document résume l'histoire de la typographie musicale, puis examine
251 les techniques de gravure à l'œuvre dans LilyPond. Il inclut également
252 des comparaisons entre LilyPond et d'autres logiciels de notation
255 @warning{il est plus facile d'examiner les détails typographiques dans
256 l'édition de ce manuel au format PDF, car elle peut être vue à une plus
261 @divClass{column-right-bottom}
263 @docLinks{Essai, essay,
264 @ressaynamed{Top,Essai},
265 @manualStableEssaySplit-fr,
266 @manualStableEssayBig-fr, 2 MB,
267 @manualStableEssayPdf-fr, 2.5 MB}
273 @unnumberedsec Notation
274 @translationof Notation
276 @divClass{column-left-top}
277 @subheading Manuel de notation
279 Ce manuel détaille toutes les commandes LilyPond produisant une notation
280 musicale. La lecture de cet ouvrage requiert une bonne compréhension des
281 concepts exposés dans le manuel d'initiation.
283 @warning{L'utilisation optimale du manuel de notation requiert une
284 familiarité avec les concepts et fonctions de base exposés dans le
285 manuel de notation, ainsi que les concepts musicaux exposés dans le
290 @divClass{column-right-bottom}
292 @docLinks{Notation, notation,
293 @rusernamed{Top,Notation},
294 @manualStableNotationSplit-fr,
295 @manualStableNotationBig-fr, 7 MB,
296 @manualStableNotationPdf-fr, 18 MB}
302 @unnumberedsec Utilisation
305 @divClass{column-left-top}
306 @subheading Manuel d'utilisation des programmes
308 Ce manuel explique l'exécution des programmes et l'intégration de
309 partitions LilyPond dans d'autres programmes, et suggère des @qq{bonnes
310 pratiques} pour une utilisation plus efficace. Sa lecture est
311 recommandée avant d'aborder de grands projets.
315 @divClass{column-right-bottom}
317 @docLinks{Utilisation des programmes, usage,
318 @rprogramnamed{Top,Utilisation des programmes},
319 @manualStableUsageSplit-fr,
320 @manualStableUsageBig-fr, 300 KB,
321 @manualStableUsagePdf-fr, 400 KB}
326 @node Morceaux choisis
327 @unnumberedsec Morceaux choisis
328 @translationof Snippets
330 @divClass{column-left-top}
331 @subheading Morceaux choisis
333 Il s'agit d'une sélection de petits exemples montrant des trucs,
334 astuces et fonctionnalités particulières de LilyPond, issus de
335 @uref{http://lsr@/.dsi@/.unimi@/.it,LilyPond Snippet Repository}
336 (LSR). Tous ces exemples sont dans le domaine public.
338 Notez bien que cette annexe n'est en aucune manière un miroir ou même
339 une partie du LSR. Dans la mesure où le LSR repose sur une version
340 stable de LilyPond, les exemples illustrant des fonctionnalités
341 introduites dans la dernière version de développement ne peuvent y
342 figurer@tie{}; c'est pourquoi vous les trouverez dans le répertoire
343 @file{Documentation/snippets/new/} des sources de LilyPond.
345 La liste des exemples correspondant à chacun des sous-chapitres du
346 manuel de notation est accessible par des liens dans le paragraphe
350 @divClass{column-right-bottom}
352 @docLinks{Morceaux choisis, snippets,
353 @rlsrnamed{Top, Morceaux choisis},
354 @manualStableSnippetsSplit,
355 @manualStableSnippetsBig, 2.5 MB,
356 @manualStableSnippetsPdf, 8 MB}
365 @divClass{column-center-top}
366 @subheading Foire aux questions
368 @subsubheading Où sont la vue graphique, les menus et barres d'outils ?
370 LilyPond demande que la musique soit écrite comme du texte. Lisez la
371 partie à propos de l'@ref{Entrée sous forme de texte}.
374 @subsubheading La documentation est si longue ! Dois-je vraiment la lire ?
376 Vous devez lire le @ref{Initiation,manuel d'initiation}. Pour le reste
377 de la documentation, vous n'avez besoin de lire que ce qui est en
378 rapport avec la notation musicale que vous voulez produire.
381 @subsubheading Ça fait encore beaucoup à lire ! Ai-je besoin de lire tout cela ?
383 C'est vous qui voyez@tie{}; les raisons pour lesquelles vous souhaitez
384 utiliser LilyPond se trouvent peut-être dans l'@ref{Introduction}.
388 @divClass{column-center-bottom}
389 @subheading Questions d'utilisation
391 @subsubheading Quelque chose ne fonctionne pas ! Comment je le répare ?
393 C'est expliqué dans @rprogram{Résolution de problèmes}.
396 @subsubheading Pourquoi changez-vous la syntaxe ?
398 C'est expliqué dans @rprogram{LilyPond une langue vivante}.
407 @divClass{column-left-top}
410 Ce document fournit des informations générales sur LilyPond et sur les
411 outils de la communauté, c'est-à-dire les listes de discussion, les
412 rapports de bogues et le développement.
416 @divClass{column-right-bottom}
419 @subsubheading La version que vous consultez actuellement
421 @divClass{keep-bullets}
427 @subsubheading Web de la version @versionDevel
431 @manualStableWebSplit-fr,
432 @manualStableWebBig-fr, 1 MB,
433 @manualStableWebPdf-fr, 2 MB}
439 @unnumberedsec Nouveautés
440 @translationof Changes
442 @divClass{column-left-top}
443 @subheading Nouveautés
445 C'est une liste des changements visibles pour l'utilisateur et des
446 nouvelles fonctionnalités de LilyPond depuis la dernière version stable.
450 @divClass{column-right-bottom}
452 @docLinks{Nouveautés, changes,
453 @rchcangesnamed{Top,Nouveautés},
454 @manualStableChangesSplit,
455 @manualStableChangesBig, 6 KB,
456 @manualStableChangesPdf, 200 KB}
462 @unnumberedsec Extension
463 @translationof Extending
465 @divClass{column-left-top}
466 @subheading Extension des fonctionnalités de LilyPond
468 Ce manuel (non traduit à ce jour) vous donnera des pistes en matière de
469 programmation avancée d’ajustements et retouches dans LilyPond.
473 @divClass{column-right-bottom}
475 @docLinks{Extension, extending,
476 @rextendnamed{Top,Extension},
477 @manualStableExtendingSplit,
478 @manualStableExtendingBig, 200 KB,
479 @manualStableExtendingPdf, 400 KB}
484 @node Propriétés internes
485 @unnumberedsec Propriétés internes
486 @translationof Internals
488 @divClass{column-left-top}
489 @subheading Référence des propriétés internes
491 C'est un ensemble de pages étroitement liées entre elles, qui documente
492 les moindres petits détails de chaque classe, objet et fonction de
493 LilyPond. Cette documentation est produite directement à partir des
494 définitions de formatage du code source.
496 Presque toutes les fonctions de formatage utilisées en interne sont
497 directement disponibles pour l'utilisateur. Par exemple, toutes les
498 variables qui contrôlent les épaisseurs, les distances etc., peuvent
499 être modifiées dans les fichiers d'entrée. Il y a un grand nombre
500 d'options de formatage, et elles sont toutes décrites dans ce document.
501 Chaque section du manuel de notation a un paragraphe @b{Voir aussi}, qui
502 renvoie à la documentation générée automatiquement.
506 @divClass{column-right-bottom}
508 @docLinks{Référence des propriétés internes, internals,
509 @rinternalsnamed{Top,Référence des propriétés internes},
510 @manualStableInternalsSplit,
511 @manualStableInternalsBig, 2.5 MB,
512 @manualStableInternalsPdf, 2.8 MB}
518 @unnumberedsec Traductions
519 @translationof Translated
521 @divClass{column-center-bottom}
522 @subheading État des traductions
524 @include translations.itexi
533 @divClass{column-left-top}
534 @subheading Versions disponibles au téléchargement
537 L'intégrale de la documentation est disponible sous forme d'archive à
538 l'adresse @uref{http://lilypond.org}
542 @divClass{keep-bullets}
545 @item @doctarballStable-fr
554 @divClass{column-right-bottom}
555 @subheading Versions stables antérieures
557 @divClass{keep-bullets}
560 @item @uref{http://lilypond.org/doc/v2.12/Documentation/,
561 LilyPond 2.12 Documentation}
563 @item @uref{http://lilypond.org/doc/v2.10/Documentation/,
564 LilyPond 2.10 Documentation}
566 @item @uref{http://lilypond.org/doc/v2.8/Documentation/,
567 LilyPond 2.8 Documentation}
569 @item @uref{http://lilypond.org/doc/v2.6/Documentation/,
570 LilyPond 2.6 Documentation}
572 @item @uref{http://lilypond.org/doc/v2.4/Documentation/out-www/,
573 LilyPond 2.4 Documentation}
575 @item @uref{http://lilypond.org/doc/v2.2/Documentation/out-www/,
576 LilyPond 2.2 Documentation}
578 @item @uref{http://lilypond.org/doc/v2.0/Documentation/out-www/,
579 LilyPond 2.0 Documentation}
581 @item @uref{http://lilypond.org/doc/v1.8/Documentation/out-www/,
582 LilyPond 1.8 Documentation}
584 @item @uref{http://lilypond.org/doc/v1.6/Documentation/out-www/,
585 LilyPond 1.6 Documentation}
595 @divClass{column-center-top}
596 @subheading Licence de la documentation
598 La documentation de GNU LilyPond est publiée selon les termes de la
599 @emph{GNU Free Documentation License}. Une brève introduction à cette
600 licence ainsi que les motifs qui nous ont fait l'adopter se trouvent à
601 la page @ref{Liberté}.
605 @divClass{column-center-bottom}
606 @subheading GNU Free Documentation License 1.1