1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
3 Translation of GIT committish: 22b6ca7247b6f0d596934d38aa2c75d5e45206eb
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 que
22 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::
36 @subsection Ajout de texte
37 @translationof Writing text
39 Cette partie constitue une introduction aux différentes manières
40 d'ajouter du texte à une partition.
42 @cindex Texte, autres langues
43 @warning{Pour écrire des accents et autres caractères spéciaux, il suffit de
44 les insérer directement dans votre fichier LilyPond. Ce fichier devra
45 être sauvegardé avec l'encodage UTF-8. Pour plus d'informations, voir
46 @ref{Codage du texte}.}
49 * Commentaires textuels::
50 * Indications textuelles et lignes d'extension::
51 * Indications textuelles::
55 @node Commentaires textuels
56 @unnumberedsubsubsec Commentaires textuels
57 @translationof Text scripts
59 @cindex Étiquette de texte
60 @cindex blocs de texte
61 @cindex ajout de texte
63 Vous pouvez ajouter à une partition des indications sous forme texuelle,
64 comme dans l'exemple suivant. Ces indications se placeront manuellement
65 au-dessus ou au-dessous de la portée selon la syntaxe utilisée -- cf.
66 @ref{Direction et positionnement}.
68 @lilypond[quote,verbatim,relative=2]
69 a8^"pizz." g f e a4-"scherz." f
72 Cette syntaxe est en fait un raccourci. Des constructions plus
73 élaborées d'annotation peuvent être obtenues en ayant recours à un bloc
74 @code{\markup} et selon les préceptes énoncés dans
75 @ref{Mise en forme du texte}.
77 @lilypond[quote,verbatim,relative=2]
78 a8^\markup { \italic pizz. } g f e
79 a4_\markup { \tiny scherz. \bold molto } f
82 Par défaut, ces indications n'affectent en rien l'espacement des
83 notes. Leur longueur peut néanmoins être prise en considération@tie{}:
84 dans l'exemple qui suit, le premier commentaire n'influe pas sur
85 l'espacement, à l'inverse du second.
87 @lilypond[quote,verbatim,relative=2]
93 En plus d'indications textuelles, les notes peuvent se voir attacher des
94 articulations, comme indiqué au chapitre @ref{Articulations et ornements}.
96 Pour de plus amples détails sur la manière de combiner indications
97 textuelles et articulations, reportez-vous au chapitre
98 @rlearning{Positionnement des objets}.
100 @funindex \textLengthOn
101 @funindex textLengthOn
102 @funindex \textLengthOff
103 @funindex textLengthOff
106 @code{\textLengthOn},
107 @code{\textLengthOff}.
112 Manuel d'initiation :
113 @rlearning{Positionnement des objets}.
116 @ref{Mise en forme du texte},
117 @ref{Direction et positionnement}.
122 Référence des propriétés internes :
123 @rinternals{TextScript}.
126 @cindex texte hors marges
127 @cindex marges, texte qui dépasse
128 @cindex texte, maintien dans les marges
129 @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 c'est la raison pour laquelle LilyPond, par défaut, ne s'en préoccupe pas.
137 Vous pouvez cependant l'y forcer en définissant
140 \override Score.PaperColumn #'keep-inside-line = ##t
144 @node Indications textuelles et lignes d'extension
145 @unnumberedsubsubsec Indications textuelles et lignes d'extension
146 @translationof Text spanners
148 @cindex texte et extenseur
149 @cindex prolongation de texte
152 Certaines indications d'interprétation comme @i{rallentando},
153 @i{accelerando} ou @i{trilles}, s'incrivent textuellement et se
154 prolongent sur plusieurs notes à l'aide d'une ligne pleine, pointillée
155 ou ondulée. Ces objets, que l'on appelle @qq{extenseurs}, se dessinent
156 entre deux notes à l'aide de la syntaxe suivante@tie{}:
158 @lilypond[verbatim,quote,relative=2]
159 \override TextSpanner #'(bound-details left text) = "rit."
164 @cindex texte, mise en forme des prolongations
165 @cindex texte, mise en forme des extenseurs
166 @cindex extenseur, mise en forme
169 Le texte à imprimer est spécifié en tant que propriété de l'objet
170 @code{TextSpanner}. Il apparaîtra par défaut en italique@tie{};
171 cependant, rien ne s'oppose à un autre graphisme dès lors que vous
172 faites appel à un bloc @code{\markup} --
173 voir @ref{Mise en forme du texte}.
175 @lilypond[quote,relative=2,verbatim]
176 \override TextSpanner #'(bound-details left text) =
177 \markup { \upright "rit." }
182 Le style de ligne se définit lui aussi comme une propriété de l'objet.
183 Les détails concernant la syntaxe à utiliser sont expliqués au chapitre
187 @funindex \textSpannerUp
188 @funindex textSpannerUp
189 @funindex \textSpannerDown
190 @funindex textSpannerDown
191 @funindex \textSpannerNeutral
192 @funindex textSpannerNeutral
196 @code{\textSpannerUp},
197 @code{\textSpannerDown},
198 @code{\textSpannerNeutral}.
202 LilyPond ne peut traiter qu'un seul extenseur à la fois par voix.
212 Référence des propriétés internes :
213 @rinternals{TextSpanner}.
216 @node Indications textuelles
217 @unnumberedsubsubsec Indications textuelles
218 @translationof Text marks
220 @cindex indication textuelle
221 @cindex coda sur une barre de mesure
222 @cindex segno sur une barre de mesure
223 @cindex point d'orgue sur une barre de mesure
224 @cindex barres de mesure, symboles au dessus de
231 La commande @code{\mark} est tout d'abord conçue pour les
232 @ref{Indications de repère}.
234 @c \mark needs to be placed on a separate line (it's not
235 @c attached to an object like \markup is). -vv
237 @lilypond[verbatim,quote,relative=2]
243 Cette syntaxe rend possible l'adjonction de n'importe quel texte à une
244 barre de mesure. Ce texte peut être mis en forme de différentes
245 manières dès lors qu'est utilisé un bloc @code{\markup}, comme indiqué
246 au chapitre @ref{Mise en forme du texte}.
248 @lilypond[quote,verbatim,relative=1]
250 \mark \markup { \italic { colla parte } }
256 Elle peut aussi servir à insérer des signes de @emph{coda} ou de
257 @emph{segno}, ou bien un point d'orgue, au dessus d'une
258 barre de mesure. Couplez-la alors à la commande @code{\markup} pour
259 avoir accès au symbole approprié, selon les indications contenues au
260 chapitre @ref{Notation musicale dans du texte formaté}.
262 @lilypond[quote,verbatim,relative=2]
264 \mark \markup { \musicglyph #"scripts.ufermata" }
269 Le résultat de @code{\mark} n'apparaîtra que sur la portée supérieure
270 d'un système. Si vous introduisez la commande @code{\mark} au moment
271 d'une barre de mesure, la marque se placera au dessus de la barre. Si
272 vous y faites appel au milieu d'une mesure, cette marque sera
273 positionnée entre les notes. Si elle intervient en début de ligne,
274 elle sera placée juste avant la première note de cette portée. Enfin,
275 une marque qui tomberait sur un saut de ligne sera imprimée au début
276 de la ligne suivante.
278 @lilypond[quote,verbatim,relative=2]
288 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
289 {printing-marks-at-the-end-of-a-line.ly}
291 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
292 {aligning-marks-with-various-notation-objects.ly}
294 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
295 {printing-marks-on-every-staff.ly}
300 @ref{Indications de repère},
301 @ref{Mise en forme du texte},
302 @ref{Notation musicale dans du texte formaté},
308 Référence des propriétés internes :
309 @rinternals{MarkEvent},
310 @rinternals{Mark_engraver},
311 @rinternals{RehearsalMark}.
314 @node Texte indépendant
315 @unnumberedsubsubsec Texte indépendant
316 @translationof Separate text
318 @cindex texte indépendant
320 @cindex texte en préambule
321 @cindex top-level text
322 @cindex text, top-level
323 @cindex text, standalone
328 Un bloc @code{\markup} peut exister en lui-même, indépendamment de tout
329 bloc @code{\score}, et venir en préambule par exemple -- voir le
330 chapitre @ref{Structure de fichier} à ce propos.
332 @lilypond[verbatim,quote]
334 Tomorrow, and tomorrow, and tomorrow...
339 De cette manière, vous pouvez insérer du texte en dehors de la musique.
340 Ceci devient particulièrement utile lorsque le fichier source contient
341 plusieurs morceaux. Pour plus d'informations à ce propos, reportez-vous
342 au chapitre @ref{Plusieurs partitions dans un même ouvrage}.
344 @lilypond[quote,verbatim]
349 Tomorrow, and tomorrow, and tomorrow...
356 Les blocs de textes peuvent s'étendre sur plusieurs pages, ce qui permet
357 de générer des ouvrages complets uniquement grâce à LilyPond. Cette
358 fonctionnalité ainsi que la syntaxe appropriée est abordée plus en
359 détail au chapitre @ref{Texte avec sauts de page}.
364 @funindex \markuplines
365 @funindex markuplines
375 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
376 {stand-alone-two-column-markup.ly}
381 @ref{Mise en forme du texte},
382 @ref{Structure de fichier},
383 @ref{Plusieurs partitions dans un même ouvrage},
384 @ref{Texte avec sauts de page}.
389 Référence des propriétés internes :
390 @rinternals{TextScript}.
393 @node Mise en forme du texte
394 @subsection Mise en forme du texte
395 @translationof Formatting text
397 Nous allons voir dans les lignes qui suivent la manière de mettre en
398 forme du texte à l'aide de la syntaxe propre au mode @code{\markup}.
401 * Introduction au formatage de texte::
402 * Sélection de la fonte et de la taille::
403 * Alignement du texte::
404 * Éléments graphiques dans du texte formaté::
405 * Notation musicale dans du texte formaté::
406 * 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 @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 chaines 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 @code{\} ou un @code{#} -- sera imprimé
463 littéralement et sans influer sur le formatage du texte. Il est de ce
464 fait possible d'imprimer des guillemets informatiques @code{"} dès lors
465 qu'ils sont précédés d'une oblique inverse.
468 @lilypond[quote,verbatim,relative=2]
469 a1^"\italic markup..."
470 a_\markup { \italic "... imprime des lettres en \"italique\" !" }
474 Une liste de mots, pour pouvoir être traitée en tant qu'expression
475 distincte, doit être bornée par des @code{"} ou précédée d'une commande.
476 La manière de définir les expressions @emph{markup} aura une influence
477 sur la manière dont elles seront empilées, centrées ou alignées. Dans
478 l'exemple qui suit, la deuxième expression @code{\markup} est traitée
479 tout comme la première@tie{}:
481 @lilypond[quote,verbatim,relative=2]
482 c1^\markup { \center-column { a bbb c } }
483 c1^\markup { \center-column { a { bbb c } } }
484 c1^\markup { \center-column { a \line { bbb c } } }
485 c1^\markup { \center-column { a "bbb c" } }
488 Vous pouvez stocker les étiquettes textuelles en tant que variables,
489 et attacher ces identificateurs à des notes, comme ici@tie{}:
491 @lilypond[quote,verbatim]
492 allegro = \markup { \bold \large Allegro }
501 Pour une liste des différentes commandes spécifiques au mode
502 @code{\markup}, consultez l'annexe @ref{Text markup commands} (en
508 @ref{Text markup commands}.
513 Fichiers d'initialisation :
514 @file{scm/@/markup@/.scm}.
519 Les erreurs de syntaxe en mode @emph{markup} sont peu loquaces.
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 caratères, taille
553 @cindex texte, taille
564 La taille des caractères se modifie de différentes manières :
567 à partir de l'une des tailles standard prédéfinies,
570 en étant définie en valeur absolue,
573 en adoptant une valeur relative à celle précédemment définie.
577 Voici une illustration de ces trois différentes méthodes@tie{}:
579 @lilypond[quote,verbatim,relative=1]
586 \fontsize #5 Sinfonia
593 \magnify #0.6 { e sentimento } )
606 Vous pouvez imprimer du texte en indice ou en exposant. Celui-ci sera
607 dans un taille plus petite, mais rien ne s'oppose à ce que vous lui
608 affectiez un taille normale@tie{}:
610 @lilypond[quote,verbatim]
613 \line { 1 \super st movement }
614 \line { 1 \normal-size-super st movement
615 \sub { (part two) } }
620 @cindex fontes, familles
622 Le mode @emph{markup} vous permet de sélectionner d'autres familles de
623 fontes. Par défaut, LilyPond utilise une police avec empattement, du
624 type roman, et tout changement doit être explicite. Dans la dernière
625 ligne de l'exemple qui suit, vous noterez qu'il n'y a aucune différence
626 entre les premier et deuxième mots.
628 @lilypond[quote,verbatim]
631 \line { Act \number 1 }
632 \line { \sans { Scene I. } }
633 \line { \typewriter { Verona. An open place. } }
634 \line { Enter \roman Valentine and Proteus. }
640 Certaines familles de police spécifiques aux nombres ou aux nuances par
641 exemple, ne disposent pas de tous les caractères, comme nous l'avons vu
642 dans les chapitres @ref{Personnalisation des indications de nuance} et
643 @ref{Indications de reprise manuelles}.
645 @c \concat is actually documented in Align (it is not
646 @c a font-switching command). But we need it here. -vv
648 Lorsqu'un changement survient au milieu d'un mot, il se peut qu'un
649 espacement supplémentaire apparaîsse. Il suffit en pareil cas de
650 concaténer les différents éléments@tie{}:
652 @lilypond[quote,verbatim]
656 \concat { 1 \super st }
660 \concat { \dynamic p , }
661 \italic { con dolce espressione }
667 Une liste des différentes commandes permettant de changer de fonte ou
668 d'utiliser des fontes personnalisées est disponible à l'annexe @ref{Font}.
670 Pour savoir comment personnaliser des fontes, reportez-vous au chapitre
679 @funindex \normalsize
706 @ref{Personnalisation des indications de nuance},
707 @ref{Indications de reprise manuelles},
713 Référence des propriétés internes :
714 @rinternals{TextScript}.
716 Fichiers d'initialisation :
717 @file{scm/@/define@/-markup@/-commands@/.scm}.
720 @node Alignement du texte
721 @unnumberedsubsubsec Alignement du texte
722 @translationof Text alignment
724 @cindex texte, alignement
725 @cindex alignement du texte
726 @cindex alignement des markups
727 @cindex markups, alignement
729 Cette partie traite de la manière de positionner du texte en mode
730 @emph{markup}. On déplace l'intégralité d'un objet @emph{markup} en
731 utilisant la syntaxe décrite au chapitre
732 @rlearning{Déplacement d'objets}.
734 @c Padding commands should be mentioned on this page, but
735 @c most of these require \box to be more clearly illustrated. -vv
737 @cindex texte, alignement horizontal
738 @cindex alignement horizontal du texte
740 @funindex \left-align
742 @funindex \center-align
743 @funindex center-align
744 @funindex \right-align
745 @funindex right-align
747 Les objets de type @emph{markup} peuvent s'aligner de différentes
748 manières. Une indication textuelle est par défaut alignée sur son
749 extrémité gauche. Dans l'exemple qui suit, il n'y a aucune différence
750 entre les deux premiers @emph{markups}.
752 @lilypond[quote,verbatim,relative=2]
755 d-\markup { \left-align poco }
757 d-\markup { \center-align { poco } }
759 d-\markup { \right-align poco }
765 L'alignement horizontal peut être ajusté à l'aide d'une valeur
768 @lilypond[quote,verbatim,relative=2]
769 a1-\markup { \halign #-1 poco }
771 a,-\markup { \halign #0 poco }
773 a,-\markup { \halign #0.5 poco }
775 a,-\markup { \halign #2 poco }
779 Certains objets possèdent leurs propres procédures d'alignement, qui
780 annuleront toute spécification d'alignement que vous pourriez affecter
781 à un argument de type @emph{markup} que vous leur auriez fourni. La
782 solution consiste alors à déplacer l'intégralité de ces objets
783 @emph{markup}, comme indiqué par exemple au chapitre
784 @ref{Indications textuelles}.
786 @cindex texte, alignement vertical
787 @cindex alignement vertical du texte
796 @c QUERY Should the function of ``\null'' be clarified? rp
798 L'alignement vertical est quant à lui un peu plus compliqué. Comme nous
799 l'avons vu ci-avant, les objets @emph{markup} peuvent être déplacés dans
800 leur intégralité. Il est néanmois possible de déplacer certains
801 éléments spécifiques au sein d'un bloc @emph{markup}. En pareil cas,
802 l'élément à déplacer doit être précédé d'un @qq{point d'ancrage} -- un
803 autre élément du @emph{markup} ou un objet invisible. L'exemple qui
804 suit illustre ces deux possibilités. Vous noterez par ailleurs que le
805 dernier @emph{markup}, dépourvu de point d'ancrage, n'est de ce fait pas
808 @lilypond[quote,verbatim,relative=1]
811 \raise #2 { Scène 1 }
816 \lower #4 \bold { Très modéré }
820 \raise #4 \italic { Une forêt. }
825 @funindex \general-align
826 @funindex general-align
829 @funindex \translate-scaled
830 @funindex translate-scaled
832 Certaines commandes permettent de régler l'alignement des objets
833 textuels en mode @emph{markup}, tant au niveau horizontal que vertical.
834 Tout objet soumis à ces commandes doit être précédé d'un point d'ancrage.
836 @lilypond[quote,verbatim,relative=1]
839 \translate #'(-1 . 2) "Scène 1"
844 \general-align #Y #3.2 \bold "Très modéré"
849 \translate-scaled #'(-1 . 2) \teeny "Une forêt."
854 @cindex multi-ligne, markup
855 @cindex markup multi-ligne
856 @cindex multi-ligne, texte
857 @cindex texte multi-ligne
858 @cindex texte en colonnes
859 @cindex colonnes de texte
863 @funindex \center-column
864 @funindex center-column
866 Un objet de type @emph{markup} peut contenir plusieurs lignes de texte.
867 Dans l'exemple suivant, chaque élément ou expression ira se placer sur
868 sa propre ligne, tantôt alignée à gauche, tantôt centrée.
870 @lilypond[quote,verbatim]
886 @cindex centrage du texte sur la page
887 @cindex texte, centrage sur la page
888 @cindex markup, centrage sur la page
893 Pareillement, une liste d'éléments ou d'expressions sera répartie sur
894 une ligne entière, voire même centrée sur toute la page s'il n'y a qu'un
895 seul élément. De telles expressions peuvent à leur tour contenir du
896 texte multi-ligne ou une autre expression @emph{markup}.
898 @lilypond[quote,verbatim]
901 \line { William S. Gilbert }
903 \huge \smallCaps "The Mikado"
905 \smallCaps "The Town of Titipu"
907 \line { Sir Arthur Sullivan }
915 @cindex plusieurs lignes de texte
916 @cindex justifié, texte
917 @cindex texte justifié
918 @cindex texte sur plusieurs lignes
919 @cindex markup, texte wordwrapped
920 @cindex markup, texte justifié
927 Les indications textuelles, lorsqu'elles sont relativement longues,
928 peuvent se répartir sur plusieurs lignes en fonction de la largeur de
929 ligne. Le texte sera alors soit aligné à gauche, soit justifié, comme
930 le montre l'exemple suivant@tie{}:
932 @lilypond[quote,verbatim]
935 \line \smallCaps { La vida breve }
936 \line \bold { Acto I }
938 (La escena representa el corral de una casa de
939 gitanos en el Albaicín de Granada. Al fondo una
940 puerta por la que se ve el negro interior de
941 una Fragua, iluminado por los rojos resplandores
946 \line \bold { Acto II }
947 \override #'(line-width . 50)
949 (Calle de Granada. Fachada de la casa de Carmela
950 y su hermano Manuel con grandes ventanas abiertas
951 a través de las que se ve el patio
952 donde se celebra una alegre fiesta)
958 @cindex commandes d'alignement du texte
959 @cindex markup, commandes d'alignement du texte
960 @cindex alignement du texte, commandes
962 Une liste des différentes commandes permettant d'aligner du texte en
963 mode @emph{markup} est disponible à l'annexe @ref{Align}.
967 Manuel d'initiation :
968 @rlearning{Déplacement d'objets}.
972 @ref{Indications textuelles}.
977 Référence des propriétés internes :
978 @rinternals{TextScript}.
980 Fichiers d'initialisation :
981 @file{scm/@/define@/-markup@/-commands@/.scm}.
984 @node Éléments graphiques dans du texte formaté
985 @unnumberedsubsubsec Éléments graphiques dans du texte formaté
986 @translationof Graphic notation inside markup
988 @cindex graphisme, tracé
989 @cindex tracé d'objets graphiques
990 @cindex graphiques, tracé d'objets
991 @cindex embedding graphic objects
992 @cindex objets graphiques, tracé
994 Vous pouvez, grâce aux mode @emph{markup}, ajouter divers objets
995 graphiques à votre partition.
997 @cindex décoration du texte
998 @cindex encadrement du texte
999 @cindex texte, encadrement
1000 @cindex texte, décoration
1001 @cindex markup, ornementation du texte
1002 @cindex markup, encadrement du texte
1008 @funindex \rounded-box
1009 @funindex rounded-box
1015 Certaines commandes de @emph{markup} permettent d'ornementer des
1016 éléments textuels avec des graphismes, à l'instar de l'exemple suivant@tie{}:
1018 @lilypond[quote,verbatim]
1019 \markup \fill-line {
1027 \bracket "1866 - 1925"
1030 \rounded-box \bold Prelude
1035 @cindex espacement autour du texte
1036 @cindex texte et rembourrage
1037 @cindex markup, rembourrage du texte
1039 @funindex \pad-markup
1040 @funindex pad-markup
1043 @funindex \pad-to-box
1044 @funindex pad-to-box
1045 @funindex \pad-around
1046 @funindex pad-around
1048 Certaines directives peuvent nécessiter d'accroître l'espacement autour
1049 du texte -- voir l'annexe @ref{Align} pour une liste des différentes
1050 commandes particulières au mode @emph{markup} ainsi que leur description.
1052 @lilypond[quote,verbatim]
1053 \markup \fill-line {
1055 \box "Charles Ives (1874 - 1954)"
1057 \box \pad-markup #2 "THE UNANSWERED QUESTION"
1058 \box \pad-x #8 "A Cosmic Landscape"
1065 \box \pad-to-box #'(-5 . 20) #'(0 . 5)
1066 \bold "Largo to Presto"
1069 "String quartet keeps very even time,
1070 Flute quartet keeps very uneven time."
1074 @cindex graphisme dans la notation
1075 @cindex symboles non musicaux
1076 @cindex non musicaux, symboles
1077 @cindex notation et graphisme
1081 @funindex \draw-circle
1082 @funindex draw-circle
1083 @funindex \filled-box
1084 @funindex filled-box
1087 @funindex \draw-line
1089 @funindex \arrow-head
1090 @funindex arrow-head
1092 Vous pouvez imprimer certains graphismes ou symboles sans qu'il n'y
1093 ait de texte. Ces objets peuvent même se combiner, à l'instar de
1094 n'importe quelle expression @emph{markup}.
1096 @lilypond[quote,verbatim]
1099 \draw-circle #4 #0.4 ##f
1100 \filled-box #'(-4 . 4) #'(-0.5 . 0.5) #1
1106 \draw-line #'(0 . 4)
1107 \arrow-head #Y #DOWN ##f
1112 @cindex intégration de graphiques
1113 @cindex images, intégration
1114 @cindex graphiques, intégration
1119 @funindex \postscript
1120 @funindex postscript
1122 Des fonctionnalités graphiques avancées vous permettent même d'inclure
1123 dans une partition un fichier image converti au format PostScript
1124 encapsulé (extension @code{eps}), ou bien de tracer un graphique
1125 directement dans le fichier source à partir d'instructions PostScript
1126 pures. Nous vous conseillons, en pareil cas, de toujours spécifier les
1127 dimensions du dessin, comme dans ce qui suit@tie{}:
1129 @lilypond[quote,verbatim,relative=1]
1132 \epsfile #X #10 #"./context-example.eps"
1133 \with-dimensions #'(0 . 6) #'(0 . 10)
1149 L'annexe @ref{Graphic} répertorie les différentes commandes en matière
1154 Manuel de notation :
1156 @ref{Notation éditoriale}.
1161 Référence des propriétés internes :
1162 @rinternals{TextScript}.
1164 Fichiers d'initialisation :
1165 @file{scm/@/define@/-markup@/-commands@/.scm},
1166 @file{scm/@/stencil@/.scm}.
1169 @node Notation musicale dans du texte formaté
1170 @unnumberedsubsubsec Notation musicale dans du texte formaté
1171 @translationof Music notation inside markup
1173 @cindex notation dans un markup
1174 @cindex musique dans un markup
1175 @cindex markup, inclusion de musique
1177 Divers éléments de notation peuvent orner une partition, au moyen d'un
1178 objet @emph{markup}.
1180 Notes et altérations sont données à l'aide d'instructions
1181 @emph{markup}@tie{}:
1183 @lilypond[quote,verbatim,relative=2]
1187 \note-by-number #1 #1 #1.5
1190 \natural \semiflat \flat
1191 \sesquiflat \doubleflat
1195 \natural \semisharp \sharp
1196 \sesquisharp \doublesharp
1201 Le mode @emph{markup} permet d'accéder à d'autres objets de
1204 @lilypond[quote,verbatim,relative=1]
1211 fis_\markup { \dynamic rf }
1222 En règle générale, tout symbole musical peut être inclus dans un
1223 @emph{markup}, comme le montre l'exemple qui suit. Ces différents
1224 symboles sont répertoriés dans l'annexe @ref{La fonte Feta}.
1226 @lilypond[quote,verbatim,relative=2]
1228 c'^\markup { \musicglyph #"eight" }
1230 c,8._\markup { \musicglyph #"clefs.G_change" }
1232 c2^\markup { \musicglyph #"timesig.neomensural94" }
1235 Le sous-chapitre @ref{Tout savoir sur les fontes} contient d'autres
1236 informations sur l'impression de glyphes non alphabétiques, tels que des
1237 crochets ou accolades.
1239 Le mode @emph{markup} supporte aussi les diagrammes spécifiques à
1240 certains instruments@tie{}:
1242 @lilypond[quote,verbatim,relative=2]
1244 \fret-diagram-terse #"x;x;o;2;3;2;"
1247 \harp-pedal #"^-v|--ov^"
1252 \musicglyph #"accordion.accDiscant"
1254 \raise #0.5 \musicglyph #"accordion.accDot"
1255 \raise #1.5 \musicglyph #"accordion.accDot"
1259 @c The accordion diagram is actually taken from a snippet.
1262 La documentation sur ces diagrammes se trouvent à l'annexe
1263 @ref{Instrument Specific Markup}.
1265 @cindex partition incluse dans un markup
1266 @cindex markup, inclusion de partition
1268 Rien ne s'oppose à ce qu'une étiquette ne comporte une partition. Il
1269 suffit que l'expression en question contienne un bloc @code{\score} et
1270 un bloc @code{\layout}.
1272 @lilypond[quote,verbatim,ragged-right]
1276 \relative { c4 d e f }
1284 Les différentes commandes @emph{markup} relatives à la notation musicale
1285 sont répertoriées à l'annexe @ref{Music}.
1289 Manuel de notation :
1291 @ref{La fonte Feta},
1292 @ref{Tout savoir sur les fontes}.
1297 Référence des propriétés internes :
1298 @rinternals{TextScript}.
1300 Fichiers d'initialisation :
1301 @file{scm/@/define@/-markup@/-commands@/.scm},
1302 @file{scm/@/fret@/-diagrams@/.scm},
1303 @file{scm/@/harp@/-pedals@/.scm}.
1306 @node Texte avec sauts de page
1307 @unnumberedsubsubsec Texte avec sauts de page
1308 @translationof Page wrapping text
1310 @cindex multi-page, markup
1311 @cindex markup multi-page
1312 @cindex markup, texte multi-page
1313 @cindex plusieurs pages de texte
1315 @funindex \markuplines
1316 @funindex markuplines
1317 @funindex \justified-lines
1318 @funindex justified-lines
1319 @funindex \wordwrap-lines
1320 @funindex wordwrap-lines
1322 Alors que @code{\markup} s'utilise pour traiter un bloc de texte
1323 insécable, @code{\markuplines} permet, employé en tête de partition,
1324 d'obtenir un bloc de lignes réparties différemment et, le cas échéant,
1325 sur plusieurs pages.
1328 @lilypond[quote,verbatim]
1331 Un long texte constitué de lignes justifiées.
1335 Un autre grand paragraphe.
1342 Cette syntaxe prend en charge une liste de @emph{markups}@tie{}; il peut
1346 d'une suite de commandes générant à leur tour des lignes de texte,
1348 d'une liste de lignes de texte,
1350 d'une liste d'étiquettes.
1353 Les différentes commandes permettant de générer des listes de lignes
1354 se trouve dans l'annexe @ref{Text markup list commands}.
1358 Manuel de notation :
1359 @ref{Text markup list commands},
1364 @c en attendant redécoupage et création de "extending" -jcm
1366 @c @rextend{New markup list command definition}.
1368 Référence des propriétés internes :
1369 @rinternals{TextScript}.
1371 Fichiers d'initialisation :
1372 @file{scm/@/define@/-markup@/-commands@/.scm}.
1375 @funindex \markuplines
1376 @funindex markuplines
1379 @code{\markuplines}.
1385 @translationof Fonts
1387 Ce chapitre est consacré aux fontes et polices de caractère, à leur
1388 gestion. Vous y apprendrez aussi comment changer de fonte en cours de
1392 * Tout savoir sur les fontes::
1393 * Attribution d'une fonte en particulier::
1394 * Choix des fontes par défaut::
1397 @node Tout savoir sur les fontes
1398 @unnumberedsubsubsec Tout savoir sur les fontes
1399 @translationof Fonts explained
1402 @cindex fontes, généralités
1403 @cindex accolades, taille
1404 @cindex fontes et markup
1405 @cindex markup et fontes
1407 @funindex font-interface
1409 La gestion des fontes est assurée par plusieurs bibliothèques@tie{}:
1410 FontConfig se charge de répertorier les différentes fontes installées
1411 sur votre système@tie{}; quant à Pango, elle se charge plus
1412 particulièrement de leur rendu.
1414 Les fontes musicales peuvent se décrire comme un jeu de glyphes
1415 spécifiques regroupés dans plusieurs familles. L'exemple qui suit
1416 montre la syntaxe à utiliser pour accéder, en mode @emph{markup}, aux
1417 différentes fontes @code{feta} non textuelles de LilyPond.
1419 @lilypond[quote,verbatim,relative=2]
1422 \override #'(font-encoding . fetaBraces)
1424 \override #'(font-encoding . fetaNumber)
1426 \override #'(font-encoding . fetaDynamic)
1428 \override #'(font-encoding . fetaMusic)
1429 \lookup #"noteheads.s0petrucci"
1435 Tous ces glyphes, à l'exception des accolades qui sont regroupées dans
1436 @code{fetaBraces}, sont accessibles avec la syntaxe indiquée dans
1437 @ref{Notation musicale dans du texte formaté}.
1439 Une remarque s'impose au sujet des glyphes contenus dans
1440 @code{fetaBraces}@tie{}: chacun d'eux est formé du mot @emph{brace}
1441 auquel est accolé un numéro d'ordre. Lorsque vous désirez imprimer une
1442 accolade, vous devez la @qq{chercher} par son numéro d'ordre -- d'où la
1443 fonction @code{\lookup} de l'exemple ci-dessus --, tout en sachant qu'il
1444 est compris entre @code{0} (la plus petite) et @code{575} (la plus
1445 grande). Vous serez souvent amené à procéder par tatonnement pour
1446 arriver au résultat optimal. Par ailleurs, @code{fetaBraces} ne
1447 comporte que des accolades ouvrantes. Pour obtenir une accolade
1448 fermante, il suffit d'appliquer une rotation au glyphe sélectionné,
1449 comme indiqué au chapitre @ref{Rotation des objets}.
1451 Vous disposez de trois familles de fontes textuelles@tie{}: @emph{roman}
1452 pour la police sérif ou avec empattement -- fixée par défaut à New
1453 Century Schoolbook --, une police sans empattement (@emph{sans} sérif)
1454 et une à chasse fixe (ou monospace) -- les deux dernières étant
1455 déterminées par l'installation de Pango.
1457 Chaque famille dispose en principe de différents styles et niveau de
1458 gras. L'exemple qui suit illustre la manière de changer la famille, le
1459 style, la graisse ou la taille. Notez bien que l'argument fourni à
1460 @code{font-size} correspond à la correction à apporter à la taille par
1463 @lilypond[quote,verbatim,relative=2]
1464 \override Score.RehearsalMark #'font-family = #'typewriter
1465 \mark \markup "Ouverture"
1466 \override Voice.TextScript #'font-shape = #'italic
1467 \override Voice.TextScript #'font-series = #'bold
1468 d2.^\markup "Allegro"
1469 \override Voice.TextScript #'font-size = #-3
1474 Cette syntaxe s'applique aussi en mode @emph{markup}, bien que celui-ci
1475 dispose d'une syntaxe allégée comme nous l'avons vu dans
1476 @ref{Sélection de la fonte et de la taille}@tie{}:
1478 @lilypond[quote,verbatim]
1482 \override #'(font-shape . italic)
1483 \override #'(font-size . 4)
1487 \override #'(font-family . typewriter)
1489 \override #'(font-series . bold)
1493 \override #'(font-family . sans)
1500 En plus de pouvoir jongler entre les différentes fontes prédéfinies,
1501 LilyPond vous permet d'en utiliser d'autres, ce qui fait l'objet des
1502 deux prochaines parties@tie{}:
1503 @ref{Attribution d'une fonte en particulier}
1504 et @ref{Choix des fontes par défaut}.
1508 Manuel de notation :
1509 @ref{La fonte Feta},
1510 @ref{Notation musicale dans du texte formaté},
1511 @ref{Sélection de la fonte et de la taille},
1515 @node Attribution d'une fonte en particulier
1516 @unnumberedsubsubsec Attribution d'une fonte en particulier
1517 @translationof Single entry fonts
1519 Vous pouvez utiliser n'importe quelle police installée sur votre
1520 système, du moment où elle est accessible par Fontconfig, en respectant
1521 la syntaxe suivante@tie{}:
1523 @lilypond[quote,verbatim,relative=2]
1524 \override Staff.TimeSignature #'font-name = #"Bitstream Charter"
1525 \override Staff.TimeSignature #'font-size = #2
1529 \override #'(font-name . "Vera Bold")
1534 @cindex fontes disponibles
1535 @cindex disponibilité des fontes
1537 @funindex show-available-fonts
1539 Pour obtenir la liste de toutes les polices disponibles sur votre
1543 lilypond -dshow-available-fonts toto
1546 (quel qu'il soit, le dernier argument est obligatoire).
1550 Manuel de notation :
1551 @ref{Tout savoir sur les fontes},
1552 @ref{Choix des fontes par défaut}.
1557 @c A source file gets never installed...
1558 @c Fichiers d'initialisation :
1559 @c @file{lily/@/font@/-config@/-scheme@/.cc}.
1562 @node Choix des fontes par défaut
1563 @unnumberedsubsubsec Choix des fontes par défaut
1564 @translationof Entire document fonts
1566 Vous pouvez tout à fait préférer un autre jeu de polices par défaut que
1567 celui de LilyPond. Il vous faudra alors spécifier les différentes
1568 familles, en respectant l'ordre @emph{roman}, @emph{sans empattement} et
1569 @emph{monospace}, comme dans l'exemple suivant. Pour plus
1570 d'explications sur les fontes, relisez @ref{Tout savoir sur les fontes}.
1572 @cindex polices, choix par défaut
1573 @cindex fontes, choix par défaut
1575 @funindex make-pango-font-tree
1577 @lilypond[verbatim,quote]
1581 (make-pango-font-tree "Times New Roman"
1584 (/ myStaffSize 20)))
1591 \typewriter typewriter. }
1595 @c we don't do Helvetica / Courier, since GS incorrectly loads
1600 Manuel de notation :
1601 @ref{Tout savoir sur les fontes},
1602 @ref{Attribution d'une fonte en particulier},
1603 @ref{Sélection de la fonte et de la taille},