1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
4 Translation of GIT committish: 0bc0ff1a281477487016b052eb699ebbd685d3e0
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, tels 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 sont abordés au chapitre @rweb{MacOS X}.
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::
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 @code{.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
113 Si votre interpréteur -- terminal, console, etc. -- prend en charge les
114 redirections, les commandes qui suivent vous permettront de
115 judicieusement rediriger les affichages de la console dans un
121 @code{lilypond fichier.ly 1>stdout.log} pour le verbiage normal
124 @code{lilypond fichier.ly 2>stderr.log} pour les messages d'erreur
127 @code{lilypond fichier.ly &>tous.log} pour garder une trace de tout ce
132 Consultez avant tout la documentation de votre interpréteur habituel
133 pour vérifier qu'il prend en charge ces options dans cette syntaxe.
134 Notez bien qu'il s'agit ici de commandes internes à l'interpréteur et
135 qui n'ont rien à voir avec LilyPond.
138 @node Options en ligne de commande
139 @unnumberedsubsec Options en ligne de commande pour @command{lilypond}
140 @translationof Command line options
142 @cindex lancement de @command{lilypond}
143 @cindex ligne de commande, options pour @command{lilypond}
144 @cindex options, ligne de commande
148 Voici les différentes options disponibles à la ligne de commande@tie{}:
152 @item -e,--evaluate=@var{expr}
153 Évalue l'expression Scheme @var{expr} avant d'analyser tout fichier
154 @file{.ly}. Lorsque vous spécifiez l'option @code{-e} à plusieurs
155 reprises, l'évaluation sera faite en séquence.
157 Dans la mesure où l'expression est évaluée par le module
158 @code{guile-user}, vous devrez, dès lors que @var{expr} utilise des
159 définitions, spécifier
162 lilypond -e '(define-public a 42)'
166 en ligne de commande, et ajouter la ligne
169 #(use-modules (guile-user))
173 en tête de votre fichier @code{.ly}.
176 @item -f,--format=@var{format}
177 Détermine le format à produire. Il peut s'agir de @code{ps}, @code{pdf}
180 Exemple : @code{lilypond -fpng @var{monfichier}.ly}
183 @item -d,--define-default=@var{var}=@var{val}
184 Affecte la valeur Scheme @var{val} à l'option interne @var{var} du
185 programme. En l'absence de @var{val}, le programme utilisera @var{#t}.
186 Préfixer @var{var} d'un @code{no-} vous permet de désactiver une option.
189 @cindex point and click, ligne de commande
198 -dpoint-and-click='#f'
202 Voici quelques options des plus intéressantes.
204 @cindex help, ligne de commande
208 Lancer @code{lilypond -dhelp} affichera la liste de toutes les options
209 @code{-d} disponibles.
212 @cindex paper-size, ligne de commande
215 Détermine la taille par défaut du papier, par exemple
217 -dpaper-size=\"letter\"
221 Veillez à ne pas oublier d'encadrer la valeur par des guillemets
222 échappés ( @code{\"} ).
223 @c Match " in previous line to help context-sensitive editors
226 @cindex safe, ligne de commande
229 Ne pas avoir une confiance aveugle dans le code @code{.ly}.
231 Lorsque LilyPond est accessible au travers d'un serveur web, il est
232 @strong{impératif} d'utiliser les options @code{--safe} ou
233 @code{--jail}. L'option @code{--safe} aura pour effet d'empêcher tout
234 code Scheme inclus de mettre en péril votre installation grâce à quelque
241 c4^#(ly:export (ly:gulp-file "/etc/passwd"))
246 L'option @code{-dsafe} forcera l'évaluation, au fil de l'eau et par un
247 module sécurisé, des expressions Scheme contenues dans le fichier
248 source. Ce module sécuritaire, dérivé du module GUILE @file{safe-r5rs},
249 ajoute un certain nombre de fonctions -- listées dans
250 @file{scm/@/safe@/-lily@/.scm} -- à l'API de LilyPond.
252 De plus, le mode @emph{safe} ne permet ni l'utilisation de directives
253 @code{\include} ni le recours aux obliques inversées (@emph{backslash})
254 dans les chaînes @TeX{}.
256 L'import de variables LilyPond dans du code Scheme n'est pas possible
259 L'option @code{-dsafe} @strong{ne détecte pas} l'utilisation abusive des
260 ressources. Il est donc possible que le programme finisse par rester
261 sans réponse si on lui envoie une boucle sans fin. C'est la raison pour
262 laquelle nous recommandons, lorsque LilyPond tourne sur un serveur
263 accessible au public, d'en limiter aussi bien les ressources processeur
266 Notez bien que l'utilisation du mode sécuritaire empêchera aussi la
267 compilation d'un certain nombre de fragments LilyPond. L'option
268 @code{--jail} est dans ce cas une excellente alternative en terme de
269 sécurité, même si elle requiert plus de temps à mettre en place.
272 @cindex format de sortie, définition
275 Détermine le format de sortie à utiliser par le moteur de traitement.
276 Les types de @code{format} reconnus sont
279 @cindex PostScript output
282 Les fichiers PostScript incluent les polices TTF, Type1 et OTF, et
283 aucune substitution ne sera opérée pour ces fontes. Si vous utilisez
284 des caractères orientaux, le fichier aura vite fait d'atteindre une
289 @cindex Postscript encapsulé
290 @cindex EPS (Encapsulated PostScript)
291 pour du PostScript encapsulé.
293 Chaque page (système) fera l'objet d'un fichier @file{EPS} particulier,
294 sans fontes, auquel sera associé un fichier @file{EPS} qui, lui,
295 contiendra toutes les pages (systèmes) et les fontes.
297 Notez qu'il s'agit du mode que @command{lilypond-book} utilise par défaut.
300 @cindex SVG (Scalable Vector Graphics)
301 pour du SVG (@emph{Scalable Vector Graphics}).
303 Cette option permet de créer un fichier SVG par page, sans incorporation
304 des fontes. Nous vous recommandons d'installer les fontes Century
305 Schoolbook comprises dans le paquetage LilyPond afin d'obtenir le
306 meilleur rendu possible. Sous UNIX, il suffit de les recopier, à partir
307 du répertoire @file{/usr/share/lilypond/VERSION/fonts/otf/}, dans
308 @file{~/.fonts/}. Les fichiers SVG alors générés devraient être lisible
309 par votre éditeur SVG habituel.
313 pour une recopie brute des commandes Scheme internes de formatage.
316 permet de ne pas générer de partition imprimable. Cette option est
317 équivalente à @code{-dno-print-pages}.
321 Exemple : @code{lilypond -dbackend=svg @var{monfichier}.ly}
325 @cindex preview, ligne de commande
326 Génère un fichier comprenant le titrage et le premier système. S'il
327 existe plusieurs sections @code{\bookpart}, ce fichier contiendra les
328 tritrage et premier système de chacun des @code{\bookpart}. Cette
329 option fonctionne pour les moteurs de traitement @code{ps}, @code{eps}
334 Génère l'intégralité des pages de la partition. L'option
335 @code{-dno-print-pages} est particulièrement utile lorsqu'utilisée
336 conjointement avec l'option @code{-dpreview}.
343 Affiche un résumé des commandes.
346 @item -H,--header=@var{CHAMP}
347 Recopie le champ d'entête dans le fichier @file{RACINE.@var{CHAMP}}.
350 @item --include, -I=@var{répertoire}
351 @cindex recherche de fichier
354 Ajoute @var{répertoire} au chemin de recherche pour les inclusions.
356 Vous pouvez mentionner plusieurs fois l'option @code{-I}, auquel cas le
357 la recherche commencera dans le premier répertoire inclus et, si le
358 fichier en question ne s'y trouve pas, les répertoires suivants seront
359 examinés l'un après l'autre.
362 @item -i,--init=@var{fichier}
363 Définit @var{fichier} (par défaut @file{init.ly}) en tant que fichier
367 @item -o,--output=@var{FICHIER} ou @var{RÉP}
368 @cindex répertoire de destination
369 @cindex fichier de destination
371 Détermine le nom par défaut du fichier résultant à @var{FICHIER}@tie{};
372 lorsque l'argument @var{RÉP} correspond à un répertoire déjà existant,
373 c'est là que les fichiers résultants seront déposés. Le suffixe adéquat
374 sera ajouté (p.ex. @code{.pdf} pour du pdf) dans tous les cas.
377 @cindex PostScript output
380 Génère du PostScript.
383 @cindex Portable Network Graphics (PNG) output
386 Génère une image par page, au format PNG@tie{}; ceci sous-entend
387 l'utilisation de @code{--ps}. La résolution de l'image, en DPI, peut se
388 régler en ajoutant par exemple
394 @cindex Portable Document Format (PDF) output
397 Génère du PDF. Ceci sous-entend l'utilisation de @code{--ps}.
400 @item -j,--jail=@var{user},@var{group},@var{jail},@var{dir}
401 Lance @command{lilypond} dans un environnement protégé.
403 L'option @code{--jail} est une alternative qui offre plus de flexibilité
404 que l'option @code{--safe} lorsque LilyPond est installé sur un serveur
405 web ou traite des fichiers externes.
407 L'option @code{--jail} va détourner la racine de @command{lilypond} sur
408 @code{jail} juste avant d'effectuer la compilation à proprement parler.
409 L'utilisateur et le groupe sont modifiés en conséquence, et le
410 répertoire en cours devient @code{dir}. Ces réglages assurent -- du
411 moins en théorie -- l'impossibilité de s'échapper de la cellule. Notez
412 cependant que, pour que l'option @code{--jail} soit fonctionnelle,
413 @code{lilypond} doit être lancé en tant qu'administrateur -- ce qui se
414 réalise aisément à l'aide de la commande @command{sudo}.
416 La création d'un environnement sécurisé requiert quelques précautions
417 dans la mesure où LilyPond doit disposer de tout ce dont il a besoin
418 pour compiler le fichier source @strong{à l'intérieur de la cellule}.
419 L'ermitage, avant d'être viable, requiert donc les étapes
423 @item Création d'un système de fichiers indépendant
424 L'intérêt d'un système de fichiers dédié à LilyPond réside dans le fait
425 qu'on peut le brider à l'aide des options @code{noexec}, @code{nodev} et
426 @code{nosuid}. Il sera de fait impossible de lancer des exécutables ou
427 d'écrire sur un périphérique à partir de LilyPond. Si vous n'avez pas
428 l'intention de créer un tel système sur une partition séparée, vous
429 pouvez avoir recours à un pseudo-périphérique (@emph{loop device}) monté
430 à partir d'un simple fichier de taille raisonnable. D'autre part, le
431 recours à un système de fichiers indépendant permet de limiter l'espace
434 @item Création d'un utilisateur spécifique
435 L'utilisation de LilyPond au sein de la cellule devrait être réservé à
436 un utilisateur aux droits restreints. Il faudra donc créer un
437 utilisateur et un groupe spécifiques -- disons @code{lily}/@code{lily}
438 -- qui n'aura accès en écriture qu'à un unique répertoire déterminé par
439 la valeur de @var{dir}.
441 @item Agencement des lieux
442 LilyPond a besoin d'un certain nombre de fichiers pour pouvoir tourner
443 correctement. Ces fichiers devront donc tous se retrouver dans
444 l'environnement protégé, distribués selon la même arborescence que dans
445 le système d'origine. Ainsi l'intégralité de l'installation de LilyPond
446 (en principe @file{/usr/share/lilypond}) doit y être dupliquée.
448 En cas de problème, lancer LilyPond en utilisant @code{strace} devrait
449 vous permettre de déterminer quels fichiers manquent à l'appel.
451 @item Lancement de LilyPond
452 Dans un environnement protégé monté avec l'option @code{noexec}, il est
453 impossible de lancer un quelconque programme extérieur. LilyPond ne
454 saurait donc avoir recours à un moteur de traitement qui le mettrait
455 dans cette situation. Comme nous l'avons vu plus haut, LilyPond sera
456 lancé avec les privilèges de l'administrateur -- privilèges qu'il perdra
457 aussitôt --, ce qui peut nécessiter le recours à la commande
458 @code{sudo}. Il est par ailleurs judicieux de limiter le temps
459 processeur aloué à LilyPond -- grâce à @command{ulimit@tie{}-t} par
460 exemple -- ainsi que, si votre système le permet, la taille de la
466 Affiche le numéro de version.
470 Active le mode verbeux@tie{}: affichage de l'intégralité du chemin
471 d'accès de chaque fichier, et information des temps de traitement.
475 Affiche les informations de garantie appliquables à GNU LilyPond -- il
476 est livré @strong{SANS GARANTIE}@tie{}!
480 @node Variables d'environnement
481 @unnumberedsubsec Variables d'environnement
482 @translationof Environment variables
485 @cindex LILYPOND_DATADIR
487 @command{lilypond} reconnaît les variables d'environnement
490 @item LILYPOND_DATADIR
491 Cette variable spécifie le répertoire où seront recherchés par défaut les
492 différentes versions des messages ainsi qu'un certain nombre de fichiers
493 nécessaires au traitement. Il devrait contenir les sous-répertoires
494 @file{ly/}, @file{ps/}, @file{tex/}, etc.
497 Cette variable détermine la langue dans laquelle seront émis les
500 @item LILYPOND_GC_YIELD
501 Cette variable parmet d'ajuster l'empreinte mémoire et le rendement de
502 la machine. Il s'agit en fait d'un pourcentage d'allocation de
503 mémoire@tie{}: lorsqu'il est élevé, le programme favorisera
504 l'utilisation de la mémoire@tie{}; une faible valeur consommera plus de
505 temps processeur. Par défaut, cette valeur est fixée à @code{70}.
510 @node Exécution de LilyPond en mode protégé
511 @unnumberedsubsec Exécution de LilyPond en mode protégé
512 @translationof LilyPond in chroot jail
514 Paramétrer un serveur afin qu'il puisse faire fonctionner LilyPond en
515 mode protégé sur un pseudo-périphérique est une tâche sensible. Les
516 différentes étapes à suivre sont répertoriées ci-dessous. Les exmples
517 qu'elle comportent proviennent d'une distribution Linux Ubuntu et
518 nécessiteront l'utilisation de @code{sudo} autant que de besoin.
522 @item Installation des paquetages nécessaires@tie{}: LilyPond, GhostScript et
525 @item Création de l'utilisateur @code{lily}:
532 Ceci, par la même occasion, créera un groupe spécifique pour
533 l'utilisateur @code{lily} ainsi que son répertoire personnel
536 @item Création, dans le répertoire personnel de l'utilisateur
537 @code{lily}, d'un espace agissant en tant que système de fichiers@tie{}:
540 dd if=/dev/zero of=/home/lily/loopfile bs=1k count= 200000
544 Cette commande a créé un fichier de 200@tie{}MB utilisable par le
545 @qq{système protégé}.
547 @item Création d'un pseudo périphérique, génération d'un système de
548 fichiers et chargement de celui-ci, puis création d'un répertoire
549 accessible en écriture pour l'utilisateur @code{lily}@tie{}:
553 losetup /dev/loop0 /home/lily/loopfile
554 mkfs -t ext3 /dev/loop0 200000
555 mount -t ext3 /dev/loop0 /mnt/lilyloop
556 mkdir /mnt/lilyloop/lilyhome
557 chown lily /mnt/lilyloop/lilyhome
560 @item Affectation, au niveau configuration du serveur, de
561 @code{/mnt/lilyloop} en tant que JAIL et @code{/lilyhome} en tant que
564 @item Création d'une arborescence, dans l'espace protégé, et recopie de
565 tous les fichiers nécessaires -- voir le script plus loin.
567 You can use @code{sed} to create the necessary copy commands for a given
571 for i in "/usr/local/lilypond/usr/bin/lilypond" "/bin/sh" "/usr/bin/; do ldd $i | sed 's/.*=> \/\(.*\/\)\([^(]*\).*/mkdir -p \1 \&\& cp -L \/\1\2 \1\2/' | sed 's/\t\/\(.*\/\)\(.*\) (.*)$/mkdir -p \1 \&\& cp -L \/\1\2 \1\2/' | sed '/.*=>.*/d'; done
576 @subheading Exemple de script fonctionnel en 32-bit sur Ubuntu 8.04
580 ## les réglages par défaut
584 loopdevice=/dev/loop0
585 jaildir=/mnt/lilyloop
586 # le préfixe (sans slash au début !)
588 # le répertoire du système où lilypond est installé
589 lilydir=/$lilyprefix/lilypond/
591 userhome=$home/$username
592 loopfile=$userhome/loopfile
594 dd if=/dev/zero of=$loopfile bs=1k count=200000
596 losetup $loopdevice $loopfile
597 mkfs -t ext3 $loopdevice 200000
598 mount -t ext3 $loopdevice $jaildir
599 mkdir $jaildir/lilyhome
600 chown $username $jaildir/lilyhome
603 mkdir -p bin usr/bin usr/share usr/lib usr/share/fonts $lilyprefix tmp
606 cp -r -L $lilydir $lilyprefix
607 cp -L /bin/sh /bin/rm bin
608 cp -L /usr/bin/convert /usr/bin/gs usr/bin
609 cp -L /usr/share/fonts/truetype usr/share/fonts
611 # la formule magique de recopie des biblothèques
612 for i in "$lilydir/usr/bin/lilypond" "$lilydir/usr/bin/guile" "/bin/sh" "/bin/rm" "/usr/bin/gs" "/usr/bin/convert"; do ldd $i | sed 's/.*=> \/\(.*\/\)\([^(]*\).*/mkdir -p \1 \&\& cp -L \/\1\2 \1\2/' | sed 's/\t\/\(.*\/\)\(.*\) (.*)$/mkdir -p \1 \&\& cp -L \/\1\2 \1\2/' | sed '/.*=>.*/d'; done | sh -s
614 # les fichiers partagés pour ghostscript...
615 cp -L -r /usr/share/ghostscript usr/share
616 # les fichiers partagés pour ImageMagick
617 cp -L -r /usr/lib/ImageMagick* usr/lib
619 ### Partant du principe que test.ly est dans /mnt/lilyloop/lilyhome,
620 ### on devrait pouvoir lancer :
621 ### Attention : /$lilyprefix/bin/lilypond est un script qui
622 ### définit LD_LIBRARY_PATH - c'est primordial
623 /$lilyprefix/bin/lilypond -jlily,lily,/mnt/lilyloop,/lilyhome test.ly
627 @node Messages d'erreur
628 @section Messages d'erreur
629 @translationof Error messages
631 @cindex erreur, messages
633 Différents messages d'erreur sont susceptibles d'apparaître au cours de
634 la compilation d'un fichier@tie{}:
638 @item Warning -- Avertissement
640 @cindex avertissement
641 Ce type de message est émis lorsque LilyPond détecte quelque chose de
642 suspect. Si vous avez demandé quelque chose qui sort de l'ordinaire,
643 vous saurez probablement ce à quoi il est fait référence et ignorerez de
644 tels messages sans remord. Néanmoins, les messages d'avertissement
645 indiquent la plupart du temps une incohérence dans le fichier source.
647 @item Error -- Erreur
649 LilyPond a détecté une erreur. L'étape en cours, qu'il s'agisse de
650 l'analyse, de l'interprétation des données ou bien du formatage, sera
651 menée à son terme, puis LilyPond s'arrêtera.
653 @item Fatal error -- Erreur fatale
655 LilyPond est confronté à une anomalie bloquante. Ceci ne se produit que
656 très rarement, et le plupart du temps en raison d'une installation
657 défectueuse des fontes.
659 @item Scheme error -- Erreur Scheme
660 @cindex trace, Scheme
663 Les erreurs qui interviennent lors de l'exécution de code Scheme sont
664 gérées par l'interpréteur Scheme. L'utilisation du mode verbeux
665 (options @code{-V} ou @code{--verbose}) vous permettra de localiser
666 l'appel de fonction délictueux.
668 @item Programming error -- Erreur de programmation
669 @cindex Programming error
670 @cindex Erreur de programmation
671 LilyPond est confronté à une incohérence interne. Ce type de message
672 est destiné à venir en aide aux développeurs et débogueurs. En règle
673 générale, vous pouvez tout simplement les ignorer. Parfois, il y en a
674 tant qu'ils masquent ce qui pourrait vous intéresser@dots{}
676 @item Aborted (core dumped) -- Abandon
677 @cindex Aborted (core dumped)
678 Ce type de message indique que LilyPond a planté en raison d'une grave
679 erreur de programmation. La survenance d'un tel message est considérée
680 comme de la plus haute importance. Si vous y étiez confronté,
681 transmettez un rapport de bogue.
684 @cindex errors, message format
685 Lorsque l'avertissement ou l'erreur est directement lié au fichier
686 source, le message est libellé sous la forme
689 @var{fichier}:@var{ligne}:@var{colonne}: @var{message}
690 @var{contenu de la ligne litigieuse}
693 Un saut de ligne est placé dans la ligne de code, indiquant l'endroit
694 précis du problème, comme ici@tie{}:
697 test.ly:2:19: erreur: n'est pas une durée: 5
702 Notez que ces coordonnées constituent l'approximation au mieux par
703 LilyPond dans le code ayant déclenché l'avertissement ou l'erreur. En
704 règle générale, erreurs et avertissement surviennent lorsque LilyPond
705 rencontre quelque chose d'inattendu. Lorsque la ligne indiquée ne vous
706 semble pas comporter d'élément litigieux, remontez de quelques lignes
709 Vous trouverez d'autres informations sur les erreurs au chapitre
710 @ref{Quelques erreurs des plus courantes}.
713 @node Quelques erreurs des plus courantes
714 @section Quelques erreurs des plus courantes
715 @translationof Common errors
717 Les conditions amenant aux erreurs qui suivent sont fréquentes, bien
718 qu'elles ne soient pas évidentes ni facilement localisables. Nous
719 espérons que ces explications vous aideront à les résoudre plus
724 * La musique déborde de la page::
725 * Apparition d'une portée supplémentaire::
726 * Erreur renvoyant à ../ly/init.ly::
727 * Message d'erreur Unbound variable %::
728 * Message d'erreur FT_Get_Glyph_Name::
731 @node La musique déborde de la page
732 @unnumberedsubsec La musique déborde de la page
733 @translationof Music runs off the page
735 Lorsque la musique s'épanche au delà de la marge droite ou bien semble
736 anormalement comprimée, la raison en est le plus souvent une note à la
737 durée erronée@tie{}; cela finit par provoquer le débordement de la
738 dernière note d'une mesure. Rien ne s'oppose à ce que la dernière note
739 d'une mesure ne s'arrête avant la barre de mesure@tie{}; on considère
740 simplement qu'elle se prolonge sur la mesure suivante. Des débordements
741 à répétition finissent par générer une musique comprimée ou qui sort de
742 la page, pour la simple et bonne raison que les sauts de ligne
743 automatiques ne peuvent intervenir qu'à la fin d'une mesure complète,
744 autrement dit lorsque toutes les notes sont terminées avant la fin de la
747 @warning{Une durée erronée peut empêcher les sauts de ligne, ce qui
748 conduit à une musique compressée, voire à un débordement de la page.}
750 Une erreur de durée sera bien plus facilement localisable si vous
751 positionnez régulièrement des contrôles de barre de mesure -- voir
752 @ruser{Vérification des limites et numéros de mesure}.
754 Si vous tenez absolument à enchainer de tels débordements, vous devrez
755 insérer des barres de mesure invisibles là où vous souhaitez positionner
756 un saut de ligne. Consultez le chapitre @ruser{Barres de mesure} pour
760 @node Apparition d'une portée supplémentaire
761 @unnumberedsubsec Apparition d'une portée supplémentaire
762 @translationof An extra staff appears
764 Lorsque les contextes ne sont pas créés explicitement par la commande
765 @code{\new}, ils le seront si la commande à exécuter n'est pas censée
766 s'appliquer au contexte en cours. Pour des partitions simples, les fait
767 que les contextes soient automatiquement créés rend bien des services,
768 et c'est d'ailleurs le cas pour la majorité des exemples contenus dans
769 les manuels de LilyPond. Cependant, la création implicite d'un contexte
770 peut aboutir à l'apparition d'une portée @qq{parasite}. On s'attend par
771 exemple, en lisant le code qui suit, à ce que toutes les têtes de notes
772 soient en rouge, alors que le résultat nous présente deux portées et que
773 les notes, placées sur la portée inférieure, restent en noir.
775 @lilypond[quote,verbatim,relative=2]
776 \override Staff.NoteHead #'color = #red
780 Étant donné qu'aucun contexte @code{Staff} n'existe lorsque la
781 dérogation est introduite, LilyPond le crée implicitement pour lui
782 appliquer la directive considérée. Survient alors la commande
783 @w{@code{\new Staff}} qui, à son tour, crée une nouvelle portée pour
784 contenir les notes qui suivent. Voici la syntaxe correcte pour obtenir
785 ces notes en rouge@tie{}:
787 @lilypond[quote,verbatim,relative=2]
789 \override Staff.NoteHead #'color = #red
794 Autre exemple : la présence d'une commande @code{\relative} à
795 l'intérieur d'une section @code{\repeat} génèrera obligatoirement une
796 portée intempestive. Cela tient au fait que la commande @code{\repeat}
797 va créer deux blocs @code{\relative} qui, chacun à leur tour, créeront
798 implicitement un bloc @code{Staff} assorti d'un bloc @code{Voice}.
800 @lilypond[quote,verbatim]
801 \repeat unfold 2 \relative { c d e f }
804 La manière adéquate de procéder consiste à inverser les commandes
805 @code{\repeat} et @code{\relative}, comme ceci@tie{}:
807 @lilypond[quote,verbatim]
809 \repeat unfold 2 { c d e f }
814 @node Erreur renvoyant à ../ly/init.ly
815 @unnumberedsubsec Erreur renvoyant à @code{../ly/init.ly}
816 @translationof Apparent error in ../ly/init.ly
818 Certains messages d'erreur relatifs à une erreur de syntaxe dans le
819 fichier @code{../ly/init.ly} peuvent survenir lorsque le fichier est mal
820 formaté. Cela se produit notamment lors d'un défaut de parité de
821 bornages ou de guillemets.
823 L'erreur la plus courante est la simple omission d'une accolade
824 fermante (@code{@}} à la fin du bloc @code{Score}. La solution est
825 évidente en pareil cas@tie{}: il suffit de vérifier que le bloc
826 @code{Score} est bien clôturé. La structure des fichiers LilyPond est
827 abordée plus en détails au chapitre @rlearning{Organisation des fichiers
828 LilyPond}. C'est la raison pour laquelle nous vous invitons à utiliser
829 un éditeur de texte qui prenne en charge le contrôle de parité des
830 parenthèses, crochets et accolades afin de vous éviter de telles erreurs.
832 Lorsqu'il s'agit d'un guillemet fermant (@code{"}) omis, le message
833 d'erreur devrait vous indiquer un numéro de ligne avoisinant. L'erreur
834 se situe la plupart du temps une ou deux lignes au-dessus de celle
838 @node Message d'erreur Unbound variable %
839 @unnumberedsubsec Message d'erreur « Unbound variable % »
840 @translationof Error message Unbound variable %
842 Ce message d'erreur, qu'il apparaisse sur le terminal ou en fin de
843 fichier journal, est associé à un message du type @qq{GUILE a signalé
844 une erreur @dots{}}, survient à chaque fois qu'un commentaire
845 @emph{LilyPond} est indûment placé dans une routine @emph{Scheme}.
847 Un commentaire LilyPond est introduit par le signe pourcent (@code{%})
848 et ne doit en aucun cas se trouver dans une routine Scheme. En Scheme,
849 les commentaires s'introduisent par un point-virgule (@code{;}).
852 @node Message d'erreur FT_Get_Glyph_Name
853 @unnumberedsubsec Message d'erreur « FT_Get_Glyph_Name »
854 @translationof Error message FT_Get_Glyph_Name
856 Ce message d'erreur, qu'il apparaisse sur le terminal ou en fin de
857 fichier journal, survient lorsqu'un fichier source contient des
858 caractères non ASCII et qu'il n'a pas été enregistré avec un encodage
859 UTF-8. Pour plus de détails, reportez-vous au chapitre
860 @ruser{Codage du texte}.