]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/fr/web/manuals.itexi
Web-fr: updates community
[lilypond.git] / Documentation / fr / web / manuals.itexi
index bd9cff427bc93545d288bc78c81828c9ede22de6..fc385f73039afffbceff3f5e3520aacf7e6589b8 100644 (file)
-\input texinfo @c -*- coding: utf-8; mode: texinfo; documentlanguage: nl -*-
+@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
 @c This file is part of web.texi
 @ignore
-    Translation of GIT committish: 1b3da70d81938d19a2b107382bbe25a267cf130b
+   Translation of GIT committish: 45d5c47caba98ccd97dadbc44234c8de1f3570ab
 
     When revising a translation, copy the HEAD committish of the
-    version that you are working on.  See TRANSLATION for details.
+    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
 
-@c -*- coding: utf-8; mode: texinfo; -*-
-@node Manuals
-@unnumbered Manuals
+@node Manuels
+@unnumbered Manuels
+@translationof Manuals
 
-@untranslated
+@macro details{reference}
+@spanClass{detail}
+(@ref{\reference\, détails de \reference\})
+@spanEnd
+@end macro
 
 
 @divClass{heading-center}
-@heading Documentation for LilyPond 2.12.2
+@ifclear web_version
+  @heading Documentation pour LilyPond @version
+@end ifclear
+@ifset web_version
+  @heading Documentation pour LilyPond @versionStable
+@end ifset
+
 @divEnd
+
+@divClass{link-headings}
+
 @divClass{column-center-top}
 @subheading Introduction
+
+@itemize
+
+@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@tie{}!
+
+@item
+@ifWebLinks{@manualStableLearningSplitNoName-fr,@rlearningnamed{Top,Initiation}}
+une introduction pas-à-pas à LilyPond.
+@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
+
 @divEnd
+
 @divClass{column-left-top}
-@subheading Regular use
+@subheading Utilisation courante
+
+@itemize
+
+@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
+@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
+@ifWebLinks{@manualStableSnippetsSplitNoName,@rlsrnamed{Top,Morceaux choisis}}
+courts extraits, trucs, modèles et autres exemples.
+@details{Morceaux choisis}
+
+@end itemize
+
 @divEnd
+
+
 @divClass{column-right-top}
-@subheading Infrequent Use
+@subheading Utilisation ponctuelle
+
+@itemize
+
+@item
+@ref{FAQ} :
+la Foire Aux Questions.
+
+@item
+@ref{Top, Web} :
+ce document.
+@details{Web}
+
+@item
+@ifWebLinks{@manualStableChangesSplitNoName,@rchangesnamed{Top,Nouveautés}}
+changements depuis la dernière version stable.
+@details{Nouveautés}
+
+@item
+@ifWebLinks{@manualStableExtendingSplitNoName,@rextendnamed{Top,Extension}}
+programmation avancée d'ajustements et retouches dans LilyPond.
+@details{Extension}
+
+@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
+
+@divEnd
+
+
+@divClass{column-center-bottom}
+@subheading Autre documentation
+
+@itemize
+
+@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
+@uref{http://lsr@/.di@/.unimi@/.it,LilyPond Snippet Repository} :
+collection d'exemples, trucs et astuces élaborés par des utilisateurs.
+
+@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} :
+ces manuels sont publiés sous la licence GNU de documentation libre FDL.
+
+@end itemize
+
 @divEnd
+
 @divClass{column-center-bottom}
-@subheading Other material
+@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
-* Learning::
-* Glossary::
-* Essay::
-* Notation::
-* Usage::
-* Snippets::
-* FAQ::
-* Changes::
-* Internals::
-* Translated::
-* Old::
-* FDL::
+* 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
+
+
 @c TRANSLATORS, most of the text in this file came from
 @c LM 1.1 About the documentation  (before this section was
 @c removed in July 2009).
-@node Learning
-@unnumberedsec Learning
 
-@untranslated
+@node Initiation
+@unnumberedsec Initiation
+@translationof Learning
+
+@divClass{column-left-top}
+@subheading Manuel d'initiation
+
+Ce manuel explique comment débuter avec LilyPond, et expose de manière
+simple quelques concepts clés.  Il est conseillé de lire ces chapitres
+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
+aurez lu l'ensemble du manuel d'initiation, vous pourrez en relisant
+certaines sections suivre ces références pour approfondir certains
+aspects.
+@divEnd
+
+@divClass{column-right-bottom}
+
+@docLinks{Initiation, learning,
+  @rlearningnamed{Top,Initiation},
+  @manualStableLearningSplit-fr,
+  @manualStableLearningBig-fr, @w{3 MB},
+  @manualStableLearningPdf-fr, @w{5 MB}}
+
+@divEnd
+
+
+@node Glossaire
+@unnumberedsec Glossaire
+@translationof Glossary
+
+@divClass{column-left-top}
+@subheading Glossaire
+
+Ce document explique en anglais des termes musicaux, et donne leur
+traduction dans diverses langues.  Si vous n'êtes pas familier avec la
+notation et la terminologie musicales, il est conseillé de consulter le
+glossaire, notamment pour les parties non encore traduites de la
+documentation.
+
+@divEnd
+
+@divClass{column-right-bottom}
+
+@docLinks{Glossaire musical, music-glossary,
+  @rglosnamed{Top,Glossaire musical},
+  @manualStableGlossarySplit,
+  @manualStableGlossaryBig, @w{1 MB},
+  @manualStableGlossaryPdf, @w{1,5 MB}}
+
+@divEnd
+
+
+@node Essai
+@unnumberedsec Essai
+@translationof Essay
 
+@divClass{column-left-top}
+@subheading Essai
+
+Ce document résume l'histoire de la typographie musicale, puis examine
+les techniques de gravure à l'œuvre dans LilyPond.  Il inclut également
+des comparaisons entre LilyPond et d'autres logiciels de notation
+musicale.
 
-@node Glossary
-@unnumberedsec Glossary
+@warning{il est plus facile d'examiner les détails typographiques dans
+l'édition de ce manuel au format PDF, car elle peut être vue à une plus
+haute résolution.}
 
-@untranslated
+@divEnd
 
+@divClass{column-right-bottom}
 
-@node Essay
-@unnumberedsec Essay
+@docLinks{Essai, essay,
+  @ressaynamed{Top,Essai},
+  @manualStableEssaySplit-fr,
+  @manualStableEssayBig-fr, @w{1 MB},
+  @manualStableEssayPdf-fr, @w{2 MB}}
 
-@untranslated
+@divEnd
 
 
 @node Notation
 @unnumberedsec Notation
+@translationof Notation
+
+@divClass{column-left-top}
+@subheading Manuel de notation
+
+Ce manuel détaille toutes les commandes LilyPond produisant une notation
+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
+familiarité avec les concepts et fonctions de base exposés dans le
+manuel d'initiation, ainsi que les concepts musicaux exposés dans le
+glossaire.}
+
+@divEnd
+
+@divClass{column-right-bottom}
+
+@docLinks{Notation, notation,
+  @rusernamed{Top,Notation},
+  @manualStableNotationSplit-fr,
+  @manualStableNotationBig-fr, @w{9 MB},
+  @manualStableNotationPdf-fr, @w{35 MB}}
+
+@divEnd
+
 
-@untranslated
+@node Utilisation
+@unnumberedsec Utilisation
+@translationof Usage
 
+@divClass{column-left-top}
+@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 « bonnes
+pratiques » pour une utilisation plus efficace.  Sa lecture est
+recommandée avant d'aborder de grands projets.
+
+@divEnd
+
+@divClass{column-right-bottom}
+
+@docLinks{Utilisation des programmes, usage,
+  @rprogramnamed{Top,Utilisation des programmes},
+  @manualStableUsageSplit-fr,
+  @manualStableUsageBig-fr, @w{400 KB},
+  @manualStableUsagePdf-fr, @w{650 KB}}
 
-@node Usage
-@unnumberedsec Usage
+@divEnd
+
+
+@node Morceaux choisis
+@unnumberedsec Morceaux choisis
+@translationof Snippets
 
-@untranslated
+@divClass{column-left-top}
+@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@/.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
+@file{Documentation/snippets/new/} des sources de LilyPond.
+
+La liste des exemples correspondant à chacun des sous-chapitres du
+manuel de notation est accessible par des liens dans le paragraphe
+@strong{Voir aussi}.
+@divEnd
 
+@divClass{column-right-bottom}
 
-@node Snippets
-@unnumberedsec Snippets
+@docLinks{Morceaux choisis, snippets,
+  @rlsrnamed{Top, Morceaux choisis},
+  @manualStableSnippetsSplit,
+  @manualStableSnippetsBig, @w{1,5 MB},
+  @manualStableSnippetsPdf, @w{12,5 MB}}
 
-@untranslated
+@divEnd
 
 
 @node FAQ
 @unnumberedsec FAQ
+@translationof FAQ
 
-@untranslated
+@divClass{column-center-top}
+@subheading Foire aux questions
+
+@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 intitulée @ref{Entrée sous forme de texte}.
+
+
+@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 ?
+
+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 ?
+
+C'est expliqué dans @rprogram{Résolution de problèmes}.
+
+
+@subsubheading Pourquoi changez-vous la syntaxe ?
+
+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.
 
-@subheading Where are the graphical canvas, menus, and toolbars?
-@subheading There's a lot of documentation!  Do I need to read it?
-@subheading That's still a lot of reading!  Is it worth it?
-@subheading Something isn't working!  How do I fix it?
-@subheading Why do you change the syntax?
-@node Changes
-@unnumberedsec Changes
+@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
+
+
+@node Nouveautés
+@unnumberedsec Nouveautés
+@translationof Changes
+
+@divClass{column-left-top}
+@subheading Nouveautés
+
+C'est une liste des changements visibles pour l'utilisateur et des
+nouvelles fonctionnalités de LilyPond depuis la dernière version stable.
+
+@divEnd
+
+@divClass{column-right-bottom}
+
+@docLinks{Nouveautés, changes,
+  @rchcangesnamed{Top,Nouveautés},
+  @manualStableChangesSplit,
+  @manualStableChangesBig, @w{90 KB},
+  @manualStableChangesPdf, @w{80 KB}}
+
+@divEnd
 
-@untranslated
 
+@node Extension
+@unnumberedsec Extension
+@translationof Extending
 
-@node Internals
-@unnumberedsec Internals
+@divClass{column-left-top}
+@subheading Extension des fonctionnalités de LilyPond
 
-@untranslated
+Ce manuel vous donnera des pistes en matière de programmation avancée
+d’ajustements et retouches dans LilyPond.
 
+@divEnd
 
-@node Translated
-@unnumberedsec Translated
+@divClass{column-right-bottom}
 
-@untranslated
+@docLinks{Extension, extending,
+  @rextendnamed{Top,Extension},
+  @manualStableExtendingSplit-fr,
+  @manualStableExtendingBig-fr, @w{300 KB},
+  @manualStableExtendingPdf-fr, @w{500 KB}}
 
+@divEnd
 
-@node Old
-@unnumberedsec Old
 
-@untranslated
+@node Propriétés internes
+@unnumberedsec Propriétés internes
+@translationof Internals
 
+@divClass{column-left-top}
+@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.  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
+ê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
+renvoie à la documentation générée automatiquement.
 
+@divEnd
+
+@divClass{column-right-bottom}
+
+@docLinks{Référence des propriétés internes, internals,
+  @rinternalsnamed{Top,Référence des propriétés internes},
+  @manualStableInternalsSplit,
+  @manualStableInternalsBig, @w{3 MB},
+  @manualStableInternalsPdf, @w{4 MB}}
+
+@divEnd
+
+
+@node Traductions
+@unnumberedsec Traductions
+@translationof Translated
+
+@divClass{column-center-bottom}
+@subheading État des traductions
+
+@include translations.itexi
+
+@divEnd
+
+
+@node Tous
+@unnumberedsec Tous
+@translationof All
+
+@divClass{column-left-top}
+@subheading Versions disponibles au téléchargement
+
+@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 @doctarballStable-fr
+
+@end itemize
+
+@divEnd
+@end ifset
+
+@divEnd
+
+@divClass{column-right-bottom}
+@subheading Versions stables antérieures
+
+@divClass{keep-bullets}
+@itemize
+
+@item @uref{http://lilypond.org/doc/v2.16/Documentation/web/manuals,
+LilyPond 2.16 Documentation}
+
+@item @uref{http://lilypond.org/doc/v2.14/Documentation/web/manuals.fr.html,
+LilyPond 2.14 Documentation}
+
+@item @uref{http://lilypond.org/doc/v2.12/Documentation/index.fr.html,
+LilyPond 2.12 Documentation}
+
+@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}
+
+@item @uref{http://lilypond.org/doc/v2.6/Documentation/,
+LilyPond 2.6 Documentation}
+
+@item @uref{http://lilypond.org/doc/v2.4/Documentation/out-www/,
+LilyPond 2.4 Documentation}
+
+@item @uref{http://lilypond.org/doc/v2.2/Documentation/out-www/,
+LilyPond 2.2 Documentation}
+
+@item @uref{http://lilypond.org/doc/v2.0/Documentation/out-www/,
+LilyPond 2.0 Documentation}
+
+@item @uref{http://lilypond.org/doc/v1.8/Documentation/out-www/,
+LilyPond 1.8 Documentation}
+
+@item @uref{http://lilypond.org/doc/v1.6/Documentation/out-www/,
+LilyPond 1.6 Documentation}
+
+@end itemize
+
+@divEnd
+@divEnd
 @node FDL
 @unnumberedsec FDL
+@translationof FDL
 
-@untranslated
+@divClass{column-center-top}
+@subheading Licence de la documentation
 
+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é}.
 
-@divClass{column-center-top}
-@subheading Documentation license
 @divEnd
+
 @divClass{column-center-bottom}
 @subheading GNU Free Documentation License 1.1
+
 @include fdl.itexi
-@divEnd
 
-@c -- SKELETON FILE --
+@divEnd