]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/fr/usage/running.itely
Imported Upstream version 2.18.0
[lilypond.git] / Documentation / fr / usage / running.itely
index fed75db4b2741e862ca8a8893742223d83e51239..ed19eac212b1fb37f800cb82fd682ebfef76a620 100644 (file)
@@ -1,14 +1,14 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
 
 @ignore
-    Translation of GIT committish: eea3764cd6bbc78506261f78ed4e7745ac69df41
+    Translation of GIT committish: a9d95f320e4b9fe65e0655911ea7b55bf0d10b2b
 
     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.16.0"
+@c \version "2.17.6"
 
 @c Translators: Jean-Charles Malahieude
 @c Translation checkers:
@@ -150,12 +150,12 @@ Différentes options sont disponibles en ligne de commande :
 
 @table @code
 
-@item -d,--define-default=@var{variable}=@var{valeur}
+@item -d, --define-default=@var{variable}=@var{valeur}
 Voir @ref{Options avancées de lilypond}.
 
 @cindex Scheme, évaluation d'expression
 @cindex expression Scheme, évaluation
-@item -e,--evaluate=@var{expr}
+@item -e, --evaluate=@var{expr}
 Évalue l'expression Scheme @var{expr} avant d'analyser tout fichier
 @file{.ly}.  Lorsque vous spécifiez l'option @option{-e} à plusieurs
 reprises, l'évaluation sera faite en séquence.
@@ -184,25 +184,25 @@ doubles @code{"} en lieu et place des guillemets simples @code{'}.}
 
 @cindex sortie, format
 @cindex format de sortie
-@item -f,--format=@var{format}
+@item -f, --format=@var{format}
 Détermine le format à produire.  Il peut s'agir de @code{ps}, @code{pdf}
 ou @code{png}.
 
 Exemple : @code{lilypond -fpng @var{monfichier}.ly}
 
-@item -h,--help
+@item -h, --help
 Affiche un résumé des commandes.
 
-@item -H,--header=@var{CHAMP}
+@item -H, --header=@var{CHAMP}
 Recopie le champ d'entête dans le fichier @file{RACINE.@var{CHAMP}}.
 
-@item -i,--init=@var{fichier}
+@item -i, --init=@var{fichier}
 Définit @var{fichier} (par défaut @file{init.ly}) en tant que fichier
 d'initialisation.
 
 @cindex recherche de fichier
 @cindex chemin de recherche
-@item -I,--include=@var{répertoire}
+@item -I, --include=@var{répertoire}
 Ajoute @var{répertoire} au chemin de recherche pour les inclusions.
 
 Vous pouvez mentionner plusieurs fois l'option @option{-I}, auquel cas
@@ -211,7 +211,7 @@ fichier en question ne s'y trouve pas, les répertoires suivants seront
 examinés l'un après l'autre.
 
 @cindex chroot jail, fonctionnement
-@item -j,--jail=@var{user},@var{group},@var{jail},@var{dir}
+@item -j, --jail=@var{user},@var{group},@var{jail},@var{dir}
 Lance @command{lilypond} dans un environnement protégé.
 
 L'option @option{--jail} est une alternative qui offre plus de
@@ -279,7 +279,7 @@ mémoire.  Voir aussi @ref{Exécution de LilyPond en mode protégé}.
 
 @cindex loglevel
 @cindex verbosité, définir le degré de
-@item -l,--loglevel=@var{DEGRÉ}
+@item -l, --loglevel=@var{DEGRÉ}
 Règle le niveau de verbosité des messages console à @var{DEGRÉ}.  Les
 différentes valeurs sont :
 
@@ -314,7 +314,7 @@ Tout ce qui peut être affiché, y compris le verbiage utile au débogage.
 @cindex redirection
 @cindex répertoire de destination
 @cindex fichier de destination
-@item -o,--output=@var{FICHIER} ou @var{RÉPERTOIRE}
+@item -o, --output=@var{FICHIER} ou @var{RÉPERTOIRE}
 Détermine le nom par défaut du fichier résultant à @var{FICHIER} ;
 lorsque l'argument @var{RÉPERTOIRE} correspond à un répertoire déjà
 existant, c'est là que les fichiers résultants seront déposés.  Le
@@ -341,14 +341,14 @@ se régler en ajoutant par exemple
 @item --pdf
 Génère du PDF.  Ceci sous-entend l'utilisation de @option{--ps}.
 
-@item -v,--version
+@item -v, --version
 Affiche le numéro de version.
 
-@item -V,--verbose
+@item -V, --verbose
 Active le mode verbeux : affichage de l'intégralité du chemin
 d'accès de chaque fichier, et information des temps de traitement.
 
-@item -w,--warranty
+@item -w, --warranty
 Affiche les informations de garantie applicables à GNU LilyPond -- il
 est livré @strong{SANS GARANTIE} !
 
@@ -361,11 +361,17 @@ 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.  En l'absence de @var{valeur}, le
-programme utilisera @var{#t}. Préfixer @var{nom-option} d'un @code{no-}
-vous permet de désactiver une option.  Ainsi,
+@var{nom-option} du programme.
+
+@example
+-dbackend=svg
+@end example
+
+En l'absence de @var{valeur}, le programme utilisera @var{#t}.
+Préfixer @var{nom-option} d'un @code{no-} vous permet de
+désactiver une option.  Ainsi,
 
 @cindex point and click, ligne de commande
 @cindex pointer-cliquer, ligne de commande
@@ -402,7 +408,7 @@ images @code{PNG}.
 pour le moteur de rendu @code{EPS}.
 
 @item @code{backend}
-@tab @code{'ps}
+@tab @code{ps}
 @tab Détermine le format de sortie à utiliser par le moteur de
 traitement.  Les fichiers PostScript (format par défaut) incluent les
 fontes @code{TTF}, @code{Type1} et @code{OTF}, et aucune substitution ne
@@ -410,7 +416,7 @@ sera opérée pour ces fontes.  Si vous utilisez des jeux de caractères
 orientaux, le fichier aura vite fait d'atteindre une taille conséquente.
 
 @item
-@tab @code{'eps}
+@tab @code{eps}
 @tab Génère du PostScript encapsulé.  Chaque page (système) fera l'objet
 d'un fichier @file{EPS} particulier, sans fontes, auquel sera associé un
 fichier @file{EPS} qui, lui, contiendra toutes les pages (systèmes) et
@@ -418,12 +424,12 @@ les fontes.  Notez qu'il s'agit du mode que @command{lilypond-book}
 utilise par défaut.
 
 @item
-@tab @code{'null}
+@tab @code{null}
 @tab Ne génère aucun fichier imprimable.  Cette option est équivalente à
 @code{-dno-print-pages}.
 
 @item
-@tab @code{'svg}
+@tab @code{svg}
 @tab Génère du@emph{Scalable Vector Graphics}.  Cette option permet de
 créer un fichier @code{SVG} par page, sans incorporation des fontes.
 Nous vous recommandons d'installer les fontes Century Schoolbook
@@ -435,7 +441,7 @@ Les fichiers @code{SVG} alors générés devraient être lisibles par votre
 permet d'utiliser les fontes @code{woff} avec le moteur @code{SVG}.
 
 @item
-@tab @code{'scm}
+@tab @code{scm}
 @tab Recopie littéralement les commandes Scheme internes de formatage.
 
 @item @code{check-internal-types}
@@ -572,11 +578,6 @@ donnée en argument.
 @tab Convertit les chaînes textuelles en chemins lorsque les glyphes
 font partie d'une fonte musicale.
 
-@item @code{old-relative}
-@tab @code{#f}
-@tab Affecte au mode @code{\relative} le même comportement pour de la
-musique simultanée que celui d'une syntaxe d'accords.
-
 @cindex paper-size, ligne de commande
 @item @code{paper-size}
 @tab @code{\"a4\"}
@@ -999,10 +1000,10 @@ facilement.
 @menu
 * La musique déborde de la page::
 * Apparition d'une portée supplémentaire::
-* Erreur renvoyant à ../ly/init.ly::
 * Message d'erreur Unbound variable %::
 * Message d'erreur FT_Get_Glyph_Name::
 * staff-affinities devraient aller en ordre décroissant::
+* Message d'erreur unexpected new::
 @end menu
 
 
@@ -1051,7 +1052,7 @@ 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]
-\override Staff.NoteHead #'color = #red
+\override Staff.NoteHead.color = #red
 \new Staff { a }
 @end lilypond
 
@@ -1064,7 +1065,7 @@ ces notes en rouge :
 
 @lilypond[quote,verbatim,relative=2]
 \new Staff {
-  \override Staff.NoteHead #'color = #red
+  \override Staff.NoteHead.color = #red
   a
 }
 @end lilypond
@@ -1093,41 +1094,8 @@ La manière adéquate de procéder consiste à inverser les commandes
 @end lilypond
 
 
-@node Erreur renvoyant à ../ly/init.ly
-@unnumberedsubsec Erreur renvoyant à @code{../ly/init.ly}
-@translationof Apparent error in ../ly/init.ly
-
-Certains messages d'erreur relatifs à une erreur de syntaxe dans le
-fichier @file{../ly/init.ly} peuvent survenir lorsque le fichier est mal
-formaté.  Cela se produit notamment lors d'un défaut de parité de
-bornages ou de guillemets.
-
-L'erreur la plus courante est la simple omission d'une accolade
-fermante (@code{@}}) à la fin du bloc @code{Score}.  La solution est
-évidente en pareil cas : il suffit de vérifier que le bloc
-@code{Score} est bien clôturé.  La structure des fichiers LilyPond est
-abordée plus en détails au chapitre
-@rlearning{Organisation des fichiers LilyPond}.  C'est la raison pour
-laquelle nous vous invitons à utiliser un éditeur de texte qui prenne en
-charge le contrôle de parité des parenthèses, crochets et accolades afin
-de vous éviter de telles erreurs.
-
-Autre erreur courante, l'absence d'espace entre la dernière syllabe et
-l'accolade (@code{@}}) clôturant un bloc de paroles.  Lorsqu'il n'y a
-pas séparation, l'accolade est considérée comme faisant partie
-intégrante de la syllabe.  C'est la raison pour laquelle nous vous
-invitons à insérer une espace avant et après @strong{chaque} accolade.
-D'autres informations à ce sujets sont mentionnées au chapitre
-@ruser{Saisie des paroles}.
-
-Lorsqu'il s'agit d'un guillemet fermant (@code{"}) omis, le message
-d'erreur devrait vous indiquer un numéro de ligne avoisinant.  L'erreur
-se situe la plupart du temps une ou deux lignes au-dessus de celle
-indiquée.
-@c Match quote character "
-
 @node Message d'erreur Unbound variable %
-@unnumberedsubsec Message d'erreur Unbound variable %
+@unnumberedsubsec Message d'erreur @code{Unbound variable %}
 @translationof Error message Unbound variable %
 
 Ce message d'erreur, qu'il apparaisse sur le terminal ou en fin de
@@ -1141,7 +1109,7 @@ les commentaires s'introduisent par un point-virgule (@code{;}).
 
 
 @node Message d'erreur FT_Get_Glyph_Name
-@unnumberedsubsec Message d'erreur FT_Get_Glyph_Name
+@unnumberedsubsec Message d'erreur @code{FT_Get_Glyph_Name}
 @translationof Error message FT_Get_Glyph_Name
 
 Ce message d'erreur, qu'il apparaisse sur le terminal ou en fin de
@@ -1152,7 +1120,7 @@ UTF-8.  Pour plus de détails, reportez-vous au chapitre
 
 
 @node staff-affinities devraient aller en ordre décroissant
-@unnumberedsubsec staff-affinities devraient aller en ordre décroissant
+@unnumberedsubsec @emph{staff-affinities} devraient aller en ordre décroissant
 @translationof Warning staff affinities should only decrease
 
 Cet avertissement est émis lorsque la partition ne comporte pas de
@@ -1162,10 +1130,61 @@ dès lors que vous autoriserez l'un de ces contextes à se comporter comme
 une portée, à l'aide de l'instruction
 
 @example
-\override VerticalAxisGroup #'staff-affinity = ##f
+\override VerticalAxisGroup.staff-affinity = ##f
 @end example
 
 @noindent
 que vous insérerez dès sa création.  Pour plus d'information,
 reportez-vous à la rubrique
 @ruser{Espacement des lignes rattachées à des portées}.
+
+
+@node Message d'erreur unexpected new
+@unnumberedsubsec Message d'erreur unexpected @code{@bs{}new}
+@translationof Error message unexpected new
+
+Un bloc @code{\score} ne peut contenir qu'@strong{une seule} expression
+musicale. Si, par contre, il comporte plusieurs @code{\new Staff},
+@code{\new StaffGroup} ou autres contextes introduits par une commande
+@code{\new} qui ne seraient pas bornés par des accolades
+@code{@{ @dots{} @}} ou des doubles chevrons @code{<< @dots{} >>} comme
+ici :
+
+@example
+\score @{
+  % Invalide ! Génère l'erreur : syntax error, unexpected \new
+  % en français : erreur de syntaxe : \new inattendu
+  \new Staff @{ @dots{} @}
+  \new Staff @{ @dots{} @}
+@}
+@end example
+
+@noindent
+vous obtiendrez ce message d'erreur.
+
+Cette erreur sera évitée dès lors que toutes les instances de
+@code{\new} sont bornées par des accolades ou des doubles chevrons.
+
+Des accolades placeront ces clauses @code{\new} en séquence :
+
+@lilypond[quote,verbatim]
+\score {
+  {
+    \new Staff { a' a' a' a' }
+    \new Staff { g' g' g' g' }
+  }
+}
+@end lilypond
+
+@noindent
+alors que des doubles chevrons les placeront en parallèle ; autrement
+dit, LilyPond les traitera simultanément :
+
+@lilypond[quote,verbatim]
+\score {
+  <<
+    \new Staff { a' a' a' a' }
+    \new Staff { g' g' g' g' }
+  >>
+}
+@end lilypond