Merge master into nested-bookparts

[lilypond.git] / Documentation / fr / user / editorial.itely

diff --git a/Documentation/fr/user/editorial.itely b/Documentation/fr/user/editorial.itely
index e8d5093f7f862622ccb57d4c3c4598f2a1f6b4c5..94900a226e510bfcbadb20953e65e790997f7500 100644 (file)
--- a/Documentation/fr/user/editorial.itely
+++ b/Documentation/fr/user/editorial.itely
@@ -1,160 +1,26 @@
 @c -*- coding: utf-8; mode: texinfo; -*-
 @ignore
 @c -*- coding: utf-8; mode: texinfo; -*-
 @ignore

-    Translation of GIT committish: f7420240e4ce1fe2217646482a47d00f566af52c
+    Translation of GIT committish: 33ba8d40c3493011a4b39ab8b1369701f8013bd6

 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  See TRANSLATION for details.
 @end ignore
 
 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  See TRANSLATION for details.
 @end ignore
 

+@c \version "2.11.61"
+

 @c Translators: Jean-Charles Malahieude
 
 @c Translators: Jean-Charles Malahieude
 

-@node Educational use
-@section Educational use
+@node Editorial annotations
+@section Editorial annotations
+
+@lilypondfile[quote]{editorial-headword.ly}

 
 @menu
 
 @menu

-* Note heads::                  

 * Inside the staff::            
 * Outside the staff::           
 @end menu
 
 
 * Inside the staff::            
 * Outside the staff::           
 @end menu
 
 

-@node Note heads
-@subsection Note heads
-
-@menu
-* Easy notation note heads::    
-* Shape note heads::            
-* Improvisation::               
-* Special noteheads::           
-@end menu
-
-@node Easy Notation note heads
-@unnumberedsubsubsec Easy Notation note heads
-
-@cindex tête de note, apprentissage
-@cindex notation facile
-@cindex Hal Leonard
-
-Les notes @q{easy play} comportent le nom de la note à l'intérieur de
-la tête.  On l'utilise dans des partitions pour débutants.
-
-@lilypond[quote,ragged-right,verbatim,fragment,staffsize=26]
-  \easyHeadsOn
-  c'2 e'4 f' | g'1
-@end lilypond
-
-La commande @code{\easyHeadsOn} remplace tous les réglages de l'objet
-@internalsref{NoteHead}.  L'impression doit être de plus grande
-taille, afin que les lettres soient lisibles.  Voir à ce propos
-@ref{Setting the staff size}.
-
-@refcommands
-
-@funindex \easyHeadsOn
-@code{\easyHeadsOn}
-
-
-@node Shape note heads
-@unnumberedsubsubsec Shape note heads
-
-@cindex tête de note, allure
-
-En notation profilée, le profil d'une tête de note correspond à la
-fonction harmonique de cette note dans la gamme.  Ce style de notation
-était très en vogue dans les recueils de chansons américains du XIXe
-siècle. 
-
-Des notes profilées sont produites après activation de
-@code{\aikenHeads} ou @code{\sacredHarpHeads}, selon le style.
-
-@lilypond[verbatim,relative=1,fragment]
-  \aikenHeads
-  c8 d4 e8 a2 g1
-  \sacredHarpHeads
-  c8 d4. e8 a2 g1
-@end lilypond
-
-Les profils sont déterminés par la hauteur dans la gamme, le premier
-degré étant défini par la commande @code{\key}. 
-
-@funindex \key
-@funindex shapeNoteStyles
-@funindex \aikenHeads
-@funindex \sacredHarpHeads
-
-Les notes profilées sont mises en œuvre par la propriété
-@code{shapeNoteStyles}, dont les valeurs sont constituées d'une liste
-de symboles.  Le n-ième élément indique le style à utiliser pour le
-n-ième degré de la gamme.  Toutes les combinaisons sont possibles :
-
-@lilypond[verbatim,relative=1,fragment]
-  \set shapeNoteStyles  = ##(cross triangle fa #f mensural xcircle diamond)
-  c8 d4. e8 a2 g1
-@end lilypond
-
-
-@node Improvisation
-@unnumberedsubsubsec Improvisation
-
-L'improvisation peut quelquefois s'indiquer à l'aide de notes de forme
-allongée (@emph{slash}).  Ces têtes de notes sont créées  par
-l'adjonction du graveur @internalsref{Pitch_squash_engraver} au
-contexte @internalsref{Voice}, de telle sorte que la commande
-
-@example
-\set squashedPosition = #0
-\override NoteHead #'style = #'slash
-@end example
-
-@noindent
-active les notes penchées.
-
-Vous disposez des raccourcis @code{\improvisationOn} et son corollaire
-@code{\improvisationOff} pour cette séquence, comme l'illustre
-l'exemple ci dessous.
-
-@lilypond[verbatim,ragged-right,quote]
-\new Voice \with {
-  \consists Pitch_squash_engraver
-} \transpose c c' {
-  e8 e g a a16(bes)(a8) g \improvisationOn
-  e8
-  ~e2~e8 f4 fis8
-  ~fis2 \improvisationOff a16(bes) a8 g e
-}
-@end lilypond
-
-
-@node Special noteheads
-@unnumberedsubsubsec Special noteheads
-
-@cindex têtes de note, spéciales
-
-Certains instruments utilisent des têtes de note différentes à des
-fins spécifiques --- des croix pour le @q{parlato} des chanteurs ou les
-notes étouffées des guitares ; des losanges pour les harmoniques des
-cordes.  Il existe un raccourci (@code{\harmonic}) pour les notes en
-losange ; pour les autres styles de tête, il vous faudra jouer avec la
-propriété @code{NoteHead}.
-
-@lilypond[ragged-right,relative=1,fragment,verbatim,quote]
-c4 d
-\override NoteHead #'style = #'cross
-e f
-\revert NoteHead #'style
-e d <c f\harmonic> <d a'\harmonic>
-@end lilypond
-
-@noindent
-Pour une liste exhaustive des styles de tête de note, consultez 
-@ref{Note head styles}.
-
-
-@seealso
-
-Référence du programme : @internalsref{NoteHead}.
-
-

 @node Inside the staff
 @subsection Inside the staff
 
 @node Inside the staff
 @subsection Inside the staff
 


@@ -165,7 +31,6 @@ Référence du programme : @internalsref{NoteHead}.
 * Hidden notes::                
 * Coloring objects::            
 * Parentheses::                 
 * Hidden notes::                
 * Coloring objects::            
 * Parentheses::                 

-* Ambitus::                     

 * Stems::                       
 @end menu
 
 * Stems::                       
 @end menu
 


@@ -214,9 +79,9 @@ portée de 20 points correspond une police de 10 points.
 
 La propriété @code{font-size} ne peut intervenir que pour les objets
 qui utilisent des polices, autrement dit ceux qui disposent de
 
 La propriété @code{font-size} ne peut intervenir que pour les objets
 qui utilisent des polices, autrement dit ceux qui disposent de

-l'interface de rendu @internalsref{font-interface}.
+l'interface de rendu @rinternals{font-interface}.

 
 

-@refcommands
+@predefined

 
 Les commandes suivantes définissent @code{fontSize} pour la voix en
 cours :
 
 Les commandes suivantes définissent @code{fontSize} pour la voix en
 cours :


@@ -292,9 +157,9 @@ d'indiquer des doigtés très proches des têtes de notes.
 
 @seealso
 
 
 @seealso
 

-Référence du programme : @internalsref{Fingering}.
+Référence du programme : @rinternals{Fingering}.

 
 

-D'autres exemples : @lsr{expressive,fingering-chords.ly}.
+Exemples : @rlsr{Editorial annotations}.

 
 
 @node Hidden notes
 
 
 @node Hidden notes


@@ -386,7 +251,7 @@ L'exemple suivant illustre l'utilisation de la fonction
 Annexes : @ref{List of colors}.
 
 
 Annexes : @ref{List of colors}.
 
 

-@refbugs
+@knownissues

 Les couleurs de X11 ne sont pas toutes perceptibles dans un navigateur
 internet.  Aussi nous vous recommandons, dans le cadre d'une
 présentation multimedia, d'utiliser des couleurs de base.
 Les couleurs de X11 ne sont pas toutes perceptibles dans un navigateur
 internet.  Aussi nous vous recommandons, dans le cadre d'une
 présentation multimedia, d'utiliser des couleurs de base.


@@ -396,7 +261,7 @@ normale ayant un nom similaire.
 
 Vous ne pouvez pas coloriser des notes à l'intérieur d'un accord avec
 @code{\override}. si besoin est, utilisez @code{\tweak}.  
 
 Vous ne pouvez pas coloriser des notes à l'intérieur d'un accord avec
 @code{\override}. si besoin est, utilisez @code{\tweak}.  

-Pour plus de détails, consultez @ref{Objects connected to the input}.
+Pour plus de détails, consultez @ref{The tweak command}.

 
 
 @node Parentheses
 
 
 @node Parentheses


@@ -425,109 +290,14 @@ comprendre qu'une seule note.
 @end example
 
 
 @end example
 
 

-@node Ambitus
-@unnumberedsubsubsec Ambitus
-@cindex ambitus
-
-L'@emph{ambitus} est l'amplitude des hauteurs d'une voix donnée dans une
-partition.  Ce terme peut aussi désigner la tessiture qu'un instrument
-est capable d'atteindre.  Souvent, cet ambitus est imprimé au début des
-partitions vocales, afin que les exécutants puissent voir au premier
-coup d'oeil s'ils sont en mesure de tenir la partie en question.
-
-Pour exprimer l'ambitus d'une pièce, on indique avant la clé deux notes
-représentant la hauteur la plus basse et la plus haute.  Pour imprimer
-cet ambitus, il faut ajouter le graveur @internalsref{Ambitus_engraver}
-au contexte @internalsref{Voice}.  Ainsi,
-
-@example
-\layout @{
-  \context @{
-    \Voice
-    \consists Ambitus_engraver
-  @}
-@}
-@end example
-
-@noindent
-donne pour résultat
-
-@lilypond[quote,ragged-right]
-\layout {
-  \context {
-    \Staff
-    \consists Ambitus_engraver
-  }
-}
-
-\relative \new Staff {
-  as'' c e2 cis,2
-}
-@end lilypond
-
-Si plusieurs voix se trouvent sur une même portée, on peut attribuer le
-graveur @internalsref{Ambitus_engraver} au contexte @internalsref{Staff}
-plutôt qu'au contexte @internalsref{Voice} ; l'ambitus affiché sera
-alors celui de toutes les voix cumulées, non d'une seule des voix
-actives.
-
-@lilypond[verbatim,ragged-right,quote]
-\new Staff \with {
-  \consists "Ambitus_engraver"
-}
-<<
-  \new Voice \with {
-    \remove "Ambitus_engraver"
-  } \relative c'' {
-    \override Ambitus #'X-offset = #-1.0
-    \voiceOne
-    c4 a d e f2
-  }
-  \new Voice \with {
-    \remove "Ambitus_engraver"
-  } \relative c' {
-    \voiceTwo
-    es4 f g as b2
-  }
->>
-@end lilypond
-
-@noindent
-Cet exemple met en œuvre une fonctionnalité avancée :
-
-@example
-\override Ambitus #'X-offset = #-1.0
-@end example
-
-@noindent
-Ce réglage déplace l'ambitus vers la gauche.  Le même résultat aurait pu
-être obtenu avec @code{extra-offset}, mais alors le système de mise en
-forme n'aurait pas attribué d'espace supplémentaire pour l'objet
-déplacé.
-
-@seealso
-
-Référence du programme : @internalsref{Ambitus},
-@internalsref{AmbitusLine}, @internalsref{AmbitusNoteHead},
-@internalsref{AmbitusAccidental}.
-
-Exemples :
-@lsr{vocal,ambitus@/.ly}.
-
-@refbugs
-
-LilyPond ne gère pas les collisions entre plusieurs ambitus présents sur
-une même portée.
-
-

 @node Stems
 @unnumberedsubsubsec Stems
 
 @node Stems
 @unnumberedsubsubsec Stems
 

-Dès qu'une note est rencontrée, un objet @internalsref{Stem} se crée
+Dès qu'une note est rencontrée, un objet @rinternals{Stem} se crée

 automatiquement.  Pour les rondes et les silences, ils sont aussi
 créés, mais en mode invisible.
 
 automatiquement.  Pour les rondes et les silences, ils sont aussi
 créés, mais en mode invisible.
 

-@refcommands
+@predefined

 
 @funindex \stemUp
 @code{\stemUp},
 
 @funindex \stemUp
 @code{\stemUp},


@@ -557,11 +327,12 @@ a4 b c b
 @menu
 * Balloon help::                
 * Grid lines::                  
 @menu
 * Balloon help::                
 * Grid lines::                  

+* Analysis brackets::           

 * Blank music sheet::           
 @end menu
 
 @node Balloon help
 * Blank music sheet::           
 @end menu
 
 @node Balloon help

-@subsection Balloon help
+@unnumberedsubsubsec Balloon help

 
 Vous pouvez marquer et nommer des éléments de notation à l'aide de
 bulles.  L'objectif premier de cette fonctionnalité est d'expliquer la
 
 Vous pouvez marquer et nommer des éléments de notation à l'aide de
 bulles.  L'objectif premier de cette fonctionnalité est d'expliquer la


@@ -589,11 +360,11 @@ et le texte de la bulle.
 
 @seealso
 
 
 @seealso
 

-Référence du programme : @internalsref{text-balloon-interface}.
+Référence du programme : @rinternals{balloon-interface}.

 
 
 @node Grid lines
 
 
 @node Grid lines

-@subsection Grid lines
+@unnumberedsubsubsec Grid lines

 
 Vous pouvez tracer des lignes entre les portées, synchronisées avec
 les notes.
 
 Vous pouvez tracer des lignes entre les portées, synchronisées avec
 les notes.


@@ -632,11 +403,44 @@ les notes.
 >>
 @end lilypond
 
 >>
 @end lilypond
 

-Exemples : @lsrdir{education}
+Exemples : @rlsr{Editorial annotations}.
+
+
+@node Analysis brackets
+@unnumberedsubsubsec Analysis brackets
+@cindex crochets
+@cindex crochets de phrasé
+@cindex analyse musicologique
+@cindex crochet de regroupement de notes
+
+On utilise des crochets en analyse musicale, pour indiquer la
+structure d'une pièce.  LilyPond permet d'utiliser une forme
+simplifiée de crochets horizontaux imbriqués, dans la mesure où le
+contexte @rinternals{Staff} comporte le graveur
+@rinternals{Horizontal_bracket_engraver}.  Un crochet s'ouvre avec
+@code{\startGroup}, et se ferme avec @code{\stopGroup}.
+
+@lilypond[quote,ragged-right,verbatim]
+\score {
+  \relative c'' {
+    c4\startGroup\startGroup
+    c4\stopGroup
+    c4\startGroup
+    c4\stopGroup\stopGroup
+  }
+  \layout {
+    \context {
+      \Staff \consists "Horizontal_bracket_engraver"
+}}}
+@end lilypond
+
+@seealso
+
+Référence du programme : @rinternals{HorizontalBracket}.

 
 
 @node Blank music sheet
 
 
 @node Blank music sheet

-@subsection Blank music sheet
+@unnumberedsubsubsec Blank music sheet

 
 @cindex Papier musique
 @cindex Portées, feuille blanche
 
 @cindex Papier musique
 @cindex Portées, feuille blanche