]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/fr/notation/input.itely
Merge remote-tracking branch 'origin/translation'
[lilypond.git] / Documentation / fr / notation / input.itely
index 3b46db15869144ceaeb943e1a4a5f4a4e35a4431..cbf85e9763a40f556a7b1f8684bf10101096490c 100644 (file)
@@ -1,14 +1,14 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
 
 @ignore
-    Translation of GIT committish: 785441aeb8cc557217d1b0658ef88d058f58eeb4
+    Translation of GIT committish: 5c35684285613e8960e2dd4324559e1ee3774b9b
 
     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.11"
+@c \version "2.19.2"
 
 @c Translators: Jean-Charles Malahieude, Valentin Villenave
 
@@ -57,7 +57,7 @@ musicale délimitée par des accolades :
 
 @example
 \score @{
-...
+@dots{}
 @}
 @end example
 
@@ -104,11 +104,11 @@ Voici quelques exemples d'expression musicale :
 
 Les commentaires constituent l'une des rares exceptions à cette règle
 immuable -- voir @ref{Structure de fichier} pour les autres.  Qu'il
-s'agisse d'une seule ligne ou de tout un bloc -- délimité par @code{%@{
-.. %@}} -- un commentaire peut se placer n'importe où dans le fichier
-source, aussi bien à l'intérieur qu'à l'extérieur du bloc @code{\score},
-ou encore à l'intérieur ou à l'extérieur de l'expression musicale
-contenue dans un bloc @code{\score}.
+s'agisse d'une seule ligne ou de tout un bloc -- délimité par
+@code{%@{ @dots{} %@}} -- un commentaire peut se placer n'importe où
+dans le fichier source, aussi bien à l'intérieur qu'à l'extérieur du
+bloc @code{\score}, ou encore à l'intérieur ou à l'extérieur de
+l'expression musicale contenue dans un bloc @code{\score}.
 
 Lorsqu'un fichier ne comprend qu'un bloc @code{\score}, celui-ci est
 implicitement inclus dans un bloc @code{\book}.  Le bloc @code{\book}
@@ -145,7 +145,7 @@ différents mouvements.  Chaque mouvement fait l'objet d'un bloc
 
 @example
 \score @{
-  @var{..musique..}
+  @var{@dots{}musique@dots{}}
 @}
 @end example
 
@@ -153,7 +153,7 @@ et le texte est contenu dans un bloc @code{\markup},
 
 @example
 \markup @{
-  @var{..texte..}
+  @var{@dots{}texte@dots{}}
 @}
 @end example
 
@@ -165,13 +165,13 @@ résultant.
 
 @example
 \score @{
-  @var{..}
+  @var{@dots{}}
 @}
 \markup @{
-  @var{..}
+  @var{@dots{}}
 @}
 \score @{
-  @var{..}
+  @var{@dots{}}
 @}
 @end example
 
@@ -196,10 +196,10 @@ bloc @code{\book}.  Dans le cas contraire, le contenu du bloc
   \header @{ piece = "Romance" @}
 @}
 \markup @{
-   ..texte du second couplet..
+   @dots{}texte du second couplet@dots{}
 @}
 \markup @{
-   ..texte du troisième couplet..
+   @dots{}texte du troisième couplet@dots{}
 @}
 \score @{
   @dots{}
@@ -256,15 +256,15 @@ Ainsi, le fichier @file{huitminiatures.ly} qui contiendrait
 @example
 \book @{
   \score @{ @dots{} @}
-  \layout @{ @dots{} @}
+  \paper @{ @dots{} @}
 @}
 \book @{
   \score @{ @dots{} @}
-  \layout @{ @dots{} @}
+  \paper @{ @dots{} @}
 @}
 \book @{
   \score @{ @dots{} @}
-  \layout @{ @dots{} @}
+  \paper @{ @dots{} @}
 @}
 @end example
 
@@ -375,7 +375,7 @@ expression apparaît à plusieurs reprises à un niveau supérieur, les
 différents contenus seront combinés, à ceci près qu'en cas de
 déclarations conflictuelles, la dernière aura préséance.  Des
 informations complémentaires sont disponibles à la rubrique
-@ref{Le bloc \layout}.
+@ref{Le bloc layout}.
 
 @item
 Une expression Scheme pure, telle que
@@ -504,7 +504,7 @@ suivantes :
 Une ligne de commentaire, introduite par le signe @code{%}.
 
 @item
-Un bloc de commentaire, délimité par @code{%@{ .. %@}}.
+Un bloc de commentaire, délimité par @code{%@{ @dots{} %@}}.
 
 @end itemize
 
@@ -543,7 +543,7 @@ Manuel d'initiation :
 
 Manuel de notation :
 @ref{Généralités en matière de titrages},
-@ref{Le bloc \layout}.
+@ref{Le bloc layout}.
 
 
 @node Titres et entêtes
@@ -580,11 +580,19 @@ d'informations.
 
 Chaque bloc @code{\book} apparaissant dans un même fichier source
 résultera en un fichier indépendant, comme indiqué à la rubrique
-@ref{Structure de fichier}.  Chacun de ces fichiers résultants
-comporte deux endroits où placer des titrages : les @strong{titrages
-de partie} au début de chaque partie (@emph{bookpart}) et les
-@strong{titrages de morceau} avant chaque pièce (@emph{score}).  Tous
-deux peuvent comporter les mêmes champs bien que, par défaut, le titrage
+@ref{Structure de fichier}. Chacun de ces fichiers résultants comporte
+trois endroits où placer des titrages : le @strong{titrage de l'ouvrage}
+au début de chaque recueil (@emph{book}), les @strong{titrages de
+partie} au début de chaque partie (@emph{bookpart}) et les
+@strong{titrages de morceau} avant chaque pièce (@emph{score}).
+
+La valeur des champs de titrage @code{title} (le titre) et
+@code{composer} (le compositeur) se définissent dans des blocs
+@code{\header} -- la syntaxe appropriée et la liste des différents
+champs disponibles par défaut sont à la section
+@ref{Mise en forme par défaut des titrages subalternes}.
+Les titrages d'un ouvrage, de ses parties ou des morceaux qu'il contient
+peuvent tous comporter les même champs bien que, par défaut, le titrage
 d'un morceau se limite à @code{piece} et @code{opus}.
 
 Les blocs @code{\header} peuvent se placer à quatre endroits différents
@@ -614,6 +622,14 @@ hiérarchie ; les valeurs persisteront à moins d'être écrasées par une
 autre valeur à un niveau inférieur.  Ainsi :
 
 @itemize
+@item
+Le titre d'un ouvrage découle des champs définis en tête de fichier
+source, modifiés par les champs définis au sein du bloc @code{\book}.
+Les champs résultants serviront à affecter un titre de recueil à
+l'ouvrage, si tant est que quoi que ce soit génère une page au début de
+cet ouvrage, avant la première partie -- un simple saut de page forcé
+(@code{\pageBreak}) suffit.
+
 @item
 Le titre d'une partie découle des champs définis en tête du fichier
 source, modifiés par les champs définis au sein du bloc @code{\book}
@@ -748,7 +764,7 @@ Manuel de notation :
 Voici les différentes variables attachées au bloc @code{\header} :
 
 @c KEEP LY
-@lilypond[papersize=a7,quote,verbatim,noragged-right]
+@lilypond[papersize=a6landscape,quote,verbatim,noragged-right]
 \book {
   \header {
       % Les champs suivants sont centrés
@@ -824,12 +840,18 @@ la rubrique @ref{Mise en forme personnalisée des titrages}.
 
 @cindex breakbefore
 
+Un bloc @code{\book} qui commencerait directement par un bloc
+@code{\bookpart} ne verra pas ses titrages apparaître puisqu'il n'y a
+aucune page où imprimer le titre.  Si toutefois le titre de l'ouvrage
+est requis, le bloc @code{\book} devra commencer par un @emph{markup} ou
+une commande @code{\pageBreak}.
+
 La variable @code{breakbefore} activée dans un bloc @code{\header} situé
 dans un bloc @code{\score} force le saut de page avant le morceau
 contenu dans ce @code{\score}.  Vous pourrez ainsi séparer le titre
 principal de la musique.
 
-@lilypond[papersize=a8landscape,verbatim,noragged-right]
+@lilypond[papersize=c7landscape,verbatim,noragged-right]
 \book {
   \header {
     title = "This is my Title"
@@ -898,16 +920,6 @@ page, ou bien sous le @code{copyright} s'il n'y a qu'une seule page.
 
 @end itemize
 
-@lilypond[papersize=a8landscape]
-\book {
-  \score {
-    \relative c' {
-      c4 d e f
-    }
-  }
-}
-@end lilypond
-
 La mention spéciale se modifie en alimentant le champ @code{tagline} au
 niveau du bloc @code{\header} principal.
 
@@ -955,7 +967,7 @@ contenus dans un bloc @code{\header}.
   { s1 }
   \header {
     piece = \markup { \fontsize #4 \bold "PRAELUDIUM I" }
-    opus = \markup { \italic "(Excerpt)" }
+    opus = \markup { \italic "BWV 846" }
   }
 }
 @end lilypond
@@ -994,7 +1006,7 @@ définis dans le fichier @file{ly/titling-init.ly} :
 
 @example
 scoreTitleMarkup = \markup @{ \column @{
-  \on-the-fly #print-all-headers @{ \bookTitleMarkup \hspace #1 @}
+  \on-the-fly \print-all-headers @{ \bookTitleMarkup \hspace #1 @}
   \fill-line @{
     \fromproperty #'header:piece
     \fromproperty #'header:opus
@@ -1159,9 +1171,9 @@ En voici la syntaxe :
 
 @example
 @code{variable} = @code{\markup} @{
-  ...
-  @code{\on-the-fly} #@var{procédure} @var{markup}
-  ...
+  @dots{}
+  @code{\on-the-fly} \@var{procédure} @var{markup}
+  @dots{}
 @}
 @end example
 
@@ -1208,7 +1220,7 @@ Enfin, nous appliquons le même paramétrage au @code{\oddFooterMarkup}.
     evenHeaderMarkup = \markup \null
     oddFooterMarkup = \markup {
       \fill-line {
-        \on-the-fly #print-page-number-check-first
+        \on-the-fly \print-page-number-check-first
         \fromproperty #'page:page-number-string
       }
     }
@@ -1224,9 +1236,9 @@ Plusieurs conditions @code{\on-the-fly} mentionnées l'une à la suite de
 l'autre se cumulent.  Ainsi, par exemple,
 
 @example
-  @code{\on-the-fly #first-page}
-  @code{\on-the-fly #last-page}
-  @code{@{ \markup ... \fromproperty #'header: ... @}}
+  @code{\on-the-fly \first-page}
+  @code{\on-the-fly \last-page}
+  @code{@{ \markup @dots{} \fromproperty #'header: @dots{} @}}
 @end example
 
 teste si la sortie tient sur une page unique.
@@ -1535,7 +1547,7 @@ l'objet est créé dans un autre contexte que celui du plus bas niveau.
     \footnote #'(-0.5 . 1) "Barre de mesure" Staff.BarLine
     q q
     \footnote #'(0.5 . -1) "Changement d'armure" Staff.KeySignature
-    \key c\minor
+    \key c \minor
     q
   }
 }
@@ -1590,7 +1602,7 @@ La syntaxe consacrée dans le cas d'une gestion automatique des appels
 de note est :
 
 @example
-\markup @{ ... \auto-footnote @var{texte} @var{annotation} ... @}
+\markup @{ @dots{} \auto-footnote @var{texte} @var{annotation} @dots{} @}
 @end example
 
 Ses les éléments sont :
@@ -1633,7 +1645,7 @@ La syntaxe consacrée dans le cas d'une gestion personnalisée des appels
 de note est :
 
 @example
-\markup @{ ... \footnote @var{appel} @var{annotation} ... @}
+\markup @{ @dots{} \footnote @var{appel} @var{annotation} @dots{} @}
 @end example
 
 Ses les éléments sont :
@@ -1802,16 +1814,16 @@ d'une expression musicale.
 \tocItem \markup "Premier mouvement"
 \score {
   {
-    c'4  % ...
+    c'4  % @dots{}
     \tocItem \markup "Passage spécifique du premier mouvement"
-    d'4  % ...
+    d'4  % @dots{}
   }
 }
 
 \tocItem \markup "Second mouvement"
 \score {
   {
-    e'4 % ...
+    e'4 % @dots{}
   }
 }
 @end verbatim
@@ -1981,7 +1993,7 @@ répertoire courant, vous devrez mentionner
 @example
 \include "parties/VI.ly"
 \include "parties/VII.ly"
-... etc.
+etc.
 @end example
 
 Les fichiers à inclure peuvent eux-mêmes contenir des instructions
@@ -2016,7 +2028,7 @@ libA/
   libA.ly
   A1.ly
   A2.ly
-  ...
+  @dots{}
 @end example
 
 @noindent
@@ -2026,7 +2038,7 @@ puis le fichier catalogue, @code{libA.ly}, qui contient
 #(ly:set-option 'relative-includes #t)
 \include "A1.ly"
 \include "A2.ly"
-...
+@dots{}
 % retour au réglage par défaut
 #(ly:set-option 'relative-includes #f)
 @end example
@@ -2311,17 +2323,17 @@ produira le même effet :
 
 @lilypond[verbatim,quote]
 music = \relative c'' {
-\tag #'A { a4 a a a }
-\tag #'B { b4 b b b }
-\tag #'C { c4 c c c }
-\tag #'D { d4 d d d }
+  \tag #'A { a4 a a a }
+  \tag #'B { b4 b b b }
+  \tag #'C { c4 c c c }
+  \tag #'D { d4 d d d }
 }
-{
-\removeWithTag #'B
-\removeWithTag #'C
-\music
-\removeWithTag #'(B C)
-\music
+\new Voice {
+  \removeWithTag #'B
+  \removeWithTag #'C
+  \music
+  \removeWithTag #'(B C)
+  \music
 }
 @end lilypond
 
@@ -2534,7 +2546,7 @@ dans des paroles et dans du texte indépendant.
   }
   \addlyrics { O \markup { \concat { Ph \char ##x0153 be! } } }
 }
-\markup { "Copyright 2008--2012" \char ##x00A9 }
+\markup { "Copyright 2008--2014" \char ##x00A9 }
 @end lilypond
 
 @cindex copyright
@@ -2668,10 +2680,10 @@ en êtes dans la notation.  Dans le but de gagner du temps dans le
 processus de correction, vous pouvez @qq{escamoter} le reste et ne
 générer que les dernières mesures en insérant
 
-@verbatim
+@example
 showLastLength = R1*5
-\score { ... }
-@end verbatim
+\score @{ @dots{} @}
+@end example
 
 @noindent
 dans votre fichier source.  Ceci aura pour effet de ne générer que les
@@ -2735,11 +2747,11 @@ Voici quelques mesures utilisant la police Gonville :
 
 @c NOTE: these images are a bit big, but that's important
 @c       for the font comparison.  -gp
-@sourceimage{Gonville_after,,,}
+@sourceimage{Gonville_after,15cm,,}
 
 Et ces même mesures avec la police de LilyPond, Feta :
 
-@sourceimage{Gonville_before,,,}
+@sourceimage{Gonville_before,15cm,,}
 
 
 @subsubheading Instructions d'installation pour MacOS
@@ -2810,7 +2822,7 @@ LilyPond générera un fichier MIDI dès que vous ajouterez un bloc
 
 @example
 \score @{
-  @var{...musique...}
+  @var{@dots{}musique@dots{}}
   \midi @{ @}
 @}
 @end example
@@ -2822,7 +2834,7 @@ un bloc @code{\layout}.
 
 @example
 \score @{
-  @var{...musique...}
+  @var{@dots{}musique@dots{}}
   \midi @{ @}
   \layout @{ @}
 @}
@@ -2912,13 +2924,13 @@ instruments répertoriés à l'annexe @ref{Instruments MIDI}.
 @example
 \new Staff @{
   \set Staff.midiInstrument = #"glockenspiel"
-  @var{...notes...}
+  @var{@dots{}notes@dots{}}
 @}
 @end example
 
 @example
 \new Staff \with @{midiInstrument = #"cello"@} @{
-  @var{...notes...}
+  @var{@dots{}notes@dots{}}
 @}
 @end example
 
@@ -2943,7 +2955,7 @@ imprimée.
 
 @example
 \score @{
-  @var{...musique...}
+  @var{@dots{}musique@dots{}}
   \midi @{
     \tempo 4 = 72
   @}
@@ -2976,7 +2988,7 @@ suffit d'insérer les lignes suivantes dans votre bloc
 
 @example
 \midi @{
-  ...
+  @dots{}
   \context @{
     \Voice
     \remove "Dynamic_performer"
@@ -3152,12 +3164,12 @@ symboles de pourcentage.  Par exemple
 
 @example
 \score @{
-  @var{..musique..}
-  \layout @{ ..  @}
+  @var{@dots{}musique@dots{}}
+  \layout @{ @dots{}  @}
 @}
 \score @{
-  \unfoldRepeats @var{..musique..}
-  \midi @{ .. @}
+  \unfoldRepeats @var{@dots{}musique@dots{}}
+  \midi @{ @dots{} @}
 @}
 @end example
 
@@ -3238,7 +3250,7 @@ Le dernier exemple de cette partie illustre la manière de procéder.
 Les valeurs extrêmes du volume MIDI des nuances se contrôlent à l'aide
 des propriétés @code{midiMinimumVolume} et @code{midiMaximumVolume} qui
 agissent au niveau @code{Score}.  Ces propriétés sont effectives dès
-lors qu'une nuance est indiquée ; une nuance de départ est donc
+lors qu'une nuance est indiquée ; une nuance de départ explicite est donc
 requise pour que le volume soit ajusté dès le début de la partition.
 Vous pouvez alors modifier la fraction correspondant à chaque nuance à
 l'aide de la formule
@@ -3259,8 +3271,8 @@ entre 0,2 et 0,5 :
       \set Staff.midiInstrument = #"flute"
       \new Voice \relative c''' {
         r2 g\mp g fis~
-        fis4 g8 fis e2~
-        e4 d8 cis d2
+        4 g8 fis e2~
+        4 d8 cis d2
       }
     }
     \new Staff {
@@ -3311,8 +3323,8 @@ indication de nuance.
       \set Staff.midiMaximumVolume = #0.9
       \new Voice \relative c''' {
         r2 g\mp g fis~
-        fis4 g8 fis e2~
-        e4 d8 cis d2
+        4 g8 fis e2~
+        4 d8 cis d2
       }
     }
     \new Staff {
@@ -3383,8 +3395,8 @@ flûte et de la clarinette -- au même niveau que dans le précédent.
       \set Staff.midiInstrument = #"flute"
       \new Voice \relative c''' {
         r2 g\mp g fis~
-        fis4 g8 fis e2~
-        e4 d8 cis d2
+        4 g8 fis e2~
+        4 d8 cis d2
       }
     }
     \new Staff {
@@ -3492,7 +3504,7 @@ seront développées et appliquer la commande à votre musique :
 
 @example
 \unfoldRepeats \articulate <<
-       tout le reste du bloc contenant la partition...
+       tout le reste du bloc contenant la partition@dots{}
 >>
 @end example
 
@@ -3551,8 +3563,7 @@ affichera
 LilyPond affichera le résultat sous forme de message en console, au
 milieu de toutes les informations de compilation.  Afin d'isoler ces
 messages et enregistrer le résultat de la fonction
-@code{\display@{MATÉRIAU@}}, pensez à rediriger la sortie vers un
-fichier.
+@code{\displayLilyMusic}, pensez à rediriger la sortie vers un fichier.
 
 @example
 lilypond fichier.ly > affichage.txt
@@ -3617,7 +3628,7 @@ tabulation.  Chaque ligne comporte deux champs fixes suivis d'un certain
 nombre de paramètres optionnels.
 
 @example
-@var{temps}  @var{type}  @var{...paramètres...}
+@var{temps} @var{type} @var{@dots{}paramètres@dots{}}
 @end example
 
 Ces informations peuvent faire l'objet d'un retraitement par d'autres