]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/fr/usage/running.itely
Doc-fr: Usage
[lilypond.git] / Documentation / fr / usage / running.itely
index a3d3579e54c130602a776afd013b55fae965f854..fdb9738bb0208ad948f88fee33b2ef4445556619 100644 (file)
@@ -1,11 +1,11 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
 
 @ignore
-    Translation of GIT committish: 2af77c4ae79774eeb99314c052b12f990f03a538
+   Translation of GIT committish: 7f011525b936261ec3dfe15130ce8dd5055fe535
 
-    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"
@@ -198,6 +198,35 @@ Différentes options sont disponibles en ligne de commande :
 
 @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}.
 
@@ -409,9 +438,10 @@ est livré @strong{SANS GARANTIE} !
 
 @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
@@ -447,7 +477,7 @@ valeur par défaut.
 @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}
@@ -476,22 +506,45 @@ utilise par défaut.
 @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.  Dans la mesure où aucune information
+concernant les fontes n'est incorporée,  elles devront être installées
+afin d'obtenir le meilleur rendu possible.  Il est préférable de ne pas
+recourir aux « alias de police » ni aux listes de fontes si le
+visionneur 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 :}
+Les polices par défaut de LilyPond -- @code{LilyPond Serif},
+@code{LilyPond Sans Serif} et @code{LilyPond Monospace} -- ne sont que
+des alias au niveau local.  Le recours au moteur 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.
@@ -644,7 +697,7 @@ Ghostscript.
 
 @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
@@ -780,7 +833,21 @@ option accroit notablement la taille des fichiers PDF.
 
 @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}
@@ -876,7 +943,7 @@ dd if=/dev/zero of=/home/lily/loopfile bs=1k count= 200000
 
 @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
@@ -1124,9 +1191,9 @@ 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
@@ -1136,10 +1203,10 @@ appliquer la directive considérée.  Survient alors la commande
 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
 
@@ -1149,8 +1216,8 @@ ces notes en rouge :
 @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{%})