1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
3 Translation of GIT committish: 057106293b07b74b00553fe4dc3dfac5c1f3b682
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::
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
44 suffit de les insérer directement dans votre fichier LilyPond. Ce
45 fichier devra être sauvegardé avec l'encodage UTF-8. Pour plus
46 d'informations, voir @ref{Codage du texte}.}
49 * Commentaires textuels::
50 * Indication textuelle avec 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
95 @ref{Articulations et ornements}.
97 Pour de plus amples détails sur la manière de combiner indications
98 textuelles et articulations, reportez-vous au chapitre
99 @rlearning{Positionnement des objets}.
101 @funindex \textLengthOn
102 @funindex textLengthOn
103 @funindex \textLengthOff
104 @funindex textLengthOff
107 @code{\textLengthOn},
108 @code{\textLengthOff}.
113 Manuel d'initiation :
114 @rlearning{Positionnement des objets}.
117 @ref{Mise en forme du texte},
118 @ref{Direction et positionnement},
119 @ref{Articulations et ornements}.
122 @rlsrnamed{Text,Texte}.
124 Référence des propriétés internes :
125 @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
136 S'assurer que tous les éléments textuels et les paroles respectent
137 les marges du document requiert des calculs relativement lourds@tie{};
138 c'est la raison pour laquelle LilyPond, par défaut, ne s'en préoccupe
139 pas. Vous pouvez cependant l'y forcer en définissant
142 \override Score.PaperColumn #'keep-inside-line = ##t
146 @node Indication textuelle avec extension
147 @unnumberedsubsubsec Indication textuelle avec extension
148 @translationof Text spanners
150 @cindex texte et extenseur
151 @cindex prolongation de texte
154 Certaines indications d'interprétation comme @emph{rallentando},
155 @emph{accelerando} ou @emph{trilles}, s'inscrivent textuellement et se
156 prolongent sur plusieurs notes à l'aide d'une ligne pleine, pointillée
157 ou ondulée. Ces objets, que l'on appelle @qq{extenseurs}, se dessinent
158 entre deux notes à l'aide de la syntaxe suivante@tie{}:
160 @lilypond[verbatim,quote,relative=2]
161 \override TextSpanner #'(bound-details left text) = "rit."
166 @cindex texte, mise en forme des prolongations
167 @cindex texte, mise en forme des extenseurs
168 @cindex extenseur, mise en forme
171 Le texte à imprimer est spécifié en tant que propriété de l'objet
172 @code{TextSpanner}. Il apparaîtra par défaut en italique@tie{};
173 cependant, rien ne s'oppose à un autre graphisme dès lors que vous
174 faites appel à un bloc @code{\markup} --
175 voir @ref{Mise en forme du texte}.
177 @lilypond[quote,relative=2,verbatim]
178 \override TextSpanner #'(bound-details left text) =
179 \markup { \upright "rit." }
184 Le style de ligne se définit lui aussi comme une propriété de l'objet.
185 Les détails concernant la syntaxe à utiliser sont expliqués au chapitre
186 @ref{Styles de ligne}.
188 @funindex \textSpannerUp
189 @funindex textSpannerUp
190 @funindex \textSpannerDown
191 @funindex textSpannerDown
192 @funindex \textSpannerNeutral
193 @funindex textSpannerNeutral
197 @code{\textSpannerUp},
198 @code{\textSpannerDown},
199 @code{\textSpannerNeutral}.
203 LilyPond ne peut traiter qu'un seul extenseur à la fois par voix.
207 @lilypondfile[verbatim,quote,texidoc,doctitle]
208 {dynamics-text-spanner-postfix.ly}
210 @lilypondfile[verbatim,quote,texidoc,doctitle]
211 {dynamics-custom-text-spanner-postfix.ly}
215 @ref{Styles de ligne},
217 @ref{Mise en forme du texte}.
220 @rlsrnamed{Text,Texte},
221 @rlsrnamed{Expressive marks,Signes d'interprétation}.
223 Référence des propriétés internes :
224 @rinternals{TextSpanner}.
227 @node Indications textuelles
228 @unnumberedsubsubsec Indications textuelles
229 @translationof Text marks
231 @cindex indication textuelle
232 @cindex coda sur une barre de mesure
233 @cindex segno sur une barre de mesure
234 @cindex point d'orgue sur une barre de mesure
235 @cindex barres de mesure, symboles au dessus de
242 La commande @code{\mark} est tout d'abord conçue pour les
243 @ref{Indications de repère}.
245 @c \mark needs to be placed on a separate line (it's not
246 @c attached to an object like \markup is). -vv
248 @lilypond[verbatim,quote,relative=2]
254 Cette syntaxe rend possible l'adjonction de n'importe quel texte à une
255 barre de mesure. Ce texte peut être mis en forme de différentes
256 manières dès lors qu'est utilisé un bloc @code{\markup}, comme indiqué
257 au chapitre @ref{Mise en forme du texte}.
259 @lilypond[quote,verbatim,relative=1]
261 \mark \markup { \italic { colla parte } }
267 Elle peut aussi servir à insérer des signes de @emph{coda} ou de
268 @emph{segno}, ou bien un point d'orgue, au dessus d'une
269 barre de mesure. Couplez-la alors à la commande @code{\markup} pour
270 avoir accès au symbole approprié, selon les indications contenues au
271 chapitre @ref{Notation musicale dans du texte formaté}.
273 @lilypond[quote,verbatim,relative=2]
275 \mark \markup { \musicglyph #"scripts.ufermata" }
280 Le résultat de @code{\mark} n'apparaîtra que sur la portée supérieure
281 d'un système. Si vous introduisez la commande @code{\mark} au moment
282 d'une barre de mesure, la marque se placera au dessus de la barre. Si
283 vous y faites appel au milieu d'une mesure, cette marque sera
284 positionnée entre les notes. Si elle intervient en début de ligne,
285 elle sera placée juste avant la première note de cette portée. Enfin,
286 une marque qui tomberait sur un saut de ligne sera imprimée au début
287 de la ligne suivante.
289 @lilypond[quote,verbatim,relative=2]
299 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
300 {printing-marks-at-the-end-of-a-line.ly}
302 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
303 {aligning-marks-with-various-notation-objects.ly}
305 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
306 {printing-marks-on-every-staff.ly}
311 @ref{Indications de repère},
312 @ref{Mise en forme du texte},
313 @ref{Notation musicale dans du texte formaté},
317 @rlsrnamed{Text,Texte}.
319 Référence des propriétés internes :
320 @rinternals{MarkEvent},
321 @rinternals{Mark_engraver},
322 @rinternals{RehearsalMark}.
325 @node Texte indépendant
326 @unnumberedsubsubsec Texte indépendant
327 @translationof Separate text
329 @cindex texte indépendant
331 @cindex texte en préambule
332 @cindex top-level text
333 @cindex text, top-level
334 @cindex indépendant, texte
339 Un bloc @code{\markup} peut exister en lui-même, indépendamment de tout
340 bloc @code{\score}, et venir en préambule par exemple -- voir le
341 chapitre @ref{Structure de fichier} à ce propos.
343 @lilypond[verbatim,quote]
345 Tomorrow, and tomorrow, and tomorrow...
350 De cette manière, vous pouvez insérer du texte en dehors de la musique.
351 Ceci devient particulièrement utile lorsque le fichier source contient
352 plusieurs morceaux. Pour plus d'informations à ce propos, reportez-vous
353 au chapitre @ref{Plusieurs partitions dans un même ouvrage}.
355 @lilypond[quote,verbatim]
360 Tomorrow, and tomorrow, and tomorrow...
367 Les blocs de textes peuvent s'étendre sur plusieurs pages, ce qui permet
368 de générer des ouvrages complets uniquement grâce à LilyPond. Cette
369 fonctionnalité, ainsi que la syntaxe appropriée, est abordée plus en
370 détail au chapitre @ref{Texte avec sauts de page}.
375 @funindex \markuplines
376 @funindex markuplines
386 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
387 {stand-alone-two-column-markup.ly}
392 @ref{Mise en forme du texte},
393 @ref{Structure de fichier},
394 @ref{Plusieurs partitions dans un même ouvrage},
395 @ref{Texte avec sauts de page}.
398 @rlsrnamed{Text,Texte}.
400 Référence des propriétés internes :
401 @rinternals{TextScript}.
404 @node Mise en forme du texte
405 @subsection Mise en forme du texte
406 @translationof Formatting text
408 Nous allons voir dans les lignes qui suivent la manière de mettre en
409 forme du texte à l'aide de la syntaxe propre au mode @code{\markup}.
412 * Introduction au formatage de texte::
413 * Sélection de la fonte et de la taille::
414 * Alignement du texte::
415 * Éléments graphiques dans du texte formaté::
416 * Notation musicale dans du texte formaté::
417 * Texte avec sauts de page::
420 @node Introduction au formatage de texte
421 @unnumberedsubsubsec Introduction au formatage de texte
422 @translationof Text markup introduction
425 @cindex commentaire textuel
426 @cindex étiquette textuelle
432 La commande @code{\markup} permet d'ajouter du texte et dispose de sa
433 propre syntaxe que nous appellerons le @qq{mode @emph{markup}}.
435 @cindex markup, expressions
436 @cindex expressions markup
437 @cindex markup, syntaxe
438 @cindex syntaxe du mode markup
440 La syntaxe du mode @emph{markup} n'est pas différente de celle des
441 autres modes de LilyPond@tie{}: une expression @code{\markup} est bornée
442 par des accolades @code{@{@tie{}@dots{}@tie{}@}}. Un mot unique sera
443 considéré comme une expression minimale, et n'aura donc pas besoin
444 d'être mis entre accolades.
446 Contrairement aux indications simples, du type "entre guillemets", les
447 blocs @code{\markup} peuvent contenir des expressions imbriquées ou
448 d'autres commandes @emph{markup}, dès lors qu'elles sont précédées du
449 caractère @code{\}. Ces commandes n'affecteront que la première
450 expression qui les suit.
452 @lilypond[quote,verbatim,relative=2]
454 a2^\markup { poco \italic più forte }
456 d2_\markup { \italic "string. assai" }
458 b1^\markup { \bold { molto \italic agitato } }
462 @cindex caractères spéciaux en mode markup
463 @cindex mode markup et caractères spéciaux
464 @cindex caractères réservés, impression
465 @cindex impression de caractères réservés
466 @cindex impression de caractères spéciaux
467 @cindex guillemets en mode markup
468 @cindex mode markup et guillemets
470 Un bloc @code{\markup} peut contenir du texte entre guillemets. De
471 telles chaines seront considérées comme des expressions textuelles
472 minimales@tie{}; à ce titre, toute commande de type @emph{markup} ou
473 tout caractère spécial -- tel un @code{\} ou un @code{#} -- sera imprimé
474 littéralement et sans influer sur le formatage du texte. Il est de ce
475 fait possible d'imprimer des guillemets informatiques @code{"} dès lors
476 qu'ils sont précédés d'une oblique inverse.
477 @c repeat double quote for pairing "
480 @lilypond[quote,verbatim,relative=2]
481 a1^"\italic markup..."
482 a_\markup { \italic "... imprime des lettres en \"italique\" !" }
486 Une liste de mots, pour pouvoir être traitée en tant qu'expression
487 distincte, doit être bornée par des @code{"} ou précédée d'une commande.
488 La manière de définir les expressions @emph{markup} aura une influence
489 sur la manière dont elles seront empilées, centrées ou alignées. Dans
490 l'exemple qui suit, la deuxième expression @code{\markup} est traitée
491 tout comme la première@tie{}:
492 @c repeat double quote for pairing "
494 @lilypond[quote,verbatim,relative=2]
495 c1^\markup { \center-column { a bbb c } }
496 c1^\markup { \center-column { a { bbb c } } }
497 c1^\markup { \center-column { a \line { bbb c } } }
498 c1^\markup { \center-column { a "bbb c" } }
501 Vous pouvez stocker les étiquettes textuelles en tant que variables,
502 et attacher ces identificateurs à des notes, comme ici@tie{}:
504 @lilypond[quote,verbatim]
505 allegro = \markup { \bold \large Allegro }
514 Pour une liste des différentes commandes spécifiques au mode
515 @code{\markup}, consultez l'annexe @ref{Text markup commands} (en
521 @ref{Text markup commands}.
524 @rlsrnamed{Text,Texte}.
526 Fichiers d'initialisation :
527 @file{scm/markup.scm}.
532 Les erreurs de syntaxe en mode @emph{markup} sont peu explicites.
535 @node Sélection de la fonte et de la taille
536 @unnumberedsubsubsec Sélection de la fonte et de la taille
537 @translationof Selecting font and font size
539 @cindex fonte, changement
540 @cindex changement de fonte
552 Le mode @emph{markup} autorise des changements élémentaires de la
555 @lilypond[quote,verbatim,relative=2]
558 \italic { non troppo \underline Vivo }
561 d,_\markup { \italic quasi \smallCaps Tromba }
565 @cindex caratères, taille
566 @cindex texte, taille
577 La taille des caractères se modifie de différentes manières@tie{}:
580 à partir de l'une des tailles standard prédéfinies,
583 en étant définie en valeur absolue,
586 en adoptant une valeur relative à celle précédemment définie.
590 Voici une illustration de ces trois différentes méthodes@tie{}:
592 @lilypond[quote,verbatim,relative=1]
599 \fontsize #5 Sinfonia
606 \magnify #0.6 { e sentimento } )
619 Vous pouvez imprimer du texte en indice ou en exposant. Celui-ci sera
620 dans un taille plus petite, mais rien ne s'oppose à ce que vous lui
621 affectiez un taille normale@tie{}:
623 @lilypond[quote,verbatim]
626 \line { 1 \super st movement }
627 \line { 1 \normal-size-super st movement
628 \sub { (part two) } }
633 @cindex fontes, familles
635 Le mode @emph{markup} vous permet de sélectionner d'autres familles de
636 fontes. Par défaut, LilyPond utilise une police avec empattement, du
637 type roman, et tout changement doit être explicite. Dans la dernière
638 ligne de l'exemple qui suit, vous noterez qu'il n'y a aucune différence
639 entre les premier et deuxième mots.
641 @lilypond[quote,verbatim]
644 \line { Act \number 1 }
645 \line { \sans { Scene I. } }
646 \line { \typewriter { Verona. An open place. } }
647 \line { Enter \roman Valentine and Proteus. }
653 Certaines familles de police spécifiques aux nombres ou aux nuances par
654 exemple, ne disposent pas de tous les caractères, comme nous l'avons vu
655 dans les chapitres @ref{Personnalisation des indications de nuance} et
656 @ref{Indications de reprise manuelles}.
658 @c \concat is actually documented in Align (it is not
659 @c a font-switching command). But we need it here. -vv
661 Lorsqu'un changement survient au milieu d'un mot, il se peut qu'un
662 espacement supplémentaire apparaisse. Il suffit en pareil cas de
663 concaténer les différents éléments@tie{}:
665 @lilypond[quote,verbatim]
669 \concat { 1 \super st }
673 \concat { \dynamic p , }
674 \italic { con dolce espressione }
680 Une liste des différentes commandes permettant de changer de fonte ou
681 d'utiliser des fontes personnalisées est disponible à l'annexe
684 Pour savoir comment personnaliser des fontes, reportez-vous au chapitre
693 @funindex \normalsize
720 @ref{Personnalisation des indications de nuance},
721 @ref{Indications de reprise manuelles},
725 @rlsrnamed{Text,Texte}.
727 Référence des propriétés internes :
728 @rinternals{TextScript}.
730 Fichiers d'initialisation :
731 @file{scm/define-markup-commands.scm}.
734 Le recours aux commandes @code{\teeny}, @code{\tiny},@code{\small},
735 @code{\normalsize}, @code{\large} et @code{\huge} produiront des
736 espacements nettement moins réguliers que si vous utilisez
740 @node Alignement du texte
741 @unnumberedsubsubsec Alignement du texte
742 @translationof Text alignment
744 @cindex texte, alignement
745 @cindex alignement du texte
746 @cindex alignement des markups
747 @cindex markups, alignement
749 Cette partie traite de la manière de positionner du texte en mode
750 @emph{markup}. On déplace l'intégralité d'un objet @emph{markup} en
751 utilisant la syntaxe décrite au chapitre
752 @rlearning{Déplacement d'objets}.
754 @c Padding commands should be mentioned on this page, but
755 @c most of these require \box to be more clearly illustrated. -vv
757 @cindex texte, alignement horizontal
758 @cindex alignement horizontal du texte
760 @funindex \left-align
762 @funindex \center-align
763 @funindex center-align
764 @funindex \right-align
765 @funindex right-align
767 Les objets de type @emph{markup} peuvent s'aligner de différentes
768 manières. Une indication textuelle est par défaut alignée sur son
769 extrémité gauche. Dans l'exemple qui suit, il n'y a aucune différence
770 entre les deux premiers @emph{markups}.
772 @lilypond[quote,verbatim,relative=2]
775 d-\markup { \left-align poco }
777 d-\markup { \center-align { poco } }
779 d-\markup { \right-align poco }
785 L'alignement horizontal peut être ajusté à l'aide d'une valeur
788 @lilypond[quote,verbatim,relative=2]
789 a1-\markup { \halign #-1 poco }
791 a,-\markup { \halign #0 poco }
793 a,-\markup { \halign #0.5 poco }
795 a,-\markup { \halign #2 poco }
799 Certains objets possèdent leurs propres procédures d'alignement, qui
800 annuleront toute spécification d'alignement que vous pourriez affecter
801 à un argument de type @emph{markup} que vous leur auriez fourni. La
802 solution consiste alors à déplacer l'intégralité de ces objets
803 @emph{markup}, comme indiqué par exemple au chapitre
804 @ref{Indications textuelles}.
806 @cindex texte, alignement vertical
807 @cindex alignement vertical du texte
816 @c QUERY Should the function of ``\null'' be clarified? rp
818 L'alignement vertical est quant à lui un peu plus compliqué. Comme nous
819 l'avons vu ci-avant, les objets @emph{markup} peuvent être déplacés dans
820 leur intégralité. Il est néanmois possible de déplacer certains
821 éléments spécifiques au sein d'un bloc @emph{markup}. En pareil cas,
822 l'élément à déplacer doit être précédé d'un @qq{point d'ancrage} -- un
823 autre élément du @emph{markup} ou un objet invisible. L'exemple qui
824 suit illustre ces deux possibilités. Vous noterez par ailleurs que le
825 dernier @emph{markup}, dépourvu de point d'ancrage, n'est de ce fait pas
828 @lilypond[quote,verbatim,relative=1]
831 \raise #2 { Scène 1 }
836 \lower #4 \bold { Très modéré }
840 \raise #4 \italic { Une forêt. }
845 @funindex \general-align
846 @funindex general-align
849 @funindex \translate-scaled
850 @funindex translate-scaled
852 Certaines commandes permettent de régler l'alignement des objets
853 textuels en mode @emph{markup}, tant au niveau horizontal que vertical.
854 Tout objet soumis à ces commandes doit être précédé d'un point
857 @lilypond[quote,verbatim,relative=1]
860 \translate #'(-1 . 2) "Scène 1"
865 \general-align #Y #3.2 \bold "Très modéré"
870 \translate-scaled #'(-1 . 2) \teeny "Une forêt."
875 @cindex multi-ligne, markup
876 @cindex markup multi-ligne
877 @cindex multi-ligne, texte
878 @cindex texte multi-ligne
879 @cindex texte en colonnes
880 @cindex colonnes de texte
884 @funindex \center-column
885 @funindex center-column
887 Un objet de type @emph{markup} peut contenir plusieurs lignes de texte.
888 Dans l'exemple suivant, chaque élément ou expression ira se placer sur
889 sa propre ligne, tantôt alignée à gauche, tantôt centrée.
891 @lilypond[quote,verbatim]
907 @cindex centrage du texte sur la page
908 @cindex texte, centrage sur la page
909 @cindex markup, centrage sur la page
914 Pareillement, une liste d'éléments ou d'expressions sera répartie sur
915 une ligne entière, voire même centrée sur toute la page s'il n'y a qu'un
916 seul élément. De telles expressions peuvent à leur tour contenir du
917 texte multi-ligne ou une autre expression @emph{markup}.
919 @lilypond[quote,verbatim]
922 \line { William S. Gilbert }
924 \huge \smallCaps "The Mikado"
926 \smallCaps "The Town of Titipu"
928 \line { Sir Arthur Sullivan }
936 @cindex plusieurs lignes de texte
937 @cindex justifié, texte
938 @cindex texte justifié
939 @cindex texte sur plusieurs lignes
940 @cindex markup, texte au kilomètre
941 @cindex markup, texte justifié
948 Les indications textuelles, lorsqu'elles sont relativement longues,
949 peuvent se répartir sur plusieurs lignes en fonction de la largeur de
950 ligne. Le texte sera alors soit aligné à gauche, soit justifié, comme
951 le montre l'exemple suivant@tie{}:
953 @lilypond[quote,verbatim]
956 \line \smallCaps { La vida breve }
957 \line \bold { Acto I }
959 (La escena representa el corral de una casa de
960 gitanos en el Albaicín de Granada. Al fondo una
961 puerta por la que se ve el negro interior de
962 una Fragua, iluminado por los rojos resplandores
967 \line \bold { Acto II }
968 \override #'(line-width . 50)
970 (Calle de Granada. Fachada de la casa de Carmela
971 y su hermano Manuel con grandes ventanas abiertas
972 a través de las que se ve el patio
973 donde se celebra una alegre fiesta)
979 @cindex commandes d'alignement du texte
980 @cindex markup, commandes d'alignement du texte
981 @cindex alignement du texte, commandes
983 Une liste des différentes commandes permettant d'aligner du texte en
984 mode @emph{markup} est disponible à l'annexe @ref{Align}.
988 Manuel d'initiation :
989 @rlearning{Déplacement d'objets}.
993 @ref{Indications textuelles}.
996 @rlsrnamed{Text,Texte}.
998 Référence des propriétés internes :
999 @rinternals{TextScript}.
1001 Fichiers d'initialisation :
1002 @file{scm/define-markup-commands.scm}.
1005 @node Éléments graphiques dans du texte formaté
1006 @unnumberedsubsubsec Éléments graphiques dans du texte formaté
1007 @translationof Graphic notation inside markup
1009 @cindex graphisme, tracé
1010 @cindex tracé d'objets graphiques
1011 @cindex graphiques, tracé d'objets
1012 @cindex embedding graphic objects
1013 @cindex objets graphiques, tracé
1015 Vous pouvez, grâce aux mode @emph{markup}, ajouter divers objets
1016 graphiques à votre partition.
1018 @cindex décoration du texte
1019 @cindex encadrement du texte
1020 @cindex texte, encadrement
1021 @cindex texte, décoration
1022 @cindex markup, ornementation du texte
1023 @cindex markup, encadrement du texte
1029 @funindex \rounded-box
1030 @funindex rounded-box
1036 Certaines commandes de @emph{markup} permettent d'ornementer des
1037 éléments textuels avec des graphismes, à l'instar de l'exemple
1040 @lilypond[quote,verbatim]
1041 \markup \fill-line {
1049 \bracket "1866 - 1925"
1052 \rounded-box \bold Prelude
1057 @cindex espacement autour du texte
1058 @cindex texte et rembourrage
1059 @cindex markup, rembourrage du texte
1061 @funindex \pad-markup
1062 @funindex pad-markup
1065 @funindex \pad-to-box
1066 @funindex pad-to-box
1067 @funindex \pad-around
1068 @funindex pad-around
1070 Certaines directives peuvent nécessiter d'accroître l'espacement autour
1071 du texte -- voir l'annexe @ref{Align} pour une liste des différentes
1072 commandes particulières au mode @emph{markup} ainsi que leur description.
1074 @lilypond[quote,verbatim]
1075 \markup \fill-line {
1077 \box "Charles Ives (1874 - 1954)"
1079 \box \pad-markup #2 "THE UNANSWERED QUESTION"
1080 \box \pad-x #8 "A Cosmic Landscape"
1087 \box \pad-to-box #'(-5 . 20) #'(0 . 5)
1088 \bold "Largo to Presto"
1091 "String quartet keeps very even time,
1092 Flute quartet keeps very uneven time."
1096 @cindex graphisme dans la notation
1097 @cindex symboles non musicaux
1098 @cindex non musicaux, symboles
1099 @cindex notation et graphisme
1103 @funindex \draw-circle
1104 @funindex draw-circle
1105 @funindex \filled-box
1106 @funindex filled-box
1109 @funindex \draw-line
1111 @funindex \arrow-head
1112 @funindex arrow-head
1114 Vous pouvez imprimer certains graphismes ou symboles sans qu'il n'y
1115 ait de texte. Ces objets peuvent même se combiner, à l'instar de
1116 n'importe quelle expression @emph{markup}.
1118 @lilypond[quote,verbatim]
1121 \draw-circle #4 #0.4 ##f
1122 \filled-box #'(-4 . 4) #'(-0.5 . 0.5) #1
1128 \draw-line #'(0 . 4)
1129 \arrow-head #Y #DOWN ##f
1134 @cindex intégration de graphiques
1135 @cindex images, intégration
1136 @cindex graphiques, intégration
1141 @funindex \postscript
1142 @funindex postscript
1144 Des fonctionnalités graphiques avancées vous permettent même d'inclure
1145 dans une partition un fichier image converti au format PostScript
1146 encapsulé (extension @code{eps}), ou bien de tracer un graphique
1147 directement dans le fichier source à partir d'instructions PostScript
1148 pures. Nous vous conseillons, en pareil cas, de toujours spécifier les
1149 dimensions du dessin, comme dans ce qui suit@tie{}:
1151 @lilypond[quote,verbatim,relative=1]
1154 \epsfile #X #10 #"./context-example.eps"
1155 \with-dimensions #'(0 . 6) #'(0 . 10)
1171 L'annexe @ref{Graphic} répertorie les différentes commandes en matière
1176 Manuel de notation :
1178 @ref{Annotations éditoriales},
1182 @rlsrnamed{Text,Texte}.
1184 Référence des propriétés internes :
1185 @rinternals{TextScript}.
1187 Fichiers d'initialisation :
1188 @file{scm/define-markup-commands.scm},
1189 @file{scm/stencil.scm}.
1192 @node Notation musicale dans du texte formaté
1193 @unnumberedsubsubsec Notation musicale dans du texte formaté
1194 @translationof Music notation inside markup
1196 @cindex notation dans un markup
1197 @cindex musique dans un markup
1198 @cindex markup, inclusion de musique
1200 Divers éléments de notation peuvent orner une partition, au moyen d'un
1201 objet @emph{markup}.
1203 Notes et altérations sont données à l'aide d'instructions
1204 @emph{markup}@tie{}:
1206 @lilypond[quote,verbatim,relative=2]
1210 \note-by-number #1 #1 #1.5
1213 \natural \semiflat \flat
1214 \sesquiflat \doubleflat
1218 \natural \semisharp \sharp
1219 \sesquisharp \doublesharp
1224 Le mode @emph{markup} permet d'accéder à d'autres objets de
1227 @lilypond[quote,verbatim,relative=1]
1234 fis_\markup { \dynamic rf }
1245 En règle générale, tout symbole musical peut être inclus dans un
1246 @emph{markup}, comme le montre l'exemple qui suit. Ces différents
1247 symboles sont répertoriés dans l'annexe @ref{La fonte Feta}.
1249 @lilypond[quote,verbatim,relative=2]
1251 c'^\markup { \musicglyph #"eight" }
1253 c,8._\markup { \musicglyph #"clefs.G_change" }
1255 c2^\markup { \musicglyph #"timesig.neomensural94" }
1258 Le sous-chapitre @ref{Tout savoir sur les fontes} contient d'autres
1259 informations sur l'impression de glyphes non alphabétiques, tels que des
1260 crochets ou accolades.
1262 Le mode @emph{markup} supporte aussi les diagrammes spécifiques à
1263 certains instruments@tie{}:
1265 @lilypond[quote,verbatim,relative=2]
1267 \fret-diagram-terse #"x;x;o;2;3;2;"
1270 \harp-pedal #"^-v|--ov^"
1275 \musicglyph #"accordion.discant"
1277 \raise #0.5 \musicglyph #"accordion.dot"
1278 \raise #1.5 \musicglyph #"accordion.dot"
1282 @c The accordion diagram is actually taken from a snippet.
1285 La documentation sur ces diagrammes se trouvent à l'annexe
1286 @ref{Instrument Specific Markup}.
1288 @cindex partition incluse dans un markup
1289 @cindex markup, inclusion de partition
1291 Rien ne s'oppose à ce qu'une étiquette ne comporte une partition. Il
1292 suffit que l'expression en question contienne un bloc @code{\score}
1293 incluant un bloc @code{\layout}.
1295 @lilypond[quote,verbatim,relative=1]
1298 \relative c' { c4 d e f }
1306 Les différentes commandes @emph{markup} relatives à la notation musicale
1307 sont répertoriées à l'annexe @ref{Music}.
1311 Manuel de notation :
1313 @ref{La fonte Feta},
1314 @ref{Tout savoir sur les fontes}.
1317 @rlsrnamed{Text,Texte}.
1319 Référence des propriétés internes :
1320 @rinternals{TextScript}.
1322 Fichiers d'initialisation :
1323 @file{scm/define-markup-commands.scm},
1324 @file{scm/fret-diagrams.scm},
1325 @file{scm/harp-pedals.scm}.
1328 @node Texte avec sauts de page
1329 @unnumberedsubsubsec Texte avec sauts de page
1330 @translationof Page wrapping text
1332 @cindex multi-page, markup
1333 @cindex markup multi-page
1334 @cindex markup, texte multi-page
1335 @cindex plusieurs pages de texte
1337 @funindex \markuplines
1338 @funindex markuplines
1339 @funindex \justified-lines
1340 @funindex justified-lines
1341 @funindex \wordwrap-lines
1342 @funindex wordwrap-lines
1344 Alors que @code{\markup} s'utilise pour traiter un bloc de texte
1345 insécable, @code{\markuplines} permet, employé en tête de partition,
1346 d'obtenir un bloc de lignes réparties différemment et, le cas échéant,
1347 sur plusieurs pages.
1350 @lilypond[quote,verbatim]
1353 Un long texte constitué de lignes justifiées.
1357 Un autre grand paragraphe.
1364 Cette syntaxe prend en charge une liste de @emph{markups}@tie{}; il peut
1368 d'une suite de commandes générant à leur tour des lignes de texte,
1370 d'une liste de lignes de texte,
1372 d'une liste d'étiquettes.
1375 Les différentes commandes permettant de générer des listes de lignes
1376 se trouve dans l'annexe @ref{Text markup list commands}.
1380 Manuel de notation :
1381 @ref{Text markup list commands},
1384 @rlsrnamed{Text,Texte}.
1386 @c TODO en attendant redécoupage et création de "extending" -jcm
1388 @c @rextend{New markup list command definition}.
1390 Référence des propriétés internes :
1391 @rinternals{TextScript}.
1393 Fichiers d'initialisation :
1394 @file{scm/define-markup-commands.scm}.
1397 @funindex \markuplines
1398 @funindex markuplines
1401 @code{\markuplines}.
1407 @translationof Fonts
1409 Ce chapitre est consacré aux fontes et polices de caractère, à leur
1410 gestion. Vous y apprendrez aussi comment changer de fonte en cours de
1414 * Tout savoir sur les fontes::
1415 * Attribution d'une fonte en particulier::
1416 * Choix des fontes par défaut::
1419 @node Tout savoir sur les fontes
1420 @unnumberedsubsubsec Tout savoir sur les fontes
1421 @translationof Fonts explained
1424 @cindex fontes, généralités
1425 @cindex accolades, taille
1426 @cindex fontes et markup
1427 @cindex markup et fontes
1429 @funindex font-interface
1431 La gestion des fontes est assurée par plusieurs bibliothèques@tie{}:
1432 FontConfig se charge de répertorier les différentes fontes installées
1433 sur votre système@tie{}; quant à Pango, elle se charge plus
1434 particulièrement de leur rendu.
1436 Les fontes musicales peuvent se décrire comme un jeu de glyphes
1437 spécifiques regroupés dans plusieurs familles. L'exemple qui suit
1438 montre la syntaxe à utiliser pour accéder, en mode @emph{markup}, aux
1439 différentes fontes @code{feta} non textuelles de LilyPond.
1441 @lilypond[quote,verbatim,relative=2]
1444 \override #'(font-encoding . fetaBraces)
1446 \override #'(font-encoding . fetaText)
1448 \override #'(font-encoding . fetaMusic)
1449 \lookup #"noteheads.s0petrucci"
1455 Tous ces glyphes, à l'exception des accolades qui sont regroupées dans
1456 @code{fetaBraces}, sont accessibles avec la syntaxe indiquée dans
1457 @ref{Notation musicale dans du texte formaté}.
1459 Une remarque s'impose au sujet des glyphes contenus dans
1460 @code{fetaBraces}@tie{}: chacun d'eux est formé du mot @emph{brace}
1461 auquel est accolé un numéro d'ordre. Lorsque vous désirez imprimer une
1462 accolade, vous devez la @qq{chercher} par son numéro d'ordre -- d'où la
1463 fonction @code{\lookup} de l'exemple ci-dessus --, tout en sachant qu'il
1464 est compris entre @code{0} (la plus petite) et @code{575} (la plus
1465 grande). Vous serez souvent amené à procéder par tatonnement pour
1466 arriver au résultat optimal. Par ailleurs, @code{fetaBraces} ne
1467 comporte que des accolades ouvrantes. Pour obtenir une accolade
1468 fermante, il suffit d'appliquer une rotation au glyphe sélectionné,
1469 comme indiqué au chapitre @ref{Rotation des objets}.
1471 Vous disposez de trois familles de fontes textuelles@tie{}: @emph{roman}
1472 pour la police sérif ou avec empattement -- fixée par défaut à New
1473 Century Schoolbook --, une police sans empattement (@emph{sans} sérif)
1474 et une à chasse fixe (ou monospace) -- les deux dernières étant
1475 déterminées par l'installation de Pango.
1477 Chaque famille dispose en principe de différents styles et niveaux de
1478 gras. L'exemple qui suit illustre la manière de changer la famille, le
1479 style, la graisse ou la taille. Notez bien que l'argument fourni à
1480 @code{font-size} correspond à la correction à apporter à la taille par
1483 @lilypond[quote,verbatim,relative=2]
1484 \override Score.RehearsalMark #'font-family = #'typewriter
1485 \mark \markup "Ouverture"
1486 \override Voice.TextScript #'font-shape = #'italic
1487 \override Voice.TextScript #'font-series = #'bold
1488 d2.^\markup "Allegro"
1489 \override Voice.TextScript #'font-size = #-3
1494 Cette syntaxe s'applique aussi en mode @emph{markup}, bien que celui-ci
1495 dispose d'une syntaxe allégée comme nous l'avons vu dans
1496 @ref{Sélection de la fonte et de la taille}@tie{}:
1498 @lilypond[quote,verbatim]
1502 \override #'(font-shape . italic)
1503 \override #'(font-size . 4)
1507 \override #'(font-family . typewriter)
1509 \override #'(font-series . bold)
1513 \override #'(font-family . sans)
1520 En plus de pouvoir jongler entre les différentes fontes prédéfinies,
1521 LilyPond vous permet d'en utiliser d'autres, ce qui fait l'objet des
1522 deux prochaines parties@tie{}:
1523 @ref{Attribution d'une fonte en particulier}
1524 et @ref{Choix des fontes par défaut}.
1528 Manuel de notation :
1529 @ref{La fonte Feta},
1530 @ref{Notation musicale dans du texte formaté},
1531 @ref{Rotation des objets},
1532 @ref{Sélection de la fonte et de la taille},
1536 @node Attribution d'une fonte en particulier
1537 @unnumberedsubsubsec Attribution d'une fonte en particulier
1538 @translationof Single entry fonts
1540 Vous pouvez utiliser n'importe quelle police installée sur votre
1541 système, dès lors qu'elle est accessible par Fontconfig et que vous
1542 respectez la syntaxe suivante@tie{}:
1544 @lilypond[quote,verbatim,relative=2]
1545 \override Staff.TimeSignature #'font-name = #"Bitstream Charter"
1546 \override Staff.TimeSignature #'font-size = #2
1550 \override #'(font-name . "Vera Bold")
1555 @cindex fontes disponibles
1556 @cindex disponibilité des fontes
1558 @funindex show-available-fonts
1560 Pour obtenir la liste de toutes les polices disponibles sur votre
1564 lilypond -dshow-available-fonts toto
1567 (quel qu'il soit, le dernier argument est obligatoire).
1571 Manuel de notation :
1572 @ref{Tout savoir sur les fontes},
1573 @ref{Choix des fontes par défaut}.
1576 @rlsrnamed{Text,Texte}.
1578 @c A source file gets never installed...
1579 @c Fichiers d'initialisation :
1580 @c @file{lily/font-config-scheme.cc}.
1583 @node Choix des fontes par défaut
1584 @unnumberedsubsubsec Choix des fontes par défaut
1585 @translationof Entire document fonts
1587 Vous pouvez tout à fait préférer un autre jeu de polices par défaut que
1588 celui de LilyPond. Il vous faudra alors spécifier les différentes
1589 familles, en respectant l'ordre @emph{roman}, @emph{sans empattement} et
1590 @emph{monospace}, comme dans l'exemple suivant. Pour plus
1591 d'explications sur les fontes, relisez @ref{Tout savoir sur les fontes}.
1593 @cindex polices, choix par défaut
1594 @cindex fontes, choix par défaut
1596 @funindex make-pango-font-tree
1598 @lilypond[verbatim,quote]
1602 (make-pango-font-tree "Times New Roman"
1605 (/ myStaffSize 20)))
1612 \typewriter typewriter. }
1616 @c we don't do Helvetica / Courier, since GS incorrectly loads
1621 Manuel de notation :
1622 @ref{Tout savoir sur les fontes},
1623 @ref{Attribution d'une fonte en particulier},
1624 @ref{Sélection de la fonte et de la taille},