Merge remote-tracking branch 'origin/translation'

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

diff --git a/Documentation/fr/notation/staff.itely b/Documentation/fr/notation/staff.itely
index a27ab1a12f9eefbb73646f1b6f86ea3a2d203584..923cb212a0f4111de90416cd7471f591d3959702 100644 (file)
--- a/Documentation/fr/notation/staff.itely
+++ b/Documentation/fr/notation/staff.itely
@@ -1,656 +1,1563 @@
-@c -*- coding: utf-8; mode: texinfo; -*-
+@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
+

 @ignore
 @ignore

-    Translation of GIT committish: bdf8540b74167817eab96ed3d13b35477217f9fe
+    Translation of GIT committish: d46572826e777ed3e9fa4656535a6e9000f2ed9e

 
     When revising a translation, copy the HEAD committish of the
 
     When revising a translation, copy the HEAD committish of the

-    version that you are working on.  See TRANSLATION for details.
+    version that you are working on.  For details, see the Contributors'
+    Guide, node Updating translation committishes..

 @end ignore
 
 @end ignore
 

-@c \version "2.12.0"
+@c \version "2.19.2"

 
 @c Translators: Valentin Villenave, Jean-Charles Malahieude
 @c Translation checkers: John Mandereau
 
 
 @c Translators: Valentin Villenave, Jean-Charles Malahieude
 @c Translation checkers: John Mandereau
 

-@node Staff notation
-@section Staff notation
+@node Notation sur la portée
+@section Notation sur la portée
+@translationof Staff notation

 
 

-@lilypondfile[quote]{staff-headword.ly}
+@c The line width is a bit of a hack to allow space for the
+@c  instrument names.
+@lilypondfile[quote,ragged-right,line-width=14.5\cm,staffsize=16]
+{staff-headword.ly}

 
 Cette section aborde les détails de gravure de la portée, la
 
 Cette section aborde les détails de gravure de la portée, la

-réalisation de partitions avec plusieurs portées et l'ajout
+réalisation de partitions comprenant plusieurs portées et l'ajout

 d'indications globales d'exécution, présentes sur certaines portées
 seulement.
 
 @menu
 d'indications globales d'exécution, présentes sur certaines portées
 seulement.
 
 @menu

-* Displaying staves::           
-* Modifying single staves::     
-* Writing parts::               
+* Gravure des portées::
+* Modification de portées individuelles::
+* Écriture de parties séparées::

 @end menu
 
 
 @end menu
 
 

-@node Displaying staves
-@subsection Displaying staves
+@node Gravure des portées
+@subsection Gravure des portées
+@translationof Displaying staves
+
+Nous allons voir ici comment créer des portées et comment les regrouper.

 
 @menu
 
 @menu

-* Instantiating new staves::    
-* Grouping staves::             
-* Nested staff groups::  
+* Initialisation de nouvelles portées::
+* Regroupement de portées::
+* Imbrication de regroupements de portées::
+* Séparation des systèmes::

 @end menu
 
 @end menu
 

-@node Instantiating new staves
-@unnumberedsubsubsec Instantiating new staves

 
 

-@untranslated
+@node Initialisation de nouvelles portées
+@unnumberedsubsubsec Initialisation de nouvelles portées
+@translationof Instantiating new staves
+
+@cindex nouvelle portée
+@cindex portée, initialisation
+@cindex portée, instanciation
+@cindex portée, nouvelle
+@cindex portée simple
+@cindex portée de batterie
+@cindex portée de percussion
+@cindex batterie, portée
+@cindex percussion, portée
+@cindex portée, transcription de grégorien
+@cindex portée rythmique
+@cindex portée de tablature
+@cindex tablature
+
+@funindex \drummode
+@funindex drummode
+@funindex DrumStaff
+@funindex RhythmicStaff
+@funindex TabStaff
+@funindex MensuralStaff
+@funindex VaticanaStaff
+@funindex GregorianTranscriptionStaff
+
+Les @notation{portées} -- en anglais @emph{staff} (@emph{staves}
+au pluriel) -- sont créées à l'aide des commandes @code{\new} ou
+@code{\context}.  Pour de plus amples détails, consultez
+@ref{Création et référencement d'un contexte}.
+
+Le contexte de portée standard s'appelle @code{Staff} :
+
+@lilypond[verbatim,quote,relative=2]
+\new Staff { c4 d e f }
+@end lilypond
+
+Le contexte @code{DrumStaff} crée une portée à cinq lignes correspondant
+à une batterie traditionnelle et chacun des instruments est représenté
+par un symbole spécifique.  Les éléments sont saisis en mode batterie,
+initialisé par la commande @code{\drummode}, chaque composante étant
+spécifiée par son nom.  Pour de plus amples détails, consultez
+@ref{Portées de percussion}.
+
+@lilypond[verbatim,quote]
+\new DrumStaff {
+  \drummode { cymc hh ss tomh }
+}
+@end lilypond
+
+Un @code{RhythmicStaff} est composé d'une portée à ligne unique chargée
+de présenter les valeurs rythmiques saisies.  Seules sont imprimées les
+durées.  Pour de plus amples détails, consultez
+@ref{Gravure de lignes rythmiques}.
+
+@lilypond[verbatim,quote,relative=2]
+\new RhythmicStaff { c4 d e f }
+@end lilypond
+
+Un @code{TabStaff} crée une portée de tablature correspondant aux six
+cordes d'une guitare standard.  Pour de plus amples détails, consultez
+@ref{Tablatures par défaut}.
+
+@lilypond[verbatim,quote,relative=2]
+\new TabStaff { c4 d e f }
+@end lilypond
+
+LilyPond dispose aussi de deux contextes dédiés à la musique
+ancienne : @code{MensuralStaff} et @code{VaticanaStaff}.  Ils sont
+abordés plus en détails au chapitre @ref{Contextes prédéfinis}.
+
+Le contexte @code{GregorianTranscriptionStaff} permet d'obtenir des
+éditions modernes du grégorien.  Bien entendu, il est dépourvu de barres
+de mesure.
+
+@lilypond[verbatim,quote,relative=2]
+\new GregorianTranscriptionStaff { c4 d e f e d }
+@end lilypond

 
 

+Vous pourrez toujours définir d'autres contextes de portée selon vos
+besoins, en suivant les indications fournies au chapitre
+@ref{Définition de nouveaux contextes}.

 
 

-@node Grouping staves
-@unnumberedsubsubsec Grouping staves
+@seealso
+Glossaire musicologique :
+@rglos{staff},
+@rglosnamed{staves,portées}.
+
+Manuel de notation :
+@ref{Création et référencement d'un contexte},
+@ref{Portées de percussion},
+@ref{Gravure de lignes rythmiques},
+@ref{Tablatures par défaut},
+@ref{Contextes prédéfinis},
+@ref{Symbole de la portée},
+@ref{Contextes du chant grégorien},
+@ref{Contextes de musique mensurale},
+@ref{Définition de nouveaux contextes}.
+
+Morceaux choisis :
+@rlsrnamed{Staff notation, Notation sur la portée}.
+
+Référence des propriétés internes :
+@rinternals{Staff},
+@rinternals{DrumStaff},
+@rinternals{GregorianTranscriptionStaff},
+@rinternals{RhythmicStaff},
+@rinternals{TabStaff},
+@rinternals{MensuralStaff},
+@rinternals{VaticanaStaff},
+@rinternals{StaffSymbol}.
+
+
+@node Regroupement de portées
+@unnumberedsubsubsec Regroupement de portées
+@translationof Grouping staves

 
 @cindex système, début de
 @cindex crochet vertical
 @cindex accolade verticale
 @cindex portée multiple
 @cindex portées, groupe de
 
 @cindex système, début de
 @cindex crochet vertical
 @cindex accolade verticale
 @cindex portée multiple
 @cindex portées, groupe de

-
-De nombreuses partitions sont écrites sur plusieurs portées.  Ces
-portées peuvent être regroupées de quatre manières différentes.
-
-@itemize @bullet
-@item Le groupe de portées est attaché par une accolade sur la gauche,
-et les barres de mesure sont d'un seul tenant. Il s'agit du contexte
-@rinternals{GrandStaff}.
-
-@lilypond[verbatim,ragged-right,quote]
-\new GrandStaff
-\relative <<
+@cindex portées, regroupement
+@cindex chœur, système
+@cindex piano, système
+@cindex système choral
+@cindex système pianistique
+@cindex système, grand
+@cindex système
+
+LilyPond dispose de différents contextes permettant de regrouper des
+portées individuelles et d'obtenir ainsi des « systèmes ».  Chacun de
+ces contextes définira le style de regroupement, avec son signe
+particulier en début de portée et ses règles de gestion des barres de
+mesure.
+
+Lorsqu'aucun contexte particulier n'est spécifié, les propriétés
+suivantes s'appliqueront par défaut : les portées du groupe ne sont
+pas reliées, hormis par une simple ligne verticale en début de ligne, et
+les barres de mesure sont indépendantes.
+
+@lilypond[verbatim,quote,relative=2]
+<<
+  \new Staff { c1 c }

   \new Staff { c1 c }
   \new Staff { c1 c }

-  \new Staff { c c }

 >>
 @end lilypond
 
 >>
 @end lilypond
 

-@item Le groupe de portées est attaché par un crochet, et les barres
-de mesure sont d'un seul tenant. Il s'agit du contexte
-@rinternals{StaffGroup}.
+Dans un @code{StaffGroup}, le groupe de portées est signifié par un
+crochet, et les barres de mesure sont d'un seul tenant.

 
 

-@lilypond[verbatim,ragged-right,quote]
-\new StaffGroup
-\relative <<
+@lilypond[verbatim,quote,relative=2]
+\new StaffGroup <<
+  \new Staff { c1 c }

   \new Staff { c1 c }
   \new Staff { c1 c }

-  \new Staff { c c }

 >>
 @end lilypond
 
 >>
 @end lilypond
 

+Dans un @code{ChoirStaff}, le groupe de portées est signifié par un
+crochet sur la gauche, et les barres de mesure sont individuelles.

 
 

+@lilypond[verbatim,quote,relative=2]
+\new ChoirStaff <<
+  \new Staff { c1 c }
+  \new Staff { c1 c }
+>>
+@end lilypond

 
 

-@item Le groupe de portées est attaché par un crochet, mais les barres
-de mesure sont séparées d'une portée à l'autre. Il s'agit du contexte
-@rinternals{ChoirStaff}.
+Dans un @code{GrandStaff}, le groupe de portées est signifié par une
+accolade sur la gauche, et les barres de mesure sont d'un seul tenant.

 
 

-@lilypond[verbatim,ragged-right,quote]
-\new ChoirStaff
-\relative <<
+@lilypond[verbatim,quote,relative=2]
+\new GrandStaff <<
+  \new Staff { c1 c }

   \new Staff { c1 c }
   \new Staff { c1 c }

-  \new Staff { c c }

 >>
 @end lilypond
 
 >>
 @end lilypond
 

-@item Les portées du groupe ne sont pas attachées (hormis par une
-simple ligne verticale). Les barres de mesure sont détachées. Il
-s'agit de l'assemblage par défaut.
+Le contexte @code{PianoStaff} est identique au @code{GrandStaff}, sauf
+qu'il gère automatiquement l'affichage du nom d'instrument -- voir
+@ref{Noms d'instrument} pour plus de détails.

 
 

-@lilypond[verbatim,ragged-right,quote]
-\relative <<
+@lilypond[verbatim,quote,relative=2]
+\new PianoStaff <<
+  \set PianoStaff.instrumentName = #"Piano"
+  \new Staff { c1 c }

   \new Staff { c1 c }
   \new Staff { c1 c }

-  \new Staff { c c }

 >>
 @end lilypond
 >>
 @end lilypond

-@end itemize

 
 

+Les barres de mesure au début de chaque système adoptent l'un des styles
+@code{SystemStartBar}, @code{SystemStartBrace} ou
+@code{SystemStartBracket}.  Dans chaque contexte, seul l'un de ces
+styles est utilisé, et c'est la propriété @code{systemStartDelimiter}
+qui détermine lequel.  Un quatrième style, @code{SystemStartSquare},
+doit quant à lui être spécifié de manière explicite.
+
+Vous pouvez aussi créer vos propres contextes de regroupement, comme
+l'explique @ref{Définition de nouveaux contextes}.
+
+@snippets
+@lilypondfile[verbatim,quote,texidoc,doctitle]
+{use-square-bracket-at-the-start-of-a-staff-group.ly}
+
+@lilypondfile[verbatim,quote,texidoc,doctitle]
+{display-bracket-with-only-one-staff-in-a-system.ly}
+
+@cindex présentation mensurale
+@cindex renaissance, musique
+@cindex transcription de musique ancienne
+@cindex musique ancienne, transcription
+
+@lilypondfile[verbatim,quote,texidoc,doctitle]
+{mensurstriche-layout-bar-lines-between-the-staves.ly}

 
 @seealso
 
 @seealso

-Les barres de mesure au début de chaque système prennent l'un des styles
-@rinternals{SystemStartBar}, @rinternals{SystemStartBrace},
-@rinternals{SystemStartBracket}.  Dans chaque contexte, seul l'un de
-ces styles est utilisé, et c'est la propriété
-@code{systemStartDelimiter} qui détermine lequel.
-
-
-@commonprop
-
-Les accolades et crochets délimitant les systèmes peuvent être imbriqués
-en profondeur,
-
-@lilypond[quote,ragged-right,verbatim]
-\new StaffGroup
-\relative <<
-  \set StaffGroup.systemStartDelimiterHierarchy
-    = #'(SystemStartSquare (SystemStartBracket a (SystemStartSquare b)) d)
-  \new Staff { c1 }
-  \new Staff { c1 }
-  \new Staff { c1 }
-  \new Staff { c1 }
-  \new Staff { c1 }
+Glossaire musicologique :
+@rglosnamed{brace,accolade},
+@rglosnamed{bracket,crochet},
+@rglosnamed{grand staff,système}.
+
+Manuel de notation :
+@ref{Noms d'instrument},
+@ref{Définition de nouveaux contextes}.
+
+Morceaux choisis :
+@rlsrnamed{Staff notation, Notation sur la portée}.
+
+Référence des propriétés internes :
+@rinternals{Staff},
+@rinternals{StaffGroup},
+@rinternals{ChoirStaff},
+@rinternals{GrandStaff},
+@rinternals{PianoStaff},
+@rinternals{SystemStartBar},
+@rinternals{SystemStartBrace},
+@rinternals{SystemStartBracket},
+@rinternals{SystemStartSquare}.
+
+@knownissues
+Un @code{PianoStaff} ne peut contenir, par défaut, de @code{ChordNames}.
+
+
+@node Imbrication de regroupements de portées
+@unnumberedsubsubsec Imbrication de regroupements de portées
+@translationof Nested staff groups
+
+@cindex portées, regroupement et imbrication
+@cindex systèmes imbriqués
+@cindex imbrication de systèmes
+@cindex délimitation, systèmes imbriqués
+
+Les accolades et crochets qui délimitent les systèmes peuvent être
+imbriqués en profondeur.  Chaque niveau inférieur aura son propre
+délimiteur, en plus de celui du niveau supérieur.
+
+@lilypond[verbatim,quote,relative=2]
+\new StaffGroup <<
+  \new Staff { c2 c | c2 c }
+  \new StaffGroup <<
+    \new Staff { g2 g | g2 g }
+    \new StaffGroup \with {
+      systemStartDelimiter = #'SystemStartSquare
+    }
+    <<
+      \new Staff { e2 e | e2 e }
+      \new Staff { c2 c | c2 c }
+    >>
+  >>

 >>
 @end lilypond
 
 >>
 @end lilypond
 

-@node Nested staff groups
-@unnumberedsubsubsec Nested staff groups
+Vous pouvez aussi créer vos propres contextes d'imbrication, comme
+l'explique @ref{Définition de nouveaux contextes}.

 
 

-@untranslated
+@snippets
+@lilypondfile[verbatim,quote,texidoc,doctitle]
+{nesting-staves.ly}

 
 

-@node Modifying single staves
-@subsection Modifying single staves
+@seealso
+Manuel de notation :
+@ref{Regroupement de portées},
+@ref{Noms d'instrument},
+@ref{Définition de nouveaux contextes}.
+
+Morceaux choisis :
+@rlsrnamed{Staff notation,Notation sur la portée}.
+
+Référence des propriétés internes :
+@rinternals{StaffGroup},
+@rinternals{ChoirStaff},
+@rinternals{SystemStartBar},
+@rinternals{SystemStartBrace},
+@rinternals{SystemStartBracket},
+@rinternals{SystemStartSquare}.
+
+
+@node Séparation des systèmes
+@unnumberedsubsubsec Séparation des systèmes
+@translationof Separating systems
+
+@cindex système, indicateur de séparation
+
+Le nombre de systèmes peut varier d'une page à l'autre ; vous
+pouvez, en pareil cas, rendre plus évidente la séparation entre les
+systèmes en l'indiquant visuellement.  Ce « séparateur » est absent par
+défaut, mais vous pouvez l'activer par une option au sein du bloc
+@code{\paper}.
+
+@c \book is required here to display the system separator
+@c ragged-right is required as there are two systems
+@lilypond[verbatim,quote,ragged-right]
+\book {
+  \score {
+    \new StaffGroup <<
+      \new Staff {
+        \relative c'' {
+          c4 c c c
+          \break
+          c4 c c c
+        }
+      }
+      \new Staff {
+        \relative c'' {
+          c4 c c c
+          \break
+          c4 c c c
+        }
+      }
+    >>
+  }
+  \paper {
+    system-separator-markup = \slashSeparator
+    % following commands are needed only to format this documentation
+    paper-width = 100\mm
+    paper-height = 100\mm
+    tagline = ##f
+  }
+}
+@end lilypond

 
 

-Cette section explique le réglage de la gravure de chaque portée,
-comme la taille de portée ou le nombre de lignes ; sont aussi décrits
-la suspension et la reprise de portées et les portées d'@emph{ossia}.
+@seealso
+Manuel de notation :
+@ref{Mise en forme de la page}.

 
 

+Morceaux choisis :
+@rlsrnamed{Staff notation,Notation sur la portée}.
+
+
+@node Modification de portées individuelles
+@subsection Modification de portées individuelles
+@translationof Modifying single staves
+
+Cette section explique le réglage de la gravure de chaque portée,
+comme la taille de portée ou le nombre de lignes ; sont aussi
+décrits la suspension et la reprise de portées, ainsi que les portées
+d'@emph{ossia}.

 
 @menu
 
 @menu

-* Staff symbol::                
-* Ossia staves::                
-* Hiding staves::               
+* Symbole de la portée::
+* Portées d'ossia::
+* Masquage de portées::

 @end menu
 
 @end menu
 

-@node Staff symbol
-@unnumberedsubsubsec Staff symbol
+
+@node Symbole de la portée
+@unnumberedsubsubsec Symbole de la portée
+@translationof Staff symbol

 
 @cindex symbole de portée
 @cindex portée, lignes de
 
 @cindex symbole de portée
 @cindex portée, lignes de

+@cindex lignes de portée, nombre de
+@cindex suspension de portée
+@cindex portée, suspension
+@cindex reprise de portée
+@cindex portée, reprise
+@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

 
 

-Les notes, nuances, etc. sont regroupés dans un assemblage de lignes
-horizontales, que l'on nomme la portée (en anglais @qq{staff}, et
-@qq{staves} au pluriel).  Dans LilyPond, ces lignes sont dessinées au
-moyen d'un objet de mise en forme à part entière, nommé @code{staff
-symbol} --- symbole de portée.
+@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
+@emph{staves} au pluriel).  Dans LilyPond, ces lignes sont dessinées au
+moyen d'un objet graphique (@emph{grob}) à part entière, nommé
+@code{StaffSymbol} -- symbole de portée.  Modifier les propriétés d'un
+@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 :
+
+@lilypond[verbatim,quote,relative=2]
+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.
+Une liste de nombres détermine le positionnement de chaque ligne.
+Le @code{0} correspond à la ligne médiane d'une portée habituelle, pour
+laquelle la liste est donc @code{(-4@tie{}-2@tie{}0@tie{}2@tie{}4)}.
+Une ligne sera donc imprimée pour chaque valeur exprimée ; 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

 
 

-L'aspect du symbole de portée peut être modifié selon différentes
-propriétés, telles que le nombre de lignes, leur épaisseur, ou leur
-éloignement.
-@ignore
-Vous en trouverez des exemples dans
-@lsr{staff,changing-the-number-of-lines-in-a-staff.ly} et
-@lsr{staff,changing-the-staff-size.ly}.
-@end ignore
+Afin de préserver l'orientation habituelle des hampes -- ascendantes
+dans la partie inférieure de la portée, descendantes dans la partie
+supérieure -- la ligne (ou l'interligne) centrale de la portée
+personnalisée devra être en phase avec avec la ligne médiane d'une
+portée classique (0).  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.
+
+@lilypond[verbatim,quote,relative=1]
+\new Staff \with {
+  \override StaffSymbol.thickness = #3
+}
+{ e4 d c b }
+@end lilypond

 
 

-De plus, la portée peut commencer et s'arrêter où l'on veut, grâce aux
-commandes @code{\startStaff} et @code{\stopStaff}.
+L'épaisseur des lignes supplémentaires (@emph{ledger lines}) peut être
+déterminée indépendamment des lignes de la portée.

 
 

-@lilypond[verbatim,relative=2,fragment]
-b4 b
-\override Staff.StaffSymbol #'line-count = 2
-\stopStaff \startStaff
-b b
-\revert Staff.StaffSymbol #'line-count
-\stopStaff \startStaff
-b b
+@lilypond[verbatim,quote,relative=2]
+\new Staff \with {
+  \override StaffSymbol.thickness = #2
+  \override StaffSymbol.ledger-line-thickness = #'(0.5 . 0.4)
+}
+{ f'4 a, a,, f }

 @end lilypond
 
 @end lilypond
 

-Cette manière de procéder peut être utilisée pour introduire des
-@qq{ossias}, ou dans des partitions à nombre de portées variable,
-comme sur l'exemple suivant :
+@noindent
+La première valeur est multipliée par l'épaisseur de ligne de portée, la
+seconde par l'espace d'interligne ; ces deux valeurs sont alors
+combinées pour donner la nouvelle épaisseur des lignes supplémentaires.
+
+L'emplacement des lignes supplémentaires est réglable :

 
 

-@cindex ossia
+@lilypond[verbatim,quote,relative=2]
+\new Staff \with {
+  \override StaffSymbol.ledger-positions = #'(-3 -2 -1 2 5 6)
+}
+{ f'4 a, a,, f }
+@end lilypond

 
 

-@c @lilypondfile{ossia.ly}
+Vous pouvez faire apparaître des lignes supplémentaires additionnelles
+au-dessus ou en dessous des têtes de note selon leur positionnement
+relatif aux autres notes, qu'elles aient ou non elles-mêmes des lignes
+supplémentaires.

 
 

-@cindex lignes de portée, nombre de
-@cindex lignes de portée, épaisseur des
-@cindex épaisseur des lignes de portées
-@cindex nombre de lignes de portée
+@lilypond[verbatim,quote,relative=2]
+\new Staff \with {
+  \override StaffSymbol.ledger-extra = #4
+}
+{ f'4 a, d, f, }
+@end lilypond

 
 

+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[verbatim,quote,relative=1]
+\override Staff.StaffSymbol.line-positions =   #'(-8 0 2 4)
+d4 e f g
+\stopStaff
+\startStaff
+\override Staff.StaffSymbol.ledger-positions = #'(-8 -6 (-4 -2) 0)
+d4 e f g
+@end lilypond

 
 

-@seealso
-Référence du programme : @rinternals{StaffSymbol}.
+Modifier l'équidistance des lignes de la portée affectera aussi les
+lignes supplémentaires.

 
 

-Exemples : @rlsr{Staff notation}.
+@lilypond[verbatim,quote,relative=2]
+\new Staff \with {
+  \override StaffSymbol.staff-space = #1.5
+}
+{ f'4 d, g, e, }
+@end lilypond

 
 

+@snippets
+@lilypondfile[verbatim,quote,texidoc,doctitle]
+{making-some-staff-lines-thicker-than-the-others.ly}

 
 

-@node Ossia staves
-@unnumberedsubsubsec Ossia staves
+@seealso
+Glossaire musicologique :
+@rglosnamed{line,ligne},
+@rglosnamed{ledger line,ligne supplémentaire},
+@rglosnamed{staff,portée}.

 
 

-@untranslated
+Manuel de notation :
+@ref{Clefs}.

 
 

+Morceaux choisis :
+@rlsrnamed{Staff notation,Notation sur la portée}.

 
 

-@node Hiding staves
-@unnumberedsubsubsec Hiding staves
+Référence des propriétés internes :
+@rinternals{StaffSymbol},
+@rinternals{staff-symbol-interface}.

 
 

-@cindex Frenched scores
-@cindex Masquer des portées

 
 

-Dans les partitions d'orchestre, les portées qui n'ont que des
-silences sont habituellement masquées afin de gagner de la place.  Ce
-style d'édition s'appelle en anglais @qq{French Score}.
-Cette fonctionnalité est activée par défaut dans les contextes 
-@rinternals{Lyrics}, @rinternals{ChordNames} et
-@rinternals{FiguredBass}.  Lorsque des lignes appartenant à ces
-contextes se retrouvent vides après placement des sauts de ligne,
-elles sont effacées.
-
-En ce qui concerne les portées normales, il existe un contexte
-@rinternals{Staff} spécifique qui permet d'arriver à ce résultat :
-les portées ne contenant rien ou uniquement des silences multi-mesures
-seront retirées.  La définition de ce contexte est enregistrée dans la
-variable @code{\RemoveEmptyStaffContext}.  Voyez comment la deuxième
-portée disparaît du deuxième système :
-
-@lilypond[quote,ragged-right,verbatim]
-\layout {
-  \context { \RemoveEmptyStaffContext }
+@node Portées d'ossia
+@unnumberedsubsubsec Portées d'ossia
+@translationof Ossia staves
+
+@cindex portée à la française
+@cindex ossia
+@cindex variante
+@cindex portées, nombre variable de
+@cindex nombre de portées
+
+@funindex \startStaff
+@funindex startStaff
+@funindex \stopStaff
+@funindex stopStaff
+
+Une portée d'@notation{ossia} -- ou de variante -- s'obtient en créant,
+à l'endroit approprié, une nouvelle portée simultanée :
+
+@lilypond[verbatim,quote]
+\new Staff \relative c'' {
+  c4 b d c
+  <<
+    { c4 b d c }
+    \new Staff { e4 d f e }
+  >>
+  c4 b c2

 }
 }

+@end lilypond

 
 

-{
-  \relative c' <<
-    \new Staff { e4 f g a \break c1 }
-    \new Staff { c4 d e f \break R1 }
+@noindent
+L'exemple ci-dessus n'est probablement pas ce qui vous conviendra le
+plus.  Afin que cette ossia se place au-dessus de la portée à laquelle
+elle se réfère, étant par ailleurs dépourvue de métrique et de clef, et
+d'une taille légèrement inférieure, vous devrez avoir recours à quelques
+retouches.  Le manuel d'initiation aborde une technique particulière
+pour obtenir ce résultat, au chapitre
+@rlearning{Expressions musicales imbriquées}.
+
+L'exemple qui suit utilise, pour aligner la portée d'ossia, la propriété
+@code{alignAboveContext}.  Cette méthode est tout à fait appropriée
+lorsqu'il y a un nombre restreint d'ossias.
+
+@lilypond[verbatim,quote]
+\new Staff = "main" \relative c'' {
+  c4 b d c
+  <<
+    { c4 b d c }
+
+    \new Staff \with {
+      \remove "Time_signature_engraver"
+      alignAboveContext = #"main"
+      fontSize = #-3
+      \override StaffSymbol.staff-space = #(magstep -3)
+      \override StaffSymbol.thickness = #(magstep -3)
+      firstClef = ##f
+    }
+    { e4 d f e }

   >>
   >>

+  c4 b c2

 }
 @end lilypond
 
 }
 @end lilypond
 

-Le premier système comportera absolument toutes les portées.  Si vous
-voulez masquer les portées vides y compris pour le premier système,
-vous devrez assigner vrai à la propriété @code{remove-first} dans
-@rinternals{VerticalAxisGroup}. 
+Dans le cas où de nombreux et courts fragments d'ossia affecteraient
+une même portée, il est judicieux de créer un contexte @code{Staff} vide
+auquel sera attribué un @emph{identifiant}. Il suffira alors, pour
+entamer un fragment d'ossia, de « faire appel » à ce contexte grâce
+aux commandes @code{\startStaff} et @code{\stopStaff}.  Vous vous
+rendrez compte à l'utilisation des avantages que procure cette façon de
+procéder, bien plus que dans l'exemple suivant.

 
 

-@example
-\override Score.VerticalAxisGroup #'remove-first = ##t
-@end example
+@lilypond[verbatim,quote,ragged-right]
+<<
+  \new Staff = "ossia" \with {
+    \remove "Time_signature_engraver"
+    \hide Clef
+    fontSize = #-3
+    \override StaffSymbol.staff-space = #(magstep -3)
+    \override StaffSymbol.thickness = #(magstep -3)
+  }
+  { \stopStaff s1*6 }
+
+  \new Staff \relative c' {
+    c4 b c2
+    <<
+      { e4 f e2 }
+      \context Staff = "ossia" {
+        \startStaff e4 g8 f e2 \stopStaff
+      }
+    >>
+    g4 a g2 \break
+    c4 b c2
+    <<
+      { g4 a g2 }
+      \context Staff = "ossia" {
+        \startStaff g4 e8 f g2 \stopStaff
+      }
+    >>
+    e4 d c2
+  }
+>>
+@end lilypond
+
+Vous pourriez aussi recourir à la commande
+@code{\Staff \RemoveEmptyStaves} pour créer votre portée d'ossia.
+Cependant, cette méthode reste limitée à l'apparition de ces ossias en
+début de ligne.  Pour plus d'information au sujet de la commande
+@code{\Staff \RemoveEmptyStaves}, reportez-vous au chapitre
+@ref{Masquage de portées}.
+
+@lilypond[verbatim,quote,ragged-right]
+<<
+  \new Staff = "ossia" \with {
+    \remove "Time_signature_engraver"
+    \hide Clef
+    fontSize = #-3
+    \override StaffSymbol.staff-space = #(magstep -3)
+    \override StaffSymbol.thickness = #(magstep -3)
+  } \relative c'' {
+    R1*3
+    c4 e8 d c2
+  }
+  \new Staff \relative c' {
+    c4 b c2
+    e4 f e2
+    g4 a g2 \break
+    c4 b c2
+    g4 a g2
+    e4 d c2
+  }
+>>
+
+\layout {
+  \context {
+    \Staff \RemoveEmptyStaves
+    \override VerticalAxisGroup.remove-first = ##t
+  }
+}
+@end lilypond

 
 

-Pour masquer d'autres types de contextes, vous pouvez utiliser 
-@code{\AncientRemoveEmptyStaffContext} ou
-@code{\RemoveEmptyRhythmicStaffContext}. 
+@snippets
+@lilypondfile[verbatim,quote,texidoc,doctitle]
+{vertically-aligning-ossias-and-lyrics.ly}

 
 

-Une application particulière de cette fonctionnalité est la création
-d'une @emph{ossia} --- variante d'une partie de la mélodie --- affichée à
-l'aide d'une portée supplémentaire.
+@seealso
+Glossaire musicologique :
+@rglos{ossia},
+@rglosnamed{staff,portée},
+@rglos{Frenched staff}.

 
 

+Manuel d'initiation :
+@rlearning{Expressions musicales imbriquées},
+@rlearning{Taille des objets},
+@rlearning{Longueur et épaisseur des objets}.

 
 

-@node Writing parts
-@subsection Writing parts
+Manuel de notation :
+@ref{Masquage de portées}.

 
 

-@menu
-* Metronome marks::             
-* Instrument names::            
-* Quoting other voices::        
-* Formatting cue notes::        
-@end menu
+Morceaux choisis :
+@rlsrnamed{Staff notation,Notation sur la portée}.

 
 

-@node Metronome marks
-@unnumberedsubsubsec Metronome marks
+Référence des propriétés internes :
+@rinternals{StaffSymbol}.

 
 

-@cindex Tempo
-@cindex battements par minute
-@cindex indication métronomique

 
 

-Le métronome se règle de la manière suivante,
-@example
-\tempo @var{durée} = @var{par minute}
-@end example
+@node Masquage de portées
+@unnumberedsubsubsec Masquage de portées
+@translationof Hiding staves

 
 

-Les indications métronomiques seront interprétées, dans le fichier
-MIDI, comme des changements de tempo.  Ils seront imprimés sur la
-partition comme ici :
-@funindex \tempo
-@lilypond[quote,ragged-right,verbatim,fragment]
-\tempo 8.=120 c''1
+@cindex Frenched scores
+@cindex masquage de portée
+@cindex portée vide
+
+@funindex \RemoveEmptyStaves
+@funindex Staff_symbol_engraver
+@funindex \stopStaff
+@funindex stopStaff
+
+Désactiver le graveur @code{Staff_symbol_engraver} dans un contexte
+@code{Staff} permet de masquer des lignes.  La commande
+@code{\stopStaff} aura le même effet.
+
+@lilypond[verbatim,quote]
+\new Staff \with {
+  \remove "Staff_symbol_engraver"
+}
+\relative c''' { a8 f e16 d c b a2 }

 @end lilypond
 
 @end lilypond
 

+L'instruction @code{\Staff \RemoveEmptyStaves} placée dans un bloc
+@code{\layout} aura pour effet de masquer toute portée qui ne contient
+rien.  Dans les partitions d'orchestre, les portées qui n'ont que des
+silences sont habituellement masquées afin de gagner de la place.  Ce
+style d'édition s'appelle en anglais « French Score ».
+Cette fonctionnalité masque et supprime toutes les portées vides d'une
+partition, hormis celles du premier système.

 
 

-@commonprop
+@warning{Une portée est considérée comme vide dès lors qu'elle ne
+contient que des silences multimesures, des silences visibles ou
+invisibles (ou d'espacement -- les @emph{@bs{}skip}) ou bien une
+combinaison de ces éléments.}

 
 

-Vous pouvez indiquer un changement de tempo pour le fichier MIDI sans
-pour autant l'imprimer.  Il suffit alors de le rendre invisible pour
-l'impression :
-@example
-\once \override Score.MetronomeMark #'transparent = ##t
-@end example
+@lilypond[verbatim,quote,ragged-right]
+\layout {
+  \context {
+    \Staff \RemoveEmptyStaves
+  }
+}

 
 

-Vous pouvez imprimer d'autres indications métronomiques, telles que
-des équivalences, en utilisant ce type d'étiquette textuelle :
-@lilypond[quote,ragged-right,verbatim,relative,fragment]
-c4^\markup {
-  (
-  \smaller \general-align #Y #DOWN \note #"16." #1
-  =
-  \smaller \general-align #Y #DOWN \note #"8" #1
-  ) }
+\relative c' <<
+  \new Staff {
+    e4 f g a \break
+    b1 \break
+    a4 b c2
+  }
+  \new Staff {
+    c,4 d e f \break
+    R1 \break
+    f4 g c,2
+  }
+>>

 @end lilypond
 
 @end lilypond
 

+@cindex ossia
+

 @noindent
 @noindent

-Pour plus de détails, voir @ref{Formatting text}.
+@code{\Staff \RemoveEmptyStaves} permet aussi de gérer des fragments
+d'ossia attachés à une portée.  Pour plus de détails, voir
+@ref{Portées d'ossia}.

 
 

+@cindex musique ancienne, masquage de portée
+@cindex portées rythmiques, masquage

 
 

-@seealso
-Référence du programme : @rinternals{MetronomeMark}.
+@funindex \RemoveEmptyStaves

 
 

+La commande @code{\VaticanaStaff \RemoveEmptyStaves} permet de masquer des
+portées vides dans les contextes de musique ancienne.  Pour des
+contextes @code{RhythmicStaff}, il faudra utiliser
+@code{\RhythmicStaff \RemoveEmptyStaves}.

 
 

-@knownissues
+@predefined
+@code{\Staff \RemoveEmptyStaves},
+@code{\VaticanaStaff \RemoveEmptyStaves},
+@code{\RhythmicStaff \RemoveEmptyStaves}.
+@endpredefined
+
+@snippets
+@lilypondfile[verbatim,quote,texidoc,doctitle]
+{removing-the-first-empty-line.ly}

 
 

-Les risques de collision ne sont pas vérifiés.  Dans le cas où il y
-aurait des notes au dessus de la portée ou d'autres objets
-(articulations, liaisons, texte, etc), l'indication métronomique peut
-venir en surimpression.  Augmentez alors le décalage de cette
-indication par rapport à la portée :
+@seealso
+Glossaire musicologique :
+@rglos{Frenched staff}.
+
+Manuel d'initiation:
+@rlearning{Visibilité et couleur des objets}.
+
+Manuel de notation :
+@ref{Modification des réglages par défaut d'un contexte},
+@ref{Symbole de la portée},
+@ref{Portées d'ossia},
+@ref{Dictée à trous},
+@ref{Silences invisibles},
+@ref{Visibilité des objets}.
+
+Morceaux choisis :
+@rlsrnamed{Staff notation,Notation sur la portée}.
+
+Référence des propriétés internes :
+@rinternals{ChordNames},
+@rinternals{FiguredBass},
+@rinternals{Lyrics},
+@rinternals{Staff},
+@rinternals{VerticalAxisGroup},
+@rinternals{Staff_symbol_engraver}.
+
+@knownissues
+Supprimer le @code{Staff_symbol_engraver} aura pour effet de masquer les
+barres de mesure.  Forcer leur visibilité peut entraîner des problèmes
+de formatage.  En pareil cas il vaut mieux, au lieu de supprimer le
+graveur, recourir aux dérogations suivantes :

 
 @example
 
 @example

-\override Score.MetronomeMark #'padding = #2.5
+\omit StaffSymbol
+\override NoteHead.no-ledgers = ##t

 @end example
 
 @end example
 

+En ce qui concerne les désagréments et messages liés à l'utilisation de
+l'instruction @code{\Staff \RemoveEmptyStaves}, consultez
+@ref{Modification des réglages par défaut d'un contexte}.

 
 

-@node Instrument names
-@unnumberedsubsubsec Instrument names

 
 

-Dans un conducteur, les noms d'instrument sont portés en regard de
-chacune des portées.
+@node Écriture de parties séparées
+@subsection Écriture de parties séparées
+@translationof Writing parts

 
 

-Ce résultat s'obtient en spécifiant
-@rinternals{Staff}.@code{instrumentName} et
-@rinternals{Staff}.@code{shortInstrumentName}, ou
-@rinternals{PianoStaff}.@code{instrumentName} et 
-@rinternals{PianoStaff}.@code{shortInstrumentName}.  L'argument
-textuel apparaîtra avant le début de la portée.  La première ligne
-affichera @code{instrumentName}, et les suivantes
-@code{shortInstrumentName}. 
+Nous allons voir, au fil des lignes qui suivent, comment insérer des
+indications de tempo ou des noms d'instrument dans une partition.  Nous
+aborderons aussi la citation d'autres voix, et comment la mettre en
+forme.

 
 

-@lilypond[quote,verbatim,ragged-right,relative=1,fragment]
-\set Staff.instrumentName = #"Ploink "
-\set Staff.shortInstrumentName = #"Plk "
-c1
-\break
-c''
-@end lilypond
+@menu
+* Noms d'instrument::
+* Citation d'autres voix::
+* Mise en forme d'une citation::
+@end menu

 
 

-Le recours à la commande @code{\markup} permet de construire des noms
-d'instruments particuliers, tels que

 
 

-@lilypond[quote,fragment,verbatim,ragged-right]
-\set Staff.instrumentName = \markup {
-  \column { "Clarinetti"
-            \line { "in B" \smaller \flat } } }
-c''1
-@end lilypond
+@node Noms d'instrument
+@unnumberedsubsubsec Noms d'instrument
+@translationof Instrument names

 
 

-Si vous centrez le nom d'un instrument, il faudra le faire pour tous
+@cindex instrument, noms
+@cindex nom d'instrument
+@cindex instrument, noms abrégés

 
 

-@lilypond[quote,verbatim,ragged-right]
-{ <<
-\new Staff {
-  \set Staff.instrumentName = \markup {
-    \center-column { "Clarinetti"
-      \line { "in B" \smaller \flat } } }
-  c''1
-}
-\new Staff {
-  \set Staff.instrumentName = \markup{ \center-align { Vibraphone }}
-  c''1
+Dans un conducteur, les noms d'instrument sont portés en regard de
+chacune des portées, qu'il s'agisse d'un contexte @code{Staff},
+@code{PianoStaff}, @code{StaffGroup}, @code{GrandStaff} ou
+@code{ChoirStaff} .  La première ligne affichera la valeur de
+@code{instrumentName}, et les suivantes celle de
+@code{shortInstrumentName}.
+
+@lilypond[verbatim,quote,ragged-right,relative=1]
+\new Staff \with {
+  instrumentName = #"Violin "
+  shortInstrumentName = #"Vln. "

 }
 }

->>
+{ c4.. g'16 c4.. g'16 \break | c1 }
+@end lilypond
+
+Le recours à la commande @code{\markup} permet de construire des noms
+d'instrument particuliers, tels que
+
+@lilypond[verbatim,quote,relative=2]
+\new Staff \with {
+  instrumentName = \markup {
+    \column { "Clarinetti"
+      \line { "in B" \smaller \flat }
+    }
+  }

 }
 }

+{ c4 c,16 d e f g2 }

 @end lilypond
 
 @end lilypond
 

-Losque le nom d'un instrument est relativement long, il est judicieux
-d'augmenter le retrait --- @code{indent} --- au sein du bloc
-@code{\layout}. 
+@cindex noms d'instrument, centrés

 
 

-Procédez comme suit pour centrer des noms d'instruments tout en
-préservant un décalage par rapport à la portée :
+Lorsque plusieurs contextes de portée sont regroupés, les noms
+d'instrument, que ce soit sous leur forme développée ou abrégée, sont
+par défaut centrés.  Si l'un d'entre eux est libellé sur plusieurs
+lignes, il faudra recourir à l'instruction @code{\center-column} :

 
 

-@lilypond[quote,verbatim,ragged-right]
-\new StaffGroup \relative
+@lilypond[verbatim,quote,indent=1.5\cm,relative=2]

 <<
 <<

-  \new Staff {
-    \set Staff.instrumentName = \markup { \hcenter-in #10 "blabla" }
-    c1 c1
+  \new Staff \with {
+    instrumentName = #"Flute"

   }
   }

-  \new Staff {
-    \set Staff.instrumentName = \markup { \hcenter-in #10 "blo" }
-    c1 c1
+  { f2 g4 f }
+  \new Staff \with {
+    instrumentName = \markup {
+      \center-column { "Clarinet"
+      \line { "in B" \smaller \flat }
+      }
+    }

   }
   }

+  { c4 b c2 }

 >>
 @end lilypond
 
 >>
 @end lilypond
 

-Des noms d'instruments peuvent s'utiliser dans d'autres contextes, tels
-que @code{GrandStaff}, @code{ChoirStaff}, ou @code{StaffGroup}, à
-condition de leur affecter le graveur approprié :
+@funindex indent
+@funindex short-indent
+
+Lorsque le nom d'un instrument est relativement long, il est judicieux
+d'augmenter les retraits -- @emph{indent} -- au sein du bloc
+@code{\layout} à l'aide des commandes @code{indent} et
+@code{short-indent}.  Pour plus de plus amples détails sur ces réglages,
+reportez-vous au chapitre @ref{Variables d'indentation et de décalage}.
+
+@lilypond[verbatim,quote,ragged-right]
+\relative c'' {
+  <<
+    \new Staff \with {
+      instrumentName = #"Alto Flute in G"
+      shortInstrumentName = #"Flt."
+    }
+    {
+      f2 g4 f \break
+      g4 f g2
+    }
+    \new Staff \with {
+      instrumentName = #"Clarinet"
+      shortInstrumentName = #"Clar."
+    }
+    {
+      c,4 b c2 \break
+      c2 b4 c
+    }
+  >>
+}

 
 

-@example
-\layout@{
-  \context @{\GrandStaff \consists "Instrument_name_engraver"@}
-@}
-@end example
+\layout {
+  indent = 3.0\cm
+  short-indent = 1.5\cm
+}
+@end lilypond

 
 

-@noindent
-Pour de plus amples informations sur la manière d'activer ou
-désactiver un graveur, voir @ref{Modifying context plug-ins}.
+@cindex noms d'instrument, autres contextes
+
+Des noms d'instrument peuvent s'utiliser dans d'autres contextes, tels
+que @code{ChordNames} ou @code{FiguredBass}, dès lors qu'on leur adjoint
+le graveur @code{Instrument_name_engraver}.  Pour de plus amples
+informations sur la manière d'activer ou désactiver un graveur, voir
+@ref{Modification des greffons de contexte}.

 
 

-Vous pouvez changer d'instrument en cours de morceau :
+@cindex instrument, changement de nom
+@cindex changement de nom d'instrument

 
 

-@lilypond[quote,fragment,verbatim,ragged-right]
-\set Staff.instrumentName = #"First"
-\set Staff.shortInstrumentName = #"one"
-c1 c c c \break
-c1 c c c \break
-\set Staff.instrumentName = #"Second"
-\set Staff.shortInstrumentName = #"two"
-c1 c c c \break
-c1 c c c \break
+Vous pouvez changer le nom d'un instrument en cours de morceau.  Notez
+cependant que la valeur de @code{instrumentName} ne s'affichera que sur
+la première portée :
+
+@lilypond[verbatim,quote,ragged-right,relative=1]
+\new Staff \with {
+  instrumentName = #"Flute"
+  shortInstrumentName = #"Flt."
+}
+{
+  c1 c c c \break
+  c1 c c c \break
+  \set Staff.instrumentName = #"Clarinet"
+  \set Staff.shortInstrumentName = #"Clt."
+  c1 c c c \break
+  c1 c c c \break
+}

 @end lilypond
 
 @end lilypond
 

+@cindex instrument, changement
+@cindex changement d'instrument
+
+@funindex \addInstrumentDefinition
+@funindex addInstrumentDefinition
+@funindex \instrumentSwitch
+@funindex instrumentSwitch
+
+Lorsqu'un musicien doit changer d'instrument -- piccolo et flûte, basson
+et contrebasson --, la commande @code{\addInstrumentDefinition},
+couplée à l'instruction @code{\instrumentSwitch} permet de spécifier en
+détail les modifications intervenant lors du changement.  La commande
+@code{\addInstrumentDefinition} prend deux arguments : une chaîne
+de caractères qui servira d'identifiant, et une liste d'association
+de valeurs aux propriétés de ce nouvel instrument.  Ces définitions
+devront être déclarées avant tout autre élément musical.  L'instruction
+@code{\instrumentSwitch} se placera dans la musique au moment de la
+substitution :
+
+@lilypond[verbatim,quote,ragged-right]
+\addInstrumentDefinition #"contrabassoon"
+  #`((instrumentTransposition . ,(ly:make-pitch -1 0 0))
+     (shortInstrumentName . "Cbsn.")
+     (clefGlyph . "clefs.F")
+     (middleCPosition . 6)
+     (clefPosition . 2)
+     (instrumentCueName . ,(make-bold-markup "cbsn."))
+     (midiInstrument . "bassoon"))
+
+\new Staff \with {
+  instrumentName = #"Bassoon"
+}
+\relative c' {
+  \clef tenor
+  \compressFullBarRests
+  c2 g'
+  R1*16
+  \instrumentSwitch "contrabassoon"
+  c,,2 g \break
+  c,1 ~ | 1
+}
+@end lilypond

 
 @seealso
 
 @seealso

-Référence du programme : @rinternals{InstrumentName}.
+Manuel de notation :
+@ref{Variables d'indentation et de décalage},
+@ref{Modification des greffons de contexte}.

 
 

+Morceaux choisis :
+@rlsrnamed{Staff notation,Notation sur la portée}.

 
 

-@node Quoting other voices
-@unnumberedsubsubsec Quoting other voices
+Référence des propriétés internes :
+@rinternals{InstrumentName},
+@rinternals{PianoStaff},
+@rinternals{Staff}.

 
 

-@cindex cues
+
+@node Citation d'autres voix
+@unnumberedsubsubsec Citation d'autres voix
+@translationof Quoting other voices
+
+@cindex répliques

 @cindex citation
 @cindex citation

+@cindex petites notes

 
 

-Grâce aux citations de répliques, vous pouvez insérer directement dans une partie
-des fragments d'une autre partie.  Avant qu'une partie ne puisse être
-mentionnée ailleurs, elle doit être considérée comme reproductible.
-C'est le but de la commande @code{\addQuote}.
+@funindex \addQuote
+@funindex addQuote
+@funindex \quoteDuring
+@funindex quoteDuring
+@funindex \transposition
+@funindex transposition

 
 

-@example
-\addQuote @var{nom} @var{musique}
-@end example
+Il est assez courant qu'une voix soit doublée par une autre.  Par
+exemple, les premiers et seconds violons peuvent jouer les mêmes notes
+durant un moment.  LilyPond gère parfaitement ces situations où une
+voix est la @emph{réplique} d'une autre, sans devoir ressaisir la
+musique en question.

 
 

+L'instruction @code{\addQuote}, placée au niveau le plus haut -- c'est à
+dire en dehors de tout bloc de musique -- définit la musique dont il
+sera possible de répliquer des fragments.

 
 

-@noindent
-Ici, @var{nom} représente une chaîne d'identification, et
-@var{musique} n'importe quelle musique.  Voici un exemple de
-@code{\addQuote} :
+Au cours d'une partie, des extraits de répliques peuvent être cités en
+utilisant la commande @code{\quoteDuring}.  Cette commande prend deux
+arguments : le nom de la voix reproduite, tel que défini par
+@code{\addQuote}, et une expression musicale qui indique la durée de
+cette citation.
+
+@lilypond[verbatim,quote]
+fluteNotes = \relative c'' {
+  a4 gis g gis | b4^"quoted" r8 ais\p a4( f)
+}

 
 

-@example
-\addQuote clarinet \relative c' @{
-  f4 fis g gis
-@}
-@end example
+oboeNotes = \relative c'' {
+  c4 cis c b \quoteDuring #"flute" { s1 }
+}

 
 

-Vous devez placer cette commande au niveau le plus haut, c'est à dire
-en dehors de tout bloc de musique.
+\addQuote "flute" { \fluteNotes }

 
 

-Après avoir fait appel à @code{\addquote}, la citation interviendra
-en utilisant @code{\quoteDuring} ou @code{\cueDuring} :
+\score {
+  <<
+    \new Staff \with { instrumentName = "Flute" } \fluteNotes
+    \new Staff \with { instrumentName = "Oboe" } \oboeNotes
+  >>
+}
+@end lilypond

 
 

-@example
-\quoteDuring #@var{nom} @var{musique}
-@end example
+Si l'expression musicale utilisée pour @code{\quoteDuring} contenait
+autre chose que du silence, il en résulterait une situation
+polyphonique, ce qui n'est pas le but recherché :

 
 

-Au cours d'une partie, des extraits de répliques peuvent être cités en
-utilisant la commande @code{\quoteDuring}.
+@lilypond[verbatim,quote]
+fluteNotes = \relative c'' {
+  a4 gis g gis | b4^"quoted" r8 ais\p a4( f)
+ }

 
 

-@example
-\quoteDuring #"clarinet" @{ s2. @}
-@end example
+oboeNotes = \relative c'' {
+  c4 cis c b \quoteDuring #"flute" { e4 r8 ais b4 a }
+}

 
 

-Cela citera trois noires (la durée de @code{s2.}) appartenant à la
-voix @code{clarinette} précédemment générée.
+\addQuote "flute" { \fluteNotes }

 
 

-Plus précisément, on s'arrête à cet instant de la partie en cours
-d'impression, et l'on extrait les notes à ce même instant dans la voix
-citée --- celle qui contient @code{\addQuote}.  C'est la raison pour
-laquelle l'argument de @code{\addQuote} doit englober toute la voix en
-question, y compris les éventuels silences à son début.
+\score {
+  <<
+    \new Staff \with { instrumentName = "Flute" } \fluteNotes
+    \new Staff \with { instrumentName = "Oboe" } \oboeNotes
+  >>
+}
+@end lilypond

 
 

-Les citations tiennent compte des transpositions, aussi bien celle de
-l'instrument d'origine que celle de la partie où elle intervient, dans
-la mesure où elles sont spécifiées par la commande @code{\transposition}.
+L'instruction @code{\quoteDuring} prendra en compte les réglages d'une
+commande @code{\transposition}, qu'elle apparaisse au niveau de la voix
+répliquée ou dans celle qui réplique.

 
 

-@lilypond[quote,ragged-right,verbatim]
-\addQuote clarinet \relative c' {
+@lilypond[verbatim,quote]
+clarinetNotes = \relative c'' {

   \transposition bes
   \transposition bes

-  f4 fis g gis
+  \key d \major
+  b4 ais a ais | cis4^"quoted" r8 bis\p b4( f)

 }
 
 }
 

-{
-  e'8 f'8 \quoteDuring #"clarinet" { s2 }
+oboeNotes = \relative c'' {
+  c4 cis c b \quoteDuring #"clarinet" { s1 }
+ }
+\addQuote "clarinet" { \clarinetNotes }
+ 
+\score {
+  <<
+    \new Staff \with { instrumentName = "Clarinet" } \clarinetNotes
+    \new Staff \with { instrumentName = "Oboe" } \oboeNotes
+  >>

 }
 @end lilypond
 
 }
 @end lilypond
 

-Le type d'événements pris en charge pour la citation peut se régler
-avec la propriété @code{quotedEventTypes}.  Par défaut, sa valeur est
-fixée à @code{(note-event rest-event)}, ce qui signifie que seuls les
-notes et silences seront mentionnés par @code{\quoteDuring}.
-Définir
+@cindex note-event
+@cindex articulation-event
+@cindex dynamic-event
+@cindex rest-event
+@cindex slur-event
+@cindex crescendo-event
+
+@funindex quotedEventTypes
+@funindex quotedCueEventTypes
+
+LilyPond répliquera, par défaut, tous les éléments -- articulations,
+nuances, @emph{markups}, etc. La propriété @code{quotedEventTypes}
+permet de définir plus précisément quels éléments de la voix originelle
+seront reproduits.
+
+@lilypond[verbatim,quote]
+fluteNotes = \relative c'' {
+  a2 g2 |
+  b4\<^"quoted" r8 ais a4\f( c->)
+ }
+
+oboeNotes = \relative c'' {
+  c2. b4 |
+  \quoteDuring #"flute" { s1 }
+}

 
 

-@example
-\set Staff.quotedEventTypes =
-       #'(note-event articulation-event dynamic-event)
-@end example
+\addQuote "flute" { \fluteNotes }

 
 

-@noindent
-reproduira les notes (mais pas les silences), ainsi que les scripts
-et nuances.
+\score {
+  <<
+    \set Score.quotedEventTypes = #'(note-event articulation-event
+                                     crescendo-event rest-event
+                                     slur-event dynamic-event)
+    \new Staff \with { instrumentName = "Flute" } \fluteNotes
+    \new Staff \with { instrumentName = "Oboe" } \oboeNotes
+  >>
+ }
+@end lilypond

 
 

-@knownissues
+Les citations peuvent être « balisées » par un nom particulier afin de
+les utiliser de différentes manières.  Pour de plus amples détails à ce
+propos, consultez le chapitre @ref{Utilisation de balises}.
+
+@seealso
+Manuel de notation :
+@ref{Instruments transpositeurs},
+@ref{Utilisation de balises}.
+
+Fichiers d'initialisation :
+@file{scm/define-event-classes.scm}.

 
 

-Seul le contenu de la première @rinternals{Voice} rencontrée dans la
-partie marquée d'une commande @code{\addQuote} pourra être retenu. Par
-voie de conséquence, @code{music} ne saurait comprendre de @code{\new}
-ou une instance @code{context Voice} qui la ferait passer à une autre voix.
+Morceaux choisis :
+@rlsrnamed{Staff notation, Notation sur la portée}.
+
+Référence des propriétés internes :
+@rinternals{Music classes},
+@rinternals{QuoteMusic},
+@rinternals{Voice}.
+
+@knownissues
+Seul le contenu de la première @code{Voice} rencontrée dans la
+partie marquée d'une commande @code{\addQuote} pourra être retenu.  Par
+voie de conséquence, @code{@var{musique}} ne saurait comprendre de
+@code{\new} ou une instance @code{\context Voice} qui la ferait
+passer à une autre voix.

 
 Citer des notes d'ornement ne fonctionne pas, et peut même entraîner
 un blocage de LilyPond.
 
 
 Citer des notes d'ornement ne fonctionne pas, et peut même entraîner
 un blocage de LilyPond.
 

-Citer des triolets imbriqués peut entraîner un résultat de médiocre qualité.
+Citer des triolets imbriqués peut entraîner un résultat de piètre
+qualité.

 
 
 
 

-@seealso
-Dans ce manuel : @ref{Instrument transpositions}.
+@node Mise en forme d'une citation
+@unnumberedsubsubsec Mise en forme d'une citation
+@translationof Formatting cue notes

 
 

-Exemples : @rlsr{Staff notation}.
+@cindex petites notes, formater des
+@cindex répliques, formatage
+@cindex voix, citation
+@cindex voix, réplication
+@cindex CueVoice
+
+@funindex \cueDuring
+@funindex cueDuring
+@funindex \cueClef
+@funindex cueClef
+@funindex \cueDuringWithClef
+@funindex cueDuringWithClef
+@funindex \quoteDuring
+@funindex quoteDuring
+
+Le moyen le plus simple pour mettre en forme des notes provenant d'une
+autre voix consiste à déclarer explicitement un contexte @code{CueVoice}
+au sein de la voix où elle apparaît.
+
+@lilypond[verbatim,relative=1]
+R1
+<<
+  { e2\rest r4. e8 }
+  \new CueVoice {
+    \stemUp d'8^"flute" c d e fis2
+  }
+>>
+d,4 r a r
+@end lilypond

 
 

-Référence du programme : @rinternals{QuoteMusic}.
+L'instruction @code{\cueClef}, utilisée conjointement à un contexte
+@code{CueVoice} explicite permet d'indiquer la clef, dans une taille
+réduite, propre à la voix citée.  Le retour à la clef d'origine
+s'effectue à l'aide de l'instruction @code{\cueClefUnset}.

 
 

+@lilypond[verbatim,noragged-right,relative=1]
+\clef "bass"
+R1
+<<
+  { e2\rest r4. \cueClefUnset e,8 }
+  \new CueVoice {
+    \cueClef "treble" \stemUp d''8^"flute" c d e fis2
+  }
+>>
+d,,4 r a r
+@end lilypond

 
 

-@node Formatting cue notes
-@unnumberedsubsubsec Formatting cue notes
+Notez que les deux instructions @code{\cueClef} et @code{\cueClefUnset}
+sont disponibles si nécessaire en dehors d'un @code{CueVoice}.

 
 

-@cindex petites notes, formater des
+@lilypond[verbatim,noragged-right,relative=1]
+\clef "bass"
+R1
+\cueClef "treble"
+d'8^"flute" c d e fis2
+\cueClefUnset
+d,,4 r a r
+@end lilypond

 
 

-La section précédente indiquait comment insérer des notes d'une autre
-voix.  Nous allons maintenant voir une fonction musicale avancée,
-@code{\cueDuring}, qui facilite le formatage des petites notes.
+Lorsque la situation est plus complexe, instrument transpositeur ou
+citations de plusieurs sources, vous disposez des instructions 
+@code{\cueDuring} et @code{\cueDuringWithClef}, versions spécifiques de
+la commande @code{\quoteDuring} -- voir la rubrique précédente
+(@ref{Citation d'autres voix}).

 
 

-Sa syntaxe est :
+Leur syntaxe est :

 
 @example
 
 @example

-  \cueDuring #@var{nom} #@var{updown} @var{musique}
+\cueDuring #@var{origine} #@var{position} #@var{musique}

 @end example
 
 @end example
 

-Des notes issues de la partie @var{nom} s'insèreront dans une
-@rinternals{Voice} nommée @code{cue}, simultanément avec
-@var{musique} --- habituellement un silence.  L'apparition des petites
-notes initialise une polyphonie temporaire pour la portée concernée.  
-L'argument @var{updown} détermine si ces petites notes seront
-attachées à la première ou à la seconde voix.
+et

 
 

+@example
+\cueDuringWithClef #@var{origine} #@var{position} #@var{clef} #@var{musique}
+@end example

 
 

-@lilypond[verbatim,ragged-right]
-smaller = {
-  \set fontSize = #-2
-  \override Stem #'length-fraction = #0.8
-  \override Beam #'thickness = #0.384
-  \override Beam #'length-fraction = #0.8
+Des mesures issues de la partie d'@code{@var{origine}} seront recopiées
+dans un contexte de @code{CueVoice} et synchronisées avec
+@code{@var{musique}} -- habituellement un silence.  L'apparition des
+petites notes initialise une polyphonie temporaire pour la portée
+concernée.  L'argument @code{@var{position}} détermine si ces petites
+notes seront attachées à la première ou à la seconde voix -- @code{UP}
+pour la première, @code{DOWN} pour la seconde.
+
+@lilypond[verbatim,quote]
+fluteNotes = \relative c'' {
+  r2. c4 | d8 c d e fis2 | g2 d |

 }
 
 }
 

-\addQuote clarinet \relative {
-  R1*20
-  r2 r8 c' f f
+oboeNotes = \relative c'' {
+  R1
+  \new CueVoice { \set instrumentCueName = "flute" }
+  \cueDuring #"flute" #UP { R1 }
+  g2 c,

 }
 
 }
 

-\new Staff \relative  <<
+\addQuote "flute" { \fluteNotes }

 
 

-  % setup a context for cue notes.
-  \new Voice = "cue" { \smaller \skip 1*21 }
-
-  \set Score.skipBars = ##t
+\new Staff {
+  \oboeNotes
+}
+@end lilypond

 
 

-  \new Voice {
-    R1*20
-    \cueDuring #"clarinet" #UP {
-      R1
-    }
-    g4 g2.
-  }
->>
+@noindent
+La propriété @code{quotedCueEventTypes} permet de définir précisément
+quels éléments de la voix originelle seront reproduits.  Sa valeur par
+défaut est @code{'(note-event rest-event tie-event beam-event
+tuplet-span-event)}.  LilyPond reproduira donc les notes, silences,
+liaisons de prolongation, ligatures et nolets, mais pas les
+articulations, annotations ni nuances.
+
+@warning{Dans l'exemple précédent, il était nécessaire de déclarer
+explicitement le contexte @code{Voice}, sinon l'intégralité de
+l'expression musicale se serait retrouvée dans le contexte
+@code{CueVoice}.}
+
+@lilypond[verbatim,quote]
+oboeNotes = \relative c'' {
+  r2 r8 d16(\f f e g f a)
+  g8 g16 g g2.
+}
+\addQuote "oboe" { \oboeNotes }
+
+\new Voice \relative c'' {
+  \set Score.quotedCueEventTypes = #'(note-event rest-event tie-event
+                                      beam-event tuplet-span-event
+                                      dynamic-event slur-event)
+  \cueDuring #"oboe" #UP { R1 }
+  g2 c,
+}

 @end lilypond
 
 @end lilypond
 

+Le nom de l'instrument qui est répliqué sera imprimé dès lors qu'aura
+été définie la propriété @code{instrumentCueName} d'un contexte
+@code{CueVoice} temporaire.  Le positionnement et le style adopté par
+@code{instrumentCueName} dépendent de l'objet @code{InstrumentSwitch}
+-- voir @ref{Noms d'instrument}.  Par ailleurs, si la citation nécessite
+l'apparition d'une clef différente, celle-ci devra être introduite
+manuellement, tout comme l'originale qui devra être rappelée en fin de
+citation.
+
+@lilypond[verbatim,quote]
+fluteNotes = \relative c'' {
+  r2. c4 d8 c d e fis2 g2 d2
+}
+
+bassoonNotes = \relative c {
+  \clef bass
+  R1
+  \clef treble
+  \new CueVoice { \set instrumentCueName = "flute" }
+  \cueDuring #"flute" #UP { R1 }
+  \clef bass
+  g4. b8 d2
+}

 
 

-Quelques indications pour une citation efficace :
+\addQuote "flute" { \fluteNotes }

 
 

-@itemize @bullet
-@item
- Les notes de la citation sont dans une police plus petite.
-@item
- La citation comporte une étiquette indiquant l'instrument qui joue.
-@item
- Lorsque la partie originale reprend sa place, rappeler l'instrument.
+\new Staff {
+  \bassoonNotes
+}
+@end lilypond

 
 

-@c really?  Are you sure about that last point?  I'll check after 3.0 -gp
+L'instruction @code{\cueDuringWithClef} se chargera quant à elle, et
+grâce à un argument supplémentaire, de gérer le changement de clef
+nécessaire à la citation et le retour à la clef originelle.

 
 

-@c Yes, this is good practice.  Otherwise, the start of the original
-@c part can only be seen from the font size.  This is not good enough
-@c for sight-reading.  It is possilbe to use other
-@c markers (e.g. a big close-bracket over the staff) to indicate the cue
-@c   notes are
-@c finished.
-@c -hwn
+@lilypond[verbatim,quote]
+fluteNotes = \relative c'' {
+  r2. c4 d8 c d e fis2 g2 d2
+}

 
 

+bassoonNotes = \relative c {
+  \clef bass
+  R1
+  \new CueVoice { \set instrumentCueName = "flute" }
+  \cueDuringWithClef #"flute" #UP #"treble" { R1 }
+  g4. b8 d2
+}

 
 

-Tout autre modification introduite par la citation devrait être
-annulée.  Par exemple, si l'instrument cité utilise une autre clé, il
-faudra revenir à la clé habituelle.
+\addQuote "flute" { \fluteNotes }

 
 

-@end itemize
+\new Staff {
+  \bassoonNotes
+}
+@end lilypond

 
 

-La macro @code{\transposedCueDuring} est particulièrement adaptée pour
-des instrument ayant une tessiture éloignée, comme dans le cas d'un
-piccolo cité dans une partie de contrebasson.
+@funindex \transposedCueDuring
+@funindex transposedCueDuring

 
 

-@lilypond[verbatim,ragged-right,quote]
-picc = \relative c''' {
+L'instruction @code{\cueDuring}, à l'instar de la commande
+@code{\quoteDuring}, tient compte des instruments transpositeurs.  La
+citation s'effectue aux hauteurs correspondant à l'instrument où elles
+apparaissent.  
+
+L'instruction @code{\transposedCueDuring} est particulièrement adaptée
+pour des instrument ayant une tessiture éloignée, comme dans le cas d'un
+piccolo cité dans une partie de clarinette basse.  Sa syntaxe  est
+identique à celle de @code{\cueDuring}, à ceci près qu'elle nécessite un
+argument supplémentaire afin de spécifier la transposition à effectuer
+en hauteur absolue.
+
+@lilypond[verbatim,quote]
+piccoloNotes = \relative c''' {

   \clef "treble^8"
   \clef "treble^8"

-  R1 |
-  c8 c c e g2 |
-  a4 g g2 |
+  R1
+  c8 c c e g2
+  c4 g g2

 }
 }

-\addQuote "picc" { \picc }

 
 

-cbsn = \relative c, {
-  \clef "bass_8"
-  c4 r g r
-  \transposedCueDuring #"picc" #UP c,, { R1 } |
-  c4 r g r |
+bassClarinetNotes = \relative c' {
+  \key d \major
+  \transposition bes,
+  d4 r a r
+  \transposedCueDuring #"piccolo" #UP d { R1 }
+  d4 r a r

 }
 
 }
 

+\addQuote "piccolo" { \piccoloNotes }
+

 <<
 <<

-  \context Staff = "picc" \picc
-  \context Staff = "cbsn" \cbsn
+  \new Staff \piccoloNotes
+  \new Staff \bassClarinetNotes
+>>
+@end lilypond
+
+@cindex citation, fin
+@cindex fin de citation
+@cindex réplique, fin
+@cindex fin de réplique
+
+@funindex \killCues
+@funindex killCues
+@funindex \addInstrumentDefinition
+@funindex addInstrumentDefinition
+
+La commande @code{killCues} permet de supprimer les notes d'une
+citation.  Ceci est utile lorsque cette citation n'est pas imprimée dans
+le conducteur entre autres.  @code{killCues} supprimera les notes et
+autres événements pris en charge par @code{\cueDuring}.  Pour les
+autres annotations telles que changement de clef ou instrument concerné,
+faites appel à des balises -- voir @ref{Utilisation de balises} à ce
+sujet.
+
+@lilypond[verbatim,quote]
+fluteNotes = \relative c'' {
+  r2. c4 d8 c d e fis2 g2 d2
+}
+
+bassoonNotes = \relative c {
+  \clef bass
+  R1
+  \tag #'part {
+    \clef treble
+    \new CueVoice { \set instrumentCueName = "flute" }
+  }
+  \cueDuring #"flute" #UP { R1 }
+  \tag #'part \clef bass
+  g4. b8 d2
+}
+
+\addQuote "flute" { \fluteNotes }
+
+\new Staff {
+  \bassoonNotes
+}
+
+\new StaffGroup <<
+  \new Staff {
+    \fluteNotes
+  }
+  \new Staff {
+    \removeWithTag #'part { \killCues { \bassoonNotes } }
+  }

 >>
 @end lilypond
 
 >>
 @end lilypond
 

+Lorsque la citation comporte une étiquette indiquant l'instrument qui
+joue et un changement de clef, ces éléments peuvent se regrouper à
+l'aide de la commande @code{\addInstrumentDefinition}.  Pour plus
+d'information, reportez-vous au chapitre @ref{Noms d'instrument}.
+
+@seealso
+Manuel de notation :
+@ref{Citation d'autres voix},
+@ref{Instruments transpositeurs},
+@ref{Noms d'instrument},
+@ref{Clefs},
+@ref{Citation-repère},
+@ref{Utilisation de balises}.
+
+Morceaux choisis :
+@rlsrnamed{Staff notation, Notation sur la portée}.
+
+Référence des propriétés internes :
+@rinternals{CueVoice},
+@rinternals{Voice}.
+
+@knownissues
+La commande @code{\cueDuring} ne sait pas gérer les collisions de
+silence entre les contextes @code{Voice} et @code{CueVoice}.

 
 

+Dans le cadre d'un @code{\cueDuringWithClef} ou d'un
+@code{\transposedCueDuring}, l'argument supplémentaire doit intervenir
+après l'origine et la position.