1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
3 Translation of GIT committish: a06cb0b0d9593ba110e001f2b0f44b8bef084693
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}. Les extenseurs sont rattachés au contexte
186 @code{Dynamics} -- cf. @rinternals{Dynamics}.
189 @funindex \textSpannerUp
190 @funindex textSpannerUp
191 @funindex \textSpannerDown
192 @funindex textSpannerDown
193 @funindex \textSpannerNeutral
194 @funindex textSpannerNeutral
198 @code{\textSpannerUp},
199 @code{\textSpannerDown},
200 @code{\textSpannerNeutral}.
204 LilyPond ne peut traiter qu'un seul extenseur à la fois par voix.
208 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
209 {dynamics-text-spanner-postfix.ly}
211 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
212 {dynamics-custom-text-spanner-postfix.ly}
216 @ref{Styles de ligne},
220 @rlsrnamed{Text,Texte},
221 @rlsrnamed{Expressive marks,Signes d'interprétation}.
223 Référence des propriétés internes :
224 @rinternals{TextSpanner},
225 @rinternals{Dynamics}.
228 @node Indications textuelles
229 @unnumberedsubsubsec Indications textuelles
230 @translationof Text marks
232 @cindex indication textuelle
233 @cindex coda sur une barre de mesure
234 @cindex segno sur une barre de mesure
235 @cindex point d'orgue sur une barre de mesure
236 @cindex barres de mesure, symboles au dessus de
243 La commande @code{\mark} est tout d'abord conçue pour les
244 @ref{Indications de repère}.
246 @c \mark needs to be placed on a separate line (it's not
247 @c attached to an object like \markup is). -vv
249 @lilypond[verbatim,quote,relative=2]
255 Cette syntaxe rend possible l'adjonction de n'importe quel texte à une
256 barre de mesure. Ce texte peut être mis en forme de différentes
257 manières dès lors qu'est utilisé un bloc @code{\markup}, comme indiqué
258 au chapitre @ref{Mise en forme du texte}.
260 @lilypond[quote,verbatim,relative=1]
262 \mark \markup { \italic { colla parte } }
268 Elle peut aussi servir à insérer des signes de @emph{coda} ou de
269 @emph{segno}, ou bien un point d'orgue, au dessus d'une
270 barre de mesure. Couplez-la alors à la commande @code{\markup} pour
271 avoir accès au symbole approprié, selon les indications contenues au
272 chapitre @ref{Notation musicale dans du texte formaté}.
274 @lilypond[quote,verbatim,relative=2]
276 \mark \markup { \musicglyph #"scripts.ufermata" }
281 Le résultat de @code{\mark} n'apparaîtra que sur la portée supérieure
282 d'un système. Si vous introduisez la commande @code{\mark} au moment
283 d'une barre de mesure, la marque se placera au dessus de la barre. Si
284 vous y faites appel au milieu d'une mesure, cette marque sera
285 positionnée entre les notes. Si elle intervient en début de ligne,
286 elle sera placée juste avant la première note de cette portée. Enfin,
287 une marque qui tomberait sur un saut de ligne sera imprimée au début
288 de la ligne suivante.
290 @lilypond[quote,verbatim,relative=2]
300 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
301 {printing-marks-at-the-end-of-a-line.ly}
303 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
304 {aligning-marks-with-various-notation-objects.ly}
306 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
307 {printing-marks-on-every-staff.ly}
312 @ref{Indications de repère},
313 @ref{Mise en forme du texte},
314 @ref{Notation musicale dans du texte formaté},
318 @rlsrnamed{Text,Texte}.
320 Référence des propriétés internes :
321 @rinternals{MarkEvent},
322 @rinternals{Mark_engraver},
323 @rinternals{RehearsalMark}.
326 @node Texte indépendant
327 @unnumberedsubsubsec Texte indépendant
328 @translationof Separate text
330 @cindex texte indépendant
332 @cindex texte en préambule
333 @cindex top-level text
334 @cindex text, top-level
335 @cindex text, standalone
340 Un bloc @code{\markup} peut exister en lui-même, indépendamment de tout
341 bloc @code{\score}, et venir en préambule par exemple -- voir le
342 chapitre @ref{Structure de fichier} à ce propos.
344 @lilypond[verbatim,quote]
346 Tomorrow, and tomorrow, and tomorrow...
351 De cette manière, vous pouvez insérer du texte en dehors de la musique.
352 Ceci devient particulièrement utile lorsque le fichier source contient
353 plusieurs morceaux. Pour plus d'informations à ce propos, reportez-vous
354 au chapitre @ref{Plusieurs partitions dans un même ouvrage}.
356 @lilypond[quote,verbatim]
361 Tomorrow, and tomorrow, and tomorrow...
368 Les blocs de textes peuvent s'étendre sur plusieurs pages, ce qui permet
369 de générer des ouvrages complets uniquement grâce à LilyPond. Cette
370 fonctionnalité, ainsi que la syntaxe appropriée, est abordée plus en
371 détail au chapitre @ref{Texte avec sauts de page}.
376 @funindex \markuplines
377 @funindex markuplines
387 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
388 {stand-alone-two-column-markup.ly}
393 @ref{Mise en forme du texte},
394 @ref{Structure de fichier},
395 @ref{Plusieurs partitions dans un même ouvrage},
396 @ref{Texte avec sauts de page}.
399 @rlsrnamed{Text,Texte}.
401 Référence des propriétés internes :
402 @rinternals{TextScript}.
405 @node Mise en forme du texte
406 @subsection Mise en forme du texte
407 @translationof Formatting text
409 Nous allons voir dans les lignes qui suivent la manière de mettre en
410 forme du texte à l'aide de la syntaxe propre au mode @code{\markup}.
413 * Introduction au formatage de texte::
414 * Sélection de la fonte et de la taille::
415 * Alignement du texte::
416 * Éléments graphiques dans du texte formaté::
417 * Notation musicale dans du texte formaté::
418 * Texte avec sauts de page::
421 @node Introduction au formatage de texte
422 @unnumberedsubsubsec Introduction au formatage de texte
423 @translationof Text markup introduction
426 @cindex commentaire textuel
427 @cindex étiquette textuelle
433 La commande @code{\markup} permet d'ajouter du texte et dispose de sa
434 propre syntaxe que nous appellerons le @qq{mode @emph{markup}}.
436 @cindex markup, expressions
437 @cindex expressions markup
438 @cindex markup, syntaxe
439 @cindex syntaxe du mode markup
441 La syntaxe du mode @emph{markup} n'est pas différente de celle des
442 autres modes de LilyPond@tie{}: une expression @code{\markup} est bornée
443 par des accolades @code{@{@tie{}@dots{}@tie{}@}}. Un mot unique sera
444 considéré comme une expression minimale, et n'aura donc pas besoin
445 d'être mis entre accolades.
447 Contrairement aux indications simples, du type "entre guillemets", les
448 blocs @code{\markup} peuvent contenir des expressions imbriquées ou
449 d'autres commandes @emph{markup}, dès lors qu'elles sont précédées du
450 caractère @code{\}. Ces commandes n'affecteront que la première
451 expression qui les suit.
453 @lilypond[quote,verbatim,relative=2]
455 a2^\markup { poco \italic più forte }
457 d2_\markup { \italic "string. assai" }
459 b1^\markup { \bold { molto \italic agitato } }
463 @cindex caractères spéciaux en mode markup
464 @cindex mode markup et caractères spéciaux
465 @cindex caractères réservés, impression
466 @cindex impression de caractères réservés
467 @cindex impression de caractères spéciaux
468 @cindex guillemets en mode markup
469 @cindex mode markup et guillemets
471 Un bloc @code{\markup} peut contenir du texte entre guillemets. De
472 telles chaines seront considérées comme des expressions textuelles
473 minimales@tie{}; à ce titre, toute commande de type @emph{markup} ou
474 tout caractère spécial -- tel un @code{\} ou un @code{#} -- sera imprimé
475 littéralement et sans influer sur le formatage du texte. Il est de ce
476 fait possible d'imprimer des guillemets informatiques @code{"} dès lors
477 qu'ils sont précédés d'une oblique inverse.
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{}:
493 @lilypond[quote,verbatim,relative=2]
494 c1^\markup { \center-column { a bbb c } }
495 c1^\markup { \center-column { a { bbb c } } }
496 c1^\markup { \center-column { a \line { bbb c } } }
497 c1^\markup { \center-column { a "bbb c" } }
500 Vous pouvez stocker les étiquettes textuelles en tant que variables,
501 et attacher ces identificateurs à des notes, comme ici@tie{}:
503 @lilypond[quote,verbatim]
504 allegro = \markup { \bold \large Allegro }
513 Pour une liste des différentes commandes spécifiques au mode
514 @code{\markup}, consultez l'annexe @ref{Text markup commands} (en
520 @ref{Text markup commands}.
523 @rlsrnamed{Text,Texte}.
525 Fichiers d'initialisation :
526 @file{scm/@/markup@/.scm}.
531 Les erreurs de syntaxe en mode @emph{markup} sont peu loquaces.
534 @node Sélection de la fonte et de la taille
535 @unnumberedsubsubsec Sélection de la fonte et de la taille
536 @translationof Selecting font and font size
538 @cindex fonte, changement
539 @cindex changement de fonte
551 Le mode @emph{markup} autorise des changements élémentaires de la
554 @lilypond[quote,verbatim,relative=2]
557 \italic { non troppo \underline Vivo }
560 d,_\markup { \italic quasi \smallCaps Tromba }
564 @cindex caratères, taille
565 @cindex texte, taille
576 La taille des caractères se modifie de différentes manières@tie{}:
579 à partir de l'une des tailles standard prédéfinies,
582 en étant définie en valeur absolue,
585 en adoptant une valeur relative à celle précédemment définie.
589 Voici une illustration de ces trois différentes méthodes@tie{}:
591 @lilypond[quote,verbatim,relative=1]
598 \fontsize #5 Sinfonia
605 \magnify #0.6 { e sentimento } )
618 Vous pouvez imprimer du texte en indice ou en exposant. Celui-ci sera
619 dans un taille plus petite, mais rien ne s'oppose à ce que vous lui
620 affectiez un taille normale@tie{}:
622 @lilypond[quote,verbatim]
625 \line { 1 \super st movement }
626 \line { 1 \normal-size-super st movement
627 \sub { (part two) } }
632 @cindex fontes, familles
634 Le mode @emph{markup} vous permet de sélectionner d'autres familles de
635 fontes. Par défaut, LilyPond utilise une police avec empattement, du
636 type roman, et tout changement doit être explicite. Dans la dernière
637 ligne de l'exemple qui suit, vous noterez qu'il n'y a aucune différence
638 entre les premier et deuxième mots.
640 @lilypond[quote,verbatim]
643 \line { Act \number 1 }
644 \line { \sans { Scene I. } }
645 \line { \typewriter { Verona. An open place. } }
646 \line { Enter \roman Valentine and Proteus. }
652 Certaines familles de police spécifiques aux nombres ou aux nuances par
653 exemple, ne disposent pas de tous les caractères, comme nous l'avons vu
654 dans les chapitres @ref{Personnalisation des indications de nuance} et
655 @ref{Indications de reprise manuelles}.
657 @c \concat is actually documented in Align (it is not
658 @c a font-switching command). But we need it here. -vv
660 Lorsqu'un changement survient au milieu d'un mot, il se peut qu'un
661 espacement supplémentaire apparaisse. Il suffit en pareil cas de
662 concaténer les différents éléments@tie{}:
664 @lilypond[quote,verbatim]
668 \concat { 1 \super st }
672 \concat { \dynamic p , }
673 \italic { con dolce espressione }
679 Une liste des différentes commandes permettant de changer de fonte ou
680 d'utiliser des fontes personnalisées est disponible à l'annexe
683 Pour savoir comment personnaliser des fontes, reportez-vous au chapitre
692 @funindex \normalsize
719 @ref{Personnalisation des indications de nuance},
720 @ref{Indications de reprise manuelles},
724 @rlsrnamed{Text,Texte}.
726 Référence des propriétés internes :
727 @rinternals{TextScript}.
729 Fichiers d'initialisation :
730 @file{scm/@/define@/-markup@/-commands@/.scm}.
733 @node Alignement du texte
734 @unnumberedsubsubsec Alignement du texte
735 @translationof Text alignment
737 @cindex texte, alignement
738 @cindex alignement du texte
739 @cindex alignement des markups
740 @cindex markups, alignement
742 Cette partie traite de la manière de positionner du texte en mode
743 @emph{markup}. On déplace l'intégralité d'un objet @emph{markup} en
744 utilisant la syntaxe décrite au chapitre
745 @rlearning{Déplacement d'objets}.
747 @c Padding commands should be mentioned on this page, but
748 @c most of these require \box to be more clearly illustrated. -vv
750 @cindex texte, alignement horizontal
751 @cindex alignement horizontal du texte
753 @funindex \left-align
755 @funindex \center-align
756 @funindex center-align
757 @funindex \right-align
758 @funindex right-align
760 Les objets de type @emph{markup} peuvent s'aligner de différentes
761 manières. Une indication textuelle est par défaut alignée sur son
762 extrémité gauche. Dans l'exemple qui suit, il n'y a aucune différence
763 entre les deux premiers @emph{markups}.
765 @lilypond[quote,verbatim,relative=2]
768 d-\markup { \left-align poco }
770 d-\markup { \center-align { poco } }
772 d-\markup { \right-align poco }
778 L'alignement horizontal peut être ajusté à l'aide d'une valeur
781 @lilypond[quote,verbatim,relative=2]
782 a1-\markup { \halign #-1 poco }
784 a,-\markup { \halign #0 poco }
786 a,-\markup { \halign #0.5 poco }
788 a,-\markup { \halign #2 poco }
792 Certains objets possèdent leurs propres procédures d'alignement, qui
793 annuleront toute spécification d'alignement que vous pourriez affecter
794 à un argument de type @emph{markup} que vous leur auriez fourni. La
795 solution consiste alors à déplacer l'intégralité de ces objets
796 @emph{markup}, comme indiqué par exemple au chapitre
797 @ref{Indications textuelles}.
799 @cindex texte, alignement vertical
800 @cindex alignement vertical du texte
809 @c QUERY Should the function of ``\null'' be clarified? rp
811 L'alignement vertical est quant à lui un peu plus compliqué. Comme nous
812 l'avons vu ci-avant, les objets @emph{markup} peuvent être déplacés dans
813 leur intégralité. Il est néanmois possible de déplacer certains
814 éléments spécifiques au sein d'un bloc @emph{markup}. En pareil cas,
815 l'élément à déplacer doit être précédé d'un @qq{point d'ancrage} -- un
816 autre élément du @emph{markup} ou un objet invisible. L'exemple qui
817 suit illustre ces deux possibilités. Vous noterez par ailleurs que le
818 dernier @emph{markup}, dépourvu de point d'ancrage, n'est de ce fait pas
821 @lilypond[quote,verbatim,relative=1]
824 \raise #2 { Scène 1 }
829 \lower #4 \bold { Très modéré }
833 \raise #4 \italic { Une forêt. }
838 @funindex \general-align
839 @funindex general-align
842 @funindex \translate-scaled
843 @funindex translate-scaled
845 Certaines commandes permettent de régler l'alignement des objets
846 textuels en mode @emph{markup}, tant au niveau horizontal que vertical.
847 Tout objet soumis à ces commandes doit être précédé d'un point
850 @lilypond[quote,verbatim,relative=1]
853 \translate #'(-1 . 2) "Scène 1"
858 \general-align #Y #3.2 \bold "Très modéré"
863 \translate-scaled #'(-1 . 2) \teeny "Une forêt."
868 @cindex multi-ligne, markup
869 @cindex markup multi-ligne
870 @cindex multi-ligne, texte
871 @cindex texte multi-ligne
872 @cindex texte en colonnes
873 @cindex colonnes de texte
877 @funindex \center-column
878 @funindex center-column
880 Un objet de type @emph{markup} peut contenir plusieurs lignes de texte.
881 Dans l'exemple suivant, chaque élément ou expression ira se placer sur
882 sa propre ligne, tantôt alignée à gauche, tantôt centrée.
884 @lilypond[quote,verbatim]
900 @cindex centrage du texte sur la page
901 @cindex texte, centrage sur la page
902 @cindex markup, centrage sur la page
907 Pareillement, une liste d'éléments ou d'expressions sera répartie sur
908 une ligne entière, voire même centrée sur toute la page s'il n'y a qu'un
909 seul élément. De telles expressions peuvent à leur tour contenir du
910 texte multi-ligne ou une autre expression @emph{markup}.
912 @lilypond[quote,verbatim]
915 \line { William S. Gilbert }
917 \huge \smallCaps "The Mikado"
919 \smallCaps "The Town of Titipu"
921 \line { Sir Arthur Sullivan }
929 @cindex plusieurs lignes de texte
930 @cindex justifié, texte
931 @cindex texte justifié
932 @cindex texte sur plusieurs lignes
933 @cindex markup, texte wordwrapped
934 @cindex markup, texte justifié
941 Les indications textuelles, lorsqu'elles sont relativement longues,
942 peuvent se répartir sur plusieurs lignes en fonction de la largeur de
943 ligne. Le texte sera alors soit aligné à gauche, soit justifié, comme
944 le montre l'exemple suivant@tie{}:
946 @lilypond[quote,verbatim]
949 \line \smallCaps { La vida breve }
950 \line \bold { Acto I }
952 (La escena representa el corral de una casa de
953 gitanos en el Albaicín de Granada. Al fondo una
954 puerta por la que se ve el negro interior de
955 una Fragua, iluminado por los rojos resplandores
960 \line \bold { Acto II }
961 \override #'(line-width . 50)
963 (Calle de Granada. Fachada de la casa de Carmela
964 y su hermano Manuel con grandes ventanas abiertas
965 a través de las que se ve el patio
966 donde se celebra una alegre fiesta)
972 @cindex commandes d'alignement du texte
973 @cindex markup, commandes d'alignement du texte
974 @cindex alignement du texte, commandes
976 Une liste des différentes commandes permettant d'aligner du texte en
977 mode @emph{markup} est disponible à l'annexe @ref{Align}.
981 Manuel d'initiation :
982 @rlearning{Déplacement d'objets}.
986 @ref{Indications textuelles}.
989 @rlsrnamed{Text,Texte}.
991 Référence des propriétés internes :
992 @rinternals{TextScript}.
994 Fichiers d'initialisation :
995 @file{scm/@/define@/-markup@/-commands@/.scm}.
998 @node Éléments graphiques dans du texte formaté
999 @unnumberedsubsubsec Éléments graphiques dans du texte formaté
1000 @translationof Graphic notation inside markup
1002 @cindex graphisme, tracé
1003 @cindex tracé d'objets graphiques
1004 @cindex graphiques, tracé d'objets
1005 @cindex embedding graphic objects
1006 @cindex objets graphiques, tracé
1008 Vous pouvez, grâce aux mode @emph{markup}, ajouter divers objets
1009 graphiques à votre partition.
1011 @cindex décoration du texte
1012 @cindex encadrement du texte
1013 @cindex texte, encadrement
1014 @cindex texte, décoration
1015 @cindex markup, ornementation du texte
1016 @cindex markup, encadrement du texte
1022 @funindex \rounded-box
1023 @funindex rounded-box
1029 Certaines commandes de @emph{markup} permettent d'ornementer des
1030 éléments textuels avec des graphismes, à l'instar de l'exemple
1033 @lilypond[quote,verbatim]
1034 \markup \fill-line {
1042 \bracket "1866 - 1925"
1045 \rounded-box \bold Prelude
1050 @cindex espacement autour du texte
1051 @cindex texte et rembourrage
1052 @cindex markup, rembourrage du texte
1054 @funindex \pad-markup
1055 @funindex pad-markup
1058 @funindex \pad-to-box
1059 @funindex pad-to-box
1060 @funindex \pad-around
1061 @funindex pad-around
1063 Certaines directives peuvent nécessiter d'accroître l'espacement autour
1064 du texte -- voir l'annexe @ref{Align} pour une liste des différentes
1065 commandes particulières au mode @emph{markup} ainsi que leur description.
1067 @lilypond[quote,verbatim]
1068 \markup \fill-line {
1070 \box "Charles Ives (1874 - 1954)"
1072 \box \pad-markup #2 "THE UNANSWERED QUESTION"
1073 \box \pad-x #8 "A Cosmic Landscape"
1080 \box \pad-to-box #'(-5 . 20) #'(0 . 5)
1081 \bold "Largo to Presto"
1084 "String quartet keeps very even time,
1085 Flute quartet keeps very uneven time."
1089 @cindex graphisme dans la notation
1090 @cindex symboles non musicaux
1091 @cindex non musicaux, symboles
1092 @cindex notation et graphisme
1096 @funindex \draw-circle
1097 @funindex draw-circle
1098 @funindex \filled-box
1099 @funindex filled-box
1102 @funindex \draw-line
1104 @funindex \arrow-head
1105 @funindex arrow-head
1107 Vous pouvez imprimer certains graphismes ou symboles sans qu'il n'y
1108 ait de texte. Ces objets peuvent même se combiner, à l'instar de
1109 n'importe quelle expression @emph{markup}.
1111 @lilypond[quote,verbatim]
1114 \draw-circle #4 #0.4 ##f
1115 \filled-box #'(-4 . 4) #'(-0.5 . 0.5) #1
1121 \draw-line #'(0 . 4)
1122 \arrow-head #Y #DOWN ##f
1127 @cindex intégration de graphiques
1128 @cindex images, intégration
1129 @cindex graphiques, intégration
1134 @funindex \postscript
1135 @funindex postscript
1137 Des fonctionnalités graphiques avancées vous permettent même d'inclure
1138 dans une partition un fichier image converti au format PostScript
1139 encapsulé (extension @code{eps}), ou bien de tracer un graphique
1140 directement dans le fichier source à partir d'instructions PostScript
1141 pures. Nous vous conseillons, en pareil cas, de toujours spécifier les
1142 dimensions du dessin, comme dans ce qui suit@tie{}:
1144 @lilypond[quote,verbatim,relative=1]
1147 \epsfile #X #10 #"./context-example.eps"
1148 \with-dimensions #'(0 . 6) #'(0 . 10)
1164 L'annexe @ref{Graphic} répertorie les différentes commandes en matière
1169 Manuel de notation :
1171 @ref{Annotations éditoriales}.
1174 @rlsrnamed{Text,Texte}.
1176 Référence des propriétés internes :
1177 @rinternals{TextScript}.
1179 Fichiers d'initialisation :
1180 @file{scm/@/define@/-markup@/-commands@/.scm},
1181 @file{scm/@/stencil@/.scm}.
1184 @node Notation musicale dans du texte formaté
1185 @unnumberedsubsubsec Notation musicale dans du texte formaté
1186 @translationof Music notation inside markup
1188 @cindex notation dans un markup
1189 @cindex musique dans un markup
1190 @cindex markup, inclusion de musique
1192 Divers éléments de notation peuvent orner une partition, au moyen d'un
1193 objet @emph{markup}.
1195 Notes et altérations sont données à l'aide d'instructions
1196 @emph{markup}@tie{}:
1198 @lilypond[quote,verbatim,relative=2]
1202 \note-by-number #1 #1 #1.5
1205 \natural \semiflat \flat
1206 \sesquiflat \doubleflat
1210 \natural \semisharp \sharp
1211 \sesquisharp \doublesharp
1216 Le mode @emph{markup} permet d'accéder à d'autres objets de
1219 @lilypond[quote,verbatim,relative=1]
1226 fis_\markup { \dynamic rf }
1237 En règle générale, tout symbole musical peut être inclus dans un
1238 @emph{markup}, comme le montre l'exemple qui suit. Ces différents
1239 symboles sont répertoriés dans l'annexe @ref{La fonte Feta}.
1241 @lilypond[quote,verbatim,relative=2]
1243 c'^\markup { \musicglyph #"eight" }
1245 c,8._\markup { \musicglyph #"clefs.G_change" }
1247 c2^\markup { \musicglyph #"timesig.neomensural94" }
1250 Le sous-chapitre @ref{Tout savoir sur les fontes} contient d'autres
1251 informations sur l'impression de glyphes non alphabétiques, tels que des
1252 crochets ou accolades.
1254 Le mode @emph{markup} supporte aussi les diagrammes spécifiques à
1255 certains instruments@tie{}:
1257 @lilypond[quote,verbatim,relative=2]
1259 \fret-diagram-terse #"x;x;o;2;3;2;"
1262 \harp-pedal #"^-v|--ov^"
1267 \musicglyph #"accordion.accDiscant"
1269 \raise #0.5 \musicglyph #"accordion.accDot"
1270 \raise #1.5 \musicglyph #"accordion.accDot"
1274 @c The accordion diagram is actually taken from a snippet.
1277 La documentation sur ces diagrammes se trouvent à l'annexe
1278 @ref{Instrument Specific Markup}.
1280 @cindex partition incluse dans un markup
1281 @cindex markup, inclusion de partition
1283 Rien ne s'oppose à ce qu'une étiquette ne comporte une partition. Il
1284 suffit que l'expression en question contienne un bloc @code{\score}
1285 incluant un bloc @code{\layout}.
1287 @lilypond[quote,verbatim,ragged-right]
1291 \relative { c4 d e f }
1299 Les différentes commandes @emph{markup} relatives à la notation musicale
1300 sont répertoriées à l'annexe @ref{Music}.
1304 Manuel de notation :
1306 @ref{La fonte Feta},
1307 @ref{Tout savoir sur les fontes}.
1310 @rlsrnamed{Text,Texte}.
1312 Référence des propriétés internes :
1313 @rinternals{TextScript}.
1315 Fichiers d'initialisation :
1316 @file{scm/@/define@/-markup@/-commands@/.scm},
1317 @file{scm/@/fret@/-diagrams@/.scm},
1318 @file{scm/@/harp@/-pedals@/.scm}.
1321 @node Texte avec sauts de page
1322 @unnumberedsubsubsec Texte avec sauts de page
1323 @translationof Page wrapping text
1325 @cindex multi-page, markup
1326 @cindex markup multi-page
1327 @cindex markup, texte multi-page
1328 @cindex plusieurs pages de texte
1330 @funindex \markuplines
1331 @funindex markuplines
1332 @funindex \justified-lines
1333 @funindex justified-lines
1334 @funindex \wordwrap-lines
1335 @funindex wordwrap-lines
1337 Alors que @code{\markup} s'utilise pour traiter un bloc de texte
1338 insécable, @code{\markuplines} permet, employé en tête de partition,
1339 d'obtenir un bloc de lignes réparties différemment et, le cas échéant,
1340 sur plusieurs pages.
1343 @lilypond[quote,verbatim]
1346 Un long texte constitué de lignes justifiées.
1350 Un autre grand paragraphe.
1357 Cette syntaxe prend en charge une liste de @emph{markups}@tie{}; il peut
1361 d'une suite de commandes générant à leur tour des lignes de texte,
1363 d'une liste de lignes de texte,
1365 d'une liste d'étiquettes.
1368 Les différentes commandes permettant de générer des listes de lignes
1369 se trouve dans l'annexe @ref{Text markup list commands}.
1373 Manuel de notation :
1374 @ref{Text markup list commands},
1377 @rlsrnamed{Text,Texte}.
1379 @c en attendant redécoupage et création de "extending" -jcm
1381 @c @rextend{New markup list command definition}.
1383 Référence des propriétés internes :
1384 @rinternals{TextScript}.
1386 Fichiers d'initialisation :
1387 @file{scm/@/define@/-markup@/-commands@/.scm}.
1390 @funindex \markuplines
1391 @funindex markuplines
1394 @code{\markuplines}.
1400 @translationof Fonts
1402 Ce chapitre est consacré aux fontes et polices de caractère, à leur
1403 gestion. Vous y apprendrez aussi comment changer de fonte en cours de
1407 * Tout savoir sur les fontes::
1408 * Attribution d'une fonte en particulier::
1409 * Choix des fontes par défaut::
1412 @node Tout savoir sur les fontes
1413 @unnumberedsubsubsec Tout savoir sur les fontes
1414 @translationof Fonts explained
1417 @cindex fontes, généralités
1418 @cindex accolades, taille
1419 @cindex fontes et markup
1420 @cindex markup et fontes
1422 @funindex font-interface
1424 La gestion des fontes est assurée par plusieurs bibliothèques@tie{}:
1425 FontConfig se charge de répertorier les différentes fontes installées
1426 sur votre système@tie{}; quant à Pango, elle se charge plus
1427 particulièrement de leur rendu.
1429 Les fontes musicales peuvent se décrire comme un jeu de glyphes
1430 spécifiques regroupés dans plusieurs familles. L'exemple qui suit
1431 montre la syntaxe à utiliser pour accéder, en mode @emph{markup}, aux
1432 différentes fontes @code{feta} non textuelles de LilyPond.
1434 @lilypond[quote,verbatim,relative=2]
1437 \override #'(font-encoding . fetaBraces)
1439 \override #'(font-encoding . fetaNumber)
1441 \override #'(font-encoding . fetaDynamic)
1443 \override #'(font-encoding . fetaMusic)
1444 \lookup #"noteheads.s0petrucci"
1450 Tous ces glyphes, à l'exception des accolades qui sont regroupées dans
1451 @code{fetaBraces}, sont accessibles avec la syntaxe indiquée dans
1452 @ref{Notation musicale dans du texte formaté}.
1454 Une remarque s'impose au sujet des glyphes contenus dans
1455 @code{fetaBraces}@tie{}: chacun d'eux est formé du mot @emph{brace}
1456 auquel est accolé un numéro d'ordre. Lorsque vous désirez imprimer une
1457 accolade, vous devez la @qq{chercher} par son numéro d'ordre -- d'où la
1458 fonction @code{\lookup} de l'exemple ci-dessus --, tout en sachant qu'il
1459 est compris entre @code{0} (la plus petite) et @code{575} (la plus
1460 grande). Vous serez souvent amené à procéder par tatonnement pour
1461 arriver au résultat optimal. Par ailleurs, @code{fetaBraces} ne
1462 comporte que des accolades ouvrantes. Pour obtenir une accolade
1463 fermante, il suffit d'appliquer une rotation au glyphe sélectionné,
1464 comme indiqué au chapitre @ref{Rotation des objets}.
1466 Vous disposez de trois familles de fontes textuelles@tie{}: @emph{roman}
1467 pour la police sérif ou avec empattement -- fixée par défaut à New
1468 Century Schoolbook --, une police sans empattement (@emph{sans} sérif)
1469 et une à chasse fixe (ou monospace) -- les deux dernières étant
1470 déterminées par l'installation de Pango.
1472 Chaque famille dispose en principe de différents styles et niveau de
1473 gras. L'exemple qui suit illustre la manière de changer la famille, le
1474 style, la graisse ou la taille. Notez bien que l'argument fourni à
1475 @code{font-size} correspond à la correction à apporter à la taille par
1478 @lilypond[quote,verbatim,relative=2]
1479 \override Score.RehearsalMark #'font-family = #'typewriter
1480 \mark \markup "Ouverture"
1481 \override Voice.TextScript #'font-shape = #'italic
1482 \override Voice.TextScript #'font-series = #'bold
1483 d2.^\markup "Allegro"
1484 \override Voice.TextScript #'font-size = #-3
1489 Cette syntaxe s'applique aussi en mode @emph{markup}, bien que celui-ci
1490 dispose d'une syntaxe allégée comme nous l'avons vu dans
1491 @ref{Sélection de la fonte et de la taille}@tie{}:
1493 @lilypond[quote,verbatim]
1497 \override #'(font-shape . italic)
1498 \override #'(font-size . 4)
1502 \override #'(font-family . typewriter)
1504 \override #'(font-series . bold)
1508 \override #'(font-family . sans)
1515 En plus de pouvoir jongler entre les différentes fontes prédéfinies,
1516 LilyPond vous permet d'en utiliser d'autres, ce qui fait l'objet des
1517 deux prochaines parties@tie{}:
1518 @ref{Attribution d'une fonte en particulier}
1519 et @ref{Choix des fontes par défaut}.
1523 Manuel de notation :
1524 @ref{La fonte Feta},
1525 @ref{Notation musicale dans du texte formaté},
1526 @ref{Sélection de la fonte et de la taille},
1530 @node Attribution d'une fonte en particulier
1531 @unnumberedsubsubsec Attribution d'une fonte en particulier
1532 @translationof Single entry fonts
1534 Vous pouvez utiliser n'importe quelle police installée sur votre
1535 système, du moment où elle est accessible par Fontconfig, en respectant
1536 la syntaxe suivante@tie{}:
1538 @lilypond[quote,verbatim,relative=2]
1539 \override Staff.TimeSignature #'font-name = #"Bitstream Charter"
1540 \override Staff.TimeSignature #'font-size = #2
1544 \override #'(font-name . "Vera Bold")
1549 @cindex fontes disponibles
1550 @cindex disponibilité des fontes
1552 @funindex show-available-fonts
1554 Pour obtenir la liste de toutes les polices disponibles sur votre
1558 lilypond -dshow-available-fonts toto
1561 (quel qu'il soit, le dernier argument est obligatoire).
1565 Manuel de notation :
1566 @ref{Tout savoir sur les fontes},
1567 @ref{Choix des fontes par défaut}.
1570 @rlsrnamed{Text,Texte}.
1572 @c A source file gets never installed...
1573 @c Fichiers d'initialisation :
1574 @c @file{lily/@/font@/-config@/-scheme@/.cc}.
1577 @node Choix des fontes par défaut
1578 @unnumberedsubsubsec Choix des fontes par défaut
1579 @translationof Entire document fonts
1581 Vous pouvez tout à fait préférer un autre jeu de polices par défaut que
1582 celui de LilyPond. Il vous faudra alors spécifier les différentes
1583 familles, en respectant l'ordre @emph{roman}, @emph{sans empattement} et
1584 @emph{monospace}, comme dans l'exemple suivant. Pour plus
1585 d'explications sur les fontes, relisez @ref{Tout savoir sur les fontes}.
1587 @cindex polices, choix par défaut
1588 @cindex fontes, choix par défaut
1590 @funindex make-pango-font-tree
1592 @lilypond[verbatim,quote]
1596 (make-pango-font-tree "Times New Roman"
1599 (/ myStaffSize 20)))
1606 \typewriter typewriter. }
1610 @c we don't do Helvetica / Courier, since GS incorrectly loads
1615 Manuel de notation :
1616 @ref{Tout savoir sur les fontes},
1617 @ref{Attribution d'une fonte en particulier},
1618 @ref{Sélection de la fonte et de la taille},