X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Ffr%2Fusage%2Flilypond-book.itely;h=919de9dc63e129c7d7edaf690ba2cb0b4326e590;hb=77267b700c377fd170abcbf4863728937038eb5e;hp=8bca6e4ced191152baae4a95ccff91ee8f679bdc;hpb=fbd85e1e78701ac40842e45bf24d2ae183786986;p=lilypond.git

diff --git a/Documentation/fr/usage/lilypond-book.itely b/Documentation/fr/usage/lilypond-book.itely
index 8bca6e4ced..919de9dc63 100644
--- 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: eea3764cd6bbc78506261f78ed4e7745ac69df41
+    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.16.0"
+@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 \times 2/3 { f8 a b } a2 e4
+\relative {
+  c'2 e2 \tuplet 3/2 { f8 a b } a2 e4
 }
 \end{lilypond}
 
@@ -134,11 +134,11 @@ dans un terminal, lancez
 lilypond-book --output=out --pdf lilybook.lytex
 @emph{lilypond-book (GNU LilyPond) @version{} }
 @emph{Lecture de lilybook.lytex...}
-@emph{..nous vous épargnons le verbiage de la console..}
+@emph{@dots{}nous vous épargnons le verbiage de la console@dots{}}
 @emph{Compilation de lilybook.tex...}
 cd out
 pdflatex lilybook
-@emph{..nous vous épargnons le verbiage de la console..}
+@emph{@dots{}nous vous épargnons le verbiage de la console@dots{}}
 xpdf lilybook
 @emph{(remplacez @command{xpdf} par votre lecteur de PDF habituel)}
 @end example
@@ -164,8 +164,8 @@ fait mélanger de la musique et du texte.
 Par exemple,
 
 @lilypond
-\relative c' {
-  c2 e2 \times 2/3 { 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
@@ -233,20 +233,20 @@ suivantes :
 @itemize
 
 @item
-la commande @code{\lilypond@{...@}} qui permet de directement saisir du
-code LilyPond simple ;
+la commande @code{\lilypond@{@dots{}@}} qui permet de directement saisir
+du code LilyPond simple ;
 
 @item
-l'environnement @code{\begin@{lilypond@}...\end@{lilypond@}} qui permet
-de saisir directement du code LilyPond plus élaboré ;
+l'environnement @code{\begin@{lilypond@}@dots{}\end@{lilypond@}} qui
+permet de saisir directement du code LilyPond plus élaboré ;
 
 @item
-la commande @code{\lilypondfile@{...@}} qui permet d'insérer un fichier
-LilyPond ;
+la commande @code{\lilypondfile@{@dots{}@}} qui permet d'insérer un
+fichier LilyPond ;
 
 @item
-la commande @code{\musicxmlfile@{...@}} qui permet d'insérer un fichier
-MusicXML qui sera alors traité par @code{musicxml2ly} puis
+la commande @code{\musicxmlfile@{@dots{}@}} qui permet d'insérer un
+fichier MusicXML qui sera alors traité par @code{musicxml2ly} puis
 @code{lilypond}.
 
 @end itemize
@@ -428,9 +428,9 @@ nombre de systèmes requis :
 
 @example
 \onlyFirstNSystems@{3@}
-\begin@{lilypond@}...\end@{lilypond@}
+\begin@{lilypond@}@dots{}\end@{lilypond@}
 \onlyFirstNSystems@{1@}
-\begin@{lilypond@}...\end@{lilypond@}
+\begin@{lilypond@}@dots{}\end@{lilypond@}
 @end example
 
 
@@ -457,20 +457,21 @@ suivantes :
 @itemize
 
 @item
-la commande @code{@@lilypond@{...@}} qui permet de directement saisir du
-code LilyPond simple ;
+la commande @code{@@lilypond@{@dots{}@}} qui permet de directement
+saisir du code LilyPond simple ;
 
 @item
-l'environnement @code{@@lilypond...@@end lilypond} qui permet
+l'environnement @code{@@lilypond@dots{}@@end lilypond} qui permet
 de saisir directement du code LilyPond plus élaboré ;
 
 @item
-la commande @code{@@lilypondfile@{...@}} qui permet d'insérer un fichier
-LilyPond ;
+la commande @code{@@lilypondfile@{@dots{}@}} qui permet d'insérer un
+fichier LilyPond ;
 
 @item
-la commande @code{@@musicxmlfile@{...@}} qui permet d'insérer un fichier
-MusicXML qui sera alors traité par @code{musicxml2ly} puis @code{lilypond}.
+la commande @code{@@musicxmlfile@{@dots{}@}} qui permet d'insérer un
+fichier MusicXML qui sera alors traité par @code{musicxml2ly} puis
+@code{lilypond}.
 
 @end itemize
 
@@ -541,21 +542,21 @@ suivantes :
 @itemize
 
 @item
-la commande @code{<lilypond ... />} qui permet de directement saisir du
-code LilyPond simple ;
+la commande @code{<lilypond @dots{} />} qui permet de directement saisir
+du code LilyPond simple ;
 
 @item
-l'environnement @code{<lilyond>...</lilypond>} qui permet de saisir
+l'environnement @code{<lilyond>@dots{}</lilypond>} qui permet de saisir
 directement du code LilyPond plus élaboré ;
 
 @item
-la commande @code{<lilypondfile>...</lilypondfile>} qui permet d'insérer
-un fichier LilyPond ;
+la commande @code{<lilypondfile>@dots{}</lilypondfile>} qui permet
+d'insérer un fichier LilyPond ;
 
 @item
-la commande @code{<musicxmlfile>...</musicxmlfile>} qui permet d'insérer
-un fichier MusicXML qui sera alors traité par @code{musicxml2ly} puis
-@code{lilypond}.
+la commande @code{<musicxmlfile>@dots{}</musicxmlfile>} qui permet
+d'insérer un fichier MusicXML qui sera alors traité par
+@code{musicxml2ly} puis @code{lilypond}.
 
 @end itemize
 
@@ -602,7 +603,7 @@ De la musique <lilypond relative=2: a b c/> au milieu d'une ligne de texte.
 Lorsque l'inclusion concerne des fichiers indépendants, utilisez
 
 @example
-<lilypondfile @var{option1} @var{option2} ...>@var{fichier}</lilypondfile>
+<lilypondfile @var{option1} @var{option2}@dots{}>@var{fichier}</lilypondfile>
 @end example
 
 La syntaxe pour @code{<musicXmlfile>} est identique à celle de
@@ -674,8 +675,8 @@ voici la syntaxe :
   <textobject>
     <programlisting language="lilypond" role="fragment verbatim staffsize=16 ragged-right relative=2">
 \context Staff \with @{
-  \remove Time_signature_engraver
-  \remove Clef_engraver@}
+  \remove "Time_signature_engraver"
+  \remove "Clef_engraver"@}
   @{ c4( fis) @}
     </programlisting>
   </textobject>
@@ -832,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
@@ -991,9 +992,26 @@ 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@}}.
+@code{\begin@{lilypond@}@dots{}\end@{lilypond@}}.
 
 Il en va de même pour un certain nombre de variables appartenant au bloc
 @code{\paper}.  Utilisez, entre autres, un @code{\newcommand} avec la
@@ -1085,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},
@@ -1109,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.
@@ -1143,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},
@@ -1229,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@}
 
@@ -1257,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
@@ -1284,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>
@@ -1395,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)
@@ -1478,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}.
-