]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/fr/notation/input.itely
Doc-fr: updates LM, NR, Usage, Extending and Web
[lilypond.git] / Documentation / fr / notation / input.itely
index 0e6e671bc45dcdd5eadd20cbd42e3ad853c73ea3..12874cea4ff034b802f8b4ec18fbb0a3458f37c3 100644 (file)
@@ -1,14 +1,14 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
 
 @ignore
-    Translation of GIT committish: 44c3a53cb34d08a57838ae56c407216277e4c3f0
+    Translation of GIT committish: bd751630011a6fbfcf069ec1fc41a8eaed8a6b87
 
     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.6"
+@c \version "2.17.11"
 
 @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{}
@@ -304,17 +304,17 @@ de chaque bloc @code{\book}.
 \book @{
   \bookOutputSuffix "Romance"
   \score @{ @dots{} @}
-  \layout @{ @dots{} @}
+  \paper @{ @dots{} @}
 @}
 \book @{
   \bookOutputSuffix "Menuet"
   \score @{ @dots{} @}
-  \layout @{ @dots{} @}
+  \paper @{ @dots{} @}
 @}
 \book @{
   \bookOutputSuffix "Nocturne"
   \score @{ @dots{} @}
-  \layout @{ @dots{} @}
+  \paper @{ @dots{} @}
 @}
 @end example
 
@@ -325,17 +325,17 @@ le nom du fichier généré pour un bloc @code{\book} :
 \book @{
   \bookOutputName "Romance"
   \score @{ @dots{} @}
-  \layout @{ @dots{} @}
+  \paper @{ @dots{} @}
 @}
 \book @{
   \bookOutputName "Menuet"
   \score @{ @dots{} @}
-  \layout @{ @dots{} @}
+  \paper @{ @dots{} @}
 @}
 \book @{
   \bookOutputName "Nocturne"
   \score @{ @dots{} @}
-  \layout @{ @dots{} @}
+  \paper @{ @dots{} @}
 @}
 @end example
 
@@ -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
 
@@ -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}
@@ -824,6 +840,12 @@ 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
@@ -994,7 +1016,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 +1181,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 +1230,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 +1246,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.
@@ -1590,7 +1612,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 +1655,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 +1824,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 +2003,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 +2038,7 @@ libA/
   libA.ly
   A1.ly
   A2.ly
-  ...
+  @dots{}
 @end example
 
 @noindent
@@ -2026,7 +2048,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
@@ -2203,14 +2225,18 @@ manière suivante :
   @tab Résultat
 
 @item
-Musique balisée précédée de @code{\keepWithTag #'@var{nom}}
- @tab Musique non balisée et musique balisée par @var{nom} seront
- incluses ; la musique balisée autrement est exclue.
+Musique balisée précédée de @code{\keepWithTag #'@var{nom}} ou
+       @code{\keepWithTag #'(@var{nom1} @var{nom2}@dots{})}
+@tab Musique non balisée et musique balisée par l'un des noms de
+       balise fournis seront incluses ; la musique balisée
+       autrement est exclue.
 
 @item
-Musique balisée précédée de @code{\removeWithTag #'@var{nom}}
- @tab Musique non balisée et fragments appelés autrement que @var{nom}
- seront inclus ; la musique balisée par @var{nom} est exclue.
+Musique balisée précédée de @code{\removeWithTag #'@var{nom}} ou
+       @code{\removeWithTag #'(@var{nom1} @var{nom2}@dots{})}
+@tab Musique non balisée et fragments appelés autrement que par
+       l'un des noms fournis seront inclus ; la musique balisée
+       par autre chose que les noms mentionnés est exclue. 
 
 @item
 Musique balisée non précédée de @code{\keepWithTag} ou
@@ -2265,7 +2291,7 @@ music = \relative g' {
 }
 @end lilypond
 
-Ce principe de filtrage peut s'appliquer aux articulations, textes, etc.
+Ce principe de filtrage peut s'appliquer aux articulations, textes, etc.
 Il suffit de positionner
 
 @example
@@ -2285,12 +2311,13 @@ Ceci définira une note avec une indication conditionnelle de doigté ou
 un texte.
 
 Vous pouvez baliser différemment la même expression musicale en
-saisissant plusieurs @code{\tag} :
+saisissant plusieurs @code{\tag} ou bien en combinant plusieurs
+balises dans une liste :
 
 @lilypond[quote,verbatim]
 music = \relative c'' {
   \tag #'a \tag #'both { a4 a a a }
-  \tag #'b \tag #'both { b4 b b b }
+  \tag #'(b both) { b4 b b b }
 }
 <<
 \keepWithTag #'a \music
@@ -2300,7 +2327,9 @@ music = \relative c'' {
 @end lilypond
 
 L'application concomitante de plusieurs filtres @code{\removeWithTag} à
-la même expression musicale permet d'exclure plusieurs balisages :
+la même expression musicale permet d'exclure plusieurs balisages.
+Une liste fournie en argument à un unique @code{\removeWithTag}
+produira le même effet :
 
 @lilypond[verbatim,quote]
 music = \relative c'' {
@@ -2313,6 +2342,8 @@ music = \relative c'' {
 \removeWithTag #'B
 \removeWithTag #'C
 \music
+\removeWithTag #'(B C)
+\music
 }
 @end lilypond
 
@@ -2320,6 +2351,10 @@ L'application de plus d'un filtre @code{\keepWithTag} à la même
 expression musicale aboutit à l'exclusion de @b{tous} les balisages.
 En effet, si le premier filtre exclut tous les autres balisages,
 l'application du second exclura les effets du premier.
+L'utilisation d'une unique commande @code{\keepWithTag} avec une
+liste de balises est en pareil cas des plus pertinente : seront
+exclus tous les fragments non concernés par l'une quelconque des
+balises mentionnées.
 
 Il peut arriver que vous ayez besoin de raccorder quelque chose en un
 point particulier d'une expression musicale.  Les commandes
@@ -2355,17 +2390,15 @@ Manuel de notation :
 @ref{Regroupement automatique de parties},
 @ref{Insertion de fichiers LilyPond}.
 
-
-@ignore
-@c This warning is more general than this placement implies.
-@c Rests are not merged whether or not they come from tagged sections.
-@c Should be deleted?  -td
-
 @knownissues
-Lorsqu'elles comportent des silences, ceux-ci ne seront pas fusionnés
-si vous imprimez une partition avec les deux sections balisées.
-
-@end ignore
+L'application d'un @code{\relative} à une expression musicale
+obtenue par filtrage à l'aide de @code{\keepWithTag} ou
+@code{\removeWithTag} peut générer des changements d'octave,
+puisque seules les hauteurs récupérées dans ce filtre seront
+prises en considération.  Une instruction @code{\relative} qui
+précède les commandes @code{\keepWithTag} ou
+@code{\removeWithTag} permet d'éviter ce risque, dans la mesure où
+elle viendra « recaler » ces hauteurs récupérées.
 
 
 @node Globalisation des réglages
@@ -2659,7 +2692,7 @@ générer que les dernières mesures en insérant
 
 @verbatim
 showLastLength = R1*5
-\score { ... }
+\score { @dots{} }
 @end verbatim
 
 @noindent
@@ -2724,11 +2757,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
@@ -2799,7 +2832,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
@@ -2811,7 +2844,7 @@ un bloc @code{\layout}.
 
 @example
 \score @{
-  @var{...musique...}
+  @var{@dots{}musique@dots{}}
   \midi @{ @}
   \layout @{ @}
 @}
@@ -2901,13 +2934,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
 
@@ -2932,7 +2965,7 @@ imprimée.
 
 @example
 \score @{
-  @var{...musique...}
+  @var{@dots{}musique@dots{}}
   \midi @{
     \tempo 4 = 72
   @}
@@ -2946,7 +2979,7 @@ Par exemple, indiquer 90 à la noire pointée est équivalent à spécifier
 270 croches à la minute :
 
 @example
-tempoWholesPerMinute = #(ly:make-moment 270 8)
+tempoWholesPerMinute = #(ly:make-moment 270/8)
 @end example
 
 @cindex MIDI et définition de contexte
@@ -2965,7 +2998,7 @@ suffit d'insérer les lignes suivantes dans votre bloc
 
 @example
 \midi @{
-  ...
+  @dots{}
   \context @{
     \Voice
     \remove "Dynamic_performer"
@@ -3141,12 +3174,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
 
@@ -3227,7 +3260,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
@@ -3481,7 +3514,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
 
@@ -3606,7 +3639,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