@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
@c This file is part of web.texi
@ignore
- Translation of GIT committish: 7b34eac90f81c8123feaf2670fafae236101f14c
+ Translation of GIT committish: 45d5c47caba98ccd97dadbc44234c8de1f3570ab
When revising a translation, copy the HEAD committish of the
version that you are working on. For details, see the Contributors'
Guide, node Updating translation committishes..
@end ignore
+@c Translators: John Mandereau
+@c Translation checkers: Jean-Charles Malahieude
@node Manuels
@unnumbered Manuels
@translationof Manuals
+@macro details{reference}
+@spanClass{detail}
+(@ref{\reference\, détails de \reference\})
+@spanEnd
+@end macro
+
+
@divClass{heading-center}
-@heading Documentation pour LilyPond @versionStable
+@ifclear web_version
+ @heading Documentation pour LilyPond @version
+@end ifclear
+@ifset web_version
+ @heading Documentation pour LilyPond @versionStable
+@end ifset
@divEnd
-@c TODO: do we want these links to be in larger text / bold ? CSS.
+@divClass{link-headings}
-@c if you change this page, also change All.
@divClass{column-center-top}
@subheading Introduction
@itemize
-@item @ref{Entrée sous forme de texte} :
+@item
+@ref{Entrée sous forme de texte} :
LilyPond est un système de gravure musicale @strong{en mode texte}. Si
-vous ne savez pas du tout ce que ça veut dire, lisez tout d'abord ceci !
+vous ne savez pas du tout ce que ça veut dire, lisez tout d'abord
+ceci@tie{}!
-@item @ref{Initiation} :
+@item
+@ifWebLinks{@manualStableLearningSplitNoName-fr,@rlearningnamed{Top,Initiation}}
une introduction pas-à-pas à LilyPond.
-
-@item @ref{Glossaire} :
-@emph{(lecture optionnelle)}
-répertoire de définition et de traduction de termes musicaux, utile en
-particulier pour connaître les termes musicaux en anglais.
-
-@item @ref{Essai} :
-@emph{(lecture optionnelle)}
-essai sur la conception des processus de gravure d'après l'esthétique et
-la technique de la gravure traditionnelle avec poiçons et plaques de plomb.
-
+@details{Initiation}
+
+@item
+@ifWebLinks{@manualStableGlossarySplitNoName,@rglosnamed{Top,Glossaire}}
+@emph{(lecture optionnelle)} répertoire de définition et de traduction
+de termes musicaux, utile en particulier pour connaître les termes
+musicaux en anglais.
+@details{Glossaire}
+
+@item
+@ifWebLinks{@manualStableEssaySplitNoName-fr,@ressaynamed{Top,Essai}}
+@emph{(lecture optionnelle)} essai sur la conception des processus de
+gravure d'après l'esthétique et la technique de la gravure
+traditionnelle avec poinçons et plaques de plomb.
+@details{Essai}
@end itemize
@itemize
-@item @ref{Notation} :
-the main portion of the documentation; provides detailed
-information about creating notation.
+@item
+@ifWebLinks{@manualStableNotationSplitNoName-fr,@rusernamed{Top,Notation}}
+partie la plus importante de la documentation, ce manuel fournit toutes
+les informations détaillées dont vous aurez besoin en matière de notation.
+@details{Notation}
-@item @ref{Utilisation} :
-discusses the actual programs and operating system-specific
-issues.
+@item
+@ifWebLinks{@manualStableUsageSplitNoName-fr,@rprogramnamed{Top,Utilisation}}
+présentation des différentes composantes de LilyPond, ainsi que les
+particularités de certains systèmes d'exploitation.
+@details{Utilisation}
-@item @ref{Exemples de codes} :
+@item
+@ifWebLinks{@manualStableSnippetsSplitNoName,@rlsrnamed{Top,Morceaux choisis}}
courts extraits, trucs, modèles et autres exemples.
+@details{Morceaux choisis}
@end itemize
@itemize
-@item @ref{Web} :
-Ce document.
+@item
+@ref{FAQ} :
+la Foire Aux Questions.
-@item @ref{FAQ} :
-pointe vers la Foire Aux Questions.
+@item
+@ref{Top, Web} :
+ce document.
+@details{Web}
-@item @ref{Nouveautés} :
+@item
+@ifWebLinks{@manualStableChangesSplitNoName,@rchangesnamed{Top,Nouveautés}}
changements depuis la dernière version stable.
+@details{Nouveautés}
-@item @ref{Extension} :
+@item
+@ifWebLinks{@manualStableExtendingSplitNoName,@rextendnamed{Top,Extension}}
programmation avancée d'ajustements et retouches dans LilyPond.
+@details{Extension}
-@item @ref{Propriétés internes} :
+@item
+@ifWebLinks{@manualStableInternalsSplitNoName,@rinternalsnamed{Top,Propriétés internes}}
information sur les structures internes de LilyPond, nécessaire en
particulier pour élaborer des retouches.
+@details{Propriétés internes}
@end itemize
@itemize
-@item @ref{Traductions} :
+@item
+@ref{Tous} :
+liens rapides, manuels téléchargeables, et documentation des anciennes
+versions.
+
+@item
+@ref{Traductions} :
état des traductions pour les lecteurs non anglophones.
-@item @ref{Tous} :
-liens rapides, manuels téléchargeables, manuels téléchargeables, et
-documentation des anciennes versions.
+@item
+@uref{http://lsr@/.di@/.unimi@/.it,LilyPond Snippet Repository} :
+collection d'exemples, trucs et astuces élaborés par des utilisateurs.
-@item @ref{Développement} :
+@item
+@uref{http://bit.ly/LilyPondBeginners,Tutoriels vidéo} : Ben Lemon,
+utilisateur de LilyPond, a mis en ligne sur son @emph{blog} plusieurs
+tutoriels destinés aux nouveaux utilisateurs.
+
+@item
+@ref{Développement} :
manuels pour la version de développement.
-@item @ref{FDL} :
+@item
+@ref{FDL} :
ces manuels sont publiés sous la licence GNU de documentation libre FDL.
@end itemize
@divEnd
+@divClass{column-center-bottom}
+@subheading Format des manuels
+
+Les manuels de LilyPond sont disponibles sous différents formats : HTML
+multifichiers, fichier monolithique HTML ou PDF.@*
+Le HTML découpé en plusieurs fichiers est tout à fait adapté à une
+consultation en ligne. Les formats HTML en fichier unique -- certains
+ont une taille conséquente -- contiennent l'intégralité d'un manuel sur
+une seule page. Les exemplaires PDF sont plutôt destinés au
+téléchargement pour consultation hors ligne. Ces trois formats sont
+accessibles en suivant le lien « détail de@dots{} » de chacun des manuels.
+
+@divEnd
+
+@divEnd
+
@divClass{hide}
@menu
-* Initiation::
-* Glossaire::
-* Essai::
-* Notation:: Reference.
-* Utilisation::
-* Exemples de codes::
-* Web:: Web.
-* FAQ:: FAQ.
-* Nouveautés::
-* Extension::
-* Propriétés internes::
-* Traductions::
-* Tous::
-* FDL:: Licence.
+* Initiation:: Premiers pas
+* Glossaire:: Glossaire musicologique multilingue
+* Essai:: Pourquoi LilyPond
+* Notation:: Référence en matière de notation
+* Utilisation:: Les différentes composantes de LilyPond
+* Morceaux choisis:: Exemples de code, trucs et astuces
+* FAQ:: Foire aux questions
+* Web:: Le site de LilyPond
+* Nouveautés:: Ce qui change au fil des versions
+* Extension:: Programmation au sein de LilyPond
+* Propriétés internes:: Références du programme
+* Traductions:: État d'avancement des différentes traductions
+* Tous:: Tous les manuels
+* FDL:: Licence.
@end menu
@divEnd
de manière linéaire.
Dans ce manuel se trouve à chaque section un paragraphe @strong{Voir
-aussi} contenant des références vers d'autres sections : il est
-conseillé de ne pas les suivre en première lecture ; lorsque vous
+aussi} contenant des références vers d'autres sections : il est
+conseillé de ne pas les suivre en première lecture ; lorsque vous
aurez lu l'ensemble du manuel d'initiation, vous pourrez en relisant
certaines sections suivre ces références pour approfondir certains
aspects.
@docLinks{Initiation, learning,
@rlearningnamed{Top,Initiation},
- @manualStableLearningSplit,
- @manualStableLearningBig, 1.5 MB,
- @manualStableLearningPdf, 3 MB}
+ @manualStableLearningSplit-fr,
+ @manualStableLearningBig-fr, @w{3 MB},
+ @manualStableLearningPdf-fr, @w{5 MB}}
@divEnd
@docLinks{Glossaire musical, music-glossary,
@rglosnamed{Top,Glossaire musical},
@manualStableGlossarySplit,
- @manualStableGlossaryBig, 1 MB,
- @manualStableGlossaryPdf, 1.5 MB}
+ @manualStableGlossaryBig, @w{1 MB},
+ @manualStableGlossaryPdf, @w{1,5 MB}}
@divEnd
@docLinks{Essai, essay,
@ressaynamed{Top,Essai},
- @manualStableEssaySplit,
- @manualStableEssayBig, 2 MB,
- @manualStableEssayPdf, 2.5 MB}
+ @manualStableEssaySplit-fr,
+ @manualStableEssayBig-fr, @w{1 MB},
+ @manualStableEssayPdf-fr, @w{2 MB}}
@divEnd
musicale. La lecture de cet ouvrage requiert une bonne compréhension des
concepts exposés dans le manuel d'initiation.
-@warning{l'utilisation optimale du manuel de notation requiert une
+@warning{L'utilisation optimale du manuel de notation requiert une
familiarité avec les concepts et fonctions de base exposés dans le
-manuel de notation, ainsi que les concepts musicaux exposés dans le
+manuel d'initiation, ainsi que les concepts musicaux exposés dans le
glossaire.}
@divEnd
@docLinks{Notation, notation,
@rusernamed{Top,Notation},
- @manualStableNotationSplit,
- @manualStableNotationBig, 7 MB,
- @manualStableNotationPdf, 18 MB}
+ @manualStableNotationSplit-fr,
+ @manualStableNotationBig-fr, @w{9 MB},
+ @manualStableNotationPdf-fr, @w{35 MB}}
@divEnd
@subheading Manuel d'utilisation des programmes
Ce manuel explique l'exécution des programmes et l'intégration de
-partitions LilyPond dans d'autres programmes, et suggère des @qq{bonnes
-pratiques} pour une utilisation plus efficace. Sa lecture est
+partitions LilyPond dans d'autres programmes, et suggère des « bonnes
+pratiques » pour une utilisation plus efficace. Sa lecture est
recommandée avant d'aborder de grands projets.
@divEnd
@docLinks{Utilisation des programmes, usage,
@rprogramnamed{Top,Utilisation des programmes},
- @manualStableUsageSplit,
- @manualStableUsageBig, 300 KB,
- @manualStableUsagePdf, 400 KB}
+ @manualStableUsageSplit-fr,
+ @manualStableUsageBig-fr, @w{400 KB},
+ @manualStableUsagePdf-fr, @w{650 KB}}
@divEnd
-@node Exemples de codes
-@unnumberedsec Exemples de code
+@node Morceaux choisis
+@unnumberedsec Morceaux choisis
@translationof Snippets
@divClass{column-left-top}
-@subheading Exemples de code
+@subheading Morceaux choisis
Il s'agit d'une sélection de petits exemples montrant des trucs,
astuces et fonctionnalités particulières de LilyPond, issus de
-@uref{http://lsr@/.dsi@/.unimi@/.it,LilyPond Snippet Repository}
+@uref{http://lsr@/.di@/.unimi@/.it,LilyPond Snippet Repository}
(LSR). Tous ces exemples sont dans le domaine public.
Notez bien que cette annexe n'est en aucune manière un miroir ou même
une partie du LSR. Dans la mesure où le LSR repose sur une version
stable de LilyPond, les exemples illustrant des fonctionnalités
introduites dans la dernière version de développement ne peuvent y
-figurer ; c'est pourquoi vous les trouverez dans le répertoire
+figurer ; c'est pourquoi vous les trouverez dans le répertoire
@file{Documentation/snippets/new/} des sources de LilyPond.
La liste des exemples correspondant à chacun des sous-chapitres du
@divClass{column-right-bottom}
-@docLinks{Extraits de code, snippets,
- @rlsrnamed{Top, Extraits de code},
+@docLinks{Morceaux choisis, snippets,
+ @rlsrnamed{Top, Morceaux choisis},
@manualStableSnippetsSplit,
- @manualStableSnippetsBig, 2.5 MB,
- @manualStableSnippetsPdf, 8 MB}
-
-@divEnd
-
-
-@node Web
-@unnumberedsec Web
-@translationof Web
-
-@divClass{column-left-top}
-@subheading Web
-
-Ce document fournit des informations générales sur LilyPond et sur les
-outils de la communauté, c'est-à-dire les listes de discussion, les
-rapports de bogues et le développement.
-
-@divEnd
-
-@divClass{column-right-bottom}
-
-@docLinks{Web, web,
- @ref{Top,,,,Web},
- @manualStableWebSplit,
- @manualStableWebBig, 1 MB,
- @manualStableWebPdf, 2 MB}
+ @manualStableSnippetsBig, @w{1,5 MB},
+ @manualStableSnippetsPdf, @w{12,5 MB}}
@divEnd
@divClass{column-center-top}
@subheading Foire aux questions
-@subsubheading Où sont la vue graphique, les menus et barres d'outils ?
+@subsubheading Où sont la vue graphique, les menus et barres d'outils ?
LilyPond demande que la musique soit écrite comme du texte. Lisez la
-partie à propos de l'@ref{Entrée sous forme de texte}.
+partie intitulée @ref{Entrée sous forme de texte}.
-@subsubheading La documentation est si longue ! Dois-je vraiment la lire ?
+@subsubheading La documentation est si longue ! Dois-je vraiment la lire ?
Vous devez lire le @ref{Initiation,manuel d'initiation}. Pour le reste
de la documentation, vous n'avez besoin de lire que ce qui est en
rapport avec la notation musicale que vous voulez produire.
-@subsubheading Ça fait encore beaucoup à lire ! Ai-je besoin de lire tout cela ?
+@subsubheading Ça fait encore beaucoup à lire ! Ai-je besoin de lire tout cela ?
-Décidez-en donc vous-même ; les raisons pour lesquelles vous souhaitez
-utiliser LilyPond se trouvent peut-être dans l'@ref{Introduction}.
+C'est vous qui voyez ; les raisons pour lesquelles vous souhaitez
+utiliser LilyPond se trouvent peut-être dans notre @ref{Introduction}.
@divEnd
@divClass{column-center-bottom}
@subheading Questions d'utilisation
-@subsubheading Quelque chose ne fonctionne pas ! Comment je le répare ?
+@subsubheading Quelque chose ne fonctionne pas ! Comment je le répare ?
-@c FIXME : la section référencée ici va être déplacée -JM
-C'est expliqué dans @rlearningnamed{Résolution de problèmes -- tout
-remettre à plat,Résolution de problèmes}.
+C'est expliqué dans @rprogram{Résolution de problèmes}.
-@subsubheading Pourquoi changez-vous la syntaxe ?
+@subsubheading Pourquoi changez-vous la syntaxe ?
-@c FIXME : corriger cette phrase lorsque la section correspondante sera
-@c traduite -JM
-C'est expliqué (en anglais) dans @rprogram{Why does the syntax change?}.
+C'est expliqué dans @rprogram{LilyPond est une langue vivante}.
+
+@divEnd
+
+
+@node Web
+@unnumberedsec Web
+@translationof Web
+
+@divClass{column-left-top}
+@subheading Web
+
+Ce document fournit des informations générales sur LilyPond et sur les
+outils de la communauté, c'est-à-dire les listes de discussion, les
+rapports de bogues et le développement.
+
+@divEnd
+
+@divClass{column-right-bottom}
+@subheading À lire
+
+@subsubheading La version que vous consultez actuellement
+
+@divClass{keep-bullets}
+@itemize
+@ref{Top,Web}
+@end itemize
+@divEnd
+
+@subsubheading Web de la version @versionDevel
+
+@docLinks{Web, web,
+ @ref{Top,Web},
+ @manualDevelWebSplit-fr,
+ @manualDevelWebBig-fr, @w{2,5 MB},
+ @manualDevelWebPdf-fr, @w{3,5 MB}}
@divEnd
@divClass{column-right-bottom}
@docLinks{Nouveautés, changes,
- @rglosnamed{Top,Nouveautés},
+ @rchcangesnamed{Top,Nouveautés},
@manualStableChangesSplit,
- @manualStableChangesBig, 6 KB,
- @manualStableChangesPdf, 200 KB}
+ @manualStableChangesBig, @w{90 KB},
+ @manualStableChangesPdf, @w{80 KB}}
@divEnd
@node Extension
@unnumberedsec Extension
-@translationof Extend
+@translationof Extending
+
+@divClass{column-left-top}
+@subheading Extension des fonctionnalités de LilyPond
+
+Ce manuel vous donnera des pistes en matière de programmation avancée
+d’ajustements et retouches dans LilyPond.
+
+@divEnd
-@untranslated
+@divClass{column-right-bottom}
+
+@docLinks{Extension, extending,
+ @rextendnamed{Top,Extension},
+ @manualStableExtendingSplit-fr,
+ @manualStableExtendingBig-fr, @w{300 KB},
+ @manualStableExtendingPdf-fr, @w{500 KB}}
+
+@divEnd
@node Propriétés internes
@translationof Internals
@divClass{column-left-top}
-@subheading Référece des propriétés internes
+@subheading Référence des propriétés internes
C'est un ensemble de pages étroitement liées entre elles, qui documente
les moindres petits détails de chaque classe, objet et fonction de
LilyPond. Cette documentation est produite directement à partir des
-définitions de formatage du code source.
+définitions de formatage du code source. Elle n'est à ce jour
+disponible qu'en anglais.
Presque toutes les fonctions de formatage utilisées en interne sont
directement disponibles pour l'utilisateur. Par exemple, toutes les
-variables qui contrôlent les épaisseurs, les distances etc., peuvent
+variables qui contrôlent les épaisseurs, les distances, etc. peuvent
être modifiées dans les fichiers d'entrée. Il y a un grand nombre
d'options de formatage, et elles sont toutes décrites dans ce document.
Chaque section du manuel de notation a un paragraphe @b{Voir aussi}, qui
@docLinks{Référence des propriétés internes, internals,
@rinternalsnamed{Top,Référence des propriétés internes},
@manualStableInternalsSplit,
- @manualStableInternalsBig, 2.5 MB,
- @manualStableInternalsPdf, 2.8 MB}
+ @manualStableInternalsBig, @w{3 MB},
+ @manualStableInternalsPdf, @w{4 MB}}
@divEnd
@divClass{column-center-bottom}
@subheading État des traductions
-Désolé, l'état des traductions est indisponible en ce moment.
+@include translations.itexi
@divEnd
@unnumberedsec Tous
@translationof All
-@divClass{heading-center}
-@heading Liens rapides vers les manuels
-
-Les liens vers les autres formats de ces manuels se trouvent à
-@ref{Manuels}.
-
-@divEnd
+@divClass{column-left-top}
+@subheading Versions disponibles au téléchargement
-@c this should match the (main) manual page.
-@divClass{column-center-top}
-@subheading Introduction
+@ifclear web_version
+L'intégrale de la documentation est disponible sous forme d'archive à
+l'adresse @uref{http://lilypond.org}
+@end ifclear
+@ifset web_version
+@divClass{keep-bullets}
@itemize
-@item @rlearningnamed{Top,Initiation} :
-une introduction pas-à-pas à LilyPond.
-
-@item @rglosnamed{Top,Glossaire} :
-@emph{(lecture optionnelle)}
-répertoire de définition et de traduction de termes musicaux, utile en
-particulier pour connaître les termes musicaux en anglais.
-
-@item @ressaynamed{Top,Essai} :
-@emph{(lecture optionnelle)}
-essai sur la conception des processus de gravure d'après l'esthétique et
-la technique de la gravure traditionnelle avec poiçons et plaques de plomb.
+@item @doctarballStable-fr
@end itemize
@divEnd
+@end ifset
-@divClass{column-left-top}
-@subheading Utilisation courante
+@divEnd
-@itemize
+@divClass{column-right-bottom}
+@subheading Versions stables antérieures
-@item @rusernamed{Top,Notation} :
-the main portion of the documentation; provides detailed
-information about creating notation.
+@divClass{keep-bullets}
+@itemize
-@item @rprogramnamed{Top,Utilisation} :
-discusses the actual programs and operating system-specific
-issues.
+@item @uref{http://lilypond.org/doc/v2.16/Documentation/web/manuals,
+LilyPond 2.16 Documentation}
-@item @rlsrnamed{Top,Exemples de codes} :
-courts extraits, trucs, modèles et autres exemples.
+@item @uref{http://lilypond.org/doc/v2.14/Documentation/web/manuals.fr.html,
+LilyPond 2.14 Documentation}
-@end itemize
+@item @uref{http://lilypond.org/doc/v2.12/Documentation/index.fr.html,
+LilyPond 2.12 Documentation}
-@divEnd
+@item @uref{http://lilypond.org/doc/v2.10/Documentation/,
+LilyPond 2.10 Documentation}
+@item @uref{http://lilypond.org/doc/v2.8/Documentation/,
+LilyPond 2.8 Documentation}
-@divClass{column-right-top}
-@subheading Utilisation ponctuelle
+@item @uref{http://lilypond.org/doc/v2.6/Documentation/,
+LilyPond 2.6 Documentation}
-@itemize
+@item @uref{http://lilypond.org/doc/v2.4/Documentation/out-www/,
+LilyPond 2.4 Documentation}
-@item @ref{FAQ} :
-pointe vers la Foire Aux Questions.
+@item @uref{http://lilypond.org/doc/v2.2/Documentation/out-www/,
+LilyPond 2.2 Documentation}
-@item @rchangesnamed{Top,Nouveautés} :
-changements depuis la dernière version stable.
+@item @uref{http://lilypond.org/doc/v2.0/Documentation/out-www/,
+LilyPond 2.0 Documentation}
-@item @rextendnamed{Top,Extension} :
-programmation avancée d'ajustements et retouches dans LilyPond.
+@item @uref{http://lilypond.org/doc/v1.8/Documentation/out-www/,
+LilyPond 1.8 Documentation}
-@item @rinternalsnamed{Top,Propriétés internes} :
-information sur les structures internes de LilyPond, nécessaire en
-particulier pour élaborer des retouches.
+@item @uref{http://lilypond.org/doc/v1.6/Documentation/out-www/,
+LilyPond 1.6 Documentation}
@end itemize
@divEnd
-
-
-@divClass{column-center-bottom}
-@subheading Versions téléchargeables
-
-À venir dans quelques mois@dots{}
-
@divEnd
+@node FDL
+@unnumberedsec FDL
+@translationof FDL
-@subheading Versions stables précédentes
-
-@divClass{keep-bullets}
-@itemize
-
-@item @uref{http://lilypond.org/doc/v2.12/Documentation/,
-Documentation de LilyPond 2.12}
-
-@item @uref{http://lilypond.org/doc/v2.10/Documentation/,
-Documentation de LilyPond 2.10}
+@divClass{column-center-top}
+@subheading Licence de la documentation
-@item @uref{http://lilypond.org/doc/v2.8/Documentation/,
-Documentation de LilyPond 2.8}
+La documentation de GNU LilyPond est publiée selon les termes de la
+@emph{GNU Free Documentation License}. Une brève introduction à cette
+licence ainsi que les motifs qui nous ont fait l'adopter se trouvent à
+la page @ref{Liberté}.
-@end itemize
-
-@divEnd
@divEnd
+@divClass{column-center-bottom}
+@subheading GNU Free Documentation License 1.1
-@node FDL
-@unnumberedsec FDL
-@translationof FDL
+@include fdl.itexi
-@untranslated
+@divEnd
projects / lilypond.git / blobdiff