Add '-dcrop' option to ps and svg backends

[lilypond.git] / Documentation / fr / usage / lilypond-book.itely

diff --git a/Documentation/fr/usage/lilypond-book.itely b/Documentation/fr/usage/lilypond-book.itely
index 04084b5e5766fa2b25ce1ec2d260822fa8dfef10..919de9dc63e129c7d7edaf690ba2cb0b4326e590 100644 (file)
--- a/Documentation/fr/usage/lilypond-book.itely
+++ b/Documentation/fr/usage/lilypond-book.itely
@@ -1,7 +1,7 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
 
 @ignore
-    Translation of GIT committish: bd751630011a6fbfcf069ec1fc41a8eaed8a6b87
+    Translation of GIT committish: f7a3d8cf31367398a1955c50d3c42216d8940989
 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  For details, see the Contributors'
@@ -9,7 +9,7 @@
 @end ignore
 
 
-@c \version "2.17.11"
+@c \version "2.19.22"
 
 @c Translators: Jean-Charles Malahieude
 @c Translation checkers:
@@ -99,8 +99,8 @@ fait mélanger de la musique et du texte.
 Par exemple,
 
 \begin{lilypond}
-\relative c' {
-  c2 e2 \tuplet 3/2 { f8 a b } a2 e4
+\relative {
+  c'2 e2 \tuplet 3/2 { f8 a b } a2 e4
 }
 \end{lilypond}
 
@@ -164,8 +164,8 @@ fait mélanger de la musique et du texte.
 Par exemple,
 
 @lilypond
-\relative c' {
-  c2 e2 \tuplet 3/2 { f8 a b } a2 e4
+\relative {
+  c'2 e2 \tuplet 3/2 { f8 a b } a2 e4
 }
 @end lilypond
 
@@ -190,8 +190,8 @@ type @code{\book @{ @}}.
     title = "LilyPond fait ses gammes"
   }
 
-  \relative c' {
-    c d e f g a b c
+  \relative {
+    c' d e f g a b c
   }
 }
 @end lilypond
@@ -833,8 +833,8 @@ la musique sera interprétée en mode relatif, mais la recopie du code ne
 comportera pas l'assertion du bloc @code{relative} :
 
 @example
-\relative c' @{ % begin verbatim
-  c4 e2 g4
+\relative @{ % begin verbatim
+  c'4 e2 g4
   f2 e % end verbatim
 @}
 @end example
@@ -992,6 +992,23 @@ des fontes, que vous pouvez ignorer sans scrupule.@*
 Si vous utilisez @command{latex} en mode colonnage, n'oubliez pas
 d'ajouter @option{-t landscape} aux options de @command{dvips}.
 
+Les environnements tels que
+
+@example
+\begin@{lilypond@} @dots{} \end@{lilypond@}
+@end example
+
+@noindent
+ne sont pas interprétés par @LaTeX{}.  En fait, @code{lilypond-book}
+extrait ces « environnements » dans des fichiers accessoires et les
+traite par LilyPond.  Il récupère ensuite les graphiques résultants et
+crée un fichier @file{.tex} dans lequel les macros
+@code{\begin@{lilypond@}}@dots{}@code{\end@{lilypond@}} sont alors
+remplacées par des commandes « d'inclusion de graphique ».  C'est
+seulement à ce moment là que @LaTeX{} est lancé -- bien que @LaTeX{}
+aura préalablement tourné, cela aura été en fait sur un document
+« vide » et pour calculer certains éléments comme @code{\linewidth}.
+
 @knownissues
 La commande @code{\pageBreak} est inopérante dans un environnement
 @code{\begin@{lilypond@}@dots{}\end@{lilypond@}}.
@@ -1086,23 +1103,23 @@ cd out
 @dots{}
 @end example
 
-@itemx --skip-lily-check
+@item --skip-lily-check
 Désactive la mise en échec en l'absence de sortie de lilypond.@*
 Option utilisée pour la documentation au format Info sans images.
 
-@itemx --skip-png-check
+@item --skip-png-check
 Désactive la mise en échec en l'absence d'images PNG correspondant aux
 fichiers EPS.@*
 Option utilisée pour la documentation au format Info sans images.
 
-@itemx --lily-output-dir=@var{rép}
+@item --lily-output-dir=@var{rép}
 Écrit les fichiers lily-XXX dans @var{rép} et crée un lien vers le
 répertoire spécifié par @code{--output}.  Cette option permet
 d'économiser du temps lors de la génération de documents qui se trouvent
 dans différents répertoires et partagent un certain nombre d'extraits
 identiques.
 
-@itemx --lily-loglevel=@var{loglevel}
+@item --lily-loglevel=@var{loglevel}
 Détermine le degré de verbosité lors des appels à @command{lilypond}.
 Les valeurs autorisée de @var{loglevel} sont : @code{NONE},
 @code{ERROR}, @code{WARNING}, @code{BASIC_PROGRESS}, @code{PROGRESS},
@@ -1110,16 +1127,16 @@ Les valeurs autorisée de @var{loglevel} sont : @code{NONE},
 pas activée, c'est le niveau déterminé par la variable d'environnement
 @code{LILYPOND_LOGLEVEL} qui sera utilisé.
 
-@itemx --info-images-dir=@var{répertoire}
+@item --info-images-dir=@var{répertoire}
 Formate la sortie Texinfo de telle sorte que Info cherche les images
 de musique dans @var{répertoire}.
 
-@itemx --latex-program=@var{programme}
+@item --latex-program=@var{programme}
 Utilise l'exécutable @command{programme} en lieu et place de
 @command{latex}.  C'est l'option que vous utiliserez si vous préférez
 @command{xelatex} par exemple.
 
-@itemx --left-padding=@var{distance}
+@item --left-padding=@var{distance}
 Décale les figures EPS de @var{distance} -- exprimée en millimètres
 (3 par défaut).  Cette option est utile lorsque les lignes de musique
 débordent sur la marge droite.
@@ -1144,7 +1161,7 @@ Le résultat des commandes est habituellement affiché dans le terminal.
 Cette option permet de rediriger tout le verbiage dans un journal situé
 dans le même répertoire que le fichier source.
 
-@itemx --use-source-file-names
+@item --use-source-file-names
 Cette option permet d'affecter aux fichiers correspondant aux extraits
 de musique le même nom que leur source.  Elle n'est fonctionnelle que
 dans le cas où la partition est incluse à l'aide de @code{lilypondfile},
@@ -1230,8 +1247,8 @@ Vous pouvez inclure des partitions LilyPond dans un document LaTeX.
 Des bananes alitées sur du LaTeX.
 
 \begin@{lilypond@}
-\relative c'' @{
-  a4 b c d
+\relative @{
+  a'4 b c d
 @}
 \end@{lilypond@}
 
@@ -1258,7 +1275,7 @@ l'intégralité de ce manuel est rédigée en Texinfo.
 Du verbiage à la mode Texinfo
 
 @@lilypond
-\relative c' @{
+\relative @{
   a4 b c d
 @}
 @@end lilypond
@@ -1285,8 +1302,8 @@ d4 c b a
 Un document pour lilypond-book peut absolument mélanger musique et
 texte.  Par exemple,
 <lilypond>
-\relative c'' @{
-  a4 b c d
+\relative @{
+  a'4 b c d
 @}
 </lilypond>
 </p>
@@ -1396,7 +1413,7 @@ comportant tous les mouvement de la partition.
                (format #f "~a, section, 1, @{~a@}, ~a" page text label))))
              (formatted-toc-items (map format-line (toc-items)))
              (whole-string (string-join formatted-toc-items ",\n"))
-             (output-name (ly:parser-output-name parser))
+             (output-name (ly:parser-output-name))
              (outfilename (format "~a.toc" output-name))
              (outfile (open-output-file outfilename)))
         (if (output-port? outfile)
@@ -1479,4 +1496,3 @@ où @code{\includescore} est défini ainsi :
 D'autres moyens de mélanger musique et texte sans recourir à
 @command{lilypond-book} sont abordés au chapitre
 @ref{Inclusion de partition LilyPond dans d'autres programmes}.
-