]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/fr/notation/editorial.itely
Merge branch 'master' of /home/jcharles/GIT/Lily/. into translation
[lilypond.git] / Documentation / fr / notation / editorial.itely
index a473c00e3db7f5310f46a1fd28f0935dfb3625df..1e53df13d9c77d795092e95572c472c4f4882400 100644 (file)
-@c -*- coding: utf-8; mode: texinfo; -*-
+@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
+
 @ignore
 @ignore
-    Translation of GIT committish: 33ba8d40c3493011a4b39ab8b1369701f8013bd6
+    Translation of GIT committish: 53cff5245f682708a6c77d580f418ece2923c2e4
 
     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.21"
 
 @c Translators: Jean-Charles Malahieude
 
 
 @c Translators: Jean-Charles Malahieude
 
-@node Editorial annotations
-@section Editorial annotations
+@node Annotations éditoriales
+@section Annotations éditoriales
+@translationof Editorial annotations
 
 @lilypondfile[quote]{editorial-headword.ly}
 
 
 @lilypondfile[quote]{editorial-headword.ly}
 
+Ce chapitre traite de la manière de modifier l'apparence des notes dans
+un but pédagogique ou d'analyse.
+
 @menu
 @menu
-* Inside the staff::            
-* Outside the staff::           
+* Dans la portée::
+* Hors de la portée::
 @end menu
 
 
 @end menu
 
 
-@node Inside the staff
-@subsection Inside the staff
+@node Dans la portée
+@subsection Dans la portée
+@translationof Inside the staff
 
 
+Nous allons voir ici comment mettre en exergue certains éléments à
+l'intérieur même de la portée.
 
 @menu
 
 @menu
-* Selecting notation font size::  
-* Fingering instructions::      
-* Hidden notes::                
-* Coloring objects::            
-* Parentheses::                 
-* Stems::                       
+* Indication de la taille de fonte musicale::
+* Doigtés::
+* Dictée à trous::
+* Coloration d'objets::
+* Parenthèses::
+* Hampes::
 @end menu
 
 @end menu
 
-@node Selecting notation font size
-@unnumberedsubsubsec Selecting notation font size
 
 
-Le plus sûr moyen de régler la taille de la police, quelque soit le
-contexte, consiste à définir la propriété @code{fontSize}.
+@node Indication de la taille de fonte musicale
+@unnumberedsubsubsec Indication de la taille de fonte musicale
+@translationof Selecting notation font size
+
+@cindex sélection de la taille (notation)
+@cindex notes, taille
+@cindex taille des notes
+@cindex têtes de note
+
+@funindex fontSize
+@funindex font-size
+@funindex magnification->font-size
+@funindex magstep
+@funindex magnifyMusic
+@funindex \teeny
+@funindex \tiny
+@funindex \small
+@funindex \normalsize
+@funindex \large
+@funindex \huge
+@funindex teeny
+@funindex tiny
+@funindex small
+@funindex normalsize
+@funindex large
+@funindex huge
+
+@warning{@*
+Pour les tailles de police textuelle, voir
+@ref{Sélection de la fonte et de la taille}.@*
+Pour la taille des portées, voir
+@ref{Définition de la taille de portée}.@*
+Pour les petites notes, voir
+@ref{Mise en forme d'une citation}.@*
+Pour les variantes, voir @ref{Portées d'ossia}.}
+
+Le plus sûr moyen de régler la taille des éléments de notation sans
+modifier la taille de la portée consiste à utiliser la commande
+@code{\magnifyMusic} :
+
+@c Grieg Piano Concerto (mvt.1 cadenza)
+@lilypond[verbatim,quote]
+\new Staff <<
+  \new Voice \relative {
+    \voiceOne
+    <e' e'>4 <f f'>8. <g g'>16 <f f'>8 <e e'>4 r8
+  }
+  \new Voice \relative {
+    \voiceTwo
+    \magnifyMusic 0.63 {
+      \override Score.SpacingSpanner.spacing-increment = #(* 1.2 0.63)
+      r32 c'' a c a c a c r c a c a c a c
+      r c a c a c a c a c a c a c a c
+    }
+  }
+>>
+@end lilypond
+
+La présence d'un @code{\override} dans cet exemple permet de
+contourner une bogue -- voir « Problèmes connus et avertissements » en
+fin de section.
+
+Dans le cas de fusion d'une tête de note normale avec une autre de
+taille inférieure, la taille de la petite note peut nécessiter une
+réinitialisation -- à l'aide d'un @w{@samp{\once@tie{}\normalsize}} --
+de telle sorte que les hampes et altérations s'alignent correctement :
+
+@c Chopin Prelude op.28 no.8
+@lilypond[verbatim,quote]
+\new Staff <<
+  \key fis \minor
+  \mergeDifferentlyDottedOn
+  \new Voice \relative {
+    \voiceOne
+    \magnifyMusic 0.63 {
+      \override Score.SpacingSpanner.spacing-increment = #(* 1.2 0.63)
+      \once \normalsize cis'32( cis' gis b a fis \once \normalsize d d'
+      \once \normalsize cis, cis' gis b a gis \once \normalsize fis fis'
+      \once \normalsize fis, fis' ais, cis b gis \once \normalsize eis eis'
+      \once \normalsize a, a' bis, d cis b \once \normalsize gis gis')
+    }
+  }
+  \new Voice \relative {
+    \voiceTwo
+    cis'8. d16 cis8. fis16 fis8. eis16 a8. gis16
+  }
+>>
+@end lilypond
+
+La commande @code{\magnifyMusic} n'est pas conçue pour gérer les
+citations, notes d'ornement ou portées d'ossia -- des moyens
+spécifiques sont déjà disponibles en la matière.  Elle est par contre
+tout à fait adaptée dans le cas d'un instrument particulier disposant de
+sa propre portée là où des notes d'ornement seraient inappropriées,
+comme pour une pseudo-cadence ou les exemples ci-dessus.  L'attribution
+d'une valeur de 0,63 à @code{\magnifyMusic} duplique les dimensions d'un
+contexte @code{CueVoice}.
+
+@warning{La commande @code{@bs{}magnifyMusic} n'est pas censée
+intervenir en complément d'une modification de la taille de portée --
+voir @ref{Définition de la taille de portée}.}
+
+
+@subsubsubheading Redimmensionnement individuel d'objets de rendu
+@c VO Resizing individual layout objects
+
+L'ajustement de la propriété @code{font-size} à l'aide des commandes
+@code{\tweak} ou @code{\override} permet de retailler un objet de rendu
+particulier :
+
+@lilypond[quote,verbatim,relative=1]
+% resize a note head
+<f \tweak font-size -4 b e>-5
+% resize a fingering
+bes-\tweak font-size 0 -3
+% resize an accidental
+\once \override Accidental.font-size = -4 bes!-^
+% resize an articulation
+\once \override Script.font-size = 4 bes!-^
+@end lilypond
+
+@lilypond[verbatim,quote,relative=2]
+\huge
+c4.-> d8---3
+\large
+c4.-> d8---3
+\normalsize
+c4.-> d8---3
+\small
+c4.-> d8---3
+\tiny
+c4.-> d8---3
+\teeny
+c4.-> d8---3
+@end lilypond
+
+La valeur par défaut de @code{font-size} est mentionnée, pour chaque
+objet de rendu, dans la référence des propriétés internes.  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
+@code{font-interface}.  L'abence de @code{font-size} dans la liste des
+« réglages par défaut » d'un objet signifie qu'elle est de 0 -- voir
+@rinternals{All layout objects} @emph{(Tous les objets de rendu)}.
+
+
+@subsubsubheading La propriété @code{fontSize}
+@c VO Understanding the @code{fontSize} property
+
+La propriété @code{fontSize} d'un contexte a pour effet de définir la
+taille proportionnelle de tout élément de notation basé sur un
+glyphe dans ce contexte :
+
+@lilypond[verbatim,quote,relative=2]
+\time 3/4
+d4---5 c8( b a g) |
+\set fontSize = -6
+e'4-- c!8-4( b a g) |
+\set fontSize = 0
+fis4---3 e8( d) fis4 |
+g2.
+@end lilypond
+
+La valeur de @code{fontSize} est un nombre indiquant la taille
+relative par rapport à la hauteur standard de la portée en cours.
+La valeur par défaut de @code{fontSize} est de 0.  Un pas de six
+aboutit exactement au doublement de la taille ; un pas de moins
+six la réduit de moitié.  Chaque incrément correspond à une
+augmentation d'environ 12 % de la taille de la police.
 
 
-@lilypond[quote,fragment,relative=1,verbatim]
-c8
-\set fontSize = #-4
-c f
-\set fontSize = #3
-g
+La fonction Scheme @code{magnification->font-size} permet de
+s'affranchir de l'échelle logarithmique peu intuitive des unités
+de la propriété @code{font-size}.  Ainsi, l'ajustement à 75 % de
+la notation musicale par rapport à la taille de la portée peut se
+libeller :
+
+@example
+\set fontSize = #(magnification->font-size 0.75)
+@end example
+
+La fonction Scheme @code{magstep} quant à elle effectue
+l'inverse : elle convertit le nombre affecté à @code{font-size} en
+facteur d'échelle.
+
+La propriété @code{fontSize} affecte uniquement les éléments de
+notation reposant sur des glyphes, tels les têtes de note,
+altérations, scripts, etc.  Elle n'aura aucun effet sur la taille
+de la portée, la hauteur des hampes ou la longueur des ligatures
+ni sur l'espacement horizontal.  L'échelonnement des hampes,
+ligature et espacement horizontal, couplé à la taille de la
+notation (sans modification de la taille de la portée), s'obtient
+à l'aide de la commande @code{\magnifyMusic} comme nous venons de
+le voir.  La modification de l'ensemble, y compris la taille de
+portée, est abordé dans @ref{Définition de la taille de portée}.
+
+Dès lors que la @strong{propriété de contexte} @code{fontSize} est
+définie, sa valeur est ajoutée individuellement à la valeur de la
+@strong{propriété de @emph{grob}} @code{font-size} des objets de
+rendu.  Ceci peut être source de confusion lorsque des propriétés
+@code{font-size} individuelles sont réglées alors que
+@code{fontSize} est déjà fixé :
+
+@lilypond[verbatim,quote,relative=2]
+% the default font-size for NoteHead is 0
+% the default font-size for Fingering is -5
+c4-3
+
+\set fontSize = -3
+% the effective font size for NoteHead is now -3
+% the effective font size for Fingering is now -8
+c4-3
+
+\override Fingering.font-size = 0
+% the effective font size for Fingering is now -3
+c4-3
 @end lilypond
 
 @end lilypond
 
-@noindent
-Ceci ne modifiera en rien la taille des différents symboles tels que
-ligatures ou liaisons.
-
-En interne, la propriété @code{fontSize} d'un contexte aura pour effet
-de définir la propriété @code{font-size} pour tous les objets de
-rendu.  La valeur de @code{font-size} est un entier représentant la
-taille proportionnellement à la hauteur standard de la portée en
-cours.  Chaque incrément correspond à une augmentation d'environ
-12@tie{}% de la taille de la police. Un pas de six aboutit exactement
-au doublement de la taille.  La fonction Scheme @code{magstep}
-convertit le nombre affecté à @code{font-size} en facteur d'échelle.
-Vous pouvez aussi définir directement la propriété @code{font-size} de
-manière à n'affecter seulement que certains objets de rendu.
-
-@lilypond[quote,fragment,relative=1,verbatim]
-c8
-\override NoteHead #'font-size = #-4
-c f
-\override NoteHead #'font-size = #3
-g
+LilyPond dispose d'un certain nombre de raccourcis :
+
+@multitable @columnfractions .2 .4 .4
+@item @b{Commande} @tab @b{Équivalent} @tab @b{Taille relative}
+@item @code{\teeny}      @tab @code{\set fontSize = -3} @tab 71 %
+@item @code{\tiny}       @tab @code{\set fontSize = -2} @tab 79 %
+@item @code{\small}      @tab @code{\set fontSize = -1} @tab 89 %
+@item @code{\normalsize} @tab @code{\set fontSize = 0} @tab 100 %
+@item @code{\large}      @tab @code{\set fontSize = 1} @tab 112 %
+@item @code{\huge}       @tab @code{\set fontSize = 2} @tab 126 %
+@end multitable
+
+@lilypond[verbatim,quote,relative=2]
+\teeny
+c4.-> d8---3
+\tiny
+c4.-> d8---3
+\small
+c4.-> d8---3
+\normalsize
+c4.-> d8---3
+\large
+c4.-> d8---3
+\huge
+c4.-> d8---3
 @end lilypond
 
 @end lilypond
 
-Pour changer la taille des symboles musicaux (police Feta), LilyPond met
-à l'échelle la fonte dont la taille est la plus proche de la taille voulue ---
-cf. @ref{Setting the staff size}.  La taille standard, pour laquelle
-@code{font-size} vaut 0, dépend de la hauteur de la portée.  À une
-portée de 20 points correspond une police de 10 points.
+@cindex standard, taille des notes
+@cindex notes, taille standard
+
+@funindex font-interface
+@funindex font-size
 
 
-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 @rinternals{font-interface}.
+Pour changer la taille des caractères, LilyPond met à l'échelle la fonte
+dont la taille est la plus proche de la taille voulue.  La taille
+standard (pour laquelle @code{font-size = 0}) dépend de la hauteur
+de la portée.  À une portée de 20 points correspond une police de
+11 points.
 
 
 @predefined
 
 
 @predefined
-Les commandes suivantes définissent @code{fontSize} pour la voix en
-cours :
-@funindex \tiny
+@code{\magnifyMusic},
+@code{\teeny},
 @code{\tiny},
 @code{\tiny},
-@funindex \small
 @code{\small},
 @code{\small},
-@funindex \normalsize
-@code{\normalsize}.
+@code{\normalsize},
+@code{\large},
+@code{\huge}.
 @endpredefined
 
 @endpredefined
 
+@seealso
+Manuel de notation :
+@ref{Sélection de la fonte et de la taille},
+@ref{Définition de la taille de portée},
+@ref{Mise en forme d'une citation},
+@ref{Portées d'ossia}.
+
+Fichiers d'initialisation :
+@file{ly/music-functions-init.ly},
+@file{ly/property-init.ly}.
+
+Morceaux choisis :
+@rlsrnamed{Editorial annotations,Annotations éditoriales}.
 
 
-@node Fingering instructions
-@unnumberedsubsubsec Fingering instructions
+Référence des propriétés internes :
+@rinternals{font-interface}.
+
+@c The two issues mentioned below:
+@c http://code.google.com/p/lilypond/issues/detail?id=3987
+@c http://code.google.com/p/lilypond/issues/detail?id=3990
+@knownissues
+Deux bogues actuellement répertoriés font obstacle à un espacement
+horizontal correct avec @code{\magnifyMusic}.  La seule façon de les
+contourner n'est cependant pas garantie dans toutes les situations.
+Dans l'exemple suivant, il vous faudra adapter la valeur de la variable
+@var{mag}.  Vous pourriez aussi tenter de supprimer une ou les deux
+commandes @code{\newSpacingSection}, ou les commandes @code{\override}
+et @code{\revert} :
+
+@example
+\magnifyMusic @var{mag} @{
+  \newSpacingSection
+  \override Score.SpacingSpanner.spacing-increment = #(* 1.2 @var{mag})
+  @var{[musique]}
+  \newSpacingSection
+  \revert Score.SpacingSpanner.spacing-increment
+@}
+@end example
+
+
+@node Doigtés
+@unnumberedsubsubsec Doigtés
+@translationof Fingering instructions
 
 @cindex doigté
 @cindex substitution de doigt
 
 
 @cindex doigté
 @cindex substitution de doigt
 
+@funindex \finger
+@funindex finger
 
 
-Les doigtés peuvent être indiqués comme suit :
-@example
+Les doigtés peuvent être indiqués comme suit :
 @var{note}-@var{chiffre_du_doigt}
 @var{note}-@var{chiffre_du_doigt}
-@end example
+
+@lilypond[verbatim,quote,relative=2]
+c4-1 d-2 f-4 e-3
+@end lilypond
+
 Pour les substitutions de doigts, on a recours à une indication
 textuelle (commande @code{\markup}) de doigté
 (commande @code{\finger}).
 
 Pour les substitutions de doigts, on a recours à une indication
 textuelle (commande @code{\markup}) de doigté
 (commande @code{\finger}).
 
-@lilypond[quote,verbatim,ragged-right,fragment,relative=1]
-c4-1 c-2 c-3 c-4
-c^\markup { \finger "2 - 3" }
+@lilypond[verbatim,quote,relative=2]
+c4-1 d-2 f\finger \markup \tied-lyric #"4~3" c\finger "2 - 3"
 @end lilypond
 
 @end lilypond
 
+@cindex pouce, doigté
+
+@funindex \thumb
+@funindex thumb
 
 La commande @code{\thumb} peut être utilisée pour indiquer, par exemple
 dans une partition de violoncelle, si une note doit être jouée avec le
 
 La commande @code{\thumb} peut être utilisée pour indiquer, par exemple
 dans une partition de violoncelle, si une note doit être jouée avec le
-pouce (@q{thumb} en anglais).
+pouce (@emph{thumb} en anglais).
 
 
-@lilypond[quote,verbatim,ragged-right,fragment,relative=2]
-<a_\thumb a'-3>8 <b_\thumb b'-3>
+@lilypond[verbatim,quote,relative=2]
+<a_\thumb a'-3>2 <b_\thumb b'-3>
 @end lilypond
 
 @end lilypond
 
+@cindex doigtés des accords
+@cindex accords, doigtés
 
 Les doigtés des accords peuvent être saisis note par note,
 en les indiquant après chaque hauteur de note.
 
 
 Les doigtés des accords peuvent être saisis note par note,
 en les indiquant après chaque hauteur de note.
 
-@lilypond[quote,verbatim,ragged-right,fragment,relative=2]
-< c-1 e-2 g-3 b-5 >4
+@lilypond[verbatim,quote,relative=2]
+<c-1 e-2 g-3 b-5>2 <d-1 f-2 a-3 c-5>
 @end lilypond
 
 @end lilypond
 
+Les indications de doigtés peuvent se placer au-dessus ou en dessous de
+la portée -- voir @ref{Direction et positionnement} à ce sujet.
 
 
-@commonprop
-
-On peut contrôler précisément les doigtés des accords en réglant
-la propriété @code{fingeringOrientations}.
-
-@lilypond[quote,verbatim,ragged-right,fragment,relative=1]
-\set fingeringOrientations = #'(left down)
-<c-1 es-2 g-4 bes-5 > 4
-\set fingeringOrientations = #'(up right down)
-<c-1 es-2 g-4 bes-5 > 4
-@end lilypond
-
-
-Cette propriété permet également, dans de la musique monophonique,
-d'indiquer des doigtés très proches des têtes de notes.
+@snippets
 
 
-@lilypond[verbatim,ragged-right,quote,fragment]
-\set fingeringOrientations = #'(right)
-<es'-2>4
-@end lilypond
+@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
+{controlling-the-placement-of-chord-fingerings.ly}
 
 
-@snippets
+@lilypondfile[verbatim,quote,texidoc,doctitle]
+{allowing-fingerings-to-be-printed-inside-the-staff.ly}
 
 
-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+@lilypondfile[verbatim,quote,texidoc,doctitle]
 {avoiding-collisions-with-chord-fingerings.ly}
 
 {avoiding-collisions-with-chord-fingerings.ly}
 
-
 @seealso
 @seealso
-Référence du programme : @rinternals{Fingering}.
+Manuel de notation :
+@ref{Direction et positionnement}.
 
 
-Exemples : @rlsr{Editorial annotations}.
+Morceaux choisis :
+@rlsrnamed{Editorial annotations, Annotations éditoriales}.
 
 
+Référence des propriétés internes :
+@rinternals{FingeringEvent},
+@rinternals{fingering-event},
+@rinternals{Fingering_engraver},
+@rinternals{New_fingering_engraver},
+@rinternals{Fingering}.
 
 
-@node Hidden notes
-@unnumberedsubsubsec Hidden notes
 
 
-@cindex Masquées, notes
-@cindex Invisibles, notes
-@cindex Transparentes, notes
+@node Dictée à trous
+@unnumberedsubsubsec Dictée à trous
+@translationof Hidden notes
+
+@cindex masquées, notes
+@cindex invisibles, notes
+@cindex transparentes, notes
+@cindex note invisible
+@cindex note masquée
 
 @funindex \hideNotes
 
 @funindex \hideNotes
+@funindex hideNotes
 @funindex \unHideNotes
 @funindex \unHideNotes
-Les notes masquées --- ou invisibles ou encore transparentes --- sont
+@funindex unHideNotes
+
+Les notes masquées -- ou invisibles ou encore transparentes -- sont
 utiles dans le cadre d'exercices de théorie ou de composition.
 
 utiles dans le cadre d'exercices de théorie ou de composition.
 
-@lilypond[quote,ragged-right,verbatim,relative=2,fragment]
-c4 d4
+@lilypond[verbatim,quote,relative=2]
+c4 d
 \hideNotes
 \hideNotes
-e4 f4
+e4 f
 \unHideNotes
 \unHideNotes
-g4 a
+g a
+\hideNotes
+b
+\unHideNotes
+c
 @end lilypond
 
 @end lilypond
 
+Têtes de note, hampes, crochets et silences sont invisibles.  Une
+ligature sera invisible si elle démarre sur une note invisible.
+Les objets de notation attachés à une note invisible ne seront pas
+masqués pour autant.
 
 
-@node Coloring objects
-@unnumberedsubsubsec Coloring objects
+@lilypond[verbatim,quote,relative=2]
+e8(\p f g a)--
+\hideNotes
+e8(\p f g a)--
+@end lilypond
+
+@predefined
+@code{\hideNotes},
+@code{\unHideNotes}.
+@endpredefined
+
+@seealso
+Manuel d'initiation :
+@rlearning{Visibilité et couleur des objets}.
+
+Manuel de notation :
+@ref{Silences invisibles},
+@ref{Visibilité des objets},
+@ref{Masquage de portées}.
+
+Morceaux choisis :
+@rlsrnamed{Editorial annotations,Annotations éditoriales}.
+
+Référence des propriétés internes :
+@rinternals{Note_spacing_engraver},
+@rinternals{NoteSpacing}.
+
+
+@node Coloration d'objets
+@unnumberedsubsubsec Coloration d'objets
+@translationof Coloring objects
+
+@cindex objets en couleur
+@cindex couleurs
+@cindex colorisation d'objets
+@cindex coloration d'objets
+@cindex coloration de notes
+@cindex colorisation de notes
+@cindex notes en couleur
+@cindex x11, couleurs
+@cindex couleurs x11
+
+@funindex color
+@funindex \with-color
+@funindex with-color
+@funindex x11-color
 
 Des objets peuvent être colorisés individuellement.  Une listes des
 
 Des objets peuvent être colorisés individuellement.  Une listes des
-noms des couleurs disponibles se trouvent à l'annexe @ref{List of colors}.
+noms des couleurs disponibles se trouvent à l'annexe
+@ref{Liste des couleurs}.
 
 
-@lilypond[quote,ragged-right,verbatim,fragment,relative=1]
-\override NoteHead #'color = #red
+@lilypond[verbatim,quote,relative=2]
+\override NoteHead.color = #red
 c4 c
 c4 c
-\override NoteHead #'color = #(x11-color 'LimeGreen)
+\override NoteHead.color = #(x11-color 'LimeGreen)
 d
 d
-\override Stem #'color = #blue
+\override Stem.color = #blue
 e
 @end lilypond
 
 L'intégralité de la palette des couleurs définies pour X11 est
 e
 @end lilypond
 
 L'intégralité de la palette des couleurs définies pour X11 est
-accessible par la fonction Scheme x11-color.  Cette fonction prend
-en argument une expression symbolique
-
-@example
-\override Beam #'color = #(x11-color 'MediumTurquoise)
-@end example
-
-ou une chaîne de caractères
+accessible par la fonction Scheme @code{x11-color}.  Cette fonction
+prend en argument une expression symbolique de la forme
+@code{@var{'TaraTata}} ou bien une chaîne de caractères comme
+@code{@var{"TaraTata"}}.  La première formulation est à la fois plus
+rapide à écrire et aussi plus efficace.  Néanmoins, la deuxième forme
+permet d'accéder aux noms composés des couleurs de X11.
+
+Lorsque la fonction @code{x11-color} ne trouve pas le paramètre fourni,
+elle revient à la couleur par défaut, le noir.  Le problème ressort de
+façon évidente au vu de la partition finale.
 
 
-@example
-\override Beam #'color = #(x11-color "MediumTurquoise")
-@end example
+@lilypond[verbatim,quote,relative=2]
+\override Staff.StaffSymbol.color = #(x11-color 'SlateBlue2)
+\set Staff.instrumentName = \markup {
+  \with-color #(x11-color 'navy) "Clarinet"
+}
 
 
-La première formulation est à la fois plus rapide à écrire et aussi
-plus efficace.  Néanmoins, la deuxième forme permet d'accéder aux noms
-composés des couleurs de X11.
+gis8 a
+\override Beam.color = #(x11-color "medium turquoise")
+gis a
+\override Accidental.color = #(x11-color 'DarkRed)
+gis a
+\override NoteHead.color = #(x11-color "LimeGreen")
+gis a
+% this is deliberate nonsense; note that the stems remain black
+\override Stem.color = #(x11-color 'Boggle)
+b2 cis
+@end lilypond
 
 
-@example
-\override Beam #'color = #(x11-color "medium turquoise")
-@end example
+@cindex rgb-color
+@cindex couleur rgb
+@cindex couleur rvb
+@cindex rgb, couleur
+@cindex rvb, couleur
 
 
-Lorsque la fonction x11-color ne trouve pas le paramètre fourni, elle
-revient à la couleur par défaut, le noir.  Le problème ressort de
-façon évidente au vu de la partition finale.
+@funindex rgb-color
 
 
-L'exemple suivant illustre l'utilisation de la fonction
-@code{x11-color}.  Notez que, après avoir été définie à (x11-color
-'Boggle), la couleur des hampes repasse au noir.
+Un autre moyen consiste à fournir à la fonction Scheme @code{rgb-color}
+les composantes de la couleur exacte au format rouge-vert-bleu
+(@emph{RGB}) -- chacune étant exprimée en en fraction de 256 (le 0.5 de
+l'exemple suivant correspond à 128).
 
 
-@lilypond[quote,ragged-right,verbatim]
-{
-  \override Staff.StaffSymbol #'color = #(x11-color 'SlateBlue2)
-  \set Staff.instrumentName = \markup {
-    \with-color #(x11-color 'navy) "Clarinet"
-  }
-  \time 2/4
-  gis''8 a''
-  \override Beam #'color = #(x11-color "medium turquoise")
-  gis'' a''
-  \override NoteHead #'color = #(x11-color "LimeGreen")
-  gis'' a''
-  \override Stem #'color = #(x11-color 'Boggle)
-  gis'' a''
+@lilypond[verbatim,quote,relative=2]
+\override Staff.StaffSymbol.color = #(x11-color 'SlateBlue2)
+\set Staff.instrumentName = \markup {
+  \with-color #(x11-color 'navy) "Clarinet"
 }
 }
-@end lilypond
 
 
+\override Stem.color = #(rgb-color 0 0 0)
+gis8 a
+\override Stem.color = #(rgb-color 1 1 1)
+gis8 a
+\override Stem.color = #(rgb-color 0 0 0.5)
+gis4 a
+@end lilypond
 
 @seealso
 
 @seealso
-Annexes : @ref{List of colors}.
+Manuel de notation :
+@ref{Liste des couleurs},
+@ref{La commande d'affinage (tweak)}.
 
 
+Morceaux choisis :
+@rlsrnamed{Editorial annotations,Annotations éditoriales}.
 
 
-@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.
+@cindex x11, couleur
+@cindex couleur, notes d'un accord
+@cindex notes colorisées dans un accord
+@cindex accords et couleur
+
+@funindex x11-color
 
 
+@knownissues
 Une couleur x11 n'aura pas forcément le même rendu qu'une couleur
 normale ayant un nom similaire.
 
 Une couleur x11 n'aura pas forcément le même rendu qu'une couleur
 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}.  
-Pour plus de détails, consultez @ref{The tweak command}.
+Les couleurs de X11 ne sont pas toutes perceptibles dans un navigateur
+internet.  Aussi nous vous recommandons, dans le cadre d'une
+présentation multimédia, d'utiliser des couleurs de base @code{blue},
+@code{green}, @code{red} -- bleu, vert, rouge.
+
+Vous ne pouvez pas coloriser individuellement des notes à l'intérieur
+d'un accord avec @code{\override}.  Si besoin est, utilisez
+@code{\tweak} ou @code{\single\override} devant la note en question.
+Pour plus de détails, consultez @ref{La commande d'affinage (tweak)}.
 
 
 
 
-@node Parentheses
-@unnumberedsubsubsec Parentheses
+@node Parenthèses
+@unnumberedsubsubsec Parenthèses
+@translationof Parentheses
 
 @cindex fantômes, notes
 @cindex notes fantômes
 @cindex parenthèses, notes entre
 
 @cindex fantômes, notes
 @cindex notes fantômes
 @cindex parenthèses, notes entre
+@cindex crochets, notes entre
+
+@funindex \parenthesize
+@funindex parenthesize
 
 Des objets peuvent être mis entre parenthèses en saisissant
 
 Des objets peuvent être mis entre parenthèses en saisissant
-@code{\parenthesize} juste avant l'événement musical.
-
-@lilypond[relative=2,fragment,verbatim,ragged-right]
-<
-  c
-  \parenthesize d
-  g
->4-\parenthesize -.
+@code{\parenthesize} juste avant l'événement musical.  Si l'instruction
+préfixe un accord, chaque note le composant se présentera entre
+parenthèses.  Vous pouvez aussi mettre individuellement entre
+parenthèses les notes d'un accord.
+
+@lilypond[verbatim,quote,relative=2]
+c2 \parenthesize d
+c2 \parenthesize <c e g>
+c2 <c \parenthesize e g>
 @end lilypond
 
 @end lilypond
 
-Ceci n'est opérationnel que dans le cadre d'un accord, qui peut ne
-comprendre qu'une seule note.
+Les objets autres que des notes peuvent aussi être entre parenthèses.
+En ce qui concerne les articulations, l'instruction @code{\parenthesize}
+doit cependant être précédée d'un tiret.
 
 
-@example
-< \parenthesize NOTE>
-@end example
+@lilypond[verbatim,quote,relative=2]
+c2-\parenthesize -. d
+c2 \parenthesize r
+@end lilypond
+
+@seealso
+Morceaux choisis :
+@rlsrnamed{Editorial annotations,Annotations éditoriales}.
+
+Référence des propriétés internes :
+@rinternals{Parenthesis_engraver},
+@rinternals{ParenthesesItem},
+@rinternals{parentheses-interface}.
+
+@knownissues
+Lorsqu'un accord est mis entre parenthèses, celles-ci s'appliquent
+individuellement à chacune des notes le composant, alors qu'on
+attendrait une seule paire de parenthèses encadrant tout l'accord.
 
 
 
 
-@node Stems
-@unnumberedsubsubsec Stems
+@node Hampes
+@unnumberedsubsubsec Hampes
+@translationof Stems
 
 
-Dès qu'une note est rencontrée, un objet @rinternals{Stem} se crée
+@cindex hampes
+@cindex hampes invisibles
+@cindex visibilité des hampes
+@cindex masquage des hampes
+@cindex hampe, orientation
+@cindex hampe montante
+@cindex hampe descendante
+@cindex hampe neutre
+
+@funindex \stemUp
+@funindex stemUp
+@funindex \stemDown
+@funindex stemDown
+@funindex \stemNeutral
+@funindex stemNeutral
+
+Dès qu'une note est rencontrée, un objet @code{Stem} se crée
 automatiquement.  Pour les rondes et les silences, ils sont aussi
 créés, mais en mode invisible.
 
 automatiquement.  Pour les rondes et les silences, ils sont aussi
 créés, mais en mode invisible.
 
+L'orientation des hampes peut être définie manuellement -- voir
+@ref{Direction et positionnement} à ce sujet.
 
 @predefined
 
 @predefined
-@funindex \stemUp
 @code{\stemUp},
 @code{\stemUp},
-@funindex \stemDown
 @code{\stemDown},
 @code{\stemDown},
-@funindex \stemNeutral
 @code{\stemNeutral}.
 @endpredefined
 
 @code{\stemNeutral}.
 @endpredefined
 
+@snippets
 
 
-@commonprop
+@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
+{default-direction-of-stems-on-the-center-line-of-the-staff.ly}
 
 
-Pour changer la direction des hampes au milieu de la portée, utilisez
+@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
+{automatically-changing-the-stem-direction-of-the-middle-note-based-on-the-melody.ly}
 
 
-@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
-a4 b c b
-\override Stem #'neutral-direction = #up
-a4 b c b
-\override Stem #'neutral-direction = #down
-a4 b c b
-@end lilypond
+@seealso
+Manuel de notation :
+@ref{Direction et positionnement}.
 
 
+Morceaux choisis :
+@rlsrnamed{Editorial annotations,Annotations éditoriales}.
 
 
-@node Outside the staff
-@subsection Outside the staff
+Référence des propriétés internes :
+@rinternals{Stem_engraver},
+@rinternals{Stem},
+@rinternals{stem-interface}.
 
 
 
 
+@node Hors de la portée
+@subsection Hors de la portée
+@translationof Outside the staff
+
+Nous allons nous intéresser ici à souligner des éléments inscrits dans
+la portée par des éléments qui lui seront externes.
+
 @menu
 @menu
-* Balloon help::                
-* Grid lines::                  
-* Analysis brackets::           
-* Blank music sheet::           
+* Info-bulle::
+* Quadrillage temporel::
+* Crochets d'analyse::
 @end menu
 
 @end menu
 
-@node Balloon help
-@unnumberedsubsubsec Balloon help
+
+@node Info-bulle
+@unnumberedsubsubsec Info-bulle
+@translationof Balloon help
+
+@cindex bulle
+@cindex notation, explication
+@cindex info-bulle
+
+@funindex \balloonGrobText
+@funindex \balloonText
+@funindex Balloon_engraver
+@funindex balloonGrobText
+@funindex balloonText
+@funindex \balloonLengthOn
+@funindex balloonLengthOn
+@funindex \balloonLengthOff
+@funindex balloonLengthOff
 
 Vous pouvez marquer et nommer des éléments de notation à l'aide de
 bulles.  L'objectif premier de cette fonctionnalité est d'expliquer la
 
 Vous pouvez marquer et nommer des éléments de notation à l'aide de
 bulles.  L'objectif premier de cette fonctionnalité est d'expliquer la
-notation. 
+notation.
 
 En voici un exemple :
 @c KEEP LY
 
 En voici un exemple :
 @c KEEP LY
-@lilypond[quote,verbatim,fragment,ragged-right,relative=2]
+@lilypond[verbatim,quote,relative=2]
 \new Voice \with { \consists "Balloon_engraver" }
 {
   \balloonGrobText #'Stem #'(3 . 4) \markup { "Je suis une hampe" }
 \new Voice \with { \consists "Balloon_engraver" }
 {
   \balloonGrobText #'Stem #'(3 . 4) \markup { "Je suis une hampe" }
-  <c-\balloonText #'(-2 . -2) \markup { Hello }  >8
+  a8
+  \balloonGrobText #'Rest #'(-4 . -4) \markup { "Je suis un silence" }
+  r
+  <c, g'-\balloonText #'(-2 . -2) \markup { "Je suis une tête de note" } c>2.
 }
 @end lilypond
 
 }
 @end lilypond
 
-@noindent
-Vous disposez de deux fonctions musicales, @code{balloonText} et
-@code{balloonGrobText}.  @code{balloonGrobText} prend en argument
-l'objet graphique à agrémenter, alors que @code{balloonText} s'utilise
-comme une simple articulation.  Les autres arguments sont le décalage
-et le texte de la bulle.
+Vous disposez de deux fonctions musicales, @code{balloonGrobText} et
+@code{balloonText}.  @code{balloonGrobText} prend en argument
+l'objet graphique à agrémenter et s'utilise comme
+@code{\once \override}.  @code{balloonText}, quant à lui, s'utilise
+comme une simple articulation et fonctionne comme @code{\tweak} pour
+attacher du texte à l'une des notes d'un accord.  Les autres arguments
+sont le décalage et le texte de la bulle.
 
 
-@cindex bulles
-@cindex notation, expliquer
+Les info-bulles n'ont aucune influence sur l'espacement des notes ; on
+peut toutefois le gérer ainsi :
 
 
+@c KEEP LY
+@lilypond[verbatim,quote,relative=2]
+\new Voice \with { \consists "Balloon_engraver" }
+{
+  \balloonGrobText #'Stem #'(3 . 4) \markup { "Je suis une hampe" }
+  a8
+  \balloonGrobText #'Rest #'(-4 . -4) \markup { "Je suis un silence" }
+  r
+  \balloonLengthOn
+  <c, g'-\balloonText #'(-2 . -2) \markup { "Je suis une tête de note" } c>2.
+}
+@end lilypond
+
+@predefined
+@code{\balloonLengthOn},
+@code{\balloonLengthOff}.
+@endpredefined
 
 @seealso
 
 @seealso
-Référence du programme : @rinternals{balloon-interface}.
+Morceaux choisis :
+@rlsrnamed{Editorial annotations,Annotations éditoriales}.
+
+Référence des propriétés internes :
+@rinternals{Balloon_engraver},
+@rinternals{BalloonTextItem},
+@rinternals{balloon-interface}.
+
+
+@node Quadrillage temporel
+@unnumberedsubsubsec Quadrillage temporel
+@translationof Grid lines
 
 
+@cindex quadrillage temporel
+@cindex temporel, quadrillage
 
 
-@node Grid lines
-@unnumberedsubsubsec Grid lines
+@funindex Grid_point_engraver
+@funindex Grid_line_span_engraver
+@funindex gridInterval
 
 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.
+
+LilyPond a recours à deux graveurs distincts afin d'afficher le
+quadrillage :  le @code{Grid_point_engraver} se charge de
+déterminer l'envergure du crochet, alors que le
+@code{Grid_line_span_engraver} se consacrera au tracé des lignes.
+Les lignes sont par défaut centrées horizontalement sous les notes et
+alignées sur la gauche des têtes.  La propriété @code{gridInterval}
+spécifie quant à elle l'espace de temps entre chaque ligne.
+
 @c KEEP LY
 @c KEEP LY
-@lilypond[ragged-right,quote,verbatim]
+@lilypond[verbatim,quote]
 \layout {
   \context {
     \Staff
     \consists "Grid_point_engraver" %% active les guides
 \layout {
   \context {
     \Staff
     \consists "Grid_point_engraver" %% active les guides
-    gridInterval = #(ly:make-moment 1 4)
+    gridInterval = #(ly:make-moment 1/4)
+  }
+  \context {
+    \Score
+    \consists "Grid_line_span_engraver"
+     %% centre les lignes guides horizontalement sous les notes
   }
 }
 
   }
 }
 
-\new Score \with {
-  \consists "Grid_line_span_engraver"
-  %% centre les lignes guides horizontalement sous les notes
-  \override NoteColumn #'X-offset = #-0.5
-}
-
-\new ChoirStaff <<
-  \new Staff {
-    \stemUp
-    \relative {
-      c'4. d8 e8 f g4
+\score {
+  \new ChoirStaff <<
+    \new Staff \relative {
+      \stemUp
+      c'''4. d8 e8 f g4
     }
     }
-  }
-  \new Staff {
+    \new Staff \relative {
     %% centre les lignes guides verticalement
     %% centre les lignes guides verticalement
-    \override Score.GridLine #'extra-offset = #'( 0.0 . 1.0 )
-    \stemDown
-    \clef bass
-    \relative c {
+      \clef bass
+      \stemDown
       c4  g'  f  e
     }
       c4  g'  f  e
     }
-  }
->>
+  >>
+}
 @end lilypond
 
 @end lilypond
 
-Exemples : @rlsr{Editorial annotations}.
+@snippets
+
+@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
+{grid-lines--changing-their-appearance.ly}
+
+@seealso
+Morceaux choisis :
+@rlsrnamed{Editorial annotations,Annotations éditoriales}.
+
+Référence des propriétés internes :
+@rinternals{Grid_line_span_engraver},
+@rinternals{Grid_point_engraver},
+@rinternals{GridLine},
+@rinternals{GridPoint},
+@rinternals{grid-line-interface},
+@rinternals{grid-point-interface}.
 
 
 
 
-@node Analysis brackets
-@unnumberedsubsubsec Analysis brackets
+@node Crochets d'analyse
+@unnumberedsubsubsec Crochets d'analyse
+@translationof Analysis brackets
+
 @cindex crochets
 @cindex crochets de phrasé
 @cindex analyse musicologique
 @cindex crochet de regroupement de notes
 
 @cindex crochets
 @cindex crochets de phrasé
 @cindex analyse musicologique
 @cindex crochet de regroupement de notes
 
+@funindex Horizontal_bracket_engraver
+@funindex \startGroup
+@funindex startGroup
+@funindex \stopGroup
+@funindex stopGroup
+
 On utilise des crochets en analyse musicale, pour indiquer la
 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}.
+structure d'une pièce.
 
 
-@lilypond[quote,ragged-right,verbatim]
-\score {
-  \relative c'' {
-    c4\startGroup\startGroup
-    c4\stopGroup
-    c4\startGroup
-    c4\stopGroup\stopGroup
+@lilypond[verbatim,quote]
+\layout {
+  \context {
+    \Voice
+    \consists "Horizontal_bracket_engraver"
   }
   }
-  \layout {
-    \context {
-      \Staff \consists "Horizontal_bracket_engraver"
-}}}
+}
+\relative {
+  c''2\startGroup
+  d\stopGroup
+}
 @end lilypond
 
 @end lilypond
 
+Les crochets d'analyses sont susceptibles d'être imbriqués :
 
 
-@seealso
-Référence du programme : @rinternals{HorizontalBracket}.
-
-
-@node Blank music sheet
-@unnumberedsubsubsec Blank music sheet
-
-@cindex Papier musique
-@cindex Portées, feuille blanche
-
-Une feuille de papier musique s'obtient en utilisant des notes
-invisibles, et en invalidant le @code{Bar_number_engraver}.
-
-@c KEEP LY
-@lilypond[quote,verbatim]
-\layout{ indent = #0 }
-emptymusic = {
-  \repeat unfold 2 % À modifier pour plus de lignes.
-  { s1\break }
-  \bar "|."
+@lilypond[verbatim,quote]
+\layout {
+  \context {
+    \Voice
+    \consists "Horizontal_bracket_engraver"
+  }
+}
+\relative {
+  c''4\startGroup\startGroup
+  d4\stopGroup
+  e4\startGroup
+  d4\stopGroup\stopGroup
 }
 }
-\new Score \with {
-  \override TimeSignature #'transparent = ##t
-% décommenter la  ligne suivante selon besoin
-%  \override Clef #'transparent = ##t
-  defaultBarType = #""
-  \remove Bar_number_engraver
-} <<
-
-% à adapter selon les portées désirées
-  \new Staff \emptymusic
-  \new TabStaff \emptymusic
->>
 @end lilypond
 
 @end lilypond
 
-
+@seealso
+Morceaux choisis :
+@rlsrnamed{Editorial annotations,Annotations éditoriales}.
+
+Référence des propriétés internes :
+@rinternals{Horizontal_bracket_engraver},
+@rinternals{HorizontalBracket},
+@rinternals{horizontal-bracket-interface},
+@rinternals{Staff}.