@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
-
@ignore
- Translation of GIT committish: 79165c00e7aadfefb0748ff55b29a1927cb87acd
+ Translation of GIT committish: c610645cc9a77cba1a2798280965db142d649ac5
When revising a translation, copy the HEAD committish of the
version that you are working on. For details, see the Contributors'
Guide, node Updating translation committishes..
@end ignore
-@c \version "2.14.0"
+@c \version "2.16.0"
@c Translators: Jean-Charles Malahieude
@c Translation checkers:
-@node Exécution de LilyPond
+@node Exécution de lilypond
@chapter Exécution de @command{lilypond}
@translationof Running lilyPond
@menu
* Lancement de lilypond::
-* Options en ligne de commande pour lilypond::
+* Options basiques de lilypond::
+* Options avancées de lilypond::
* Variables d'environnement::
* Exécution de LilyPond en mode protégé::
@end menu
qui n'ont rien à voir avec LilyPond.
-@node Options en ligne de commande pour lilypond
-@unnumberedsubsec Options en ligne de commande pour @command{lilypond}
-@translationof Command line options for lilypond
+@node Options basiques de lilypond
+@unnumberedsubsec Options basiques de @command{lilypond}
+@translationof Basic command line options for LilyPond
@cindex lancement de @command{lilypond}
@cindex ligne de commande, options pour @command{lilypond}
@cindex switches
@cindex commutateurs
-Voici les différentes options disponibles à la ligne de commande@tie{}:
+Différentes options sont disponibles en ligne de commande@tie{}:
@table @code
+@item -d,--define-default=@var{variable}=@var{valeur}
+Voir @ref{Options avancées de lilypond}.
+
+@cindex Scheme, évaluation d'expression
+@cindex expression Scheme, évaluation
@item -e,--evaluate=@var{expr}
Évalue l'expression Scheme @var{expr} avant d'analyser tout fichier
-@file{.ly}. Lorsque vous spécifiez l'option @code{-e} à plusieurs
+@file{.ly}. Lorsque vous spécifiez l'option @option{-e} à plusieurs
reprises, l'évaluation sera faite en séquence.
Dans la mesure où l'expression est évaluée par le module
@noindent
en tête de votre fichier @file{.ly}.
+@warning{Les utilisateurs de Windows doivent utiliser des guillemets
+doubles @code{"} en lieu et place des guillemets simples @code{'}.}
+@c Match " in context-sensitive editors
+@cindex sortie, format
+@cindex format de sortie
@item -f,--format=@var{format}
Détermine le format à produire. Il peut s'agir de @code{ps}, @code{pdf}
ou @code{png}.
Exemple : @code{lilypond -fpng @var{monfichier}.ly}
-
-@item -d,--define-default=@var{var}=@var{val}
-Affecte la valeur Scheme @var{val} à l'option interne @var{var} du
-programme. En l'absence de @var{val}, le programme utilisera @var{#t}.
-Préfixer @var{var} d'un @code{no-} vous permet de désactiver une option.
-Ainsi,
-
-@cindex point and click, ligne de commande
-
-@example
--dno-point-and-click
-@end example
-
-@noindent
-revient au même que
-@example
--dpoint-and-click='#f'
-@end example
-
-
-Voici quelques options des plus intéressantes.
-
-@cindex help, ligne de commande
-
-@table @samp
-@item help
-Lancer @code{lilypond -dhelp} affichera la liste de toutes les options
-@code{-d} disponibles.
-
-
-@cindex paper-size, ligne de commande
-
-@item paper-size
-Détermine la taille par défaut du papier, par exemple
-@example
--dpaper-size=\"letter\"
-@end example
-
-@noindent
-Veillez à ne pas oublier d'encadrer la valeur par des guillemets
-échappés ( @code{\"} ).
-@c Match " in previous line to help context-sensitive editors
-
-
-@cindex safe, ligne de commande
-
-@item safe
-Ne pas avoir une confiance aveugle dans le code @file{.ly}.
-
-Lorsque LilyPond est accessible au travers d'un serveur web, il est
-@strong{impératif} d'utiliser les options @code{--safe} ou
-@code{--jail}. L'option @code{--safe} aura pour effet d'empêcher tout
-code Scheme inclus de mettre en péril votre installation grâce à quelque
-chose du style
-
-@quotation
-@verbatim
-#(system "rm -rf /")
-{
- c4^#(ly:export (ly:gulp-file "/etc/passwd"))
-}
-@end verbatim
-@end quotation
-
-L'option @code{-dsafe} forcera l'évaluation, au fil de l'eau et par un
-module sécurisé, des expressions Scheme contenues dans le fichier
-source. Ce module sécuritaire, dérivé du module GUILE @file{safe-r5rs},
-ajoute un certain nombre de fonctions -- listées dans
-@file{scm/safe-lily.scm} -- à l'API de LilyPond.
-
-De plus, le mode @emph{safe} ne permet ni l'utilisation de directives
-@code{\include} ni le recours aux obliques inversées (@emph{backslash})
-dans les chaînes @TeX{}.
-
-L'import de variables LilyPond dans du code Scheme n'est pas possible
-en mode sécuritaire.
-
-L'option @code{-dsafe} @strong{ne détecte pas} l'utilisation abusive des
-ressources. Il est donc possible que le programme finisse par rester
-sans réponse si on lui envoie une boucle sans fin. C'est la raison pour
-laquelle nous recommandons, lorsque LilyPond tourne sur un serveur
-accessible au public, d'en limiter aussi bien les ressources processeur
-que mémoire.
-
-Notez bien que l'utilisation du mode sécuritaire empêchera aussi la
-compilation d'un certain nombre de fragments LilyPond. L'option
-@code{--jail} est dans ce cas une excellente alternative en terme de
-sécurité, même si elle requiert plus de temps à mettre en place.
-
-
-@cindex format de sortie, définition
-
-@item backend
-Détermine le format de sortie à utiliser par le moteur de traitement.
-Les types de @code{format} reconnus sont
-@table @code
-@item ps
-@cindex PostScript output
- pour du PostScript.
-
-Les fichiers PostScript incluent les polices TTF, Type1 et OTF, et
-aucune substitution ne sera opérée pour ces fontes. Si vous utilisez
-des caractères orientaux, le fichier aura vite fait d'atteindre une
-taille conséquente.
-
-
-@item eps
-@cindex Postscript encapsulé
-@cindex EPS (Encapsulated PostScript)
- pour du PostScript encapsulé.
-
-Chaque page (système) fera l'objet d'un fichier @file{EPS} particulier,
-sans fontes, auquel sera associé un fichier @file{EPS} qui, lui,
-contiendra toutes les pages (systèmes) et les fontes.
-
-Notez qu'il s'agit du mode que @command{lilypond-book} utilise par défaut.
-
-@item svg
-@cindex SVG (Scalable Vector Graphics)
- pour du SVG (@emph{Scalable Vector Graphics}).
-
-Cette option permet de créer un fichier SVG par page, sans incorporation
-des fontes. Nous vous recommandons d'installer les fontes Century
-Schoolbook comprises dans le paquetage LilyPond afin d'obtenir le
-meilleur rendu possible. Sous UNIX, il suffit de les recopier, à partir
-du répertoire @file{/usr/share/lilypond/VERSION/fonts/otf/}, dans
-@file{~/.fonts/}. Les fichiers SVG alors générés devraient être
-lisibles par votre éditeur SVG habituel.
-
-@item scm
-@cindex Scheme dump
- pour une recopie brute des commandes Scheme internes de formatage.
-
-@item null
- permet de ne pas générer de partition imprimable. Cette option est
- équivalente à @code{-dno-print-pages}.
-
-@end table
-
-Exemple : @code{lilypond -dbackend=svg @var{monfichier}.ly}
-
-
-@item preview
-@cindex preview, ligne de commande
-Génère un fichier comprenant le titrage et le premier système. S'il
-existe plusieurs sections @code{\bookpart}, ce fichier contiendra les
-titrage et premier système de chacun des @code{\bookpart}. Cette
-option fonctionne pour les moteurs de traitement @code{ps}, @code{eps}
-et @code{svg}.
-
-
-@item print-pages
-Génère l'intégralité des pages de la partition. L'option
-@code{-dno-print-pages} est particulièrement utile lorsqu'utilisée
-conjointement avec l'option @code{-dpreview}.
-
-@end table
-
-
-
@item -h,--help
Affiche un résumé des commandes.
-
@item -H,--header=@var{CHAMP}
Recopie le champ d'entête dans le fichier @file{RACINE.@var{CHAMP}}.
+@item -i,--init=@var{fichier}
+Définit @var{fichier} (par défaut @file{init.ly}) en tant que fichier
+d'initialisation.
-@item --include, -I=@var{répertoire}
@cindex recherche de fichier
-@cindex search path
-
+@cindex chemin de recherche
+@item -I,--include=@var{répertoire}
Ajoute @var{répertoire} au chemin de recherche pour les inclusions.
-Vous pouvez mentionner plusieurs fois l'option @code{-I}, auquel cas le
+Vous pouvez mentionner plusieurs fois l'option @option{-I}, auquel cas
la recherche commencera dans le premier répertoire inclus et, si le
fichier en question ne s'y trouve pas, les répertoires suivants seront
examinés l'un après l'autre.
-
-@item -i,--init=@var{fichier}
-Définit @var{fichier} (par défaut @file{init.ly}) en tant que fichier
-d'initialisation.
-
-
-@item -o,--output=@var{FICHIER} ou @var{RÉP}
-@cindex répertoire de destination
-@cindex fichier de destination
-
-Détermine le nom par défaut du fichier résultant à @var{FICHIER}@tie{};
-lorsque l'argument @var{RÉP} correspond à un répertoire déjà existant,
-c'est là que les fichiers résultants seront déposés. Le suffixe adéquat
-sera ajouté (p.ex. @file{.pdf} pour du pdf) dans tous les cas.
-
-
-@cindex PostScript output
-
-@item --ps
-Génère du PostScript.
-
-
-@cindex Portable Network Graphics (PNG) output
-
-@item --png
-Génère une image par page, au format PNG@tie{}; ceci sous-entend
-l'utilisation de @code{--ps}. La résolution de l'image, en DPI, peut se
-régler en ajoutant par exemple
-@example
--dresolution=110
-@end example
-
-
-@cindex Portable Document Format (PDF) output
-
-@item --pdf
-Génère du PDF. Ceci sous-entend l'utilisation de @code{--ps}.
-
-
+@cindex chroot jail, fonctionnement
@item -j,--jail=@var{user},@var{group},@var{jail},@var{dir}
Lance @command{lilypond} dans un environnement protégé.
-L'option @code{--jail} est une alternative qui offre plus de flexibilité
-que l'option @code{--safe} lorsque LilyPond est installé sur un serveur
-web ou traite des fichiers externes.
+L'option @option{--jail} est une alternative qui offre plus de
+flexibilité que l'option @option{--safe} lorsque LilyPond est installé
+sur un serveur web ou traite des fichiers externes -- voir
+@ref{Options avancées de lilypond}.
-L'option @code{--jail} va détourner la racine de @command{lilypond} sur
-@code{jail} juste avant d'effectuer la compilation à proprement parler.
-L'utilisateur et le groupe sont modifiés en conséquence, et le
-répertoire en cours devient @code{dir}. Ces réglages assurent -- du
+L'option @option{--jail} va détourner la racine de @command{lilypond}
+sur @var{jail} juste avant d'effectuer la compilation à proprement
+parler. L'utilisateur et le groupe sont modifiés en conséquence, et le
+répertoire en cours devient @var{dir}. Ces réglages assurent -- du
moins en théorie -- l'impossibilité de s'échapper de la cellule. Notez
-cependant que, pour que l'option @code{--jail} soit fonctionnelle,
-@code{lilypond} doit être lancé en tant qu'administrateur -- ce qui se
-réalise aisément à l'aide de la commande @command{sudo}.
+cependant que, pour que l'option @option{--jail} soit fonctionnelle,
+@command{lilypond} doit être lancé en tant qu'administrateur -- ce qui
+se réalise aisément à l'aide de la commande @command{sudo}.
La création d'un environnement sécurisé requiert quelques précautions
dans la mesure où LilyPond doit disposer de tout ce dont il a besoin
suivantes@tie{}:
@table @asis
+
@item Création d'un système de fichiers indépendant
L'intérêt d'un système de fichiers dédié à LilyPond réside dans le fait
qu'on peut le brider à l'aide des options @code{noexec}, @code{nodev} et
@item Création d'un utilisateur spécifique
L'utilisation de LilyPond au sein de la cellule devrait être réservé à
un utilisateur aux droits restreints. Il faudra donc créer un
-utilisateur et un groupe spécifiques -- disons @code{lily}/@code{lily}
--- qui n'aura accès en écriture qu'à un unique répertoire déterminé par
-la valeur de @var{dir}.
+utilisateur et un groupe spécifiques -- disons
+@w{@code{lily}/@code{lily}} -- qui n'aura accès en écriture qu'à un
+unique répertoire déterminé par la valeur de @var{dir}.
@item Agencement des lieux
LilyPond a besoin d'un certain nombre de fichiers pour pouvoir tourner
le système d'origine. Ainsi l'intégralité de l'installation de LilyPond
(en principe @file{/usr/share/lilypond}) doit y être dupliquée.
-En cas de problème, lancer LilyPond en utilisant @code{strace} devrait
-vous permettre de déterminer quels fichiers manquent à l'appel.
+En cas de problème, lancer LilyPond en utilisant @command{strace}
+devrait vous permettre de déterminer quels fichiers manquent à l'appel.
@item Lancement de LilyPond
-Dans un environnement protégé monté avec l'option @code{noexec}, il est
-impossible de lancer un quelconque programme extérieur. LilyPond ne
+Dans un environnement protégé monté avec l'option @code{noexec}, il
+est impossible de lancer un quelconque programme extérieur. LilyPond ne
saurait donc avoir recours à un moteur de traitement qui le mettrait
dans cette situation. Comme nous l'avons vu plus haut, LilyPond sera
lancé avec les privilèges de l'administrateur -- privilèges qu'il perdra
aussitôt --, ce qui peut nécessiter le recours à la commande
@code{sudo}. Il est par ailleurs judicieux de limiter le temps
-processeur aloué à LilyPond -- grâce à @command{ulimit@tie{}-t} par
+processeur alloué à LilyPond -- grâce à @command{ulimit@tie{}-t} par
exemple -- ainsi que, si votre système le permet, la taille de la
-mémoire.
+mémoire. Voir aussi @ref{Exécution de LilyPond en mode protégé}.
@end table
+@cindex loglevel
+@cindex verbosité, définir le degré de
+@item -l,--loglevel=@var{DEGRÉ}
+Règle le niveau de verbosité des messages console à @var{DEGRÉ}. Les
+différentes valeurs sont@tie{}:
+
+@table @code
+@item NONE
+Aucun verbiage, même pas les messages d'erreur.
+
+@item ERROR
+Uniquement les messages d'erreur@tie{}; pas de message d'avertissement
+ni de progression.
+
+@item WARN
+Messages d'avertissement ou d'erreur@tie{}; pas d'information de
+progression.
+
+@item BASIC_PROGRESS
+Information de progression basique (réussite) et avertissements ou erreurs.
+
+@item PROGRESS
+Toutes les informations de progression, avertissements et erreurs.
+
+@item INFO (par défaut)
+Informations de progression, avertissements et erreurs, ainsi que
+d'autres informations quant à l'exécution.
+
+@item DEBUG
+Tout ce qui peut être affiché, y compris le verbiage utile au débogage.
+
+@end table
+
+@cindex redirection
+@cindex répertoire de destination
+@cindex fichier de destination
+@item -o,--output=@var{FICHIER} ou @var{RÉPERTOIRE}
+Détermine le nom par défaut du fichier résultant à @var{FICHIER}@tie{};
+lorsque l'argument @var{RÉPERTOIRE} correspond à un répertoire déjà
+existant, c'est là que les fichiers résultants seront déposés. Le
+suffixe adéquat sera ajouté (par ex. @code{.pdf} pour du pdf) dans tous
+les cas.
+
+@cindex PostScript, output
+@cindex PS (PostScript), output
+@item --ps
+Génère du PostScript.
+
+@cindex Portable Network Graphics (PNG), output
+@cindex PNG (Portable Network Graphics), output
+@item --png
+Génère une image par page, au format PNG@tie{}; ceci sous-entend
+l'utilisation de @option{--ps}. La résolution de l'image, en DPI, peut
+se régler en ajoutant par exemple
+@example
+-dresolution=110
+@end example
+
+@cindex Portable Document Format (PDF), output
+@cindex PDF (Portable Document Format), output
+@item --pdf
+Génère du PDF. Ceci sous-entend l'utilisation de @option{--ps}.
@item -v,--version
Affiche le numéro de version.
-
@item -V,--verbose
Active le mode verbeux@tie{}: affichage de l'intégralité du chemin
d'accès de chaque fichier, et information des temps de traitement.
-
@item -w,--warranty
-Affiche les informations de garantie appliquables à GNU LilyPond -- il
+Affiche les informations de garantie applicables à GNU LilyPond -- il
est livré @strong{SANS GARANTIE}@tie{}!
+
@end table
+@node Options avancées de lilypond
+@unnumberedsubsec Options avancées de @command{lilypond}
+@translationof Advanced command line options for LilyPond
+
+@table @code
+
+@item -d@var{[nom-option]}=@var{[valeur]},--define-default=@var{[nom-option]}=@var{[valeur]}
+Affecte la valeur Scheme @var{valeur} à l'option interne @var{nom-option} du
+programme. En l'absence de @var{valeur}, le programme utilisera @var{#t}.
+Préfixer @var{nom-option} d'un @code{no-} vous permet de désactiver une option.
+Ainsi,
+
+@cindex point and click, ligne de commande
+@cindex pointer-cliquer, ligne de commande
+
+@example
+-dno-point-and-click
+@end example
+
+@noindent
+revient au même que
+@example
+-dpoint-and-click=#f
+@end example
+@end table
+
+@noindent Voici les différentes options disponibles, ainsi que leur
+valeur par défaut.
+
+@multitable @columnfractions .33 .16 .51
+@item @strong{Symbole}
+@tab @strong{Valeur}
+@tab @strong{Observations}
+
+
+@item @code{anti-alias-factor}
+@tab @code{1}
+@tab Adopte une résolution supérieure (selon le facteur donné),puis
+réduit au niveau du résultat afin d'éviter les @qq{distorsions} des
+images @code{PNG}.
+
+@item @code{aux-files}
+@tab @code{#t}
+@tab Génère les fichiers @code{.tex}, @code{.texi} et @code{.count}
+pour le moteur de rendu @code{EPS}.
+
+@item @code{backend}
+@tab @code{'ps}
+@tab Détermine le format de sortie à utiliser par le moteur de
+traitement. Les fichiers PostScript (format par défaut) incluent les
+fontes @code{TTF}, @code{Type1} et @code{OTF}, et aucune substitution ne
+sera opérée pour ces fontes. Si vous utilisez des jeux de caractères
+orientaux, le fichier aura vite fait d'atteindre une taille conséquente.
+
+@item
+@tab @code{'eps}
+@tab Génère du PostScript encapsulé. Chaque page (système) fera l'objet
+d'un fichier @file{EPS} particulier, sans fontes, auquel sera associé un
+fichier @file{EPS} qui, lui, contiendra toutes les pages (systèmes) et
+les fontes. Notez qu'il s'agit du mode que @command{lilypond-book}
+utilise par défaut.
+
+@item
+@tab @code{'null}
+@tab Ne génère aucun fichier imprimable. Cette option est équivalente à
+@code{-dno-print-pages}.
+
+@item
+@tab @code{'svg}
+@tab Génère du@emph{Scalable Vector Graphics}. Cette option permet de
+créer un fichier @code{SVG} par page, sans incorporation des fontes.
+Nous vous recommandons d'installer les fontes Century Schoolbook
+comprises dans le paquetage LilyPond afin d'obtenir le meilleur rendu
+possible. Sous UNIX, il suffit de les recopier, à partir du répertoire
+@file{/usr/share/lilypond/VERSION/fonts/otf/}, dans @file{~/.fonts/}.
+Les fichiers @code{SVG} alors générés devraient être lisibles par votre
+éditeur SVG habituel. L'option @code{svg-woff} -- voir ci-après --
+permet d'utiliser les fontes @code{woff} avec le moteur @code{SVG}.
+
+@item
+@tab @code{'scm}
+@tab Recopie littéralement les commandes Scheme internes de formatage.
+
+@item @code{check-internal-types}
+@tab @code{#f}
+@tab Vérifie qu'à chaque propriété est bien affecté un type.
+
+@item @code{clip-systems}
+@tab @code{#f}
+@tab Génère des typons à partir d'une partition.
+
+@item @code{datadir}
+@tab
+@tab Détermine le préfixe des fichiers de données (lecture seule).
+
+@item @code{debug-gc}
+@tab @code{#f}
+@tab Génère une copie brute de la mémoire, aux fins de débogage.
+
+@item @code{debug-gc-assert-parsed-dead}
+@tab @code{#f}
+@tab Pour débogage de la mémoire@tie{}: s'assure que toute référence à
+des objets analysés est effacée. Il s'agit d'une option interne qui
+est automatiquement activée par l'option @code{`-ddebug-gc'}.
+
+@item @code{debug-lexer}
+@tab @code{#f}
+@tab Débogage de l'analyseur lexical @emph{flex}.
+
+@item @code{debug-page-breaking-scoring}
+@tab @code{#f}
+@tab Purge les calculs des configurations de saut de page.
+
+@item @code{debug-parser}
+@tab @code{#f}
+@tab Débogage de l'analyseur @emph{bison}.
+
+@item @code{debug-property-callbacks}
+@tab @code{#f}
+@tab Débogage des chaînes de @emph{callback} cycliques.
+
+@item @code{debug-skylines}
+@tab @code{#f}
+@tab Débogage des lignes d'horizon.
+
+@item @code{delete-intermediate-files}
+@tab @code{#t}
+@tab Supprime les fichiers @code{.ps} inutiles crées lors de la
+compilation.
+
+@item @code{dump-cpu-profile}
+@tab @code{#f}
+@tab Génère une copie brute des informations de timing (dépend du
+système).
+
+@item @code{dump-profile}
+@tab @code{#f}
+@tab Génère une copie brute de la mémoire et des temps de traitement
+pour chaque fichier.
+
+@item @code{dump-signatures}
+@tab @code{#f}
+@tab Génère une copie des signatures de chaque système. Cette option
+est utilisée pour les tests de régression.
+
+@item @code{eps-box-padding}
+@tab @code{#f}
+@tab Décale le bord gauche du typon EPS d'une valeur donnée en
+millimètres.
+
+@item @code{gs-load-fonts}
+@tab @code{#f}
+@tab Charge les fontes grâce à Ghostscript.
+
+@item @code{gs-load-lily-fonts}
+@tab @code{#f}
+@tab Limites les fontes chargées par Ghostscript aux seules fontes
+LilyPond.
+
+@item @code{gui}
+@tab @code{#f}
+@tab Travaille silencieusement, et redirige tout le verbiage dans un
+fichier journal.
+@end multitable
+
+@noindent
+@strong{Note à l'attention des utilisateurs de Windows@tie{}:} toutes
+les informations concernant le traitement apparaissent au fur et à
+mesure dans l'interpréteur de commandes lorsque vous lancez le programme
+@code{lilypond.exe}, à l'inverse de @w{@code{lilypond-windows.exe}} qui
+vous renvoie simplement la main. L'option @option{-dgui} vous permettra
+alors de rediriger ces informations dans un fichier journal.
+
+@multitable @columnfractions .33 .16 .51
+@item @code{help}
+@tab @code{#f}
+@tab Affiche cette aide.
+
+@item @code{include-book-title-preview}
+@tab @code{#t}
+@tab Inclut les titres de l'ouvrage dans les images de prévisualisation.
+
+@item @code{include-eps-fonts}
+@tab @code{#t}
+@tab Inclut les fontes dans chaque fichier EPS contenant un système.
+
+@item @code{include-settings}
+@tab @code{#f}
+@tab Inclut un fichier contenant les réglages globaux. Ce fichier sera
+inclus avant traitement de la partition.
+
+@item @code{job-count}
+@tab @code{#f}
+@tab Traite plusieurs fichiers en parallèle, selon le nombre de
+@emph{jobs}.
+
+@item @code{log-file}
+@tab @code{#f [fichier]}
+@tab Fournir @code{TOTO} en second argument redirigera la sortie dans le
+fichier journal @code{TOTO.log}.
+
+@item @code{max-markup-depth}
+@tab @code{1024}
+@tab Profondeur maximale de l'arborescence de @emph{markups}. Si un
+@emph{markup} était plus profond, part du principe qu'on aboutira pas,
+émet un avertissement et renvoie alors un @emph{markup} vide.
+
+@item @code{midi-extension}
+@tab @code{"midi"}
+@tab Détermine l'extension par défaut des fichiers MIDI, selon la chaîne
+donnée en argument.
+
+@item @code{music-strings-to-paths}
+@tab @code{#f}
+@tab Convertit les chaînes textuelles en chemins lorsque les glyphes
+font partie d'une fonte musicale.
+
+@item @code{old-relative}
+@tab @code{#f}
+@tab Affecte au mode @code{\relative} le même comportement pour de la
+musique simultanée que celui d'une syntaxe d'accords.
+
+@cindex paper-size, ligne de commande
+@item @code{paper-size}
+@tab @code{\"a4\"}
+@tab Détermine la taille par défaut du papier. Veillez à ne pas oublier
+d'encadrer la valeur par des guillemets échappés (@code{\"}).
+@c Match " in context-sensitive editors
+
+@item @code{pixmap-format}
+@tab @code{png16m}
+@tab Détermine le format de sortie en images pixélisées pour
+Ghostscript.
+
+@item @code{point-and-click}
+@tab @code{#f}
+@tab Ajoute les liens @qq{point & click} à la sortie @code{PDF}. Voir
+@ref{Pointer-cliquer}.
+
+@cindex format de sortie, définition
+@cindex preview, ligne de commande
+@item @code{preview}
+@tab @code{#f}
+@tab Génère une prévisualisation en plus de la sortie normale.
+@end multitable
+
+@noindent
+Cette option, disponible dans tous les formats de sortie imprimables --
+@code{pdf}, @code{png}, @code{ps}, @code{eps} et @code{svg} -- génère
+un fichier de la forme @code{monFichier.preview.extension} comprenant le
+titrage et le premier système. S'il existe plusieurs sections
+@code{\book}, @code{\bookpart}, ce fichier contiendra les titrage et
+premier système de chacun des @code{\book}, @code{\bookpart} et
+@code{\score}, dès lors que la variable @code{print-all-headers} du bloc
+@code{\paper} est activée.
+
+Pour l'éviter, utilisez conjointement l'une des options
+@option{-dprint-pages} ou @option{-dno-print-pages} selon vos besoins.
+
+@multitable @columnfractions .33 .16 .51
+@item @code{print-pages}
+@tab @code{#t}
+@tab Génère l'intégralité des pages de la partition. L'option
+@option{-dno-print-pages} est particulièrement utile lorsqu'utilisée
+conjointement avec l'option @option{-dpreview}.
+
+@item @code{profile-property-accesses}
+@tab @code{#f}
+@tab Enregistre des statistiques des appels à la fonction
+@code{get_property()}.
+
+@item @code{protected-scheme-parsing}
+@tab @code{#t}
+@tab Continue en dépit des erreurs que l'analyseur syntaxique
+détecterait dans du code Scheme inclus. Lorsque basculé sur @code{#f},
+stoppe le traitement s'il y a erreur et affiche une trace de la pile.
+
+@item @code{read-file-list}
+@tab @code{#f [fichier]}
+@tab Spécifie un fichier listant les différents fichier sources à
+traiter.
+
+@item @code{relative-includes}
+@tab @code{#f}
+@tab Face à une instruction @code{\include}, recherche les fichiers à
+inclure relativement à l'endroit où se trouve le fichier en cours de
+traitement plutôt que par rapport au fichier maître.
+
+@item @code{resolution}
+@tab @code{101}
+@tab Détermine, en @code{dpi}, la résolution des pixmaps @code{PNG} à
+générer selon la valeur donnée.
+
+@item @code{safe}
+@tab @code{#f}
+@tab Ne pas avoir une confiance aveugle dans le code @file{.ly}.
+@end multitable
+
+@noindent
+Lorsque LilyPond est accessible au travers d'un serveur web, il est
+@strong{impératif} d'utiliser les options @option{--safe} ou
+@option{--jail}. L'option @option{--safe} aura pour effet d'empêcher
+tout code Scheme inclus de mettre en péril votre installation grâce à
+quelque chose du style
+
+@quotation
+@verbatim
+#(system "rm -rf /")
+{
+ c4^$(ly:gulp-file "/etc/passwd")
+}
+@end verbatim
+@end quotation
+
+L'option @code{-dsafe} forcera l'évaluation, au fil de l'eau et par un
+module sécurisé, des expressions Scheme contenues dans le fichier
+source. Ce module sécuritaire, dérivé du module GUILE @file{safe-r5rs},
+ajoute un certain nombre de fonctions -- listées dans
+@file{scm/safe-lily.scm} -- à l'API de LilyPond.
+
+De plus, le mode @emph{safe} ne permet ni l'utilisation de directives
+@code{\include} ni le recours aux obliques inversées (@emph{backslash})
+dans les chaînes @TeX{}. L'import de variables LilyPond dans du code
+Scheme n'est pas possible en mode sécuritaire.
+
+L'option @code{-dsafe} @strong{ne détecte pas} l'utilisation abusive des
+ressources. Il est donc possible que le programme finisse par rester
+sans réponse si on lui envoie une boucle sans fin. C'est la raison pour
+laquelle nous recommandons, lorsque LilyPond tourne sur un serveur
+accessible au public, d'en limiter aussi bien les ressources processeur
+que mémoire.
+
+Notez bien que l'utilisation du mode sécuritaire empêchera aussi la
+compilation d'un certain nombre de fragments LilyPond. L'option
+@code{--jail} est dans ce cas une excellente alternative en terme de
+sécurité, même si elle requiert plus de temps à mettre en place -- voir
+@ref{Options basiques de lilypond}.
+
+@multitable @columnfractions .33 .16 .51
+@item @code{separate-log-files}
+@tab @code{#f}
+@tab Pour les fichiers @code{FICHIER1.ly}, @code{FICHIER2.ly} etc.
+enregistre le déroulement dans les journaux @code{FICHIER1.log},
+@code{FICHIER2.log}@dots{}
+
+@item @code{show-available-fonts}
+@tab @code{#f}
+@tab Liste le nom des fontes disponibles.
+
+@item @code{strict-infinity-checking}
+@tab @code{#f}
+@tab Force le crash en présence des points d'exception de virgule
+flottante @code{Inf} ou @code{NaN} -- infini ou non-nombre.
+
+@item @code{strip-output-dir}
+@tab @code{#t}
+@tab Supprime, lors du nommage des fichiers résultant, la partie
+correspondant au répertoire des fichiers sources.
+
+@item @code{svg-woff}
+@tab @code{#f}
+@tab Utilise, avec le moteur SVG, les fontes @code{woff}.
+
+@item @code{trace-memory-frequency}
+@tab @code{#f}
+@tab Enregistre l'utilisation de la cellule Scheme plusieurs fois par
+seconde, dans les fichiers @code{FICHIER.stacks} et
+@code{FICHIER.graph}.
+
+@item @code{trace-scheme-coverage}
+@tab @code{#f}
+@tab Enregistre la couverture des fichiers Scheme dans @code{FILE.cov}.
+
+@item @code{verbose}
+@tab @code{#f}
+@tab Passe en mode verbeux, ce qui correspond à un niveau de
+journalisation @code{DEBUG} (lecture seule).
+
+@item @code{warning-as-error}
+@tab @code{#f}
+@tab Considère tous les messages d'avertissement et @qq{erreur de
+programmation} comme étant de véritables erreurs.
+@end multitable
+
+
@node Variables d'environnement
@unnumberedsubsec Variables d'environnement
@translationof Environment variables
@command{lilypond} reconnaît les variables d'environnement
suivantes@tie{}:
+
@table @code
@item LILYPOND_DATADIR
Cette variable spécifie le répertoire où seront recherchés par défaut
Cette variable détermine la langue dans laquelle seront émis les
messages.
+@item LILYPOND_LOGLEVEL
+Cette variable détermine le niveau par défaut de verbosité. En
+l'absence de niveau explicite -- autrement dit la ligne de commande ne
+comporte pas de @option{--loglevel} -- c'est cette valeur qui sera
+utilisée.
+
@item LILYPOND_GC_YIELD
Cette variable permet d'ajuster l'empreinte mémoire et le rendement de
la machine. Il s'agit en fait d'un pourcentage d'allocation de
@itemize
-@item Installation des paquetages nécessaires@tie{}: LilyPond, GhostScript et
+@item Installation des paquetages nécessaires@tie{}: LilyPond, Ghostscript et
ImageMagick.
-@item Création de l'utilisateur @code{lily}:
+@item Création de l'utilisateur @code{lily} :
@example
adduser lily
cp -L /usr/bin/convert /usr/bin/gs usr/bin
cp -L /usr/share/fonts/truetype usr/share/fonts
-# la formule magique de recopie des biblothèques
+# la formule magique de recopie des bibliothèques
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 \
@cindex Scheme error
Les erreurs qui interviennent lors de l'exécution de code Scheme sont
gérées par l'interpréteur Scheme. L'utilisation du mode verbeux
-(options @code{-V} ou @code{--verbose}) vous permettra de localiser
+(options @option{-V} ou @option{--verbose}) vous permettra de localiser
l'appel de fonction délictueux.
@item Programming error -- Erreur de programmation
Notez que ces coordonnées constituent l'approximation au mieux par
LilyPond dans le code ayant déclenché l'avertissement ou l'erreur. En
-règle générale, erreurs et avertissement surviennent lorsque LilyPond
+règle générale, erreurs et avertissements surviennent lorsque LilyPond
rencontre quelque chose d'inattendu. Lorsque la ligne indiquée ne vous
semble pas comporter d'élément litigieux, remontez de quelques lignes
dans votre code.
espérons que ces explications vous aideront à les résoudre plus
facilement.
-
@menu
* La musique déborde de la page::
* Apparition d'une portée supplémentaire::
* staff-affinities devraient aller en ordre décroissant::
@end menu
+
@node La musique déborde de la page
@unnumberedsubsec La musique déborde de la page
@translationof Music runs off the page
positionnez régulièrement des contrôles de barre de mesure -- voir
@ruser{Vérification des limites et numéros de mesure}.
-Si vous tenez absolument à enchainer de tels débordements, vous devrez
+Si vous tenez absolument à enchaîner de tels débordements, vous devrez
insérer des barres de mesure invisibles là où vous souhaitez positionner
un saut de ligne. Consultez le chapitre @ruser{Barres de mesure} pour
plus de détails.
et c'est d'ailleurs le cas pour la majorité des exemples contenus dans
les manuels de LilyPond. Cependant, la création implicite d'un contexte
peut aboutir à l'apparition d'une portée @qq{parasite}. On s'attend par
-exemple, en lisant le code qui suit, à ce que toutes les têtes de notes
+exemple, en lisant le code qui suit, à ce que toutes les têtes de note
soient en rouge, alors que le résultat nous présente deux portées et que
les notes, placées sur la portée inférieure, restent en noir.
@end lilypond
Autre exemple : la présence d'une commande @code{\relative} à
-l'intérieur d'une section @code{\repeat} génèrera obligatoirement une
+l'intérieur d'une section @code{\repeat} générera obligatoirement une
portée intempestive. Cela tient au fait que la commande @code{\repeat}
va créer deux blocs @code{\relative} qui, chacun à leur tour, créeront
implicitement un bloc @code{Staff} assorti d'un bloc @code{Voice}.
@lilypond[quote,verbatim]
-\repeat unfold 2 \relative { c d e f }
+\repeat unfold 2 {
+ \relative c' { c4 d e f }
+}
@end lilypond
La manière adéquate de procéder consiste à inverser les commandes
@code{\repeat} et @code{\relative}, comme ceci@tie{}:
@lilypond[quote,verbatim]
-\relative {
- \repeat unfold 2 { c d e f }
+\new Voice {
+ \repeat unfold 2 {
+ \relative c' { c4 d e f }
+ }
}
@end lilypond
bornages ou de guillemets.
L'erreur la plus courante est la simple omission d'une accolade
-fermante (@code{@}} à la fin du bloc @code{Score}. La solution est
+fermante (@code{@}}) à la fin du bloc @code{Score}. La solution est
évidente en pareil cas@tie{}: il suffit de vérifier que le bloc
@code{Score} est bien clôturé. La structure des fichiers LilyPond est
abordée plus en détails au chapitre
charge le contrôle de parité des parenthèses, crochets et accolades afin
de vous éviter de telles erreurs.
+Autre erreur courante, l'absence d'espace entre la dernière syllabe et
+l'accolade (@code{@}}) clôturant un bloc de paroles. Lorsqu'il n'y a
+pas séparation, l'accolade est considérée comme faisant partie
+intégrante de la syllabe. C'est la raison pour laquelle nous vous
+invitons à insérer une espace avant et après @strong{chaque} accolade.
+D'autres informations à ce sujets sont mentionnées au chapitre
+@ruser{Saisie des paroles}.
+
Lorsqu'il s'agit d'un guillemet fermant (@code{"}) omis, le message
d'erreur devrait vous indiquer un numéro de ligne avoisinant. L'erreur
se situe la plupart du temps une ou deux lignes au-dessus de celle
indiquée.
-
+@c Match quote character "
@node Message d'erreur Unbound variable %
-@unnumberedsubsec Message d'erreur « Unbound variable % »
+@unnumberedsubsec Message d'erreur Unbound variable %
@translationof Error message Unbound variable %
Ce message d'erreur, qu'il apparaisse sur le terminal ou en fin de
fichier journal, est associé à un message du type @qq{GUILE a signalé
-une erreur @dots{}}. Il survient à chaque fois qu'un commentaire
+une erreur@dots{}}. Il survient à chaque fois qu'un commentaire
@emph{LilyPond} est indûment placé dans une routine @emph{Scheme}.
Un commentaire LilyPond est introduit par le signe pourcent (@code{%})
@node Message d'erreur FT_Get_Glyph_Name
-@unnumberedsubsec Message d'erreur « FT_Get_Glyph_Name »
+@unnumberedsubsec Message d'erreur FT_Get_Glyph_Name
@translationof Error message FT_Get_Glyph_Name
Ce message d'erreur, qu'il apparaisse sur le terminal ou en fin de
fichier journal, survient lorsqu'un fichier source contient des
caractères non ASCII et qu'il n'a pas été enregistré avec un encodage
UTF-8. Pour plus de détails, reportez-vous au chapitre
-@ruser{Codage du texte}.
+@ruser{Caractères spéciaux}.
@node staff-affinities devraient aller en ordre décroissant
@end example
@noindent
-que vous insérerez dès sa création. Pouur plus d'information,
+que vous insérerez dès sa création. Pour plus d'information,
reportez-vous à la rubrique
@ruser{Espacement des lignes rattachées à des portées}.
projects / lilypond.git / blobdiff