Documentation/fr/usage/updating.itely

   1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
   2
   3 @ignore
   4     Translation of GIT committish: eea3764cd6bbc78506261f78ed4e7745ac69df41
   5
   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..
   9 @end ignore
  10
  11 @c \version "2.16.0"
  12
  13 @c Translators: Jean-Charles Malahieude
  14 @c Translation checkers:
  15
  16 @node Mise à jour avec convert-ly
  17 @chapter Mise à jour avec @command{convert-ly}
  18 @translationof Updating files with convert-ly
  19
  20 @cindex mise à jour de fichiers LilyPond
  21 @cindex convert-ly
  22
  23 La syntaxe des fichiers LilyPond évolue avec le temps, que ce soit dans
  24 le but de la simplifier ou pour l'améliorer.  Il en résulte que
  25 l'interpréteur de LilyPond se retrouve incapable de traiter d'anciens
  26 fichiers.  L'utilitaire @command{convert-ly} permet cependant de
  27 mettre ces fichiers en conformité au fur et à mesure que de nouvelles
  28 versions de LilyPond sont disponibles.
  29
  30 @menu
  31 * LilyPond est une langue vivante::
  32 * Exécution de convert-ly::
  33 * Options en ligne de commande pour convert-ly::
  34 * Problèmes d'exécution de convert-ly::
  35 * Conversions manuelles::
  36 @end menu
  37
  38
  39 @node LilyPond est une langue vivante
  40 @section LilyPond est une langue vivante
  41 @translationof Why does the syntax change?
  42
  43 @cindex convert-ly
  44 @cindex mise à jour d'anciens fichiers
  45
  46 La syntaxe de LilyPond change de temps en temps.  Ces changements de
  47 syntaxe -- le langage d'entrée -- accompagnent les améliorations du
  48 logiciel.  Ces changements sont parfois destinés à rendre les fichiers
  49 plus faciles à lire et à écrire, ou permettent d'intégrer de nouvelles
  50 fonctionnalités.
  51
  52 Par exemple, tous les noms des propriétés de @code{\paper} et
  53 @code{\layout} devaient être libellées sous la forme
  54 @code{@w{premier-deuxième-troisième}}.  Nous avons constaté, une fois la
  55 version 2.11.60 mise à disposition, que la propriété
  56 @code{printallheaders} ne respectait pas cette convention.  Aurions-nous
  57 dû la laisser telle que, au risque de dérouter les nouveaux utilisateurs
  58 par cette exception au formatage, ou bien la modifier -- ce qui allait
  59 obliger ceux qui l'avaient déjà utilisée à se mettre en chasse ?
  60 Pour ce cas d'espèce, nous avons décidé de changer pour
  61 @code{print-all-headers}.  Cette modification peut heureusement être
  62 automatisée par notre utilitaire @command{convert-ly}.
  63
  64 Malheureusement, @command{convert-ly} ne peut pas réaliser toutes les
  65 modifications.  Par exemple, dans les versions 2.4 et antérieures de
  66 LilyPond, les accents et les lettres non anglaises étaient entrées en
  67 utilisant @LaTeX{} -- par exemple, @code{No\"el}.  À partir de la
  68 version 2.6, le caractère @code{ë} doit être entré directement dans
  69 le fichier LilyPond comme caractère UTF-8.  @code{convert-ly} ne peut
  70 pas changer tous les caractères @LaTeX{} en caractères UTF-8 ; vous
  71 devez mettre à jour vos vieux fichiers LilyPond manuellement.
  72
  73
  74 @node Exécution de convert-ly
  75 @section Exécution de @command{convert-ly}
  76 @translationof Invoking convert-ly
  77
  78 @command{convert-ly} utilise les mentions de @code{\version} -- que vous
  79 n'avez sûrement pas oublié de porter dans vos fichiers --  pour
  80 déterminer le numéro de l'ancienne version.  Mettre à jour votre fichier
  81 ne vous demande que de lancer
  82
  83 @example
  84 convert-ly -e monfichier.ly
  85 @end example
  86
  87 @noindent
  88 dans le dossier où il se trouve.  @file{monfichier.ly} sera mis à jour,
  89 et vous aurez une copie de l'original : @file{monfichier.ly~}.
  90
  91 @warning{@command{convert-ly} effectuera les conversions jusqu'aux
  92 modifications de syntaxe les plus récentes qu'il contient.  C'est la
  93 raison pour laquelle le numéro de @code{@bs{}version} modifié est la
  94 plupart du temps inférieur au propre numéro de version de
  95 @command{convert-ly}.}
  96
  97 Vous pouvez convertir tous les fichiers d'un dossier en lançant
  98
  99 @example
 100 convert-ly -e *.ly
 101 @end example
 102
 103 Vous pouvez aussi affecter un autre nom au fichier mis à jour et
 104 conserver votre fichier original en l'état :
 105
 106 @example
 107 convert-ly monfichier.ly > monnouveaufichier.ly
 108 @end example
 109
 110 Le programme affichera les numéros de version correspondant aux
 111 différentes conversions effectuées.  Si aucun numéro de version
 112 n'apparaît, considérez que le fichier ne comporte pas de syntaxe
 113 obsolète.
 114
 115 Les utilisateurs de MacOS X disposent d'une entrée spécifique dans
 116 le menu : @code{Compile > Update syntax}.
 117
 118 Si vous utilisez windows, ouvrez un interpréteur de commande en faisant
 119 @code{Démarrer > Accessoires > Interpréteur de commandes}.
 120
 121
 122 @node Options en ligne de commande pour convert-ly
 123 @section Options en ligne de commande pour @command{convert-ly}
 124 @translationof Command line options for convert-ly
 125
 126 L'utilitaire @command{convert-ly} se lance de la manière suivante :
 127
 128 @example
 129 convert-ly [@var{option}]@dots{} @var{fichier}@dots{}
 130 @end example
 131
 132 Vous pouvez utiliser les options :
 133
 134 @table @code
 135 @item -e,--edit
 136 pour éditer directement le fichier d'origine.
 137
 138 @item -f,--from=@var{from-patchlevel}
 139 pour définir le numéro de version à partir duquel vous voulez effectuer
 140 les conversions.  Lorsque cette option n'est pas activée,
 141 @command{convert-ly} tentera de le déterminer sur la foi de la mention
 142 de @code{\version} contenue dans le fichier.  Cette option s'utilise
 143 sous la forme : @code{--from=2.10.25}
 144
 145 @item -n,--no-version
 146 Normalement, @command{convert-ly} ajoutera une indication de
 147 @code{\version} à votre fichier s'il n'en comporte pas.  Cette option
 148 permet de passer outre.
 149
 150 @item -s, --show-rules
 151 pour afficher les conversions applicables.
 152
 153 @item --to=@var{to-patchlevel}
 154 pour n'appliquer les conversions que jusqu'à une version déterminée.  Il
 155 s'agit par défaut de la dernière version disponible.  Cette option
 156 s'utilise sous la forme : @code{--to=2.12.2}
 157
 158
 159 @item -h, --help
 160 visualiser l'aide et quitter.
 161
 162 @item -l @var{loglevel}, --loglevel=@var{loglevel}
 163 pour régler le degré de verbosité à @var{loglevel}.  Les différentes
 164 valeurs sont @code{NONE}, @code{ERROR}, @code{WARNING}, @code{PROGRESS}
 165 (par défaut) et @code{DEBUG}.
 166
 167 @end table
 168
 169 Lorsqu'il s'agit de fragments inclus dans un fichier texinfo, il
 170 vous faudra lancer
 171
 172 @example
 173 convert-ly --from=... --to=... --no-version *.itely
 174 @end example
 175
 176 Lorsque vous désirez savoir quels changements de syntaxe sont intervenus
 177 entre deux versions de LilyPond, lancez
 178
 179 @example
 180 convert-ly --from=@var{ancienne} --to=@var{récente} -s
 181 @end example
 182
 183
 184 @node Problèmes d'exécution de convert-ly
 185 @section Problèmes d'exécution de @code{convert-ly}
 186 @translationof Problems running convert-ly
 187
 188 Sous Windows, lorsque le nom du fichier original ou le chemin qui y mène
 189 comporte des espaces, l'interpréteur de commande requiert qu'il soit
 190 entouré de triples guillemets comme ci-dessous :
 191
 192 @example
 193 convert-ly """D:/Mes Partitions/Ode.ly""" > "D:/Mes Partitions/nouveau Ode.ly"
 194 @end example
 195
 196 Lorsque la commande @command{convert-ly -e *.ly} échoue parce que
 197 son expansion dépasse la taille maximale d'une ligne, vous pouvez lancer
 198 @command{convert-ly} dans une boucle.  L'exemple suivant permet, sous
 199 Unix, de convertir tous les fichiers @file{.ly} d'un même répertoire :
 200
 201 @example
 202 for f in *.ly; do convert-ly -e $f; done;
 203 @end example
 204
 205 Avec l'interpréteur de commandes de Windows, la syntaxe consacrée est :
 206
 207 @example
 208 for %x in (*.ly) do convert-ly -e """%x"""
 209 @end example
 210
 211 Toutes les évolutions du langage ne sont pas forcément prises en charge.
 212 @command{convert-ly} ne tolère qu'une seule option de sortie à la fois.
 213 La mise à jour automatique du code Scheme inclus dans les fichiers
 214 LilyPond est plus qu'hasardeuse ; attendez-vous à devoir mettre les
 215 mains dans le cambouis.
 216
 217
 218 @node Conversions manuelles
 219 @section Conversions manuelles
 220 @translationof Manual conversions
 221
 222 En théorie, un programme tel que @command{convert-ly} devrait pouvoir
 223 traiter n'importe quel changement de syntaxe.  En effet, si un programme
 224 informatique sait interpréter aussi bien une version que l'autre, un
 225 autre programme informatique doit alors être capable de traduire un
 226 fichier donné@footnote{Ceci est réalisable tant que le fichier LilyPond
 227 ne contient pas de Scheme.  Dès lors qu'un fichier contient du Scheme,
 228 des bribes de langage évolué se retrouvent danas le fichier LilyPond, ce
 229 qui conduit immanquablement au « problème de l'arrêt » bien connu en
 230 informatique.}.
 231
 232 Le projet LilyPond ne dispose cependant que de ressources limitées : les
 233 conversions ne sont pas toutes automatisées.  Voici une liste de
 234 problèmes clairement identifiés :
 235
 236
 237 @verbatim
 238 1.6->2.0:
 239  Doesn't always convert figured bass correctly, specifically things like {<
 240 >}.  Mats' comment on working around this:
 241    To be able to run convert-ly
 242    on it, I first replaced all occurrences of '{<' to some dummy like '{#'
 243    and similarly I replaced '>}' with '&}'.  After the conversion, I could
 244    then change back from '{ #' to '{ <' and from '& }' to '> }'.
 245  Doesn't convert all text markup correctly.  In the old markup syntax,
 246  it was possible to group a number of markup commands together within
 247 parentheses, e.g.
 248    -#'((bold italic) "string")
 249    This will incorrectly be converted into
 250    -\markup{{\bold italic} "string"}
 251    instead of the correct
 252    -\markup{\bold \italic "string"}
 253 2.0->2.2:
 254  Doesn't handle \partcombine
 255  Doesn't do \addlyrics => \lyricsto, this breaks some scores with multiple
 256 stanzas.
 257 2.0->2.4:
 258  \magnify isn't changed to \fontsize.
 259     - \magnify #m => \fontsize #f, where f = 6ln(m)/ln(2)
 260  remove-tag isn't changed.
 261     - \applyMusic #(remove-tag '. . .) => \keepWithTag #'. . .
 262  first-page-number isn't changed.
 263     - first-page-number no => print-first-page-number = ##f
 264  Line breaks in header strings aren't converted.
 265     - \\\\  as line break in \header strings => \markup \center-align <
 266       "First Line" "Second Line" >
 267  Crescendo and decrescendo terminators aren't converted.
 268     - \rced => \!
 269     - \rc => \!
 270 2.2->2.4:
 271  \turnOff (used in \set Staff.VoltaBracket = \turnOff) is not properly
 272 converted.
 273 2.4.2->2.5.9
 274  \markup{ \center-align <{ ... }> } should be converted to:
 275  \markup{ \center-align {\line { ... }} }
 276  but now, \line is missing.
 277 2.4->2.6
 278  Special LaTeX characters such as $~$ in text are not converted to UTF8.
 279 2.8
 280  \score{} must now begin with a music expression.  Anything else
 281  (particularly \header{}) must come after the music.
 282 @end verbatim
 283
 284