]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/fr/notation/editorial.itely
Issue 4894: Remove unescaped @funindex entries
[lilypond.git] / Documentation / fr / notation / editorial.itely
index ac33088e47c501cac7d445dffca55c0d316ab69e..61d33e7a8eef3917c5e8e8dc91f4e20a4b3108d7 100644 (file)
@@ -1,14 +1,14 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
 
 @ignore
-    Translation of GIT committish: ece268fa66e2576c01f33a4a6e1806f44c9f8fa8
+   Translation of GIT committish: 16d46fb0995cc6d078617ada1e8fea7879dffe07
 
-    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..
+   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.21"
 
 @c Translators: Jean-Charles Malahieude
 
@@ -154,30 +154,17 @@ L'ajustement de la propriété @code{font-size} à l'aide des commandes
 @code{\tweak} ou @code{\override} permet de retailler un objet de rendu
 particulier :
 
-@lilypond[quote,verbatim,relative=1]
-% resize a note head
-<f \tweak font-size -4 b e>-5
-% resize a fingering
-bes-\tweak font-size 0 -3
-% resize an accidental
-\once \override Accidental.font-size = -4 bes!-^
-% resize an articulation
-\once \override Script.font-size = 4 bes!-^
-@end lilypond
-
-@lilypond[verbatim,quote,relative=2]
-\huge
-c4.-> d8---3
-\large
-c4.-> d8---3
-\normalsize
-c4.-> d8---3
-\small
-c4.-> d8---3
-\tiny
-c4.-> d8---3
-\teeny
-c4.-> d8---3
+@lilypond[quote,verbatim]
+\relative {
+  % resize a note head
+  <f' \tweak font-size -4 b e>-5
+  % resize a fingering
+  bes-\tweak font-size 0 -3
+  % resize an accidental
+  \once \override Accidental.font-size = -4 bes!-^
+  % resize an articulation
+  \once \override Script.font-size = 4 bes!-^
+}
 @end lilypond
 
 La valeur par défaut de @code{font-size} est mentionnée, pour chaque
@@ -196,14 +183,16 @@ La propriété @code{fontSize} d'un contexte a pour effet de définir la
 taille proportionnelle de tout élément de notation basé sur un
 glyphe dans ce contexte :
 
-@lilypond[verbatim,quote,relative=2]
-\time 3/4
-d4---5 c8( b a g) |
-\set fontSize = -6
-e'4-- c!8-4( b a g) |
-\set fontSize = 0
-fis4---3 e8( d) fis4 |
-g2.
+@lilypond[verbatim,quote]
+\relative {
+  \time 3/4
+  d''4---5 c8( b a g) |
+  \set fontSize = -6
+  e'4-- c!8-4( b a g) |
+  \set fontSize = 0
+  fis4---3 e8( d) fis4 |
+  g2.
+}
 @end lilypond
 
 La valeur de @code{fontSize} est un nombre indiquant la taille
@@ -245,19 +234,19 @@ rendu.  Ceci peut être source de confusion lorsque des propriétés
 @code{font-size} individuelles sont réglées alors que
 @code{fontSize} est déjà fixé :
 
-@lilypond[verbatim,quote,relative=2]
+@lilypond[verbatim,quote,fragment]
 % the default font-size for NoteHead is 0
 % the default font-size for Fingering is -5
-c4-3
+c''4-3
 
 \set fontSize = -3
 % the effective font size for NoteHead is now -3
 % the effective font size for Fingering is now -8
-c4-3
+c''4-3
 
 \override Fingering.font-size = 0
 % the effective font size for Fingering is now -3
-c4-3
+c''4-3
 @end lilypond
 
 LilyPond dispose d'un certain nombre de raccourcis :
@@ -272,19 +261,21 @@ LilyPond dispose d'un certain nombre de raccourcis :
 @item @code{\huge}       @tab @code{\set fontSize = 2} @tab 126 %
 @end multitable
 
-@lilypond[verbatim,quote,relative=2]
-\teeny
-c4.-> d8---3
-\tiny
-c4.-> d8---3
-\small
-c4.-> d8---3
-\normalsize
-c4.-> d8---3
-\large
-c4.-> d8---3
-\huge
-c4.-> d8---3
+@lilypond[verbatim,quote]
+\relative c'' {
+  \teeny
+  c4.-> d8---3
+  \tiny
+  c4.-> d8---3
+  \small
+  c4.-> d8---3
+  \normalsize
+  c4.-> d8---3
+  \large
+  c4.-> d8---3
+  \huge
+  c4.-> d8---3
+}
 @end lilypond
 
 @cindex standard, taille des notes
@@ -297,7 +288,7 @@ Pour changer la taille des caractères, LilyPond met à l'échelle la fonte
 dont la taille est la plus proche de la taille voulue.  La taille
 standard (pour laquelle @code{font-size = 0}) dépend de la hauteur
 de la portée.  À une portée de 20 points correspond une police de
-10 points.
+11 points.
 
 
 @predefined
@@ -312,10 +303,10 @@ de la portée.  À une portée de 20 points correspond une police de
 
 @seealso
 Manuel de notation :
-@ref{Sélection de la fonte et de la taille},
 @ref{Définition de la taille de portée},
 @ref{Mise en forme d'une citation},
-@ref{Portées d'ossia}.
+@ref{Portées d'ossia},
+@ref{Sélection de la fonte et de la taille}.
 
 Fichiers d'initialisation :
 @file{ly/music-functions-init.ly},
@@ -343,7 +334,7 @@ et @code{\revert} :
 \magnifyMusic @var{mag} @{
   \newSpacingSection
   \override Score.SpacingSpanner.spacing-increment = #(* 1.2 @var{mag})
-  @var{[musique]}
+  [@var{musique}]
   \newSpacingSection
   \revert Score.SpacingSpanner.spacing-increment
 @}
@@ -358,34 +349,33 @@ et @code{\revert} :
 @cindex substitution de doigt
 
 @funindex \finger
-@funindex finger
 
 Les doigtés peuvent être indiqués comme suit :
 @var{note}-@var{chiffre_du_doigt}
 
-@lilypond[verbatim,quote,relative=2]
-c4-1 d-2 f-4 e-3
+@lilypond[verbatim,quote]
+\relative { c''4-1 d-2 f-4 e-3 }
 @end lilypond
 
 Pour les substitutions de doigts, on a recours à une indication
-textuelle (commande @code{\markup}) de doigté
-(commande @code{\finger}).
+textuelle (commande @code{\markup}) de doigté (commande @code{\finger}).
 
-@lilypond[verbatim,quote,relative=2]
-c4-1 d-2 f\finger \markup \tied-lyric #"4~3" c\finger "2 - 3"
+@lilypond[verbatim,quote]
+\relative {
+  c''4-1 d-2 f\finger \markup \tied-lyric #"4~3" c\finger "2 - 3"
+}
 @end lilypond
 
 @cindex pouce, doigté
 
 @funindex \thumb
-@funindex thumb
 
 La commande @code{\thumb} peut être utilisée pour indiquer, par exemple
 dans une partition de violoncelle, si une note doit être jouée avec le
 pouce (@emph{thumb} en anglais).
 
-@lilypond[verbatim,quote,relative=2]
-<a_\thumb a'-3>2 <b_\thumb b'-3>
+@lilypond[verbatim,quote]
+\relative { <a'_\thumb a'-3>2 <b_\thumb b'-3> }
 @end lilypond
 
 @cindex doigtés des accords
@@ -394,8 +384,10 @@ pouce (@emph{thumb} en anglais).
 Les doigtés des accords peuvent être saisis note par note,
 en les indiquant après chaque hauteur de note.
 
-@lilypond[verbatim,quote,relative=2]
-<c-1 e-2 g-3 b-5>2 <d-1 f-2 a-3 c-5>
+@lilypond[verbatim,quote]
+\relative {
+  <c''-1 e-2 g-3 b-5>2 <d-1 f-2 a-3 c-5>
+}
 @end lilypond
 
 Les indications de doigtés peuvent se placer au-dessus ou en dessous de
@@ -438,23 +430,23 @@ Référence des propriétés internes :
 @cindex note masquée
 
 @funindex \hideNotes
-@funindex hideNotes
 @funindex \unHideNotes
-@funindex unHideNotes
 
 Les notes masquées -- ou invisibles ou encore transparentes -- sont
 utiles dans le cadre d'exercices de théorie ou de composition.
 
-@lilypond[verbatim,quote,relative=2]
-c4 d
-\hideNotes
-e4 f
-\unHideNotes
-g a
-\hideNotes
-b
-\unHideNotes
-c
+@lilypond[verbatim,quote]
+\relative {
+  c''4 d
+  \hideNotes
+  e4 f
+  \unHideNotes
+  g a
+  \hideNotes
+  b
+  \unHideNotes
+  c
+}
 @end lilypond
 
 Têtes de note, hampes, crochets et silences sont invisibles.  Une
@@ -462,10 +454,12 @@ ligature sera invisible si elle démarre sur une note invisible.
 Les objets de notation attachés à une note invisible ne seront pas
 masqués pour autant.
 
-@lilypond[verbatim,quote,relative=2]
-e8(\p f g a)--
-\hideNotes
-e8(\p f g a)--
+@lilypond[verbatim,quote]
+\relative c'' {
+  e8(\p f g a)--
+  \hideNotes
+  e8(\p f g a)--
+}
 @end lilypond
 
 @predefined
@@ -478,9 +472,9 @@ Manuel d'initiation :
 @rlearning{Visibilité et couleur des objets}.
 
 Manuel de notation :
+@ref{Masquage de portées},
 @ref{Silences invisibles},
-@ref{Visibilité des objets},
-@ref{Masquage de portées}.
+@ref{Visibilité des objets}.
 
 Morceaux choisis :
 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
@@ -506,20 +500,19 @@ Référence des propriétés internes :
 
 @funindex color
 @funindex \with-color
-@funindex with-color
 @funindex x11-color
 
 Des objets peuvent être colorisés individuellement.  Une listes des
 noms des couleurs disponibles se trouvent à l'annexe
 @ref{Liste des couleurs}.
 
-@lilypond[verbatim,quote,relative=2]
+@lilypond[verbatim,quote,fragment]
 \override NoteHead.color = #red
-c4 c
+c''4 c''
 \override NoteHead.color = #(x11-color 'LimeGreen)
-d
+d''
 \override Stem.color = #blue
-e
+e''
 @end lilypond
 
 L'intégralité de la palette des couleurs définies pour X11 est
@@ -534,22 +527,24 @@ Lorsque la fonction @code{x11-color} ne trouve pas le paramètre fourni,
 elle revient à la couleur par défaut, le noir.  Le problème ressort de
 façon évidente au vu de la partition finale.
 
-@lilypond[verbatim,quote,relative=2]
-\override Staff.StaffSymbol.color = #(x11-color 'SlateBlue2)
-\set Staff.instrumentName = \markup {
-  \with-color #(x11-color 'navy) "Clarinet"
-}
+@lilypond[verbatim,quote]
+\relative c'' {
+  \override Staff.StaffSymbol.color = #(x11-color 'SlateBlue2)
+  \set Staff.instrumentName = \markup {
+    \with-color #(x11-color 'navy) "Clarinet"
+  }
 
-gis8 a
-\override Beam.color = #(x11-color "medium turquoise")
-gis a
-\override Accidental.color = #(x11-color 'DarkRed)
-gis a
-\override NoteHead.color = #(x11-color "LimeGreen")
-gis a
-% this is deliberate nonsense; note that the stems remain black
-\override Stem.color = #(x11-color 'Boggle)
-b2 cis
+  gis8 a
+  \override Beam.color = #(x11-color "medium turquoise")
+  gis a
+  \override Accidental.color = #(x11-color 'DarkRed)
+  gis a
+  \override NoteHead.color = #(x11-color "LimeGreen")
+  gis a
+  % this is deliberate nonsense; note that the stems remain black
+  \override Stem.color = #(x11-color 'Boggle)
+  b2 cis
+}
 @end lilypond
 
 @cindex rgb-color
@@ -565,24 +560,26 @@ les composantes de la couleur exacte au format rouge-vert-bleu
 (@emph{RGB}) -- chacune étant exprimée en en fraction de 256 (le 0.5 de
 l'exemple suivant correspond à 128).
 
-@lilypond[verbatim,quote,relative=2]
-\override Staff.StaffSymbol.color = #(x11-color 'SlateBlue2)
-\set Staff.instrumentName = \markup {
-  \with-color #(x11-color 'navy) "Clarinet"
-}
+@lilypond[verbatim,quote]
+\relative c'' {
+  \override Staff.StaffSymbol.color = #(x11-color 'SlateBlue2)
+  \set Staff.instrumentName = \markup {
+    \with-color #(x11-color 'navy) "Clarinet"
+  }
 
-\override Stem.color = #(rgb-color 0 0 0)
-gis8 a
-\override Stem.color = #(rgb-color 1 1 1)
-gis8 a
-\override Stem.color = #(rgb-color 0 0 0.5)
-gis4 a
+  \override Stem.color = #(rgb-color 0 0 0)
+  gis8 a
+  \override Stem.color = #(rgb-color 1 1 1)
+  gis8 a
+  \override Stem.color = #(rgb-color 0 0 0.5)
+  gis4 a
+}
 @end lilypond
 
 @seealso
 Manuel de notation :
-@ref{Liste des couleurs},
-@ref{La commande d'affinage (tweak)}.
+@ref{La commande d'affinage (tweak)},
+@ref{Liste des couleurs}.
 
 Morceaux choisis :
 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
@@ -619,7 +616,6 @@ Pour plus de détails, consultez @ref{La commande d'affinage (tweak)}.
 @cindex crochets, notes entre
 
 @funindex \parenthesize
-@funindex parenthesize
 
 Des objets peuvent être mis entre parenthèses en saisissant
 @code{\parenthesize} juste avant l'événement musical.  Si l'instruction
@@ -627,19 +623,23 @@ préfixe un accord, chaque note le composant se présentera entre
 parenthèses.  Vous pouvez aussi mettre individuellement entre
 parenthèses les notes d'un accord.
 
-@lilypond[verbatim,quote,relative=2]
-c2 \parenthesize d
-c2 \parenthesize <c e g>
-c2 <c \parenthesize e g>
+@lilypond[verbatim,quote]
+\relative {
+  c''2 \parenthesize d
+  c2 \parenthesize <c e g>
+  c2 <c \parenthesize e g>
+}
 @end lilypond
 
 Les objets autres que des notes peuvent aussi être entre parenthèses.
 En ce qui concerne les articulations, l'instruction @code{\parenthesize}
 doit cependant être précédée d'un tiret.
 
-@lilypond[verbatim,quote,relative=2]
-c2-\parenthesize -. d
-c2 \parenthesize r
+@lilypond[verbatim,quote]
+\relative {
+  c''2-\parenthesize -. d
+  c2 \parenthesize r
+}
 @end lilypond
 
 @seealso
@@ -671,11 +671,8 @@ attendrait une seule paire de parenthèses encadrant tout l'accord.
 @cindex hampe neutre
 
 @funindex \stemUp
-@funindex stemUp
 @funindex \stemDown
-@funindex stemDown
 @funindex \stemNeutral
-@funindex stemNeutral
 
 Dès qu'une note est rencontrée, un objet @code{Stem} se crée
 automatiquement.  Pour les rondes et les silences, ils sont aussi
@@ -739,9 +736,7 @@ la portée par des éléments qui lui seront externes.
 @funindex balloonGrobText
 @funindex balloonText
 @funindex \balloonLengthOn
-@funindex balloonLengthOn
 @funindex \balloonLengthOff
-@funindex balloonLengthOff
 
 Vous pouvez marquer et nommer des éléments de notation à l'aide de
 bulles.  L'objectif premier de cette fonctionnalité est d'expliquer la
@@ -749,9 +744,9 @@ notation.
 
 En voici un exemple :
 @c KEEP LY
-@lilypond[verbatim,quote,relative=2]
+@lilypond[verbatim,quote]
 \new Voice \with { \consists "Balloon_engraver" }
-{
+\relative c'' {
   \balloonGrobText #'Stem #'(3 . 4) \markup { "Je suis une hampe" }
   a8
   \balloonGrobText #'Rest #'(-4 . -4) \markup { "Je suis un silence" }
@@ -761,20 +756,20 @@ En voici un exemple :
 @end lilypond
 
 Vous disposez de deux fonctions musicales, @code{balloonGrobText} et
-@code{balloonText}.  @code{balloonGrobText} prend en argument
-l'objet graphique à agrémenter et s'utilise comme
-@code{\once \override}.  @code{balloonText}, quant à lui, s'utilise
-comme une simple articulation et fonctionne comme @code{\tweak} pour
-attacher du texte à l'une des notes d'un accord.  Les autres arguments
-sont le décalage et le texte de la bulle.
+@code{balloonText}.  @code{balloonGrobText} prend en argument l'objet
+graphique à agrémenter et s'utilise comme @code{\once \override}.
+@code{balloonText}, quant à lui, s'utilise comme une simple articulation
+et fonctionne comme @code{\tweak} pour attacher du texte à l'une des
+notes d'un accord.  Les autres arguments sont le décalage et le texte de
+la bulle.
 
 Les info-bulles n'ont aucune influence sur l'espacement des notes ; on
 peut toutefois le gérer ainsi :
 
 @c KEEP LY
-@lilypond[verbatim,quote,relative=2]
+@lilypond[verbatim,quote]
 \new Voice \with { \consists "Balloon_engraver" }
-{
+\relative c'' {
   \balloonGrobText #'Stem #'(3 . 4) \markup { "Je suis une hampe" }
   a8
   \balloonGrobText #'Rest #'(-4 . -4) \markup { "Je suis un silence" }
@@ -814,12 +809,12 @@ Vous pouvez tracer des lignes entre les portées, synchronisées avec
 les notes.
 
 LilyPond a recours à deux graveurs distincts afin d'afficher le
-quadrillage :  le @code{Grid_point_engraver} se charge de
-déterminer l'envergure du crochet, alors que le
-@code{Grid_line_span_engraver} se consacrera au tracé des lignes.
-Les lignes sont par défaut centrées horizontalement sous les notes et
-alignées sur la gauche des têtes.  La propriété @code{gridInterval}
-spécifie quant à elle l'espace de temps entre chaque ligne.
+quadrillage :  le @code{Grid_point_engraver} se charge de déterminer
+l'envergure du crochet, alors que le @code{Grid_line_span_engraver} se
+consacrera au tracé des lignes.  Les lignes sont par défaut centrées
+horizontalement sous les notes et alignées sur la gauche des têtes.  La
+propriété @code{gridInterval} spécifie quant à elle l'espace de temps
+entre chaque ligne.
 
 @c KEEP LY
 @lilypond[verbatim,quote]
@@ -838,11 +833,11 @@ spécifie quant à elle l'espace de temps entre chaque ligne.
 
 \score {
   \new ChoirStaff <<
-    \new Staff \relative c'' {
+    \new Staff \relative {
       \stemUp
-      c'4. d8 e8 f g4
+      c''4. d8 e8 f g4
     }
-    \new Staff \relative {
+    \new Staff \relative {
     %% centre les lignes guides verticalement
       \clef bass
       \stemDown
@@ -878,12 +873,11 @@ Référence des propriétés internes :
 @cindex crochets de phrasé
 @cindex analyse musicologique
 @cindex crochet de regroupement de notes
+@cindex musicologie, crochets d'analyse
 
 @funindex Horizontal_bracket_engraver
 @funindex \startGroup
-@funindex startGroup
 @funindex \stopGroup
-@funindex stopGroup
 
 On utilise des crochets en analyse musicale, pour indiquer la
 structure d'une pièce.
@@ -895,8 +889,8 @@ structure d'une pièce.
     \consists "Horizontal_bracket_engraver"
   }
 }
-\relative c'' {
-  c2\startGroup
+\relative {
+  c''2\startGroup
   d\stopGroup
 }
 @end lilypond
@@ -910,8 +904,8 @@ Les crochets d'analyses sont susceptibles d'être imbriqués :
     \consists "Horizontal_bracket_engraver"
   }
 }
-\relative c'' {
-  c4\startGroup\startGroup
+\relative {
+  c''4\startGroup\startGroup
   d4\stopGroup
   e4\startGroup
   d4\stopGroup\stopGroup