From 940a3955254888e14a8c5ef7e835225e5cc3852c Mon Sep 17 00:00:00 2001 From: Jean-Charles Malahieude Date: Sun, 31 Jan 2010 20:29:32 +0100 Subject: [PATCH] Web-fr: updates * macros.itexi: nitpicks * web.texi: nitpicks * web/manuals.itexi: review --- Documentation/fr/macros.itexi | 4 +- Documentation/fr/web.texi | 171 ++++++++++++++------ Documentation/fr/web/manuals.itexi | 252 +++++++++++++---------------- 3 files changed, 241 insertions(+), 186 deletions(-) diff --git a/Documentation/fr/macros.itexi b/Documentation/fr/macros.itexi index c251306700..20fb2920b4 100644 --- a/Documentation/fr/macros.itexi +++ b/Documentation/fr/macros.itexi @@ -1,6 +1,6 @@ @c -*- coding: utf-8; mode: texinfo; -*- @ignore - Translation of GIT committish: 7b34eac90f81c8123feaf2670fafae236101f14c + Translation of GIT committish: d59f652451ef6948d1b256808d874b7d03bd3551 When revising a translation, copy the HEAD committish of the version that you are working on. For details, see the Contributors' @@ -87,7 +87,7 @@ translations should be in macros.itexi. @macro docMain @cartouche Pour connaître la place qu'occupe ce manuel dans la -documentation, consultez Manuels. +documentation, consultez @rweb{Manuels}. Si vous ne disposez pas de certains manuels, la documentation complète se trouve sur @w{@uref{http://@/www@/.lilypond@/.org/}}. diff --git a/Documentation/fr/web.texi b/Documentation/fr/web.texi index ee7273726f..e95b1598e0 100644 --- a/Documentation/fr/web.texi +++ b/Documentation/fr/web.texi @@ -1,7 +1,6 @@ \input texinfo @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*- -@c This file is part of web.texi @ignore - Translation of GIT committish: 98c18c374a10c480bbc82b7657b4a71cf4e6452a + Translation of GIT committish: d59f652451ef6948d1b256808d874b7d03bd3551 When revising a translation, copy the HEAD committish of the version that you are working on. For details, see the Contributors' @@ -15,14 +14,16 @@ @afourpaper @c `Web' was imported 2009-08-05 with git commit b938d71... -@macro copyrightDeclare -Copyright @copyright{} 2009--2010 par les auteurs. -@end macro +@c @macro copyrightDeclare +@c Copyright @copyright{} 2009--2010 par les auteurs. +@c @end macro @set FDL @set web @include macros.itexi +@include weblinks.itexi +@afourpaper @c don't remove this comment. @ignore @@ -33,19 +34,32 @@ Copyright @copyright{} 2009--2010 par les auteurs. @omflanguage French @end ignore +@c Translators: John Mandereau +@c Translators checkers: Jean-Charles Malahieude + +@copying +Copyright @copyright{} 2009--2010 par les auteurs. + +@quotation +Permission is granted to copy, distribute and/or modify this +document under the terms of the GNU Free Documentation License, +Version 1.1 or any later version published by the Free Software +Foundation; with no Invariant Sections. A copy of the license is +included in the section entitled ``GNU Free Documentation +License''. +@end quotation +@end copying + @c TITLE PAGE @ifnottex @node Accueil @top LilyPond... la notation musicale pour tous @translationof Top - -@c Translators: John Mandereau -@c Translators checkers: Jean-Charles Malahieude - -@chapheading @end ifnottex + +@c hack for texi2html, bleh -gp @ifnothtml @finalout @@ -68,11 +82,13 @@ Pour LilyPond version @version{} @c ************************ WEBSITE START *************** + @divId{pageHeader} @heading LilyPond ... la notation musicale pour tous @divEnd + @c @imageId{cmws,web-clef-g-eight-alpha.png,Catchy Musical Web Snippet} @imageId{lilylogo,double-lily-modified3.png,LilyPond logo} @c @im ageId{cmws,web-snippet-alpha.png,Catchy Musical Web Snippet} @@ -94,18 +110,24 @@ Plus sur LilyPond dans notre @ref{Introduction} ! @divClass{separator} @divEnd + @divId{news} @c TODO: generate this automatically, including RSS feed. -@include news-front.itexi +@include web/news-front.itexi @divClass{float-right} -(@ref{Old news,,,,Actualités passées}) +(@ref{Old news}) @c (@ref{Old news,,,,Actualités passées}) @divEnd @divEnd +@ifclear web_version + @c do nothing +@end ifclear +@ifset web_version + @c make the box: @divId{latestVersion} @subheading Raccourcis @@ -113,26 +135,28 @@ Plus sur LilyPond dans notre @ref{Introduction} ! @subsubheading Branche stable -@ref{Download, Download @versionStable} +@ref{Download, Téléchargemement de @versionStable} -@ref{Manuals, Manuals @versionStable} +@ref{Manuals, Manuels de @versionStable} @subsubheading Branche de développement -@ref{Development, @versionDevel} +@ref{Development, Téléchargement de @versionDevel} -@ref{Development, @versionDevel} +@ref{Development, Manuels de @versionDevel} @divEnd +@end ifset + @ifnottex @divClass{hide} @menu -* Introduction:: -* Download:: -* Manuals:: -* Community:: +* Introduction:: Comment créer des partitions +* Download:: Télécharger LilyPond +* Manuals:: Bibliothèque de LilyPond +* Community:: Comment contacter d'autres utilisateurs @end menu @divEnd @@ -140,57 +164,99 @@ Plus sur LilyPond dans notre @ref{Introduction} ! @contents + +@c ****************** GENERAL STUFF FOR INFO ************ +@ignore +Distributions will want to install lilypond.info in postinstall, doing: + + install-info --info-dir=/usr/share/info out[-www]/lilypond-web.info + + * Prepend GNU for dir, must be unique. + + * Do not list the `lilypond' node at toplevel, so that `info lilypond' + goes to Top. + + * List all commands in direntry. + +@c * lilypond: (lilypond-application)Running LilyPond. Invoking the +@c LilyPond program. +@end ignore + +@c Info files are no longer installed in a subdirectory, images are +@c expected to be found in lilypond/ subdirectory. +@dircategory GNU LilyPond -- le typographe de musique +@direntry +* Manuel d'initiation à LilyPond: (lilypond-learning). Les premiers pas. +* Glossaire musicologique: (music-glossary). Pour l'utilisateur non anglophone. +* Manuel de notation: (lilypond-notation). Gravure de musique avec LilyPond. +* Morceaux choisis de LilyPond: (lilypond-snippets). Petits trucs, astuces et exemples. +* Références des propriétés internes: (lilypond-internals). Définitions pour les retouches. +* Utilisation des programmes: (lilypond-application). Installation et exécution des programmes. +* LilyPond Website: (lilypond-general). Prévisualisation du site. +* abc2ly: (lilypond-application)lancement de abc2ly. Import de fichier ABC. +* convert-ly: (lilypond-application)Mise à jour de fichiers. Pour d'anciens fichiers LilyPond. +* etf2ly: (lilypond-application)Lancement de etf2ly. Import de fichier Finale. +* lilypond-book: (lilypond-application)LilyPond-book. Association musique-texte. +* midi2ly: (lilypond-application)Lancement de midi2ly. Import de fichier MIDI. +* musicxml2ly: (lilypond-application)Lancement de musicxml2ly. Import de fichier MusicXML. +@end direntry + + @c FIXME: this still doesn't solve the broken links in pdf and big @c html; we'll need a bunch of @iftext and stuff in here. -gp @c ****************** SPECIAL MACROS FOR WEB MANUAL ************ @macro docLinks{name,base,refLink,split,big,bigsize,pdf,pdfsize} @subheading Lisez-le -@itemize +@docLinksBare{\name\,\base\,\refLink\,\split\,\big\,\bigsize\,\pdf\,\pdfsize\} -@c normal case, special online case -@ifclear web_version - @item \refLink\: -@end ifclear -@ifset web_version - @c we assume that the online web version will be split html - @item \split\: -@end ifset -lisez ce manuel dans le même format que celui-ci. - -@end itemize +@end macro -@subheading Tous les formats - -@divClass{keep-bullets} -@itemize +@macro docLinkSplit{name,base,webLink} @ifclear web_version - @item @uref{../\base\/index.html, \name\ (split HTML)}: + @uref{../\base\/index.html, \name\ (split HTML)} @end ifclear @ifset web_version - @item \split\ + \webLink\ @end ifset - manuel sous forme de plusieurs pages HTML - @*@ @ @emph{— chaque page est assez petite.} +@end macro +@macro docLinkBig{name,base,webLink} @ifclear web_version - @item @uref{../\base\-big-page.html, \name\ (big HTML)}: + @uref{../\base\-big-page.html, \name\ (big HTML)} @end ifclear @ifset web_version - @item \big\ + \webLink\ @end ifset - manuel sous forme d'une seule grande page - @*@ @ @emph{— un seul gros téléchargement, \bigsize\.} +@end macro +@macro docLinkPdf{name,base,webLink} @ifclear web_version - @item @uref{../\base\.pdf, \base\.pdf}: + @uref{../\base\.pdf, \base\.pdf} @end ifclear @ifset web_version - @item \pdf\ + \webLink\ @end ifset +@end macro + + +@macro docLinksBare{name,base,refLink,split,big,bigsize,pdf,pdfsize} + +@divClass{keep-bullets} +@itemize + +@item @docLinkSplit{\name\,\base\,\split\} : + manuel sous forme de plusieurs pages HTML + @*@ @ @emph{-- chaque page est assez petite.} + +@item @docLinkBig{\name\,\base\,\big\} : + manuel sous forme d'une seule grande page + @*@ @ @emph{-- un seul gros téléchargement, \bigsize\.} + +@item @docLinkPdf{\name\,\base\,\pdf\} : manuel au format PDF - @*@ @ @emph{— un seul gros téléchargement, \pdfsize\} + @*@ @ @emph{-- un seul gros téléchargement, \pdfsize\.} @end itemize @@ -199,6 +265,17 @@ lisez ce manuel dans le même format que celui-ci. @end macro +@c don't add any extra spaces in this macro -gp +@macro ifWebLinks{webLink,normalLink} +@ifclear web_version + \normalLink\: +@end ifclear +@ifset web_version + \webLink\: +@end ifset +@end macro + + @include web/introduction.itexi @include web/download.itexi @include web/manuals.itexi diff --git a/Documentation/fr/web/manuals.itexi b/Documentation/fr/web/manuals.itexi index ef59b65ff9..fea5551ea1 100644 --- a/Documentation/fr/web/manuals.itexi +++ b/Documentation/fr/web/manuals.itexi @@ -1,7 +1,7 @@ @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*- @c This file is part of web.texi @ignore - Translation of GIT committish: 98c18c374a10c480bbc82b7657b4a71cf4e6452a + Translation of GIT committish: d59f652451ef6948d1b256808d874b7d03bd3551 When revising a translation, copy the HEAD committish of the version that you are working on. For details, see the Contributors' @@ -15,14 +15,25 @@ @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. -@c if you change this page, also change All. @divClass{column-center-top} @subheading Introduction @@ -32,18 +43,21 @@ 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 ! -@item @ref{Initiation} : +@item @ifWebLinks{@manualStableLearningSplitNoName,@rlearningnamed{Top,Initiation}} une introduction pas-à-pas à LilyPond. +@details{Initiation} -@item @ref{Glossaire} : +@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 @ref{Essai} : +@item @ifWebLinks{@manualStableEssaySplitNoName,@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 @@ -55,16 +69,20 @@ la technique de la gravure traditionnelle avec poinçons et plaques de plomb. @itemize -@item @ref{Notation} : -the main portion of the documentation; provides detailed -information about creating notation. +@item @ifWebLinks{@manualStableNotationSplitNoName,@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,@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 @@ -76,21 +94,26 @@ courts extraits, trucs, modèles et autres exemples. @itemize -@item @ref{Web} : -Ce document. - @item @ref{FAQ} : pointe vers la Foire Aux Questions. -@item @ref{Nouveautés} : +@item @ref{Web} : +Ce document. +@details{Web} + +@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 @@ -109,7 +132,7 @@ particulier pour élaborer des retouches. liens rapides, manuels téléchargeables, et documentation des anciennes versions. -@item @ref{Développement} : +@item @ref{Development} : manuels pour la version de développement. @item @ref{FDL} : @@ -122,20 +145,20 @@ ces manuels sont publiés sous la licence GNU de documentation libre FDL. @divClass{hide} @menu -* Initiation:: -* Glossaire:: -* Essai:: -* Notation:: Reference. -* Utilisation:: -* Exemples de codes:: -* Web:: Web. -* FAQ:: FAQ. +* 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 +* Web:: +* FAQ:: Foire aux questions * Nouveautés:: * Extension:: * Propriétés internes:: * Traductions:: * Tous:: -* FDL:: Licence. +* FDL:: Licence. @end menu @divEnd @@ -241,7 +264,7 @@ 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 +@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 glossaire.} @@ -284,12 +307,12 @@ recommandée avant d'aborder de grands projets. @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 @@ -310,8 +333,8 @@ manuel de notation est accessible par des liens dans le paragraphe @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} @@ -319,30 +342,6 @@ manuel de notation est accessible par des liens dans le paragraphe @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} - -@divEnd - - @node FAQ @unnumberedsec FAQ @translationof FAQ @@ -389,6 +388,30 @@ C'est expliqué (en anglais) dans @rprogram{Why does the syntax change?}. @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} + +@divEnd + + @node Nouveautés @unnumberedsec Nouveautés @translationof Changes @@ -424,7 +447,7 @@ nouvelles fonctionnalités de LilyPond depuis la dernière version stable. @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 @@ -468,110 +491,65 @@ Désolé, l'état des traductions est indisponible en ce moment. @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 - -@c this should match the (main) manual page. -@divClass{column-center-top} -@subheading Introduction - -@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. - -@end itemize - -@divEnd - @divClass{column-left-top} -@subheading Utilisation courante - -@itemize - -@item @rusernamed{Top,Notation} : -the main portion of the documentation; provides detailed -information about creating notation. - -@item @rprogramnamed{Top,Utilisation} : -discusses the actual programs and operating system-specific -issues. - -@item @rlsrnamed{Top,Exemples de codes} : -courts extraits, trucs, modèles et autres exemples. - -@end itemize - -@divEnd - +@subheading Versions disponibles au téléchargement -@divClass{column-right-top} -@subheading Utilisation ponctuelle +@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 @ref{FAQ} : -pointe vers la Foire Aux Questions. - -@item @rchangesnamed{Top,Nouveautés} : -changements depuis la dernière version stable. - -@item @rextendnamed{Top,Extension} : -programmation avancée d'ajustements et retouches dans LilyPond. - -@item @rinternalsnamed{Top,Propriétés internes} : -information sur les structures internes de LilyPond, nécessaire en -particulier pour élaborer des retouches. +@item @doctarballStable @end itemize @divEnd - - -@divClass{column-center-bottom} -@subheading Versions téléchargeables - -À venir dans quelques mois@dots{} +@end ifset @divEnd -@subheading Versions stables précédentes +@divClass{column-right-bottom} +@subheading Versions stables antérieures @divClass{keep-bullets} @itemize @item @uref{http://lilypond.org/doc/v2.12/Documentation/, -Documentation de LilyPond 2.12} +LilyPond 2.12 Documentation} @item @uref{http://lilypond.org/doc/v2.10/Documentation/, -Documentation de LilyPond 2.10} +LilyPond 2.10 Documentation} @item @uref{http://lilypond.org/doc/v2.8/Documentation/, -Documentation de LilyPond 2.8} +LilyPond 2.8 Documentation} + +@help anybody want to write this stuff? @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 poublié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é}. + +@divEnd + +@divClass{column-center-bottom} +@subheading GNU Free Documentation License 1.1 + +@include fdl.itexi + +@divEnd -- 2.39.2