From: Jean-Charles Malahieude Date: Tue, 30 Dec 2014 15:33:50 +0000 (+0100) Subject: Doc-fr: updates LM, NR and AU X-Git-Tag: release/2.19.16-1~2^2~48 X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=e0ede41cade2fbaa20efa55523d173d71ea201cc;p=lilypond.git Doc-fr: updates LM, NR and AU --- diff --git a/Documentation/fr/learning/common-notation.itely b/Documentation/fr/learning/common-notation.itely index c12eedea12..5bb01ce6d9 100644 --- a/Documentation/fr/learning/common-notation.itely +++ b/Documentation/fr/learning/common-notation.itely @@ -1,7 +1,7 @@ @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*- @ignore - Translation of GIT committish: 0fe24db3936774a8fb913cb14c997036db7aeb1c + Translation of GIT committish: 4467a72a98fb582466ee4d5944ec8454b4b77fc6 When revising a translation, copy the HEAD committish of the version that you are working on. For details, see the Contributors' @@ -56,7 +56,7 @@ Cette section présente la notation courante dont on a besoin pour @menu * Barre et contrôle de mesure:: -* Altérations et armure:: +* Hauteurs et armure:: * Liaisons:: * Articulations et nuances:: * Ajout de texte:: @@ -114,9 +114,9 @@ Manuel de notation : @ruser{Vérification des limites et numéros de mesure}. -@node Altérations et armure -@subsection Altérations et armure -@translationof Accidentals and key signatures +@node Hauteurs et armure +@subsection Hauteurs et armure +@translationof Pitches and key signatures @menu * Altérations:: @@ -124,13 +124,13 @@ Manuel de notation : * Attention aux armures et aux hauteurs:: @end menu -@warning{Si, comme nombre de nouveaux utilisateurs, ce qui suit vous -paraît déroutant, lisez cette partie jusqu'au bout, à plus forte raison -si vous n'avez jamais fait de solfège !} +@warning{Si, comme nombre de nouveaux utilisateurs, vous avez du mal à +appréhender la notion de tonalité et d'armures dans LilyPond, consultez +la note à la fin de cette page.} @node Altérations @unnumberedsubsubsec Altérations -@translationof Accidentals +@translationof Pitch alterations @cindex altérations @cindex dièse @@ -139,6 +139,8 @@ si vous n'avez jamais fait de solfège !} @cindex bémol @cindex double bémol @cindex bémol, double +@cindex bécarre +@cindex naturel @funindex es @funindex is @@ -150,6 +152,10 @@ Glossaire musicologique : @rglosnamed{double sharp,double dièse}, @rglosnamed{double flat,double bémol}, @rglosnamed{accidental,altération}. +LilyPond identifie le nom d'une note par sa hauteur. Par exemple, un +@code{c} signifiera toujours @notation{do naturel}, quelle que soit la +tonalité ou l'armure. + Dans la notation par défaut, on obtient un @notation{dièse} en ajoutant @code{is} au nom de la note, et un @notation{bémol} en ajoutant @code{es}. Comme vous pouvez vous y attendre, un double @@ -197,11 +203,11 @@ Glossaire musicologique : L'armure est déterminée par la commande @code{\key}, suivie d'une hauteur puis de @code{\major} (majeur) ou @code{\minor} (mineur). -@lilypond[verbatim,quote,relative=2] +@lilypond[verbatim,quote,relative=1] \key d \major -a1 -\key c \minor -a +d4 fis a c | +\bar "||" \key c \minor +c,4 ees g b | @end lilypond @smallspace @@ -217,25 +223,17 @@ Glossaire musicologique : @rglosnamed{natural,bécarre}, @rglosnamed{sharp,dièse}, @rglos{transposition}, @rglosnamed{Pitch names,Noms de note}. -La combinaison de l'@notation{armure} et des hauteurs de note -- y -compris les altérations -- permet à LilyPond de déterminer dans quel -cas imprimer des @notation{altérations accidentelles}. L'armure -n'affecte que les altérations @emph{imprimées}, et non les hauteurs -réelles ! Cette fonctionnalité est souvent source de confusion pour -les nouveaux utilisateurs, aussi expliquons-la en détail. - -LilyPond fait une distinction nette entre le contenu musical et la -mise en forme. L'altération d'une note -- @notation{bémol}, -@notation{bécarre} ou @notation{dièse} -- fait partie de sa hauteur, -et relève donc du contenu musical. La gravure ou non d'une altération -accidentelle -- un @emph{signe} bémol, bécarre ou dièse -- devant la -note correspondante est une question qui relève de la mise en forme. -La gravure d'une partition suit des règles, en particulier des règles -d'indication des altérations accidentelles. Les hauteurs de note, en -revanche, relèvent de ce que vous voulez entendre ; et, dans la -mesure où la musique que vous entrez est censée être celle que vous -voulez entendre, LilyPond, qui n'est chargé que de la gravure, ne les -choisira pas à votre place. +LilyPond fait une distinction nette entre le contenu musical et sa +représentation sur papier. Un code tel que @code{d4 e fis2} définit la +hauteur et la durée de notes ; il s'agit du contenu. L'armure, les +altérations « à la clef », fait partie de la représentation imprimée. +L'armure définit aussi des règles en matière de représentation des notes +imprimées. LilyPond comparera chaque hauteur saisie avec l'armure pour +déterminer s'il est besoin d'imprimer une altération accidentelle. + +La commande @code{\key} détermine l'armure, ce qui affectera la +représentation imprimée, et ne modifiera @b{en aucun cas} la hauteur +assignée à une note telle qu'un @code{c} que vous aurez saisi. Dans cet exemple, diff --git a/Documentation/fr/learning/tweaks.itely b/Documentation/fr/learning/tweaks.itely index 7581567632..0833ee5dc4 100644 --- a/Documentation/fr/learning/tweaks.itely +++ b/Documentation/fr/learning/tweaks.itely @@ -1,7 +1,7 @@ @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*- @ignore - Translation of GIT committish: 0fe24db3936774a8fb913cb14c997036db7aeb1c + Translation of GIT committish: 4467a72a98fb582466ee4d5944ec8454b4b77fc6 When revising a translation, copy the HEAD committish of the version that you are working on. For details, see the Contributors' @@ -3386,18 +3386,26 @@ voir à ce sujet @ruser{Modification des liaisons}. Voici un autre exemple. Comme nous pouvons le constater, les barres de ligature chevauchent les liaisons de tenue : -@lilypond[quote,verbatim,fragment,ragged-right] +@lilypond[quote,verbatim,fragment,ragged-right,relative=1] { \time 4/2 << - { c'1 ~ 2. e'8 f' } + { c1~ 2. e8 f } \\ - { e''8 e'' e'' e'' e'' e'' e'' e'' f''2 g'' } + { + e'8 e e e + e e e e + f2 g + } >> << - { c'1 ~ 2. e'8 f' } + { c,,1~ 2. e8 f } \\ - { e''8 e'' e'' e'' e'' e'' e'' e'' f''2 g'' } + { + e'8 e e e + e e e e + f2 g + } >> } @end lilypond @@ -3410,29 +3418,38 @@ au-dessous de la ligne médiane mais, disons, à 1 : @cindex Beam, exemple de dérogation @cindex positions, exemple d'utilisation de la propriété -@lilypond[quote,verbatim,fragment,ragged-right] +@lilypond[quote,verbatim,fragment,ragged-right,relative=1] { \time 4/2 << - { c'1 ~ 2. e'8 f' } + { c1~ 2. e'8 f' } \\ { \override Beam.positions = #'(-1 . -1) - e''8 e'' e'' e'' e'' e'' e'' e'' f''2 g'' + e'8 e e e + e e e e + f2 g } >> << - { c'1 ~ 2. e'8 f' } + { c,,1~ 2. e'8 f' } \\ - { e''8 e'' e'' e'' e'' e'' e'' e'' f''2 g'' } + { + e'8 e e e + e e e e + f2 g + \revert Beam.positions + } >> } @end lilypond @noindent -Vous remarquerez que la retouche continue de s'appliquer au -second bloc de croches de la première voix mais qu'il ne s'applique -à aucune mesure de la deuxième voix. +Vous remarquerez que la retouche continue de s'appliquer au second bloc +de croches de la deuxième voix mais qu'il ne s'applique à aucune des +ligatures de la première voix, même dans la seconde mesure. Dès que la +dérogation ne doit plus s'appliquer, il suffit de l'annuler comme +indiqué ici. @node La propriété force-hshift diff --git a/Documentation/fr/notation/pitches.itely b/Documentation/fr/notation/pitches.itely index d4059d61e4..20c4d2e449 100644 --- a/Documentation/fr/notation/pitches.itely +++ b/Documentation/fr/notation/pitches.itely @@ -1,7 +1,7 @@ @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*- @ignore - Translation of GIT committish: b58a17a6b0b6f624cee7858a74092265e0791fe2 + Translation of GIT committish: 4467a72a98fb582466ee4d5944ec8454b4b77fc6 When revising a translation, copy the HEAD committish of the version that you are working on. For details, see the Contributors' @@ -325,12 +325,12 @@ Référence des propriétés internes : @c duplicated in Key signature and in Accidentals @warning{Les nouveaux utilisateurs sont parfois déroutés par la gestion -des altérations et de l'armure. Pour LilyPond, une hauteur n'est que du -matériau brut ; l'armure et la clef ne feront que déterminer -comment ce matériau sera retranscrit. Un simple @code{c} signifie -tout bonnement « do naturel » quelles que soient l'armure et la clef -en question. Pour plus d'information, reportez-vous au chapitre -@rlearning{Altérations et armure}.} +des altérations et de l'armure. Pour LilyPond, un nom de note spécifie +une hauteur ; l'armure et la clef ne feront que déterminer comment ces +hauteurs seront retranscrites. Un simple @code{c} signifie tout +bonnement « do naturel » quelles que soient l'armure et la clef en +vigueur. Pour plus d'information, reportez-vous au chapitre +@rlearning{Hauteurs et armure}.} @cindex noms de note, hollandais @cindex noms de note, par défaut @@ -353,10 +353,10 @@ langues, consultez @ref{Nom des notes dans d'autres langues}. ais1 aes aisis aeses @end lilypond -Un bécarre annule l'effet d'une altération, qu'elle soit accidentelle -ou à l'armure. Cependant, dans la syntaxe des noms de note, les -bécarres ne s'écrivent pas avec un suffixe ; un simple nom de note -donnera une note bécarre. +Une hauteur naturelle se saisit comme un simple nom de note, sans +suffixe. Un bécarre sera imprimé si besoin est, que ce soit pour +annuler les effets d'un précédente altération accidentelle ou pour +déroger à l'armure. @lilypond[verbatim,quote,relative=2] a4 aes a2 @@ -389,8 +389,7 @@ peut que vous vouliez les imprimer manuellement. On peut forcer l'impression d'une altération, dite « de précaution », en ajoutant un point d'exclamation @code{!} après la hauteur de note. Une altération entre parenthèses peut être obtenue en ajoutant un point -d'interrogation @code{?} après la hauteur de note. Ces signes peuvent -aussi être utilisés pour imprimer des bécarres. +d'interrogation @code{?} après la hauteur de note. @lilypond[verbatim,quote,relative=2] cis cis cis! cis? c c c! c? @@ -425,7 +424,7 @@ Glossaire musicologique : @rglosnamed{quarter tone,quart de ton}. Manuel d'initiation : -@rlearning{Altérations et armure}. +@rlearning{Hauteurs et armure}. Manuel de notation : @ref{Altérations accidentelles automatiques}, @@ -507,7 +506,7 @@ sont les suivants : et les suffixes d'altération correspondants : @quotation -@multitable {@code{nederlands}} {-s/-sharp} {-ess/-es} {-ss/-x/-sharpsharp} {-essess/-eses} +@multitable {@code{nederlands}} {-s/--sharp} {-ess/-es} {-ss/-x/--sharpsharp} {-essess/-eses} @headitem Langue @tab dièse @tab bémol @tab double dièse @tab double bémol @item @code{nederlands} @@ -517,8 +516,8 @@ et les suffixes d'altération correspondants : @item @code{deutsch} @tab -is @tab -es @tab -isis @tab -eses @item @code{english} - @tab -s/-sharp @tab -f/-flat @tab -ss/-x/-sharpsharp - @tab -ff/-flatflat + @tab -s/--sharp @tab -f/--flat @tab -ss/-x/--sharpsharp + @tab -ff/--flatflat @item @code{espanol} ou @code{español} @tab -s @tab -b @tab -ss/-x @tab -bb @item @code{italiano} ou @code{français} @@ -1272,7 +1271,7 @@ matériau brut ; l'armure et la clef ne feront que déterminer comment ce matériau sera retranscrit. Un simple @code{c} signifie tout bonnement « do naturel » quelles que soient l'armure et la clef en question. Pour plus d'information, reportez-vous au chapitre -@rlearning{Altérations et armure}.} +@rlearning{Hauteurs et armure}.} L'armure indique la tonalité dans laquelle la pièce doit être jouée. Elle comprend un ensemble d'altérations (dièses ou bémols) à la clef, @@ -1377,7 +1376,7 @@ Glossaire musicologique : @rglos{scordatura}. Manuel d'initiation : -@rlearning{Altérations et armure}. +@rlearning{Hauteurs et armure}. Morceaux choisis : @rlsrnamed{Pitches,Hauteurs}. diff --git a/Documentation/fr/notation/rhythms.itely b/Documentation/fr/notation/rhythms.itely index c483eeef5f..fc3e0e499c 100644 --- a/Documentation/fr/notation/rhythms.itely +++ b/Documentation/fr/notation/rhythms.itely @@ -1,7 +1,7 @@ @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*- @ignore - Translation of GIT committish: fab824ac128346465690246f7a42ce1e8b42db8d + Translation of GIT committish: 4467a72a98fb582466ee4d5944ec8454b4b77fc6 When revising a translation, copy the HEAD committish of the version that you are working on. For details, see the Contributors' @@ -3139,6 +3139,16 @@ test de mesure signale une erreur. \time 3/4 c2 e4 | g2 | @end example +Des durées incorrectes font échouer les tests de mesure et peuvent +souvent mettre la partition sens dessus dessous, particulièrement s'il +s'agit de musique polyphonique. Vérifier les tests de mesure qui ont +échoué et les durées incorrectes est un bon moyen de commencer à +corriger sa partition. + +Lorsque plusieurs tests successifs présentent un même décalage, seul le +message d'avertissement concernant la première occurrence est affiché. +L'origine du problème est de fait plus évidente. + Le test de mesure peut être aussi utilisé dans les paroles, par exemple : @@ -3149,15 +3159,11 @@ exemple : @} @end example -Des durées incorrectes font échouer les tests de mesure et peuvent -souvent mettre la partition sens dessus dessous, particulièrement s'il -s'agit de musique polyphonique. Vérifier les tests de mesure qui ont -échoué et les durées incorrectes est un bon moyen de commencer à -corriger sa partition. - -Lorsque plusieurs tests successifs présentent un même décalage, seul le -message d'avertissement concernant la première occurrence est affiché. -L'origine du problème est de fait plus évidente. +Notez bien qu'en matière de paroles, le test est effectué à l'instant +musical où la syllabe @b{suivant} la marque est traitée. Par voie de +conséquence, lorsqu'une mesure débute par un silence, il n'y a pas moyen +de positionner une syllabe à cet endroit, et LilyPond émettra un +avertissement. @funindex | @funindex "|" diff --git a/Documentation/fr/notation/wind.itely b/Documentation/fr/notation/wind.itely index 95daaf5d15..8373587704 100644 --- a/Documentation/fr/notation/wind.itely +++ b/Documentation/fr/notation/wind.itely @@ -1,7 +1,7 @@ @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*- @ignore - Translation of GIT committish: e6e64de1da49ff8c6005daa5fd81adc8387b2668 + Translation of GIT committish: 4467a72a98fb582466ee4d5944ec8454b4b77fc6 When revising a translation, copy the HEAD committish of the version that you are working on. For details, see the Contributors' diff --git a/Documentation/fr/notation/world.itely b/Documentation/fr/notation/world.itely index 741e6fcef4..3b774c8d7d 100644 --- a/Documentation/fr/notation/world.itely +++ b/Documentation/fr/notation/world.itely @@ -1,7 +1,7 @@ @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*- @ignore - Translation of GIT committish: bdff8baf5bce0c4c456ebbf292ba8fc771e4bd31 + Translation of GIT committish: 4467a72a98fb582466ee4d5944ec8454b4b77fc6 When revising a translation, copy the HEAD committish of the version that you are working on. For details, see the Contributors' @@ -354,7 +354,7 @@ Manuel de notation : @ref{Armure}. Manuel d’initiation : -@rlearning{Altérations et armure}. +@rlearning{Hauteurs et armure}. Référence des propriétés internes : @rinternals{KeySignature}. diff --git a/Documentation/fr/texidocs/conducting-signs,-measure-grouping-signs.texidoc b/Documentation/fr/texidocs/conducting-signs,-measure-grouping-signs.texidoc index a3c2bb0d37..989fe1f921 100644 --- a/Documentation/fr/texidocs/conducting-signs,-measure-grouping-signs.texidoc +++ b/Documentation/fr/texidocs/conducting-signs,-measure-grouping-signs.texidoc @@ -1,4 +1,4 @@ -%% Translation of GIT committish: 8eae9a75fb3ec1d0b6633103c8a652608c8fa630 +%% Translation of GIT committish: 4467a72a98fb582466ee4d5944ec8454b4b77fc6 texidocfr = " Les règles de ligature par mesure sont gérées par la propriété de contexte @code{beatStructure}. Ses valeurs par défaut sont diff --git a/Documentation/fr/usage/running.itely b/Documentation/fr/usage/running.itely index 6f199adec5..6eafa823d2 100644 --- a/Documentation/fr/usage/running.itely +++ b/Documentation/fr/usage/running.itely @@ -1,7 +1,7 @@ @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*- @ignore - Translation of GIT committish: 3c907f2dd5ba3dd91e30454922d8361225ca28d5 + Translation of GIT committish: 4467a72a98fb582466ee4d5944ec8454b4b77fc6 When revising a translation, copy the HEAD committish of the version that you are working on. For details, see the Contributors' @@ -47,11 +47,11 @@ certaines options particulières. D'autre part, certains utilitaires associés, tel que @code{midi2ly}, ne sont disponibles qu'en ligne de commande. -Par @qq{ligne de commande}, nous entendons l'interface de commande du +Par « ligne de commande », nous entendons l'interface de commande du système. Les utilisateurs de Windows seront certainement plus familiers -des termes @qq{fenêtre DOS} ou @qq{invite de commande}. Quant aux +des termes « fenêtre DOS » ou « invite de commande ». Quant aux utilisateurs de MacOS X, ils connaissent assurément les termes -@qq{console} et @qq{terminal}. Les paramétrages spécifiques au système +« console » et « terminal ». Les paramétrages spécifiques au système MacOS font l'objet d'un @rwebnamed{MacOS X,chapitre particulier}. Notre propos n'est pas ici d'expliquer ce qu'est l'interface de @@ -121,6 +121,7 @@ Par exemple, lilypond *.ly @end example +@noindent traitera tous les fichiers LilyPond présent dans le répertoire en cours. Rediriger, par exemple dans un fichier, ce qui est émis à l'écran peut @@ -142,6 +143,45 @@ Consultez avant tout la documentation de votre interpréteur habituel -- terminal, console, etc. -- pour vérifier qu'il prend en charge les options dans cette syntaxe. +Voici comment traiter un jeu de fichiers répartis dans un répertoire +donné ainsi que tous ses différents sous-répertoires. Les fichiers +résultants seront regroupés dans le répertoire à partir duquel la +commande a été exécutée, non selon l'emplacement des fichiers sources. + +@example +find . -name '*.ly' -exec lilypond '@{@}' \; +@end example + +@noindent +Cette commande, bien qu'effective uniquement dans un terminal, devrait +être fonctionnelle aussi pour les utilisateurs de MacOS X. + +Les utilisateurs de windows utiliseront l'instruction + +@example +forfiles /s /M *.ly /c "cmd /c lilypond @@file" +@end example + +@noindent +dans l'@code{interpréteur de commandes}, qui se trouve normalement sous +@code{Démarrer > Accessoires > Interpréteur de commandes} ou, pour la +version 8, en faisant une recherche sur « interpréteur de commande ». + +Par ailleurs, il est possible de spécifier de manière explicite le chemin +d'accès au dossier comportant des sous-répertoires où se trouvent les +fichiers sources, à l'aide de l'option @code{/p} : + +@example +forfiles /s /p C:\Documents\MesPartitions /M *.ly /c "cmd /c lilypond @@file" +@end example + +Dans le cas où ce chemin d'accès comporte des espaces, l'intégralité de +ce chemin devra être borné par des guillemets informatiques : + +@example +forfiles /s /p "C:\Documents\Mes Partitions" /M *.ly /c "cmd /c lilypond @@file" +@end example + @node Options basiques de lilypond @unnumberedsubsec Options basiques de @command{lilypond} @@ -195,7 +235,7 @@ doubles @code{"} en lieu et place des guillemets simples @code{'}.} Détermine le format à produire. Il peut s'agir de @code{ps}, @code{pdf} ou @code{png}. -Exemple : @code{lilypond -fpng @var{monfichier}.ly} +Exemple : @code{lilypond -fpng @var{monfichier}.ly} @item -h, --help Affiche un résumé des commandes. @@ -1074,7 +1114,7 @@ s'appliquer au contexte en cours. Pour des partitions simples, le fait que les contextes soient automatiquement créés rend bien des services, et c'est d'ailleurs le cas pour la majorité des exemples contenus dans les manuels de LilyPond. Cependant, la création implicite d'un contexte -peut aboutir à l'apparition d'une portée @qq{parasite}. On s'attend par +peut aboutir à l'apparition d'une portée « parasite ». On s'attend par exemple, en lisant le code qui suit, à ce que toutes les têtes de note soient en rouge, alors que le résultat nous présente deux portées et que les notes, placées sur la portée inférieure, restent en noir. diff --git a/Documentation/fr/usage/updating.itely b/Documentation/fr/usage/updating.itely index 3b695625a8..068f582b63 100644 --- a/Documentation/fr/usage/updating.itely +++ b/Documentation/fr/usage/updating.itely @@ -1,7 +1,7 @@ @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*- @ignore - Translation of GIT committish: 6ec0d3283b9e23f2d21658d71ac6801c3aab69b8 + Translation of GIT committish: 4467a72a98fb582466ee4d5944ec8454b4b77fc6 When revising a translation, copy the HEAD committish of the version that you are working on. For details, see the Contributors' @@ -20,12 +20,16 @@ @cindex mise à jour de fichiers LilyPond @cindex convert-ly -La syntaxe des fichiers LilyPond évolue avec le temps, que ce soit dans -le but de la simplifier ou pour l'améliorer. Il en résulte que -l'interpréteur de LilyPond se retrouve incapable de traiter d'anciens -fichiers. L'utilitaire @command{convert-ly} permet cependant de -mettre ces fichiers en conformité au fur et à mesure que de nouvelles -versions de LilyPond sont disponibles. +Au fur et à mesure des améliorations de LilyPond, la syntaxe ou façon de +libeller les fonctions et commandes peut être amenée à évoluer. Ceci +peut avoir pour effet de générer des erreurs ou avertissements +intempestifs, voire une sortie erronée, lorsque des fichiers créés avec +une version antérieure sont traités par une version plus récente du +progamme. + +L'utilitaire @command{convert-ly} permet alors de mettre ces fichiers en +conformité au fur et à mesure que de nouvelles versions de LilyPond sont +disponibles. @menu * LilyPond est une langue vivante:: @@ -43,27 +47,29 @@ versions de LilyPond sont disponibles. @cindex convert-ly @cindex mise à jour d'anciens fichiers -La syntaxe de LilyPond change de temps en temps. Ces changements de -syntaxe -- le langage d'entrée -- accompagnent les améliorations du -logiciel. Ces changements sont parfois destinés à rendre les fichiers -plus faciles à lire et à écrire, ou permettent d'intégrer de nouvelles -fonctionnalités. - -Par exemple, tous les noms des propriétés de @code{\paper} et -@code{\layout} devaient être libellées sous la forme -@code{@w{premier-deuxième-troisième}}. Nous avons constaté, une fois la -version 2.11.60 mise à disposition, que la propriété -@code{printallheaders} ne respectait pas cette convention. Aurions-nous -dû la laisser telle que, au risque de dérouter les nouveaux utilisateurs -par cette exception au formatage, ou bien la modifier -- ce qui allait -obliger ceux qui l'avaient déjà utilisée à se mettre en chasse ? -Pour ce cas d'espèce, nous avons décidé de changer pour -@code{print-all-headers}. Cette modification peut heureusement être -automatisée par notre utilitaire @command{convert-ly}. +La syntaxe de LilyPond change de temps en temps, que ce soit pour rendre +les fichiers plus faciles à lire et à écrire, ou pour intégrer de +nouvelles fonctionnalités. + +En voici un exemple flagrant : + +Tous les noms des propriétés de @code{\paper} et @code{\layout} sont +libellés sous la forme @code{@w{premier-deuxième-troisième}}. Nous +avons constaté, une fois la version 2.11.60 mise à disposition, que la +propriété @code{printallheaders} ne respectait pas cette convention. +Aurions-nous dû la laisser telle que, au risque de dérouter les nouveaux +utilisateurs par cette exception au formatage, ou bien la modifier -- ce +qui allait obliger ceux qui l'avaient déjà utilisée à se mettre en +chasse ? + +Pour ce cas d'espèce, nous avons décidé de changer le nom de cette +propriété en @code{print-all-headers} et de permettre à ceux qui +avaient utilisé l'ancienne syntaxe de modifier automatiquement leurs +fichiers à l'aide de notre utilitaire @command{convert-ly}. Malheureusement, @command{convert-ly} ne peut pas réaliser toutes les -modifications. Par exemple, dans les versions 2.4 et antérieures de -LilyPond, les accents et les lettres non anglaises étaient entrées en +modifications. Par exemple, dans les versions de LilyPond antérieures à +la 2.4.2, les accents et les lettres non anglaises étaient entrées en utilisant @LaTeX{} -- par exemple, @code{No\"el}. À partir de la version 2.6, le caractère @code{ë} doit être entré directement dans le fichier LilyPond comme caractère UTF-8. @command{convert-ly} ne @@ -83,10 +89,10 @@ manuelle ; la version de « départ » devrait toujours rester disponible pour comparaison. @item -Seules des conversions à un format plus récent sont possibles ; aucune -règle ne permet de revenir en arrière. La copie de travail d'un fichier -LilyPond ne devrait donc être mise à jour que lorsque la version sur -laquelle il repose n'est plus disponible. Des système de gestion de +Seules des conversions à une syntaxe plus récente sont possibles ; +aucune règle ne permet de revenir en arrière. La copie de travail d'un +fichier LilyPond ne devrait donc être mise à jour que lorsque la version +sur laquelle il repose n'est plus maintenue. Des système de gestion de version tels que Git permettent de se tenir à jour sur plusieurs versions. @@ -104,8 +110,8 @@ jour avec @command{convert-ly}. @section Exécution de @command{convert-ly} @translationof Invoking convert-ly -@command{convert-ly} utilise les mentions de @code{\version} -- que vous -n'avez sûrement pas oublié de porter dans vos fichiers -- pour +La commande @command{convert-ly} utilise les mentions de @code{\version} +-- que vous n'avez sûrement pas oublié de porter dans vos fichiers -- pour déterminer le numéro de l'ancienne version. Mettre à jour votre fichier ne vous demande que de lancer @@ -115,7 +121,8 @@ convert-ly -e monfichier.ly @noindent dans le dossier où il se trouve. @file{monfichier.ly} sera mis à jour, -et vous aurez une copie de l'original : @file{monfichier.ly~}. +avec un nouveau buméro en argument à @code{\version}, et vous aurez une +copie de l'original : @file{monfichier.ly~}. @warning{@command{convert-ly} effectuera les conversions jusqu'aux modifications de syntaxe les plus récentes qu'il contient. C'est la @@ -129,23 +136,56 @@ Vous pouvez convertir tous les fichiers d'un dossier en lançant convert-ly -e *.ly @end example -Vous pouvez aussi affecter un autre nom au fichier mis à jour et -conserver votre fichier original en l'état : +Les utilisatuers de Gnu/Linux ou de MacOS X peuvent lancer cette +commande dans un terminal. Les utilisateurs de MacOS X disposent d'une +entrée spécifique dans le menu : @code{Compile > Update syntax}. + +Un utilisateur de Windows lancera la commande @example -convert-ly monfichier.ly > monnouveaufichier.ly +convert-ly.py -e *.ly +@end example + +@noindent +dans l'@code{interpréteur de commandes}, qui se trouve normalement sous +@code{Démarrer > Accessoires > Interpréteur de commandes} ou, pour la +version 8, en faisant une recherche sur « interpréteur de commande ». + +La conversion d'un jeu de fichiers répartis dans différents +sous-répertoires s'obtient en lançant + +@example +find . -name '*.ly' -exec convert-ly -e '@{@}' \; +@end example + +Ceci aura pour effet de rechercher et convertir tous les fichiers +sources dans le répertoire en cours et dans tous ses sous-répertoires. +les fichiers convertis se trouveront à leur emplacement d'orignie, tout +comme les fichiers originels après renommage. Cette commande, bien +qu'effective uniquement dans un terminal, devrait etre fonctnionnelle +aussi pour les utilisateurs de MacOS X. + + +Les utilisateurs de windows utiliseront l'instruction + +@example +forfiles /s /M *.ly /c "cmd /c convert-ly.py -e @@fichier" @end example -Le programme affichera les numéros de version correspondant aux -différentes conversions effectuées. Si aucun numéro de version -n'apparaît, considérez que le fichier ne comporte pas de syntaxe -obsolète. +Par ailleurs, il est possible de spécifier de manière explicite le chemin +d'accès au dossier comportant des sous-répertoires où se trouvent les +fichiers sources, à l'aide de l'option @code{/p} : -Les utilisateurs de MacOS X disposent d'une entrée spécifique dans -le menu : @code{Compile > Update syntax}. +@example +forfiles /s /p C:\Documents\MesPartitions /M *.ly /c "cmd /c convert-ly.py -e @@fichier" +@end example -Si vous utilisez windows, ouvrez un interpréteur de commande en faisant -@code{Démarrer > Accessoires > Interpréteur de commandes}. +Dans le cas où ce chemin d'accès comporte des espaces, l'intégralité de +ce chemin devra être borné par des guillemets informatiques : + +@example +forfiles /s /p "C:\Documents\Mes Partitions" /M *.ly /c "cmd /c convert-ly.py -e @@fichier" +@end example @node Options en ligne de commande pour convert-ly @@ -175,6 +215,19 @@ pour éditer directement le fichier d'origine. Le fichier originel est renommé en que @file{monfichier.ly~}. Ce fichier de sauvegarde, selon le système d'exploitation, peut être « caché ». +Vous pouvez aussi affecter un autre nom au fichier mis à jour et +conserver votre fichier original en l'état : + +@example +convert-ly monfichier.ly > monnouveaufichier.ly +@end example + +@noindent et, pour les utilisateurs de windows : + +@example +convert-ly.py monfichier.ly > monnouveaufichier.ly +@end example + @item -b, --backup-numbered combine à l'option @samp{-e}, pour numéroter les sauvegardes de telle sorte qu'aucune version antérieure ne soit écrasée. Les fichiers de