@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
@ignore
- Translation of GIT committish: eea3764cd6bbc78506261f78ed4e7745ac69df41
+ Translation of GIT committish: 0a003d729ded8b728bf627c87c196719676dba6b
When revising a translation, copy the HEAD committish of the
version that you are working on. For details, see the Contributors'
@end ignore
-@c \version "2.16.0"
+@c \version "2.17.11"
@c Translators: Jean-Charles Malahieude
@c Translation checkers:
\begin{lilypond}
\relative c' {
- c2 e2 \times 2/3 { f8 a b } a2 e4
+ c2 e2 \tuplet 3/2 { f8 a b } a2 e4
}
\end{lilypond}
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
@lilypond
\relative c' {
- c2 e2 \times 2/3 { f8 a b } a2 e4
+ c2 e2 \tuplet 3/2 { f8 a b } a2 e4
}
@end lilypond
@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
@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
@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
@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
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
<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>
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
@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},
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.
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},
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}.
-