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::
38 @node Selecting notation font size
39 @unnumberedsubsubsec Selecting notation font size
41 Le plus sûr moyen de régler la taille de la police, quelque soit le
42 contexte, consiste à définir la propriété @code{fontSize}.
44 @lilypond[quote,fragment,relative=1,verbatim]
53 Ceci ne modifiera en rien la taille des différents symboles tels que
54 ligatures ou liaisons.
56 En interne, la propriété @code{fontSize} d'un contexte aura pour effet
57 de définir la propriété @code{font-size} pour tous les objets de
58 rendu. La valeur de @code{font-size} est un entier représentant la
59 taille proportionnellement à la hauteur standard de la portée en
60 cours. Chaque incrément correspond à une augmentation d'environ
61 12@tie{}% de la taille de la police. Un pas de six aboutit exactement
62 au doublement de la taille. La fonction Scheme @code{magstep}
63 convertit le nombre affecté à @code{font-size} en facteur d'échelle.
64 Vous pouvez aussi définir directement la propriété @code{font-size} de
65 manière à n'affecter seulement que certains objets de rendu.
67 @lilypond[quote,fragment,relative=1,verbatim]
69 \override NoteHead #'font-size = #-4
71 \override NoteHead #'font-size = #3
75 Pour changer la taille des symboles musicaux (police Feta), LilyPond met
76 à l'échelle la fonte dont la taille est la plus proche de la taille voulue ---
77 cf. @ref{Setting the staff size}. La taille standard, pour laquelle
78 @code{font-size} vaut 0, dépend de la hauteur de la portée. À une
79 portée de 20 points correspond une police de 10 points.
81 La propriété @code{font-size} ne peut intervenir que pour les objets
82 qui utilisent des polices, autrement dit ceux qui disposent de
83 l'interface de rendu @rinternals{font-interface}.
87 Les commandes suivantes définissent @code{fontSize} pour la voix en
99 @node Fingering instructions
100 @unnumberedsubsubsec Fingering instructions
103 @cindex substitution de doigt
106 Les doigtés peuvent être indiqués comme suit :
108 @var{note}-@var{chiffre_du_doigt}
110 Pour les substitutions de doigts, on a recours à une indication
111 textuelle (commande @code{\markup}) de doigté
112 (commande @code{\finger}).
114 @lilypond[quote,verbatim,ragged-right,fragment,relative=1]
116 c^\markup { \finger "2 - 3" }
120 La commande @code{\thumb} peut être utilisée pour indiquer, par exemple
121 dans une partition de violoncelle, si une note doit être jouée avec le
122 pouce (@q{thumb} en anglais).
124 @lilypond[quote,verbatim,ragged-right,fragment,relative=2]
125 <a_\thumb a'-3>8 <b_\thumb b'-3>
129 Les doigtés des accords peuvent être saisis note par note,
130 en les indiquant après chaque hauteur de note.
132 @lilypond[quote,verbatim,ragged-right,fragment,relative=2]
139 On peut contrôler précisément les doigtés des accords en réglant
140 la propriété @code{fingeringOrientations}.
142 @lilypond[quote,verbatim,ragged-right,fragment,relative=1]
143 \set fingeringOrientations = #'(left down)
144 <c-1 es-2 g-4 bes-5 > 4
145 \set fingeringOrientations = #'(up right down)
146 <c-1 es-2 g-4 bes-5 > 4
150 Cette propriété permet également, dans de la musique monophonique,
151 d'indiquer des doigtés très proches des têtes de notes.
153 @lilypond[verbatim,ragged-right,quote,fragment]
154 \set fingeringOrientations = #'(right)
161 Référence du programme : @rinternals{Fingering}.
163 Exemples : @rlsr{Editorial annotations}.
167 @unnumberedsubsubsec Hidden notes
169 @cindex Masquées, notes
170 @cindex Invisibles, notes
171 @cindex Transparentes, notes
174 @funindex \unHideNotes
175 Les notes masquées --- ou invisibles ou encore transparentes --- sont
176 utiles dans le cadre d'exercices de théorie ou de composition.
178 @lilypond[quote,ragged-right,verbatim,relative=2,fragment]
187 @node Coloring objects
188 @unnumberedsubsubsec Coloring objects
190 Des objets peuvent être colorisés individuellement. Une listes des
191 noms des couleurs disponibles se trouvent à l'annexe @ref{List of colors}.
193 @lilypond[quote,ragged-right,verbatim,fragment,relative=1]
194 \override NoteHead #'color = #red
196 \override NoteHead #'color = #(x11-color 'LimeGreen)
198 \override Stem #'color = #blue
202 L'intégralité de la palette des couleurs définies pour X11 est
203 accessible par la fonction Scheme x11-color. Cette fonction prend
204 en argument une expression symbolique
207 \override Beam #'color = #(x11-color 'MediumTurquoise)
210 ou une chaîne de caractères
213 \override Beam #'color = #(x11-color "MediumTurquoise")
216 La première formulation est à la fois plus rapide à écrire et aussi
217 plus efficace. Néanmoins, la deuxième forme permet d'accéder aux noms
218 composés des couleurs de X11.
221 \override Beam #'color = #(x11-color "medium turquoise")
224 Lorsque la fonction x11-color ne trouve pas le paramètre fourni, elle
225 revient à la couleur par défaut, le noir. Le problème ressort de
226 façon évidente au vu de la partition finale.
228 L'exemple suivant illustre l'utilisation de la fonction
229 @code{x11-color}. Notez que, après avoir été définie à (x11-color
230 'Boggle), la couleur des hampes repasse au noir.
232 @lilypond[quote,ragged-right,verbatim]
234 \override Staff.StaffSymbol #'color = #(x11-color 'SlateBlue2)
235 \set Staff.instrumentName = \markup {
236 \with-color #(x11-color 'navy) "Clarinet"
240 \override Beam #'color = #(x11-color "medium turquoise")
242 \override NoteHead #'color = #(x11-color "LimeGreen")
244 \override Stem #'color = #(x11-color 'Boggle)
252 Annexes : @ref{List of colors}.
256 Les couleurs de X11 ne sont pas toutes perceptibles dans un navigateur
257 internet. Aussi nous vous recommandons, dans le cadre d'une
258 présentation multimedia, d'utiliser des couleurs de base.
260 Une couleur x11 n'aura pas forcément le même rendu qu'une couleur
261 normale ayant un nom similaire.
263 Vous ne pouvez pas coloriser des notes à l'intérieur d'un accord avec
264 @code{\override}. si besoin est, utilisez @code{\tweak}.
265 Pour plus de détails, consultez @ref{Objects connected to the input}.
269 @unnumberedsubsubsec Parentheses
271 @cindex fantômes, notes
272 @cindex notes fantômes
273 @cindex parenthèses, notes entre
275 Des objets peuvent être mis entre parenthèses en saisissant
276 @code{\parenthesize} juste avant l'événement musical.
278 @lilypond[relative=2,fragment,verbatim,ragged-right]
286 Ceci n'est opérationnel que dans le cadre d'un accord, qui peut ne
287 comprendre qu'une seule note.
290 < \parenthesize NOTE>
295 @unnumberedsubsubsec Ambitus
298 L'@emph{ambitus} est l'amplitude des hauteurs d'une voix donnée dans une
299 partition. Ce terme peut aussi désigner la tessiture qu'un instrument
300 est capable d'atteindre. Souvent, cet ambitus est imprimé au début des
301 partitions vocales, afin que les exécutants puissent voir au premier
302 coup d'oeil s'ils sont en mesure de tenir la partie en question.
304 Pour exprimer l'ambitus d'une pièce, on indique avant la clé deux notes
305 représentant la hauteur la plus basse et la plus haute. Pour imprimer
306 cet ambitus, il faut ajouter le graveur @rinternals{Ambitus_engraver}
307 au contexte @rinternals{Voice}. Ainsi,
313 \consists Ambitus_engraver
321 @lilypond[quote,ragged-right]
325 \consists Ambitus_engraver
329 \relative \new Staff {
334 Si plusieurs voix se trouvent sur une même portée, on peut attribuer le
335 graveur @rinternals{Ambitus_engraver} au contexte @rinternals{Staff}
336 plutôt qu'au contexte @rinternals{Voice} ; l'ambitus affiché sera
337 alors celui de toutes les voix cumulées, non d'une seule des voix
340 @lilypond[verbatim,ragged-right,quote]
342 \consists "Ambitus_engraver"
346 \remove "Ambitus_engraver"
348 \override Ambitus #'X-offset = #-1.0
353 \remove "Ambitus_engraver"
362 Cet exemple met en œuvre une fonctionnalité avancée :
365 \override Ambitus #'X-offset = #-1.0
369 Ce réglage déplace l'ambitus vers la gauche. Le même résultat aurait pu
370 être obtenu avec @code{extra-offset}, mais alors le système de mise en
371 forme n'aurait pas attribué d'espace supplémentaire pour l'objet
376 Référence du programme : @rinternals{Ambitus},
377 @rinternals{AmbitusLine}, @rinternals{AmbitusNoteHead},
378 @rinternals{AmbitusAccidental}.
380 Exemples : @rlsr{Pitches}, @rlsr{Vocal music}.
384 LilyPond ne gère pas les collisions entre plusieurs ambitus présents sur
389 @unnumberedsubsubsec Stems
391 Dès qu'une note est rencontrée, un objet @rinternals{Stem} se crée
392 automatiquement. Pour les rondes et les silences, ils sont aussi
393 créés, mais en mode invisible.
401 @funindex \stemNeutral
407 Pour changer la direction des hampes au milieu de la portée, utilisez
409 @lilypond[quote,ragged-right,fragment,relative=2,verbatim]
411 \override Stem #'neutral-direction = #up
413 \override Stem #'neutral-direction = #down
418 @node Outside the staff
419 @subsection Outside the staff
425 * Analysis brackets::
426 * Blank music sheet::
430 @unnumberedsubsubsec Balloon help
432 Vous pouvez marquer et nommer des éléments de notation à l'aide de
433 bulles. L'objectif premier de cette fonctionnalité est d'expliquer la
436 En voici un exemple :
438 @lilypond[quote,verbatim,fragment,ragged-right,relative=2]
439 \new Voice \with { \consists "Balloon_engraver" }
441 \balloonGrobText #'Stem #'(3 . 4) \markup { "Je suis une hampe" }
442 <c-\balloonText #'(-2 . -2) \markup { Hello } >8
447 Vous disposez de deux fonctions musicales, @code{balloonText} et
448 @code{balloonGrobText}. @code{balloonGrobText} prend en argument
449 l'objet graphique à agrémenter, alors que @code{balloonText} s'utilise
450 comme une simple articulation. Les autres arguments sont le décalage
451 et le texte de la bulle.
454 @cindex notation, expliquer
458 Référence du programme : @rinternals{text-balloon-interface}.
462 @unnumberedsubsubsec Grid lines
464 Vous pouvez tracer des lignes entre les portées, synchronisées avec
467 @lilypond[ragged-right,quote,verbatim]
471 \consists "Grid_point_engraver" %% active les guides
472 gridInterval = #(ly:make-moment 1 4)
477 \consists "Grid_line_span_engraver"
478 %% centre les lignes guides horizontalement sous les notes
479 \override NoteColumn #'X-offset = #-0.5
490 %% centre les lignes guides verticalement
491 \override Score.GridLine #'extra-offset = #'( 0.0 . 1.0 )
501 Exemples : @rlsr{Editorial annotations}.
504 @node Analysis brackets
505 @unnumberedsubsubsec Analysis brackets
507 @cindex crochets de phrasé
508 @cindex analyse musicologique
509 @cindex crochet de regroupement de notes
511 On utilise des crochets en analyse musicale, pour indiquer la
512 structure d'une pièce. LilyPond permet d'utiliser une forme
513 simplifiée de crochets horizontaux imbriqués, dans la mesure où le
514 contexte @rinternals{Staff} comporte le graveur
515 @rinternals{Horizontal_bracket_engraver}. Un crochet s'ouvre avec
516 @code{\startGroup}, et se ferme avec @code{\stopGroup}.
518 @lilypond[quote,ragged-right,verbatim]
521 c4\startGroup\startGroup
524 c4\stopGroup\stopGroup
528 \Staff \consists "Horizontal_bracket_engraver"
534 Référence du programme : @rinternals{HorizontalBracket}.
537 @node Blank music sheet
538 @unnumberedsubsubsec Blank music sheet
540 @cindex Papier musique
541 @cindex Portées, feuille blanche
543 Une feuille de papier musique s'obtient en utilisant des notes
544 invisibles, et en invalidant le @code{Bar_number_engraver}.
547 @lilypond[quote,verbatim]
548 \layout{ indent = #0 }
550 \repeat unfold 2 % À modifier pour plus de lignes.
555 \override TimeSignature #'transparent = ##t
556 % décommenter la ligne suivante selon besoin
557 % \override Clef #'transparent = ##t
559 \remove Bar_number_engraver
562 % à adapter selon les portées désirées
563 \new Staff \emptymusic
564 \new TabStaff \emptymusic