Documentation/fr/user/setup.itely

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