1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
3 Translation of GIT committish: 0f93dd92ffa0319328e58148458d22c5448b3d58
5 When revising a translation, copy the HEAD committish of the
6 version that you are working on. For details, see the Contributors'
7 Guide, node Updating translation committishes..
12 @c Translators: Jean-Charles Malahieude
13 @c Translation checkers: Valentin Villenave, John Mandereau
19 @lilypondfile[quote]{text-headword.ly}
21 Nous allons voir ici comment insérer du texte dans une partition, ainsi
22 que différentes manières de le mettre en forme.
25 Certains éléments de texte ne sont pas abordés ici mais dans des
26 chapitres qui leur sont dédiés. C'est le cas de la
27 @ref{Musique vocale} et des @ref{Titres et entêtes}.
31 * Mise en forme du texte::
37 @subsection Ajout de texte
38 @translationof Writing text
40 Cette partie constitue une introduction aux différentes manières
41 d'ajouter du texte à une partition.
43 @cindex Texte, autres langues
44 @warning{Pour écrire des accents et autres caractères spéciaux, il
45 suffit de les insérer directement dans votre fichier LilyPond. Ce
46 fichier devra être sauvegardé avec l'encodage UTF-8. Pour plus
47 d'informations, voir @ref{Codage du texte}.}
50 * Commentaires textuels::
51 * Indication textuelle avec extension::
52 * Indications textuelles::
57 @node Commentaires textuels
58 @unnumberedsubsubsec Commentaires textuels
59 @translationof Text scripts
61 @cindex Étiquette de texte
62 @cindex blocs de texte
63 @cindex ajout de texte
65 Vous pouvez ajouter à une partition des indications sous forme textuelle,
66 comme dans l'exemple suivant. Ces indications se placeront manuellement
67 au-dessus ou au-dessous de la portée selon la syntaxe utilisée -- cf.
68 @ref{Direction et positionnement}.
70 @lilypond[quote,verbatim,relative=2]
71 a8^"pizz." g f e a4-"scherz." f
74 Cette syntaxe est en fait un raccourci. Des constructions plus
75 élaborées d'annotation peuvent être obtenues en ayant recours à un bloc
76 @code{\markup} et selon les préceptes énoncés dans
77 @ref{Mise en forme du texte}.
79 @lilypond[quote,verbatim,relative=2]
80 a8^\markup { \italic pizz. } g f e
81 a4_\markup { \tiny scherz. \bold molto } f
84 Par défaut, ces indications n'affectent en rien l'espacement des
85 notes. Leur longueur peut néanmoins être prise en considération@tie{}:
86 dans l'exemple qui suit, le premier commentaire n'influe pas sur
87 l'espacement, à l'inverse du second.
89 @lilypond[quote,verbatim,relative=2]
95 En plus d'indications textuelles, les notes peuvent se voir attacher des
96 articulations, comme indiqué au chapitre
97 @ref{Articulations et ornements}.
99 Pour de plus amples détails sur la manière de combiner indications
100 textuelles et articulations, reportez-vous au chapitre
101 @rlearning{Positionnement des objets}.
103 @funindex \textLengthOn
104 @funindex textLengthOn
105 @funindex \textLengthOff
106 @funindex textLengthOff
109 @code{\textLengthOn},
110 @code{\textLengthOff}.
114 Manuel d'initiation :
115 @rlearning{Positionnement des objets}.
118 @ref{Mise en forme du texte},
119 @ref{Direction et positionnement},
120 @ref{Articulations et ornements}.
123 @rlsrnamed{Text,Texte}.
125 Référence des propriétés internes :
126 @rinternals{TextScript}.
128 @cindex texte hors marges
129 @cindex marges, texte qui dépasse
130 @cindex texte, maintien dans les marges
131 @cindex texte, maintien dans les marges
134 S'assurer que tous les éléments textuels et les paroles respectent
135 les marges du document requiert des calculs relativement lourds@tie{};
136 vous pouvez toutefois vous en affranchir en ajoutant
139 \override Score.PaperColumn #'keep-inside-line = ##f
143 @node Indication textuelle avec extension
144 @unnumberedsubsubsec Indication textuelle avec extension
145 @translationof Text spanners
147 @cindex texte et extenseur
148 @cindex prolongation de texte
151 Certaines indications d'interprétation comme @emph{rallentando},
152 @emph{accelerando} ou @emph{trilles}, s'inscrivent textuellement et se
153 prolongent sur plusieurs notes à l'aide d'une ligne pleine, pointillée
154 ou ondulée. Ces objets, que l'on appelle @qq{extenseurs}, se dessinent
155 entre deux notes à l'aide de la syntaxe suivante@tie{}:
157 @lilypond[verbatim,quote,relative=2]
158 \override TextSpanner #'(bound-details left text) = "rit."
163 @cindex texte, mise en forme des prolongations
164 @cindex texte, mise en forme des extenseurs
165 @cindex extenseur, mise en forme
168 Le texte à imprimer est spécifié en tant que propriété de l'objet
169 @code{TextSpanner}. Il apparaîtra par défaut en italique@tie{};
170 cependant, rien ne s'oppose à un autre graphisme dès lors que vous
171 faites appel à un bloc @code{\markup} --
172 voir @ref{Mise en forme du texte}.
174 @lilypond[quote,relative=2,verbatim]
175 \override TextSpanner #'(bound-details left text) =
176 \markup { \upright "rit." }
181 Le style de ligne se définit lui aussi comme une propriété de l'objet.
182 Les détails concernant la syntaxe à utiliser sont expliqués au chapitre
183 @ref{Styles de ligne}.
185 @funindex \textSpannerUp
186 @funindex textSpannerUp
187 @funindex \textSpannerDown
188 @funindex textSpannerDown
189 @funindex \textSpannerNeutral
190 @funindex textSpannerNeutral
193 @code{\textSpannerUp},
194 @code{\textSpannerDown},
195 @code{\textSpannerNeutral}.
199 @lilypondfile[verbatim,quote,texidoc,doctitle]
200 {dynamics-text-spanner-postfix.ly}
202 @lilypondfile[verbatim,quote,texidoc,doctitle]
203 {dynamics-custom-text-spanner-postfix.ly}
207 @ref{Styles de ligne},
209 @ref{Mise en forme du texte}.
212 @rlsrnamed{Text,Texte},
213 @rlsrnamed{Expressive marks,Signes d'interprétation}.
215 Référence des propriétés internes :
216 @rinternals{TextSpanner}.
219 LilyPond ne peut traiter qu'un seul extenseur à la fois par voix.
222 @node Indications textuelles
223 @unnumberedsubsubsec Indications textuelles
224 @translationof Text marks
226 @cindex indication textuelle
227 @cindex coda sur une barre de mesure
228 @cindex segno sur une barre de mesure
229 @cindex point d'orgue sur une barre de mesure
230 @cindex barres de mesure, symboles au dessus de
237 La commande @code{\mark} est tout d'abord conçue pour les
238 @ref{Indications de repère}.
240 @c \mark needs to be placed on a separate line (it's not
241 @c attached to an object like \markup is). -vv
243 @lilypond[verbatim,quote,relative=2]
249 Cette syntaxe rend possible l'adjonction de n'importe quel texte à une
250 barre de mesure. Ce texte peut être mis en forme de différentes
251 manières dès lors qu'est utilisé un bloc @code{\markup}, comme indiqué
252 au chapitre @ref{Mise en forme du texte}.
254 @lilypond[quote,verbatim,relative=1]
256 \mark \markup { \italic { colla parte } }
262 Elle peut aussi servir à insérer des signes de @emph{coda} ou de
263 @emph{segno}, ou bien un point d'orgue, au dessus d'une
264 barre de mesure. Couplez-la alors à la commande @code{\markup} pour
265 avoir accès au symbole approprié, selon les indications contenues au
266 chapitre @ref{Notation musicale dans du texte formaté}.
268 @lilypond[quote,verbatim,relative=2]
270 \mark \markup { \musicglyph #"scripts.ufermata" }
275 Le résultat de @code{\mark} n'apparaîtra que sur la portée supérieure
276 d'un système. Si vous introduisez la commande @code{\mark} au moment
277 d'une barre de mesure, la marque se placera au dessus de la barre. Si
278 vous y faites appel au milieu d'une mesure, cette marque sera
279 positionnée entre les notes. Si elle intervient en début de ligne,
280 elle sera placée juste avant la première note de cette portée. Enfin,
281 une marque qui tomberait sur un saut de ligne sera imprimée au début
282 de la ligne suivante.
284 @lilypond[quote,verbatim,relative=2]
292 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
293 {printing-marks-at-the-end-of-a-line.ly}
295 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
296 {aligning-marks-with-various-notation-objects.ly}
298 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
299 {printing-marks-on-every-staff.ly}
303 @ref{Indications de repère},
304 @ref{Mise en forme du texte},
305 @ref{Notation musicale dans du texte formaté},
309 @rlsrnamed{Text,Texte}.
311 Référence des propriétés internes :
312 @rinternals{MarkEvent},
313 @rinternals{Mark_engraver},
314 @rinternals{RehearsalMark}.
317 @node Texte indépendant
318 @unnumberedsubsubsec Texte indépendant
319 @translationof Separate text
321 @cindex texte indépendant
323 @cindex texte en préambule
324 @cindex top-level, texte
325 @cindex texte, top-level
326 @cindex indépendant, texte
331 Un bloc @code{\markup} peut exister en lui-même, indépendamment de tout
332 bloc @code{\score}, et venir en préambule par exemple -- voir le
333 chapitre @ref{Structure de fichier} à ce propos.
335 @lilypond[verbatim,quote]
337 Tomorrow, and tomorrow, and tomorrow...
342 De cette manière, vous pouvez insérer du texte en dehors de la musique.
343 Ceci devient particulièrement utile lorsque le fichier source contient
344 plusieurs morceaux. Pour plus d'informations à ce propos, reportez-vous
345 au chapitre @ref{Plusieurs partitions dans un même ouvrage}.
347 @lilypond[quote,verbatim]
352 Tomorrow, and tomorrow, and tomorrow...
359 Les blocs de textes peuvent s'étendre sur plusieurs pages, ce qui permet
360 de générer des ouvrages complets uniquement grâce à LilyPond. Cette
361 fonctionnalité, ainsi que la syntaxe appropriée, est abordée plus en
362 détail au chapitre @ref{Texte avec sauts de page}.
366 @funindex \markuplist
375 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
376 {stand-alone-two-column-markup.ly}
380 @ref{Mise en forme du texte},
381 @ref{Structure de fichier},
382 @ref{Plusieurs partitions dans un même ouvrage},
383 @ref{Texte avec sauts de page}.
386 @rlsrnamed{Text,Texte}.
388 Référence des propriétés internes :
389 @rinternals{TextScript}.
392 @node Mise en forme du texte
393 @subsection Mise en forme du texte
394 @translationof Formatting text
396 Nous allons voir dans les lignes qui suivent la manière de mettre en
397 forme du texte à l'aide de la syntaxe propre au mode @code{\markup}.
400 * Introduction au formatage de texte::
401 * Sélection de la fonte et de la taille::
402 * Alignement du texte::
403 * Éléments graphiques dans du texte formaté::
404 * Notation musicale dans du texte formaté::
405 * Texte avec sauts de page::
409 @node Introduction au formatage de texte
410 @unnumberedsubsubsec Introduction au formatage de texte
411 @translationof Text markup introduction
414 @cindex commentaire textuel
415 @cindex étiquette textuelle
421 La commande @code{\markup} permet d'ajouter du texte et dispose de sa
422 propre syntaxe que nous appellerons le @qq{mode @emph{markup}}.
424 @cindex markup, expressions
425 @cindex expressions markup
426 @cindex markup, syntaxe
427 @cindex syntaxe du mode markup
429 La syntaxe du mode @emph{markup} n'est pas différente de celle des
430 autres modes de LilyPond@tie{}: une expression @code{\markup} est bornée
431 par des accolades @code{@{@tie{}@dots{}@tie{}@}}. Un mot unique sera
432 considéré comme une expression minimale, et n'aura donc pas besoin
433 d'être mis entre accolades.
435 Contrairement aux indications simples, du type "entre guillemets", les
436 blocs @code{\markup} peuvent contenir des expressions imbriquées ou
437 d'autres commandes @emph{markup}, dès lors qu'elles sont précédées du
438 caractère@tie{}@code{\}. Ces commandes n'affecteront que la première
439 expression qui les suit.
441 @lilypond[quote,verbatim,relative=2]
443 a2^\markup { poco \italic più forte }
445 d2_\markup { \italic "string. assai" }
447 b1^\markup { \bold { molto \italic agitato } }
451 @cindex caractères spéciaux en mode markup
452 @cindex mode markup et caractères spéciaux
453 @cindex caractères réservés, impression
454 @cindex impression de caractères réservés
455 @cindex impression de caractères spéciaux
456 @cindex guillemets en mode markup
457 @cindex mode markup et guillemets
459 Un bloc @code{\markup} peut contenir du texte entre guillemets. De
460 telles chaînes seront considérées comme des expressions textuelles
461 minimales@tie{}; à ce titre, toute commande de type @emph{markup} ou
462 tout caractère spécial -- tel un@tie{}@code{\} ou un@tie{}@code{#} --
463 sera imprimé littéralement et sans influer sur le formatage du texte.
464 Il est de ce fait possible d'imprimer des guillemets
465 informatiques@tie{}@code{"} dès lors qu'ils sont précédés d'une oblique
467 @c repeat double quote for pairing "
470 @lilypond[quote,verbatim,relative=2]
471 a1^"\italic markup..."
472 a_\markup { \italic "... imprime des lettres en \"italique\" !" }
476 Une liste de mots, pour pouvoir être traitée en tant qu'expression
477 distincte, doit être bornée par des @code{"} ou précédée d'une commande.
478 La manière de définir les expressions @emph{markup} aura une influence
479 sur la manière dont elles seront empilées, centrées ou alignées. Dans
480 l'exemple qui suit, la deuxième expression @code{\markup} est traitée
481 tout comme la première@tie{}:
482 @c repeat double quote for pairing "
484 @lilypond[quote,verbatim,relative=2]
485 c1^\markup { \center-column { a bbb c } }
486 c1^\markup { \center-column { a { bbb c } } }
487 c1^\markup { \center-column { a \line { bbb c } } }
488 c1^\markup { \center-column { a "bbb c" } }
491 Vous pouvez stocker les étiquettes textuelles en tant que variables,
492 et attacher ces identificateurs à des notes, comme ici@tie{}:
494 @lilypond[quote,verbatim]
495 allegro = \markup { \bold \large Allegro }
504 Pour une liste des différentes commandes spécifiques au mode
505 @code{\markup}, consultez l'annexe @ref{Text markup commands} (en
510 @ref{Text markup commands}.
512 Fichiers d'initialisation :
513 @file{scm/markup.scm}.
516 @rlsrnamed{Text,Texte}.
519 Les erreurs de syntaxe en mode @emph{markup} sont peu explicites.
522 @node Sélection de la fonte et de la taille
523 @unnumberedsubsubsec Sélection de la fonte et de la taille
524 @translationof Selecting font and font size
526 @cindex fonte, changement
527 @cindex changement de fonte
539 Le mode @emph{markup} autorise des changements élémentaires de la
542 @lilypond[quote,verbatim,relative=2]
545 \italic { non troppo \underline Vivo }
548 d,_\markup { \italic quasi \smallCaps Tromba }
552 @cindex caractères, taille
553 @cindex texte, taille
555 @funindex \abs-fontsize
565 La taille des caractères se modifie, relativement à la taille globale
566 des portées, de différentes manières.
568 Vous pouvez adopter l'une des tailles prédéfinies, comme ici@tie{}:
570 @lilypond[quote,verbatim,relative=2]
571 b1_\markup { \huge Sinfonia }
572 b1^\markup { \teeny da }
573 b1-\markup { \normalsize camera }
576 Vous pouvez la modifier relativement à sa valeur précédente@tie{}:
578 @lilypond[quote,verbatim,relative=2]
579 b1_\markup { \larger Sinfonia }
580 b1^\markup { \smaller da }
581 b1-\markup { \magnify #0.6 camera }
584 Vous pouvez l'augementer ou la diminuer par rapport à la taille globale
587 @lilypond[quote,verbatim,relative=2]
588 b1_\markup { \fontsize #-2 Sinfonia }
589 b1^\markup { \fontsize #1 da }
590 b1-\markup { \fontsize #3 camera }
593 Vous pouvez lui attribuer une valeur arbitraire quelle que soit la
594 taille de portée globale@tie{}:
596 @lilypond[quote,verbatim,relative=2]
597 b1_\markup { \abs-fontsize #20 Sinfonia }
598 b1^\markup { \abs-fontsize #8 da }
599 b1-\markup { \abs-fontsize #14 camera }
609 @funindex \normal-size-super
610 @funindex normal-size-super
612 Vous pouvez imprimer du texte en indice ou en exposant. Celui-ci sera
613 dans un taille plus petite, mais rien ne s'oppose à ce que vous lui
614 affectiez un taille normale@tie{}:
616 @lilypond[quote,verbatim]
619 \line { 1 \super st movement }
620 \line { 1 \normal-size-super st movement
621 \sub { (part two) } }
626 @cindex fontes, familles
628 Le mode @emph{markup} vous permet de sélectionner d'autres familles de
629 fontes. Par défaut, LilyPond utilise une police avec empattement, du
630 type roman, et tout changement doit être explicite. Dans la dernière
631 ligne de l'exemple qui suit, vous noterez qu'il n'y a aucune différence
632 entre les premier et deuxième mots.
634 @lilypond[quote,verbatim]
637 \line { Act \number 1 }
638 \line { \sans { Scene I. } }
639 \line { \typewriter { Verona. An open place. } }
640 \line { Enter \roman Valentine and Proteus. }
646 Certaines familles de police spécifiques aux nombres ou aux nuances par
647 exemple, ne disposent pas de tous les caractères, comme nous l'avons vu
648 dans les chapitres @ref{Personnalisation des indications de nuance} et
649 @ref{Indications de reprise manuelles}.
651 @c \concat is actually documented in Align (it is not
652 @c a font-switching command). But we need it here. -vv
654 Lorsqu'un changement survient au milieu d'un mot, il se peut qu'un
655 espacement supplémentaire apparaisse. Il suffit en pareil cas de
656 concaténer les différents éléments@tie{}:
658 @lilypond[quote,verbatim]
662 \concat { 1 \super st }
666 \concat { \dynamic p , }
667 \italic { con dolce espressione }
673 Une liste des différentes commandes permettant de changer de fonte ou
674 d'utiliser des fontes personnalisées est disponible à l'annexe
677 Pour savoir comment personnaliser des fontes, reportez-vous au chapitre
686 @funindex \normalsize
711 @ref{Personnalisation des indications de nuance},
712 @ref{Indications de reprise manuelles},
715 Fichiers d'initialisation :
716 @file{scm/define-markup-commands.scm}.
719 @rlsrnamed{Text,Texte}.
721 Référence des propriétés internes :
722 @rinternals{TextScript}.
725 Le recours aux commandes @code{\teeny}, @code{\tiny},@code{\small},
726 @code{\normalsize}, @code{\large} et @code{\huge} produiront des
727 espacements nettement moins réguliers que si vous utilisez
731 @node Alignement du texte
732 @unnumberedsubsubsec Alignement du texte
733 @translationof Text alignment
735 @cindex texte, alignement
736 @cindex alignement du texte
737 @cindex alignement des markups
738 @cindex markups, alignement
740 Cette partie traite de la manière de positionner du texte en mode
741 @emph{markup}. On déplace l'intégralité d'un objet @emph{markup} en
742 utilisant la syntaxe décrite au chapitre
743 @rlearning{Déplacement d'objets}.
745 @c Padding commands should be mentioned on this page, but
746 @c most of these require \box to be more clearly illustrated. -vv
748 @cindex texte, alignement horizontal
749 @cindex alignement horizontal du texte
751 @funindex \left-align
753 @funindex \center-align
754 @funindex center-align
755 @funindex \right-align
756 @funindex right-align
758 Les objets de type @emph{markup} peuvent s'aligner de différentes
759 manières. Une indication textuelle est par défaut alignée sur son
760 extrémité gauche. Dans l'exemple qui suit, il n'y a aucune différence
761 entre les deux premiers @emph{markups}.
763 @lilypond[quote,verbatim,relative=2]
766 d-\markup { \left-align poco }
768 d-\markup { \center-align { poco } }
770 d-\markup { \right-align poco }
776 L'alignement horizontal peut être ajusté à l'aide d'une valeur
779 @lilypond[quote,verbatim,relative=2]
780 a1-\markup { \halign #-1 poco }
782 a,-\markup { \halign #0 poco }
784 a,-\markup { \halign #0.5 poco }
786 a,-\markup { \halign #2 poco }
790 Certains objets possèdent leurs propres procédures d'alignement, qui
791 annuleront toute spécification d'alignement que vous pourriez affecter
792 à un argument de type @emph{markup} que vous leur auriez fourni. La
793 solution consiste alors à déplacer l'intégralité de ces objets
794 @emph{markup}, comme indiqué par exemple au chapitre
795 @ref{Indications textuelles}.
797 @cindex texte, alignement vertical
798 @cindex alignement vertical du texte
807 @c QUERY Should the function of ``\null'' be clarified? rp
809 L'alignement vertical est quant à lui un peu plus compliqué. Comme nous
810 l'avons vu ci-avant, les objets @emph{markup} peuvent être déplacés dans
811 leur intégralité. Il est néanmoins possible de déplacer certains
812 éléments spécifiques au sein d'un bloc @emph{markup}. En pareil cas,
813 l'élément à déplacer doit être précédé d'un @qq{point d'ancrage} -- un
814 autre élément du @emph{markup} ou un objet invisible. L'exemple qui
815 suit illustre ces deux possibilités. Vous noterez par ailleurs que le
816 dernier @emph{markup}, dépourvu de point d'ancrage, n'est de ce fait pas
819 @lilypond[quote,verbatim,relative=1]
822 \raise #2 { Scène 1 }
827 \lower #4 \bold { Très modéré }
831 \raise #4 \italic { Une forêt. }
836 @funindex \general-align
837 @funindex general-align
840 @funindex \translate-scaled
841 @funindex translate-scaled
843 Certaines commandes permettent de régler l'alignement des objets
844 textuels en mode @emph{markup}, tant au niveau horizontal que vertical.
845 Tout objet soumis à ces commandes doit être précédé d'un point
848 @lilypond[quote,verbatim,relative=1]
851 \translate #'(-1 . 2) "Scène 1"
856 \general-align #Y #3.2 \bold "Très modéré"
861 \translate-scaled #'(-1 . 2) \teeny "Une forêt."
866 @cindex multiligne, markup
867 @cindex markup multiligne
868 @cindex multiligne, texte
869 @cindex texte multiligne
870 @cindex texte en colonnes
871 @cindex colonnes de texte
875 @funindex \center-column
876 @funindex center-column
878 Un objet de type @emph{markup} peut contenir plusieurs lignes de texte.
879 Dans l'exemple suivant, chaque élément ou expression ira se placer sur
880 sa propre ligne, tantôt alignée à gauche, tantôt centrée.
882 @lilypond[quote,verbatim]
898 @cindex centrage du texte sur la page
899 @cindex texte, centrage sur la page
900 @cindex markup, centrage sur la page
905 Pareillement, une liste d'éléments ou d'expressions sera répartie sur
906 une ligne entière, voire même centrée sur toute la page s'il n'y a qu'un
907 seul élément. De telles expressions peuvent à leur tour contenir du
908 texte multiligne ou une autre expression @emph{markup}.
910 @lilypond[quote,verbatim]
913 \line { William S. Gilbert }
915 \huge \smallCaps "The Mikado"
917 \smallCaps "The Town of Titipu"
919 \line { Sir Arthur Sullivan }
927 @cindex plusieurs lignes de texte
928 @cindex justifié, texte
929 @cindex texte justifié
930 @cindex texte sur plusieurs lignes
931 @cindex markup, texte au kilomètre
932 @cindex markup, texte justifié
939 Les indications textuelles, lorsqu'elles sont relativement longues,
940 peuvent se répartir sur plusieurs lignes en fonction de la largeur de
941 ligne. Le texte sera alors soit aligné à gauche, soit justifié, comme
942 le montre l'exemple suivant@tie{}:
944 @lilypond[quote,verbatim]
947 \line \smallCaps { La vida breve }
948 \line \bold { Acto I }
950 (La escena representa el corral de una casa de
951 gitanos en el Albaicín de Granada. Al fondo una
952 puerta por la que se ve el negro interior de
953 una Fragua, iluminado por los rojos resplandores
958 \line \bold { Acto II }
959 \override #'(line-width . 50)
961 (Calle de Granada. Fachada de la casa de Carmela
962 y su hermano Manuel con grandes ventanas abiertas
963 a través de las que se ve el patio
964 donde se celebra una alegre fiesta)
970 @cindex commandes d'alignement du texte
971 @cindex markup, commandes d'alignement du texte
972 @cindex alignement du texte, commandes
974 Une liste des différentes commandes permettant d'aligner du texte en
975 mode @emph{markup} est disponible à l'annexe @ref{Align}.
978 Manuel d'initiation :
979 @rlearning{Déplacement d'objets}.
983 @ref{Indications textuelles}.
985 Fichiers d'initialisation :
986 @file{scm/define-markup-commands.scm}.
989 @rlsrnamed{Text,Texte}.
991 Référence des propriétés internes :
992 @rinternals{TextScript}.
995 @node Éléments graphiques dans du texte formaté
996 @unnumberedsubsubsec Éléments graphiques dans du texte formaté
997 @translationof Graphic notation inside markup
999 @cindex graphisme, tracé
1000 @cindex tracé d'objets graphiques
1001 @cindex graphiques, tracé d'objets
1002 @cindex intégration d'objet graphique
1003 @cindex objets graphiques, tracé
1005 Vous pouvez, grâce aux mode @emph{markup}, ajouter divers objets
1006 graphiques à votre partition.
1008 @cindex décoration du texte
1009 @cindex encadrement du texte
1010 @cindex texte, encadrement
1011 @cindex texte, décoration
1012 @cindex markup, ornementation du texte
1013 @cindex markup, encadrement du texte
1019 @funindex \rounded-box
1020 @funindex rounded-box
1026 Certaines commandes de @emph{markup} permettent d'ornementer des
1027 éléments textuels avec des graphismes, à l'instar de l'exemple
1030 @lilypond[quote,verbatim]
1031 \markup \fill-line {
1039 \bracket "1866 - 1925"
1042 \rounded-box \bold Prelude
1047 @cindex espacement autour du texte
1048 @cindex texte et rembourrage
1049 @cindex markup, rembourrage du texte
1051 @funindex \pad-markup
1052 @funindex pad-markup
1055 @funindex \pad-to-box
1056 @funindex pad-to-box
1057 @funindex \pad-around
1058 @funindex pad-around
1060 Certaines directives peuvent nécessiter d'accroître l'espacement autour
1061 du texte -- voir l'annexe @ref{Align} pour une liste des différentes
1062 commandes particulières au mode @emph{markup} ainsi que leur description.
1064 @lilypond[quote,verbatim]
1065 \markup \fill-line {
1067 \box "Charles Ives (1874 - 1954)"
1069 \box \pad-markup #2 "THE UNANSWERED QUESTION"
1070 \box \pad-x #8 "A Cosmic Landscape"
1077 \box \pad-to-box #'(-5 . 20) #'(0 . 5)
1078 \bold "Largo to Presto"
1081 "String quartet keeps very even time,
1082 Flute quartet keeps very uneven time."
1086 @cindex graphisme dans la notation
1087 @cindex symboles non musicaux
1088 @cindex non musicaux, symboles
1089 @cindex notation et graphisme
1093 @funindex \draw-circle
1094 @funindex draw-circle
1095 @funindex \filled-box
1096 @funindex filled-box
1099 @funindex \draw-line
1101 @funindex \arrow-head
1102 @funindex arrow-head
1104 Vous pouvez imprimer certains graphismes ou symboles sans qu'il n'y
1105 ait de texte. Ces objets peuvent même se combiner, à l'instar de
1106 n'importe quelle expression @emph{markup}.
1108 @lilypond[quote,verbatim]
1111 \draw-circle #4 #0.4 ##f
1112 \filled-box #'(-4 . 4) #'(-0.5 . 0.5) #1
1118 \draw-line #'(0 . 4)
1119 \arrow-head #Y #DOWN ##f
1124 @cindex intégration de graphiques
1125 @cindex images, intégration
1126 @cindex graphiques, intégration
1131 @funindex \postscript
1132 @funindex postscript
1134 Des fonctionnalités graphiques avancées vous permettent même d'inclure
1135 dans une partition un fichier image converti au format PostScript
1136 encapsulé (extension @code{eps}), ou bien de tracer un graphique
1137 directement dans le fichier source à partir d'instructions PostScript
1138 pures. Nous vous conseillons, en pareil cas, de toujours spécifier les
1139 dimensions du dessin, comme dans ce qui suit@tie{}:
1141 @lilypond[quote,verbatim,relative=1]
1144 \epsfile #X #10 #"./context-example.eps"
1145 \with-dimensions #'(0 . 6) #'(0 . 10)
1161 L'annexe @ref{Graphic} répertorie les différentes commandes en matière
1165 Manuel de notation :
1167 @ref{Annotations éditoriales},
1170 Fichiers d'initialisation :
1171 @file{scm/define-markup-commands.scm},
1172 @file{scm/stencil.scm}.
1175 @rlsrnamed{Text,Texte}.
1177 Référence des propriétés internes :
1178 @rinternals{TextScript}.
1181 @node Notation musicale dans du texte formaté
1182 @unnumberedsubsubsec Notation musicale dans du texte formaté
1183 @translationof Music notation inside markup
1185 @cindex notation dans un markup
1186 @cindex musique dans un markup
1187 @cindex markup, inclusion de musique
1189 Divers éléments de notation peuvent orner une partition, au moyen d'un
1190 objet @emph{markup}.
1192 Notes et altérations sont données à l'aide d'instructions
1193 @emph{markup}@tie{}:
1195 @lilypond[quote,verbatim,relative=2]
1199 \note-by-number #1 #1 #1.5
1202 \natural \semiflat \flat
1203 \sesquiflat \doubleflat
1207 \natural \semisharp \sharp
1208 \sesquisharp \doublesharp
1213 Le mode @emph{markup} permet d'accéder à d'autres objets de
1216 @lilypond[quote,verbatim,relative=1]
1223 fis_\markup { \dynamic rf }
1234 En règle générale, tout symbole musical peut être inclus dans un
1235 @emph{markup}, comme le montre l'exemple qui suit. Ces différents
1236 symboles sont répertoriés dans l'annexe @ref{La fonte Feta}.
1238 @lilypond[quote,verbatim,relative=2]
1240 c'^\markup { \musicglyph #"eight" }
1242 c,8._\markup { \musicglyph #"clefs.G_change" }
1244 c2^\markup { \musicglyph #"timesig.neomensural94" }
1247 La rubrique @ref{Tout savoir sur les fontes} contient d'autres
1248 informations sur l'impression de glyphes non alphabétiques, tels que des
1249 crochets ou accolades.
1251 Le mode @emph{markup} supporte aussi les diagrammes spécifiques à
1252 certains instruments@tie{}:
1254 @lilypond[quote,verbatim,relative=2]
1256 \fret-diagram-terse #"x;x;o;2;3;2;"
1259 \harp-pedal #"^-v|--ov^"
1264 \musicglyph #"accordion.discant"
1266 \raise #0.5 \musicglyph #"accordion.dot"
1267 \raise #1.5 \musicglyph #"accordion.dot"
1271 @c The accordion diagram is actually taken from a snippet.
1274 La documentation sur ces diagrammes se trouvent à l'annexe
1275 @ref{Instrument Specific Markup}.
1277 @cindex partition incluse dans un markup
1278 @cindex markup, inclusion de partition
1280 Rien ne s'oppose à ce qu'une étiquette ne comporte une partition. Il
1281 suffit que l'expression en question contienne un bloc @code{\score}
1282 incluant un bloc @code{\layout}.
1284 @lilypond[quote,verbatim,relative=1]
1287 \relative c' { c4 d e f }
1295 Les différentes commandes @emph{markup} relatives à la notation musicale
1296 sont répertoriées à l'annexe @ref{Music}.
1299 Manuel de notation :
1301 @ref{La fonte Feta},
1302 @ref{Tout savoir sur les fontes}.
1304 Fichiers d'initialisation :
1305 @file{scm/define-markup-commands.scm},
1306 @file{scm/fret-diagrams.scm},
1307 @file{scm/harp-pedals.scm}.
1310 @rlsrnamed{Text,Texte}.
1312 Référence des propriétés internes :
1313 @rinternals{TextScript}.
1316 @node Texte avec sauts de page
1317 @unnumberedsubsubsec Texte avec sauts de page
1318 @translationof Page wrapping text
1320 @cindex multi-page, markup
1321 @cindex markup multi-page
1322 @cindex markup, texte multi-page
1323 @cindex plusieurs pages de texte
1325 @funindex \markuplist
1326 @funindex markuplist
1327 @funindex \justified-lines
1328 @funindex justified-lines
1329 @funindex \wordwrap-lines
1330 @funindex wordwrap-lines
1332 Alors que @code{\markup} s'utilise pour traiter un bloc de texte
1333 insécable, @code{\markuplist} permet, employé en tête de partition,
1334 d'obtenir un bloc de lignes réparties différemment et, le cas échéant,
1335 sur plusieurs pages.
1338 @lilypond[quote,verbatim]
1341 Un long texte constitué de lignes justifiées.
1345 Un autre grand paragraphe.
1352 Cette syntaxe prend en charge une liste de @emph{markups}@tie{}; il peut
1356 d'une suite de commandes générant à leur tour des lignes de texte,
1358 d'une liste de lignes de texte,
1360 d'une liste d'étiquettes.
1363 Les différentes commandes permettant de générer des listes de lignes
1364 se trouve dans l'annexe @ref{Text markup list commands}.
1366 @funindex \markuplist
1367 @funindex markuplist
1374 Manuel de notation :
1375 @ref{Text markup list commands},
1377 Manuel d'extension :
1378 @rextend{Définition d'une nouvelle commande de liste de markups}.
1380 Fichiers d'initialisation :
1381 @file{scm/define-markup-commands.scm}.
1384 @rlsrnamed{Text,Texte}.
1386 Référence des propriétés internes :
1387 @rinternals{TextScript}.
1392 @translationof Fonts
1394 Ce chapitre est consacré aux fontes et polices de caractère, à leur
1395 gestion. Vous y apprendrez aussi comment changer de fonte en cours de
1399 * Tout savoir sur les fontes::
1400 * Attribution d'une fonte en particulier::
1401 * Choix des fontes par défaut::
1405 @node Tout savoir sur les fontes
1406 @unnumberedsubsubsec Tout savoir sur les fontes
1407 @translationof Fonts explained
1410 @cindex fontes, généralités
1411 @cindex accolades, taille
1412 @cindex fontes et markup
1413 @cindex markup et fontes
1415 @funindex font-interface
1417 La gestion des fontes est assurée par plusieurs bibliothèques@tie{}:
1418 FontConfig se charge de répertorier les différentes fontes installées
1419 sur votre système@tie{}; quant à Pango, elle se charge plus
1420 particulièrement de leur rendu.
1422 Les fontes musicales peuvent se décrire comme un jeu de glyphes
1423 spécifiques regroupés dans plusieurs familles. L'exemple qui suit
1424 montre la syntaxe à utiliser pour accéder, en mode @emph{markup}, aux
1425 différentes fontes @code{feta} non textuelles de LilyPond.
1427 @lilypond[quote,verbatim,relative=2]
1430 \override #'(font-encoding . fetaBraces)
1432 \override #'(font-encoding . fetaText)
1434 \override #'(font-encoding . fetaMusic)
1435 \lookup #"noteheads.s0petrucci"
1441 Tous ces glyphes, à l'exception des accolades qui sont regroupées dans
1442 @code{fetaBraces}, sont accessibles avec la syntaxe indiquée dans
1443 @ref{Notation musicale dans du texte formaté}.
1445 Une remarque s'impose au sujet des glyphes contenus dans
1446 @code{fetaBraces}@tie{}: chacun d'eux est formé du mot @emph{brace}
1447 auquel est accolé un numéro d'ordre. Lorsque vous désirez imprimer une
1448 accolade, vous devez la @qq{chercher} par son numéro d'ordre -- d'où la
1449 fonction @code{\lookup} de l'exemple ci-dessus --, tout en sachant qu'il
1450 est compris entre @code{0} (la plus petite) et @code{575} (la plus
1451 grande). Vous serez souvent amené à procéder par tâtonnement pour
1452 arriver au résultat optimal. Par ailleurs, @code{fetaBraces} ne
1453 comporte que des accolades ouvrantes. Pour obtenir une accolade
1454 fermante, il suffit d'appliquer une rotation au glyphe sélectionné,
1455 comme indiqué au chapitre @ref{Rotation des objets}.
1457 Vous disposez de trois familles de fontes textuelles@tie{}: @emph{roman}
1458 pour la police sérif ou avec empattement -- fixée par défaut à New
1459 Century Schoolbook --, une police sans empattement (@emph{sans} sérif)
1460 et une à chasse fixe (ou monospace) -- les deux dernières étant
1461 déterminées par l'installation de Pango.
1463 Chaque famille dispose en principe de différents styles et niveaux de
1464 gras. L'exemple qui suit illustre la manière de changer la famille, le
1465 style, la graisse ou la taille. Notez bien que l'argument fourni à
1466 @code{font-size} correspond à la correction à apporter à la taille par
1469 @lilypond[quote,verbatim,relative=2]
1470 \override Score.RehearsalMark #'font-family = #'typewriter
1471 \mark \markup "Ouverture"
1472 \override Voice.TextScript #'font-shape = #'italic
1473 \override Voice.TextScript #'font-series = #'bold
1474 d2.^\markup "Allegro"
1475 \override Voice.TextScript #'font-size = #-3
1480 Cette syntaxe s'applique aussi en mode @emph{markup}, bien que celui-ci
1481 dispose d'une syntaxe allégée comme nous l'avons vu dans
1482 @ref{Sélection de la fonte et de la taille}@tie{}:
1484 @lilypond[quote,verbatim]
1488 \override #'(font-shape . italic)
1489 \override #'(font-size . 4)
1493 \override #'(font-family . typewriter)
1495 \override #'(font-series . bold)
1499 \override #'(font-family . sans)
1506 En plus de pouvoir jongler entre les différentes fontes prédéfinies,
1507 LilyPond vous permet d'en utiliser d'autres, ce qui fait l'objet des
1508 deux prochaines parties@tie{}:
1509 @ref{Attribution d'une fonte en particulier}
1510 et @ref{Choix des fontes par défaut}.
1513 Manuel de notation :
1514 @ref{La fonte Feta},
1515 @ref{Notation musicale dans du texte formaté},
1516 @ref{Rotation des objets},
1517 @ref{Sélection de la fonte et de la taille},
1521 @node Attribution d'une fonte en particulier
1522 @unnumberedsubsubsec Attribution d'une fonte en particulier
1523 @translationof Single entry fonts
1525 Vous pouvez utiliser n'importe quelle police installée sur votre
1526 système, dès lors qu'elle est accessible par Fontconfig et que vous
1527 respectez la syntaxe suivante@tie{}:
1529 @lilypond[quote,verbatim,relative=2]
1530 \override Staff.TimeSignature #'font-name = #"Bitstream Charter"
1531 \override Staff.TimeSignature #'font-size = #2
1535 \override #'(font-name . "Vera Bold")
1540 @cindex fontes disponibles
1541 @cindex disponibilité des fontes
1543 @funindex show-available-fonts
1545 Pour obtenir la liste de toutes les polices disponibles sur votre
1549 lilypond -dshow-available-fonts toto
1552 (quel qu'il soit, le dernier argument est obligatoire).
1555 Manuel de notation :
1556 @ref{Tout savoir sur les fontes},
1557 @ref{Choix des fontes par défaut}.
1560 @rlsrnamed{Text,Texte}.
1562 @c A source file gets never installed...
1563 @c Fichiers d'initialisation :
1564 @c @file{lily/font-config-scheme.cc}.
1567 @node Choix des fontes par défaut
1568 @unnumberedsubsubsec Choix des fontes par défaut
1569 @translationof Entire document fonts
1571 Vous pouvez tout à fait préférer un autre jeu de polices par défaut que
1572 celui de LilyPond. Il vous faudra alors spécifier les différentes
1573 familles, en respectant l'ordre @emph{roman}, @emph{sans empattement} et
1574 @emph{monospace}, comme dans l'exemple suivant. Pour plus
1575 d'explications sur les fontes, relisez @ref{Tout savoir sur les fontes}.
1577 @cindex polices, choix par défaut
1578 @cindex fontes, choix par défaut
1580 @funindex make-pango-font-tree
1582 @lilypond[verbatim,quote]
1586 (make-pango-font-tree "Times New Roman"
1589 (/ myStaffSize 20)))
1596 \typewriter typewriter. }
1600 @c we don't do Helvetica / Courier, since GS incorrectly loads
1604 Manuel de notation :
1605 @ref{Tout savoir sur les fontes},
1606 @ref{Attribution d'une fonte en particulier},
1607 @ref{Sélection de la fonte et de la taille},