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)
159 Référence du programme : @rinternals{Fingering}.
161 Exemples : @rlsr{Editorial annotations}.
165 @unnumberedsubsubsec Hidden notes
167 @cindex Masquées, notes
168 @cindex Invisibles, notes
169 @cindex Transparentes, notes
172 @funindex \unHideNotes
173 Les notes masquées --- ou invisibles ou encore transparentes --- sont
174 utiles dans le cadre d'exercices de théorie ou de composition.
176 @lilypond[quote,ragged-right,verbatim,relative=2,fragment]
185 @node Coloring objects
186 @unnumberedsubsubsec Coloring objects
188 Des objets peuvent être colorisés individuellement. Une listes des
189 noms des couleurs disponibles se trouvent à l'annexe @ref{List of colors}.
191 @lilypond[quote,ragged-right,verbatim,fragment,relative=1]
192 \override NoteHead #'color = #red
194 \override NoteHead #'color = #(x11-color 'LimeGreen)
196 \override Stem #'color = #blue
200 L'intégralité de la palette des couleurs définies pour X11 est
201 accessible par la fonction Scheme x11-color. Cette fonction prend
202 en argument une expression symbolique
205 \override Beam #'color = #(x11-color 'MediumTurquoise)
208 ou une chaîne de caractères
211 \override Beam #'color = #(x11-color "MediumTurquoise")
214 La première formulation est à la fois plus rapide à écrire et aussi
215 plus efficace. Néanmoins, la deuxième forme permet d'accéder aux noms
216 composés des couleurs de X11.
219 \override Beam #'color = #(x11-color "medium turquoise")
222 Lorsque la fonction x11-color ne trouve pas le paramètre fourni, elle
223 revient à la couleur par défaut, le noir. Le problème ressort de
224 façon évidente au vu de la partition finale.
226 L'exemple suivant illustre l'utilisation de la fonction
227 @code{x11-color}. Notez que, après avoir été définie à (x11-color
228 'Boggle), la couleur des hampes repasse au noir.
230 @lilypond[quote,ragged-right,verbatim]
232 \override Staff.StaffSymbol #'color = #(x11-color 'SlateBlue2)
233 \set Staff.instrumentName = \markup {
234 \with-color #(x11-color 'navy) "Clarinet"
238 \override Beam #'color = #(x11-color "medium turquoise")
240 \override NoteHead #'color = #(x11-color "LimeGreen")
242 \override Stem #'color = #(x11-color 'Boggle)
250 Annexes : @ref{List of colors}.
254 Les couleurs de X11 ne sont pas toutes perceptibles dans un navigateur
255 internet. Aussi nous vous recommandons, dans le cadre d'une
256 présentation multimedia, d'utiliser des couleurs de base.
258 Une couleur x11 n'aura pas forcément le même rendu qu'une couleur
259 normale ayant un nom similaire.
261 Vous ne pouvez pas coloriser des notes à l'intérieur d'un accord avec
262 @code{\override}. si besoin est, utilisez @code{\tweak}.
263 Pour plus de détails, consultez @ref{The tweak command}.
267 @unnumberedsubsubsec Parentheses
269 @cindex fantômes, notes
270 @cindex notes fantômes
271 @cindex parenthèses, notes entre
273 Des objets peuvent être mis entre parenthèses en saisissant
274 @code{\parenthesize} juste avant l'événement musical.
276 @lilypond[relative=2,fragment,verbatim,ragged-right]
284 Ceci n'est opérationnel que dans le cadre d'un accord, qui peut ne
285 comprendre qu'une seule note.
288 < \parenthesize NOTE>
293 @unnumberedsubsubsec Stems
295 Dès qu'une note est rencontrée, un objet @rinternals{Stem} se crée
296 automatiquement. Pour les rondes et les silences, ils sont aussi
297 créés, mais en mode invisible.
305 @funindex \stemNeutral
312 Pour changer la direction des hampes au milieu de la portée, utilisez
314 @lilypond[quote,ragged-right,fragment,relative=2,verbatim]
316 \override Stem #'neutral-direction = #up
318 \override Stem #'neutral-direction = #down
323 @node Outside the staff
324 @subsection Outside the staff
330 * Analysis brackets::
331 * Blank music sheet::
335 @unnumberedsubsubsec Balloon help
337 Vous pouvez marquer et nommer des éléments de notation à l'aide de
338 bulles. L'objectif premier de cette fonctionnalité est d'expliquer la
341 En voici un exemple :
343 @lilypond[quote,verbatim,fragment,ragged-right,relative=2]
344 \new Voice \with { \consists "Balloon_engraver" }
346 \balloonGrobText #'Stem #'(3 . 4) \markup { "Je suis une hampe" }
347 <c-\balloonText #'(-2 . -2) \markup { Hello } >8
352 Vous disposez de deux fonctions musicales, @code{balloonText} et
353 @code{balloonGrobText}. @code{balloonGrobText} prend en argument
354 l'objet graphique à agrémenter, alors que @code{balloonText} s'utilise
355 comme une simple articulation. Les autres arguments sont le décalage
356 et le texte de la bulle.
359 @cindex notation, expliquer
363 Référence du programme : @rinternals{balloon-interface}.
367 @unnumberedsubsubsec Grid lines
369 Vous pouvez tracer des lignes entre les portées, synchronisées avec
372 @lilypond[ragged-right,quote,verbatim]
376 \consists "Grid_point_engraver" %% active les guides
377 gridInterval = #(ly:make-moment 1 4)
382 \consists "Grid_line_span_engraver"
383 %% centre les lignes guides horizontalement sous les notes
384 \override NoteColumn #'X-offset = #-0.5
395 %% centre les lignes guides verticalement
396 \override Score.GridLine #'extra-offset = #'( 0.0 . 1.0 )
406 Exemples : @rlsr{Editorial annotations}.
409 @node Analysis brackets
410 @unnumberedsubsubsec Analysis brackets
412 @cindex crochets de phrasé
413 @cindex analyse musicologique
414 @cindex crochet de regroupement de notes
416 On utilise des crochets en analyse musicale, pour indiquer la
417 structure d'une pièce. LilyPond permet d'utiliser une forme
418 simplifiée de crochets horizontaux imbriqués, dans la mesure où le
419 contexte @rinternals{Staff} comporte le graveur
420 @rinternals{Horizontal_bracket_engraver}. Un crochet s'ouvre avec
421 @code{\startGroup}, et se ferme avec @code{\stopGroup}.
423 @lilypond[quote,ragged-right,verbatim]
426 c4\startGroup\startGroup
429 c4\stopGroup\stopGroup
433 \Staff \consists "Horizontal_bracket_engraver"
439 Référence du programme : @rinternals{HorizontalBracket}.
442 @node Blank music sheet
443 @unnumberedsubsubsec Blank music sheet
445 @cindex Papier musique
446 @cindex Portées, feuille blanche
448 Une feuille de papier musique s'obtient en utilisant des notes
449 invisibles, et en invalidant le @code{Bar_number_engraver}.
452 @lilypond[quote,verbatim]
453 \layout{ indent = #0 }
455 \repeat unfold 2 % À modifier pour plus de lignes.
460 \override TimeSignature #'transparent = ##t
461 % décommenter la ligne suivante selon besoin
462 % \override Clef #'transparent = ##t
464 \remove Bar_number_engraver
467 % à adapter selon les portées désirées
468 \new Staff \emptymusic
469 \new TabStaff \emptymusic