1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
3 Translation of GIT committish: 52f98b4061e0eb74b7c1dbcc29e74538b374752f
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}.
121 @rlsrnamed{Text,Texte}.
123 Référence des propriétés internes :
124 @rinternals{TextScript}.
127 @cindex texte hors marges
128 @cindex marges, texte qui dépasse
129 @cindex texte, maintien dans les marges
130 @cindex texte, maintien dans les marges
135 S'assurer que tous les éléments textuels et les paroles respectent
136 les marges du document requiert des calculs relativement lourds@tie{};
137 c'est la raison pour laquelle LilyPond, par défaut, ne s'en préoccupe
138 pas. Vous pouvez cependant l'y forcer en définissant
141 \override Score.PaperColumn #'keep-inside-line = ##t
145 @node Indication textuelle avec extension
146 @unnumberedsubsubsec Indication textuelle avec extension
147 @translationof Text spanners
149 @cindex texte et extenseur
150 @cindex prolongation de texte
153 Certaines indications d'interprétation comme @i{rallentando},
154 @i{accelerando} ou @i{trilles}, s'inscrivent textuellement et se
155 prolongent sur plusieurs notes à l'aide d'une ligne pleine, pointillée
156 ou ondulée. Ces objets, que l'on appelle @qq{extenseurs}, se dessinent
157 entre deux notes à l'aide de la syntaxe suivante@tie{}:
159 @lilypond[verbatim,quote,relative=2]
160 \override TextSpanner #'(bound-details left text) = "rit."
165 @cindex texte, mise en forme des prolongations
166 @cindex texte, mise en forme des extenseurs
167 @cindex extenseur, mise en forme
170 Le texte à imprimer est spécifié en tant que propriété de l'objet
171 @code{TextSpanner}. Il apparaîtra par défaut en italique@tie{};
172 cependant, rien ne s'oppose à un autre graphisme dès lors que vous
173 faites appel à un bloc @code{\markup} --
174 voir @ref{Mise en forme du texte}.
176 @lilypond[quote,relative=2,verbatim]
177 \override TextSpanner #'(bound-details left text) =
178 \markup { \upright "rit." }
183 Le style de ligne se définit lui aussi comme une propriété de l'objet.
184 Les détails concernant la syntaxe à utiliser sont expliqués au chapitre
185 @ref{Styles de ligne}.
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.
206 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
207 {dynamics-text-spanner-postfix.ly}
209 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
210 {dynamics-custom-text-spanner-postfix.ly}
214 @ref{Styles de ligne},
218 @rlsrnamed{Text,Texte},
219 @rlsrnamed{Expressive marks,Signes d'interprétation}.
221 Référence des propriétés internes :
222 @rinternals{TextSpanner}.
225 @node Indications textuelles
226 @unnumberedsubsubsec Indications textuelles
227 @translationof Text marks
229 @cindex indication textuelle
230 @cindex coda sur une barre de mesure
231 @cindex segno sur une barre de mesure
232 @cindex point d'orgue sur une barre de mesure
233 @cindex barres de mesure, symboles au dessus de
240 La commande @code{\mark} est tout d'abord conçue pour les
241 @ref{Indications de repère}.
243 @c \mark needs to be placed on a separate line (it's not
244 @c attached to an object like \markup is). -vv
246 @lilypond[verbatim,quote,relative=2]
252 Cette syntaxe rend possible l'adjonction de n'importe quel texte à une
253 barre de mesure. Ce texte peut être mis en forme de différentes
254 manières dès lors qu'est utilisé un bloc @code{\markup}, comme indiqué
255 au chapitre @ref{Mise en forme du texte}.
257 @lilypond[quote,verbatim,relative=1]
259 \mark \markup { \italic { colla parte } }
265 Elle peut aussi servir à insérer des signes de @emph{coda} ou de
266 @emph{segno}, ou bien un point d'orgue, au dessus d'une
267 barre de mesure. Couplez-la alors à la commande @code{\markup} pour
268 avoir accès au symbole approprié, selon les indications contenues au
269 chapitre @ref{Notation musicale dans du texte formaté}.
271 @lilypond[quote,verbatim,relative=2]
273 \mark \markup { \musicglyph #"scripts.ufermata" }
278 Le résultat de @code{\mark} n'apparaîtra que sur la portée supérieure
279 d'un système. Si vous introduisez la commande @code{\mark} au moment
280 d'une barre de mesure, la marque se placera au dessus de la barre. Si
281 vous y faites appel au milieu d'une mesure, cette marque sera
282 positionnée entre les notes. Si elle intervient en début de ligne,
283 elle sera placée juste avant la première note de cette portée. Enfin,
284 une marque qui tomberait sur un saut de ligne sera imprimée au début
285 de la ligne suivante.
287 @lilypond[quote,verbatim,relative=2]
297 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
298 {printing-marks-at-the-end-of-a-line.ly}
300 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
301 {aligning-marks-with-various-notation-objects.ly}
303 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
304 {printing-marks-on-every-staff.ly}
309 @ref{Indications de repère},
310 @ref{Mise en forme du texte},
311 @ref{Notation musicale dans du texte formaté},
315 @rlsrnamed{Text,Texte}.
317 Référence des propriétés internes :
318 @rinternals{MarkEvent},
319 @rinternals{Mark_engraver},
320 @rinternals{RehearsalMark}.
323 @node Texte indépendant
324 @unnumberedsubsubsec Texte indépendant
325 @translationof Separate text
327 @cindex texte indépendant
329 @cindex texte en préambule
330 @cindex top-level text
331 @cindex text, top-level
332 @cindex indépendant, texte
337 Un bloc @code{\markup} peut exister en lui-même, indépendamment de tout
338 bloc @code{\score}, et venir en préambule par exemple -- voir le
339 chapitre @ref{Structure de fichier} à ce propos.
341 @lilypond[verbatim,quote]
343 Tomorrow, and tomorrow, and tomorrow...
348 De cette manière, vous pouvez insérer du texte en dehors de la musique.
349 Ceci devient particulièrement utile lorsque le fichier source contient
350 plusieurs morceaux. Pour plus d'informations à ce propos, reportez-vous
351 au chapitre @ref{Plusieurs partitions dans un même ouvrage}.
353 @lilypond[quote,verbatim]
358 Tomorrow, and tomorrow, and tomorrow...
365 Les blocs de textes peuvent s'étendre sur plusieurs pages, ce qui permet
366 de générer des ouvrages complets uniquement grâce à LilyPond. Cette
367 fonctionnalité, ainsi que la syntaxe appropriée, est abordée plus en
368 détail au chapitre @ref{Texte avec sauts de page}.
373 @funindex \markuplines
374 @funindex markuplines
384 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
385 {stand-alone-two-column-markup.ly}
390 @ref{Mise en forme du texte},
391 @ref{Structure de fichier},
392 @ref{Plusieurs partitions dans un même ouvrage},
393 @ref{Texte avec sauts de page}.
396 @rlsrnamed{Text,Texte}.
398 Référence des propriétés internes :
399 @rinternals{TextScript}.
402 @node Mise en forme du texte
403 @subsection Mise en forme du texte
404 @translationof Formatting text
406 Nous allons voir dans les lignes qui suivent la manière de mettre en
407 forme du texte à l'aide de la syntaxe propre au mode @code{\markup}.
410 * Introduction au formatage de texte::
411 * Sélection de la fonte et de la taille::
412 * Alignement du texte::
413 * Éléments graphiques dans du texte formaté::
414 * Notation musicale dans du texte formaté::
415 * Texte avec sauts de page::
418 @node Introduction au formatage de texte
419 @unnumberedsubsubsec Introduction au formatage de texte
420 @translationof Text markup introduction
423 @cindex commentaire textuel
424 @cindex étiquette textuelle
430 La commande @code{\markup} permet d'ajouter du texte et dispose de sa
431 propre syntaxe que nous appellerons le @qq{mode @emph{markup}}.
433 @cindex markup, expressions
434 @cindex expressions markup
435 @cindex markup, syntaxe
436 @cindex syntaxe du mode markup
438 La syntaxe du mode @emph{markup} n'est pas différente de celle des
439 autres modes de LilyPond@tie{}: une expression @code{\markup} est bornée
440 par des accolades @code{@{@tie{}@dots{}@tie{}@}}. Un mot unique sera
441 considéré comme une expression minimale, et n'aura donc pas besoin
442 d'être mis entre accolades.
444 Contrairement aux indications simples, du type "entre guillemets", les
445 blocs @code{\markup} peuvent contenir des expressions imbriquées ou
446 d'autres commandes @emph{markup}, dès lors qu'elles sont précédées du
447 caractère @code{\}. Ces commandes n'affecteront que la première
448 expression qui les suit.
450 @lilypond[quote,verbatim,relative=2]
452 a2^\markup { poco \italic più forte }
454 d2_\markup { \italic "string. assai" }
456 b1^\markup { \bold { molto \italic agitato } }
460 @cindex caractères spéciaux en mode markup
461 @cindex mode markup et caractères spéciaux
462 @cindex caractères réservés, impression
463 @cindex impression de caractères réservés
464 @cindex impression de caractères spéciaux
465 @cindex guillemets en mode markup
466 @cindex mode markup et guillemets
468 Un bloc @code{\markup} peut contenir du texte entre guillemets. De
469 telles chaines seront considérées comme des expressions textuelles
470 minimales@tie{}; à ce titre, toute commande de type @emph{markup} ou
471 tout caractère spécial -- tel un @code{\} ou un @code{#} -- sera imprimé
472 littéralement et sans influer sur le formatage du texte. Il est de ce
473 fait possible d'imprimer des guillemets informatiques @code{"} dès lors
474 qu'ils sont précédés d'une oblique inverse.
475 @c repeat double quote for pairing "
478 @lilypond[quote,verbatim,relative=2]
479 a1^"\italic markup..."
480 a_\markup { \italic "... imprime des lettres en \"italique\" !" }
484 Une liste de mots, pour pouvoir être traitée en tant qu'expression
485 distincte, doit être bornée par des @code{"} ou précédée d'une commande.
486 La manière de définir les expressions @emph{markup} aura une influence
487 sur la manière dont elles seront empilées, centrées ou alignées. Dans
488 l'exemple qui suit, la deuxième expression @code{\markup} est traitée
489 tout comme la première@tie{}:
490 @c repeat double quote for pairing "
492 @lilypond[quote,verbatim,relative=2]
493 c1^\markup { \center-column { a bbb c } }
494 c1^\markup { \center-column { a { bbb c } } }
495 c1^\markup { \center-column { a \line { bbb c } } }
496 c1^\markup { \center-column { a "bbb c" } }
499 Vous pouvez stocker les étiquettes textuelles en tant que variables,
500 et attacher ces identificateurs à des notes, comme ici@tie{}:
502 @lilypond[quote,verbatim]
503 allegro = \markup { \bold \large Allegro }
512 Pour une liste des différentes commandes spécifiques au mode
513 @code{\markup}, consultez l'annexe @ref{Text markup commands} (en
519 @ref{Text markup commands}.
522 @rlsrnamed{Text,Texte}.
524 Fichiers d'initialisation :
525 @file{scm/markup.scm}.
530 Les erreurs de syntaxe en mode @emph{markup} sont peu explicites.
533 @node Sélection de la fonte et de la taille
534 @unnumberedsubsubsec Sélection de la fonte et de la taille
535 @translationof Selecting font and font size
537 @cindex fonte, changement
538 @cindex changement de fonte
550 Le mode @emph{markup} autorise des changements élémentaires de la
553 @lilypond[quote,verbatim,relative=2]
556 \italic { non troppo \underline Vivo }
559 d,_\markup { \italic quasi \smallCaps Tromba }
563 @cindex caratères, taille
564 @cindex texte, taille
575 La taille des caractères se modifie de différentes manières@tie{}:
578 à partir de l'une des tailles standard prédéfinies,
581 en étant définie en valeur absolue,
584 en adoptant une valeur relative à celle précédemment définie.
588 Voici une illustration de ces trois différentes méthodes@tie{}:
590 @lilypond[quote,verbatim,relative=1]
597 \fontsize #5 Sinfonia
604 \magnify #0.6 { e sentimento } )
617 Vous pouvez imprimer du texte en indice ou en exposant. Celui-ci sera
618 dans un taille plus petite, mais rien ne s'oppose à ce que vous lui
619 affectiez un taille normale@tie{}:
621 @lilypond[quote,verbatim]
624 \line { 1 \super st movement }
625 \line { 1 \normal-size-super st movement
626 \sub { (part two) } }
631 @cindex fontes, familles
633 Le mode @emph{markup} vous permet de sélectionner d'autres familles de
634 fontes. Par défaut, LilyPond utilise une police avec empattement, du
635 type roman, et tout changement doit être explicite. Dans la dernière
636 ligne de l'exemple qui suit, vous noterez qu'il n'y a aucune différence
637 entre les premier et deuxième mots.
639 @lilypond[quote,verbatim]
642 \line { Act \number 1 }
643 \line { \sans { Scene I. } }
644 \line { \typewriter { Verona. An open place. } }
645 \line { Enter \roman Valentine and Proteus. }
651 Certaines familles de police spécifiques aux nombres ou aux nuances par
652 exemple, ne disposent pas de tous les caractères, comme nous l'avons vu
653 dans les chapitres @ref{Personnalisation des indications de nuance} et
654 @ref{Indications de reprise manuelles}.
656 @c \concat is actually documented in Align (it is not
657 @c a font-switching command). But we need it here. -vv
659 Lorsqu'un changement survient au milieu d'un mot, il se peut qu'un
660 espacement supplémentaire apparaisse. Il suffit en pareil cas de
661 concaténer les différents éléments@tie{}:
663 @lilypond[quote,verbatim]
667 \concat { 1 \super st }
671 \concat { \dynamic p , }
672 \italic { con dolce espressione }
678 Une liste des différentes commandes permettant de changer de fonte ou
679 d'utiliser des fontes personnalisées est disponible à l'annexe
682 Pour savoir comment personnaliser des fontes, reportez-vous au chapitre
691 @funindex \normalsize
718 @ref{Personnalisation des indications de nuance},
719 @ref{Indications de reprise manuelles},
723 @rlsrnamed{Text,Texte}.
725 Référence des propriétés internes :
726 @rinternals{TextScript}.
728 Fichiers d'initialisation :
729 @file{scm/define-markup-commands.scm}.
732 Le recours aux commandes @code{\teeny}, @code{\tiny},@code{\small},
733 @code{\normalsize}, @code{\large} et @code{\huge} produiront des
734 espacements nettement moins réguliers que si vous utilisez
738 @node Alignement du texte
739 @unnumberedsubsubsec Alignement du texte
740 @translationof Text alignment
742 @cindex texte, alignement
743 @cindex alignement du texte
744 @cindex alignement des markups
745 @cindex markups, alignement
747 Cette partie traite de la manière de positionner du texte en mode
748 @emph{markup}. On déplace l'intégralité d'un objet @emph{markup} en
749 utilisant la syntaxe décrite au chapitre
750 @rlearning{Déplacement d'objets}.
752 @c Padding commands should be mentioned on this page, but
753 @c most of these require \box to be more clearly illustrated. -vv
755 @cindex texte, alignement horizontal
756 @cindex alignement horizontal du texte
758 @funindex \left-align
760 @funindex \center-align
761 @funindex center-align
762 @funindex \right-align
763 @funindex right-align
765 Les objets de type @emph{markup} peuvent s'aligner de différentes
766 manières. Une indication textuelle est par défaut alignée sur son
767 extrémité gauche. Dans l'exemple qui suit, il n'y a aucune différence
768 entre les deux premiers @emph{markups}.
770 @lilypond[quote,verbatim,relative=2]
773 d-\markup { \left-align poco }
775 d-\markup { \center-align { poco } }
777 d-\markup { \right-align poco }
783 L'alignement horizontal peut être ajusté à l'aide d'une valeur
786 @lilypond[quote,verbatim,relative=2]
787 a1-\markup { \halign #-1 poco }
789 a,-\markup { \halign #0 poco }
791 a,-\markup { \halign #0.5 poco }
793 a,-\markup { \halign #2 poco }
797 Certains objets possèdent leurs propres procédures d'alignement, qui
798 annuleront toute spécification d'alignement que vous pourriez affecter
799 à un argument de type @emph{markup} que vous leur auriez fourni. La
800 solution consiste alors à déplacer l'intégralité de ces objets
801 @emph{markup}, comme indiqué par exemple au chapitre
802 @ref{Indications textuelles}.
804 @cindex texte, alignement vertical
805 @cindex alignement vertical du texte
814 @c QUERY Should the function of ``\null'' be clarified? rp
816 L'alignement vertical est quant à lui un peu plus compliqué. Comme nous
817 l'avons vu ci-avant, les objets @emph{markup} peuvent être déplacés dans
818 leur intégralité. Il est néanmois possible de déplacer certains
819 éléments spécifiques au sein d'un bloc @emph{markup}. En pareil cas,
820 l'élément à déplacer doit être précédé d'un @qq{point d'ancrage} -- un
821 autre élément du @emph{markup} ou un objet invisible. L'exemple qui
822 suit illustre ces deux possibilités. Vous noterez par ailleurs que le
823 dernier @emph{markup}, dépourvu de point d'ancrage, n'est de ce fait pas
826 @lilypond[quote,verbatim,relative=1]
829 \raise #2 { Scène 1 }
834 \lower #4 \bold { Très modéré }
838 \raise #4 \italic { Une forêt. }
843 @funindex \general-align
844 @funindex general-align
847 @funindex \translate-scaled
848 @funindex translate-scaled
850 Certaines commandes permettent de régler l'alignement des objets
851 textuels en mode @emph{markup}, tant au niveau horizontal que vertical.
852 Tout objet soumis à ces commandes doit être précédé d'un point
855 @lilypond[quote,verbatim,relative=1]
858 \translate #'(-1 . 2) "Scène 1"
863 \general-align #Y #3.2 \bold "Très modéré"
868 \translate-scaled #'(-1 . 2) \teeny "Une forêt."
873 @cindex multi-ligne, markup
874 @cindex markup multi-ligne
875 @cindex multi-ligne, texte
876 @cindex texte multi-ligne
877 @cindex texte en colonnes
878 @cindex colonnes de texte
882 @funindex \center-column
883 @funindex center-column
885 Un objet de type @emph{markup} peut contenir plusieurs lignes de texte.
886 Dans l'exemple suivant, chaque élément ou expression ira se placer sur
887 sa propre ligne, tantôt alignée à gauche, tantôt centrée.
889 @lilypond[quote,verbatim]
905 @cindex centrage du texte sur la page
906 @cindex texte, centrage sur la page
907 @cindex markup, centrage sur la page
912 Pareillement, une liste d'éléments ou d'expressions sera répartie sur
913 une ligne entière, voire même centrée sur toute la page s'il n'y a qu'un
914 seul élément. De telles expressions peuvent à leur tour contenir du
915 texte multi-ligne ou une autre expression @emph{markup}.
917 @lilypond[quote,verbatim]
920 \line { William S. Gilbert }
922 \huge \smallCaps "The Mikado"
924 \smallCaps "The Town of Titipu"
926 \line { Sir Arthur Sullivan }
934 @cindex plusieurs lignes de texte
935 @cindex justifié, texte
936 @cindex texte justifié
937 @cindex texte sur plusieurs lignes
938 @cindex markup, texte au kilomètre
939 @cindex markup, texte justifié
946 Les indications textuelles, lorsqu'elles sont relativement longues,
947 peuvent se répartir sur plusieurs lignes en fonction de la largeur de
948 ligne. Le texte sera alors soit aligné à gauche, soit justifié, comme
949 le montre l'exemple suivant@tie{}:
951 @lilypond[quote,verbatim]
954 \line \smallCaps { La vida breve }
955 \line \bold { Acto I }
957 (La escena representa el corral de una casa de
958 gitanos en el Albaicín de Granada. Al fondo una
959 puerta por la que se ve el negro interior de
960 una Fragua, iluminado por los rojos resplandores
965 \line \bold { Acto II }
966 \override #'(line-width . 50)
968 (Calle de Granada. Fachada de la casa de Carmela
969 y su hermano Manuel con grandes ventanas abiertas
970 a través de las que se ve el patio
971 donde se celebra una alegre fiesta)
977 @cindex commandes d'alignement du texte
978 @cindex markup, commandes d'alignement du texte
979 @cindex alignement du texte, commandes
981 Une liste des différentes commandes permettant d'aligner du texte en
982 mode @emph{markup} est disponible à l'annexe @ref{Align}.
986 Manuel d'initiation :
987 @rlearning{Déplacement d'objets}.
991 @ref{Indications textuelles}.
994 @rlsrnamed{Text,Texte}.
996 Référence des propriétés internes :
997 @rinternals{TextScript}.
999 Fichiers d'initialisation :
1000 @file{scm/define-markup-commands.scm}.
1003 @node Éléments graphiques dans du texte formaté
1004 @unnumberedsubsubsec Éléments graphiques dans du texte formaté
1005 @translationof Graphic notation inside markup
1007 @cindex graphisme, tracé
1008 @cindex tracé d'objets graphiques
1009 @cindex graphiques, tracé d'objets
1010 @cindex embedding graphic objects
1011 @cindex objets graphiques, tracé
1013 Vous pouvez, grâce aux mode @emph{markup}, ajouter divers objets
1014 graphiques à votre partition.
1016 @cindex décoration du texte
1017 @cindex encadrement du texte
1018 @cindex texte, encadrement
1019 @cindex texte, décoration
1020 @cindex markup, ornementation du texte
1021 @cindex markup, encadrement du texte
1027 @funindex \rounded-box
1028 @funindex rounded-box
1034 Certaines commandes de @emph{markup} permettent d'ornementer des
1035 éléments textuels avec des graphismes, à l'instar de l'exemple
1038 @lilypond[quote,verbatim]
1039 \markup \fill-line {
1047 \bracket "1866 - 1925"
1050 \rounded-box \bold Prelude
1055 @cindex espacement autour du texte
1056 @cindex texte et rembourrage
1057 @cindex markup, rembourrage du texte
1059 @funindex \pad-markup
1060 @funindex pad-markup
1063 @funindex \pad-to-box
1064 @funindex pad-to-box
1065 @funindex \pad-around
1066 @funindex pad-around
1068 Certaines directives peuvent nécessiter d'accroître l'espacement autour
1069 du texte -- voir l'annexe @ref{Align} pour une liste des différentes
1070 commandes particulières au mode @emph{markup} ainsi que leur description.
1072 @lilypond[quote,verbatim]
1073 \markup \fill-line {
1075 \box "Charles Ives (1874 - 1954)"
1077 \box \pad-markup #2 "THE UNANSWERED QUESTION"
1078 \box \pad-x #8 "A Cosmic Landscape"
1085 \box \pad-to-box #'(-5 . 20) #'(0 . 5)
1086 \bold "Largo to Presto"
1089 "String quartet keeps very even time,
1090 Flute quartet keeps very uneven time."
1094 @cindex graphisme dans la notation
1095 @cindex symboles non musicaux
1096 @cindex non musicaux, symboles
1097 @cindex notation et graphisme
1101 @funindex \draw-circle
1102 @funindex draw-circle
1103 @funindex \filled-box
1104 @funindex filled-box
1107 @funindex \draw-line
1109 @funindex \arrow-head
1110 @funindex arrow-head
1112 Vous pouvez imprimer certains graphismes ou symboles sans qu'il n'y
1113 ait de texte. Ces objets peuvent même se combiner, à l'instar de
1114 n'importe quelle expression @emph{markup}.
1116 @lilypond[quote,verbatim]
1119 \draw-circle #4 #0.4 ##f
1120 \filled-box #'(-4 . 4) #'(-0.5 . 0.5) #1
1126 \draw-line #'(0 . 4)
1127 \arrow-head #Y #DOWN ##f
1132 @cindex intégration de graphiques
1133 @cindex images, intégration
1134 @cindex graphiques, intégration
1139 @funindex \postscript
1140 @funindex postscript
1142 Des fonctionnalités graphiques avancées vous permettent même d'inclure
1143 dans une partition un fichier image converti au format PostScript
1144 encapsulé (extension @code{eps}), ou bien de tracer un graphique
1145 directement dans le fichier source à partir d'instructions PostScript
1146 pures. Nous vous conseillons, en pareil cas, de toujours spécifier les
1147 dimensions du dessin, comme dans ce qui suit@tie{}:
1149 @lilypond[quote,verbatim,relative=1]
1152 \epsfile #X #10 #"./context-example.eps"
1153 \with-dimensions #'(0 . 6) #'(0 . 10)
1169 L'annexe @ref{Graphic} répertorie les différentes commandes en matière
1174 Manuel de notation :
1176 @ref{Annotations éditoriales}.
1179 @rlsrnamed{Text,Texte}.
1181 Référence des propriétés internes :
1182 @rinternals{TextScript}.
1184 Fichiers d'initialisation :
1185 @file{scm/define-markup-commands.scm},
1186 @file{scm/stencil.scm}.
1189 @node Notation musicale dans du texte formaté
1190 @unnumberedsubsubsec Notation musicale dans du texte formaté
1191 @translationof Music notation inside markup
1193 @cindex notation dans un markup
1194 @cindex musique dans un markup
1195 @cindex markup, inclusion de musique
1197 Divers éléments de notation peuvent orner une partition, au moyen d'un
1198 objet @emph{markup}.
1200 Notes et altérations sont données à l'aide d'instructions
1201 @emph{markup}@tie{}:
1203 @lilypond[quote,verbatim,relative=2]
1207 \note-by-number #1 #1 #1.5
1210 \natural \semiflat \flat
1211 \sesquiflat \doubleflat
1215 \natural \semisharp \sharp
1216 \sesquisharp \doublesharp
1221 Le mode @emph{markup} permet d'accéder à d'autres objets de
1224 @lilypond[quote,verbatim,relative=1]
1231 fis_\markup { \dynamic rf }
1242 En règle générale, tout symbole musical peut être inclus dans un
1243 @emph{markup}, comme le montre l'exemple qui suit. Ces différents
1244 symboles sont répertoriés dans l'annexe @ref{La fonte Feta}.
1246 @lilypond[quote,verbatim,relative=2]
1248 c'^\markup { \musicglyph #"eight" }
1250 c,8._\markup { \musicglyph #"clefs.G_change" }
1252 c2^\markup { \musicglyph #"timesig.neomensural94" }
1255 Le sous-chapitre @ref{Tout savoir sur les fontes} contient d'autres
1256 informations sur l'impression de glyphes non alphabétiques, tels que des
1257 crochets ou accolades.
1259 Le mode @emph{markup} supporte aussi les diagrammes spécifiques à
1260 certains instruments@tie{}:
1262 @lilypond[quote,verbatim,relative=2]
1264 \fret-diagram-terse #"x;x;o;2;3;2;"
1267 \harp-pedal #"^-v|--ov^"
1272 \musicglyph #"accordion.discant"
1274 \raise #0.5 \musicglyph #"accordion.dot"
1275 \raise #1.5 \musicglyph #"accordion.dot"
1279 @c The accordion diagram is actually taken from a snippet.
1282 La documentation sur ces diagrammes se trouvent à l'annexe
1283 @ref{Instrument Specific Markup}.
1285 @cindex partition incluse dans un markup
1286 @cindex markup, inclusion de partition
1288 Rien ne s'oppose à ce qu'une étiquette ne comporte une partition. Il
1289 suffit que l'expression en question contienne un bloc @code{\score}
1290 incluant un bloc @code{\layout}.
1292 @lilypond[quote,verbatim,relative=1]
1295 \relative c' { c4 d e f }
1303 Les différentes commandes @emph{markup} relatives à la notation musicale
1304 sont répertoriées à l'annexe @ref{Music}.
1308 Manuel de notation :
1310 @ref{La fonte Feta},
1311 @ref{Tout savoir sur les fontes}.
1314 @rlsrnamed{Text,Texte}.
1316 Référence des propriétés internes :
1317 @rinternals{TextScript}.
1319 Fichiers d'initialisation :
1320 @file{scm/define-markup-commands.scm},
1321 @file{scm/fret-diagrams.scm},
1322 @file{scm/harp-pedals.scm}.
1325 @node Texte avec sauts de page
1326 @unnumberedsubsubsec Texte avec sauts de page
1327 @translationof Page wrapping text
1329 @cindex multi-page, markup
1330 @cindex markup multi-page
1331 @cindex markup, texte multi-page
1332 @cindex plusieurs pages de texte
1334 @funindex \markuplines
1335 @funindex markuplines
1336 @funindex \justified-lines
1337 @funindex justified-lines
1338 @funindex \wordwrap-lines
1339 @funindex wordwrap-lines
1341 Alors que @code{\markup} s'utilise pour traiter un bloc de texte
1342 insécable, @code{\markuplines} permet, employé en tête de partition,
1343 d'obtenir un bloc de lignes réparties différemment et, le cas échéant,
1344 sur plusieurs pages.
1347 @lilypond[quote,verbatim]
1350 Un long texte constitué de lignes justifiées.
1354 Un autre grand paragraphe.
1361 Cette syntaxe prend en charge une liste de @emph{markups}@tie{}; il peut
1365 d'une suite de commandes générant à leur tour des lignes de texte,
1367 d'une liste de lignes de texte,
1369 d'une liste d'étiquettes.
1372 Les différentes commandes permettant de générer des listes de lignes
1373 se trouve dans l'annexe @ref{Text markup list commands}.
1377 Manuel de notation :
1378 @ref{Text markup list commands},
1381 @rlsrnamed{Text,Texte}.
1383 @c TODO en attendant redécoupage et création de "extending" -jcm
1385 @c @rextend{New markup list command definition}.
1387 Référence des propriétés internes :
1388 @rinternals{TextScript}.
1390 Fichiers d'initialisation :
1391 @file{scm/define-markup-commands.scm}.
1394 @funindex \markuplines
1395 @funindex markuplines
1398 @code{\markuplines}.
1404 @translationof Fonts
1406 Ce chapitre est consacré aux fontes et polices de caractère, à leur
1407 gestion. Vous y apprendrez aussi comment changer de fonte en cours de
1411 * Tout savoir sur les fontes::
1412 * Attribution d'une fonte en particulier::
1413 * Choix des fontes par défaut::
1416 @node Tout savoir sur les fontes
1417 @unnumberedsubsubsec Tout savoir sur les fontes
1418 @translationof Fonts explained
1421 @cindex fontes, généralités
1422 @cindex accolades, taille
1423 @cindex fontes et markup
1424 @cindex markup et fontes
1426 @funindex font-interface
1428 La gestion des fontes est assurée par plusieurs bibliothèques@tie{}:
1429 FontConfig se charge de répertorier les différentes fontes installées
1430 sur votre système@tie{}; quant à Pango, elle se charge plus
1431 particulièrement de leur rendu.
1433 Les fontes musicales peuvent se décrire comme un jeu de glyphes
1434 spécifiques regroupés dans plusieurs familles. L'exemple qui suit
1435 montre la syntaxe à utiliser pour accéder, en mode @emph{markup}, aux
1436 différentes fontes @code{feta} non textuelles de LilyPond.
1438 @lilypond[quote,verbatim,relative=2]
1441 \override #'(font-encoding . fetaBraces)
1443 \override #'(font-encoding . fetaText)
1445 \override #'(font-encoding . fetaMusic)
1446 \lookup #"noteheads.s0petrucci"
1452 Tous ces glyphes, à l'exception des accolades qui sont regroupées dans
1453 @code{fetaBraces}, sont accessibles avec la syntaxe indiquée dans
1454 @ref{Notation musicale dans du texte formaté}.
1456 Une remarque s'impose au sujet des glyphes contenus dans
1457 @code{fetaBraces}@tie{}: chacun d'eux est formé du mot @emph{brace}
1458 auquel est accolé un numéro d'ordre. Lorsque vous désirez imprimer une
1459 accolade, vous devez la @qq{chercher} par son numéro d'ordre -- d'où la
1460 fonction @code{\lookup} de l'exemple ci-dessus --, tout en sachant qu'il
1461 est compris entre @code{0} (la plus petite) et @code{575} (la plus
1462 grande). Vous serez souvent amené à procéder par tatonnement pour
1463 arriver au résultat optimal. Par ailleurs, @code{fetaBraces} ne
1464 comporte que des accolades ouvrantes. Pour obtenir une accolade
1465 fermante, il suffit d'appliquer une rotation au glyphe sélectionné,
1466 comme indiqué au chapitre @ref{Rotation des objets}.
1468 Vous disposez de trois familles de fontes textuelles@tie{}: @emph{roman}
1469 pour la police sérif ou avec empattement -- fixée par défaut à New
1470 Century Schoolbook --, une police sans empattement (@emph{sans} sérif)
1471 et une à chasse fixe (ou monospace) -- les deux dernières étant
1472 déterminées par l'installation de Pango.
1474 Chaque famille dispose en principe de différents styles et niveaux de
1475 gras. L'exemple qui suit illustre la manière de changer la famille, le
1476 style, la graisse ou la taille. Notez bien que l'argument fourni à
1477 @code{font-size} correspond à la correction à apporter à la taille par
1480 @lilypond[quote,verbatim,relative=2]
1481 \override Score.RehearsalMark #'font-family = #'typewriter
1482 \mark \markup "Ouverture"
1483 \override Voice.TextScript #'font-shape = #'italic
1484 \override Voice.TextScript #'font-series = #'bold
1485 d2.^\markup "Allegro"
1486 \override Voice.TextScript #'font-size = #-3
1491 Cette syntaxe s'applique aussi en mode @emph{markup}, bien que celui-ci
1492 dispose d'une syntaxe allégée comme nous l'avons vu dans
1493 @ref{Sélection de la fonte et de la taille}@tie{}:
1495 @lilypond[quote,verbatim]
1499 \override #'(font-shape . italic)
1500 \override #'(font-size . 4)
1504 \override #'(font-family . typewriter)
1506 \override #'(font-series . bold)
1510 \override #'(font-family . sans)
1517 En plus de pouvoir jongler entre les différentes fontes prédéfinies,
1518 LilyPond vous permet d'en utiliser d'autres, ce qui fait l'objet des
1519 deux prochaines parties@tie{}:
1520 @ref{Attribution d'une fonte en particulier}
1521 et @ref{Choix des fontes par défaut}.
1525 Manuel de notation :
1526 @ref{La fonte Feta},
1527 @ref{Notation musicale dans du texte formaté},
1528 @ref{Sélection de la fonte et de la taille},
1532 @node Attribution d'une fonte en particulier
1533 @unnumberedsubsubsec Attribution d'une fonte en particulier
1534 @translationof Single entry fonts
1536 Vous pouvez utiliser n'importe quelle police installée sur votre
1537 système, dès lors qu'elle est accessible par Fontconfig et que vous
1538 respectez la syntaxe suivante@tie{}:
1540 @lilypond[quote,verbatim,relative=2]
1541 \override Staff.TimeSignature #'font-name = #"Bitstream Charter"
1542 \override Staff.TimeSignature #'font-size = #2
1546 \override #'(font-name . "Vera Bold")
1551 @cindex fontes disponibles
1552 @cindex disponibilité des fontes
1554 @funindex show-available-fonts
1556 Pour obtenir la liste de toutes les polices disponibles sur votre
1560 lilypond -dshow-available-fonts toto
1563 (quel qu'il soit, le dernier argument est obligatoire).
1567 Manuel de notation :
1568 @ref{Tout savoir sur les fontes},
1569 @ref{Choix des fontes par défaut}.
1572 @rlsrnamed{Text,Texte}.
1574 @c A source file gets never installed...
1575 @c Fichiers d'initialisation :
1576 @c @file{lily/font-config-scheme.cc}.
1579 @node Choix des fontes par défaut
1580 @unnumberedsubsubsec Choix des fontes par défaut
1581 @translationof Entire document fonts
1583 Vous pouvez tout à fait préférer un autre jeu de polices par défaut que
1584 celui de LilyPond. Il vous faudra alors spécifier les différentes
1585 familles, en respectant l'ordre @emph{roman}, @emph{sans empattement} et
1586 @emph{monospace}, comme dans l'exemple suivant. Pour plus
1587 d'explications sur les fontes, relisez @ref{Tout savoir sur les fontes}.
1589 @cindex polices, choix par défaut
1590 @cindex fontes, choix par défaut
1592 @funindex make-pango-font-tree
1594 @lilypond[verbatim,quote]
1598 (make-pango-font-tree "Times New Roman"
1601 (/ myStaffSize 20)))
1608 \typewriter typewriter. }
1612 @c we don't do Helvetica / Courier, since GS incorrectly loads
1617 Manuel de notation :
1618 @ref{Tout savoir sur les fontes},
1619 @ref{Attribution d'une fonte en particulier},
1620 @ref{Sélection de la fonte et de la taille},