1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
3 Translation of GIT committish: c610645cc9a77cba1a2798280965db142d649ac5
5 When revising a translation, copy the HEAD committish of the
6 version that you are working on. For details, see the Contributors'
7 Guide, node Updating translation committishes..
12 @c Translators: Jean-Charles Malahieude
13 @c Translation checkers:
15 @node Exécution de lilypond
16 @chapter Exécution de @command{lilypond}
17 @translationof Running lilyPond
19 Ce chapitre passe en revue ce qui se passe lorsque vous lancez LilyPond.
22 * Utilisation habituelle::
23 * Utilisation en ligne de commande::
25 * Quelques erreurs des plus courantes::
28 @node Utilisation habituelle
29 @section Utilisation habituelle
30 @translationof Normal usage
32 La plupart des utilisateurs de LilyPond le font au travers d'une
33 interface graphique (@emph{GUI} pour @emph{graphical user interface}).
34 Si vous ne l'avez pas encore parcouru, lisez le @rlearning{Tutoriel}.
35 Si vous utilisez un éditeur alternatif pour rédiger vos fichiers
36 LilyPond, référez-vous à la documentation de celui-ci.
39 @node Utilisation en ligne de commande
40 @section Utilisation en ligne de commande
41 @translationof Command-line usage
43 Nous nous intéresserons ici aux spécificités de LilyPond employé en
44 ligne de commande. La ligne de commande permet de faire appel à
45 certaines options particulières. D'autre part, certains utilitaires
46 associés, tel que @code{midi2ly}, ne sont disponibles qu'en ligne de
49 Par @qq{ligne de commande}, nous entendons l'interface de commande du
50 système. Les utilisateurs de Windows seront certainement plus familiers
51 des termes @qq{fenêtre DOS} ou @qq{invite de commande}. Quant aux
52 utilisateurs de MacOS@tie{}X, ils connaissent assurément les termes
53 @qq{console} et @qq{terminal}. Les paramétrages spécifiques au système
54 MacOS font l'objet d'un @rwebnamed{MacOS X,chapitre particulier}.
56 Notre propos n'est pas ici d'expliquer ce qu'est l'interface de
57 commande pour un système informatique ni comment elle fonctionne.
58 Aussi, si vous ne savez de quoi il retourne, nous vous renvoyons aux
59 nombreuses documentations que vous pourrez trouver sur ce sujet.
63 * Lancement de lilypond::
64 * Options basiques de lilypond::
65 * Options avancées de lilypond::
66 * Variables d'environnement::
67 * Exécution de LilyPond en mode protégé::
70 @node Lancement de lilypond
71 @unnumberedsubsec Lancement de @command{lilypond}
72 @translationof Invoking lilypond
74 L'exécutable @command{lilypond} en ligne de commande se lance
78 lilypond [@var{option}]@dots{} @var{fichier}@dots{}
81 Lorsque le fichier est fourni sans extension, LilyPond présume qu'il
82 s'agit de @file{.ly}. Pour interpréter directement l'entrée standard
83 (@emph{stdin}), fournissez un tiret (@code{-}) en lieu et place de
86 Le traitement de @file{monfichier.ly} produira @file{monfichier.ps} et
87 @file{monfichier.pdf}. Vous pouvez spécifier plusieurs fichiers à la
88 fois@tie{}; ils seront traités indépendamment les uns des
89 autres.@footnote{Le statut de GUILE n'étant pas réinitialisé après
90 traitement d'un fichier @file{.ly}, veillez à ne pas modifier les
91 réglages par défaut du système à partir d'assertions en Scheme.}
93 Lorsque @file{monfichier.ly} contient plus d'une section @code{\book},
94 les fichiers produits -- à partir du deuxième -- seront numérotés. Par
95 ailleurs, la valeur affectée à @code{output-suffix} sera insérée entre la
96 racine et le numéro. Par exemple, un fichier @var{racine} qui
100 #(define output-suffix "violon")
102 #(define output-suffix "cello")
107 fournira grâce à LilyPond @file{@var{racine}-violon.pdf} et
108 @file{@var{racine}-cello-1.pdf}.
111 @unnumberedsubsubsec Commandes standard de l'interpréteur
112 @translationof Standard shell commands
114 Si votre interpréteur -- terminal, console, etc. -- prend en charge les
115 redirections, les commandes qui suivent vous permettront de
116 judicieusement rediriger les affichages de la console dans un
122 @code{lilypond fichier.ly 1>stdout.log} pour le verbiage normal
125 @code{lilypond fichier.ly 2>stderr.log} pour les messages d'erreur
128 @code{lilypond fichier.ly &>tous.log} pour garder une trace de tout ce
133 Consultez avant tout la documentation de votre interpréteur habituel
134 pour vérifier qu'il prend en charge ces options dans cette syntaxe.
135 Notez bien qu'il s'agit ici de commandes internes à l'interpréteur et
136 qui n'ont rien à voir avec LilyPond.
139 @node Options basiques de lilypond
140 @unnumberedsubsec Options basiques de @command{lilypond}
141 @translationof Basic command line options for LilyPond
143 @cindex lancement de @command{lilypond}
144 @cindex ligne de commande, options pour @command{lilypond}
145 @cindex options, ligne de commande
149 Différentes options sont disponibles en ligne de commande@tie{}:
153 @item -d,--define-default=@var{variable}=@var{valeur}
154 Voir @ref{Options avancées de lilypond}.
156 @cindex Scheme, évaluation d'expression
157 @cindex expression Scheme, évaluation
158 @item -e,--evaluate=@var{expr}
159 Évalue l'expression Scheme @var{expr} avant d'analyser tout fichier
160 @file{.ly}. Lorsque vous spécifiez l'option @option{-e} à plusieurs
161 reprises, l'évaluation sera faite en séquence.
163 Dans la mesure où l'expression est évaluée par le module
164 @code{guile-user}, vous devrez, dès lors que @var{expr} utilise des
165 définitions, spécifier
168 lilypond -e '(define-public a 42)'
172 en ligne de commande, et ajouter la ligne
175 #(use-modules (guile-user))
179 en tête de votre fichier @file{.ly}.
181 @warning{Les utilisateurs de Windows doivent utiliser des guillemets
182 doubles @code{"} en lieu et place des guillemets simples @code{'}.}
183 @c Match " in context-sensitive editors
185 @cindex sortie, format
186 @cindex format de sortie
187 @item -f,--format=@var{format}
188 Détermine le format à produire. Il peut s'agir de @code{ps}, @code{pdf}
191 Exemple : @code{lilypond -fpng @var{monfichier}.ly}
194 Affiche un résumé des commandes.
196 @item -H,--header=@var{CHAMP}
197 Recopie le champ d'entête dans le fichier @file{RACINE.@var{CHAMP}}.
199 @item -i,--init=@var{fichier}
200 Définit @var{fichier} (par défaut @file{init.ly}) en tant que fichier
203 @cindex recherche de fichier
204 @cindex chemin de recherche
205 @item -I,--include=@var{répertoire}
206 Ajoute @var{répertoire} au chemin de recherche pour les inclusions.
208 Vous pouvez mentionner plusieurs fois l'option @option{-I}, auquel cas
209 la recherche commencera dans le premier répertoire inclus et, si le
210 fichier en question ne s'y trouve pas, les répertoires suivants seront
211 examinés l'un après l'autre.
213 @cindex chroot jail, fonctionnement
214 @item -j,--jail=@var{user},@var{group},@var{jail},@var{dir}
215 Lance @command{lilypond} dans un environnement protégé.
217 L'option @option{--jail} est une alternative qui offre plus de
218 flexibilité que l'option @option{--safe} lorsque LilyPond est installé
219 sur un serveur web ou traite des fichiers externes -- voir
220 @ref{Options avancées de lilypond}.
222 L'option @option{--jail} va détourner la racine de @command{lilypond}
223 sur @var{jail} juste avant d'effectuer la compilation à proprement
224 parler. L'utilisateur et le groupe sont modifiés en conséquence, et le
225 répertoire en cours devient @var{dir}. Ces réglages assurent -- du
226 moins en théorie -- l'impossibilité de s'échapper de la cellule. Notez
227 cependant que, pour que l'option @option{--jail} soit fonctionnelle,
228 @command{lilypond} doit être lancé en tant qu'administrateur -- ce qui
229 se réalise aisément à l'aide de la commande @command{sudo}.
231 La création d'un environnement sécurisé requiert quelques précautions
232 dans la mesure où LilyPond doit disposer de tout ce dont il a besoin
233 pour compiler le fichier source @strong{à l'intérieur de la cellule}.
234 L'ermitage, avant d'être viable, requiert donc les étapes
239 @item Création d'un système de fichiers indépendant
240 L'intérêt d'un système de fichiers dédié à LilyPond réside dans le fait
241 qu'on peut le brider à l'aide des options @code{noexec}, @code{nodev} et
242 @code{nosuid}. Il sera de fait impossible de lancer des exécutables ou
243 d'écrire sur un périphérique à partir de LilyPond. Si vous n'avez pas
244 l'intention de créer un tel système sur une partition séparée, vous
245 pouvez avoir recours à un pseudo-périphérique (@emph{loop device}) monté
246 à partir d'un simple fichier de taille raisonnable. D'autre part, le
247 recours à un système de fichiers indépendant permet de limiter l'espace
250 @item Création d'un utilisateur spécifique
251 L'utilisation de LilyPond au sein de la cellule devrait être réservé à
252 un utilisateur aux droits restreints. Il faudra donc créer un
253 utilisateur et un groupe spécifiques -- disons
254 @w{@code{lily}/@code{lily}} -- qui n'aura accès en écriture qu'à un
255 unique répertoire déterminé par la valeur de @var{dir}.
257 @item Agencement des lieux
258 LilyPond a besoin d'un certain nombre de fichiers pour pouvoir tourner
259 correctement. Ces fichiers devront donc tous se retrouver dans
260 l'environnement protégé, distribués selon la même arborescence que dans
261 le système d'origine. Ainsi l'intégralité de l'installation de LilyPond
262 (en principe @file{/usr/share/lilypond}) doit y être dupliquée.
264 En cas de problème, lancer LilyPond en utilisant @command{strace}
265 devrait vous permettre de déterminer quels fichiers manquent à l'appel.
267 @item Lancement de LilyPond
268 Dans un environnement protégé monté avec l'option @code{noexec}, il
269 est impossible de lancer un quelconque programme extérieur. LilyPond ne
270 saurait donc avoir recours à un moteur de traitement qui le mettrait
271 dans cette situation. Comme nous l'avons vu plus haut, LilyPond sera
272 lancé avec les privilèges de l'administrateur -- privilèges qu'il perdra
273 aussitôt --, ce qui peut nécessiter le recours à la commande
274 @code{sudo}. Il est par ailleurs judicieux de limiter le temps
275 processeur alloué à LilyPond -- grâce à @command{ulimit@tie{}-t} par
276 exemple -- ainsi que, si votre système le permet, la taille de la
277 mémoire. Voir aussi @ref{Exécution de LilyPond en mode protégé}.
281 @cindex verbosité, définir le degré de
282 @item -l,--loglevel=@var{DEGRÉ}
283 Règle le niveau de verbosité des messages console à @var{DEGRÉ}. Les
284 différentes valeurs sont@tie{}:
288 Aucun verbiage, même pas les messages d'erreur.
291 Uniquement les messages d'erreur@tie{}; pas de message d'avertissement
295 Messages d'avertissement ou d'erreur@tie{}; pas d'information de
299 Information de progression basique (réussite) et avertissements ou erreurs.
302 Toutes les informations de progression, avertissements et erreurs.
304 @item INFO (par défaut)
305 Informations de progression, avertissements et erreurs, ainsi que
306 d'autres informations quant à l'exécution.
309 Tout ce qui peut être affiché, y compris le verbiage utile au débogage.
314 @cindex répertoire de destination
315 @cindex fichier de destination
316 @item -o,--output=@var{FICHIER} ou @var{RÉPERTOIRE}
317 Détermine le nom par défaut du fichier résultant à @var{FICHIER}@tie{};
318 lorsque l'argument @var{RÉPERTOIRE} correspond à un répertoire déjà
319 existant, c'est là que les fichiers résultants seront déposés. Le
320 suffixe adéquat sera ajouté (par ex. @code{.pdf} pour du pdf) dans tous
323 @cindex PostScript, output
324 @cindex PS (PostScript), output
326 Génère du PostScript.
328 @cindex Portable Network Graphics (PNG), output
329 @cindex PNG (Portable Network Graphics), output
331 Génère une image par page, au format PNG@tie{}; ceci sous-entend
332 l'utilisation de @option{--ps}. La résolution de l'image, en DPI, peut
333 se régler en ajoutant par exemple
338 @cindex Portable Document Format (PDF), output
339 @cindex PDF (Portable Document Format), output
341 Génère du PDF. Ceci sous-entend l'utilisation de @option{--ps}.
344 Affiche le numéro de version.
347 Active le mode verbeux@tie{}: affichage de l'intégralité du chemin
348 d'accès de chaque fichier, et information des temps de traitement.
351 Affiche les informations de garantie applicables à GNU LilyPond -- il
352 est livré @strong{SANS GARANTIE}@tie{}!
357 @node Options avancées de lilypond
358 @unnumberedsubsec Options avancées de @command{lilypond}
359 @translationof Advanced command line options for LilyPond
363 @item -d@var{[nom-option]}=@var{[valeur]},--define-default=@var{[nom-option]}=@var{[valeur]}
364 Affecte la valeur Scheme @var{valeur} à l'option interne @var{nom-option} du
365 programme. En l'absence de @var{valeur}, le programme utilisera @var{#t}.
366 Préfixer @var{nom-option} d'un @code{no-} vous permet de désactiver une option.
369 @cindex point and click, ligne de commande
370 @cindex pointer-cliquer, ligne de commande
383 @noindent Voici les différentes options disponibles, ainsi que leur
386 @multitable @columnfractions .33 .16 .51
387 @item @strong{Symbole}
389 @tab @strong{Observations}
392 @item @code{anti-alias-factor}
394 @tab Adopte une résolution supérieure (selon le facteur donné),puis
395 réduit au niveau du résultat afin d'éviter les @qq{distorsions} des
398 @item @code{aux-files}
400 @tab Génère les fichiers @code{.tex}, @code{.texi} et @code{.count}
401 pour le moteur de rendu @code{EPS}.
405 @tab Détermine le format de sortie à utiliser par le moteur de
406 traitement. Les fichiers PostScript (format par défaut) incluent les
407 fontes @code{TTF}, @code{Type1} et @code{OTF}, et aucune substitution ne
408 sera opérée pour ces fontes. Si vous utilisez des jeux de caractères
409 orientaux, le fichier aura vite fait d'atteindre une taille conséquente.
413 @tab Génère du PostScript encapsulé. Chaque page (système) fera l'objet
414 d'un fichier @file{EPS} particulier, sans fontes, auquel sera associé un
415 fichier @file{EPS} qui, lui, contiendra toutes les pages (systèmes) et
416 les fontes. Notez qu'il s'agit du mode que @command{lilypond-book}
421 @tab Ne génère aucun fichier imprimable. Cette option est équivalente à
422 @code{-dno-print-pages}.
426 @tab Génère du@emph{Scalable Vector Graphics}. Cette option permet de
427 créer un fichier @code{SVG} par page, sans incorporation des fontes.
428 Nous vous recommandons d'installer les fontes Century Schoolbook
429 comprises dans le paquetage LilyPond afin d'obtenir le meilleur rendu
430 possible. Sous UNIX, il suffit de les recopier, à partir du répertoire
431 @file{/usr/share/lilypond/VERSION/fonts/otf/}, dans @file{~/.fonts/}.
432 Les fichiers @code{SVG} alors générés devraient être lisibles par votre
433 éditeur SVG habituel. L'option @code{svg-woff} -- voir ci-après --
434 permet d'utiliser les fontes @code{woff} avec le moteur @code{SVG}.
438 @tab Recopie littéralement les commandes Scheme internes de formatage.
440 @item @code{check-internal-types}
442 @tab Vérifie qu'à chaque propriété est bien affecté un type.
444 @item @code{clip-systems}
446 @tab Génère des typons à partir d'une partition.
450 @tab Détermine le préfixe des fichiers de données (lecture seule).
452 @item @code{debug-gc}
454 @tab Génère une copie brute de la mémoire, aux fins de débogage.
456 @item @code{debug-gc-assert-parsed-dead}
458 @tab Pour débogage de la mémoire@tie{}: s'assure que toute référence à
459 des objets analysés est effacée. Il s'agit d'une option interne qui
460 est automatiquement activée par l'option @code{`-ddebug-gc'}.
462 @item @code{debug-lexer}
464 @tab Débogage de l'analyseur lexical @emph{flex}.
466 @item @code{debug-page-breaking-scoring}
468 @tab Purge les calculs des configurations de saut de page.
470 @item @code{debug-parser}
472 @tab Débogage de l'analyseur @emph{bison}.
474 @item @code{debug-property-callbacks}
476 @tab Débogage des chaînes de @emph{callback} cycliques.
478 @item @code{debug-skylines}
480 @tab Débogage des lignes d'horizon.
482 @item @code{delete-intermediate-files}
484 @tab Supprime les fichiers @code{.ps} inutiles crées lors de la
487 @item @code{dump-cpu-profile}
489 @tab Génère une copie brute des informations de timing (dépend du
492 @item @code{dump-profile}
494 @tab Génère une copie brute de la mémoire et des temps de traitement
497 @item @code{dump-signatures}
499 @tab Génère une copie des signatures de chaque système. Cette option
500 est utilisée pour les tests de régression.
502 @item @code{eps-box-padding}
504 @tab Décale le bord gauche du typon EPS d'une valeur donnée en
507 @item @code{gs-load-fonts}
509 @tab Charge les fontes grâce à Ghostscript.
511 @item @code{gs-load-lily-fonts}
513 @tab Limites les fontes chargées par Ghostscript aux seules fontes
518 @tab Travaille silencieusement, et redirige tout le verbiage dans un
523 @strong{Note à l'attention des utilisateurs de Windows@tie{}:} toutes
524 les informations concernant le traitement apparaissent au fur et à
525 mesure dans l'interpréteur de commandes lorsque vous lancez le programme
526 @code{lilypond.exe}, à l'inverse de @w{@code{lilypond-windows.exe}} qui
527 vous renvoie simplement la main. L'option @option{-dgui} vous permettra
528 alors de rediriger ces informations dans un fichier journal.
530 @multitable @columnfractions .33 .16 .51
533 @tab Affiche cette aide.
535 @item @code{include-book-title-preview}
537 @tab Inclut les titres de l'ouvrage dans les images de prévisualisation.
539 @item @code{include-eps-fonts}
541 @tab Inclut les fontes dans chaque fichier EPS contenant un système.
543 @item @code{include-settings}
545 @tab Inclut un fichier contenant les réglages globaux. Ce fichier sera
546 inclus avant traitement de la partition.
548 @item @code{job-count}
550 @tab Traite plusieurs fichiers en parallèle, selon le nombre de
553 @item @code{log-file}
554 @tab @code{#f [fichier]}
555 @tab Fournir @code{TOTO} en second argument redirigera la sortie dans le
556 fichier journal @code{TOTO.log}.
558 @item @code{max-markup-depth}
560 @tab Profondeur maximale de l'arborescence de @emph{markups}. Si un
561 @emph{markup} était plus profond, part du principe qu'on aboutira pas,
562 émet un avertissement et renvoie alors un @emph{markup} vide.
564 @item @code{midi-extension}
566 @tab Détermine l'extension par défaut des fichiers MIDI, selon la chaîne
569 @item @code{music-strings-to-paths}
571 @tab Convertit les chaînes textuelles en chemins lorsque les glyphes
572 font partie d'une fonte musicale.
574 @item @code{old-relative}
576 @tab Affecte au mode @code{\relative} le même comportement pour de la
577 musique simultanée que celui d'une syntaxe d'accords.
579 @cindex paper-size, ligne de commande
580 @item @code{paper-size}
582 @tab Détermine la taille par défaut du papier. Veillez à ne pas oublier
583 d'encadrer la valeur par des guillemets échappés (@code{\"}).
584 @c Match " in context-sensitive editors
586 @item @code{pixmap-format}
588 @tab Détermine le format de sortie en images pixélisées pour
591 @item @code{point-and-click}
593 @tab Ajoute les liens @qq{point & click} à la sortie @code{PDF}. Voir
594 @ref{Pointer-cliquer}.
596 @cindex format de sortie, définition
597 @cindex preview, ligne de commande
600 @tab Génère une prévisualisation en plus de la sortie normale.
604 Cette option, disponible dans tous les formats de sortie imprimables --
605 @code{pdf}, @code{png}, @code{ps}, @code{eps} et @code{svg} -- génère
606 un fichier de la forme @code{monFichier.preview.extension} comprenant le
607 titrage et le premier système. S'il existe plusieurs sections
608 @code{\book}, @code{\bookpart}, ce fichier contiendra les titrage et
609 premier système de chacun des @code{\book}, @code{\bookpart} et
610 @code{\score}, dès lors que la variable @code{print-all-headers} du bloc
611 @code{\paper} est activée.
613 Pour l'éviter, utilisez conjointement l'une des options
614 @option{-dprint-pages} ou @option{-dno-print-pages} selon vos besoins.
616 @multitable @columnfractions .33 .16 .51
617 @item @code{print-pages}
619 @tab Génère l'intégralité des pages de la partition. L'option
620 @option{-dno-print-pages} est particulièrement utile lorsqu'utilisée
621 conjointement avec l'option @option{-dpreview}.
623 @item @code{profile-property-accesses}
625 @tab Enregistre des statistiques des appels à la fonction
626 @code{get_property()}.
628 @item @code{protected-scheme-parsing}
630 @tab Continue en dépit des erreurs que l'analyseur syntaxique
631 détecterait dans du code Scheme inclus. Lorsque basculé sur @code{#f},
632 stoppe le traitement s'il y a erreur et affiche une trace de la pile.
634 @item @code{read-file-list}
635 @tab @code{#f [fichier]}
636 @tab Spécifie un fichier listant les différents fichier sources à
639 @item @code{relative-includes}
641 @tab Face à une instruction @code{\include}, recherche les fichiers à
642 inclure relativement à l'endroit où se trouve le fichier en cours de
643 traitement plutôt que par rapport au fichier maître.
645 @item @code{resolution}
647 @tab Détermine, en @code{dpi}, la résolution des pixmaps @code{PNG} à
648 générer selon la valeur donnée.
652 @tab Ne pas avoir une confiance aveugle dans le code @file{.ly}.
656 Lorsque LilyPond est accessible au travers d'un serveur web, il est
657 @strong{impératif} d'utiliser les options @option{--safe} ou
658 @option{--jail}. L'option @option{--safe} aura pour effet d'empêcher
659 tout code Scheme inclus de mettre en péril votre installation grâce à
660 quelque chose du style
666 c4^$(ly:gulp-file "/etc/passwd")
671 L'option @code{-dsafe} forcera l'évaluation, au fil de l'eau et par un
672 module sécurisé, des expressions Scheme contenues dans le fichier
673 source. Ce module sécuritaire, dérivé du module GUILE @file{safe-r5rs},
674 ajoute un certain nombre de fonctions -- listées dans
675 @file{scm/safe-lily.scm} -- à l'API de LilyPond.
677 De plus, le mode @emph{safe} ne permet ni l'utilisation de directives
678 @code{\include} ni le recours aux obliques inversées (@emph{backslash})
679 dans les chaînes @TeX{}. L'import de variables LilyPond dans du code
680 Scheme n'est pas possible en mode sécuritaire.
682 L'option @code{-dsafe} @strong{ne détecte pas} l'utilisation abusive des
683 ressources. Il est donc possible que le programme finisse par rester
684 sans réponse si on lui envoie une boucle sans fin. C'est la raison pour
685 laquelle nous recommandons, lorsque LilyPond tourne sur un serveur
686 accessible au public, d'en limiter aussi bien les ressources processeur
689 Notez bien que l'utilisation du mode sécuritaire empêchera aussi la
690 compilation d'un certain nombre de fragments LilyPond. L'option
691 @code{--jail} est dans ce cas une excellente alternative en terme de
692 sécurité, même si elle requiert plus de temps à mettre en place -- voir
693 @ref{Options basiques de lilypond}.
695 @multitable @columnfractions .33 .16 .51
696 @item @code{separate-log-files}
698 @tab Pour les fichiers @code{FICHIER1.ly}, @code{FICHIER2.ly} etc.
699 enregistre le déroulement dans les journaux @code{FICHIER1.log},
700 @code{FICHIER2.log}@dots{}
702 @item @code{show-available-fonts}
704 @tab Liste le nom des fontes disponibles.
706 @item @code{strict-infinity-checking}
708 @tab Force le crash en présence des points d'exception de virgule
709 flottante @code{Inf} ou @code{NaN} -- infini ou non-nombre.
711 @item @code{strip-output-dir}
713 @tab Supprime, lors du nommage des fichiers résultant, la partie
714 correspondant au répertoire des fichiers sources.
716 @item @code{svg-woff}
718 @tab Utilise, avec le moteur SVG, les fontes @code{woff}.
720 @item @code{trace-memory-frequency}
722 @tab Enregistre l'utilisation de la cellule Scheme plusieurs fois par
723 seconde, dans les fichiers @code{FICHIER.stacks} et
724 @code{FICHIER.graph}.
726 @item @code{trace-scheme-coverage}
728 @tab Enregistre la couverture des fichiers Scheme dans @code{FILE.cov}.
732 @tab Passe en mode verbeux, ce qui correspond à un niveau de
733 journalisation @code{DEBUG} (lecture seule).
735 @item @code{warning-as-error}
737 @tab Considère tous les messages d'avertissement et @qq{erreur de
738 programmation} comme étant de véritables erreurs.
742 @node Variables d'environnement
743 @unnumberedsubsec Variables d'environnement
744 @translationof Environment variables
747 @cindex LILYPOND_DATADIR
749 @command{lilypond} reconnaît les variables d'environnement
753 @item LILYPOND_DATADIR
754 Cette variable spécifie le répertoire où seront recherchés par défaut
755 les différentes versions des messages ainsi qu'un certain nombre de
756 fichiers nécessaires au traitement. Il devrait contenir les
757 sous-répertoires @file{ly/}, @file{ps/}, @file{tex/}, etc.
760 Cette variable détermine la langue dans laquelle seront émis les
763 @item LILYPOND_LOGLEVEL
764 Cette variable détermine le niveau par défaut de verbosité. En
765 l'absence de niveau explicite -- autrement dit la ligne de commande ne
766 comporte pas de @option{--loglevel} -- c'est cette valeur qui sera
769 @item LILYPOND_GC_YIELD
770 Cette variable permet d'ajuster l'empreinte mémoire et le rendement de
771 la machine. Il s'agit en fait d'un pourcentage d'allocation de
772 mémoire@tie{}: lorsqu'il est élevé, le programme favorisera
773 l'utilisation de la mémoire@tie{}; une faible valeur consommera plus de
774 temps processeur. Par défaut, cette valeur est fixée à@tie{}@code{70}.
779 @node Exécution de LilyPond en mode protégé
780 @unnumberedsubsec Exécution de LilyPond en mode protégé
781 @translationof LilyPond in chroot jail
783 Paramétrer un serveur afin qu'il puisse faire fonctionner LilyPond en
784 mode protégé sur un pseudo-périphérique est une tâche sensible. Les
785 différentes étapes à suivre sont répertoriées ci-dessous. Les exemples
786 qu'elle comportent proviennent d'une distribution Linux Ubuntu et
787 nécessiteront l'utilisation de @code{sudo} autant que de besoin.
791 @item Installation des paquetages nécessaires@tie{}: LilyPond, Ghostscript et
794 @item Création de l'utilisateur @code{lily} :
801 Ceci, par la même occasion, créera un groupe spécifique pour
802 l'utilisateur @code{lily} ainsi que son répertoire personnel
805 @item Création, dans le répertoire personnel de l'utilisateur
806 @code{lily}, d'un espace agissant en tant que système de fichiers@tie{}:
809 dd if=/dev/zero of=/home/lily/loopfile bs=1k count= 200000
813 Cette commande a créé un fichier de 200@tie{}MB utilisable par le
814 @qq{système protégé}.
816 @item Création d'un pseudo-périphérique, génération d'un système de
817 fichiers et chargement de celui-ci, puis création d'un répertoire
818 accessible en écriture pour l'utilisateur @code{lily}@tie{}:
822 losetup /dev/loop0 /home/lily/loopfile
823 mkfs -t ext3 /dev/loop0 200000
824 mount -t ext3 /dev/loop0 /mnt/lilyloop
825 mkdir /mnt/lilyloop/lilyhome
826 chown lily /mnt/lilyloop/lilyhome
829 @item Affectation, au niveau configuration du serveur, de
830 @code{/mnt/lilyloop} en tant que JAIL et @code{/lilyhome} en tant que
833 @item Création d'une arborescence, dans l'espace protégé, et recopie de
834 tous les fichiers nécessaires -- voir le script plus loin.
836 Le recours à l'utilitaire @code{sed} permet de créer les commandes de
837 copie de tout ce qui est nécessaire à un exécutable@tie{}:
840 for i in "/usr/local/lilypond/usr/bin/lilypond" "/bin/sh" "/usr/bin/; \
841 do ldd $i | sed 's/.*=> \/\(.*\/\)\([^(]*\).*/mkdir -p \1 \&\& \
842 cp -L \/\1\2 \1\2/' | sed 's/\t\/\(.*\/\)\(.*\) (.*)$/mkdir -p \
843 \1 \&\& cp -L \/\1\2 \1\2/' | sed '/.*=>.*/d'; done
848 @subheading Exemple de script fonctionnel en 32-bit sur Ubuntu 8.04
852 ## les réglages par défaut
856 loopdevice=/dev/loop0
857 jaildir=/mnt/lilyloop
858 # le préfixe (sans slash au début !)
860 # le répertoire du système où lilypond est installé
861 lilydir=/$lilyprefix/lilypond/
863 userhome=$home/$username
864 loopfile=$userhome/loopfile
866 dd if=/dev/zero of=$loopfile bs=1k count=200000
868 losetup $loopdevice $loopfile
869 mkfs -t ext3 $loopdevice 200000
870 mount -t ext3 $loopdevice $jaildir
871 mkdir $jaildir/lilyhome
872 chown $username $jaildir/lilyhome
875 mkdir -p bin usr/bin usr/share usr/lib usr/share/fonts $lilyprefix tmp
878 cp -r -L $lilydir $lilyprefix
879 cp -L /bin/sh /bin/rm bin
880 cp -L /usr/bin/convert /usr/bin/gs usr/bin
881 cp -L /usr/share/fonts/truetype usr/share/fonts
883 # la formule magique de recopie des bibliothèques
884 for i in "$lilydir/usr/bin/lilypond" "$lilydir/usr/bin/guile" "/bin/sh" \
885 "/bin/rm" "/usr/bin/gs" "/usr/bin/convert"; do ldd $i | sed 's/.*=> \
886 \/\(.*\/\)\([^(]*\).*/mkdir -p \1 \&\& cp -L \/\1\2 \1\2/' | sed \
887 's/\t\/\(.*\/\)\(.*\) (.*)$/mkdir -p \1 \&\& cp -L \/\1\2 \1\2/' \
888 | sed '/.*=>.*/d'; done | sh -s
890 # les fichiers partagés pour ghostscript...
891 cp -L -r /usr/share/ghostscript usr/share
892 # les fichiers partagés pour ImageMagick
893 cp -L -r /usr/lib/ImageMagick* usr/lib
895 ### Partant du principe que test.ly est dans /mnt/lilyloop/lilyhome,
896 ### on devrait pouvoir lancer :
897 ### Attention : /$lilyprefix/bin/lilypond est un script qui
898 ### définit LD_LIBRARY_PATH - c'est primordial
899 /$lilyprefix/bin/lilypond -jlily,lily,/mnt/lilyloop,/lilyhome test.ly
903 @node Messages d'erreur
904 @section Messages d'erreur
905 @translationof Error messages
907 @cindex erreur, messages
909 Différents messages d'erreur sont susceptibles d'apparaître au cours de
910 la compilation d'un fichier@tie{}:
914 @item Warning -- Avertissement
916 @cindex avertissement
917 Ce type de message est émis lorsque LilyPond détecte quelque chose de
918 suspect. Si vous avez demandé quelque chose qui sort de l'ordinaire,
919 vous saurez probablement ce à quoi il est fait référence et ignorerez de
920 tels messages sans remord. Néanmoins, les messages d'avertissement
921 indiquent la plupart du temps une incohérence dans le fichier source.
923 @item Error -- Erreur
925 LilyPond a détecté une erreur. L'étape en cours, qu'il s'agisse de
926 l'analyse, de l'interprétation des données ou bien du formatage, sera
927 menée à son terme, puis LilyPond s'arrêtera.
929 @item Fatal error -- Erreur fatale
931 LilyPond est confronté à une anomalie bloquante. Ceci ne se produit que
932 très rarement, et la plupart du temps en raison d'une installation
933 défectueuse des fontes.
935 @item Scheme error -- Erreur Scheme
936 @cindex trace, Scheme
939 Les erreurs qui interviennent lors de l'exécution de code Scheme sont
940 gérées par l'interpréteur Scheme. L'utilisation du mode verbeux
941 (options @option{-V} ou @option{--verbose}) vous permettra de localiser
942 l'appel de fonction délictueux.
944 @item Programming error -- Erreur de programmation
945 @cindex Programming error
946 @cindex Erreur de programmation
947 LilyPond est confronté à une incohérence interne. Ce type de message
948 est destiné à venir en aide aux développeurs et débogueurs. En règle
949 générale, vous pouvez tout simplement les ignorer. Parfois, il y en a
950 tant qu'ils masquent ce qui pourrait vous intéresser@dots{}
952 @item Aborted (core dumped) -- Abandon
953 @cindex Aborted (core dumped)
954 Ce type de message indique que LilyPond a planté en raison d'une grave
955 erreur de programmation. La survenance d'un tel message est considérée
956 comme de la plus haute importance. Si vous y étiez confronté,
957 transmettez un rapport de bogue.
960 @cindex errors, message format
961 Lorsque l'avertissement ou l'erreur est directement lié au fichier
962 source, le message est libellé sous la forme
965 @var{fichier}:@var{ligne}:@var{colonne}: @var{message}
966 @var{contenu de la ligne litigieuse}
969 Un saut de ligne est placé dans la ligne de code, indiquant l'endroit
970 précis du problème, comme ici@tie{}:
973 test.ly:2:19: erreur: n'est pas une durée: 5
978 Notez que ces coordonnées constituent l'approximation au mieux par
979 LilyPond dans le code ayant déclenché l'avertissement ou l'erreur. En
980 règle générale, erreurs et avertissements surviennent lorsque LilyPond
981 rencontre quelque chose d'inattendu. Lorsque la ligne indiquée ne vous
982 semble pas comporter d'élément litigieux, remontez de quelques lignes
985 Vous trouverez d'autres informations sur les erreurs au chapitre
986 @ref{Quelques erreurs des plus courantes}.
989 @node Quelques erreurs des plus courantes
990 @section Quelques erreurs des plus courantes
991 @translationof Common errors
993 Les conditions amenant aux erreurs qui suivent sont fréquentes, bien
994 qu'elles ne soient pas évidentes ni facilement localisables. Nous
995 espérons que ces explications vous aideront à les résoudre plus
999 * La musique déborde de la page::
1000 * Apparition d'une portée supplémentaire::
1001 * Erreur renvoyant à ../ly/init.ly::
1002 * Message d'erreur Unbound variable %::
1003 * Message d'erreur FT_Get_Glyph_Name::
1004 * staff-affinities devraient aller en ordre décroissant::
1008 @node La musique déborde de la page
1009 @unnumberedsubsec La musique déborde de la page
1010 @translationof Music runs off the page
1012 Lorsque la musique s'épanche au delà de la marge droite ou bien semble
1013 anormalement comprimée, la raison en est le plus souvent une note à la
1014 durée erronée@tie{}; cela finit par provoquer le débordement de la
1015 dernière note d'une mesure. Rien ne s'oppose à ce que la dernière note
1016 d'une mesure ne s'arrête avant la barre de mesure@tie{}; on considère
1017 simplement qu'elle se prolonge sur la mesure suivante. Des débordements
1018 à répétition finissent par générer une musique comprimée ou qui sort de
1019 la page, pour la simple et bonne raison que les sauts de ligne
1020 automatiques ne peuvent intervenir qu'à la fin d'une mesure complète,
1021 autrement dit lorsque toutes les notes sont terminées avant la fin de la
1024 @warning{Une durée erronée peut empêcher les sauts de ligne, ce qui
1025 conduit à une musique compressée, voire à un débordement de la page.}
1027 Une erreur de durée sera bien plus facilement localisable si vous
1028 positionnez régulièrement des contrôles de barre de mesure -- voir
1029 @ruser{Vérification des limites et numéros de mesure}.
1031 Si vous tenez absolument à enchaîner de tels débordements, vous devrez
1032 insérer des barres de mesure invisibles là où vous souhaitez positionner
1033 un saut de ligne. Consultez le chapitre @ruser{Barres de mesure} pour
1037 @node Apparition d'une portée supplémentaire
1038 @unnumberedsubsec Apparition d'une portée supplémentaire
1039 @translationof An extra staff appears
1041 Lorsque les contextes ne sont pas créés explicitement par la commande
1042 @code{\new}, ils le seront si la commande à exécuter n'est pas censée
1043 s'appliquer au contexte en cours. Pour des partitions simples, le fait
1044 que les contextes soient automatiquement créés rend bien des services,
1045 et c'est d'ailleurs le cas pour la majorité des exemples contenus dans
1046 les manuels de LilyPond. Cependant, la création implicite d'un contexte
1047 peut aboutir à l'apparition d'une portée @qq{parasite}. On s'attend par
1048 exemple, en lisant le code qui suit, à ce que toutes les têtes de note
1049 soient en rouge, alors que le résultat nous présente deux portées et que
1050 les notes, placées sur la portée inférieure, restent en noir.
1052 @lilypond[quote,verbatim,relative=2]
1053 \override Staff.NoteHead #'color = #red
1057 Étant donné qu'aucun contexte @code{Staff} n'existe lorsque la
1058 dérogation est introduite, LilyPond le crée implicitement pour lui
1059 appliquer la directive considérée. Survient alors la commande
1060 @w{@code{\new Staff}} qui, à son tour, crée une nouvelle portée pour
1061 contenir les notes qui suivent. Voici la syntaxe correcte pour obtenir
1062 ces notes en rouge@tie{}:
1064 @lilypond[quote,verbatim,relative=2]
1066 \override Staff.NoteHead #'color = #red
1071 Autre exemple : la présence d'une commande @code{\relative} à
1072 l'intérieur d'une section @code{\repeat} générera obligatoirement une
1073 portée intempestive. Cela tient au fait que la commande @code{\repeat}
1074 va créer deux blocs @code{\relative} qui, chacun à leur tour, créeront
1075 implicitement un bloc @code{Staff} assorti d'un bloc @code{Voice}.
1077 @lilypond[quote,verbatim]
1079 \relative c' { c4 d e f }
1083 La manière adéquate de procéder consiste à inverser les commandes
1084 @code{\repeat} et @code{\relative}, comme ceci@tie{}:
1086 @lilypond[quote,verbatim]
1089 \relative c' { c4 d e f }
1095 @node Erreur renvoyant à ../ly/init.ly
1096 @unnumberedsubsec Erreur renvoyant à @code{../ly/init.ly}
1097 @translationof Apparent error in ../ly/init.ly
1099 Certains messages d'erreur relatifs à une erreur de syntaxe dans le
1100 fichier @file{../ly/init.ly} peuvent survenir lorsque le fichier est mal
1101 formaté. Cela se produit notamment lors d'un défaut de parité de
1102 bornages ou de guillemets.
1104 L'erreur la plus courante est la simple omission d'une accolade
1105 fermante (@code{@}}) à la fin du bloc @code{Score}. La solution est
1106 évidente en pareil cas@tie{}: il suffit de vérifier que le bloc
1107 @code{Score} est bien clôturé. La structure des fichiers LilyPond est
1108 abordée plus en détails au chapitre
1109 @rlearning{Organisation des fichiers LilyPond}. C'est la raison pour
1110 laquelle nous vous invitons à utiliser un éditeur de texte qui prenne en
1111 charge le contrôle de parité des parenthèses, crochets et accolades afin
1112 de vous éviter de telles erreurs.
1114 Autre erreur courante, l'absence d'espace entre la dernière syllabe et
1115 l'accolade (@code{@}}) clôturant un bloc de paroles. Lorsqu'il n'y a
1116 pas séparation, l'accolade est considérée comme faisant partie
1117 intégrante de la syllabe. C'est la raison pour laquelle nous vous
1118 invitons à insérer une espace avant et après @strong{chaque} accolade.
1119 D'autres informations à ce sujets sont mentionnées au chapitre
1120 @ruser{Saisie des paroles}.
1122 Lorsqu'il s'agit d'un guillemet fermant (@code{"}) omis, le message
1123 d'erreur devrait vous indiquer un numéro de ligne avoisinant. L'erreur
1124 se situe la plupart du temps une ou deux lignes au-dessus de celle
1126 @c Match quote character "
1128 @node Message d'erreur Unbound variable %
1129 @unnumberedsubsec Message d'erreur Unbound variable %
1130 @translationof Error message Unbound variable %
1132 Ce message d'erreur, qu'il apparaisse sur le terminal ou en fin de
1133 fichier journal, est associé à un message du type @qq{GUILE a signalé
1134 une erreur@dots{}}. Il survient à chaque fois qu'un commentaire
1135 @emph{LilyPond} est indûment placé dans une routine @emph{Scheme}.
1137 Un commentaire LilyPond est introduit par le signe pourcent (@code{%})
1138 et ne doit en aucun cas se trouver dans une routine Scheme. En Scheme,
1139 les commentaires s'introduisent par un point-virgule (@code{;}).
1142 @node Message d'erreur FT_Get_Glyph_Name
1143 @unnumberedsubsec Message d'erreur FT_Get_Glyph_Name
1144 @translationof Error message FT_Get_Glyph_Name
1146 Ce message d'erreur, qu'il apparaisse sur le terminal ou en fin de
1147 fichier journal, survient lorsqu'un fichier source contient des
1148 caractères non ASCII et qu'il n'a pas été enregistré avec un encodage
1149 UTF-8. Pour plus de détails, reportez-vous au chapitre
1150 @ruser{Caractères spéciaux}.
1153 @node staff-affinities devraient aller en ordre décroissant
1154 @unnumberedsubsec staff-affinities devraient aller en ordre décroissant
1155 @translationof Warning staff affinities should only decrease
1157 Cet avertissement est émis lorsque la partition ne comporte pas de
1158 portée, comme par exemple une feuille de chant avec un contexte
1159 @code{ChordName} et un contexte @code{Lyrics}. Ce message disparaîtra
1160 dès lors que autoriserez l'un de ces contextes à se comporter comme une
1161 portée, à l'aide de l'instruction
1164 \override VerticalAxisGroup #'staff-affinity = ##f
1168 que vous insérerez dès sa création. Pour plus d'information,
1169 reportez-vous à la rubrique
1170 @ruser{Espacement des lignes rattachées à des portées}.