@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
@ignore
- Translation of GIT committish: d46572826e777ed3e9fa4656535a6e9000f2ed9e
+ Translation of GIT committish: 0061a10c574353b9bb4097ba1c214da7d9d714a2
When revising a translation, copy the HEAD committish of the
version that you are working on. For details, see the Contributors'
@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}
@item -h, --help
Affiche un résumé des commandes.
@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
+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 @code{woff} avec le moteur @code{SVG}.
+permet d'utiliser les fontes woff avec le moteur SVG.
@item
@tab @code{scm}
@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
Ghostscript.
@item @code{point-and-click}
-@tab @code{#f}
-@tab Ajoute les liens @qq{point & click} à la sortie @code{PDF}. Voir
+@tab @code{#t}
+@tab Ajoute les liens @qq{point & click} à la sortie PDF ou SVG. Voir
@ref{Pointer-cliquer}.
@cindex format de sortie, définition
@quotation
@verbatim
-#(system "rm -rf /")
+#(s ystem "rm -rf /") % trop dangeureux à écrire sans faute
{
- c4^$(ly:gulp-file "/etc/passwd")
+ c4^$(ly:gulp-file "/etc/passwd") % malveillant mais pas destructeur
}
@end verbatim
@end quotation
@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.
+@tab Considère tous les messages d'avertissement et « erreur de
+programmation » comme étant de véritables erreurs.
@end multitable
semble pas comporter d'élément litigieux, remontez de quelques lignes
dans votre code.
+Par ailleurs, des diagnostics peuvent être déclenchés à n'importe quel
+moment au cours des différentes étapes du traitement. Par exemple,
+lorsque certaines parties de la source sont traitées plusieurs fois --
+sortie MIDI et sortie imprimable -- ou qu'une même variable musicale est
+utilisée dans plusieurs contextes, peut apparaître le même message à
+plusieurs reprises. Les diagnostics effectués à une étape avancée du
+traitement, tels que les contrôles de mesure, sont aussi susceptibles
+d'apparaître plusieurs fois.
+
Vous trouverez d'autres informations sur les erreurs au chapitre
@ref{Quelques erreurs des plus courantes}.
* 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.
}
@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
-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' { 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 :
-
-@lilypond[quote,verbatim]
-\new Voice {
- \repeat unfold 2 {
- \relative c' { c4 d e f }
- }
-}
-@end lilypond
-
@node Message d'erreur Unbound variable %
@unnumberedsubsec Message d'erreur @code{Unbound variable %}
>>
}
@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