]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/fr/usage/running.itely
Doc-fr: updates NR, AU and web
[lilypond.git] / Documentation / fr / usage / running.itely
index 6eafa823d273fa24a85aeb4cac2bd6f2be1b374d..6d1d3365f3db519a1ce9ffeb134788abe91ccdb2 100644 (file)
@@ -1,11 +1,11 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
 
 @ignore
-    Translation of GIT committish: 4467a72a98fb582466ee4d5944ec8454b4b77fc6
+   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"
@@ -122,7 +122,8 @@ lilypond *.ly
 @end example
 
 @noindent
-traitera tous les fichiers LilyPond présent dans le répertoire en cours.
+traitera tous les fichiers LilyPond présents dans le répertoire en
+cours.
 
 Rediriger, par exemple dans un fichier, ce qui est émis à l'écran peut
 s'avérer utile.
@@ -197,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}.
 
@@ -237,6 +267,10 @@ ou @code{png}.
 
 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.
 
@@ -408,9 +442,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
@@ -446,7 +481,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}
@@ -475,29 +510,58 @@ 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.  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
@@ -553,6 +617,10 @@ pour chaque fichier.
 @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
@@ -639,7 +707,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
@@ -775,7 +843,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}
@@ -871,7 +953,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
@@ -1071,7 +1153,7 @@ facilement.
 * Message d'erreur FT_Get_Glyph_Name::
 * staff-affinities devraient aller en ordre décroissant::
 * Message d'erreur unexpected new::
-* Trop d'empilements de notes se chevauchent::
+* Cette voix requiert un voiceXx ou un réglage shiftXx::
 @end menu
 
 
@@ -1119,9 +1201,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
@@ -1131,10 +1213,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
 
@@ -1144,8 +1226,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{%})
@@ -1235,17 +1317,17 @@ dit, LilyPond les traitera simultanément :
 @end lilypond
 
 
-@node Trop d'empilements de notes se chevauchent
-@unnumberedsubsec Trop d'empilements de notes se chevauchent
-@translationof Warning ignoring too many clashing note columns
+@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 : trop d'empilements de notes se chevauchent. On
-fera au mieux} (@emph{warning: ignoring too many clashing note columns}).
-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
+@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