Doc-FR: NR-1.6 Staff notation

  full update

diff --git a/Documentation/fr/notation/staff.itely b/Documentation/fr/notation/staff.itely
index cd41d1777cb201b5173f17c86b0b79acdde59012..787d18aa60969ce0efd8c696b277adc0e3ffa73d 100644 (file)
--- a/Documentation/fr/notation/staff.itely
+++ b/Documentation/fr/notation/staff.itely
@@ -1,6 +1,6 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
 @ignore
-    Translation of GIT committish: 8329db420f98f9d2f03ee8aec740b7ccf770b0d2
+    Translation of GIT committish: 6b39c0b8d7500da65ec6f0ad3dda9e67b244453e
 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  For details, see the Contributors'
@@ -356,7 +356,7 @@ Référence des propriétés internes :
 @cindex système, indicateur de séparation
 
 Le nombre de systèmes peut varier d'une page à l'autre@tie{}; vous
-povez, en pareil cas, rendre plus évidente la séparation entre les
+pouvez, en pareil cas, rendre plus évidente la séparation entre les
 systèmes en l'indiquant visuellement.  Ce @qq{séparateur} est absent par
 défaut, mais vous pouvez l'activer par une option au sein du bloc
 @code{\paper}.
@@ -432,6 +432,25 @@ d'@emph{ossia}.
 @cindex lignes de portée, épaisseur
 @cindex ligne supplémentaire
 
+@funindex \startStaff
+@funindex startStaff
+@funindex \stopStaff
+@funindex stopStaff
+
+Les commandes @code{\stopStaff} et @code{\startStaff} permettent
+respectivement de clôturer et (re)démarrer une portée n'importe où dans
+une partition.
+
+@lilypond[verbatim,quote,relative=2]
+\stopStaff f4 d \startStaff g, e
+f'4 d \stopStaff g, e
+f'4 d \startStaff g, e
+@end lilypond
+
+@predefined
+@code{\startStaff},
+@code{\stopStaff}.
+@endpredefined
 
 Les notes, nuances, etc. sont regroupées dans un assemblage de lignes
 horizontales, que l'on nomme la portée (en anglais @emph{staff}, et
@@ -441,22 +460,40 @@ moyen d'un objet graphique (@emph{grob}) à part entière, nommé
 @code{StaffSymbol} changera l'apparence de la portée, dès lors qu'elles
 auront été définies avant de créer la portée en question.
 
-Vous pouvez modifier le nombre de lignes d'une portée.  Néanmoins, la
-position de la clef et celle du do médium demanderont parfois un
-ajustement afin d'être en phase avec cette nouvelle portée.  Pour plus
-d'explications, reportez-vous aux exemples du chapitre @ref{Clefs}.
+Vous pouvez modifier le nombre de lignes d'une portée.
 
 @lilypond[verbatim,quote,relative=2]
-\new Staff \with {
-  \override StaffSymbol #'line-count = #3
-}
-{ d4 d d d }
+f4 d \stopStaff
+\override Staff.StaffSymbol #'line-count = #2
+\startStaff g, e |
+
+f'4 d \stopStaff
+\revert Staff.StaffSymbol #'line-count
+\startStaff g, e |
+@end lilypond
+
+Le positionnement de chacune des lignes de la portée est modifiable.
+Les valeurs s'expriment en @emph{demi} espace de portée, et la nouvelle
+position est déterminée par rapport à la ligne médiane.  Une ligne sera
+donc imprimée pour chaque valeur exprimée@tie{}; le nombre de lignes,
+ainsi que leur position dans la portée, peut donc se modifier à l'aide
+d'une seule commande.
+
+@lilypond[verbatim,quote,relative=2]
+f4 d \stopStaff
+\override Staff.StaffSymbol #'line-positions = #'(1 3 5 -1 -3)
+\startStaff g, e |
+f'4 d \stopStaff
+\override Staff.StaffSymbol #'line-positions = #'(8 6.5 -6 -8 -0.5)
+\startStaff g, e
 @end lilypond
 
+La position de la clef et celle du do médium demanderont parfois un
+ajustement afin d'être en phase avec cette nouvelle portée.  Pour plus
+d'explications, reportez-vous aux exemples du chapitre @ref{Clefs}.
+
 Lorsque vous modifierez l'épaisseur des lignes, gardez à l'esprit que
-les lignes supplémentaires et les hampes seront aussi modifiées.  En
-effet, elles dépendent directement de l'épaisseur des lignes de la
-portée.
+les lignes supplémentaires et les hampes seront aussi modifiées.
 
 @lilypond[verbatim,quote,relative=1]
 \new Staff \with {
@@ -471,68 +508,61 @@ suivant, les deux nombres constituent des coefficients multiplicateurs
 de l'épaisseur de la ligne.  Ils sont fournis en argument pour
 déterminer l'épaisseur des lignes supplémentaires.
 
-@lilypond[verbatim,quote,relative=1]
+@lilypond[verbatim,quote,relative=2]
 \new Staff \with {
-  \override StaffSymbol #'ledger-line-thickness = #'(1 . 0.2)
+  \override StaffSymbol #'thickness = #2
+  \override StaffSymbol #'ledger-line-thickness = #'(0.5 . 0.4)
 }
-{ e4 d c b }
+{ f'4 a, a,, f }
 @end lilypond
 
-Modifier l'équidistance des lignes de la portée affectera aussi les
-lignes supplémentaires.
+L'emplacement des lignes supplémentaires est réglable@tie{}:
 
-@lilypond[verbatim,quote,relative=1]
+@lilypond[verbatim,quote,relative=2]
 \new Staff \with {
-  \override StaffSymbol #'staff-space = #1.5
+  \override StaffSymbol #'ledger-positions = #'(-3 -2 -1 2 5 6)
 }
-{ a4 b c d }
+{ f'4 a, a,, f }
 @end lilypond
 
-Vous trouverez de plus amples détails sur les propriétés du
-@code{StaffSymbol} au chapitre @rinternals{staff-symbol-interface}.
-
-@cindex fin de portée
-@cindex début de portée
-@cindex portée, début
-@cindex portée, fin
-
-@funindex \startStaff
-@funindex startStaff
-@funindex \stopStaff
-@funindex stopStaff
-
-Les propriétés d'une portée peuvent être modifiées en cours de partition
-à l'aide des commandes @code{\stopStaff} et @code{\startStaff}@tie{}:
+Vous pouvez faire apparaître des lignes supplémentaires additionnelles
+au-dessus ou en dessous des têtes de note selon le positionnement
+relatif aux autres notes, qu'elles aient ou non elles-même des lignes
+supplémentaires.
 
 @lilypond[verbatim,quote,relative=2]
-c2 c
-\stopStaff
-\override Staff.StaffSymbol #'line-count = #2
-\startStaff
-b2 b
-\stopStaff
-\revert Staff.StaffSymbol #'line-count
-\startStaff
-a2 a
+\new Staff \with {
+  \override StaffSymbol #'ledger-extra = #4
+}
+{ f'4 a, d, f, }
 @end lilypond
 
-@noindent
-En règle générale, @code{\startStaff} et @code{\stopStaff} permettent
-d'entamer puis clôturer une portée n'importe où dans une partition.
-
-@lilypond[verbatim,quote,relative=2]
-c4 b a2
+Des lignes supplémentaires peuvent apparaître y compris au sein d'une
+portée, notamment lorsque vous l'avez personnalisée.  L'exemple suivant
+illustre deux cas de figure quant au positionnement des lignes
+supplémentaires selon que la propriété @code{legder-position} est
+définie explicitement ou non.  La présence du @code{stopStaff} est ici
+rendue nécessaire pour annuler les effets de la commande
+@code{\override} qui s'applique à l'intégralité du @code{StaffSymbol}.
+
+@lilypond[fragment,quote,relative=1]
+\override Staff.StaffSymbol #'line-positions =   #'(-8 0 2 4)
+d4 e f g
 \stopStaff
-b4 c d2
 \startStaff
-e4 d c2
+\override Staff.StaffSymbol #'ledger-positions = #'(-8 -6 (-4 -2) 0)
+d4 e f g
 @end lilypond
 
+Modifier l'équidistance des lignes de la portée affectera aussi les
+lignes supplémentaires.
 
-@predefined
-@code{\startStaff},
-@code{\stopStaff}.
-@endpredefined
+@lilypond[verbatim,quote,relative=2]
+\new Staff \with {
+  \override StaffSymbol #'staff-space = #1.5
+}
+{ f'4 d, g, e, }
+@end lilypond
 
 
 @snippets
@@ -1524,7 +1554,7 @@ Manuel de notation :
 @ref{Citation d'autres voix},
 @ref{Instruments transpositeurs},
 @ref{Noms d'instrument},
-@ref{Clef},
+@ref{Clefs},
 @ref{Citation-repère},
 @ref{Utilisation de balises}.