Rerun scripts/auxiliar/update-with-convert-ly.sh

[lilypond.git] / Documentation / fr / notation / chords.itely

diff --git a/Documentation/fr/notation/chords.itely b/Documentation/fr/notation/chords.itely
index d94d29ebd8f53d7a5cf21001917e5a717dbc2e35..4b779159626ecfa2748dffd2ee2e3ba23279e7a4 100644 (file)
--- a/Documentation/fr/notation/chords.itely
+++ b/Documentation/fr/notation/chords.itely
@@ -1,23 +1,28 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
 
 @ignore
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
 
 @ignore

-    Translation of GIT committish: 3f4496001441e0b1b27d7bc5395c4520f4f2088c
+    Translation of GIT committish: 049bdd90b5ae67fe463bf85e926c2eabf51acf74

 
     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
 
 
     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.13.36"
+@c \version "2.17.6"

 
 

-@c Translators: Valentin Villenave
+@c Translators: Valentin Villenave,Jean-Charles Malahieude

 @c Translation checkers: Jean-Charles Malahieude, John Mandereau
 
 @node Notation des accords
 @section Notation des accords
 @translationof Chord notation
 
 @c Translation checkers: Jean-Charles Malahieude, John Mandereau
 
 @node Notation des accords
 @section Notation des accords
 @translationof Chord notation
 

-@untranslated
+@lilypondfile[quote]{chords-headword.ly}
+
+Les accords se saisissent soit comme des notes normales, soit à l'aide
+d'un mode dédié, et seront rendus selon l'une des diverses nomenclatures
+occidentales.  Les accords peuvent aussi se présenter sous forme
+nominale, ou bien en basse figurée.

 
 @menu
 * Mode accords::
 
 @menu
 * Mode accords::


@@ -25,213 +30,409 @@
 * Basse chiffrée::
 @end menu
 
 * Basse chiffrée::
 @end menu
 

+

 @node Mode accords
 @subsection Mode accords
 @translationof Chord mode
 
 @node Mode accords
 @subsection Mode accords
 @translationof Chord mode
 

-@untranslated
+@cindex chordmode
+@cindex accords, mode
+
+Le mode accords permet de saisir des accords en indiquant leur structure
+plutôt que les notes qui les composent.

 
 @menu
 * Généralités sur le mode accords::
 * Accords courants::
 
 @menu
 * Généralités sur le mode accords::
 * Accords courants::

-* Extensions et altération d'accords::
+* Extension et altération d'accords::

 @end menu
 
 @end menu
 

-@c This material comes from 'Entering chord names' -FV
+

 @node Généralités sur le mode accords
 @unnumberedsubsubsec Généralités sur le mode accords
 @translationof Chord mode overview
 
 @node Généralités sur le mode accords
 @unnumberedsubsubsec Généralités sur le mode accords
 @translationof Chord mode overview
 

-@cindex accords, chiffrage jazz
+@cindex accords, noms
+@cindex accords, chiffrage

 
 

-LilyPond permet de désigner les accords par leur chiffrage jazz.
-S'il est possible d'entrer un accord sous sa forme musicale, avec
-@code{<@dots{}>}, on peut aussi le saisir par son nom.  Le logiciel
-traite les accords comme des ensembles de hauteurs, donc les accords
-peuvent être transposés.
+Un accord peut se saisir en tant que musique simultanée, comme nous
+l'avons vu à la rubrique @ref{Notes en accords}.

 
 

-@lilypond[quote,ragged-right,verbatim,ragged-right]
-twoWays = \transpose c c' {
-  \chordmode {
-    c1 f:sus4 bes/f
-  }
-  <c e g>
-  <f bes c'>
-  <f bes d'>
-}
+LilyPond dispose aussi d'un @qq{mode accords} au sein duquel sera
+considérée la structure des accords, tels qu'ils se présentent dans les
+traditions occidentales, plutôt que les différentes hauteurs qui les
+composent.  Ce mode est tout à fait adapté pour ceux qui sont plus
+habitués aux accords nommés.  Pour plus d'information quant aux
+différentes façons de libeller votre code, voir @ref{Modes de saisie}.
+
+@lilypond[verbatim,quote,ragged-right]
+\chordmode { c1 g a g c }
+@end lilypond
+
+Tout accord saisi dans ce mode dédié constitue un élément musical à
+part entière ; il pourra donc par exemple être transposé comme
+n'importe quel ensemble de hauteurs simultanées.  @code{\chordmode}
+travaille en absolu ; une instruction @code{\relative} restera sans
+effet au sein d'un bloc @code{chordmode}.  Notez toutefois que les
+hauteurs absolues sont une octave plus haut en @code{\chordmode} qu'en
+mode notes traditionnel.
+
+Mode notes et mode accords peuvent tout à fait cohabiter dans une
+séquence musicale :
+
+@lilypond[verbatim,quote,ragged-right,relative=1]
+<c e g>2 <g b d>
+\chordmode { c2 f }
+<c e g>2 <g' b d>
+\chordmode { f2 g }
+@end lilypond

 
 

-<< \new ChordNames \twoWays
-   \new Voice \twoWays >>
+@seealso
+Glossaire musicologique :
+@rglosnamed{chord,Accord}.
+
+Manuel de notation :
+@ref{Notes en accords},
+@ref{Modes de saisie}.
+
+Morceaux choisis :
+@rlsrnamed{Chords,Accords}.
+
+@knownissues
+Les raccourcis d'articulation ou d'ornementation ne sont pas disponibles
+en mode accord -- voir @ref{Articulations et ornements}.
+
+Lorsque vous mélangez mode accords et mode notes dans une séquence
+musicale qui démarre par le mode accords, le mode notes créera un
+nouveau contexte @code{Staff} :
+
+@lilypond[verbatim,quote,ragged-right,relative=1]
+\chordmode { c2 f }
+<c e g>2 <g' b d>

 @end lilypond
 
 @end lilypond
 

-Cet exemple montre également que les jeux d'instructions qui permettent
-à LilyPond d'imprimer des accords ne cherchent pas à se montrer
-intelligents.  Ici, le dernier accord n'est pas interprété comme étant
-renversé.
+@noindent
+La solution consiste à créer explicitement le contexte @code{Staff} dès
+le départ :

 
 

-Notez bien que la valeur rythmique des accords doit être indiquée
-@emph{à l'extérieur} des symboles @code{<>}.
+@lilypond[verbatim,quote,ragged-right,relative=1]
+\new Staff {
+  \chordmode { c2 f }
+  <c e g>2  <g' b d>
+}
+@end lilypond

 
 

-@example
-<c e g>2
-@end example

 
 

-@c This material comes from 'Chords mode' -FV

 @node Accords courants
 @unnumberedsubsubsec Accords courants
 @translationof Common chords
 
 @node Accords courants
 @unnumberedsubsubsec Accords courants
 @translationof Common chords
 

+@cindex triades
+@cindex septième
+@cindex fondamentale
+@cindex accords, modificateur
+@cindex qualité d'accord
+

 Dans le mode accords, introduit par la commande @code{\chordmode}, les
 Dans le mode accords, introduit par la commande @code{\chordmode}, les

-accords ne sont indiqués que par leur note fondamentale.
+accords ne sont indiqués que par leur note fondamentale, à laquelle on
+peut adjoindre une durée.

 
 

-@lilypond[quote,ragged-right,fragment,verbatim]
-\chordmode { es4. d8 c2 }
+@lilypond[verbatim,quote,ragged-right]
+\chordmode { c2 f4 g }

 @end lilypond
 
 @end lilypond
 

-@cindex saisir des accords
-@cindex mode accords
+On peut cependant obtenir des accords différents -- mineur, augmenté ou
+diminué -- en utilisant le caractère deux points (@code{:}).
+
+@lilypond[verbatim,quote,ragged-right]
+\chordmode { c2:m f4:aug g:dim }
+@end lilypond

 
 

-On peut cependant obtenir des accords différents, en utilisant le
-caractère deux points (@code{:}).
+Les accords de septième sont aisément stipulables :

 
 

-@lilypond[quote,fragment,verbatim]
-\chordmode { e1:m e1:7 e1:m7 }
+@lilypond[quote,ragged-right,verbatim]
+\chordmode { c1:7 c:m7 c:maj7 c:dim7 c:aug7 }

 @end lilypond
 
 @end lilypond
 

-Le nombre accolé à la note fondamentale est considéré comme chiffrage
-jazz de l'accord, qui est de ce fait construit par un empilement de
-tierces. Notez l'exception que constitue @code{c:13} dans lequel la
-onzième est délibérément omise.
+@funindex aug
+@funindex dim
+@funindex maj
+@funindex m
+
+Voici les différents modificateurs d'accord de trois sons ou de
+septième.  Par défaut, la septième ajoutée sera mineure ; la
+septième de dominante est donc l'accord de septième de base.  Toutes les
+altérations sont relatives à la septième de dominante.  Une table
+étendue des modificateurs et de leur utilisation est à l'annexe
+@ref{Modificateurs d'accord usuels}.
+
+@c @table @code
+@multitable @columnfractions .2 .4 .3
+
+@item
+@b{Modificateur}
+@tab
+@b{Action}
+@tab
+@b{Exemple}
+
+@item
+Néant
+@tab
+Action par défaut ; produit une triade majeure.
+@tab
+@lilypond[line-width=4\cm, noragged-right]
+\chordmode {
+  \override Staff.TimeSignature.stencil = ##f
+  c1
+}
+@end lilypond

 
 

-@lilypond[quote,fragment,verbatim]
-\chordmode { c:3 c:5 c:6 c:7 c:8 c:9 c:10 c:11 c:13 }
+@item
+m, m7
+@tab
+Accord mineur.  Ce modificateur abaisse la tierce, et la septième s'il y
+en a une.
+@tab
+@lilypond[line-width=4\cm, noragged-right]
+\chordmode {
+  \override Staff.TimeSignature.stencil = ##f
+  c1:m c:m7
+}

 @end lilypond
 
 @end lilypond
 

-@cindex note fondamentale
-@cindex notes ajoutées
-@cindex accords incomplets
+@item
+dim, dim7
+@tab
+Accord diminué.  Ce modificateur minorise la tierce, diminue la quinte et
+la septième s'il y en a.
+@tab
+@lilypond[line-width=4\cm, noragged-right]
+\chordmode {
+  \override Staff.TimeSignature.stencil = ##f
+  c1:dim c:dim7
+}
+@end lilypond

 
 

-Des accords encore plus complexes peuvent être élaborés en plusieurs
-étapes séparées.  Ainsi, on peut enrichir l'accord par des notes
-ajoutées, que l'on indique après le chiffrage principal et que l'on
-sépare par des points@tie{}:
+@item
+aug
+@tab
+Accord augmenté.  Ce modificateur augmente la quinte.
+@tab
+@lilypond[line-width=4\cm, noragged-right]
+\chordmode {
+  \override Staff.TimeSignature.stencil = ##f
+  c1:aug
+}
+@end lilypond

 
 

-@lilypond[quote,verbatim,fragment]
-\chordmode { c:5.6 c:3.7.8 c:3.6.13 }
+@item
+maj, maj7
+@tab
+Accord de septième majeure. Ce modificateur majorise la septième.  Le
+@code{7} à la suite du est @code{maj} facultatif.  Ce modificateur ne
+sert pas à créer une triade majeure.
+@tab
+@lilypond[line-width=4\cm, noragged-right]
+\chordmode {
+  \override Staff.TimeSignature.stencil = ##f
+  c1:maj c:maj7
+}

 @end lilypond
 
 @end lilypond
 

-On peut augmenter ou diminuer certains intervalles au moyen des
-signes @code{-} ou @code{+}@tie{}:
+@end multitable
+
+@seealso
+Manuel de notation :
+@ref{Extension et altération d'accords},
+@ref{Modificateurs d'accord usuels}.

 
 

-@lilypond[quote,verbatim,fragment]
-\chordmode { c:7+ c:5+.3- c:3-.5-.7- }
+Morceaux choisis :
+@rlsrnamed{Chords,Accords}.
+
+@knownissues
+Un accord ne devrait comporter qu'un seul modificateur de qualité.  La
+présence de plusieurs modificateurs ne déclenchera ni avertissement, ni
+erreur, mais le résultat pourrait être surprenant.  Un accord qui n'est
+pas constructible à l'aide d'un unique modificateur devra faire l'objet
+d'une altération de ses composantes, comme indiqué à la rubrique
+@ref{Extension et altération d'accords}.
+
+
+@node Extension et altération d'accords
+@unnumberedsubsubsec Extension et altération d'accords
+@translationof Extended and altered chords
+
+Le mode accords permet d'élaborer des accords complexes.  Ainsi, on peut
+enrichir l'accord par des notes ajoutées, enlever certaines notes,
+augmenter ou diminuer certains intervalles, ajouter la note de basse ou
+créer un renversement.
+
+Le premier nombre qui suit le caractère deux-points (@code{:}) permet de
+déterminer l'étendue d'un accord.  L'accord sera construit par ajout à
+la fondamentale, d'autant de tierces consécutives que nécessaire pour
+atteindre le nombre spécifié.  N'oubliez pas que la septième ajoutée à
+un accord est minorée par défaut.  Lorsque le dernier degré ne
+correspond pas à une tierce -- la sixte par exemple -- les tierces
+seront empilées jusqu'à celle directement inférieure au degré mentionné,
+qui sera alors ajouté pour conclure l'accord.  L'étendue maximale
+autorisée est la treizième ; toute étendue plus élevée sera
+interprétée comme un accord de treizième.
+
+@lilypond[quote,ragged-right,verbatim]
+\chordmode {
+  c1:2 c:3 c:4 c:5
+  c1:6 c:7 c:8 c:9
+  c1:10 c:11 c:12 c:13
+  c1:14
+}

 @end lilypond
 
 @end lilypond
 

-On peut aussi enlever certaines notes de l'accord, en les spécifiant
-après un signe @code{^} -- les notes ajoutées doivent être indiquées
-@emph{avant} les notes à enlever.
+@noindent
+Notez bien que @code{c:5} et @code{c} produisent tous deux une triade de
+do majeur.
+
+Dans la mesure où un accord de treizième majeure ne sonne pas très bien
+avec la onzième, la onzième est automatiquement enlevée, sauf à l'avoir
+explicitement spécifiée.

 
 

-@lilypond[quote,verbatim,fragment]
-\chordmode { c^3 c:7^5 c:9^3.5 }
+@lilypond[quote,ragged-right,verbatim]
+\chordmode {
+  c1:13 c:13.11 c:m13
+}

 @end lilypond
 
 @end lilypond
 

-Voici les différents chiffrages disponibles, en plus des nombres que
-nous venons de voir@tie{}:
+@cindex additions à un accord
+@cindex accord, additions

 
 

-@table @code
-@item m
-Accord mineur.  Ce chiffrage minorise la tierce, et la septième s'il y
-en a une.
+On peut enrichir l'accord par des notes ajoutées, que l'on indique après
+le chiffrage principal et que l'on sépare par des points, sans oublier
+que si l'on y ajoute une septième, celle-ci sera minorée et non majeure.

 
 

-@item dim
-Accord diminué.  Ce chiffrage minorise la tierce, diminue la quinte et
-la septième s'il y en a.
+@lilypond[quote,verbatim]
+\chordmode {
+  c1:5.6 c:3.7.8 c:3.6.13
+}
+@end lilypond

 
 

-@item aug
-Accord augmenté.  Ce chiffrage augmente la quinte.
+Les notes ajoutées peuvent monter aussi haut que de besoin.

 
 

-@item maj
-Accord de septième majeure. Ce chiffrage majorise la septième s'il y
-en a une (dans le cas d'un accord parfait, ce chiffrage est facultatif).
+@lilypond[quote,verbatim]
+\chordmode {
+  c4:5.15 c:5.20 c:5.25 c:5.30
+}
+@end lilypond

 
 

-@item sus
-Accord de suspension. Ce chiffrage supprime la tierce, et y ajoute,
-suivant que vous spécifiez @code{2} ou @code{4}, la seconde ou la
-quarte.
-@end table
+@cindex accord, altération d'un degré

 
 

-Il est bien sûr possible de mélanger ces chiffrages avec des notes
-ajoutées.
-@lilypond[quote,verbatim,fragment]
-  \chordmode { c:sus4 c:7sus4 c:dim7 c:m6 }
+On peut augmenter ou diminuer certains intervalles au moyen des
+signes @code{-} ou @code{+} au degré considéré.  L'altération de l'un
+des degrés automatiquement inclus dans la structure de base d'un accord
+s'effectue de la même manière.
+
+@lilypond[quote,verbatim]
+\chordmode {
+  c1:7+ c:5+.3- c:3-.5-.7-
+}
+@end lilypond
+
+@cindex accord, suppression d'un degré
+
+@funindex ^
+
+Après avoir ajouté des notes à un accord, on peut aussi en enlever
+certaines, en les spécifiant derrière un signe @code{^} -- les séparer
+par un point lorsqu'il y en a plus d'une.
+
+@lilypond[quote,verbatim]
+\chordmode {
+  c1^3 c:7^5 c:9^3 c:9^3.5 c:13.11^3.7
+}

 @end lilypond
 
 @end lilypond
 

-@cindex chiffrages des accords
-@funindex aug
-@funindex dim
-@funindex maj

 @funindex sus
 @funindex sus

-@funindex m

 
 

-Dans la mesure où un accord de treizième majeure ne sonne pas très bien
-avec la onzième, la onzième est enlevée automatiquement, à moins que
-vous ne le spécifiez explicitement.
+L'ajout du modificateur @code{sus} permet de créer un accord de
+suspension.  Ceci aura pour effet de supprimer la tierce et y ajouter,
+suivant que vous spécifiez @code{2} ou @code{4}, la seconde ou la
+quarte.  @code{sus} est équivalent à @code{^3} ; @code{sus4} est
+équivalent à @code{.4^3}.

 
 

-@lilypond[quote,ragged-right,fragment,verbatim]
-\chordmode { c:13 c:13.11 c:m13 }
+@lilypond[quote,ragged-right,verbatim]
+\chordmode {
+  c1:sus c:sus2 c:sus4 c:5.4^3
+}

 @end lilypond
 
 @funindex /
 @end lilypond
 
 @funindex /

+@cindex accord, inversion
+@cindex accord, spécifier la basse
+@cindex basse d'un accord

 
 Les accords peuvent être renversés ou combinés avec une note étrangère à
 
 Les accords peuvent être renversés ou combinés avec une note étrangère à

-la basse, au moyen de @code{@var{accord}/}@var{note}
-@lilypond[quote,ragged-right,fragment,verbatim]
-\chordmode { c1 c/g c/f }
+la basse, au moyen de @code{@var{accord}/}@var{hauteur}.
+
+@lilypond[quote,ragged-right,verbatim]
+\chordmode {
+  c1 c/g c/f
+}

 @end lilypond
 @end lilypond

+

 @funindex /+
 
 Si la note de basse précisée appartient à l'accord, la doublure
 supérieure sera supprimée.  Pour l'éviter, utilisez la syntaxe
 @funindex /+
 
 Si la note de basse précisée appartient à l'accord, la doublure
 supérieure sera supprimée.  Pour l'éviter, utilisez la syntaxe

-@code{/+}@var{note}.
+@code{/+}@var{hauteur}.

 
 

-@lilypond[quote,ragged-right,fragment,verbatim]
-\chordmode { c1 c/+g c/+f }
+@lilypond[quote,ragged-right,verbatim]
+\chordmode {
+  c1 c/g c/+g
+}

 @end lilypond
 
 @end lilypond
 

-Le mode accords est semblable à @code{\lyricmode} ou autre, c'est-à-dire
-que la plupart des commandes sont encore disponibles@tie{}; ainsi,
-@code{r} ou @code{\skip} peuvent servir à insérer des silences ou des
-silences invisibles.  De plus, les propriétés des objets peuvent être
-ajustées ou modifiées.
+Une table étendue des modificateurs et de leur utilisation est à
+l'annexe @ref{Modificateurs d'accord usuels}.

 
 

-@knownissues
+@seealso
+Manuel de notation :
+@ref{Modificateurs d'accord usuels}.
+
+Morceaux choisis :
+@rlsrnamed{Chords,Accords}.

 
 

+@knownissues

 Aucun nom de note ne peut être indiqué deux fois dans un accord.  Ainsi,
 dans l'accord suivant, seule la quinte augmentée est prise en compte,
 Aucun nom de note ne peut être indiqué deux fois dans un accord.  Ainsi,
 dans l'accord suivant, seule la quinte augmentée est prise en compte,

-car elle est indiquée en dernier@tie{}:
+parce qu'elle est indiquée en dernier :

 
 

-@cindex agrégats
-@lilypond[quote,ragged-right,verbatim,fragment]
-\chordmode { c:5.5-.5+ }
+@lilypond[quote,ragged-right,verbatim]
+\chordmode { c1:5.5-.5+ }

 @end lilypond
 
 @end lilypond
 

-@node Extensions et altération d'accords
-@unnumberedsubsubsec Extensions et altération d'accords
-@translationof Extended and altered chords
+Seul le deuxième renversement peut être obtenu par adjonction de la
+basse.  Le premier renversement requiert de changer la fondamentale de
+l'accord.
+
+@lilypond[quote,ragged-right,verbatim]
+\chordmode {
+  c'1: c':/g e:6-3-^5 e:m6-^5
+}
+@end lilypond

 
 

-@untranslated

 
 @node Gravure des accords
 @subsection Gravure des accords
 @translationof Displaying chords
 
 
 @node Gravure des accords
 @subsection Gravure des accords
 @translationof Displaying chords
 

-@untranslated
+Les accords peuvent se présenter aussi bien sous forme nominative que
+comme un empilement de notes sur une portée.

 
 @menu
 * Impression des noms d'accord::
 * Personnalisation des noms d'accord::
 @end menu
 
 
 @menu
 * Impression des noms d'accord::
 * Personnalisation des noms d'accord::
 @end menu
 

+

 @node Impression des noms d'accord
 @unnumberedsubsubsec Impression des noms d'accord
 @translationof Printing chord names
 @node Impression des noms d'accord
 @unnumberedsubsubsec Impression des noms d'accord
 @translationof Printing chord names


@@ -239,164 +440,295 @@ car elle est indiquée en dernier@tie{}:
 @cindex chiffrages d'accords
 @cindex accords
 
 @cindex chiffrages d'accords
 @cindex accords
 

-Les chiffrages d'accords sont liés au contexte
-@rinternals{ChordNames}.  Les accords peuvent être saisis soit au
-moyen de la notation indiquée ci-dessus, soit directement avec les
-symboles @code{<} et @code{>}.
+Les chiffrages d'accords sont liés au contexte @code{ChordNames} :

 
 

-@lilypond[quote,verbatim,ragged-right]
-harmonies = {
-  \chordmode {a1 b c} <d' f' a'> <e' g' b'>
+@lilypond[verbatim,quote,ragged-right]
+\new ChordNames {
+  \chordmode {
+    c2 f4. g8
+  }

 }
 }

+@end lilypond
+
+Les accords peuvent être saisis soit en tant que hauteurs simultanées,
+soit au moyen du mode accords.  Le chiffrage affiché sera identique quel
+que soit le mode de saisie, à moins qu'il n'y ait inversion ou ajout de
+la basse.
+
+@lilypond[verbatim,quote,relative=1]

 <<
 <<

-  \new ChordNames \harmonies
-  \new Staff \harmonies
+  \new ChordNames {
+    <c e g>2  <f bes c>
+    <f c' e g>1
+    \chordmode {
+      c2 f:sus4 c1:/f
+    }
+  }
+  {
+    <c e g>2  <f bes c>
+    <f, c' e g>1
+    \chordmode {
+      c2 f:sus4 c1:/f
+    }
+  }

 >>
 @end lilypond
 
 >>
 @end lilypond
 

-Vous pouvez faire ressortir les chiffrages d'accords en assignant la
-valeur vrai à la propriété @code{chordChanges} dans le contexte
-@rinternals{ChordNames}.  De cette façon, les chiffrages ne sont
-imprimés qu'aux changements d'accord ou en début de ligne.
+@cindex no chord, symbole
+@cindex N.C., symbole
+@cindex accords, No Chord

 
 

-@lilypond[quote,verbatim,ragged-right]
-harmonies = \chordmode {
-  c1:m c:m \break c:m c:m d
-}
+L'apparition de silences dans un contexte @code{ChordNames} déclenchera
+l'impression d'un @emph{markup} @code{noChordSymbol}.
+
+@lilypond[verbatim, quote, relative=1]

 <<
 <<

-  \new ChordNames {
-    \set chordChanges = ##t
-    \harmonies }
-  \new Staff \transpose c c' \harmonies
+  \new ChordNames \chordmode {
+    c1
+    r1
+    g1
+    c1
+  }
+  \chordmode {
+    c1
+    r1
+    g1
+    c1
+  }

 >>
 @end lilypond
 
 >>
 @end lilypond
 

-Les exemples précédents montrent des chiffrages placés au-dessus de la
-portée, mais ce n'est pas obligatoire@tie{}: les accords peuvent également
-être imprimés séparément -- auquel cas vous aurez peut-être besoin
-d'ajouter le @rinternals{Volta_engraver} et le
-@rinternals{Bar_engraver} afin que les éventuelles barres de reprises
-s'affichent correctement.
+@funindex \chords

 
 

-@lilypond[ragged-right,verbatim]
-\new ChordNames \with {
-  \override BarLine #'bar-size = #4
-  \consists Bar_engraver
-  \consists "Volta_engraver"
-}
-\chordmode { \repeat volta 2 {
-  f1:maj7 f:7 bes:7
-  c:maj7
-} \alternative {
-  es e
+@code{\chords @{ ... @}} est un raccourci de
+@code{\new ChordNames @{ \chordmode @{ ... @} @}}.
+
+@lilypond[verbatim,quote,ragged-right]
+\chords {
+  c2 f4.:m g8:maj7

 }
 }

+@end lilypond
+
+@lilypond[verbatim,quote,ragged-right]
+\new ChordNames {
+  \chordmode {
+    c2 f4.:m g8:maj7
+  }

 }
 @end lilypond
 
 }
 @end lilypond
 

-Le modèle par défaut des chiffrages d'accord est celui de Klaus Ignatzek
-pour le jazz (cf. @ressay{Références bibliographiques}).  Il s'agit
-d'une notation anglo-saxonne@tie{}; cependant vous pouvez indiquer vos
-chiffrages en notation française au moyen de la commande
-@code{\frenchChords} (voir plus bas).
+@snippets

 
 

-Il est possible de créer votre propre modèle de chiffrages en
-réglant les propriétés suivantes@tie{}:
+@c Keep index entries with following snippet
+@cindex accords, suppression des répétitions
+@funindex chordChanges

 
 

-@table @code
-@funindex chordNameExceptions
-@item chordNameExceptions
-C'est la liste des accords mis en forme de manière particulière.
-
-Cette liste d'exceptions s'indique de la façon suivante.
-On commence par créer une expression musicale telle que
-@example
-@code{chExceptionMusic} = @{ <c f g bes>1 \markup @{ \super "7" "wahh" @} @}
-@end example
-puis on la transforme en liste d'exceptions au moyen du code
-@example
-(sequential-music-to-chord-exceptions chExceptionMusic #t)
-@end example
-Pour qu'elles soient effectives, on ajoute ces exceptions aux exceptions
-par défaut définies dans @file{ly/@/chord@/-modifier@/-init@/.ly}@tie{}:
-@example
-(append
- (sequential-music-to-chord-exceptions chExceptionMusic #t)
- ignatzekExceptions)
-@end example
+@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
+{showing-chords-at-changes.ly}

 
 

-@cindex exceptions, chiffrage d'accords
-@cindex chiffrage d'accords, exceptions
-@cindex accords chiffrés, exceptions
-@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
-{chord-name-exceptions.ly}
+@c @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
+@c {adding-bar-lines-to-chordnames-context.ly}

 
 

-@funindex majorSevenSymbol
-@item majorSevenSymbol
-Cette propriété définit l'objet employé pour indiquer une septième
-majeure.  Les options prédéfinies sont @code{whiteTriangleMarkup}
-(triangle blanc) et @code{blackTriangleMarkup} (triangle noir).
+@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
+{simple-lead-sheet.ly}

 
 

-@funindex chordNameSeparator
-@item chordNameSeparator
-Les différents termes d'un chiffrage jazz (par exemple les notes de
-l'accord et la basse) sont habituellement séparés par une barre oblique.
-La propriété @code{chordNameSeparator} permet d'indiquer un autre
-séparateur, par exemple
-@lilypond[quote,ragged-right,fragment,verbatim]
-\new ChordNames \chordmode {
-  c:7sus4
-  \set chordNameSeparator
-    = \markup { \typewriter "|" }
-  c:7sus4
+@seealso
+Glossaire musicologique :
+@rglosnamed{chord,Accord}.
+
+Manuel de notation :
+@ref{Saisie de musique en parallèle}.
+
+Morceaux choisis :
+@rlsrnamed{Chords,Accords}.
+
+Référence des propriétés internes :
+@rinternals{ChordNames},
+@rinternals{ChordName},
+@rinternals{Chord_name_engraver},
+@rinternals{Volta_engraver},
+@rinternals{Bar_engraver}.
+
+@knownissues
+Un accord contenant un renversement ou dont la basse est changée ne sera
+pas chiffré correctement s'il est saisi en tant que musique simultanée.
+
+
+@node Personnalisation des noms d'accord
+@unnumberedsubsubsec Personnalisation des noms d'accord
+@translationof Customizing chord names
+
+@cindex accord, personnalisation du chiffrage
+@cindex chiffrage d'accords, personnalisation
+
+Il existe plus d'un système de chiffrage d'accords.  Le nom des accords
+varie selon les traditions musicales, et plusieurs symboles représentent
+un même accord.  LilyPond vous permet de créer votre propre nomenclature
+d'accords, tant au niveau des noms que des symboles qui les
+représenteront.
+
+@cindex jazz, accords
+@cindex accords jazz
+
+Le modèle par défaut des chiffrages d'accord est celui de Klaus Ignatzek
+pour le jazz (cf. @ressay{Références bibliographiques}).Il est possible
+de créer votre propre modèle de chiffrages à l'aide des différentes
+propriétés mentionnées ci-dessous.  LilyPond dispose d'un système
+alternatif de chiffrage jazz qui a été élaboré grâce à ces même
+propriétés.  Les deux notations, Ignatzek et alternative, sont illustrés
+à l'annexe @ref{Table des noms d'accord}.
+
+@c TODO --  Change this so we don't have a non-verbatim example.
+@c  Make short example in docs, then move longer example to
+@c  appendix, where the length of the snippet won't matter.
+
+En plus des différents systèmes de nommage, le nom de la fondamentale
+varie selon la langue utilisée.  Les instructions @code{\germanChords},
+@code{\semiGermanChords}, @code{\italianChords} et @code{\frenchChords}
+permettent de définir la langue, comme vous pouvez le constater :
+
+@lilypondfile[ragged-right]
+{chord-names-languages.ly}
+
+@funindex chordNameLowercaseMinor
+Nombre de carnets de chant allemands indiquent un accord mineur par
+l'emploi de caractères en minuscule, sans le suffixe @code{m}.  Cette
+fonctionnalité est gérée par la propriété
+@code{chordNameLowercaseMinor} :
+
+@lilypond[verbatim,quote,ragged-right]
+\chords {
+  \set chordNameLowercaseMinor = ##t
+  c2 d:m e:m f

 }
 @end lilypond
 
 }
 @end lilypond
 

+Lorsqu'aucun des systèmes prédéfinis ne vous permet de représenter
+l'accord voulu, les propriétés suivantes vous permettront de le
+construire.
+
+@table @code
+

 @funindex chordRootNamer
 @funindex chordRootNamer

+

 @item chordRootNamer
 Dans les chiffrages d'accord jazz, la note fondamentale de chaque accord
 est exprimée par une lettre capitale, parfois suivie d'une altération,
 correspondant à la notation anglo-saxonne de la musique.  Cette
 propriété a pour valeur la fonction qui transforme la hauteur de la note
 @item chordRootNamer
 Dans les chiffrages d'accord jazz, la note fondamentale de chaque accord
 est exprimée par une lettre capitale, parfois suivie d'une altération,
 correspondant à la notation anglo-saxonne de la musique.  Cette
 propriété a pour valeur la fonction qui transforme la hauteur de la note

-foncdamentale en nom de note@tie{}; c'est donc en assignant une nouvelle
+fondamentale en nom de note ; c'est donc en assignant une nouvelle

 fonction à cette propriété que l'on peut produire des noms de note
 fonction à cette propriété que l'on peut produire des noms de note

-spéciaux, adaptés par exemple aux systèmes de notation d'autres pays.
+spéciaux adaptés par exemple aux systèmes de notation d'autres pays.
+
+@funindex majorSevenSymbol
+
+@item majorSevenSymbol
+Cette propriété définit l'objet ajouté au @code{chordRootNamer} pour
+indiquer une septième majeure.  Les options prédéfinies sont
+@code{whiteTriangleMarkup} (triangle blanc) et
+@code{blackTriangleMarkup} (triangle noir).
+
+@funindex additionalPitchPrefix
+
+@item additionalPitchPrefix
+Lorsqu'un chiffrage contient des notes ajoutées, vous pouvez le préfixer
+d'une annotation.  LilyPond n'en ajoute pas par défaut, dans le but de
+ne pas trop surcharger la partition ; vous pouvez cependant les
+faire apparaître si elles sont visuellement efficaces.
+
+@lilypond[verbatim,quote,ragged-right]
+\new ChordNames {
+  <c e g d'>    % add9
+  \set additionalPitchPrefix = #"add"
+  <c e g d'>    % add9
+}
+@end lilypond

 
 @funindex chordNoteNamer
 
 @funindex chordNoteNamer

+

 @item chordNoteNamer
 Lorsqu'un chiffrage mentionne une note ajoutée (par exemple la basse),
 les règles utilisées sont par défaut celles définies par la propriété
 @item chordNoteNamer
 Lorsqu'un chiffrage mentionne une note ajoutée (par exemple la basse),
 les règles utilisées sont par défaut celles définies par la propriété

-@code{chordRootNamer} ci-dessus.  Cependant, la propriété @code{chordNoteNamer}
-permet de régler cet élément indépendamment, par exemple pour imprimer la basse
-en caractères minuscules.
+@code{chordRootNamer} ci-dessus.  Cependant, la propriété
+@code{chordNoteNamer} permet de régler cet élément indépendamment, par
+exemple pour imprimer la basse en caractères minuscules.

 
 

-@funindex chordPrefixSpacer
-@item chordPrefixSpacer
-Le petit @code{m} qui indique un accord mineur est, dans la notation
-anglo-saxonne, attaché à la lettre de l'accord. Cependant il est
-possible d'ajouter un espace en assignant la valeur vrai à la propriété
-@code{chordPrefixSpacer}.  Cet espace sera omis si une altération est
-présente.
+@funindex chordNameSeparator

 
 

-@end table
+@item chordNameSeparator
+Les différents termes d'un chiffrage jazz (par exemple les notes de
+l'accord et la basse) sont habituellement légèrement espacés.  La
+propriété @code{chordNameSeparator} permet d'indiquer un autre
+séparateur.  Le séparateur entre un chiffrage et sa basse est géré par
+la propriété @code{slashChordSeparator}.
+
+@lilypond[verbatim,quote,ragged-right]
+\chords {
+  c4:7.9- c:7.9-/g
+  \set chordNameSeparator = \markup { "/" }
+  \break
+  c4:7.9- c:7.9-/g
+}
+@end lilypond
+
+@funindex slashChordSeparator
+
+@item slashChordSeparator
+La note basse d'un accord n'est pas forcément la fondamentale.  L'accord
+est alors @qq{renversé} -- certains diront @qq{barré} parce que son
+chiffrage est habituellement flanqué d'une barre oblique entre l'accord
+de base et sa basse.  La propriété @code{slashChordSeparator} permet de
+modifier ce séparateur -- par défaut la barre de fraction.
+
+@lilypond[verbatim,quote,ragged-right]
+\chords {
+  c4:7.9- c:7.9-/g
+  \set slashChordSeparator = \markup { " over " }
+  \break
+  c4:7.9- c:7.9-/g
+}
+@end lilypond
+
+@funindex chordNameExceptions

 
 

-Les propriétés ci-dessus font l'objet de commandes prédéfinies
-adaptées aux notations de différents pays@tie{}: @code{\germanChords} et
-@code{\semiGermanChords} pour la notation allemande,
-@code{\italianChords} pour la notation italienne et enfin
-@code{\frenchChords} pour la notation française.
+@item chordNameExceptions
+Cette propriété recense, sous forme de paire, les accords mis en forme
+de manière particulière.  Le premier élément de chacune des paires
+répertorie les différentes hauteurs qui constituent l'accord.  Le second
+élément est un @emph{markup} qui sera ajouté au @code{chordRootNamer}
+lors de l'impression du chiffrage.
+
+@funindex minorChordModifier
+
+@item minorChordModifier
+Les accords mineurs sont habituellement identifiés par un @code{m} après
+leur fondamentale.  Certaines nomenclatures ont cependant adopté un
+autre suffixe, comme le signe moins.
+
+@lilypond[verbatim,quote,ragged-right]
+\chords {
+  c4:min f:min7
+  \set minorChordModifier = \markup { "-" }
+  \break
+  c4:min f:min7
+}
+@end lilypond

 
 

-@lilypondfile[ragged-right]{chord-names-languages.ly}
+@funindex chordPrefixSpacer

 
 

-@cindex Banter
-@cindex jazz, chiffrages d'accords
-@cindex accords jazz, chiffrage
-LilyPond intègre également deux autres modèles de chiffrages@tie{}: une
-notation Jazz alternative, et un modèle systématique appelé système
-Banter.  Pour la mise en œuvre de ces modèles, voir
-@ref{Table des noms d'accord}.
+@item chordPrefixSpacer
+Le modificateur pour accord mineur, géré par la propriété
+@code{minorChordModifier}, est en principe accolé la fondamentale.  Vous
+pouvez cependant l'espacer de la fondamentale à l'aide de la propriété
+@code{chordPrefixSpacer}.  Notez bien que cet espacement sera réduit à
+néant si la fondamentale est altérée.

 
 

+@end table

 
 @predefined
 
 @predefined

+@funindex symboles de septième majeure
+@code{\whiteTriangleMarkup},
+@code{\blackTriangleMarkup},

 @funindex \germanChords
 @code{\germanChords},
 @funindex \semiGermanChords
 @funindex \germanChords
 @code{\germanChords},
 @funindex \semiGermanChords


@@ -408,34 +740,71 @@ Banter.  Pour la mise en œuvre de ces modèles, voir
 @endpredefined
 
 
 @endpredefined
 
 

+@snippets
+
+@cindex exceptions, chiffrage d'accords
+@cindex chiffrage d'accords, exceptions
+@cindex accords chiffrés, exceptions
+@lilypondfile[verbatim,quote,texidoc,doctitle]
+{chord-name-exceptions.ly}
+
+@c TODO - tweak snippet to use \blackTriangleMarkup as well
+@lilypondfile[verbatim,quote,texidoc,doctitle]
+{chord-name-major7.ly}
+
+@lilypondfile[verbatim,quote,texidoc,doctitle]
+{adding-bar-lines-to-chordnames-context.ly}
+
+@lilypondfile[verbatim,quote,texidoc,doctitle]
+{volta-below-chords.ly}
+
+@lilypondfile[verbatim,quote,texidoc,doctitle]
+{changing-chord-separator.ly}
+

 @seealso
 @seealso

-Morceaux choisis :
-@rlsrnamed{Chords,Accords}.
+Manuel de notation :
+@ref{Table des noms d'accord},
+@ref{Modificateurs d'accord usuels}.

 
 

-Fichiers internes :
-@file{scm/@/chords@/-ignatzek@/.scm},
-@file{scm/@/chord@/-entry@/.scm}.
+Essai sur la gravure musicale automatisée :
+@ressay{Références bibliographiques}.

 
 

+Fichiers d'initialisation :
+@file{scm/chords-ignatzek.scm},
+@file{scm/chord-entry.scm},
+@file{ly/chord-modifier-init.ly}.

 
 

-@knownissues
+Morceaux choisis :
+@rlsrnamed{Chords,Accords}.

 
 

+@knownissues

 Les chiffrages d'accords ne sont déterminés que par la succession des
 hauteurs de notes.  En d'autres termes, les accords inversés ne sont pas
 reconnus, ni les notes ajoutées à la basse.  C'est pourquoi les accords
 saisis au moyen de la syntaxe @code{<@dots{}>} peuvent produire des
 chiffrages étranges.
 
 Les chiffrages d'accords ne sont déterminés que par la succession des
 hauteurs de notes.  En d'autres termes, les accords inversés ne sont pas
 reconnus, ni les notes ajoutées à la basse.  C'est pourquoi les accords
 saisis au moyen de la syntaxe @code{<@dots{}>} peuvent produire des
 chiffrages étranges.
 

-@node Personnalisation des noms d'accord
-@unnumberedsubsubsec Personnalisation des noms d'accord
-@translationof Customizing chord names
+@lilypond[quote,ragged-right,verbatim]
+myChords = \relative c' {
+  \chordmode { c1 c/g c/f }
+  <c e g>1 <g c e> <f c' e g>
+}
+<<
+  \new ChordNames { \myChords }
+  \new Staff { \myChords }
+>>
+@end lilypond

 
 

-@untranslated

 
 @node Basse chiffrée
 @subsection Basse chiffrée
 @translationof Figured bass
 
 
 @node Basse chiffrée
 @subsection Basse chiffrée
 @translationof Figured bass
 

-@untranslated
+@c Line width hack because of instrument names
+@lilypondfile[quote,staffsize=18,line-width=14.5\cm]
+{figured-bass-headword.ly}
+
+LilyPond permet de générer des parties de continuo.

 
 @menu
 * Introduction à la basse chiffrée::
 
 @menu
 * Introduction à la basse chiffrée::


@@ -443,7 +812,7 @@ chiffrages étranges.
 * Gravure de la basse chiffrée::
 @end menu
 
 * Gravure de la basse chiffrée::
 @end menu
 

-@c This material comes from 'Figured bass', needs redistribution by translator --FV
+

 @node Introduction à la basse chiffrée
 @unnumberedsubsubsec Introduction à la basse chiffrée
 @translationof Introduction to figured bass
 @node Introduction à la basse chiffrée
 @unnumberedsubsubsec Introduction à la basse chiffrée
 @translationof Introduction to figured bass


@@ -469,197 +838,384 @@ lui-même l'accompagnement.
 
 LilyPond gère la basse chiffrée.
 
 
 LilyPond gère la basse chiffrée.
 

-@lilypond[quote,ragged-right,verbatim,fragment]
+@lilypond[quote,ragged-right,verbatim]

 <<
   \new Voice { \clef bass dis4 c d ais g fis}
 <<
   \new Voice { \clef bass dis4 c d ais g fis}

-  \new FiguredBass \figuremode {
-    < 6 >4 < 7\+ >8 < 6+ [_!] >
-    < 6 >4 <6 5 [3+] >
-    < _ >4 < 6 5/>4
+  \new FiguredBass {
+    \figuremode {
+      < 6 >4 < 7\+ >8 < 6+ [_!] >
+      < 6 >4 <6 5 [3+] >
+      < _ >4 < 6 5/>4
+    }

   }
 >>
 @end lilypond
 
 La gestion de la basse chiffrée se décompose en deux parties.  Dans un
 premier temps, le mode @code{\figuremode} permet de saisir les accords
   }
 >>
 @end lilypond
 
 La gestion de la basse chiffrée se décompose en deux parties.  Dans un
 premier temps, le mode @code{\figuremode} permet de saisir les accords

-sous forme chiffrée.  Le contexte @rinternals{FiguredBass} s'occupera
-ensuite de gérer les objets @rinternals{BassFigure}.
+sous forme chiffrée.  Le contexte @code{FiguredBass} s'occupera ensuite
+de gérer les objets @code{BassFigure}.  La basse chiffrée pourra être
+attachée à un contexte @code{Staff}.
+
+L'expression @code{\figures@{ ... @}} constitue une raccourci à
+@code{\new FiguredBass @{ \figuremode @{ ... @} @}}.
+
+Bien que la gestion de la basse chiffrée ressemble beaucoup à celle
+des accords, elle est beaucoup plus simpliste.  Le mode
+@code{\figuremode} ne fait que stocker des chiffres que le contexte
+@code{FiguredBass} se chargera d'imprimer tels quels.  En aucune manière
+ils ne sont transformés en son, et ils ne sont pas rendus dans un
+fichier MIDI.
+
+@ignore
+En interne, ce code produit des étiquettes de texte que vous
+pouvez formater à votre convenance grâce aux propriétés des
+étiquettes.  Par exemple, l'espacement vertical des chiffrages est
+déterminé par la propriété @code{baseline-skip}.
+@end ignore
+
+@seealso
+Glossaire musicologique :
+@rglosnamed{figured bass, basse chifrée}.
+
+Morceaux choisis :
+@rlsrnamed{Chords,Accords}.
+
+
+@node Saisie de la basse chiffrée
+@unnumberedsubsubsec Saisie de la basse chiffrée
+@translationof Entering figured bass
+
+@code{\figuremode} permet de faire la relation entre ce qui est saisi et
+le mode de chiffrage.  De plus amples informations quant aux différents
+modes sont regroupées à la rubrique @ref{Modes de saisie}.

 
 En mode de saisie, un chiffrage est délimité par @code{<} et
 
 En mode de saisie, un chiffrage est délimité par @code{<} et

-@code{>}.  La  durée est indiquée après le @code{>}@tie{}:
+@code{>}.  La  durée est indiquée après le @code{>} :
+
+@lilypond[verbatim,quote,ragged-right]
+\new FiguredBass {
+  \figuremode {
+    <6 4>2
+  }
+}
+@end lilypond
+
+Une altération -- y compris un bécarre -- peut s'attacher à un
+chiffre :

 
 

-@example
-<4 6>
-@end example
-@lilypond[quote,ragged-right,fragment]
-\new FiguredBass
-\figuremode { <4 6> }
+@lilypond[verbatim,quote,ragged-right]
+\figures {
+  <7! 6+ 4-> <5++> <3-->
+}

 @end lilypond
 
 @end lilypond
 

-Les altérations s'obtiennent en ajoutant aux chiffres les caractères
-@code{-}, @code{!} ou @code{+}. Un signe plus s'obtient grâce à
-@code{\+}, et une quinte ou septième diminuée par @code{5/} ou
-@code{7/} respectivement.
+Vous pouvez stipuler un intervalle augmenté ou diminué :

 
 

-@example
-<4- 6+ 7!> <5++> <3--> <7/> r <6\+ 5/>
-@end example
-@lilypond[quote,ragged-right,fragment]
-\figures { <4- 6+ 7!> <5++> <3--> <7/> r <6\+ 5/> }
+@lilypond[verbatim,quote,ragged-right]
+\figures {
+  <6\+ 5/> <7/>
+}

 @end lilypond
 
 @end lilypond
 

-Le caractère @code{_} insère un espace, et l'on peut imprimer des
-crochets avec @code{[} et @code{]}.  Vous pouvez aussi ajouter des
-chaînes de caractères ou des étiquettes --- cf. @ref{Text markup commands}.
+Vous pouvez barrer un chiffre d'une oblique inversée, typiquement pour
+une @qq{petite sixte} :

 
 

-@example
-<[4 6] 8 [_! 12] > <5 \markup @{ \number 6 \super (1) @} >
-@end example
-@lilypond[quote,ragged-right,fragment]
-\new FiguredBass
-\figuremode { < [4 6] 8 [_! 12] > < 5 \markup{ \tiny \number 6 \super (1)} > }
+@lilypond[verbatim,quote,ragged-right]
+\figures {
+  <6> <6\\>
+}

 @end lilypond
 
 @end lilypond
 

+Vous pouvez insérer un espace ou ajouter des crochets :
+
+@lilypond[verbatim,quote,ragged-right]
+\figures {
+  <[12 _!] 8 [6  4]>
+}
+@end lilypond
+
+Vous pouvez aussi ajouter des chaînes de caractères ou des étiquettes --
+cf. @ref{Text markup commands}.
+
+@lilypond[verbatim,quote,ragged-right]
+\figures {
+  <\markup { \tiny \number 6 \super (1) } 5>
+}
+@end lilypond
+
+@c NOTE: We need to include notes any time we use extenders to
+@c avoid extraneous staff creation due to Staff.use... in
+@c \bassFigureExtendersOn
+

 Lorsque des chiffrages se répètent, vous pouvez utiliser des lignes de
 prolongation.
 
 Lorsque des chiffrages se répètent, vous pouvez utiliser des lignes de
 prolongation.
 

-@lilypond[verbatim,relative=1]
+@lilypond[verbatim,quote,ragged-right]

 <<
 <<

-  \new Staff {
+  {

     \clef bass
     \clef bass

-    c4 c c
+    e4 d c b,
+    e4 d c b,

   }
   \figures {
   }
   \figures {

-    \set useBassFigureExtenders = ##t
-    <4 6> <3 6> <3 7>
+    \bassFigureExtendersOn
+    <6 4>4 <6 3> <7 3> <7 3>
+    \bassFigureExtendersOff
+    <6 4>4 <6 3> <7 3> <7 3>

   }
 >>
 @end lilypond
 
 @noindent
 En pareil cas, la ligne de prolongation masquera toujours le chiffre
   }
 >>
 @end lilypond
 
 @noindent
 En pareil cas, la ligne de prolongation masquera toujours le chiffre

-qu'elle rappelle dans le chiffrage suivant.
-
-Le contexte @code{FiguredBass} ne tient aucun compte de la ligne de
-basse.  Par conséquent, il vous faudra peut être insérer des chiffrages
-supplémentaires pour imprimer les prolongations, ou utiliser des
-@code{\!} pour les éviter, comme dans l'exemple suivant@tie{}:
+qu'elle rappelle dans le chiffrage suivant à moins d'avoir été
+explicitement interrompue.

 
 

-@lilypond[relative=1]
+@lilypond[verbatim,quote,ragged-right]

 <<
 <<

-  \new Voice

   \figures {
   \figures {

-    \set useBassFigureExtenders = ##t
-    <6 4->4. <6 4->16. <6 4->32 <5>8. r16 <6>8 <6\! 5->
+    \bassFigureExtendersOn
+    <6 4>4 <6 4> <6\! 4\!> <6 4>

   }
   {
     \clef bass
   }
   {
     \clef bass

-    f16. g32 f16. g32 f16. g32 f16. g32 f8. es16 d8 es
+    d4 d c c

   }
 >>
 @end lilypond
 
   }
 >>
 @end lilypond
 

-Lorsque vous utilisez des lignes de prolongation, les chiffres communs
-seront verticalement alignés.  Pour l'éviter, insérez un silence avec
-@code{r} afin de réinitialiser l'alignement.  Par exemple, saisissez
-
-@example
-  <4 6>8 r8
-@end example
+Voici, de manière synthétique, les différents modificateurs
+disponibles :
+
+@multitable @columnfractions .1 .5 .4
+
+@item
+@b{Modificateur}
+@tab
+@b{Utilisation}
+@tab
+@b{Exemple}
+
+@item
++, -, !
+@tab
+Altérations
+@tab
+@lilypond[line-width=4\cm]
+\figures {
+  <7! 6+ 4-> <5++> <3-->
+}
+@end lilypond

 
 

-@noindent
-au lieu de
-@example
-  <4 6>4
-@end example
+@item
+\+, /
+@tab
+Augmentation ou diminution d'un degré
+@tab
+@lilypond[line-width=4\cm]
+\figures {
+  <6\+ 5/> <7/>
+}
+@end lilypond

 
 

-On peut choisir d'impriemr les altérations et signes plus aussi bien
-avant qu'après les chiffres, en réglant les propriétés
-@code{figuredBassAlterationDirection} et
-@code{figuredBassPlusDirection}.
+@item
+\\
+@tab
+Petite sixte
+@tab
+@lilypond[line-width=4\cm]
+\figures {
+  <6\\>
+}
+@end lilypond

 
 

-@lilypond
+@item
+\!
+@tab
+Terminaison d'une prolongation
+@tab
+@lilypond[line-width=4\cm]
+<<

   \figures {
   \figures {

-    <6\+> <5+> <6 4-> r
-    \set figuredBassAlterationDirection = #1
-    <6\+> <5+> <6 4-> r
-    \set figuredBassPlusDirection = #1
-    <6\+> <5+> <6 4-> r
-    \set figuredBassAlterationDirection = #-1
-    <6\+> <5+> <6 4-> r
+    \bassFigureExtendersOn
+    <6 4> <6 4> <6\! 4\!> <6 4>

   }
   }

+  {
+    \clef bass
+    d d c c
+  }
+>>

 @end lilypond
 
 @end lilypond
 

-Bien que la gestion de la basse chiffrée ressemble beaucoup à celle
-des accords, elle est beaucoup plus simpliste.  Le mode
-@code{\figuremode} ne fait que stocker des chiffres que le contexte
-@rinternals{FiguredBass} se chargera d'imprimer tels quels.  En
-aucune manière ils ne sont transformés en son, et ils ne sont pas
-rendus dans un fichier MIDI.
+@end multitable

 
 

-En interne, ce code produit des étiquettes de texte que vous
-pouvez formater à votre convenance grâce aux propriétés des
-étiquettes.  Par exemple, l'espacement vertical des chiffrages est
-déterminé par la propriété @code{baseline-skip}.
+@predefined
+@cindex basse chiffrée, lignes d'extension
+@code{\bassFigureExtendersOn},
+@code{\bassFigureExtendersOff}.
+@endpredefined

 
 

-On peut également ajouter une basse chiffrée directement à un contexte
-@code{Staff}.  L'alignement vertical est alors automatiquement ajusté.
+@snippets
+@lilypondfile[verbatim,quote,texidoc,doctitle]
+{changing-the-positions-of-figured-bass-alterations.ly}
+
+@seealso
+Morceaux choisis :
+@rlsrnamed{Chords,Accords}.

 
 

-@lilypond[ragged-right,fragment,quote]
+Référence des propriétés internes :
+@rinternals{BassFigure},
+@rinternals{BassFigureAlignment},
+@rinternals{BassFigureLine},
+@rinternals{BassFigureBracket},
+@rinternals{BassFigureContinuation},
+@rinternals{FiguredBass}.
+
+
+@node Gravure de la basse chiffrée
+@unnumberedsubsubsec Gravure de la basse chiffrée
+@translationof Displaying figured bass
+
+Une ligne de basse chiffrée s'imprime soit dans un contexte
+@code{FiguredBass}, soit dans la plupart des autres contextes du niveau
+de la portée.
+
+Le contexte @code{FiguredBass} ne tient aucun compte des notes qui
+apparaissent sur la portée.
+
+@lilypond[verbatim,ragged-right,quote]

 <<
 <<

-  \new Staff = someUniqueName

   \relative c'' {
     c4 c'8 r8 c,4 c'
   }
   \relative c'' {
     c4 c'8 r8 c,4 c'
   }

-
-  %% send to existing Staff.
-  \context Staff = someUniqueName
-  \figuremode {
-    <4>4 <6 10>8 s8
-
-    \set Staff.useBassFigureExtenders = ##t
-    <4 6>4 <4 6>
+  \new FiguredBass {
+    \figuremode {
+      <4>4 <10 6>8 s8
+      <6 4>4 <6 4>
+    }

   }
 >>
 @end lilypond
 
   }
 >>
 @end lilypond
 

-@commonprop
+@noindent
+Il est impératif, dans cet exemple, d'instancier explicitement le
+contexte @code{FiguredBass} pour éviter l'apparition d'une portée
+supplémentaire vide.

 
 

-Par défaut, les chiffres sont imprimés au-dessus de la portée.  Pour les
-imprimer dessous, ajoutez
+On peut ajouter une basse chiffrée directement à un contexte
+@code{Staff}.  L'alignement vertical est alors automatiquement ajusté.

 
 

-@example
-\override Staff.BassFigureAlignmentPositioning #'direction = #DOWN
-@end example
+@lilypond[verbatim,ragged-right,quote]
+<<
+  \new Staff = myStaff
+  \figuremode {
+    <4>4 <10 6>8 s8
+    <6 4>4 <6 4>
+  }
+  %% Put notes on same Staff as figures
+  \context Staff = myStaff
+  {
+    \clef bass
+    c4 c'8 r8 c4 c'
+  }
+>>
+@end lilypond

 
 

-@knownissues
+La basse chiffrée attachée à un contexte @code{Staff} peut se
+positionner au-dessus ou en dessous de la portée.

 
 

-Si vous positionnez la basse chiffrée au dessus de la portée en ayant
-recours aux lignes d'extension et @code{implicitBassFigures}, les lignes
-peuvent se mélanger.  Préserver l'ordre des prolongateurs peut s'avérer
-impossible lorsque plusieurs chiffrages qui se chevauchent en possèdent.
-Ce problème peut être contourné en jouant sur l'empilement, avec la
-propriété @code{stacking-dir} de l'objet @code{BassFigureAlignment}.
+@lilypond[verbatim,ragged-right,quote]
+<<
+  \new Staff = myStaff
+  \figuremode {
+    <4>4 <10 6>8 s8
+    \bassFigureStaffAlignmentDown
+    <6 4>4 <6 4>
+  }
+  %% Put notes on same Staff as figures
+  \context Staff = myStaff
+  {
+    \clef bass
+    c4 c'8 r8 c4 c'
+  }
+>>
+@end lilypond

 
 

+@predefined
+@cindex basse chiffrée, alignement
+@code{\bassFigureStaffAlignmentDown},
+@code{\bassFigureStaffAlignmentUp},
+@code{\bassFigureStaffAlignmentNeutral}.
+@endpredefined

 
 @seealso
 
 @seealso

-Référence des pripriétés internes : les objets
+Morceaux choisis :
+@rlsrnamed{Chords,Accords}.
+
+Référence des propriétés internes :

 @rinternals{BassFigure},
 @rinternals{BassFigureAlignment},
 @rinternals{BassFigureLine},
 @rinternals{BassFigure},
 @rinternals{BassFigureAlignment},
 @rinternals{BassFigureLine},

-@rinternals{BassFigureBracket} et
-@rinternals{BassFigureContinuation}, ainsi que le contexte
+@rinternals{BassFigureBracket},
+@rinternals{BassFigureContinuation},

 @rinternals{FiguredBass}.
 
 @rinternals{FiguredBass}.
 

+@knownissues
+Les lignes de prolongation seront correctes dès lors que notes et
+chiffrages adoptent des durées identiques.

 
 

-@node Saisie de la basse chiffrée
-@unnumberedsubsubsec Saisie de la basse chiffrée
-@translationof Entering figured bass
+@lilypond[verbatim,ragged-right,quote]
+<<
+  {
+    \clef bass
+    \repeat unfold 4 { f16. g32 } f8. es16 d8 es
+  }
+  \figures {
+    \bassFigureExtendersOn
+    % The extenders are correct here, with the same rhythm as the bass
+    \repeat unfold 4 { <6 4->16. <6 4->32 }
+    <5>8. r16 <6>8 <6\! 5->
+  }
+>>
+<<
+  {
+    \clef bass
+    \repeat unfold 4 { f16. g32 } f8. es16 d8 es
+  }
+  \figures {
+    \bassFigureExtendersOn
+    % The extenders are incorrect here, even though the timing is the same
+    <6 4->4 <6 4->4
+    <5>8. r16 <6>8 <6\! 5->
+  }
+>>
+@end lilypond

 
 

-@untranslated
+Préserver l'ordre des prolongateurs peut s'avérer impossible lorsque
+plusieurs chiffrages qui se chevauchent en possèdent.

 
 

-@node Gravure de la basse chiffrée
-@unnumberedsubsubsec Gravure de la basse chiffrée
-@translationof Displaying figured bass
+@lilypond[verbatim,ragged-right,quote,relative=1]
+<<
+  { fis4 g g, e' }
+  \figures {
+    \bassFigureExtendersOn
+    <6 5>4 <5\! 4> < 5 _!> <6>
+  }
+>>
+@end lilypond
+
+Ce problème peut être contourné en activant les prolongateurs derrière
+le chiffrage qui l'entame, puis en les désactivant derrière leur fin.

 
 

-@untranslated
+@lilypond[verbatim,ragged-right,quote,relative=1]
+<<
+  { fis4 g g, e' }
+  \figures {
+    <6 5>4 <5 4>
+    \bassFigureExtendersOn
+    < 5 _!>4 <6>
+    \bassFigureExtendersOff
+  }
+>>
+@end lilypond