1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
4 Translation of GIT committish: c299f84d574ac9b97ab7ffbb640b5c3a1cdca5cc
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..
13 @c Translators: Jean-Charles Malahieude
14 @c Translation checkers:
16 @node Exécution de lilypond
17 @chapter Exécution de @command{lilypond}
18 @translationof Running lilyPond
20 Ce chapitre passe en revue ce qui se passe lorsque vous lancez LilyPond.
23 * Utilisation habituelle::
24 * Utilisation en ligne de commande::
26 * Quelques erreurs des plus courantes::
29 @node Utilisation habituelle
30 @section Utilisation habituelle
31 @translationof Normal usage
33 La plupart des utilisateurs de LilyPond le font au travers d'une
34 interface graphique (@emph{GUI} pour @emph{graphical user interface}).
35 Si vous ne l'avez pas encore parcouru, lisez le @rlearning{Tutoriel}.
36 Si vous utilisez un éditeur alternatif pour rédiger vos fichiers
37 LilyPond, référez-vous à la documentation de celui-ci.
40 @node Utilisation en ligne de commande
41 @section Utilisation en ligne de commande
42 @translationof Command-line usage
44 Nous nous intéresserons ici aux spécificités de LilyPond employé en
45 ligne de commande. La ligne de commande permet de faire appel à
46 certaines options particulières. D'autre part, certains utilitaires
47 associés, tel que @code{midi2ly}, ne sont disponibles qu'en ligne de
50 Par @qq{ligne de commande}, nous entendons l'interface de commande du
51 système. Les utilisateurs de Windows seront certainement plus familiers
52 des termes @qq{fenêtre DOS} ou @qq{invite de commande}. Quant aux
53 utilisateurs de MacOS@tie{}X, ils connaissent assurément les termes
54 @qq{console} et @qq{terminal}. Les paramétrages spécifiques au système
55 MacOS font l'objet d'un @rwebnamed{MacOS X,chapitre particulier}.
57 Notre propos n'est pas ici d'expliquer ce qu'est l'interface de
58 commande pour un système informatique ni comment elle fonctionne.
59 Aussi, si vous ne savez de quoi il retourne, nous vous renvoyons aux
60 nombreuses documentations que vous pourrez trouver sur ce sujet.
64 * Lancement de lilypond::
65 * Options en ligne de commande pour 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 en ligne de commande pour lilypond
140 @unnumberedsubsec Options en ligne de commande pour @command{lilypond}
141 @translationof 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 Voici les différentes options disponibles à la ligne de commande@tie{}:
153 @item -d,--define-default=@var{var}=@var{val}
154 Affecte la valeur Scheme @var{val} à l'option interne @var{var} du
155 programme. En l'absence de @var{val}, le programme utilisera @var{#t}.
156 Préfixer @var{var} d'un @code{no-} vous permet de désactiver une option.
159 @cindex point and click, ligne de commande
160 @cindex pointer-cliquer, ligne de commande
172 Voici les options disponibles@tie{}:
174 @cindex help, ligne de commande
179 Lancer @code{lilypond -dhelp} affichera la liste de toutes les options
180 @code{-d} disponibles.
183 @cindex paper-size, ligne de commande
185 Détermine la taille par défaut du papier, par exemple
187 -dpaper-size=\"letter\"
191 Veillez à ne pas oublier d'encadrer la valeur par des guillemets
192 échappés ( @code{\"} ).
193 @c Match " in previous line to help context-sensitive editors
196 @cindex safe, ligne de commande
198 Ne pas avoir une confiance aveugle dans le code @file{.ly}.
200 Lorsque LilyPond est accessible au travers d'un serveur web, il est
201 @strong{impératif} d'utiliser les options @option{--safe} ou
202 @option{--jail}. L'option @option{--safe} aura pour effet d'empêcher
203 tout code Scheme inclus de mettre en péril votre installation grâce à
204 quelque chose du style
210 c4^$(ly:gulp-file "/etc/passwd")
215 L'option @code{-dsafe} forcera l'évaluation, au fil de l'eau et par un
216 module sécurisé, des expressions Scheme contenues dans le fichier
217 source. Ce module sécuritaire, dérivé du module GUILE @file{safe-r5rs},
218 ajoute un certain nombre de fonctions -- listées dans
219 @file{scm/safe-lily.scm} -- à l'API de LilyPond.
221 De plus, le mode @emph{safe} ne permet ni l'utilisation de directives
222 @code{\include} ni le recours aux obliques inversées (@emph{backslash})
223 dans les chaînes @TeX{}.
225 L'import de variables LilyPond dans du code Scheme n'est pas possible
228 L'option @code{-dsafe} @strong{ne détecte pas} l'utilisation abusive des
229 ressources. Il est donc possible que le programme finisse par rester
230 sans réponse si on lui envoie une boucle sans fin. C'est la raison pour
231 laquelle nous recommandons, lorsque LilyPond tourne sur un serveur
232 accessible au public, d'en limiter aussi bien les ressources processeur
235 Notez bien que l'utilisation du mode sécuritaire empêchera aussi la
236 compilation d'un certain nombre de fragments LilyPond. L'option
237 @code{--jail} est dans ce cas une excellente alternative en terme de
238 sécurité, même si elle requiert plus de temps à mettre en place.
241 @cindex format de sortie, définition
243 Détermine le format de sortie à utiliser par le moteur de traitement.
244 Les types de @code{format} reconnus sont
249 @cindex PostScript output
252 Les fichiers PostScript incluent les polices TTF, Type1 et OTF, et
253 aucune substitution ne sera opérée pour ces fontes. Si vous utilisez
254 des caractères orientaux, le fichier aura vite fait d'atteindre une
259 @cindex Postscript encapsulé
260 @cindex EPS (Encapsulated PostScript)
261 pour du PostScript encapsulé.
263 Chaque page (système) fera l'objet d'un fichier @file{EPS} particulier,
264 sans fontes, auquel sera associé un fichier @file{EPS} qui, lui,
265 contiendra toutes les pages (systèmes) et les fontes.
267 Notez qu'il s'agit du mode que @command{lilypond-book} utilise par défaut.
270 @cindex SVG (Scalable Vector Graphics)
271 pour du SVG (@emph{Scalable Vector Graphics}).
273 Cette option permet de créer un fichier SVG par page, sans incorporation
274 des fontes. Nous vous recommandons d'installer les fontes Century
275 Schoolbook comprises dans le paquetage LilyPond afin d'obtenir le
276 meilleur rendu possible. Sous UNIX, il suffit de les recopier, à partir
277 du répertoire @file{/usr/share/lilypond/VERSION/fonts/otf/}, dans
278 @file{~/.fonts/}. Les fichiers SVG alors générés devraient être
279 lisibles par votre éditeur SVG habituel.
283 pour une recopie brute des commandes Scheme internes de formatage.
286 permet de ne pas générer de partition imprimable. Cette option est
287 équivalente à @code{-dno-print-pages}.
291 Exemple : @code{lilypond -dbackend=svg @var{monfichier}.ly}
295 @cindex preview, ligne de commande
296 Génère un fichier comprenant le titrage et le premier système. S'il
297 existe plusieurs sections @code{\bookpart}, ce fichier contiendra les
298 titrage et premier système de chacun des @code{\bookpart}. Cette
299 option fonctionne pour les moteurs de traitement @code{ps}, @code{eps}
302 Sera automatiquement généré un fichier additionnel, de la forme
303 @file{monFichier.preview.extension}. Pour l'éviter, utilisez
304 conjointement l'une des options @option{-dprint-pages} ou
305 @option{-dno-print-pages} selon vos besoins.
308 Travaille silencieusement, et redirige tout le verbiage dans un fichier
311 Note à l'attention des utilisateurs de Windows@tie{}: toutes les
312 informations concernant le traitement apparaissent au fur et à mesure
313 dans l'interpréteur de commandes lorsque vous lancez le programme
314 @code{lilypond.exe}, à l'inverse de @w{@code{lilypond-windows.exe}} qui
315 vous renvoie simplement la main. L'option @option{-dgui} vous permettra
316 alors de rediriger ces informations dans un fichier journal.
319 Génère l'intégralité des pages de la partition. L'option
320 @option{-dno-print-pages} est particulièrement utile lorsqu'utilisée
321 conjointement avec l'option @option{-dpreview}.
326 @cindex Scheme, évaluation d'expression
327 @cindex expression Scheme, évaluation
328 @item -e,--evaluate=@var{expr}
329 Évalue l'expression Scheme @var{expr} avant d'analyser tout fichier
330 @file{.ly}. Lorsque vous spécifiez l'option @option{-e} à plusieurs
331 reprises, l'évaluation sera faite en séquence.
333 Dans la mesure où l'expression est évaluée par le module
334 @code{guile-user}, vous devrez, dès lors que @var{expr} utilise des
335 définitions, spécifier
338 lilypond -e '(define-public a 42)'
342 en ligne de commande, et ajouter la ligne
345 #(use-modules (guile-user))
349 en tête de votre fichier @file{.ly}.
351 @warning{Les utilisateurs de Windows doivent utiliser des quillements
352 doubles @code{"} en lieu et place des guillemets simples @code{'}.}
353 @c Match " in previous line to help context-sensitive editors
356 @cindex sortie, format
357 @cindex format de sortie
358 @item -f,--format=@var{format}
359 Détermine le format à produire. Il peut s'agir de @code{ps}, @code{pdf}
362 Exemple : @code{lilypond -fpng @var{monfichier}.ly}
366 Affiche un résumé des commandes.
369 @item -H,--header=@var{CHAMP}
370 Recopie le champ d'entête dans le fichier @file{RACINE.@var{CHAMP}}.
373 @item -i,--init=@var{fichier}
374 Définit @var{fichier} (par défaut @file{init.ly}) en tant que fichier
378 @cindex recherche de fichier
379 @cindex chemin de recherche
380 @item -I,--include=@var{répertoire}
382 Ajoute @var{répertoire} au chemin de recherche pour les inclusions.
384 Vous pouvez mentionner plusieurs fois l'option @option{-I}, auquel cas
385 la recherche commencera dans le premier répertoire inclus et, si le
386 fichier en question ne s'y trouve pas, les répertoires suivants seront
387 examinés l'un après l'autre.
390 @cindex chroot jail, fonctionnement
391 @item -j,--jail=@var{user},@var{group},@var{jail},@var{dir}
392 Lance @command{lilypond} dans un environnement protégé.
394 L'option @option{--jail} est une alternative qui offre plus de
395 flexibilité que l'option @option{--safe} lorsque LilyPond est installé
396 sur un serveur web ou traite des fichiers externes.
398 L'option @option{--jail} va détourner la racine de @command{lilypond}
399 sur @var{jail} juste avant d'effectuer la compilation à proprement
400 parler. L'utilisateur et le groupe sont modifiés en conséquence, et le
401 répertoire en cours devient @var{dir}. Ces réglages assurent -- du
402 moins en théorie -- l'impossibilité de s'échapper de la cellule. Notez
403 cependant que, pour que l'option @option{--jail} soit fonctionnelle,
404 @command{lilypond} doit être lancé en tant qu'administrateur -- ce qui
405 se réalise aisément à l'aide de la commande @command{sudo}.
407 La création d'un environnement sécurisé requiert quelques précautions
408 dans la mesure où LilyPond doit disposer de tout ce dont il a besoin
409 pour compiler le fichier source @strong{à l'intérieur de la cellule}.
410 L'ermitage, avant d'être viable, requiert donc les étapes
415 @item Création d'un système de fichiers indépendant
416 L'intérêt d'un système de fichiers dédié à LilyPond réside dans le fait
417 qu'on peut le brider à l'aide des options @code{noexec},@code{nodev} et
418 @code{nosuid}. Il sera de fait impossible de lancer des exécutables ou
419 d'écrire sur un périphérique à partir de LilyPond. Si vous n'avez pas
420 l'intention de créer un tel système sur une partition séparée, vous
421 pouvez avoir recours à un pseudo-périphérique (@emph{loop device}) monté
422 à partir d'un simple fichier de taille raisonnable. D'autre part, le
423 recours à un système de fichiers indépendant permet de limiter l'espace
426 @item Création d'un utilisateur spécifique
427 L'utilisation de LilyPond au sein de la cellule devrait être réservé à
428 un utilisateur aux droits restreints. Il faudra donc créer un
429 utilisateur et un groupe spécifiques -- disons
430 @w{@code{lily}/@code{lily}} -- qui n'aura accès en écriture qu'à un
431 unique répertoire déterminé par la valeur de @var{dir}.
433 @item Agencement des lieux
434 LilyPond a besoin d'un certain nombre de fichiers pour pouvoir tourner
435 correctement. Ces fichiers devront donc tous se retrouver dans
436 l'environnement protégé, distribués selon la même arborescence que dans
437 le système d'origine. Ainsi l'intégralité de l'installation de LilyPond
438 (en principe @file{/usr/share/lilypond}) doit y être dupliquée.
440 En cas de problème, lancer LilyPond en utilisant @command{strace}
441 devrait vous permettre de déterminer quels fichiers manquent à l'appel.
443 @item Lancement de LilyPond
444 Dans un environnement protégé monté avec l'option @code{noexec}, il
445 est impossible de lancer un quelconque programme extérieur. LilyPond ne
446 saurait donc avoir recours à un moteur de traitement qui le mettrait
447 dans cette situation. Comme nous l'avons vu plus haut, LilyPond sera
448 lancé avec les privilèges de l'administrateur -- privilèges qu'il perdra
449 aussitôt --, ce qui peut nécessiter le recours à la commande
450 @code{sudo}. Il est par ailleurs judicieux de limiter le temps
451 processeur aloué à LilyPond -- grâce à @command{ulimit@tie{}-t} par
452 exemple -- ainsi que, si votre système le permet, la taille de la
458 @cindex verbosité, définir le degré de
459 @item -l,--loglevel=@var{DEGRÉ}
460 Règle le niveau de verbosité des messages console à @var{DEGRÉ}. Les
461 différentes valeurs sont@tie{}:
465 Aucun verbiage, même pas les messages d'erreur.
468 Uniquement les messages d'erreur@tie{}; pas de message d'avertissement
472 Messages d'avertissement ou d'erreur@tie{}; pas d'information de
476 Information de progression basique (réussite) et avertissements ou erreurs.
479 Toutes les informations de progression, avertissements et erreurs.
481 @item INFO (par défaut)
482 Informations de progression, avertissements et erreurs, ainsi que
483 d'autres informations quant à l'exécution.
486 Tout ce qui peut être affiché, y compris le verbiage utile au débogage.
491 @cindex répertoire de destination
492 @cindex fichier de destination
493 @item -o,--output=@var{FICHIER} ou @var{RÉPERTOIRE}
494 Détermine le nom par défaut du fichier résultant à @var{FICHIER}@tie{};
495 lorsque l'argument @var{RÉPERTOIRE} correspond à un répertoire déjà
496 existant, c'est là que les fichiers résultants seront déposés. Le
497 suffixe adéquat sera ajouté (p.ex. @file{.pdf} pour du pdf) dans tous
501 @cindex PostScript, output
502 @cindex PS (PostScript), output
504 Génère du PostScript.
508 @cindex Portable Network Graphics (PNG), output
509 @cindex PNG (Portable Network Graphics), output
510 Génère une image par page, au format PNG@tie{}; ceci sous-entend
511 l'utilisation de @option{--ps}. La résolution de l'image, en DPI, peut
512 se régler en ajoutant par exemple
519 @cindex Portable Document Format (PDF), output
520 @cindex PDF (Portable Document Format), output
521 Génère du PDF. Ceci sous-entend l'utilisation de @option{--ps}.
525 Affiche le numéro de version.
529 Active le mode verbeux@tie{}: affichage de l'intégralité du chemin
530 d'accès de chaque fichier, et information des temps de traitement.
534 Affiche les informations de garantie appliquables à GNU LilyPond -- il
535 est livré @strong{SANS GARANTIE}@tie{}!
539 @node Variables d'environnement
540 @unnumberedsubsec Variables d'environnement
541 @translationof Environment variables
544 @cindex LILYPOND_DATADIR
546 @command{lilypond} reconnaît les variables d'environnement
550 @item LILYPOND_DATADIR
551 Cette variable spécifie le répertoire où seront recherchés par défaut
552 les différentes versions des messages ainsi qu'un certain nombre de
553 fichiers nécessaires au traitement. Il devrait contenir les
554 sous-répertoires @file{ly/}, @file{ps/}, @file{tex/}, etc.
557 Cette variable détermine la langue dans laquelle seront émis les
560 @item LILYPOND_LOGLEVEL
561 Cette variable détermine le niveau par défaut de verbosité. En
562 l'absence de niveau explicite -- autrement dit la ligne de commande ne
563 comporte pas de @option{--loglevel} -- c'est cette valeur qui sera
566 @item LILYPOND_GC_YIELD
567 Cette variable permet d'ajuster l'empreinte mémoire et le rendement de
568 la machine. Il s'agit en fait d'un pourcentage d'allocation de
569 mémoire@tie{}: lorsqu'il est élevé, le programme favorisera
570 l'utilisation de la mémoire@tie{}; une faible valeur consommera plus de
571 temps processeur. Par défaut, cette valeur est fixée à@tie{}@code{70}.
576 @node Exécution de LilyPond en mode protégé
577 @unnumberedsubsec Exécution de LilyPond en mode protégé
578 @translationof LilyPond in chroot jail
580 Paramétrer un serveur afin qu'il puisse faire fonctionner LilyPond en
581 mode protégé sur un pseudo-périphérique est une tâche sensible. Les
582 différentes étapes à suivre sont répertoriées ci-dessous. Les exemples
583 qu'elle comportent proviennent d'une distribution Linux Ubuntu et
584 nécessiteront l'utilisation de @code{sudo} autant que de besoin.
588 @item Installation des paquetages nécessaires@tie{}: LilyPond, GhostScript et
591 @item Création de l'utilisateur @code{lily} :
598 Ceci, par la même occasion, créera un groupe spécifique pour
599 l'utilisateur @code{lily} ainsi que son répertoire personnel
602 @item Création, dans le répertoire personnel de l'utilisateur
603 @code{lily}, d'un espace agissant en tant que système de fichiers@tie{}:
606 dd if=/dev/zero of=/home/lily/loopfile bs=1k count= 200000
610 Cette commande a créé un fichier de 200@tie{}MB utilisable par le
611 @qq{système protégé}.
613 @item Création d'un pseudo-périphérique, génération d'un système de
614 fichiers et chargement de celui-ci, puis création d'un répertoire
615 accessible en écriture pour l'utilisateur @code{lily}@tie{}:
619 losetup /dev/loop0 /home/lily/loopfile
620 mkfs -t ext3 /dev/loop0 200000
621 mount -t ext3 /dev/loop0 /mnt/lilyloop
622 mkdir /mnt/lilyloop/lilyhome
623 chown lily /mnt/lilyloop/lilyhome
626 @item Affectation, au niveau configuration du serveur, de
627 @code{/mnt/lilyloop} en tant que JAIL et @code{/lilyhome} en tant que
630 @item Création d'une arborescence, dans l'espace protégé, et recopie de
631 tous les fichiers nécessaires -- voir le script plus loin.
633 Le recours à l'utilitaire @code{sed} permet de créer les commandes de
634 copie de tout ce qui est nécessaire à un exécutable@tie{}:
637 for i in "/usr/local/lilypond/usr/bin/lilypond" "/bin/sh" "/usr/bin/; \
638 do ldd $i | sed 's/.*=> \/\(.*\/\)\([^(]*\).*/mkdir -p \1 \&\& \
639 cp -L \/\1\2 \1\2/' | sed 's/\t\/\(.*\/\)\(.*\) (.*)$/mkdir -p \
640 \1 \&\& cp -L \/\1\2 \1\2/' | sed '/.*=>.*/d'; done
645 @subheading Exemple de script fonctionnel en 32-bit sur Ubuntu 8.04
649 ## les réglages par défaut
653 loopdevice=/dev/loop0
654 jaildir=/mnt/lilyloop
655 # le préfixe (sans slash au début !)
657 # le répertoire du système où lilypond est installé
658 lilydir=/$lilyprefix/lilypond/
660 userhome=$home/$username
661 loopfile=$userhome/loopfile
663 dd if=/dev/zero of=$loopfile bs=1k count=200000
665 losetup $loopdevice $loopfile
666 mkfs -t ext3 $loopdevice 200000
667 mount -t ext3 $loopdevice $jaildir
668 mkdir $jaildir/lilyhome
669 chown $username $jaildir/lilyhome
672 mkdir -p bin usr/bin usr/share usr/lib usr/share/fonts $lilyprefix tmp
675 cp -r -L $lilydir $lilyprefix
676 cp -L /bin/sh /bin/rm bin
677 cp -L /usr/bin/convert /usr/bin/gs usr/bin
678 cp -L /usr/share/fonts/truetype usr/share/fonts
680 # la formule magique de recopie des biblothèques
681 for i in "$lilydir/usr/bin/lilypond" "$lilydir/usr/bin/guile" "/bin/sh" \
682 "/bin/rm" "/usr/bin/gs" "/usr/bin/convert"; do ldd $i | sed 's/.*=> \
683 \/\(.*\/\)\([^(]*\).*/mkdir -p \1 \&\& cp -L \/\1\2 \1\2/' | sed \
684 's/\t\/\(.*\/\)\(.*\) (.*)$/mkdir -p \1 \&\& cp -L \/\1\2 \1\2/' \
685 | sed '/.*=>.*/d'; done | sh -s
687 # les fichiers partagés pour ghostscript...
688 cp -L -r /usr/share/ghostscript usr/share
689 # les fichiers partagés pour ImageMagick
690 cp -L -r /usr/lib/ImageMagick* usr/lib
692 ### Partant du principe que test.ly est dans /mnt/lilyloop/lilyhome,
693 ### on devrait pouvoir lancer :
694 ### Attention : /$lilyprefix/bin/lilypond est un script qui
695 ### définit LD_LIBRARY_PATH - c'est primordial
696 /$lilyprefix/bin/lilypond -jlily,lily,/mnt/lilyloop,/lilyhome test.ly
700 @node Messages d'erreur
701 @section Messages d'erreur
702 @translationof Error messages
704 @cindex erreur, messages
706 Différents messages d'erreur sont susceptibles d'apparaître au cours de
707 la compilation d'un fichier@tie{}:
711 @item Warning -- Avertissement
713 @cindex avertissement
714 Ce type de message est émis lorsque LilyPond détecte quelque chose de
715 suspect. Si vous avez demandé quelque chose qui sort de l'ordinaire,
716 vous saurez probablement ce à quoi il est fait référence et ignorerez de
717 tels messages sans remord. Néanmoins, les messages d'avertissement
718 indiquent la plupart du temps une incohérence dans le fichier source.
720 @item Error -- Erreur
722 LilyPond a détecté une erreur. L'étape en cours, qu'il s'agisse de
723 l'analyse, de l'interprétation des données ou bien du formatage, sera
724 menée à son terme, puis LilyPond s'arrêtera.
726 @item Fatal error -- Erreur fatale
728 LilyPond est confronté à une anomalie bloquante. Ceci ne se produit que
729 très rarement, et la plupart du temps en raison d'une installation
730 défectueuse des fontes.
732 @item Scheme error -- Erreur Scheme
733 @cindex trace, Scheme
736 Les erreurs qui interviennent lors de l'exécution de code Scheme sont
737 gérées par l'interpréteur Scheme. L'utilisation du mode verbeux
738 (options @option{-V} ou @option{--verbose}) vous permettra de localiser
739 l'appel de fonction délictueux.
741 @item Programming error -- Erreur de programmation
742 @cindex Programming error
743 @cindex Erreur de programmation
744 LilyPond est confronté à une incohérence interne. Ce type de message
745 est destiné à venir en aide aux développeurs et débogueurs. En règle
746 générale, vous pouvez tout simplement les ignorer. Parfois, il y en a
747 tant qu'ils masquent ce qui pourrait vous intéresser@dots{}
749 @item Aborted (core dumped) -- Abandon
750 @cindex Aborted (core dumped)
751 Ce type de message indique que LilyPond a planté en raison d'une grave
752 erreur de programmation. La survenance d'un tel message est considérée
753 comme de la plus haute importance. Si vous y étiez confronté,
754 transmettez un rapport de bogue.
757 @cindex errors, message format
758 Lorsque l'avertissement ou l'erreur est directement lié au fichier
759 source, le message est libellé sous la forme
762 @var{fichier}:@var{ligne}:@var{colonne}: @var{message}
763 @var{contenu de la ligne litigieuse}
766 Un saut de ligne est placé dans la ligne de code, indiquant l'endroit
767 précis du problème, comme ici@tie{}:
770 test.ly:2:19: erreur: n'est pas une durée: 5
775 Notez que ces coordonnées constituent l'approximation au mieux par
776 LilyPond dans le code ayant déclenché l'avertissement ou l'erreur. En
777 règle générale, erreurs et avertissements surviennent lorsque LilyPond
778 rencontre quelque chose d'inattendu. Lorsque la ligne indiquée ne vous
779 semble pas comporter d'élément litigieux, remontez de quelques lignes
782 Vous trouverez d'autres informations sur les erreurs au chapitre
783 @ref{Quelques erreurs des plus courantes}.
786 @node Quelques erreurs des plus courantes
787 @section Quelques erreurs des plus courantes
788 @translationof Common errors
790 Les conditions amenant aux erreurs qui suivent sont fréquentes, bien
791 qu'elles ne soient pas évidentes ni facilement localisables. Nous
792 espérons que ces explications vous aideront à les résoudre plus
796 * La musique déborde de la page::
797 * Apparition d'une portée supplémentaire::
798 * Erreur renvoyant à ../ly/init.ly::
799 * Message d'erreur Unbound variable %::
800 * Message d'erreur FT_Get_Glyph_Name::
801 * staff-affinities devraient aller en ordre décroissant::
805 @node La musique déborde de la page
806 @unnumberedsubsec La musique déborde de la page
807 @translationof Music runs off the page
809 Lorsque la musique s'épanche au delà de la marge droite ou bien semble
810 anormalement comprimée, la raison en est le plus souvent une note à la
811 durée erronée@tie{}; cela finit par provoquer le débordement de la
812 dernière note d'une mesure. Rien ne s'oppose à ce que la dernière note
813 d'une mesure ne s'arrête avant la barre de mesure@tie{}; on considère
814 simplement qu'elle se prolonge sur la mesure suivante. Des débordements
815 à répétition finissent par générer une musique comprimée ou qui sort de
816 la page, pour la simple et bonne raison que les sauts de ligne
817 automatiques ne peuvent intervenir qu'à la fin d'une mesure complète,
818 autrement dit lorsque toutes les notes sont terminées avant la fin de la
821 @warning{Une durée erronée peut empêcher les sauts de ligne, ce qui
822 conduit à une musique compressée, voire à un débordement de la page.}
824 Une erreur de durée sera bien plus facilement localisable si vous
825 positionnez régulièrement des contrôles de barre de mesure -- voir
826 @ruser{Vérification des limites et numéros de mesure}.
828 Si vous tenez absolument à enchainer de tels débordements, vous devrez
829 insérer des barres de mesure invisibles là où vous souhaitez positionner
830 un saut de ligne. Consultez le chapitre @ruser{Barres de mesure} pour
834 @node Apparition d'une portée supplémentaire
835 @unnumberedsubsec Apparition d'une portée supplémentaire
836 @translationof An extra staff appears
838 Lorsque les contextes ne sont pas créés explicitement par la commande
839 @code{\new}, ils le seront si la commande à exécuter n'est pas censée
840 s'appliquer au contexte en cours. Pour des partitions simples, le fait
841 que les contextes soient automatiquement créés rend bien des services,
842 et c'est d'ailleurs le cas pour la majorité des exemples contenus dans
843 les manuels de LilyPond. Cependant, la création implicite d'un contexte
844 peut aboutir à l'apparition d'une portée @qq{parasite}. On s'attend par
845 exemple, en lisant le code qui suit, à ce que toutes les têtes de note
846 soient en rouge, alors que le résultat nous présente deux portées et que
847 les notes, placées sur la portée inférieure, restent en noir.
849 @lilypond[quote,verbatim,relative=2]
850 \override Staff.NoteHead #'color = #red
854 Étant donné qu'aucun contexte @code{Staff} n'existe lorsque la
855 dérogation est introduite, LilyPond le crée implicitement pour lui
856 appliquer la directive considérée. Survient alors la commande
857 @w{@code{\new Staff}} qui, à son tour, crée une nouvelle portée pour
858 contenir les notes qui suivent. Voici la syntaxe correcte pour obtenir
859 ces notes en rouge@tie{}:
861 @lilypond[quote,verbatim,relative=2]
863 \override Staff.NoteHead #'color = #red
868 Autre exemple : la présence d'une commande @code{\relative} à
869 l'intérieur d'une section @code{\repeat} génèrera obligatoirement une
870 portée intempestive. Cela tient au fait que la commande @code{\repeat}
871 va créer deux blocs @code{\relative} qui, chacun à leur tour, créeront
872 implicitement un bloc @code{Staff} assorti d'un bloc @code{Voice}.
874 @lilypond[quote,verbatim]
876 \relative c' { c4 d e f }
880 La manière adéquate de procéder consiste à inverser les commandes
881 @code{\repeat} et @code{\relative}, comme ceci@tie{}:
883 @lilypond[quote,verbatim]
886 \relative c' { c4 d e f }
892 @node Erreur renvoyant à ../ly/init.ly
893 @unnumberedsubsec Erreur renvoyant à @code{../ly/init.ly}
894 @translationof Apparent error in ../ly/init.ly
896 Certains messages d'erreur relatifs à une erreur de syntaxe dans le
897 fichier @file{../ly/init.ly} peuvent survenir lorsque le fichier est mal
898 formaté. Cela se produit notamment lors d'un défaut de parité de
899 bornages ou de guillemets.
901 L'erreur la plus courante est la simple omission d'une accolade
902 fermante (@code{@}}) à la fin du bloc @code{Score}. La solution est
903 évidente en pareil cas@tie{}: il suffit de vérifier que le bloc
904 @code{Score} est bien clôturé. La structure des fichiers LilyPond est
905 abordée plus en détails au chapitre
906 @rlearning{Organisation des fichiers LilyPond}. C'est la raison pour
907 laquelle nous vous invitons à utiliser un éditeur de texte qui prenne en
908 charge le contrôle de parité des parenthèses, crochets et accolades afin
909 de vous éviter de telles erreurs.
911 Autre erreur courante, l'absence d'espace entre la dernière syllabe et
912 l'accolade (@code{@}}) clôturant un bloc de paroles. Lorsqu'il n'y a
913 pas séparation, l'accolade est considérée comme faisant partie
914 intégrante de la syllabe. C'est la raison pour laquelle nous vous
915 invitons à insérer une espace avant et après @strong{chaque} accolade.
916 D'autres informations à ce sujets sont mentionnées au chapitre
917 @ruser{Saisie des paroles}.
919 Lorsqu'il s'agit d'un guillemet fermant (@code{"}) omis, le message
920 d'erreur devrait vous indiquer un numéro de ligne avoisinant. L'erreur
921 se situe la plupart du temps une ou deux lignes au-dessus de celle
923 @c Match quote character "
925 @node Message d'erreur Unbound variable %
926 @unnumberedsubsec Message d'erreur Unbound variable %
927 @translationof Error message Unbound variable %
929 Ce message d'erreur, qu'il apparaisse sur le terminal ou en fin de
930 fichier journal, est associé à un message du type @qq{GUILE a signalé
931 une erreur@dots{}}. Il survient à chaque fois qu'un commentaire
932 @emph{LilyPond} est indûment placé dans une routine @emph{Scheme}.
934 Un commentaire LilyPond est introduit par le signe pourcent (@code{%})
935 et ne doit en aucun cas se trouver dans une routine Scheme. En Scheme,
936 les commentaires s'introduisent par un point-virgule (@code{;}).
939 @node Message d'erreur FT_Get_Glyph_Name
940 @unnumberedsubsec Message d'erreur FT_Get_Glyph_Name
941 @translationof Error message FT_Get_Glyph_Name
943 Ce message d'erreur, qu'il apparaisse sur le terminal ou en fin de
944 fichier journal, survient lorsqu'un fichier source contient des
945 caractères non ASCII et qu'il n'a pas été enregistré avec un encodage
946 UTF-8. Pour plus de détails, reportez-vous au chapitre
947 @ruser{Caractères spéciaux}.
950 @node staff-affinities devraient aller en ordre décroissant
951 @unnumberedsubsec staff-affinities devraient aller en ordre décroissant
952 @translationof Warning staff affinities should only decrease
954 Cet avertissement est émis lorsque la partition ne comporte pas de
955 portée, comme par exemple une feuille de chant avec un contexte
956 @code{ChordName} et un contexte @code{Lyrics}. Ce message disparaîtra
957 dès lors que autoriserez l'un de ces contextes à se comporter comme une
958 portée, à l'aide de l'instruction
961 \override VerticalAxisGroup #'staff-affinity = ##f
965 que vous insérerez dès sa création. Pour plus d'information,
966 reportez-vous à la rubrique
967 @ruser{Espacement des lignes rattachées à des portées}.