Documentation/fr/usage/setup.itely

   1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
   2
   3 @ignore
   4     Translation of GIT committish: 64a52df69da5818ac0adab4ad4b364a7498f8fb7
   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.12.0"
  12
  13 @c Translators: Jean-Charles Malahieude
  14
  15 @node Environnement de travail
  16 @chapter Environnement de travail
  17 @translationof Setup
  18
  19 Ce chapitre traite des options de configuration à effectuer après
  20 l'installation de LilyPond et de ses dépendances.  Il tient lieu de
  21 référence en la matière : ne vous intéressez qu'à la rubrique qui vous
  22 concerne directement.
  23
  24 @menu
  25 * Spécificités pour certains systèmes::
  26 * LilyPond et les éditeurs de texte::
  27 * Pointer-cliquer::
  28 @end menu
  29
  30 @node Spécificités pour certains systèmes
  31 @section Spécificités pour certains systèmes
  32 @translationof Setup for specific Operating Systems
  33
  34 Cette partie explique comment optimiser l'installation propres à
  35 certains systèmes.
  36
  37 @menu
  38 * Spécificités pour MacOS X::
  39 @end menu
  40
  41 @node Spécificités pour MacOS X
  42 @subsection Spécificités pour MacOS X
  43 @translationof Setup for MacOS X
  44
  45 @subsubheading Utilisation de scripts Python sur MacOS 10.3 ou 10.4
  46
  47 Les exécutables de LilyPond pour MacOS X ne fournissent pas Python, bien
  48 qu'une version au moins de niveau 2.4 soit requise par
  49 @command{convert-ly}.  Ainsi, et si vous utilisez MacOS 10.3 ou 10.4,
  50 devrez-vous installer une version plus récente de Python à partir de
  51 @uref{http://python.org/download/}, puis éditer la première ligne de
  52 @command{convert-ly} et @command{lilypond-book}. Si les exécutables du
  53 Python que vous venez d'installer sont dans votre @var{PATH}, cette ligne
  54 doit être :
  55
  56 @example
  57 #!/usr/bin/env python
  58 @end example
  59
  60 @noindent
  61 et dans le cas contraire
  62
  63 @example
  64 #!@var{/chemin/vers/nouvelle_installation/python}
  65 @end example
  66
  67
  68 @subsubheading MacOS X et la ligne de commande
  69
  70 Les scripts tels que @command{lilypond-book}, @command{convert-ly},
  71 @command{abc2ly}, et même @command{lilypond}, sont insclus dans un
  72 fichier @code{.app} pour MacOS@tie{}X.  Vous pourrez les lancer
  73 directement en ligne de commande de la manière suivante :
  74
  75 @example
  76 @var{chemin/vers}/LilyPond.app/Contents/Resources/bin/lilypond
  77 @end example
  78
  79 @noindent
  80 Il en va de même pour les autres scripts de ce répertoire, y compris
  81 @command{lilypond-book}, @command{convert-ly}, @command{abc2ly}, etc.
  82
  83 Une autre façon de procéder consiste à créer des scripts qui ajoutent
  84 automatiquement le chemin.  À cette intention, créez un répertoire qui
  85 contiendra ces scripts :
  86
  87 @example
  88 mkdir -p ~/bin
  89 cd ~/bin
  90 @end example
  91
  92 Créez un fichier appelé @code{lilypond} et qui contiendra :
  93
  94 @example
  95 exec @var{chemin/vers}/LilyPond.app/Contents/Resources/bin/lilypond "$@@"
  96 @end example
  97
  98 Créez autant de fichiers -- @code{lilypond-book}, @code{convert-ly}, et
  99 autres programmes annexes que vous utilisez (@code{abc2ly},
 100 @code{midi2ly}, etc) -- que de besoin.  Remplacez simplement
 101 @code{bin/lilypond} par @code{bin/convert-ly} ou tout autre nom de
 102 programme dans le fichier que vous créez.
 103
 104 Rendez ces fichiers exécutables :
 105
 106 @example
 107 chmod u+x lilypond
 108 @end example
 109
 110 Ajoutez alors ce répertoire à votre @var{PATH}.  Modifiez le fichier
 111 @code{.profile} -- créez-le si besoin -- de votre répertoire personnel,
 112 de telle sorte qu'il contienne
 113
 114 @example
 115 export PATH=$PATH:~/bin
 116 @end example
 117
 118 @noindent
 119 Ce fichier doit se terminer par une ligne vide.
 120
 121 Notez que @var{chemin/vers} devrait correspondre à @code{/Applications/}.
 122
 123
 124 @node LilyPond et les éditeurs de texte
 125 @section LilyPond et les éditeurs de texte
 126 @translationof Text editor support
 127
 128 @cindex editors
 129 @cindex vim
 130 @cindex emacs
 131 @cindex modes, editor
 132 @cindex syntax coloring
 133 @cindex coloring, syntax
 134
 135 Certains éditeurs de texte prennent en charge LilyPond.
 136
 137 @menu
 138 * Mode Emacs::
 139 * Mode Vim::
 140 * jEdit::
 141 * TexShop::
 142 * TextMate::
 143 * LilyKDE::
 144 @end menu
 145
 146 @node Mode Emacs
 147 @subsection Mode Emacs
 148 @translationof Emacs mode
 149
 150 Emacs dispose d'un @file{lilypond-mode} qui fournit l'autocomplétion des
 151 mots-clés, l'indentation, les appariements spécifiques à LilyPond, la
 152 coloration synthaxique, ainsi que des raccourcis pour compiler et
 153 consulter les manuels de LilyPond en mode info.  Si le
 154 @file{lilypond-mode} n'était pas installé sur votre système, procédez
 155 comme ci-dessous.
 156
 157 Le répertoire @file{elisp} inclus dans les sources contient aussi un
 158 mode pour saisir la musique et lancer LilyPond.  Faites @command{make
 159 install} pour l'installer dans votre @var{elispdir}.  Le fichier
 160 @file{lilypond-init.el} devrait trouver sa place dans
 161 @var{load-path}@file{/site-start.d/} ou bien ajouté à votre
 162 @file{~/.emacs} ou @file{~/.emacs.el}.
 163
 164 En tant que simple utilisateur, vous pouvez toujours ajouter votre
 165 propre répertoire (par exemple @file{~/site-lisp/}) à votre
 166 @var{load-path} en ajoutant la ligne suivante -- modifiée en conséquence
 167 -- à votre @file{~/.emacs} :
 168
 169 @c any reason we do not advise:  (push "~/site-lisp" load-path)
 170 @example
 171 (setq load-path (append (list (expand-file-name "~/site-lisp")) load-path))
 172 @end example
 173
 174
 175 @node Mode Vim
 176 @subsection Mode Vim
 177 @translationof Vim mode
 178
 179 En ce qui concerne @uref{http://@/www@/.vim@/.org,VIM}, LilyPond fournit
 180 un fichier @file{vimrc} qui gère la coloration synthaxique.  Le
 181 répertoire @code{$VIM} inclus dans les sources contient aussi un
 182 mode pour saisir la musique et lancer LilyPond.
 183
 184 Le type de fichier LilyPond sera reconnu si votre
 185 @file{~/.vim/filetype.vim} contient
 186
 187 @example
 188 if exists("did_load_filetypes")
 189   finish
 190 endif
 191 augroup filetypedetect
 192   au! BufNewFile,BufRead *.ly,*.ily           setf lilypond
 193 augroup END
 194 @end example
 195
 196 N'oubliez pas d'inclure ce chemin en ajoutant à votre @file{~/.vimrc} la
 197 ligne suivante :
 198
 199 @example
 200 set runtimepath+=/usr/local/share/lilypond/$@{LILYPOND_VERSION@}/vim/
 201 @end example
 202
 203 @noindent
 204 où $@{LILYPOND_VERSION@} correspond à votre version de LilyPond.  Si
 205 LilyPond n'est pas installé dans @file{/usr/local/}, modifiez ce chemin
 206 en conséquence.
 207
 208
 209 @node jEdit
 210 @subsection jEdit
 211 @translationof jEdit
 212
 213 Créé en tant que greffon pour l'éditeur de texte
 214 @uref{http://@/www@/.jedit@/.org@/,jEdit}, LilyPondTool est l'outil le
 215 plus riche en fonctionnalités pour éditer des partitions écrites avec
 216 LilyPond.  Cela inclue un assistant à la création de document qui prend
 217 en charge les paroles, un visionneur de PDF avec gestion du
 218 pointer-cliquer.  Captures d'écran, démonstrations et instructions
 219 d'installation sont disponibles sur le site de
 220 @uref{http://lilypondtool@/.organum@/.hu,LilyPondTool}.
 221
 222
 223 @node TexShop
 224 @subsection TexShop
 225 @translationof TexShop
 226
 227 L'éditeur
 228 @uref{http://@/www@/.uoregon@/.edu/~koch/texshop/index@/.html,TexShop}
 229 pour MacOS@tie{}X peut prendre en charge LilyPond, lilypond-book et
 230 convert-ly, en lui adjoignant les extensions disponibles
 231 @uref{http://@/www@/.dimi@/.uniud@/.it/vitacolo/freesoftware@/.html,ici}.
 232
 233
 234 @node TextMate
 235 @subsection TextMate
 236 @translationof TextMate
 237
 238 TextMate dispose d'un greffon pour LilyPond.  Vous pouvez l'installer en
 239 lançant :
 240
 241 @example
 242 mkdir -p /Library/Application\ Support/TextMate/Bundles
 243 cd /Library/Application\ Support/TextMate/Bundles
 244 svn co http://macromates.com/svn/Bundles/trunk/Bundles/Lilypond.tmbundle/
 245 @end example
 246
 247
 248 @node LilyKDE
 249 @subsection LilyKDE
 250 @translationof LilyKDE
 251
 252 @uref{http://lilykde.googlecode.com/,LilyKDE} est un greffon pour
 253 @uref{http://kate-editor.org/,Kate}, l'éditeur de texte de
 254 l'environnement de bureau KDE.  Il dispose d'un assistant à la création
 255 de document LilyPond et un visionneur de PDF.
 256
 257 LilyKDE peut s'interfacer avec
 258 @uref{http://www.volny.cz/smilauer/rumor/,Rumor}, afin de pouvoir entrer
 259 la musique à l'aide d'un clavier MIDI.
 260
 261 LilyKDE gère l'hyphénation des paroles, et le gestionnaire de fichiers
 262 de KDE permet de lancer LilyPond sur plusierus fichiers simultanément.
 263
 264
 265 @node Pointer-cliquer
 266 @section Pointer-cliquer
 267 @translationof Point and click
 268
 269 Le pointer-cliquer (@emph{point and click}) permet de se retrouver
 270 directement dans le fichier source, à la note que l'on pointe dans le
 271 visionneur de PDF.  Ceci facilite grandement le repérage des erreurs à
 272 partir du fichier imprimable.
 273
 274 Lorsque cette fonctionnalité est active, LilyPond ajoute des hyperliens
 275 au fichier PDF.  Ces liens sont transmis au navigateur internet qui se
 276 charge d'ouvrir un éditeur de texte à l'enfroit même où le curseur
 277 pointe.
 278
 279 Afin que cette chaîne de traitement soit pleinement opérationnelle, il
 280 faut configurer votre visionneur de PDF de façon à ce qu'il suive les
 281 liens grâce au script @file{lilypond-invoke-editor} fourni avec
 282 LilyPond.
 283
 284
 285 Pour Xpdf, sous UNIX, vous devrez insérer la ligne suivante dans
 286 le fichier @file{xpdfrc} -- soit @file{/etc/xpdfrc}, soit dans votre
 287 répertoire personnel @file{.xpdfrc}.
 288
 289 @example
 290 urlCommand     "lilypond-invoke-editor %s"
 291 @end example
 292
 293 @file{lilypond-invoke-editor} est un petit programme assistant.  Il se
 294 charge d'appeler un éditeur pour les identifants de ressource
 295 (@emph{URI}) de type @code{textedit}, et un navigateur pour les autres.
 296 Il teste en outre la variable d'environnement @code{EDITOR} pour les cas
 297 suivant :
 298
 299 @table @code
 300 @item emacs
 301   sera alors lancée la commande
 302 @example
 303 emacsclient --no-wait +@var{line}:@var{column} @var{file}
 304 @end example
 305 @item vim
 306   sera alors lancée la commande
 307 @example
 308 gvim --remote +:@var{line}:norm@var{char} @var{file}
 309 @end example
 310
 311 @item nedit
 312   sera alors lancée la commande
 313 @example
 314 nc -noask +@var{line} @var{file}'
 315 @end example
 316 @end table
 317
 318 La variable d'environnement @code{LYEDITOR} permet d'anticiper cette
 319 affectation, puisqu'elle contient la commande qui permet de lancer
 320 l'éditeur en tenant compte des valeurs respectives de @code{%(file)},
 321 @code{%(column)} , et@code{%(line)}. Par exemple,
 322
 323 @example
 324 emacsclient --no-wait +%(line)s:%(column)s %(file)s
 325 @end example
 326
 327 @noindent
 328 en variable d'environnement @code{LYEDITOR} revient au lancement d'un
 329 client emacs standard.
 330
 331
 332 @cindex ficher de sortie, taille
 333 @cindex taille du ficher de sortie
 334
 335 L'option pointer-cliquer accroît la taille des fichiers de manière
 336 significative.  Afin de réduire la taille des fichiers PDF et PS, il est
 337 toujours possible de désactiver le pointer-cliquer en ajoutant
 338
 339 @example
 340 \pointAndClickOff
 341 @end example
 342
 343 @noindent
 344 dans le fichier @file{.ly}.  Il peut alors être activé de manière
 345 explicite grâce à
 346
 347 @example
 348 \pointAndClickOn
 349 @end example
 350
 351 Le pointer-cliquer peut aussi être désactivé au moment de la compilation
 352 en ligne de commande :
 353
 354 @example
 355 lilypond -dno-point-and-click fichier.ly
 356 @end example
 357
 358 @warning{Lorsqu'un fichier LilyPond est destiné à être redistribué,
 359 pensez à désactiver le pointer-cliquer, de telle sorte que les chemins
 360 d'accès et autres informations propres à votre système ne se retrouvent
 361 pas inclus dans le fichier  @file{.pdf}.}
 362