1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
3 Translation of GIT committish: c2e8b1d6d671dbfc138f890cbc7e9882b7be2761
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
12 @c Translation checkers: Valentin Villenave, John Mandereau
18 @lilypondfile[quote]{text-headword.ly}
20 Nous allons voir ici comment insérer du texte dans une partition, ainsi que
21 différentes manières de le mettre en forme.
24 Certains éléments de texte ne sont pas abordés ici mais dans des
25 chapitres qui leur sont dédiés. C'est le cas de la
26 @ref{Musique vocale} et des @ref{Titres et entêtes}.
30 * Mise en forme du texte::
35 @subsection Ajout de texte
36 @translationof Writing text
38 Cette partie constitue une introduction aux différentes manières
39 d'ajouter du texte à une partition.
41 @cindex Texte, autres langues
42 @warning{Pour écrire des accents et autres caractères spéciaux, il suffit de
43 les insérer directement dans votre fichier LilyPond. Ce fichier devra
44 être sauvegardé avec l'encodage UTF-8. Pour plus d'informations, voir
45 @ref{Codage du texte}.}
48 * Commentaires textuels::
49 * Indications textuelles et lignes d'extension::
50 * Indications textuelles::
54 @node Commentaires textuels
55 @unnumberedsubsubsec Commentaires textuels
56 @translationof Text scripts
58 @cindex Étiquette de texte
59 @cindex blocs de texte
60 @cindex ajout de texte
62 Vous pouvez ajouter à une partition des indications sous forme texuelle,
63 comme dans l'exemple suivant. Ces indications se placeront manuellement
64 au-dessus ou au-dessous de la portée selon la syntaxe utilisée -- cf.
65 @ref{Direction et positionnement}.
67 @lilypond[quote,verbatim,relative=2]
68 a8^"pizz." g f e a4-"scherz." f
71 Cette syntaxe est en fait un raccourci. Des constructions plus
72 élaborées d'annotation peuvent être obtenues en ayant recours à un bloc
73 @code{\markup} et selon les préceptes énoncés dans
74 @ref{Mise en forme du texte}.
76 @lilypond[quote,verbatim,relative=2]
77 a8^\markup { \italic pizz. } g f e
78 a4_\markup { \tiny scherz. \bold molto } f
81 Par défaut, ces indications n'affectent en rien l'espacement des
82 notes. Leur longueur peut néanmoins être prise en considération : dans
83 l'exemple qui suit, le premier commentaire n'influe pas sur
84 l'espacement, à l'inverse du second.
86 @lilypond[quote,verbatim,relative=2]
93 @funindex \textLengthOn
94 @funindex textLengthOn
95 @funindex \textLengthOff
96 @funindex textLengthOff
100 @code{\textLengthOff}.
106 @ref{Mise en forme du texte},
107 @ref{Direction et positionnement}.
112 Référence des propriétés internes :
113 @rinternals{TextScript}.
116 @cindex texte hors marges
117 @cindex marges, texte qui dépasse
118 @cindex texte, maintien dans les marges
119 @cindex texte, maintien dans les marges
124 S'assurer que tous les éléments textuels et les paroles respectent
125 les marges du document requiert des calculs relativement lourds ; c'est
126 la raison pour laquelle LilyPond, par défaut, ne s'en préoccupe pas.
127 Vous pouvez cependant l'y forcer en définissant
130 \override Score.PaperColumn #'keep-inside-line = ##t
134 @node Indications textuelles et lignes d'extension
135 @unnumberedsubsubsec Indications textuelles et lignes d'extension
136 @translationof Text spanners
138 @cindex texte et extenseur
139 @cindex prolongation de texte
142 Certaines indications d'interprétation comme @i{rallentando},
143 @i{accelerando} ou @i{trilles}, s'incrivent textuellement et se
144 prolongent sur plusieurs notes à l'aide d'une ligne pleine, pointillée
145 ou ondulée. Ces objets, que l'on appelle @qq{extenseurs}, se dessinent
146 entre deux notes à l'aide de la syntaxe suivante :
148 @lilypond[verbatim,quote,relative=2]
149 \override TextSpanner #'(bound-details left text) = "rit."
154 @cindex texte, mise en forme des prolongations
155 @cindex texte, mise en forme des extenseurs
156 @cindex extenseur, mise en forme
159 Le texte à imprimer est spécifié en tant que propriété de l'objet
160 @code{TextSpanner}. Il apparaîtra par défaut en italique ; cependant,
161 rien ne s'oppose à un autre graphisme dès lors que vous faites appel à
162 un bloc @code{\markup} -- voir @ref{Mise en forme du texte}.
164 @lilypond[quote,relative=2,verbatim]
165 \override TextSpanner #'(bound-details left text) =
166 \markup { \upright "rit." }
171 Le style de ligne se définit lui aussi comme une propriété de l'objet.
172 Les détails concernant la syntaxe à utiliser sont expliqués au chapitre
176 @funindex \textSpannerUp
177 @funindex textSpannerUp
178 @funindex \textSpannerDown
179 @funindex textSpannerDown
180 @funindex \textSpannerNeutral
181 @funindex textSpannerNeutral
185 @code{\textSpannerUp},
186 @code{\textSpannerDown},
187 @code{\textSpannerNeutral}.
199 Référence des propriétés internes :
200 @rinternals{TextSpanner}.
203 @node Indications textuelles
204 @unnumberedsubsubsec Indications textuelles
205 @translationof Text marks
207 @cindex indication textuelle
208 @cindex coda sur une barre de mesure
209 @cindex segno sur une barre de mesure
210 @cindex point d'orgue sur une barre de mesure
211 @cindex barres de mesure, symboles au dessus de
218 La commande @code{\mark} est tout d'abord conçue pour les
219 @ref{Indications de repère}.
221 @c \mark needs to be placed on a separate line (it's not
222 @c attached to an object like \markup is). -vv
224 @lilypond[verbatim,quote,relative=2]
230 Cette syntaxe rend possible l'adjonction de n'importe quel texte à une
231 barre de mesure. Ce texte peut être mis en forme de différentes
232 manières dès lors qu'est utilisé un bloc @code{\markup}, comme indiqué
233 au chapitre @ref{Mise en forme du texte}.
235 @lilypond[quote,verbatim,relative=1]
237 \mark \markup { \italic { colla parte } }
243 Elle peut aussi servir à insérer des signes de @emph{coda} ou de
244 @emph{segno}, ou bien un point d'orgue, au dessus d'une
245 barre de mesure. Couplez-la alors à la commande @code{\markup} pour
246 avoir accès au symbole approprié, selon les indications contenues au
247 chapitre @ref{Notation musicale dans du texte formaté}.
249 @lilypond[quote,verbatim,relative=2]
251 \mark \markup { \musicglyph #"scripts.ufermata" }
256 Le résultat de @code{\mark} n'apparaîtra que sur la portée supérieure
257 d'un système. Si vous introduisez la commande @code{\mark} au moment
258 d'une barre de mesure, la marque se placera au dessus de la barre. Si
259 vous y faites appel au milieu d'une mesure, cette marque sera
260 positionnée entre les notes. Si elle intervient en début de ligne,
261 elle sera placée juste avant la première note de cette portée. Enfin,
262 une marque qui tomberait sur un saut de ligne sera imprimée au début
263 de la ligne suivante.
265 @lilypond[quote,verbatim,relative=2]
275 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
276 {printing-marks-at-the-end-of-a-line.ly}
278 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
279 {aligning-marks-with-various-notation-objects.ly}
281 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
282 {printing-marks-on-every-staff.ly}
287 @ref{Indications de repère},
288 @ref{Mise en forme du texte},
289 @ref{Notation musicale dans du texte formaté},
295 Référence des propriétés internes :
296 @rinternals{MarkEvent},
297 @rinternals{Mark_engraver},
298 @rinternals{RehearsalMark}.
302 @c To be removed when Issue 69 in the tracker gets fixed. -vv
304 Au cas où il n'y aurait pas de ligne à suivre, la marque ne sera pas imprimée.
307 @node Texte indépendant
308 @unnumberedsubsubsec Texte indépendant
309 @translationof Separate text
311 @cindex texte indépendant
313 @cindex texte en préambule
314 @cindex top-level text
315 @cindex text, top-level
316 @cindex text, standalone
321 Un bloc @code{\markup} peut exister en lui-même, indépendamment de tout
322 bloc @code{\score}, et venir en préambule par exemple -- voir le
323 chapitre @ref{Structure de fichier} à ce propos.
325 @lilypond[verbatim,quote]
327 Tomorrow, and tomorrow, and tomorrow...
332 De cette manière, vous pouvez insérer du texte en dehors de la musique.
333 Ceci devient particulièrement utile lorsque le fichier source contient
334 plusieurs morceaux. Pour plus d'informations à ce propos, reportez-vous
335 au chapitre @ref{Plusieurs partitions dans un même ouvrage}.
337 @lilypond[quote,verbatim]
342 Tomorrow, and tomorrow, and tomorrow...
349 Les blocs de textes peuvent s'étendre sur plusieurs pages, ce qui permet
350 de générer des ouvrages complets uniquement grâce à LilyPond. Cette
351 fonctionnalité ainsi que la syntaxe appropriée est abordée plus en
352 détail au chapitre @ref{Texte avec sauts de page}.
357 @funindex \markuplines
358 @funindex markuplines
368 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
369 {stand-alone-two-column-markup.ly}
374 @ref{Mise en forme du texte},
375 @ref{Structure de fichier},
376 @ref{Plusieurs partitions dans un même ouvrage},
377 @ref{Texte avec sauts de page}.
382 Référence des propriétés internes :
383 @rinternals{TextScript}.
387 @node Mise en forme du texte
388 @subsection Mise en forme du texte
389 @translationof Formatting text
391 Nous allons voir dans les lignes qui suivent la manière de mettre en
392 forme du texte à l'aide de la syntaxe propre au mode @code{\markup}.
395 * Introduction au formatage de texte::
396 * Sélection de la fonte et de la taille::
397 * Alignement du texte::
398 * Éléments graphiques dans du texte formaté::
399 * Notation musicale dans du texte formaté::
400 * Texte avec sauts de page::
403 @node Introduction au formatage de texte
404 @unnumberedsubsubsec Introduction au formatage de texte
405 @translationof Text markup introduction
408 @cindex commentaire textuel
409 @cindex étiquette textuelle
415 La commande @code{\markup} permet d'ajouter du texte et dispose de sa
416 propre syntaxe que nous appellerons le @qq{mode @emph{markup}}.
418 @cindex markup, expressions
419 @cindex expressions markup
420 @cindex markup, syntaxe
421 @cindex syntaxe du mode markup
423 La syntaxe du mode @emph{markup} n'est pas différente de celle des
424 autres modes de LilyPond : une expression @code{\markup} est bornée par
425 des accolades @code{@{ @dots{} @}}. Un mot unique sera considéré comme
426 une expression minimale, et n'aura donc pas besoin d'être mis entre
429 Contrairement aux indications simples, du type "entre guillemets", les
430 blocs @code{\markup} peuvent contenir des expressions imbriquées ou
431 d'autres commandes @emph{markup}, dès lors qu'elles sont précédées du
432 caractère @code{\}. Ces commandes n'affecteront que la première
433 expression qui les suit.
435 @lilypond[quote,verbatim,relative=2]
437 a2^\markup { poco \italic più forte }
439 d2_\markup { \italic "string. assai" }
441 b1^\markup { \bold { molto \italic agitato } }
445 @cindex caractères spéciaux en mode markup
446 @cindex mode markup et caractères spéciaux
447 @cindex caractères réservés, impression
448 @cindex impression de caractères réservés
449 @cindex impression de caractères spéciaux
450 @cindex guillemets en mode markup
451 @cindex mode markup et guillemets
453 Un bloc @code{\markup} peut contenir du texte entre guillemets. De
454 telles chaines seront considérées comme des expressions textuelles
455 minimales ; à ce titre, toute commande de type @emph{markup} ou tout
456 caractère spécial -- tel un @code{\} ou un @code{#} -- sera imprimé
457 littéralement et sans influer sur le formatage du texte. Il est de ce
458 fait possible d'imprimer des guillemets informatiques @code{"} dès lors
459 qu'ils sont précédés d'une oblique inverse.
462 @lilypond[quote,verbatim,relative=2]
463 a1^"\italic markup..."
464 a_\markup { \italic "... imprime des lettres en \"italique\" !" }
468 Une liste de mots, pour pouvoir être traitée en tant qu'expression
469 distincte, doit être bornée par des @code{"} ou précédée d'une commande.
470 La manière de définir les expressions @emph{markup} aura une influence
471 sur la manière dont elles seront empilées, centrées ou alignées. Dans
472 l'exemple qui suit, la deuxième expression @code{\markup} est traitée
473 tout comme la première :
475 @lilypond[quote,verbatim,relative=2]
476 c1^\markup { \center-column { a bbb c } }
477 c1^\markup { \center-column { a { bbb c } } }
478 c1^\markup { \center-column { a \line { bbb c } } }
479 c1^\markup { \center-column { a "bbb c" } }
482 Vous pouvez stocker les étiquettes textuelles en tant que variables,
483 et attacher ces identificateurs à des notes, comme ici :
485 @lilypond[quote,verbatim]
486 allegro = \markup { \bold \large Allegro }
495 Pour une liste des différentes commandes spécifiques au mode
496 @code{\markup}, consultez l'annexe @ref{Text markup commands} (en
502 @ref{Text markup commands}.
507 Fichiers d'initialisation :
508 @file{scm/@/markup@/.scm}.
513 Les erreurs de syntaxe en mode @emph{markup} sont peu loquaces.
516 @node Sélection de la fonte et de la taille
517 @unnumberedsubsubsec Sélection de la fonte et de la taille
518 @translationof Selecting font and font size
520 @cindex fonte, changement
521 @cindex changement de fonte
533 Le mode @emph{markup} autorise des changements élémentaires de la fonte :
535 @lilypond[quote,verbatim,relative=2]
538 \italic { non troppo \underline Vivo }
541 d,_\markup { \italic quasi \smallCaps Tromba }
545 @cindex caratères, taille
546 @cindex texte, taille
557 La taille des caractères se modifie de différentes manières :
560 à partir de l'une des tailles standard prédéfinies,
563 en étant définie en valeur absolue,
566 en adoptant une valeur relative à celle précédemment définie.
570 Voici une illustration de ces trois différentes méthodes :
572 @lilypond[quote,verbatim,relative=1]
579 \fontsize #5 Sinfonia
586 \magnify #0.6 { e sentimento } )
599 Vous pouvez imprimer du texte en indice ou en exposant. Celui-ci sera
600 dans un taille plus petite, mais rien ne s'oppose à ce que vous lui
601 affectiez un taille normale :
603 @lilypond[quote,verbatim]
606 \line { 1 \super st movement }
607 \line { 1 \normal-size-super st movement
608 \sub { (part two) } }
613 @cindex fontes, familles
615 Le mode @emph{markup} vous permet de sélectionner d'autres familles de
616 fontes. Par défaut, LilyPond utilise une police avec empattement, du
617 type roman, et tout changement doit être explicite. Dans la dernière
618 ligne de l'exemple qui suit, vous noterez qu'il n'y a aucune différence
619 entre les premier et deuxième mots.
621 @lilypond[quote,verbatim]
624 \line { Act \number 1 }
625 \line { \sans { Scene I. } }
626 \line { \typewriter { Verona. An open place. } }
627 \line { Enter \roman Valentine and Proteus. }
633 Certaines familles de police spécifiques aux nombres ou aux nuances par
634 exemple, ne disposent pas de tous les caractères, comme nous l'avons vu
635 dans les chapitres @ref{Personnalisation des indications de nuance} et
636 @ref{Indications de reprise manuelles}.
638 @c \concat is actually documented in Align (it is not
639 @c a font-switching command). But we need it here. -vv
641 Lorsqu'un changement survient au milieu d'un mot, il se peut qu'un
642 espacement supplémentaire apparaîsse. Il suffit en pareil cas de
643 concaténer les différents éléments :
645 @lilypond[quote,verbatim]
649 \concat { 1 \super st }
653 \concat { \dynamic p , }
654 \italic { con dolce espressione }
660 Une liste des différentes commandes permettant de changer de fonte ou
661 d'utiliser des fontes personnalisées est disponible à l'annexe @ref{Font}.
663 Pour savoir comment personnaliser des fontes, reportez-vous au chapitre
672 @funindex \normalsize
699 @ref{Personnalisation des indications de nuance},
700 @ref{Indications de reprise manuelles},
706 Référence des propriétés internes :
707 @rinternals{TextScript}.
709 Fichiers d'initialisation :
710 @file{scm/@/define@/-markup@/-commands@/.scm}.
713 @node Alignement du texte
714 @unnumberedsubsubsec Alignement du texte
715 @translationof Text alignment
717 @cindex texte, alignement
718 @cindex alignement du texte
719 @cindex alignement des markups
720 @cindex markups, alignement
722 Cette partie traite de la manière de positionner du texte en mode
723 @emph{markup}. On déplace l'intégralité d'un objet @emph{markup} en
724 utilisant la syntaxe décrite au chapitre
725 @rlearning{Déplacement d'objets}.
727 @c Padding commands should be mentioned on this page, but
728 @c most of these require \box to be more clearly illustrated. -vv
730 @cindex texte, alignement horizontal
731 @cindex alignement horizontal du texte
733 @funindex \left-align
735 @funindex \center-align
736 @funindex center-align
737 @funindex \right-align
738 @funindex right-align
740 Les objets de type @emph{markup} peuvent s'aligner de différentes
741 manières. Une indication textuelle est par défaut alignée sur son
742 extrémité gauche. Dans l'exemple qui suit, il n'y a aucune différence
743 entre les deux premiers @emph{markups}.
745 @lilypond[quote,verbatim,relative=2]
748 d-\markup { \left-align poco }
750 d-\markup { \center-align { poco } }
752 d-\markup { \right-align poco }
758 L'alignement horizontal peut être ajusté à l'aide d'une valeur numérique :
760 @lilypond[quote,verbatim,relative=2]
761 a1-\markup { \halign #-1 poco }
763 a,-\markup { \halign #0 poco }
765 a,-\markup { \halign #0.5 poco }
767 a,-\markup { \halign #2 poco }
771 Certains objets possèdent leurs propres procédures d'alignement, qui
772 annuleront toute spécification d'alignement que vous pourriez affecter
773 à un argument de type @emph{markup} que vous leur auriez fourni. La
774 solution consiste alors à déplacer l'intégralité de ces objets
775 @emph{markup}, comme indiqué par exemple au chapitre
776 @ref{Indications textuelles}.
778 @cindex texte, alignement vertical
779 @cindex alignement vertical du texte
788 @c QUERY Should the function of ``\null'' be clarified? rp
790 L'alignement vertical est quant à lui un peu plus compliqué. Comme nous
791 l'avons vu ci-avant, les objets @emph{markup} peuvent être déplacés dans
792 leur intégralité. Il est néanmois possible de déplacer certains
793 éléments spécifiques au sein d'un bloc @emph{markup}. En pareil cas,
794 l'élément à déplacer doit être précédé d'un @qq{point d'ancrage} -- un
795 autre élément du @emph{markup} ou un objet invisible. L'exemple qui
796 suit illustre ces deux possibilités. Vous noterez par ailleurs que le
797 dernier @emph{markup}, dépourvu de point d'ancrage, n'est de ce fait pas
800 @lilypond[quote,verbatim,relative=1]
803 \raise #2 { Scène 1 }
808 \lower #4 \bold { Très modéré }
812 \raise #4 \italic { Une forêt. }
817 @funindex \general-align
818 @funindex general-align
821 @funindex \translate-scaled
822 @funindex translate-scaled
824 Certaines commandes permettent de régler l'alignement des objets
825 textuels en mode @emph{markup}, tant au niveau horizontal que vertical.
826 Tout objet soumis à ces commandes doit être précédé d'un point d'ancrage.
828 @lilypond[quote,verbatim,relative=1]
831 \translate #'(-1 . 2) "Scène 1"
836 \general-align #Y #3.2 \bold "Très modéré"
841 \translate-scaled #'(-1 . 2) \teeny "Une forêt."
846 @cindex multi-ligne, markup
847 @cindex markup multi-ligne
848 @cindex multi-ligne, texte
849 @cindex texte multi-ligne
850 @cindex texte en colonnes
851 @cindex colonnes de texte
855 @funindex \center-column
856 @funindex center-column
858 Un objet de type @emph{markup} peut contenir plusieurs lignes de texte.
859 Dans l'exemple suivant, chaque élément ou expression ira se placer sur
860 sa propre ligne, tantôt alignée à gauche, tantôt centrée.
862 @lilypond[quote,verbatim]
878 @cindex centrage du texte sur la page
879 @cindex texte, centrage sur la page
880 @cindex markup, centrage sur la page
885 Pareillement, une liste d'éléments ou d'expressions sera répartie sur
886 une ligne entière, voire même centrée sur toute la page s'il n'y a qu'un
887 seul élément. De telles expressions peuvent à leur tour contenir du
888 texte multi-ligne ou une autre expression @emph{markup}.
890 @lilypond[quote,verbatim]
893 \line { William S. Gilbert }
895 \huge \smallCaps "The Mikado"
897 \smallCaps "The Town of Titipu"
899 \line { Sir Arthur Sullivan }
907 @cindex plusieurs lignes de texte
908 @cindex justifié, texte
909 @cindex texte justifié
910 @cindex texte sur plusieurs lignes
911 @cindex markup, texte wordwrapped
912 @cindex markup, texte justifié
919 Les indications textuelles, lorsqu'elles sont relativement longues,
920 peuvent se répartir sur plusieurs lignes en fonction de la largeur de
921 ligne. Le texte sera alors soit aligné à gauche, soit justifié, comme
922 le montre l'exemple suivant :
924 @lilypond[quote,verbatim]
927 \line \smallCaps { La vida breve }
928 \line \bold { Acto I }
930 (La escena representa el corral de una casa de
931 gitanos en el Albaicín de Granada. Al fondo una
932 puerta por la que se ve el negro interior de
933 una Fragua, iluminado por los rojos resplandores
938 \line \bold { Acto II }
939 \override #'(line-width . 50)
941 (Calle de Granada. Fachada de la casa de Carmela
942 y su hermano Manuel con grandes ventanas abiertas
943 a través de las que se ve el patio
944 donde se celebra una alegre fiesta)
950 @cindex commandes d'alignement du texte
951 @cindex markup, commandes d'alignement du texte
952 @cindex alignement du texte, commandes
954 Une liste des différentes commandes permettant d'aligner du texte en
955 mode @emph{markup} est disponible à l'annexe @ref{Align}.
959 Manuel d'initiation :
960 @rlearning{Déplacement d'objets}.
964 @ref{Indications textuelles}.
969 Référence des propriétés internes :
970 @rinternals{TextScript}.
972 Fichiers d'initialisation :
973 @file{scm/@/define@/-markup@/-commands@/.scm}.
976 @node Éléments graphiques dans du texte formaté
977 @unnumberedsubsubsec Éléments graphiques dans du texte formaté
978 @translationof Graphic notation inside markup
980 @cindex graphisme, tracé
981 @cindex tracé d'objets graphiques
982 @cindex graphiques, tracé d'objets
983 @cindex embedding graphic objects
984 @cindex objets graphiques, tracé
986 Vous pouvez, grâce aux mode @emph{markup}, ajouter divers objets
987 graphiques à votre partition.
989 @cindex décoration du texte
990 @cindex encadrement du texte
991 @cindex texte, encadrement
992 @cindex texte, décoration
993 @cindex markup, ornementation du texte
994 @cindex markup, encadrement du texte
1000 @funindex \rounded-box
1001 @funindex rounded-box
1007 Certaines commandes de @emph{markup} permettent d'ornementer des
1008 éléments textuels avec des graphismes, à l'instar de l'exemple suivant :
1010 @lilypond[quote,verbatim]
1011 \markup \fill-line {
1019 \bracket "1866 - 1925"
1022 \rounded-box \bold Prelude
1027 @cindex espacement autour du texte
1028 @cindex texte et rembourrage
1029 @cindex markup, rembourrage du texte
1031 @funindex \pad-markup
1032 @funindex pad-markup
1035 @funindex \pad-to-box
1036 @funindex pad-to-box
1037 @funindex \pad-around
1038 @funindex pad-around
1040 Certaines directives peuvent nécessiter d'accroître l'espacement autour
1041 du texte -- voir l'annexe @ref{Align} pour une liste des différentes
1042 commandes particulières au mode @emph{markup} ainsi que leur description.
1044 @lilypond[quote,verbatim]
1045 \markup \fill-line {
1047 \box "Charles Ives (1874 - 1954)"
1049 \box \pad-markup #2 "THE UNANSWERED QUESTION"
1050 \box \pad-x #8 "A Cosmic Landscape"
1057 \box \pad-to-box #'(-5 . 20) #'(0 . 5)
1058 \bold "Largo to Presto"
1061 "String quartet keeps very even time,
1062 Flute quartet keeps very uneven time."
1066 @cindex graphisme dans la notation
1067 @cindex symboles non musicaux
1068 @cindex non musicaux, symboles
1069 @cindex notation et graphisme
1073 @funindex \draw-circle
1074 @funindex draw-circle
1075 @funindex \filled-box
1076 @funindex filled-box
1079 @funindex \draw-line
1081 @funindex \arrow-head
1082 @funindex arrow-head
1084 Vous pouvez imprimer certains graphismes ou symboles sans qu'il n'y
1085 ait de texte. Ces objets peuvent même se combiner, à l'instar de
1086 n'importe quelle expression @emph{markup}.
1088 @lilypond[quote,verbatim]
1091 \draw-circle #4 #0.4 ##f
1092 \filled-box #'(-4 . 4) #'(-0.5 . 0.5) #1
1098 \draw-line #'(0 . 4)
1099 \arrow-head #Y #DOWN ##f
1104 @cindex intégration de graphiques
1105 @cindex images, intégration
1106 @cindex graphiques, intégration
1111 @funindex \postscript
1112 @funindex postscript
1114 Des fonctionnalités graphiques avancées vous permettent même d'inclure
1115 dans une partition un fichier image converti au format PostScript
1116 encapsulé (extension @code{eps}), ou bien de tracer un graphique
1117 directement dans le fichier source à partir d'instructions PostScript
1118 pures. Nous vous conseillons, en pareil cas, de toujours spécifier les
1119 dimensions du dessin, comme dans ce qui suit :
1121 @lilypond[quote,verbatim,relative=1]
1124 \epsfile #X #10 #"./context-example.eps"
1125 \with-dimensions #'(0 . 6) #'(0 . 10)
1141 L'annexe @ref{Graphic} répertorie les différentes commandes en matière
1146 Manuel de notation :
1148 @ref{Notation éditoriale}.
1153 Référence des propriétés internes :
1154 @rinternals{TextScript}.
1156 Fichiers d'initialisation :
1157 @file{scm/@/define@/-markup@/-commands@/.scm},
1158 @file{scm/@/stencil@/.scm}.
1161 @node Notation musicale dans du texte formaté
1162 @unnumberedsubsubsec Notation musicale dans du texte formaté
1163 @translationof Music notation inside markup
1165 @cindex notation dans un markup
1166 @cindex musique dans un markup
1167 @cindex markup, inclusion de musique
1169 Divers éléments de notation peuvent orner une partition, au moyen d'un
1170 objet @emph{markup}.
1172 Notes et altérations sont données à l'aide d'instructions @emph{markup} :
1174 @lilypond[quote,verbatim,relative=2]
1178 \note-by-number #1 #1 #1.5
1181 \natural \semiflat \flat
1182 \sesquiflat \doubleflat
1186 \natural \semisharp \sharp
1187 \sesquisharp \doublesharp
1192 Le mode @emph{markup} permet d'accéder à d'autres objets de notation :
1194 @lilypond[quote,verbatim,relative=1]
1201 fis_\markup { \dynamic rf }
1212 En règle générale, tout symbole musical peut être inclus dans un
1213 @emph{markup}, comme le montre l'exemple qui suit. Ces différents
1214 symboles sont répertoriés dans l'annexe @ref{La fonte Feta}.
1216 @lilypond[quote,verbatim,relative=2]
1218 c'^\markup { \musicglyph #"eight" }
1220 c,8._\markup { \musicglyph #"clefs.G_change" }
1222 c2^\markup { \musicglyph #"timesig.neomensural94" }
1225 Le sous-chapitre @ref{Tout savoir sur les fontes} contient d'autres
1226 informations sur l'impression de glyphes non alphabétiques, tels que des
1227 crochets ou accolades.
1229 Le mode @emph{markup} supporte aussi les diagrammes spécifiques à
1230 certains instruments :
1232 @lilypond[quote,verbatim,relative=2]
1234 \fret-diagram-terse #"x;x;o;2;3;2;"
1237 \harp-pedal #"^-v|--ov^"
1242 \musicglyph #"accordion.accDiscant"
1244 \raise #0.5 \musicglyph #"accordion.accDot"
1245 \raise #1.5 \musicglyph #"accordion.accDot"
1249 @c The accordion diagram is actually taken from a snippet.
1252 La documentation sur ces diagrammes se trouvent à l'annexe
1253 @ref{Instrument Specific Markup}.
1255 @cindex partition incluse dans un markup
1256 @cindex markup, inclusion de partition
1258 Rien ne s'oppose à ce qu'une étiquette ne comporte une partition. Il
1259 suffit que l'expression en question contienne un bloc @code{\score} et
1260 un bloc @code{\layout}.
1262 @lilypond[quote,verbatim,ragged-right]
1266 \relative { c4 d e f }
1274 Les différentes commandes @emph{markup} relatives à la notation musicale
1275 sont répertoriées à l'annexe @ref{Music}.
1279 Manuel de notation :
1281 @ref{La fonte Feta},
1282 @ref{Tout savoir sur les fontes}.
1287 Référence des propriétés internes :
1288 @rinternals{TextScript}.
1290 Fichiers d'initialisation :
1291 @file{scm/@/define@/-markup@/-commands@/.scm},
1292 @file{scm/@/fret@/-diagrams@/.scm},
1293 @file{scm/@/harp@/-pedals@/.scm}.
1296 @node Texte avec sauts de page
1297 @unnumberedsubsubsec Texte avec sauts de page
1298 @translationof Page wrapping text
1300 @cindex multi-page, markup
1301 @cindex markup multi-page
1302 @cindex markup, texte multi-page
1303 @cindex plusieurs pages de texte
1305 @funindex \markuplines
1306 @funindex markuplines
1307 @funindex \justified-lines
1308 @funindex justified-lines
1309 @funindex \wordwrap-lines
1310 @funindex wordwrap-lines
1312 Alors que @code{\markup} s'utilise pour traiter un bloc de texte
1313 insécable, @code{\markuplines} permet, employé en tête de partition,
1314 d'obtenir un bloc de lignes réparties différemment et, le cas échéant,
1315 sur plusieurs pages.
1318 @lilypond[quote,verbatim]
1321 Un long texte constitué de lignes justifiées.
1325 Un autre grand paragraphe.
1332 Cette syntaxe prend en charge une liste de @emph{markups} ; il peut s'agir
1335 d'une suite de commandes générant à leur tour des lignes de texte,
1337 d'une liste de lignes de texte,
1339 d'une liste d'étiquettes.
1342 Les différentes commandes permettant de générer des listes de lignes
1343 se trouve dans l'annexe @ref{Text markup list commands}.
1347 Manuel de notation :
1348 @ref{Text markup list commands},
1353 @c en attendant redécoupage et création de "extending" -jcm
1355 @c @rextend{New markup list command definition}.
1357 Référence des propriétés internes :
1358 @rinternals{TextScript}.
1360 Fichiers d'initialisation :
1361 @file{scm/@/define@/-markup@/-commands@/.scm}.
1364 @funindex \markuplines
1365 @funindex markuplines
1368 @code{\markuplines}.
1374 @translationof Fonts
1376 Ce chapitre est consacré aux fontes et polices de caractère, à leur
1377 gestion. Vous y apprendrez aussi comment changer de fonte en cours de
1381 * Tout savoir sur les fontes::
1382 * Attribution d'une fonte en particulier::
1383 * Choix des fontes par défaut::
1386 @node Tout savoir sur les fontes
1387 @unnumberedsubsubsec Tout savoir sur les fontes
1388 @translationof Fonts explained
1391 @cindex fontes, généralités
1392 @cindex accolades, taille
1393 @cindex fontes et markup
1394 @cindex markup et fontes
1396 @funindex font-interface
1398 La gestion des fontes est assurée par plusieurs bibliothèques :
1399 FontConfig se charge de répertorier les différentes fontes installées
1400 sur votre système ; quant à Pango, elle se charge plus particulièrement
1403 Les fontes musicales peuvent se décrire comme un jeu de glyphes
1404 spécifiques regroupés dans plusieurs familles. L'exemple qui suit
1405 montre la syntaxe à utiliser pour accéder, en mode @emph{markup}, aux
1406 différentes fontes @code{feta} non textuelles de LilyPond.
1408 @lilypond[quote,verbatim,relative=2]
1411 \override #'(font-encoding . fetaBraces)
1413 \override #'(font-encoding . fetaNumber)
1415 \override #'(font-encoding . fetaDynamic)
1417 \override #'(font-encoding . fetaMusic)
1418 \lookup #"noteheads.s0petrucci"
1424 Tous ces glyphes, à l'exception des accolades qui sont regroupées dans
1425 @code{fetaBraces}, sont accessibles avec la syntaxe indiquée dans
1426 @ref{Notation musicale dans du texte formaté}.
1428 Une remarque s'impose au sujet des glyphes contenus dans
1429 @code{fetaBraces} : chacun d'eux est formé du mot @emph{brace} auquel
1430 est accolé un numéro d'ordre. Lorsque vous désirez imprimer une
1431 accolade, vous devez la @qq{chercher} par son numéro d'ordre -- d'où la
1432 fonction @code{\lookup} de l'exemple ci-dessus --, tout en sachant qu'il
1433 est compris entre @code{0} (la plus petite) et @code{575} (la plus
1434 grande). Vous serez souvent amené à procéder par tatonnement pour
1435 arriver au résultat optimal. Par ailleurs, @code{fetaBraces} ne
1436 comporte que des accolades ouvrantes. Pour obtenir une accolade
1437 fermante, il suffit d'appliquer une rotation au glyphe sélectionné,
1438 comme indiqué au chapitre @ref{Rotation des objets}.
1440 Vous disposez de trois familles de fontes textuelles : @emph{roman}
1441 pour la police sérif ou avec empattement -- fixée par défaut à New
1442 Century Schoolbook --, une police sans empattement (@emph{sans} sérif)
1443 et une à chasse fixe (ou monospace) -- les deux dernières étant
1444 déterminées par l'installation de Pango.
1446 Chaque famille dispose en principe de différents styles et niveau de
1447 gras. L'exemple qui suit illustre la manière de changer la famille, le
1448 style, la graisse ou la taille. Notez bien que l'argument fourni à
1449 @code{font-size} correspond à la correction à apporter à la taille par
1452 @lilypond[quote,verbatim,relative=2]
1453 \override Score.RehearsalMark #'font-family = #'typewriter
1454 \mark \markup "Ouverture"
1455 \override Voice.TextScript #'font-shape = #'italic
1456 \override Voice.TextScript #'font-series = #'bold
1457 d2.^\markup "Allegro"
1458 \override Voice.TextScript #'font-size = #-3
1463 Cette syntaxe s'applique aussi en mode @emph{markup}, bien que celui-ci
1464 dispose d'une syntaxe allégée comme nous l'avons vu dans
1465 @ref{Sélection de la fonte et de la taille}:
1467 @lilypond[quote,verbatim]
1471 \override #'(font-shape . italic)
1472 \override #'(font-size . 4)
1476 \override #'(font-family . typewriter)
1478 \override #'(font-series . bold)
1482 \override #'(font-family . sans)
1489 En plus de pouvoir jongler entre les différentes fontes prédéfinies,
1490 LilyPond vous permet d'en utiliser d'autres, ce qui fait l'objet des
1491 deux prochaines parties : @ref{Attribution d'une fonte en particulier}
1492 et @ref{Choix des fontes par défaut}.
1496 Manuel de notation :
1497 @ref{La fonte Feta},
1498 @ref{Notation musicale dans du texte formaté},
1499 @ref{Sélection de la fonte et de la taille},
1503 @node Attribution d'une fonte en particulier
1504 @unnumberedsubsubsec Attribution d'une fonte en particulier
1505 @translationof Single entry fonts
1507 Vous pouvez utiliser n'importe quelle police installée sur votre
1508 système, du moment où elle est accessible par Fontconfig, en respectant
1509 la syntaxe suivante :
1511 @lilypond[quote,verbatim,relative=2]
1512 \override Staff.TimeSignature #'font-name = #"Bitstream Charter"
1513 \override Staff.TimeSignature #'font-size = #2
1517 \override #'(font-name . "Vera Bold")
1522 @cindex fontes disponibles
1523 @cindex disponibilité des fontes
1525 @funindex show-available-fonts
1527 Pour obtenir la liste de toutes les polices disponibles sur votre
1531 lilypond -dshow-available-fonts toto
1534 (quel qu'il soit, le dernier argument est obligatoire).
1538 Manuel de notation :
1539 @ref{Tout savoir sur les fontes},
1540 @ref{Choix des fontes par défaut}.
1545 @c A source file gets never installed...
1546 @c Fichiers d'initialisation :
1547 @c @file{lily/@/font@/-config@/-scheme@/.cc}.
1550 @node Choix des fontes par défaut
1551 @unnumberedsubsubsec Choix des fontes par défaut
1552 @translationof Entire document fonts
1554 Vous pouvez tout à fait préférer un autre jeu de polices par défaut que
1555 celui de LilyPond. Il vous faudra alors spécifier les différentes
1556 familles, en respectant l'ordre @emph{roman}, @emph{sans empattement} et
1557 @emph{monospace}, comme dans l'exemple suivant. Pour plus
1558 d'explications sur les fontes, relisez @ref{Tout savoir sur les fontes}.
1560 @cindex polices, choix par défaut
1561 @cindex fontes, choix par défaut
1563 @funindex make-pango-font-tree
1565 @lilypond[verbatim,quote]
1569 (make-pango-font-tree "Times New Roman"
1572 (/ myStaffSize 20)))
1579 \typewriter typewriter. }
1583 @c we don't do Helvetica / Courier, since GS incorrectly loads
1588 Manuel de notation :
1589 @ref{Tout savoir sur les fontes},
1590 @ref{Attribution d'une fonte en particulier},
1591 @ref{Sélection de la fonte et de la taille},