1 @c -*- coding: utf-8; mode: texinfo; -*-
3 Translation of GIT committish: 33ba8d40c3493011a4b39ab8b1369701f8013bd6
5 When revising a translation, copy the HEAD committish of the
6 version that you are working on. See TRANSLATION for details.
11 @c Translators: Jean-Charles Malahieude
13 @node Editorial annotations
14 @section Editorial annotations
16 @lilypondfile[quote]{editorial-headword.ly}
24 @node Inside the staff
25 @subsection Inside the staff
29 * Selecting notation font size::
30 * Fingering instructions::
37 @node Selecting notation font size
38 @unnumberedsubsubsec Selecting notation font size
40 Le plus sûr moyen de régler la taille de la police, quelque soit le
41 contexte, consiste à définir la propriété @code{fontSize}.
43 @lilypond[quote,fragment,relative=1,verbatim]
52 Ceci ne modifiera en rien la taille des différents symboles tels que
53 ligatures ou liaisons.
55 En interne, la propriété @code{fontSize} d'un contexte aura pour effet
56 de définir la propriété @code{font-size} pour tous les objets de
57 rendu. La valeur de @code{font-size} est un entier représentant la
58 taille proportionnellement à la hauteur standard de la portée en
59 cours. Chaque incrément correspond à une augmentation d'environ
60 12@tie{}% de la taille de la police. Un pas de six aboutit exactement
61 au doublement de la taille. La fonction Scheme @code{magstep}
62 convertit le nombre affecté à @code{font-size} en facteur d'échelle.
63 Vous pouvez aussi définir directement la propriété @code{font-size} de
64 manière à n'affecter seulement que certains objets de rendu.
66 @lilypond[quote,fragment,relative=1,verbatim]
68 \override NoteHead #'font-size = #-4
70 \override NoteHead #'font-size = #3
74 Pour changer la taille des symboles musicaux (police Feta), LilyPond met
75 à l'échelle la fonte dont la taille est la plus proche de la taille voulue ---
76 cf. @ref{Setting the staff size}. La taille standard, pour laquelle
77 @code{font-size} vaut 0, dépend de la hauteur de la portée. À une
78 portée de 20 points correspond une police de 10 points.
80 La propriété @code{font-size} ne peut intervenir que pour les objets
81 qui utilisent des polices, autrement dit ceux qui disposent de
82 l'interface de rendu @rinternals{font-interface}.
86 Les commandes suivantes définissent @code{fontSize} pour la voix en
97 @node Fingering instructions
98 @unnumberedsubsubsec Fingering instructions
101 @cindex substitution de doigt
104 Les doigtés peuvent être indiqués comme suit :
106 @var{note}-@var{chiffre_du_doigt}
108 Pour les substitutions de doigts, on a recours à une indication
109 textuelle (commande @code{\markup}) de doigté
110 (commande @code{\finger}).
112 @lilypond[quote,verbatim,ragged-right,fragment,relative=1]
114 c^\markup { \finger "2 - 3" }
118 La commande @code{\thumb} peut être utilisée pour indiquer, par exemple
119 dans une partition de violoncelle, si une note doit être jouée avec le
120 pouce (@q{thumb} en anglais).
122 @lilypond[quote,verbatim,ragged-right,fragment,relative=2]
123 <a_\thumb a'-3>8 <b_\thumb b'-3>
127 Les doigtés des accords peuvent être saisis note par note,
128 en les indiquant après chaque hauteur de note.
130 @lilypond[quote,verbatim,ragged-right,fragment,relative=2]
137 On peut contrôler précisément les doigtés des accords en réglant
138 la propriété @code{fingeringOrientations}.
140 @lilypond[quote,verbatim,ragged-right,fragment,relative=1]
141 \set fingeringOrientations = #'(left down)
142 <c-1 es-2 g-4 bes-5 > 4
143 \set fingeringOrientations = #'(up right down)
144 <c-1 es-2 g-4 bes-5 > 4
148 Cette propriété permet également, dans de la musique monophonique,
149 d'indiquer des doigtés très proches des têtes de notes.
151 @lilypond[verbatim,ragged-right,quote,fragment]
152 \set fingeringOrientations = #'(right)
158 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
159 {avoiding-collisions-with-chord-fingerings.ly}
163 Référence du programme : @rinternals{Fingering}.
165 Exemples : @rlsr{Editorial annotations}.
169 @unnumberedsubsubsec Hidden notes
171 @cindex Masquées, notes
172 @cindex Invisibles, notes
173 @cindex Transparentes, notes
176 @funindex \unHideNotes
177 Les notes masquées --- ou invisibles ou encore transparentes --- sont
178 utiles dans le cadre d'exercices de théorie ou de composition.
180 @lilypond[quote,ragged-right,verbatim,relative=2,fragment]
189 @node Coloring objects
190 @unnumberedsubsubsec Coloring objects
192 Des objets peuvent être colorisés individuellement. Une listes des
193 noms des couleurs disponibles se trouvent à l'annexe @ref{List of colors}.
195 @lilypond[quote,ragged-right,verbatim,fragment,relative=1]
196 \override NoteHead #'color = #red
198 \override NoteHead #'color = #(x11-color 'LimeGreen)
200 \override Stem #'color = #blue
204 L'intégralité de la palette des couleurs définies pour X11 est
205 accessible par la fonction Scheme x11-color. Cette fonction prend
206 en argument une expression symbolique
209 \override Beam #'color = #(x11-color 'MediumTurquoise)
212 ou une chaîne de caractères
215 \override Beam #'color = #(x11-color "MediumTurquoise")
218 La première formulation est à la fois plus rapide à écrire et aussi
219 plus efficace. Néanmoins, la deuxième forme permet d'accéder aux noms
220 composés des couleurs de X11.
223 \override Beam #'color = #(x11-color "medium turquoise")
226 Lorsque la fonction x11-color ne trouve pas le paramètre fourni, elle
227 revient à la couleur par défaut, le noir. Le problème ressort de
228 façon évidente au vu de la partition finale.
230 L'exemple suivant illustre l'utilisation de la fonction
231 @code{x11-color}. Notez que, après avoir été définie à (x11-color
232 'Boggle), la couleur des hampes repasse au noir.
234 @lilypond[quote,ragged-right,verbatim]
236 \override Staff.StaffSymbol #'color = #(x11-color 'SlateBlue2)
237 \set Staff.instrumentName = \markup {
238 \with-color #(x11-color 'navy) "Clarinet"
242 \override Beam #'color = #(x11-color "medium turquoise")
244 \override NoteHead #'color = #(x11-color "LimeGreen")
246 \override Stem #'color = #(x11-color 'Boggle)
253 Annexes : @ref{List of colors}.
257 Les couleurs de X11 ne sont pas toutes perceptibles dans un navigateur
258 internet. Aussi nous vous recommandons, dans le cadre d'une
259 présentation multimedia, d'utiliser des couleurs de base.
261 Une couleur x11 n'aura pas forcément le même rendu qu'une couleur
262 normale ayant un nom similaire.
264 Vous ne pouvez pas coloriser des notes à l'intérieur d'un accord avec
265 @code{\override}. si besoin est, utilisez @code{\tweak}.
266 Pour plus de détails, consultez @ref{The tweak command}.
270 @unnumberedsubsubsec Parentheses
272 @cindex fantômes, notes
273 @cindex notes fantômes
274 @cindex parenthèses, notes entre
276 Des objets peuvent être mis entre parenthèses en saisissant
277 @code{\parenthesize} juste avant l'événement musical.
279 @lilypond[relative=2,fragment,verbatim,ragged-right]
287 Ceci n'est opérationnel que dans le cadre d'un accord, qui peut ne
288 comprendre qu'une seule note.
291 < \parenthesize NOTE>
296 @unnumberedsubsubsec Stems
298 Dès qu'une note est rencontrée, un objet @rinternals{Stem} se crée
299 automatiquement. Pour les rondes et les silences, ils sont aussi
300 créés, mais en mode invisible.
308 @funindex \stemNeutral
315 Pour changer la direction des hampes au milieu de la portée, utilisez
317 @lilypond[quote,ragged-right,fragment,relative=2,verbatim]
319 \override Stem #'neutral-direction = #up
321 \override Stem #'neutral-direction = #down
326 @node Outside the staff
327 @subsection Outside the staff
333 * Analysis brackets::
334 * Blank music sheet::
338 @unnumberedsubsubsec Balloon help
340 Vous pouvez marquer et nommer des éléments de notation à l'aide de
341 bulles. L'objectif premier de cette fonctionnalité est d'expliquer la
344 En voici un exemple :
346 @lilypond[quote,verbatim,fragment,ragged-right,relative=2]
347 \new Voice \with { \consists "Balloon_engraver" }
349 \balloonGrobText #'Stem #'(3 . 4) \markup { "Je suis une hampe" }
350 <c-\balloonText #'(-2 . -2) \markup { Hello } >8
355 Vous disposez de deux fonctions musicales, @code{balloonText} et
356 @code{balloonGrobText}. @code{balloonGrobText} prend en argument
357 l'objet graphique à agrémenter, alors que @code{balloonText} s'utilise
358 comme une simple articulation. Les autres arguments sont le décalage
359 et le texte de la bulle.
362 @cindex notation, expliquer
366 Référence du programme : @rinternals{balloon-interface}.
370 @unnumberedsubsubsec Grid lines
372 Vous pouvez tracer des lignes entre les portées, synchronisées avec
375 @lilypond[ragged-right,quote,verbatim]
379 \consists "Grid_point_engraver" %% active les guides
380 gridInterval = #(ly:make-moment 1 4)
385 \consists "Grid_line_span_engraver"
386 %% centre les lignes guides horizontalement sous les notes
387 \override NoteColumn #'X-offset = #-0.5
398 %% centre les lignes guides verticalement
399 \override Score.GridLine #'extra-offset = #'( 0.0 . 1.0 )
409 Exemples : @rlsr{Editorial annotations}.
412 @node Analysis brackets
413 @unnumberedsubsubsec Analysis brackets
415 @cindex crochets de phrasé
416 @cindex analyse musicologique
417 @cindex crochet de regroupement de notes
419 On utilise des crochets en analyse musicale, pour indiquer la
420 structure d'une pièce. LilyPond permet d'utiliser une forme
421 simplifiée de crochets horizontaux imbriqués, dans la mesure où le
422 contexte @rinternals{Staff} comporte le graveur
423 @rinternals{Horizontal_bracket_engraver}. Un crochet s'ouvre avec
424 @code{\startGroup}, et se ferme avec @code{\stopGroup}.
426 @lilypond[quote,ragged-right,verbatim]
429 c4\startGroup\startGroup
432 c4\stopGroup\stopGroup
436 \Staff \consists "Horizontal_bracket_engraver"
442 Référence du programme : @rinternals{HorizontalBracket}.
445 @node Blank music sheet
446 @unnumberedsubsubsec Blank music sheet
448 @cindex Papier musique
449 @cindex Portées, feuille blanche
451 Une feuille de papier musique s'obtient en utilisant des notes
452 invisibles, et en invalidant le @code{Bar_number_engraver}.
455 @lilypond[quote,verbatim]
456 \layout{ indent = #0 }
458 \repeat unfold 2 % À modifier pour plus de lignes.
463 \override TimeSignature #'transparent = ##t
464 % décommenter la ligne suivante selon besoin
465 % \override Clef #'transparent = ##t
467 \remove Bar_number_engraver
470 % à adapter selon les portées désirées
471 \new Staff \emptymusic
472 \new TabStaff \emptymusic