@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
@ignore
- Translation of GIT committish: ede6552ee0a9954a6ced5922cfc0cfa2c40733af
+ Translation of GIT committish: 9ae56888788d74c292e20b735a8f973c64cf1b1d
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.13.36"
+@c \version "2.15.18"
@c Translators: Jean-Charles Malahieude
@c Translation checkers:
@node Exécution de LilyPond
@chapter Exécution de @command{lilypond}
-@translationof Running LilyPond
+@translationof Running lilyPond
Ce chapitre passe en revue ce qui se passe lorsque vous lancez LilyPond.
@menu
* Lancement de lilypond::
-* Options en ligne de commande::
+* Options en ligne de commande pour lilypond::
* Variables d'environnement::
* Exécution de LilyPond en mode protégé::
@end menu
@end example
Lorsque le fichier est fourni sans extension, LilyPond présume qu'il
-s'agit de @file{@/.ly}. Pour interpréter directement l'entrée standard
+s'agit de @file{.ly}. Pour interpréter directement l'entrée standard
(@emph{stdin}), fournissez un tiret (@code{-}) en lieu et place de
@var{fichier}.
-Le traitement de @file{monfichier@/.ly} produira @file{monfichier@/.ps} et
-@file{monfichier@/.pdf}. Vous pouvez spécifier plusieurs fichiers à la
+Le traitement de @file{monfichier.ly} produira @file{monfichier.ps} et
+@file{monfichier.pdf}. Vous pouvez spécifier plusieurs fichiers à la
fois@tie{}; ils seront traités indépendamment les uns des
autres.@footnote{Le statut de GUILE n'étant pas réinitialisé après
-traitement d'un fichier @file{@/.ly}, veillez à ne pas modifier les
+traitement d'un fichier @file{.ly}, veillez à ne pas modifier les
réglages par défaut du système à partir d'assertions en Scheme.}
-Lorsque @file{monfichier@/.ly} contient plus d'une section @code{\book},
+Lorsque @file{monfichier.ly} contient plus d'une section @code{\book},
les fichiers produits -- à partir du deuxième -- seront numérotés. Par
ailleurs, la valeur affectée à @code{output-suffix} sera insérée entre la
racine et le numéro. Par exemple, un fichier @var{racine} qui
@end example
@noindent
-fournira grâce à LilyPond @file{@var{racine}@/-violon@/.pdf} et
-@file{@var{racine}@/-cello@/-1@/.pdf}.
+fournira grâce à LilyPond @file{@var{racine}-violon.pdf} et
+@file{@var{racine}-cello-1.pdf}.
@unnumberedsubsubsec Commandes standard de l'interpréteur
+@translationof Standard shell commands
Si votre interpréteur -- terminal, console, etc. -- prend en charge les
redirections, les commandes qui suivent vous permettront de
qui n'ont rien à voir avec LilyPond.
-@node Options en ligne de commande
+@node Options en ligne de commande pour lilypond
@unnumberedsubsec Options en ligne de commande pour @command{lilypond}
-@translationof Command line options
+@translationof Command line options for lilypond
@cindex lancement de @command{lilypond}
@cindex ligne de commande, options pour @command{lilypond}
@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
@end example
@noindent
-en tête de votre fichier @file{@/.ly}.
+en tête de votre fichier @file{.ly}.
+@warning{Les utilisateurs de Windows doivent utiliser des quillements
+doubles @code{"} en lieu et place des guillemets simples @code{'}.}
+@c Match " in previous line to help context-sensitive editors
@item -f,--format=@var{format}
Détermine le format à produire. Il peut s'agir de @code{ps}, @code{pdf}
@noindent
revient au même que
@example
--dpoint-and-click='#f'
+-dpoint-and-click=#f
@end example
-
-Voici quelques options des plus intéressantes.
+Voici les options disponibles@tie{}:
@cindex help, ligne de commande
-@table @samp
+@table @code
+
@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
+@cindex paper-size, ligne de commande
Détermine la taille par défaut du papier, par exemple
@example
-dpaper-size=\"letter\"
@cindex safe, ligne de commande
-
@item safe
-Ne pas avoir une confiance aveugle dans le code @file{@/.ly}.
+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
+@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:export (ly:gulp-file "/etc/passwd"))
+ 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},
+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.
+@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})
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
+@option{--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
+@cindex format de sortie, définition
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.
+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
@item eps
@cindex Postscript encapsulé
@cindex EPS (Encapsulated PostScript)
- pour du PostScript encapsulé.
+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,
@item svg
@cindex SVG (Scalable Vector Graphics)
- pour du SVG (@emph{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
@item scm
@cindex Scheme dump
- pour une recopie brute des commandes Scheme internes de formatage.
+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}.
+permet de ne pas générer de partition imprimable. Cette option est
+équivalente à @code{-dno-print-pages}.
@end table
et @code{svg}.
+@item gui
+Travaille silencieusement, et redirige tout le verbiage dans un fichier
+journal.
+
+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.
+
@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}.
+@option{-dno-print-pages} est particulièrement utile lorsqu'utilisée
+conjointement avec l'option @option{-dpreview}.
@end table
-
@item -h,--help
Affiche un résumé des commandes.
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éfinit @var{fichier} (par défaut @file{init.ly}) en tant que fichier
d'initialisation.
+@item -l,--loglevel=@var{DEGRÉ}
+@cindex loglevel
+@cindex verbosité, définir le degré de
+
+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
+
+
@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.
-
+sera ajouté (p.ex. @file{.pdf} pour du pdf) dans tous les cas.
-@cindex PostScript output
@item --ps
+@cindex PostScript output
Génère du PostScript.
-@cindex Portable Network Graphics (PNG) output
-
@item --png
+@cindex Portable Network Graphics (PNG) output
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
+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
-
@item --pdf
-Génère du PDF. Ceci sous-entend l'utilisation de @code{--ps}.
+@cindex Portable Document Format (PDF) output
+Génère du PDF. Ceci sous-entend l'utilisation de @option{--ps}.
@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.
-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
+L'option @option{--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
moins en théorie -- l'impossibilité de s'échapper de la cellule. Notez
-cependant que, pour que l'option @code{--jail} soit fonctionnelle,
+cependant que, pour que l'option @option{--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}.
@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
-@code{nosuid}. Il sera de fait impossible de lancer des exécutables ou
-d'écrire sur un périphérique à partir de LilyPond. Si vous n'avez pas
-l'intention de créer un tel système sur une partition séparée, vous
-pouvez avoir recours à un pseudo-périphérique (@emph{loop device}) monté
-à partir d'un simple fichier de taille raisonnable. D'autre part, le
-recours à un système de fichiers indépendant permet de limiter l'espace
-dévolu à LilyPond.
+qu'on peut le brider à l'aide des options @option{noexec},
+@option{nodev} et @option{nosuid}. Il sera de fait impossible de lancer
+des exécutables ou d'écrire sur un périphérique à partir de LilyPond.
+Si vous n'avez pas l'intention de créer un tel système sur une partition
+séparée, vous pouvez avoir recours à un pseudo-périphérique (@emph{loop
+device}) monté à partir d'un simple fichier de taille raisonnable.
+D'autre part, le recours à un système de fichiers indépendant permet de
+limiter l'espace dévolu à LilyPond.
@item Création d'un utilisateur spécifique
L'utilisation de LilyPond au sein de la cellule devrait être réservé à
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 @option{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
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
@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
* Erreur renvoyant à ../ly/init.ly::
* Message d'erreur Unbound variable %::
* Message d'erreur FT_Get_Glyph_Name::
+* staff-affinities devraient aller en ordre décroissant::
@end menu
@node La musique déborde de la page
@translationof Apparent error in ../ly/init.ly
Certains messages d'erreur relatifs à une erreur de syntaxe dans le
-fichier @file{@/.@/./@/ly/@/init@/.ly} peuvent survenir lorsque le fichier est mal
+fichier @file{../ly/init.ly} peuvent survenir lorsque le fichier est mal
formaté. Cela se produit notamment lors d'un défaut de parité de
bornages ou de guillemets.
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 % »
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{%})
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
+@unnumberedsubsec staff-affinities devraient aller en ordre décroissant
+@translationof Warning staff affinities should only decrease
+Cet avertissement est émis lorsque la partition ne comporte pas de
+portée, comme par exemple une feuille de chant avec un contexte
+@code{ChordName} et un contexte @code{Lyrics}. Ce message disparaîtra
+dès lors que autoriserez l'un de ces contextes à se comporter comme une
+portée, à l'aide de l'instruction
+
+@example
+\override VerticalAxisGroup #'staff-affinity = ##f
+@end example
+
+@noindent
+que vous insérerez dès sa création. Pouur plus d'information,
+reportez-vous à la rubrique
+@ruser{Espacement des lignes rattachées à des portées}.