--- /dev/null
+@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
+@ignore
+ Translation of GIT committish: 057106293b07b74b00553fe4dc3dfac5c1f3b682
+
+ When revising a translation, copy the HEAD committish of the
+ version that you are working on. For details, see the Contributors'
+ Guide, node Updating translation committishes..
+@end ignore
+
+@c \version "2.14.0"
+
+@c Translators: Jean-Charles Malahieude
+
+@node Annotations éditoriales
+@section Annotations éditoriales
+@translationof Editorial annotations
+
+@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
+* Dans la portée::
+* Hors de la portée::
+@end menu
+
+
+@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
+* Indication de la taille de fonte musicale::
+* Doigtés::
+* Dictée à trous::
+* Coloration d'objets::
+* Parenthèses::
+* Hampes::
+@end menu
+
+@node Indication de la taille de fonte musicale
+@unnumberedsubsubsec Indication de la taille de fonte musicale
+@translationof Selecting notation font size
+
+@cindex selection de la taille (notation)
+@cindex notes, taille
+@cindex taille des notes
+@cindex têtes de note
+
+@funindex fontSize
+@funindex font-size
+@funindex magstep
+@funindex \huge
+@funindex \large
+@funindex \normalsize
+@funindex \small
+@funindex \tiny
+@funindex \teeny
+@funindex huge
+@funindex large
+@funindex normalsize
+@funindex small
+@funindex tiny
+@funindex teeny
+
+
+Le plus sûr moyen de régler la taille de la police, quel que soit le
+contexte, consiste à définir la propriété @code{fontSize}.
+Ceci ne modifiera en rien la taille des différents symboles tels que
+ligatures ou liaisons.
+
+@warning{En matière de taille des éléments textuels, référez-vous au
+chapitre @ref{Sélection de la fonte et de la taille}.}
+
+@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
+
+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[verbatim,quote,relative=2]
+\set fontSize = #3
+c4.-> d8---3
+\override NoteHead #'font-size = #-4
+c4.-> d8---3
+\override Script #'font-size = #2
+c4.-> d8---3
+\override Stem #'font-size = #-5
+c4.-> d8---3
+@end lilypond
+
+@cindex standard, taille des notes
+@cindex notes, taille standard
+
+@funindex font-interface
+@funindex font-size
+
+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 @w{@code{font-size = #0}}) dépend de la hauteur
+de la portée. À une portée de 20@tie{}points correspond une police de
+10@tie{}points.
+
+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}.
+
+
+@predefined
+@code{\teeny},
+@code{\tiny},
+@code{\small},
+@code{\normalsize},
+@code{\large},
+@code{\huge}.
+@endpredefined
+
+
+@seealso
+Morceaux choisis :
+@rlsrnamed{Editorial annotations,Annotations éditoriales}.
+
+Référence des propriétés internes :
+@rinternals{font-interface}.
+
+
+@node Doigtés
+@unnumberedsubsubsec Doigtés
+@translationof Fingering instructions
+
+@cindex doigté
+@cindex substitution de doigt
+
+@funindex \finger
+@funindex finger
+
+Les doigtés peuvent être indiqués comme suit@tie{}:
+@var{note}-@var{chiffre_du_doigt}
+
+@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}).
+
+@lilypond[verbatim,quote,relative=2]
+c4-1 d-2 f-4 c^\markup { \finger "2 - 3" }
+@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
+pouce (@emph{thumb} en anglais).
+
+@lilypond[verbatim,quote,relative=2]
+<a_\thumb a'-3>2 <b_\thumb b'-3>
+@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.
+
+@lilypond[verbatim,quote,relative=2]
+<c-1 e-2 g-3 b-5>2 <d-1 f-2 a-3 c-5>
+@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.
+
+@snippets
+
+@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
+{controlling-the-placement-of-chord-fingerings.ly}
+
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{allowing-fingerings-to-be-printed-inside-the-staff.ly}
+
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{avoiding-collisions-with-chord-fingerings.ly}
+
+
+@seealso
+Manuel de notation :
+@ref{Direction et positionnement}
+
+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 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 \unHideNotes
+@funindex unHideNotes
+
+Les notes masquées -- ou invisibles ou encore transparentes -- sont
+utiles dans le cadre d'exercices de théorie ou de composition.
+
+@lilypond[verbatim,quote,relative=2]
+c4 d
+\hideNotes
+e4 f
+\unHideNotes
+g a
+\hideNotes
+b
+\unHideNotes
+c
+@end lilypond
+
+Les objets de notation attachés à une note invisible ne seront pas
+masqués pour autant.
+
+@lilypond[verbatim,quote,relative=2]
+c4( d)
+\hideNotes
+e4(\p f)--
+@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
+noms des couleurs disponibles se trouvent à l'annexe
+@ref{Liste des couleurs}.
+
+@lilypond[verbatim,quote,relative=2]
+\override NoteHead #'color = #red
+c4 c
+\override NoteHead #'color = #(x11-color 'LimeGreen)
+d
+\override Stem #'color = #blue
+e
+@end lilypond
+
+L'intégralité de la palette des couleurs définies pour X11 est
+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.
+
+@lilypond[verbatim,quote,relative=2]
+\override Staff.StaffSymbol #'color = #(x11-color 'SlateBlue2)
+\set Staff.instrumentName = \markup {
+ \with-color #(x11-color 'navy) "Clarinet"
+}
+
+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
+
+@cindex rgb-color
+@cindex couleur rgb
+@cindex couleur rvb
+@cindex rgb, couleur
+@cindex rvb, couleur
+
+@funindex rgb-color
+
+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[verbatim,quote,relative=2]
+\override Staff.StaffSymbol #'color = #(x11-color 'SlateBlue2)
+\set Staff.instrumentName = \markup {
+ \with-color #(x11-color 'navy) "Clarinet"
+}
+
+\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
+Manuel de notation :
+@ref{Liste des couleurs},
+@ref{La commande d'affinage (tweak)}.
+
+Morceaux choisis :
+@rlsrnamed{Editorial annotations,Annotations éditoriales}.
+
+
+@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.
+
+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 @code{#blue},
+@code{#green}, @code{#red} -- bleu, vert, rouge.
+
+
+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{La commande d'affinage (tweak)}.
+
+
+@node Parenthèses
+@unnumberedsubsubsec Parenthèses
+@translationof Parentheses
+
+@cindex fantômes, notes
+@cindex notes fantômes
+@cindex parenthèses, notes entre
+
+@funindex \parenthesize
+@funindex parenthesize
+
+Des objets peuvent être mis entre parenthèses en saisissant
+@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
+
+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.
+
+@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 Hampes
+@unnumberedsubsubsec Hampes
+@translationof Stems
+
+@cindex hampes
+@cindex hampes invisibles
+@cindex visibilité des hampes
+@cindex masquage des hampes
+
+@funindex \stemUp
+@funindex stemUp
+@funindex \stemDown
+@funindex stemDown
+@funindex \stemNeutral
+@funindex stemNeutral
+@cindex stem, direction
+@cindex stem, up
+@cindex stem, down
+@cindex stem, neutral
+
+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.
+
+L'orientation des hampes peut être définie manuellement -- voir
+@ref{Direction et positionnement} à ce sujet.
+
+
+@predefined
+@code{\stemUp},
+@code{\stemDown},
+@code{\stemNeutral}.
+@endpredefined
+
+
+@snippets
+
+@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
+{default-direction-of-stems-on-the-center-line-of-the-staff.ly}
+
+
+@seealso
+Manuel de notation :
+@ref{Direction et positionnement}.
+
+Morceaux choisis :
+@rlsrnamed{Editorial annotations,Annotations éditoriales}.
+
+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
+* Info-bulle::
+* Quadrillage temporel::
+* Crochets d'analyse::
+@end menu
+
+@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
+notation.
+
+En voici un exemple :
+@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
+ <c, g'-\balloonText #'(-2 . -2) \markup { "Je suis une tête de note" } c>2.
+}
+@end lilypond
+
+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@tie{}\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.
+
+Les info-bulles ont une influence sur les espacements, que l'on peut
+gérer ainsi@tie{}:
+
+@c KEEP LY
+@lilypond[verbatim,quote,relative=2]
+\new Voice \with { \consists "Balloon_engraver" }
+{
+ \balloonLengthOff
+ \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
+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
+
+@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.
+
+LilyPond a recours à deux graveurs distincts afin d'afficher le
+quadrillage@tie{}: 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
+@lilypond[verbatim,quote]
+\layout {
+ \context {
+ \Staff
+ \consists "Grid_point_engraver" %% active les guides
+ gridInterval = #(ly:make-moment 1 4)
+ }
+ \context {
+ \Score
+ \consists "Grid_line_span_engraver"
+ %% centre les lignes guides horizontalement sous les notes
+ }
+}
+
+\score {
+ \new ChoirStaff <<
+ \new Staff \relative c'' {
+ \stemUp
+ c'4. d8 e8 f g4
+ }
+ \new Staff \relative c {
+ %% centre les lignes guides verticalement
+ \clef bass
+ \stemDown
+ c4 g' f e
+ }
+ >>
+}
+@end lilypond
+
+@snippets
+
+@lilypondfile[verbatim,lilyquote,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 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
+
+@funindex Horizontal_bracket_engraver
+@funindex \startGroup
+@funindex startGroup
+@funindex \stopGroup
+@funindex stopGroup
+
+On utilise des crochets en analyse musicale, pour indiquer la
+structure d'une pièce.
+
+@lilypond[verbatim,quote]
+\layout {
+ \context {
+ \Voice
+ \consists "Horizontal_bracket_engraver"
+ }
+}
+\relative c'' {
+ c2\startGroup
+ d\stopGroup
+}
+@end lilypond
+
+Les crochets d'analyses sont susceptibles d'être imbriqués@tie{}:
+
+@lilypond[verbatim,quote]
+\layout {
+ \context {
+ \Voice
+ \consists "Horizontal_bracket_engraver"
+ }
+}
+\relative c'' {
+ c4\startGroup\startGroup
+ d4\stopGroup
+ e4\startGroup
+ d4\stopGroup\stopGroup
+}
+@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}.
+
projects / lilypond.git / blobdiff