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 Référence du programme : @rinternals{Fingering}.
160 Exemples : @rlsr{Editorial annotations}.
164 @unnumberedsubsubsec Hidden notes
166 @cindex Masquées, notes
167 @cindex Invisibles, notes
168 @cindex Transparentes, notes
171 @funindex \unHideNotes
172 Les notes masquées --- ou invisibles ou encore transparentes --- sont
173 utiles dans le cadre d'exercices de théorie ou de composition.
175 @lilypond[quote,ragged-right,verbatim,relative=2,fragment]
184 @node Coloring objects
185 @unnumberedsubsubsec Coloring objects
187 Des objets peuvent être colorisés individuellement. Une listes des
188 noms des couleurs disponibles se trouvent à l'annexe @ref{List of colors}.
190 @lilypond[quote,ragged-right,verbatim,fragment,relative=1]
191 \override NoteHead #'color = #red
193 \override NoteHead #'color = #(x11-color 'LimeGreen)
195 \override Stem #'color = #blue
199 L'intégralité de la palette des couleurs définies pour X11 est
200 accessible par la fonction Scheme x11-color. Cette fonction prend
201 en argument une expression symbolique
204 \override Beam #'color = #(x11-color 'MediumTurquoise)
207 ou une chaîne de caractères
210 \override Beam #'color = #(x11-color "MediumTurquoise")
213 La première formulation est à la fois plus rapide à écrire et aussi
214 plus efficace. Néanmoins, la deuxième forme permet d'accéder aux noms
215 composés des couleurs de X11.
218 \override Beam #'color = #(x11-color "medium turquoise")
221 Lorsque la fonction x11-color ne trouve pas le paramètre fourni, elle
222 revient à la couleur par défaut, le noir. Le problème ressort de
223 façon évidente au vu de la partition finale.
225 L'exemple suivant illustre l'utilisation de la fonction
226 @code{x11-color}. Notez que, après avoir été définie à (x11-color
227 'Boggle), la couleur des hampes repasse au noir.
229 @lilypond[quote,ragged-right,verbatim]
231 \override Staff.StaffSymbol #'color = #(x11-color 'SlateBlue2)
232 \set Staff.instrumentName = \markup {
233 \with-color #(x11-color 'navy) "Clarinet"
237 \override Beam #'color = #(x11-color "medium turquoise")
239 \override NoteHead #'color = #(x11-color "LimeGreen")
241 \override Stem #'color = #(x11-color 'Boggle)
248 Annexes : @ref{List of colors}.
252 Les couleurs de X11 ne sont pas toutes perceptibles dans un navigateur
253 internet. Aussi nous vous recommandons, dans le cadre d'une
254 présentation multimedia, d'utiliser des couleurs de base.
256 Une couleur x11 n'aura pas forcément le même rendu qu'une couleur
257 normale ayant un nom similaire.
259 Vous ne pouvez pas coloriser des notes à l'intérieur d'un accord avec
260 @code{\override}. si besoin est, utilisez @code{\tweak}.
261 Pour plus de détails, consultez @ref{The tweak command}.
265 @unnumberedsubsubsec Parentheses
267 @cindex fantômes, notes
268 @cindex notes fantômes
269 @cindex parenthèses, notes entre
271 Des objets peuvent être mis entre parenthèses en saisissant
272 @code{\parenthesize} juste avant l'événement musical.
274 @lilypond[relative=2,fragment,verbatim,ragged-right]
282 Ceci n'est opérationnel que dans le cadre d'un accord, qui peut ne
283 comprendre qu'une seule note.
286 < \parenthesize NOTE>
291 @unnumberedsubsubsec Stems
293 Dès qu'une note est rencontrée, un objet @rinternals{Stem} se crée
294 automatiquement. Pour les rondes et les silences, ils sont aussi
295 créés, mais en mode invisible.
303 @funindex \stemNeutral
310 Pour changer la direction des hampes au milieu de la portée, utilisez
312 @lilypond[quote,ragged-right,fragment,relative=2,verbatim]
314 \override Stem #'neutral-direction = #up
316 \override Stem #'neutral-direction = #down
321 @node Outside the staff
322 @subsection Outside the staff
328 * Analysis brackets::
329 * Blank music sheet::
333 @unnumberedsubsubsec Balloon help
335 Vous pouvez marquer et nommer des éléments de notation à l'aide de
336 bulles. L'objectif premier de cette fonctionnalité est d'expliquer la
339 En voici un exemple :
341 @lilypond[quote,verbatim,fragment,ragged-right,relative=2]
342 \new Voice \with { \consists "Balloon_engraver" }
344 \balloonGrobText #'Stem #'(3 . 4) \markup { "Je suis une hampe" }
345 <c-\balloonText #'(-2 . -2) \markup { Hello } >8
350 Vous disposez de deux fonctions musicales, @code{balloonText} et
351 @code{balloonGrobText}. @code{balloonGrobText} prend en argument
352 l'objet graphique à agrémenter, alors que @code{balloonText} s'utilise
353 comme une simple articulation. Les autres arguments sont le décalage
354 et le texte de la bulle.
357 @cindex notation, expliquer
361 Référence du programme : @rinternals{balloon-interface}.
365 @unnumberedsubsubsec Grid lines
367 Vous pouvez tracer des lignes entre les portées, synchronisées avec
370 @lilypond[ragged-right,quote,verbatim]
374 \consists "Grid_point_engraver" %% active les guides
375 gridInterval = #(ly:make-moment 1 4)
380 \consists "Grid_line_span_engraver"
381 %% centre les lignes guides horizontalement sous les notes
382 \override NoteColumn #'X-offset = #-0.5
393 %% centre les lignes guides verticalement
394 \override Score.GridLine #'extra-offset = #'( 0.0 . 1.0 )
404 Exemples : @rlsr{Editorial annotations}.
407 @node Analysis brackets
408 @unnumberedsubsubsec Analysis brackets
410 @cindex crochets de phrasé
411 @cindex analyse musicologique
412 @cindex crochet de regroupement de notes
414 On utilise des crochets en analyse musicale, pour indiquer la
415 structure d'une pièce. LilyPond permet d'utiliser une forme
416 simplifiée de crochets horizontaux imbriqués, dans la mesure où le
417 contexte @rinternals{Staff} comporte le graveur
418 @rinternals{Horizontal_bracket_engraver}. Un crochet s'ouvre avec
419 @code{\startGroup}, et se ferme avec @code{\stopGroup}.
421 @lilypond[quote,ragged-right,verbatim]
424 c4\startGroup\startGroup
427 c4\stopGroup\stopGroup
431 \Staff \consists "Horizontal_bracket_engraver"
437 Référence du programme : @rinternals{HorizontalBracket}.
440 @node Blank music sheet
441 @unnumberedsubsubsec Blank music sheet
443 @cindex Papier musique
444 @cindex Portées, feuille blanche
446 Une feuille de papier musique s'obtient en utilisant des notes
447 invisibles, et en invalidant le @code{Bar_number_engraver}.
450 @lilypond[quote,verbatim]
451 \layout{ indent = #0 }
453 \repeat unfold 2 % À modifier pour plus de lignes.
458 \override TimeSignature #'transparent = ##t
459 % décommenter la ligne suivante selon besoin
460 % \override Clef #'transparent = ##t
462 \remove Bar_number_engraver
465 % à adapter selon les portées désirées
466 \new Staff \emptymusic
467 \new TabStaff \emptymusic