1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
2 @c This file is part of lilypond-program.tely
4 Translation of GIT committish: 1e2013ba299c3640143448cbd5ea72f2aa61e380
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. See TRANSLATION for details.
12 @c Translators: Jean-Charles Malahieude
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
23 * Setup for specific Operating Systems::
24 * Text editor support::
28 @node Setup for specific Operating Systems
29 @section Setup for specific Operating Systems
31 Cette partie explique comment optimiser l'installation propres à
38 @node Setup for MacOS X
39 @subsection Setup for MacOS X
41 @subsubheading Using Python scripts on MacOS 10.3 or 10.4
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
57 et dans le cas contraire
60 #!@var{/chemin/vers/nouvelle_installation/python}
64 @subsubheading MacOS X on the command line
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 :
72 @var{chemin/vers}/LilyPond.app/Contents/Resources/bin/lilypond
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.
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 :
88 Créez un fichier appelé @code{lilypond} et qui contiendra :
91 exec @var{chemin/vers}/LilyPond.app/Contents/Resources/bin/lilypond "$@@"
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.
100 Rendez ces fichiers exécutables :
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
111 export PATH=$PATH:~/bin
115 Ce fichier doit se terminer par une ligne vide.
117 Notez que @var{chemin/vers} devrait correspondre à @code{/Applications/}.
120 @node Text editor support
121 @section Text editor support
126 @cindex modes, editor
127 @cindex syntax coloring
128 @cindex coloring, syntax
130 Certains éditeurs de texte prennent en charge LilyPond.
142 @subsection Emacs mode
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
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}.
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} :
163 @c any reason we do not advise: (push "~/site-lisp" load-path)
165 (setq load-path (append (list (expand-file-name "~/site-lisp")) load-path))
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.
177 Le type de fichier LilyPond sera reconnu si votre
178 @file{~/.vim/filetype.vim} contient
181 if exists("did_load_filetypes")
184 augroup filetypedetect
185 au! BufNewFile,BufRead *.ly setf lilypond
189 N'oubliez pas d'inclure ce chemin en ajoutant à votre @file{~/.vimrc} la
193 set runtimepath+=/usr/local/share/lilypond/$@{LILYPOND_VERSION@}/vim/
197 où $@{LILYPOND_VERSION@} correspond à votre version de LilyPond. Si
198 LilyPond n'est pas installé dans @file{/usr/local/}, modifiez ce chemin
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}.
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}.
228 TextMate dispose d'un greffon pour LilyPond. Vous pouvez l'installer en
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/
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.
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.
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.
254 @node Point and click
255 @section Point and click
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.
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
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
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}.
278 urlCommand "lilypond-invoke-editor %s"
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
289 sera alors lancée la commande
291 emacsclient --no-wait +@var{line}:@var{column} @var{file}
294 sera alors lancée la commande
296 gvim --remote +:@var{line}:norm@var{char} @var{file}
300 sera alors lancée la commande
302 nc -noask +@var{line} @var{file}'
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,
312 emacsclient --no-wait +%(line)s:%(column)s %(file)s
316 en variable d'environnement @code{LYEDITOR} revient au lancement d'un
317 client emacs standard.
320 @cindex ficher de sortie, taille
321 @cindex taille du ficher de sortie
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
332 dans le fichier @file{.ly}. Il peut alors être activé de manière
339 Le pointer-cliquer peut aussi être désactivé au moment de la compilation
340 en ligne de commande :
343 lilypond -dno-point-and-click fichier.ly
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}.}