1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
2 @c This file is part of web.texi
4 Translation of GIT committish: fa8dd31ed29a5ef35d76f127a795b5c2d951f5dd
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 @c TODO: do we want these links to be in larger text / bold ? CSS.
37 @divClass{column-center-top}
38 @subheading Introduction
42 @item @ref{Entrée sous forme de texte} :
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 ceci !
46 @item @ifWebLinks{@manualStableLearningSplitNoName,@rlearningnamed{Top,Initiation}}
47 une introduction pas-à-pas à LilyPond.
50 @item @ifWebLinks{@manualStableGlossarySplitNoName,@rglosnamed{Top,Glossaire}}
51 @emph{(lecture optionnelle)}
52 répertoire de définition et de traduction de termes musicaux, utile en
53 particulier pour connaître les termes musicaux en anglais.
56 @item @ifWebLinks{@manualStableEssaySplitNoName,@ressaynamed{Top,Essai}}
57 @emph{(lecture optionnelle)}
58 essai sur la conception des processus de gravure d'après l'esthétique et
59 la technique de la gravure traditionnelle avec poinçons et plaques de plomb.
67 @divClass{column-left-top}
68 @subheading Utilisation courante
72 @item @ifWebLinks{@manualStableNotationSplitNoName,@rusernamed{Top,Notation}}
73 Partie la plus importante de la documentation, ce manuel fournit toutes
74 les informations détaillées dont vous aurez besoin en matière de notation.
77 @item @ifWebLinks{@manualStableUsageSplitNoName,@rprogramnamed{Top,Utilisation}}
78 présentation des différentes composantes de LilyPond, ainsi que les
79 particularités de certains systèmes d'exploitation.
83 @ifWebLinks{@manualStableSnippetsSplitNoName,@rlsrnamed{Top,Morceaux choisis}}
84 courts extraits, trucs, modèles et autres exemples.
85 @details{Morceaux choisis}
92 @divClass{column-right-top}
93 @subheading Utilisation ponctuelle
98 pointe vers la Foire Aux Questions.
105 @ifWebLinks{@manualStableChangesSplitNoName,@rchangesnamed{Top,Nouveautés}}
106 changements depuis la dernière version stable.
109 @item @ifWebLinks{@manualStableExtendingSplitNoName,@rextendnamed{Top,Extension}}
110 programmation avancée d'ajustements et retouches dans LilyPond.
113 @item @ifWebLinks{@manualStableInternalsSplitNoName,@rinternalsnamed{Top,Propriétés internes}} :
114 information sur les structures internes de LilyPond, nécessaire en
115 particulier pour élaborer des retouches.
116 @details{Propriétés internes}
123 @divClass{column-center-bottom}
124 @subheading Autre documentation
128 @item @ref{Traductions} :
129 état des traductions pour les lecteurs non anglophones.
132 liens rapides, manuels téléchargeables, et documentation des anciennes
135 @item @ref{Development} :
136 manuels pour la version de développement.
139 ces manuels sont publiés sous la licence GNU de documentation libre FDL.
148 * Initiation:: Premiers pas
149 * Glossaire:: Glossaire musicologique multilingue
150 * Essai:: Pourquoi LilyPond
151 * Notation:: Référence en matière de notation
152 * Utilisation:: Les différentes composantes de LilyPond
153 * Morceaux choisis:: Exemples de code, trucs et astuces
155 * FAQ:: Foire aux questions
158 * Propriétés internes::
167 @c TRANSLATORS, most of the text in this file came from
168 @c LM 1.1 About the documentation (before this section was
169 @c removed in July 2009).
172 @unnumberedsec Initiation
173 @translationof Learning
175 @divClass{column-left-top}
176 @subheading Manuel d'initiation
178 Ce manuel explique comment débuter avec LilyPond, et expose de manière
179 simple quelques concepts clés. Il est conseillé de lire ces chapitres
182 Dans ce manuel se trouve à chaque section un paragraphe @strong{Voir
183 aussi} contenant des références vers d'autres sections : il est
184 conseillé de ne pas les suivre en première lecture ; lorsque vous
185 aurez lu l'ensemble du manuel d'initiation, vous pourrez en relisant
186 certaines sections suivre ces références pour approfondir certains
190 @divClass{column-right-bottom}
192 @docLinks{Initiation, learning,
193 @rlearningnamed{Top,Initiation},
194 @manualStableLearningSplit,
195 @manualStableLearningBig, 1.5 MB,
196 @manualStableLearningPdf, 3 MB}
202 @unnumberedsec Glossaire
203 @translationof Glossary
205 @divClass{column-left-top}
206 @subheading Glossaire
208 Ce document explique en anglais des termes musicaux, et donne leur
209 traduction dans diverses langues. Si vous n'êtes pas familier avec la
210 notation et la terminologie musicales, il est conseillé de consulter le
211 glossaire, notamment pour les parties non encore traduites de la
216 @divClass{column-right-bottom}
218 @docLinks{Glossaire musical, music-glossary,
219 @rglosnamed{Top,Glossaire musical},
220 @manualStableGlossarySplit,
221 @manualStableGlossaryBig, 1 MB,
222 @manualStableGlossaryPdf, 1.5 MB}
231 @divClass{column-left-top}
234 Ce document résume l'histoire de la typographie musicale, puis examine
235 les techniques de gravure à l'œuvre dans LilyPond. Il inclut également
236 des comparaisons entre LilyPond et d'autres logiciels de notation
239 @warning{il est plus facile d'examiner les détails typographiques dans
240 l'édition de ce manuel au format PDF, car elle peut être vue à une plus
245 @divClass{column-right-bottom}
247 @docLinks{Essai, essay,
248 @ressaynamed{Top,Essai},
249 @manualStableEssaySplit,
250 @manualStableEssayBig, 2 MB,
251 @manualStableEssayPdf, 2.5 MB}
257 @unnumberedsec Notation
258 @translationof Notation
260 @divClass{column-left-top}
261 @subheading Manuel de notation
263 Ce manuel détaille toutes les commandes LilyPond produisant une notation
264 musicale. La lecture de cet ouvrage requiert une bonne compréhension des
265 concepts exposés dans le manuel d'initiation.
267 @warning{L'utilisation optimale du manuel de notation requiert une
268 familiarité avec les concepts et fonctions de base exposés dans le
269 manuel de notation, ainsi que les concepts musicaux exposés dans le
274 @divClass{column-right-bottom}
276 @docLinks{Notation, notation,
277 @rusernamed{Top,Notation},
278 @manualStableNotationSplit,
279 @manualStableNotationBig, 7 MB,
280 @manualStableNotationPdf, 18 MB}
286 @unnumberedsec Utilisation
289 @divClass{column-left-top}
290 @subheading Manuel d'utilisation des programmes
292 Ce manuel explique l'exécution des programmes et l'intégration de
293 partitions LilyPond dans d'autres programmes, et suggère des @qq{bonnes
294 pratiques} pour une utilisation plus efficace. Sa lecture est
295 recommandée avant d'aborder de grands projets.
299 @divClass{column-right-bottom}
301 @docLinks{Utilisation des programmes, usage,
302 @rprogramnamed{Top,Utilisation des programmes},
303 @manualStableUsageSplit,
304 @manualStableUsageBig, 300 KB,
305 @manualStableUsagePdf, 400 KB}
310 @node Morceaux choisis
311 @unnumberedsec Morceaux choisis
312 @translationof Snippets
314 @divClass{column-left-top}
315 @subheading Morceaux choisis
317 Il s'agit d'une sélection de petits exemples montrant des trucs,
318 astuces et fonctionnalités particulières de LilyPond, issus de
319 @uref{http://lsr@/.dsi@/.unimi@/.it,LilyPond Snippet Repository}
320 (LSR). Tous ces exemples sont dans le domaine public.
322 Notez bien que cette annexe n'est en aucune manière un miroir ou même
323 une partie du LSR. Dans la mesure où le LSR repose sur une version
324 stable de LilyPond, les exemples illustrant des fonctionnalités
325 introduites dans la dernière version de développement ne peuvent y
326 figurer ; c'est pourquoi vous les trouverez dans le répertoire
327 @file{Documentation/snippets/new/} des sources de LilyPond.
329 La liste des exemples correspondant à chacun des sous-chapitres du
330 manuel de notation est accessible par des liens dans le paragraphe
334 @divClass{column-right-bottom}
336 @docLinks{Morceaux choisis, snippets,
337 @rlsrnamed{Top, Morceaux choisis},
338 @manualStableSnippetsSplit,
339 @manualStableSnippetsBig, 2.5 MB,
340 @manualStableSnippetsPdf, 8 MB}
348 @divClass{column-left-top}
351 Ce document fournit des informations générales sur LilyPond et sur les
352 outils de la communauté, c'est-à-dire les listes de discussion, les
353 rapports de bogues et le développement.
357 @divClass{column-right-bottom}
361 @manualStableWebSplit,
362 @manualStableWebBig, 1 MB,
363 @manualStableWebPdf, 2 MB}
371 @divClass{column-center-top}
372 @subheading Foire aux questions
374 @subsubheading Où sont la vue graphique, les menus et barres d'outils ?
376 LilyPond demande que la musique soit écrite comme du texte. Lisez la
377 partie à propos de l'@ref{Entrée sous forme de texte}.
380 @subsubheading La documentation est si longue ! Dois-je vraiment la lire ?
382 Vous devez lire le @ref{Initiation,manuel d'initiation}. Pour le reste
383 de la documentation, vous n'avez besoin de lire que ce qui est en
384 rapport avec la notation musicale que vous voulez produire.
387 @subsubheading Ça fait encore beaucoup à lire ! Ai-je besoin de lire tout cela ?
389 Décidez-en donc vous-même ; les raisons pour lesquelles vous souhaitez
390 utiliser LilyPond se trouvent peut-être dans l'@ref{Introduction}.
394 @divClass{column-center-bottom}
395 @subheading Questions d'utilisation
397 @subsubheading Quelque chose ne fonctionne pas ! Comment je le répare ?
399 @c FIXME : la section référencée ici va être déplacée -JM
400 C'est expliqué dans @rlearningnamed{Résolution de problèmes -- tout
401 remettre à plat,Résolution de problèmes}.
404 @subsubheading Pourquoi changez-vous la syntaxe ?
406 @c FIXME : corriger cette phrase lorsque la section correspondante sera
408 C'est expliqué (en anglais) dans @rprogram{Pourquoi la syntaxe change-t-elle?}.
414 @unnumberedsec Nouveautés
415 @translationof Changes
417 @divClass{column-left-top}
418 @subheading Nouveautés
420 C'est une liste des changements visibles pour l'utilisateur et des
421 nouvelles fonctionnalités de LilyPond depuis la dernière version stable.
425 @divClass{column-right-bottom}
427 @docLinks{Nouveautés, changes,
428 @rglosnamed{Top,Nouveautés},
429 @manualStableChangesSplit,
430 @manualStableChangesBig, 6 KB,
431 @manualStableChangesPdf, 200 KB}
437 @unnumberedsec Extension
438 @translationof Extend
443 @node Propriétés internes
444 @unnumberedsec Propriétés internes
445 @translationof Internals
447 @divClass{column-left-top}
448 @subheading Référence des propriétés internes
450 C'est un ensemble de pages étroitement liées entre elles, qui documente
451 les moindres petits détails de chaque classe, objet et fonction de
452 LilyPond. Cette documentation est produite directement à partir des
453 définitions de formatage du code source.
455 Presque toutes les fonctions de formatage utilisées en interne sont
456 directement disponibles pour l'utilisateur. Par exemple, toutes les
457 variables qui contrôlent les épaisseurs, les distances etc., peuvent
458 être modifiées dans les fichiers d'entrée. Il y a un grand nombre
459 d'options de formatage, et elles sont toutes décrites dans ce document.
460 Chaque section du manuel de notation a un paragraphe @b{Voir aussi}, qui
461 renvoie à la documentation générée automatiquement.
465 @divClass{column-right-bottom}
467 @docLinks{Référence des propriétés internes, internals,
468 @rinternalsnamed{Top,Référence des propriétés internes},
469 @manualStableInternalsSplit,
470 @manualStableInternalsBig, 2.5 MB,
471 @manualStableInternalsPdf, 2.8 MB}
477 @unnumberedsec Traductions
478 @translationof Translated
480 @divClass{column-center-bottom}
481 @subheading État des traductions
483 Désolé, l'état des traductions est indisponible en ce moment.
492 @divClass{column-left-top}
493 @subheading Versions disponibles au téléchargement
496 L'intégrale de la documentation est disponible sous forme d'archive à
497 l'adresse @uref{http://lilypond.org}
501 @divClass{keep-bullets}
504 @item @doctarballStable
513 @divClass{column-right-bottom}
514 @subheading Versions stables antérieures
516 @divClass{keep-bullets}
519 @item @uref{http://lilypond.org/doc/v2.12/Documentation/,
520 LilyPond 2.12 Documentation}
522 @item @uref{http://lilypond.org/doc/v2.10/Documentation/,
523 LilyPond 2.10 Documentation}
525 @item @uref{http://lilypond.org/doc/v2.8/Documentation/,
526 LilyPond 2.8 Documentation}
528 @help anybody want to write this stuff?
538 @divClass{column-center-top}
539 @subheading Licence de la documentation
541 La documentation de GNU LilyPond est poubliée selon les termes de la
542 @emph{GNU Free Documentation License}. Une brève introduction à cette
543 licence ainsi que les motifs qui nous ont fait l'adopter se trouvent à
544 la page @ref{Liberté}.
548 @divClass{column-center-bottom}
549 @subheading GNU Free Documentation License 1.1