1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
4 Translation of GIT committish: 6b8cabe379e8b4b945797a4e55759c56117223d4
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 « ligne de commande », nous entendons l'interface de commande du
51 système. Les utilisateurs de Windows seront certainement plus familiers
52 des termes « fenêtre DOS » ou « invite de commande ». Quant aux
53 utilisateurs de MacOS X, ils connaissent assurément les termes
54 « console » et « 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.
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é::
71 @node Lancement de LilyPond
72 @unnumberedsubsec Lancement de LilyPond
73 @translationof Invoking LilyPond
75 L'exécutable @command{lilypond} en ligne de commande se lance ainsi :
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 ; 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 Utilisation de LilyPond avec les fonctionnalités standard de l'interpréteur
112 @translationof Using LilyPond with standard shell features
114 Dans la mesure où LilyPond est une application qui fonctionne en ligne
115 de commande, les fonctionnalités de l'interpréteur utilisé pour lancer
116 LilyPond peuvent se révéler utiles.
125 traitera tous les fichiers LilyPond présents dans le répertoire en
128 Rediriger, par exemple dans un fichier, ce qui est émis à l'écran peut
132 lilypond fichier.ly 1> stdout.log
134 lilypond fichier.ly 2> stderr.log
136 lilypond fichier.ly &> tous.log
140 redirigeront respectivement le « verbiage normal », les erreurs ou tout,
141 dans un fichier texte.
143 Consultez avant tout la documentation de votre interpréteur habituel
144 -- terminal, console, etc. -- pour vérifier qu'il prend en charge les
145 options dans cette syntaxe.
147 Voici comment traiter un jeu de fichiers répartis dans un répertoire
148 donné ainsi que tous ses différents sous-répertoires. Les fichiers
149 résultants seront regroupés dans le répertoire à partir duquel la
150 commande a été exécutée, non selon l'emplacement des fichiers sources.
153 find . -name '*.ly' -exec lilypond '@{@}' \;
157 Cette commande, bien qu'effective uniquement dans un terminal, devrait
158 être fonctionnelle aussi pour les utilisateurs de MacOS X.
160 Les utilisateurs de windows utiliseront l'instruction
163 forfiles /s /M *.ly /c "cmd /c lilypond @@file"
167 dans l'@code{interpréteur de commandes}, qui se trouve normalement sous
168 @code{Démarrer > Accessoires > Interpréteur de commandes} ou, pour la
169 version 8, en faisant une recherche sur « interpréteur de commande ».
171 Par ailleurs, il est possible de spécifier de manière explicite le chemin
172 d'accès au dossier comportant des sous-répertoires où se trouvent les
173 fichiers sources, à l'aide de l'option @code{/p} :
176 forfiles /s /p C:\Documents\MesPartitions /M *.ly /c "cmd /c lilypond @@file"
179 Dans le cas où ce chemin d'accès comporte des espaces, l'intégralité de
180 ce chemin devra être borné par des guillemets informatiques :
183 forfiles /s /p "C:\Documents\Mes Partitions" /M *.ly /c "cmd /c lilypond @@file"
187 @node Options basiques de lilypond
188 @unnumberedsubsec Options basiques de @command{lilypond}
189 @translationof Basic command line options for LilyPond
191 @cindex lancement de @command{lilypond}
192 @cindex ligne de commande, options pour @command{lilypond}
193 @cindex options, ligne de commande
197 Différentes options sont disponibles en ligne de commande :
204 Les fichiers PDF générés peuvent être beaucoup plus lourd que la normale
205 selon le degré d'optimisation des fontes. Néanmoins, lorsque plusieurs
206 fichiers PDF sont inclus dans un document @code{pdftex}, @code{xetex} ou
207 @code{luatex}, ils peuvent faire l'objet d'un traitement supplémentaire
208 par @code{ghostscript} afin de fusionner les données de fontes
209 redondantes et ainsi obtenir un fichier PDF @emph{significativement}
213 lilypond -b monfichier
216 Puis lancer @code{ghostscript} :
219 gs -q -sDEVICE=pdfwrite -o gsout.pdf monfichier.pdf
222 @code{pdfsizeopt.py} vient alors en complément pour optimiser encore la
226 pdfsizeopt.py --use-multivalent=no gsout.pdf final.pdf
230 @item -d, --define-default=@var{variable}=@var{valeur}
231 Voir @ref{Options avancées de lilypond}.
233 @cindex Scheme, évaluation d'expression
234 @cindex expression Scheme, évaluation
235 @item -e, --evaluate=@var{expr}
236 Évalue l'expression Scheme @var{expr} avant d'analyser tout fichier
237 @file{.ly}. Lorsque vous spécifiez l'option @option{-e} à plusieurs
238 reprises, l'évaluation sera faite en séquence.
240 Dans la mesure où l'expression est évaluée par le module
241 @code{guile-user}, vous devrez, dès lors que @var{expr} utilise des
242 définitions, spécifier
245 lilypond -e '(define-public a 42)'
249 en ligne de commande, et ajouter la ligne
252 #(use-modules (guile-user))
256 en tête de votre fichier @file{.ly}.
258 @warning{Les utilisateurs de Windows doivent utiliser des guillemets
259 doubles @code{"} en lieu et place des guillemets simples @code{'}.}
260 @c Match " in context-sensitive editors
262 @cindex sortie, format
263 @cindex format de sortie
264 @item -f, --format=@var{format}
265 Détermine le format à produire. Il peut s'agir de @code{ps}, @code{pdf}
268 Exemple : @code{lilypond -fpng @var{monfichier}.ly}
271 Les formats @code{svg} et @code{eps} s'obtiennent à l'aide de
272 l'option @code{-dbackend} -- voir @ref{Options avancées de lilypond}.
275 Affiche un résumé des commandes.
277 @item -H, --header=@var{CHAMP}
278 Recopie le champ d'entête dans le fichier @file{RACINE.@var{CHAMP}}.
280 @item -i, --init=@var{fichier}
281 Définit @var{fichier} (par défaut @file{init.ly}) en tant que fichier
284 @cindex recherche de fichier
285 @cindex chemin de recherche
286 @item -I, --include=@var{répertoire}
287 Ajoute @var{répertoire} au chemin de recherche pour les inclusions.
289 Vous pouvez mentionner plusieurs fois l'option @option{-I}, auquel cas
290 la recherche commencera dans le premier répertoire inclus et, si le
291 fichier en question ne s'y trouve pas, les répertoires suivants seront
292 examinés l'un après l'autre.
294 @cindex chroot jail, fonctionnement
295 @item -j, --jail=@var{user},@var{group},@var{jail},@var{dir}
296 Lance @command{lilypond} dans un environnement protégé.
298 L'option @option{--jail} est une alternative qui offre plus de
299 flexibilité que l'option @option{--safe} lorsque LilyPond est installé
300 sur un serveur web ou traite des fichiers externes -- voir
301 @ref{Options avancées de lilypond}.
303 L'option @option{--jail} va détourner la racine de @command{lilypond}
304 sur @var{jail} juste avant d'effectuer la compilation à proprement
305 parler. L'utilisateur et le groupe sont modifiés en conséquence, et le
306 répertoire en cours devient @var{dir}. Ces réglages assurent -- du
307 moins en théorie -- l'impossibilité de s'échapper de la cellule. Notez
308 cependant que, pour que l'option @option{--jail} soit fonctionnelle,
309 @command{lilypond} doit être lancé en tant qu'administrateur -- ce qui
310 se réalise aisément à l'aide de la commande @command{sudo}.
312 La création d'un environnement sécurisé requiert quelques précautions
313 dans la mesure où LilyPond doit disposer de tout ce dont il a besoin
314 pour compiler le fichier source @strong{à l'intérieur de la cellule}.
315 L'ermitage, avant d'être viable, requiert donc les étapes
320 @item Création d'un système de fichiers indépendant
321 L'intérêt d'un système de fichiers dédié à LilyPond réside dans le fait
322 qu'on peut le brider à l'aide des options @code{noexec}, @code{nodev} et
323 @code{nosuid}. Il sera de fait impossible de lancer des exécutables ou
324 d'écrire sur un périphérique à partir de LilyPond. Si vous n'avez pas
325 l'intention de créer un tel système sur une partition séparée, vous
326 pouvez avoir recours à un pseudo-périphérique (@emph{loop device}) monté
327 à partir d'un simple fichier de taille raisonnable. D'autre part, le
328 recours à un système de fichiers indépendant permet de limiter l'espace
331 @item Création d'un utilisateur spécifique
332 L'utilisation de LilyPond au sein de la cellule devrait être réservé à
333 un utilisateur aux droits restreints. Il faudra donc créer un
334 utilisateur et un groupe spécifiques -- disons
335 @w{@code{lily}/@code{lily}} -- qui n'aura accès en écriture qu'à un
336 unique répertoire déterminé par la valeur de @var{dir}.
338 @item Agencement des lieux
339 LilyPond a besoin d'un certain nombre de fichiers pour pouvoir tourner
340 correctement. Ces fichiers devront donc tous se retrouver dans
341 l'environnement protégé, distribués selon la même arborescence que dans
342 le système d'origine. Ainsi l'intégralité de l'installation de LilyPond
343 (en principe @file{/usr/share/lilypond}) doit y être dupliquée.
345 En cas de problème, lancer LilyPond en utilisant @command{strace}
346 devrait vous permettre de déterminer quels fichiers manquent à l'appel.
348 @item Lancement de LilyPond
349 Dans un environnement protégé monté avec l'option @code{noexec}, il
350 est impossible de lancer un quelconque programme extérieur. LilyPond ne
351 saurait donc avoir recours à un moteur de traitement qui le mettrait
352 dans cette situation. Comme nous l'avons vu plus haut, LilyPond sera
353 lancé avec les privilèges de l'administrateur -- privilèges qu'il perdra
354 aussitôt --, ce qui peut nécessiter le recours à la commande
355 @code{sudo}. Il est par ailleurs judicieux de limiter le temps
356 processeur alloué à LilyPond -- grâce à @command{ulimit -t} par
357 exemple -- ainsi que, si votre système le permet, la taille de la
358 mémoire. Voir aussi @ref{Exécution de LilyPond en mode protégé}.
362 @cindex verbosité, définir le degré de
363 @item -l, --loglevel=@var{DEGRÉ}
364 Règle le niveau de verbosité des messages console à @var{DEGRÉ}. Les
365 différentes valeurs sont :
369 Aucun verbiage, même pas les messages d'erreur.
372 Uniquement les messages d'erreur ; pas de message d'avertissement
376 Messages d'avertissement ou d'erreur ; pas d'information de
380 Information de progression basique (réussite) et avertissements ou
384 Toutes les informations de progression, avertissements et erreurs.
386 @item INFO (par défaut)
387 Informations de progression, avertissements et erreurs, ainsi que
388 d'autres informations relatives à l'exécution.
391 Tout ce qui peut être affiché, y compris le verbiage utile au débogage.
396 @cindex répertoire de destination
397 @cindex fichier de destination
398 @item -o, --output=@var{FICHIER} ou @var{RÉPERTOIRE}
399 Détermine le nom par défaut du fichier résultant à @var{FICHIER} ;
400 lorsque l'argument @var{RÉPERTOIRE} correspond à un répertoire déjà
401 existant, c'est là que les fichiers résultants seront déposés. Le
402 suffixe adéquat sera ajouté (par ex. @code{.pdf} pour du pdf) dans tous
405 @cindex PostScript, output
406 @cindex PS (PostScript), output
408 Génère du PostScript.
410 @cindex Portable Network Graphics (PNG), output
411 @cindex PNG (Portable Network Graphics), output
413 Génère une image par page, au format PNG ; ceci sous-entend
414 l'utilisation de @option{--ps}. La résolution de l'image, en DPI, peut
415 se régler en ajoutant par exemple
420 @cindex Portable Document Format (PDF), output
421 @cindex PDF (Portable Document Format), output
423 Génère du PDF. Ceci sous-entend l'utilisation de @option{--ps}.
426 Affiche le numéro de version.
429 Active le mode verbeux : affichage de l'intégralité du chemin
430 d'accès de chaque fichier, et information des temps de traitement.
433 Affiche les informations de garantie applicables à GNU LilyPond -- il
434 est livré @strong{SANS GARANTIE} !
439 @node Options avancées de lilypond
440 @unnumberedsubsec Options avancées de @command{lilypond}
441 @translationof Advanced command line options for LilyPond
445 @item -d@var{[nom-option]}=@var{[valeur]},
446 --define-default=@var{[nom-option]}=@var{[valeur]}
447 Affecte la valeur Scheme @var{valeur} à l'option interne
448 @var{nom-option} du programme, comme par exemple
454 En l'absence de @var{valeur}, le programme utilisera @var{#t}.
455 Préfixer @var{nom-option} d'un @code{no-} vous permet de
456 désactiver une option. Ainsi,
458 @cindex point and click, ligne de commande
459 @cindex pointer-cliquer, ligne de commande
472 @noindent Voici les différentes options disponibles, ainsi que leur
475 @multitable @columnfractions .33 .16 .51
476 @item @strong{Symbole}
478 @tab @strong{Observations}
481 @item @code{anti-alias-factor}
483 @tab Adopte une résolution supérieure (selon le facteur donné),puis
484 réduit au niveau du résultat afin d'éviter les « distorsions » des
487 @item @code{aux-files}
489 @tab Génère les fichiers @code{.tex}, @code{.texi} et @code{.count}
490 pour le moteur de rendu @code{EPS}.
494 @tab Détermine le format de sortie à utiliser par le moteur de
495 traitement. Les fichiers PostScript (format par défaut) incluent les
496 fontes @code{TTF}, @code{Type1} et @code{OTF}, et aucune substitution ne
497 sera opérée pour ces fontes. Si vous utilisez des jeux de caractères
498 orientaux, le fichier aura vite fait d'atteindre une taille conséquente.
502 @tab Génère du PostScript encapsulé. Chaque page (système) fera l'objet
503 d'un fichier @file{EPS} particulier, sans fontes, auquel sera associé un
504 fichier @file{EPS} qui, lui, contiendra toutes les pages (systèmes) et
505 les fontes. Notez qu'il s'agit du mode que @command{lilypond-book}
510 @tab Ne génère aucun fichier imprimable. Cette option est équivalente à
511 @code{-dno-print-pages}.
515 @tab Recopie littéralement les commandes Scheme internes de formatage.
519 @tab Génère du @emph{Scalable Vector Graphics}. Cette option permet de
520 créer un fichier SVG par page. Les glyphes musicaux sont codés en tant
521 que graphiques vectoriels mais les fontes textuelles @b{ne sont pas}
522 incorporées aux fichiers @file{SVG} résultants. Quel que soit le
523 programme utilisé pour visionner ces fichiers, il devra avoir accès aux
524 fontes en question pour pouvoir afficher correctement les textes et
525 paroles. Il est préférable de ne pas recourir aux « alias de police »
526 ni aux listes de fontes si la visionneuse de fichier SVG ne peut le
527 traîter correctement. L'option supplémentaire @code{--svg-woff} -- voir
528 ci-après -- permet d'utiliser les fontes WOFF (@emph{Web Open Font
529 Format}) avec le moteur SVG.
533 @strong{Note à propos des sorties SVG :}
534 Par défaut, LilyPond utilise des valeurs de @code{font-family}
535 génériques -- @code{Serif}, @code{Sans Serif} et @code{Monospace}. Le
536 recours au moteur @code{svg} requiert donc que ces polices par défaut
537 soient explicitement définies dans le fichier source :
543 (make-pango-font-tree "TeX Gyre Schola"
546 (/ staff-height pt 20)))
551 Voir aussi @ruser{Choix des fontes par défaut}.
553 @multitable @columnfractions .33 .16 .51
554 @item @code{check-internal-types}
556 @tab Vérifie qu'à chaque propriété est bien affecté un type.
558 @item @code{clip-systems}
560 @tab Extrait des fragments musicaux d'une partition. Ceci requiert que
561 la fonction @code{clip-regions} a été définie au sein du bloc
562 @code{\layout} -- voir @ruser{Extraction de fragments musicaux}. Bien
563 entendu, aucun fragment ne sera extrait si l'on utilise l'option
564 @option{-dno-print-pages}
568 @tab Détermine le préfixe des fichiers de données (lecture seule).
570 @item @code{debug-gc}
572 @tab Génère une copie brute de la mémoire, aux fins de débogage.
574 @item @code{debug-gc-assert-parsed-dead}
576 @tab Pour débogage de la mémoire : s'assure que toute référence à
577 des objets analysés est effacée. Il s'agit d'une option interne qui
578 est automatiquement activée par l'option @code{`-ddebug-gc'}.
580 @item @code{debug-lexer}
582 @tab Débogage de l'analyseur lexical @emph{flex}.
584 @item @code{debug-page-breaking-scoring}
586 @tab Purge les calculs des configurations de saut de page.
588 @item @code{debug-parser}
590 @tab Débogage de l'analyseur @emph{bison}.
592 @item @code{debug-property-callbacks}
594 @tab Débogage des chaînes de @emph{callback} cycliques.
596 @item @code{debug-skylines}
598 @tab Débogage des lignes d'horizon.
600 @item @code{delete-intermediate-files}
602 @tab Supprime les fichiers @code{.ps} inutiles crées lors de la
605 @item @code{dump-cpu-profile}
607 @tab Génère une copie brute des informations de timing (dépend du
610 @item @code{dump-profile}
612 @tab Génère une copie brute de la mémoire et des temps de traitement
615 @item @code{dump-signatures}
617 @tab Génère une copie des signatures de chaque système. Cette option
618 est utilisée pour les tests de régression.
620 @item @code{embed-source-code}
622 @tab Intègre les fichiers source LilyPond au document PDF généré.
624 @item @code{eps-box-padding}
626 @tab Décale le bord gauche du typon EPS d'une valeur donnée en
629 @item @code{font-export-dir}
630 @tab @code{#f [répertoire]}
631 @tab Répertoire dans lequel exporter les fontes en tant que fichiers
634 @item @code{gs-load-fonts}
636 @tab Charge les fontes grâce à Ghostscript.
638 @item @code{gs-load-lily-fonts}
640 @tab Limite les fontes chargées par Ghostscript aux seules fontes
643 @item @code{gs-never-embed-fonts}
645 @tab Intime à Ghostscript d'embarquer les fontes uniquement au format
646 TrueType, sans exception.
650 @tab Travaille silencieusement, et redirige tout le verbiage dans un
655 @strong{Note à l'attention des utilisateurs de Windows :} toutes
656 les informations concernant le traitement apparaissent au fur et à
657 mesure dans l'interpréteur de commandes lorsque vous lancez le programme
658 @code{lilypond.exe}, à l'inverse de @w{@code{lilypond-windows.exe}} qui
659 vous renvoie simplement la main. L'option @option{-dgui} vous permettra
660 alors de rediriger ces informations dans un fichier journal.
662 @multitable @columnfractions .33 .16 .51
665 @tab Affiche cette aide.
667 @item @code{include-book-title-preview}
669 @tab Inclut les titres de l'ouvrage dans les images de prévisualisation.
671 @item @code{include-eps-fonts}
673 @tab Inclut les fontes dans chaque fichier EPS contenant un système.
675 @item @code{include-settings}
677 @tab Inclut un fichier contenant les réglages globaux. Ce fichier sera
678 inclus avant traitement de la partition.
680 @item @code{job-count}
682 @tab Traite plusieurs fichiers en parallèle, selon le nombre de
685 @item @code{log-file}
686 @tab @code{#f [fichier]}
687 @tab Fournir @code{TOTO} en second argument redirigera la sortie dans le
688 fichier journal @code{TOTO.log}.
690 @item @code{max-markup-depth}
692 @tab Profondeur maximale de l'arborescence de @emph{markups}. Si un
693 @emph{markup} était plus profond, part du principe qu'on aboutira pas,
694 émet un avertissement et renvoie alors un @emph{markup} vide.
696 @item @code{midi-extension}
698 @tab Détermine l'extension par défaut des fichiers MIDI, selon la chaîne
701 @item @code{music-strings-to-paths}
703 @tab Convertit les chaînes textuelles en chemins lorsque les glyphes
704 font partie d'une fonte musicale.
706 @cindex paper-size, ligne de commande
707 @item @code{paper-size}
709 @tab Détermine la taille par défaut du papier. Veillez à ne pas oublier
710 d'encadrer la valeur par des guillemets échappés (@code{\"}).
711 @c Match " in context-sensitive editors
713 @item @code{pixmap-format}
715 @tab Détermine le format de sortie en images pixélisées pour
718 @item @code{point-and-click}
720 @tab Ajoute les liens « point & click » à la sortie PDF ou SVG. Voir
721 @ref{Pointer-cliquer}.
723 @cindex format de sortie, définition
724 @cindex preview, ligne de commande
727 @tab Génère une prévisualisation en plus de la sortie normale.
731 Cette option, disponible dans tous les formats de sortie imprimables --
732 @code{pdf}, @code{png}, @code{ps}, @code{eps} et @code{svg} -- génère
733 un fichier de la forme @code{monFichier.preview.extension} comprenant le
734 titrage et le premier système. S'il existe plusieurs sections
735 @code{\book}, @code{\bookpart}, ce fichier contiendra les titrage et
736 premier système de chacun des @code{\book}, @code{\bookpart} et
737 @code{\score}, dès lors que la variable @code{print-all-headers} du bloc
738 @code{\paper} est activée.
740 Pour l'éviter, utilisez conjointement l'une des options
741 @option{-dprint-pages} ou @option{-dno-print-pages} selon vos besoins.
743 @multitable @columnfractions .33 .16 .51
744 @item @code{print-pages}
746 @tab Génère l'intégralité des pages de la partition. L'option
747 @option{-dno-print-pages} est particulièrement utile lorsqu'utilisée
748 conjointement avec l'option @option{-dpreview}.
750 @item @code{profile-property-accesses}
752 @tab Enregistre des statistiques des appels à la fonction
753 @code{get_property()}.
755 @item @code{protected-scheme-parsing}
757 @tab Continue en dépit des erreurs que l'analyseur syntaxique
758 détecterait dans du code Scheme inclus. Lorsque basculé sur @code{#f},
759 stoppe le traitement s'il y a erreur et affiche une trace de la pile.
761 @item @code{read-file-list}
762 @tab @code{#f [fichier]}
763 @tab Spécifie un fichier listant les différents fichiers sources à
766 @item @code{relative-includes}
768 @tab Face à une instruction @code{\include}, recherche les fichiers à
769 inclure relativement à l'endroit où se trouve le fichier en cours de
770 traitement plutôt que par rapport au fichier maître.
772 @item @code{resolution}
774 @tab Détermine, en @code{dpi}, la résolution des pixmaps @code{PNG} à
775 générer selon la valeur donnée.
779 @tab Ne pas avoir une confiance aveugle dans le code @file{.ly}.
783 Lorsque LilyPond est accessible au travers d'un serveur web, il est
784 @strong{impératif} d'utiliser les options @option{--safe} ou
785 @option{--jail}. L'option @option{--safe} aura pour effet d'empêcher
786 tout code Scheme inclus de mettre en péril votre installation grâce à
787 quelque chose du style
791 #(s ystem "rm -rf /") % trop dangeureux à écrire sans faute
793 c4^$(ly:gulp-file "/etc/passwd") % malveillant mais pas destructeur
798 L'option @code{-dsafe} forcera l'évaluation, au fil de l'eau et par un
799 module sécurisé, des expressions Scheme contenues dans le fichier
800 source. Ce module sécuritaire, dérivé du module GUILE @file{safe-r5rs},
801 ajoute un certain nombre de fonctions -- listées dans
802 @file{scm/safe-lily.scm} -- à l'API de LilyPond.
804 De plus, le mode @emph{safe} ne permet ni l'utilisation de directives
805 @code{\include} ni le recours aux obliques inversées (@emph{backslash})
806 dans les chaînes @TeX{}. L'import de variables LilyPond dans du code
807 Scheme n'est pas possible en mode sécurisé.
809 L'option @code{-dsafe} @strong{ne détecte pas} l'utilisation abusive des
810 ressources. Il est donc possible que le programme finisse par rester
811 sans réponse si on lui envoie une boucle sans fin. C'est la raison pour
812 laquelle nous recommandons, lorsque LilyPond tourne sur un serveur
813 accessible au public, d'en limiter aussi bien les ressources processeur
816 Notez bien que l'utilisation du mode sécuritaire empêchera aussi la
817 compilation d'un certain nombre de fragments LilyPond. L'option
818 @code{--jail} est dans ce cas une excellente alternative en terme de
819 sécurité, même si elle requiert plus de temps à mettre en place -- voir
820 @ref{Options basiques de lilypond}.
822 @multitable @columnfractions .33 .16 .51
823 @item @code{separate-log-files}
825 @tab Pour les fichiers @code{FICHIER1.ly}, @code{FICHIER2.ly}, etc.
826 enregistre le déroulement dans les journaux @code{FICHIER1.log},
827 @code{FICHIER2.log}@dots{}
829 @item @code{show-available-fonts}
831 @tab Liste le nom des fontes disponibles.
833 @item @code{strict-infinity-checking}
835 @tab Force le crash en présence des points d'exception de virgule
836 flottante @code{Inf} ou @code{NaN} -- infini ou non-nombre.
838 @item @code{strip-output-dir}
840 @tab Supprime, lors du nommage des fichiers résultant, la partie
841 correspondant au répertoire des fichiers sources.
843 @item @code{strokeadjust}
845 @tab Force l'ajustement des traits PostScript. Cette option trouve
846 toute son utilité pour générer du PDF à partir de PostScript --
847 l'ajustement des traits est en principe automatiquement activé pour les
848 périphériques bitmap à faible résolution. Sans cette option, les
849 visionneurs de PDF ont tendance à ne pas rendre de manière constante
850 l'épaisseur des hampes dans les résolutions habituelles des écrans.
851 Bien que n'affectant pas notoirement la qualité d'impression, cette
852 option accroit notablement la taille des fichiers PDF.
854 @item @code{svg-woff}
856 @tab Cette option est obligatoire dès lors que sont utilisées, avec le
857 moteur SVG, les fontes @emph{Web Open Font Format} (WOFF). Un fichier
858 SVG sera généré pour chacune des pages produites. En dehors des glyphes
859 musicaux propres à LilyPond, aucune autre information ne sera incluse.
860 Quelque soir le visionneur de SVG utilisé, il devra avoir à disposition
861 les fontes requises pour pouvoir afficher les éléments textuels et les
862 paroles. Dans la mesure où le visionneur pourrait ne pas savoir le
863 gérer, mieux vaut s'abstenir derecourir aux alias ou listes de fontes.
866 Lorsque celles-ci sont utilisées correctement, nul n'est besoin
867 d'installer les fontes que les fichiers SVG utiliseront dans
868 l'environnement du visionneur. Néanmoins, LilyPond ne dispose pas de
869 fichier de fonte @code{woff} textuelle. La présence du fichier de fonte
870 @code{woff} est un prérequis.
872 @item @code{trace-memory-frequency}
874 @tab Enregistre l'utilisation de la cellule Scheme plusieurs fois par
875 seconde, dans les fichiers @code{FICHIER.stacks} et
876 @code{FICHIER.graph}.
878 @item @code{trace-scheme-coverage}
880 @tab Enregistre la couverture des fichiers Scheme dans @code{FILE.cov}.
884 @tab Passe en mode verbeux, ce qui correspond à un niveau de
885 journalisation @code{DEBUG} (lecture seule).
887 @item @code{warning-as-error}
889 @tab Considère tous les messages d'avertissement et « erreur de
890 programmation » comme étant de véritables erreurs.
894 @node Variables d'environnement
895 @unnumberedsubsec Variables d'environnement
896 @translationof Environment variables
899 @cindex LILYPOND_DATADIR
901 @command{lilypond} reconnaît les variables d'environnement
905 @item LILYPOND_DATADIR
906 Cette variable spécifie le répertoire où seront recherchés par défaut
907 les différentes versions des messages ainsi qu'un certain nombre de
908 fichiers nécessaires au traitement. Il devrait contenir les
909 sous-répertoires @file{ly/}, @file{ps/}, @file{tex/}, etc.
912 Cette variable détermine la langue dans laquelle seront émis les
915 @item LILYPOND_LOGLEVEL
916 Cette variable détermine le niveau par défaut de verbosité. En
917 l'absence de niveau explicite -- autrement dit la ligne de commande ne
918 comporte pas de @option{--loglevel} -- c'est cette valeur qui sera
921 @item LILYPOND_GC_YIELD
922 Cette variable permet d'ajuster l'empreinte mémoire et le rendement de
923 la machine. Il s'agit en fait d'un pourcentage d'allocation de
924 mémoire : lorsqu'il est élevé, le programme favorisera
925 l'utilisation de la mémoire ; une faible valeur consommera plus de
926 temps processeur. Par défaut, cette valeur est fixée à @code{70}.
931 @node Exécution de LilyPond en mode protégé
932 @unnumberedsubsec Exécution de LilyPond en mode protégé
933 @translationof LilyPond in chroot jail
935 Paramétrer un serveur afin qu'il puisse faire fonctionner LilyPond en
936 mode protégé sur un pseudo-périphérique est une tâche sensible. Les
937 différentes étapes à suivre sont répertoriées ci-dessous. Les exemples
938 qu'elle comportent proviennent d'une distribution GNU/Linux Ubuntu et
939 nécessiteront l'utilisation de @code{sudo} autant que de besoin.
943 @item Installation des paquetages nécessaires : LilyPond, Ghostscript et
946 @item Création de l'utilisateur @code{lily} :
953 Ceci, par la même occasion, créera un groupe spécifique pour
954 l'utilisateur @code{lily} ainsi que son répertoire personnel
957 @item Création, dans le répertoire personnel de l'utilisateur
958 @code{lily}, d'un espace agissant en tant que système de fichiers :
961 dd if=/dev/zero of=/home/lily/loopfile bs=1k count= 200000
965 Cette commande a créé un fichier de 200 MB utilisable par le
968 @item Création d'un pseudo-périphérique, génération d'un système de
969 fichiers et chargement de celui-ci, puis création d'un répertoire
970 accessible en écriture pour l'utilisateur @code{lily} :
974 losetup /dev/loop0 /home/lily/loopfile
975 mkfs -t ext3 /dev/loop0 200000
976 mount -t ext3 /dev/loop0 /mnt/lilyloop
977 mkdir /mnt/lilyloop/lilyhome
978 chown lily /mnt/lilyloop/lilyhome
981 @item Affectation, au niveau configuration du serveur, de
982 @code{/mnt/lilyloop} en tant que JAIL et @code{/lilyhome} en tant que
985 @item Création d'une arborescence, dans l'espace protégé, et recopie de
986 tous les fichiers nécessaires -- voir le script plus loin.
988 Le recours à l'utilitaire @code{sed} permet de créer les commandes de
989 copie de tout ce qui est nécessaire à un exécutable :
992 for i in "/usr/local/lilypond/usr/bin/lilypond" "/bin/sh" "/usr/bin/; \
993 do ldd $i | sed 's/.*=> \/\(.*\/\)\([^(]*\).*/mkdir -p \1 \&\& \
994 cp -L \/\1\2 \1\2/' | sed 's/\t\/\(.*\/\)\(.*\) (.*)$/mkdir -p \
995 \1 \&\& cp -L \/\1\2 \1\2/' | sed '/.*=>.*/d'; done
1000 @subheading Exemple de script fonctionnel en 32-bit sur Ubuntu 8.04
1004 ## les réglages par défaut
1008 loopdevice=/dev/loop0
1009 jaildir=/mnt/lilyloop
1010 # le préfixe (sans slash au début !)
1011 lilyprefix=usr/local
1012 # le répertoire du système où lilypond est installé
1013 lilydir=/$lilyprefix/lilypond/
1015 userhome=$home/$username
1016 loopfile=$userhome/loopfile
1018 dd if=/dev/zero of=$loopfile bs=1k count=200000
1020 losetup $loopdevice $loopfile
1021 mkfs -t ext3 $loopdevice 200000
1022 mount -t ext3 $loopdevice $jaildir
1023 mkdir $jaildir/lilyhome
1024 chown $username $jaildir/lilyhome
1027 mkdir -p bin usr/bin usr/share usr/lib usr/share/fonts $lilyprefix tmp
1030 cp -r -L $lilydir $lilyprefix
1031 cp -L /bin/sh /bin/rm bin
1032 cp -L /usr/bin/convert /usr/bin/gs usr/bin
1033 cp -L /usr/share/fonts/truetype usr/share/fonts
1035 # la formule magique de recopie des bibliothèques
1036 for i in "$lilydir/usr/bin/lilypond" "$lilydir/usr/bin/guile" "/bin/sh" \
1037 "/bin/rm" "/usr/bin/gs" "/usr/bin/convert"; do ldd $i | sed 's/.*=> \
1038 \/\(.*\/\)\([^(]*\).*/mkdir -p \1 \&\& cp -L \/\1\2 \1\2/' | sed \
1039 's/\t\/\(.*\/\)\(.*\) (.*)$/mkdir -p \1 \&\& cp -L \/\1\2 \1\2/' \
1040 | sed '/.*=>.*/d'; done | sh -s
1042 # les fichiers partagés pour ghostscript...
1043 cp -L -r /usr/share/ghostscript usr/share
1044 # les fichiers partagés pour ImageMagick
1045 cp -L -r /usr/lib/ImageMagick* usr/lib
1047 ### Partant du principe que test.ly est dans /mnt/lilyloop/lilyhome,
1048 ### on devrait pouvoir lancer :
1049 ### Attention : /$lilyprefix/bin/lilypond est un script qui
1050 ### définit LD_LIBRARY_PATH - c'est primordial
1051 /$lilyprefix/bin/lilypond -jlily,lily,/mnt/lilyloop,/lilyhome test.ly
1055 @node Messages d'erreur
1056 @section Messages d'erreur
1057 @translationof Error messages
1059 @cindex erreur, messages
1061 Différents messages d'erreur sont susceptibles d'apparaître au cours de
1062 la compilation d'un fichier :
1066 @item Warning -- Avertissement
1068 @cindex avertissement
1069 Ce type de message est émis lorsque LilyPond détecte quelque chose de
1070 suspect. Si vous avez demandé quelque chose qui sort de l'ordinaire,
1071 vous saurez probablement ce à quoi il est fait référence et ignorerez de
1072 tels messages sans remord. Néanmoins, les messages d'avertissement
1073 indiquent la plupart du temps une incohérence dans le fichier source.
1075 @item Error -- Erreur
1077 LilyPond a détecté une erreur. L'étape en cours, qu'il s'agisse de
1078 l'analyse, de l'interprétation des données ou bien du formatage, sera
1079 menée à son terme, puis LilyPond s'arrêtera.
1081 @item Fatal error -- Erreur fatale
1083 LilyPond est confronté à une anomalie bloquante. Ceci ne se produit que
1084 très rarement, et la plupart du temps en raison d'une installation
1085 défectueuse des fontes.
1087 @item Scheme error -- Erreur Scheme
1088 @cindex trace, Scheme
1090 @cindex Scheme error
1091 Les erreurs qui interviennent lors de l'exécution de code Scheme sont
1092 gérées par l'interpréteur Scheme. L'utilisation du mode verbeux
1093 (options @option{-V} ou @option{--verbose}) vous permettra de localiser
1094 l'appel de fonction délictueux.
1096 @item Programming error -- Erreur de programmation
1097 @cindex Programming error
1098 @cindex Erreur de programmation
1099 LilyPond est confronté à une incohérence interne. Ce type de message
1100 est destiné à venir en aide aux développeurs et débogueurs. En règle
1101 générale, vous pouvez tout simplement les ignorer. Parfois, il y en a
1102 tant qu'ils masquent ce qui pourrait vous intéresser@dots{}
1104 @item Aborted (core dumped) -- Abandon
1105 @cindex Aborted (core dumped)
1106 Ce type de message indique que LilyPond a planté en raison d'une grave
1107 erreur de programmation. La survenance d'un tel message est considérée
1108 comme de la plus haute importance. Si vous y étiez confronté,
1109 transmettez un rapport de bogue.
1112 @cindex errors, message format
1113 Lorsque l'avertissement ou l'erreur est directement lié au fichier
1114 source, le message est libellé sous la forme
1117 @var{fichier}:@var{ligne}:@var{colonne}: @var{message}
1118 @var{contenu de la ligne litigieuse}
1121 Un saut de ligne est placé dans la ligne de code, indiquant l'endroit
1122 précis du problème, comme ici :
1125 test.ly:2:19: erreur: n'est pas une durée: 5
1130 Notez que ces coordonnées constituent l'approximation au mieux par
1131 LilyPond dans le code ayant déclenché l'avertissement ou l'erreur. En
1132 règle générale, erreurs et avertissements surviennent lorsque LilyPond
1133 rencontre quelque chose d'inattendu. Lorsque la ligne indiquée ne vous
1134 semble pas comporter d'élément litigieux, remontez de quelques lignes
1137 Par ailleurs, des diagnostics peuvent être déclenchés à n'importe quel
1138 moment au cours des différentes étapes du traitement. Par exemple,
1139 lorsque certaines parties de la source sont traitées plusieurs fois --
1140 sortie MIDI et sortie imprimable -- ou qu'une même variable musicale est
1141 utilisée dans plusieurs contextes, peut apparaître le même message à
1142 plusieurs reprises. Les diagnostics effectués à une étape avancée du
1143 traitement, tels que les contrôles de mesure, sont aussi susceptibles
1144 d'apparaître plusieurs fois.
1146 Vous trouverez d'autres informations sur les erreurs au chapitre
1147 @ref{Quelques erreurs des plus courantes}.
1150 @node Quelques erreurs des plus courantes
1151 @section Quelques erreurs des plus courantes
1152 @translationof Common errors
1154 Les conditions amenant aux erreurs qui suivent sont fréquentes, bien
1155 qu'elles ne soient pas évidentes ni facilement localisables. Nous
1156 espérons que ces explications vous aideront à les résoudre plus
1160 * La musique déborde de la page::
1161 * Apparition d'une portée supplémentaire::
1162 * Message d'erreur Unbound variable %::
1163 * Message d'erreur FT_Get_Glyph_Name::
1164 * staff-affinities devraient aller en ordre décroissant::
1165 * Message d'erreur unexpected new::
1166 * Cette voix requiert un voiceXx ou un réglage shiftXx::
1170 @node La musique déborde de la page
1171 @unnumberedsubsec La musique déborde de la page
1172 @translationof Music runs off the page
1174 Lorsque la musique s'épanche au delà de la marge droite ou bien semble
1175 anormalement comprimée, la raison en est le plus souvent une note à la
1176 durée erronée ; cela finit par provoquer le débordement de la
1177 dernière note d'une mesure. Rien ne s'oppose à ce que la dernière note
1178 d'une mesure ne s'arrête avant la barre de mesure ; on considère
1179 simplement qu'elle se prolonge sur la mesure suivante. Des débordements
1180 à répétition finissent par générer une musique comprimée ou qui sort de
1181 la page, pour la simple et bonne raison que les sauts de ligne
1182 automatiques ne peuvent intervenir qu'à la fin d'une mesure complète,
1183 autrement dit lorsque toutes les notes sont terminées avant la fin de la
1186 @warning{Une durée erronée peut empêcher les sauts de ligne, ce qui
1187 conduit à une musique compressée, voire à un débordement de la page.}
1189 Une erreur de durée sera bien plus facilement localisable si vous
1190 positionnez régulièrement des contrôles de barre de mesure -- voir
1191 @ruser{Vérification des limites et numéros de mesure}.
1193 Si vous tenez absolument à enchaîner de tels débordements, vous devrez
1194 insérer des barres de mesure invisibles là où vous souhaitez positionner
1195 un saut de ligne. Consultez le chapitre @ruser{Barres de mesure} pour
1199 @node Apparition d'une portée supplémentaire
1200 @unnumberedsubsec Apparition d'une portée supplémentaire
1201 @translationof An extra staff appears
1203 Lorsque les contextes ne sont pas créés explicitement par la commande
1204 @code{\new}, ils le seront si la commande à exécuter n'est pas censée
1205 s'appliquer au contexte en cours. Pour des partitions simples, le fait
1206 que les contextes soient automatiquement créés rend bien des services,
1207 et c'est d'ailleurs le cas pour la majorité des exemples contenus dans
1208 les manuels de LilyPond. Cependant, la création implicite d'un contexte
1209 peut aboutir à l'apparition d'une portée « parasite ». On s'attend par
1210 exemple, en lisant le code qui suit, à ce que toutes les têtes de note
1211 soient en rouge, alors que le résultat nous présente deux portées et que
1212 les notes, placées sur la portée inférieure, restent en noir.
1214 @lilypond[quote,verbatim,fragment]
1215 \override Staff.NoteHead.color = #red
1219 Étant donné qu'aucun contexte @code{Staff} n'existe lorsque la
1220 dérogation est introduite, LilyPond le crée implicitement pour lui
1221 appliquer la directive considérée. Survient alors la commande
1222 @code{\new Staff} qui, à son tour, crée une nouvelle portée pour
1223 contenir les notes qui suivent. Voici la syntaxe correcte pour obtenir
1224 ces notes en rouge :
1226 @lilypond[quote,verbatim]
1228 \override Staff.NoteHead.color = #red
1234 @node Message d'erreur Unbound variable %
1235 @unnumberedsubsec Message d'erreur @code{Unbound variable %}
1236 @translationof Error message Unbound variable %
1238 Ce message d'erreur, qu'il apparaisse sur le terminal ou en fin de
1239 fichier journal, est associé à un message du type « GUILE a signalé
1240 une erreur@dots{} ». Il survient à chaque fois qu'un commentaire
1241 @emph{LilyPond} est indûment placé dans une routine @emph{Scheme}.
1243 Un commentaire LilyPond est introduit par le signe pourcent (@code{%})
1244 et ne doit en aucun cas se trouver dans une routine Scheme. En Scheme,
1245 les commentaires s'introduisent par un point-virgule (@code{;}).
1248 @node Message d'erreur FT_Get_Glyph_Name
1249 @unnumberedsubsec Message d'erreur @code{FT_Get_Glyph_Name}
1250 @translationof Error message FT_Get_Glyph_Name
1252 Ce message d'erreur, qu'il apparaisse sur le terminal ou en fin de
1253 fichier journal, survient lorsqu'un fichier source contient des
1254 caractères non ASCII et qu'il n'a pas été enregistré avec un encodage
1255 UTF-8. Pour plus de détails, reportez-vous au chapitre
1256 @ruser{Caractères spéciaux}.
1259 @node staff-affinities devraient aller en ordre décroissant
1260 @unnumberedsubsec @emph{staff-affinities} devraient aller en ordre décroissant
1261 @translationof Warning staff affinities should only decrease
1263 Cet avertissement est émis lorsque la partition ne comporte pas de
1264 portée, comme par exemple une feuille de chant avec un contexte
1265 @code{ChordName} et un contexte @code{Lyrics}. Ce message disparaîtra
1266 dès lors que vous autoriserez l'un de ces contextes à se comporter comme
1267 une portée, à l'aide de l'instruction
1270 \override VerticalAxisGroup.staff-affinity = ##f
1274 que vous insérerez dès sa création. Pour plus d'information,
1275 reportez-vous à la rubrique
1276 @ruser{Espacement des lignes rattachées à des portées}.
1279 @node Message d'erreur unexpected new
1280 @unnumberedsubsec Message d'erreur unexpected @code{@bs{}new}
1281 @translationof Error message unexpected new
1283 Un bloc @code{\score} ne peut contenir qu'@strong{une seule} expression
1284 musicale. Si, par contre, il comporte plusieurs @code{\new Staff},
1285 @code{\new StaffGroup} ou autres contextes introduits par une commande
1286 @code{\new} qui ne seraient pas bornés par des accolades
1287 @code{@{ @dots{} @}} ou des doubles chevrons @code{<< @dots{} >>} comme
1292 % Invalide ! Génère l'erreur : syntax error, unexpected \new
1293 % en français : erreur de syntaxe : \new inattendu
1294 \new Staff @{ @dots{} @}
1295 \new Staff @{ @dots{} @}
1300 vous obtiendrez ce message d'erreur.
1302 Cette erreur sera évitée dès lors que toutes les instances de
1303 @code{\new} sont bornées par des accolades ou des doubles chevrons.
1305 Des accolades placeront ces clauses @code{\new} en séquence :
1307 @lilypond[quote,verbatim]
1310 \new Staff { a' a' a' a' }
1311 \new Staff { g' g' g' g' }
1317 alors que des doubles chevrons les placeront en parallèle ; autrement
1318 dit, LilyPond les traitera simultanément :
1320 @lilypond[quote,verbatim]
1323 \new Staff { a' a' a' a' }
1324 \new Staff { g' g' g' g' }
1330 @node Cette voix requiert un voiceXx ou un réglage shiftXx
1331 @unnumberedsubsec Cette voix requiert un @code{@bs{}voiceXx} ou un réglage @code{@bs{}shiftXx}
1332 @translationof Warning this voice needs a voiceXx or shiftXx setting
1334 Lorsque des notes affectées à des voix différentes et ayant la même
1335 orientation de hampe interviennent au même instant musical et qu'aucun
1336 décalage spécifique à la voix n'a été spécifié, LilyPond émet
1337 @code{Avertissement : Cette voix requiert un voiceXx ou un réglage
1338 shiftXx} (@emph{warning: this voice needs a \voiceXx or \shiftXx
1339 setting}). Cet avertissement est émis même lorsque ces notes n'ont pas
1340 de hampe visible, comme par exemple des rondes, si les hampes des durées
1341 inférieures à ces même hauteurs avaient la même orientation.
1343 N'oublions pas que l'orientation des hampes dépend de la position des
1344 notes sur la portée à moins que cette orientation n'ait été spécifiée,
1345 par exemple à l'aide d'un @code{\voiceOne} ou autre clause. En pareil
1346 cas, l'avertissement ne sera émis que lorsque les hampes auront la même
1347 orientation, autrement dit lorsque les notes seront dans la même moitié
1350 Le fait de placer les notes dans des voix auxquelles sont attachés
1351 orientation de hampe et décalage, comme @code{\voiceOne} ou autre, peut
1352 permettre d'éviter ces avertissements.
1354 Les notes se trouvant dans des voix au numéro plus élévé --
1355 @code{\voiceThree} ou @code{\voiceFour} -- sont automatiquement décalées
1356 pour éviter que les empilements se chevauchent. Ceci aura pour résultat
1357 de visuellement décaler les notes affublées de hampe sans toutefois
1358 bouger les rondes, hormis dans le cas d'un réel chevauchement ou lorsque
1359 ces voix se croisent (@code{\voiceThree} au dessus de@code{\voiceOne}).
1362 Manuel d'initiation :
1363 @rlearning{Instanciation explicite des voix},
1364 @rlearning{Exemple concret}.
1366 Manuel de notation :
1367 @ruser{Polyphonie sur une portée},
1368 @ruser{Résolution des collisions}.