@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
@ignore
- Translation of GIT committish: 6ec0d3283b9e23f2d21658d71ac6801c3aab69b8
+ Translation of GIT committish: 2034ca4fcbed9253b5a85e9360e47d3fe3ff1d09
- 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..
+ 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.17.6"
@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.
associés, tel que @code{midi2ly}, ne sont disponibles qu'en ligne de
commande.
-Par @qq{ligne de commande}, nous entendons l'interface de commande du
+Par « ligne de commande », nous entendons l'interface de commande du
système. Les utilisateurs de Windows seront certainement plus familiers
-des termes @qq{fenêtre DOS} ou @qq{invite de commande}. Quant aux
+des termes « fenêtre DOS » ou « invite de commande ». Quant aux
utilisateurs de MacOS X, ils connaissent assurément les termes
-@qq{console} et @qq{terminal}. Les paramétrages spécifiques au système
+« console » et « terminal ». Les paramétrages spécifiques au système
MacOS font l'objet d'un @rwebnamed{MacOS X,chapitre particulier}.
Notre propos n'est pas ici d'expliquer ce qu'est l'interface de
nombreuses documentations que vous pourrez trouver sur ce sujet.
@menu
-* Lancement de lilypond::
+* Lancement de LilyPond::
* Options basiques de lilypond::
* Options avancées de lilypond::
* Variables d'environnement::
@end menu
-@node Lancement de lilypond
-@unnumberedsubsec Lancement de @command{lilypond}
-@translationof Invoking lilypond
+@node Lancement de LilyPond
+@unnumberedsubsec Lancement de LilyPond
+@translationof Invoking LilyPond
L'exécutable @command{lilypond} en ligne de commande se lance ainsi :
@file{@var{racine}-cello-1.pdf}.
-@unnumberedsubsubsec Commandes standard de l'interpréteur
-@translationof Standard shell commands
+@unnumberedsubsubsec Utilisation de LilyPond avec les fonctionnalités standard de l'interpréteur
+@translationof Using LilyPond with standard shell features
-Si votre interpréteur -- terminal, console, etc. -- prend en charge les
-redirections, les commandes qui suivent vous permettront de
-judicieusement rediriger les affichages de la console dans un
-fichier :
+Dans la mesure où LilyPond est une application qui fonctionne en ligne
+de commande, les fonctionnalités de l'interpréteur utilisé pour lancer
+LilyPond peuvent se révéler utiles.
-@itemize
+Par exemple,
-@item
-@code{lilypond fichier.ly 1>stdout.log} pour le verbiage normal
+@example
+lilypond *.ly
+@end example
-@item
-@code{lilypond fichier.ly 2>stderr.log} pour les messages d'erreur
+@noindent
+traitera tous les fichiers LilyPond présents dans le répertoire en
+cours.
-@item
-@code{lilypond fichier.ly &>tous.log} pour garder une trace de tout ce
-qui s'est passé
+Rediriger, par exemple dans un fichier, ce qui est émis à l'écran peut
+s'avérer utile.
-@end itemize
+@example
+lilypond fichier.ly 1> stdout.log
+
+lilypond fichier.ly 2> stderr.log
+
+lilypond fichier.ly &> tous.log
+@end example
+
+@noindent
+redirigeront respectivement le « verbiage normal », les erreurs ou tout,
+dans un fichier texte.
Consultez avant tout la documentation de votre interpréteur habituel
-pour vérifier qu'il prend en charge ces options dans cette syntaxe.
-Notez bien qu'il s'agit ici de commandes internes à l'interpréteur et
-qui n'ont rien à voir avec LilyPond.
+-- terminal, console, etc. -- pour vérifier qu'il prend en charge les
+options dans cette syntaxe.
+
+Voici comment traiter un jeu de fichiers répartis dans un répertoire
+donné ainsi que tous ses différents sous-répertoires. Les fichiers
+résultants seront regroupés dans le répertoire à partir duquel la
+commande a été exécutée, non selon l'emplacement des fichiers sources.
+
+@example
+find . -name '*.ly' -exec lilypond '@{@}' \;
+@end example
+
+@noindent
+Cette commande, bien qu'effective uniquement dans un terminal, devrait
+être fonctionnelle aussi pour les utilisateurs de MacOS X.
+
+Les utilisateurs de windows utiliseront l'instruction
+
+@example
+forfiles /s /M *.ly /c "cmd /c lilypond @@file"
+@end example
+
+@noindent
+dans l'@code{interpréteur de commandes}, qui se trouve normalement sous
+@code{Démarrer > Accessoires > Interpréteur de commandes} ou, pour la
+version 8, en faisant une recherche sur « interpréteur de commande ».
+
+Par ailleurs, il est possible de spécifier de manière explicite le chemin
+d'accès au dossier comportant des sous-répertoires où se trouvent les
+fichiers sources, à l'aide de l'option @code{/p} :
+
+@example
+forfiles /s /p C:\Documents\MesPartitions /M *.ly /c "cmd /c lilypond @@file"
+@end example
+
+Dans le cas où ce chemin d'accès comporte des espaces, l'intégralité de
+ce chemin devra être borné par des guillemets informatiques :
+
+@example
+forfiles /s /p "C:\Documents\Mes Partitions" /M *.ly /c "cmd /c lilypond @@file"
+@end example
@node Options basiques de lilypond
@table @code
+@item -b, --bigpdfs
+@cindex bigpdfs
+
+Les fichiers PDF générés peuvent être beaucoup plus lourd que la normale
+selon le degré d'optimisation des fontes. Néanmoins, lorsque plusieurs
+fichiers PDF sont inclus dans un document @code{pdftex}, @code{xetex} ou
+@code{luatex}, ils peuvent faire l'objet d'un traitement supplémentaire
+par @code{ghostscript} afin de fusionner les données de fontes
+redondantes et ainsi obtenir un fichier PDF @emph{significativement}
+plus léger.
+
+@example
+lilypond -b monfichier
+@end example
+
+Puis lancer @code{ghostscript} :
+
+@example
+gs -q -sDEVICE=pdfwrite -o gsout.pdf monfichier.pdf
+@end example
+
+@code{pdfsizeopt.py} vient alors en complément pour optimiser encore la
+taille du fichier :
+
+@example
+pdfsizeopt.py --use-multivalent=no gsout.pdf final.pdf
+@end example
+
+
@item -d, --define-default=@var{variable}=@var{valeur}
Voir @ref{Options avancées de lilypond}.
Détermine le format à produire. Il peut s'agir de @code{ps}, @code{pdf}
ou @code{png}.
-Exemple : @code{lilypond -fpng @var{monfichier}.ly}
+Exemple : @code{lilypond -fpng @var{monfichier}.ly}
+
+@noindent
+Les formats @code{svg} et @code{eps} s'obtiennent à l'aide de
+l'option @code{-dbackend} -- voir @ref{Options avancées de lilypond}.
@item -h, --help
Affiche un résumé des commandes.
@table @code
-@item -d@var{[nom-option]}=@var{[valeur]}, --define-default=@var{[nom-option]}=@var{[valeur]}
+@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.
+@var{nom-option} du programme, comme par exemple
@example
-dbackend=svg
@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
+réduit au niveau du résultat afin d'éviter les « distorsions » des
images @code{PNG}.
@item @code{aux-files}
@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 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 woff avec le moteur SVG.
-
@item
@tab @code{scm}
@tab Recopie littéralement les commandes Scheme internes de formatage.
+@item
+@tab @code{svg}
+@tab Génère du @emph{Scalable Vector Graphics}. Cette option permet de
+créer un fichier SVG par page. Les glyphes musicaux sont codés en tant
+que graphiques vectoriels mais les fontes textuelles @b{ne sont pas}
+incorporées aux fichiers @file{SVG} résultants. Quel que soit le
+programme utilisé pour visionner ces fichiers, il devra avoir accès aux
+fontes en question pour pouvoir afficher correctement les textes et
+paroles. Il est préférable de ne pas recourir aux « alias de police »
+ni aux listes de fontes si la visionneuse de fichier SVG ne peut le
+traîter correctement. L'option supplémentaire @code{--svg-woff} -- voir
+ci-après -- permet d'utiliser les fontes WOFF (@emph{Web Open Font
+Format}) avec le moteur SVG.
+@end multitable
+
+@noindent
+@strong{Note à propos des sorties SVG :}
+Par défaut, LilyPond utilise des valeurs de @code{font-family}
+génériques -- @code{Serif}, @code{Sans Serif} et @code{Monospace}. Le
+recours au moteur @code{svg} requiert donc que ces polices par défaut
+soient explicitement définies dans le fichier source :
+
+@quotation
+@verbatim
+\paper {
+ #(define fonts
+ (make-pango-font-tree "TeX Gyre Schola"
+ "TeX Gyre Heros"
+ "TeX Gyre Cursor"
+ (/ staff-height pt 20)))
+}
+@end verbatim
+@end quotation
+
+Voir aussi @ruser{Choix des fontes par défaut}.
+
+@multitable @columnfractions .33 .16 .51
@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.
+@tab Extrait des fragments musicaux d'une partition. Ceci requiert que
+la fonction @code{clip-regions} a été définie au sein du bloc
+@code{\layout} -- voir @ruser{Extraction de fragments musicaux}. Bien
+entendu, aucun fragment ne sera extrait si l'on utilise l'option
+@option{-dno-print-pages}
@item @code{datadir}
@tab
@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{embed-source-code}
+@tab @code{#f}
+@tab Intègre les fichiers source LilyPond au document PDF généré.
+
@item @code{eps-box-padding}
@tab @code{#f}
@tab Décale le bord gauche du typon EPS d'une valeur donnée en
@item @code{point-and-click}
@tab @code{#t}
-@tab Ajoute les liens @qq{point & click} à la sortie PDF ou SVG. Voir
+@tab Ajoute les liens « point & click » à la sortie PDF ou SVG. Voir
@ref{Pointer-cliquer}.
@cindex format de sortie, définition
@item @code{svg-woff}
@tab @code{#f}
-@tab Utilise, avec le moteur SVG, les fontes @code{woff}.
+@tab Cette option est obligatoire dès lors que sont utilisées, avec le
+moteur SVG, les fontes @emph{Web Open Font Format} (WOFF). Un fichier
+SVG sera généré pour chacune des pages produites. En dehors des glyphes
+musicaux propres à LilyPond, aucune autre information ne sera incluse.
+Quelque soir le visionneur de SVG utilisé, il devra avoir à disposition
+les fontes requises pour pouvoir afficher les éléments textuels et les
+paroles. Dans la mesure où le visionneur pourrait ne pas savoir le
+gérer, mieux vaut s'abstenir derecourir aux alias ou listes de fontes.
+
+
+Lorsque celles-ci sont utilisées correctement, nul n'est besoin
+d'installer les fontes que les fichiers SVG utiliseront dans
+l'environnement du visionneur. Néanmoins, LilyPond ne dispose pas de
+fichier de fonte @code{woff} textuelle. La présence du fichier de fonte
+@code{woff} est un prérequis.
@item @code{trace-memory-frequency}
@tab @code{#f}
@noindent
Cette commande a créé un fichier de 200 MB utilisable par le
-@qq{système protégé}.
+« système protégé ».
@item Création d'un pseudo-périphérique, génération d'un système de
fichiers et chargement de celui-ci, puis création d'un répertoire
* Message d'erreur FT_Get_Glyph_Name::
* staff-affinities devraient aller en ordre décroissant::
* Message d'erreur unexpected new::
+* Cette voix requiert un voiceXx ou un réglage shiftXx::
@end menu
que les contextes soient automatiquement créés rend bien des services,
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
+peut aboutir à l'apparition d'une portée « parasite ». On s'attend par
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.
-@lilypond[quote,verbatim,relative=2]
+@lilypond[quote,verbatim,fragment]
\override Staff.NoteHead.color = #red
-\new Staff { a }
+\new Staff { a' }
@end lilypond
Étant donné qu'aucun contexte @code{Staff} n'existe lorsque la
contenir les notes qui suivent. Voici la syntaxe correcte pour obtenir
ces notes en rouge :
-@lilypond[quote,verbatim,relative=2]
+@lilypond[quote,verbatim]
\new Staff {
\override Staff.NoteHead.color = #red
- a
+ a'
}
@end lilypond
@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
+fichier journal, est associé à un message du type « GUILE a signalé
+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{%})
>>
}
@end lilypond
+
+
+@node Cette voix requiert un voiceXx ou un réglage shiftXx
+@unnumberedsubsec Cette voix requiert un @code{@bs{}voiceXx} ou un réglage @code{@bs{}shiftXx}
+@translationof Warning this voice needs a voiceXx or shiftXx setting
+
+Lorsque des notes affectées à des voix différentes et ayant la même
+orientation de hampe interviennent au même instant musical et qu'aucun
+décalage spécifique à la voix n'a été spécifié, LilyPond émet
+@code{Avertissement : Cette voix requiert un voiceXx ou un réglage
+shiftXx} (@emph{warning: this voice needs a \voiceXx or \shiftXx
+setting}). Cet avertissement est émis même lorsque ces notes n'ont pas
+de hampe visible, comme par exemple des rondes, si les hampes des durées
+inférieures à ces même hauteurs avaient la même orientation.
+
+N'oublions pas que l'orientation des hampes dépend de la position des
+notes sur la portée à moins que cette orientation n'ait été spécifiée,
+par exemple à l'aide d'un @code{\voiceOne} ou autre clause. En pareil
+cas, l'avertissement ne sera émis que lorsque les hampes auront la même
+orientation, autrement dit lorsque les notes seront dans la même moitié
+de la portée.
+
+Le fait de placer les notes dans des voix auxquelles sont attachés
+orientation de hampe et décalage, comme @code{\voiceOne} ou autre, peut
+permettre d'éviter ces avertissements.
+
+Les notes se trouvant dans des voix au numéro plus élévé --
+@code{\voiceThree} ou @code{\voiceFour} -- sont automatiquement décalées
+pour éviter que les empilements se chevauchent. Ceci aura pour résultat
+de visuellement décaler les notes affublées de hampe sans toutefois
+bouger les rondes, hormis dans le cas d'un réel chevauchement ou lorsque
+ces voix se croisent (@code{\voiceThree} au dessus de@code{\voiceOne}).
+
+@seealso
+Manuel d'initiation :
+@rlearning{Instanciation explicite des voix},
+@rlearning{Exemple concret}.
+
+Manuel de notation :
+@ruser{Polyphonie sur une portée},
+@ruser{Résolution des collisions}.
projects / lilypond.git / blobdiff