1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
3 Translation of GIT committish: 548ef200973bd3d46ea75c5498461d9e5f168334
5 When revising a translation, copy the HEAD committish of the
6 version that you are working on. For details, see the Contributors'
7 Guide, node Updating translation committishes..
12 @c Translators: Jean-Charles Malahieude
13 @c Translation checkers: Valentin Villenave, John Mandereau
19 @lilypondfile[quote]{text-headword.ly}
21 Nous allons voir ici comment insérer du texte dans une partition, ainsi que
22 différentes manières de le mettre en forme.
25 Certains éléments de texte ne sont pas abordés ici mais dans des
26 chapitres qui leur sont dédiés. C'est le cas de la
27 @ref{Musique vocale} et des @ref{Titres et entêtes}.
31 * Mise en forme du texte::
36 @subsection Ajout de texte
37 @translationof Writing text
39 Cette partie constitue une introduction aux différentes manières
40 d'ajouter du texte à une partition.
42 @cindex Texte, autres langues
43 @warning{Pour écrire des accents et autres caractères spéciaux, il suffit de
44 les insérer directement dans votre fichier LilyPond. Ce fichier devra
45 être sauvegardé avec l'encodage UTF-8. Pour plus d'informations, voir
46 @ref{Codage du texte}.}
49 * Commentaires textuels::
50 * Indications textuelles et lignes d'extension::
51 * Indications textuelles::
55 @node Commentaires textuels
56 @unnumberedsubsubsec Commentaires textuels
57 @translationof Text scripts
59 @cindex Étiquette de texte
60 @cindex blocs de texte
61 @cindex ajout de texte
63 Vous pouvez ajouter à une partition des indications sous forme texuelle,
64 comme dans l'exemple suivant. Ces indications se placeront manuellement
65 au-dessus ou au-dessous de la portée selon la syntaxe utilisée -- cf.
66 @ref{Direction et positionnement}.
68 @lilypond[quote,verbatim,relative=2]
69 a8^"pizz." g f e a4-"scherz." f
72 Cette syntaxe est en fait un raccourci. Des constructions plus
73 élaborées d'annotation peuvent être obtenues en ayant recours à un bloc
74 @code{\markup} et selon les préceptes énoncés dans
75 @ref{Mise en forme du texte}.
77 @lilypond[quote,verbatim,relative=2]
78 a8^\markup { \italic pizz. } g f e
79 a4_\markup { \tiny scherz. \bold molto } f
82 Par défaut, ces indications n'affectent en rien l'espacement des
83 notes. Leur longueur peut néanmoins être prise en considération : dans
84 l'exemple qui suit, le premier commentaire n'influe pas sur
85 l'espacement, à l'inverse du second.
87 @lilypond[quote,verbatim,relative=2]
94 @funindex \textLengthOn
95 @funindex textLengthOn
96 @funindex \textLengthOff
97 @funindex textLengthOff
100 @code{\textLengthOn},
101 @code{\textLengthOff}.
107 @ref{Mise en forme du texte},
108 @ref{Direction et positionnement}.
113 Référence des propriétés internes :
114 @rinternals{TextScript}.
117 @cindex texte hors marges
118 @cindex marges, texte qui dépasse
119 @cindex texte, maintien dans les marges
120 @cindex texte, maintien dans les marges
125 S'assurer que tous les éléments textuels et les paroles respectent
126 les marges du document requiert des calculs relativement lourds ; c'est
127 la raison pour laquelle LilyPond, par défaut, ne s'en préoccupe pas.
128 Vous pouvez cependant l'y forcer en définissant
131 \override Score.PaperColumn #'keep-inside-line = ##t
135 @node Indications textuelles et lignes d'extension
136 @unnumberedsubsubsec Indications textuelles et lignes d'extension
137 @translationof Text spanners
139 @cindex texte et extenseur
140 @cindex prolongation de texte
143 Certaines indications d'interprétation comme @i{rallentando},
144 @i{accelerando} ou @i{trilles}, s'incrivent textuellement et se
145 prolongent sur plusieurs notes à l'aide d'une ligne pleine, pointillée
146 ou ondulée. Ces objets, que l'on appelle @qq{extenseurs}, se dessinent
147 entre deux notes à l'aide de la syntaxe suivante :
149 @lilypond[verbatim,quote,relative=2]
150 \override TextSpanner #'(bound-details left text) = "rit."
155 @cindex texte, mise en forme des prolongations
156 @cindex texte, mise en forme des extenseurs
157 @cindex extenseur, mise en forme
160 Le texte à imprimer est spécifié en tant que propriété de l'objet
161 @code{TextSpanner}. Il apparaîtra par défaut en italique ; cependant,
162 rien ne s'oppose à un autre graphisme dès lors que vous faites appel à
163 un bloc @code{\markup} -- voir @ref{Mise en forme du texte}.
165 @lilypond[quote,relative=2,verbatim]
166 \override TextSpanner #'(bound-details left text) =
167 \markup { \upright "rit." }
172 Le style de ligne se définit lui aussi comme une propriété de l'objet.
173 Les détails concernant la syntaxe à utiliser sont expliqués au chapitre
177 @funindex \textSpannerUp
178 @funindex textSpannerUp
179 @funindex \textSpannerDown
180 @funindex textSpannerDown
181 @funindex \textSpannerNeutral
182 @funindex textSpannerNeutral
186 @code{\textSpannerUp},
187 @code{\textSpannerDown},
188 @code{\textSpannerNeutral}.
200 Référence des propriétés internes :
201 @rinternals{TextSpanner}.
204 @node Indications textuelles
205 @unnumberedsubsubsec Indications textuelles
206 @translationof Text marks
208 @cindex indication textuelle
209 @cindex coda sur une barre de mesure
210 @cindex segno sur une barre de mesure
211 @cindex point d'orgue sur une barre de mesure
212 @cindex barres de mesure, symboles au dessus de
219 La commande @code{\mark} est tout d'abord conçue pour les
220 @ref{Indications de repère}.
222 @c \mark needs to be placed on a separate line (it's not
223 @c attached to an object like \markup is). -vv
225 @lilypond[verbatim,quote,relative=2]
231 Cette syntaxe rend possible l'adjonction de n'importe quel texte à une
232 barre de mesure. Ce texte peut être mis en forme de différentes
233 manières dès lors qu'est utilisé un bloc @code{\markup}, comme indiqué
234 au chapitre @ref{Mise en forme du texte}.
236 @lilypond[quote,verbatim,relative=1]
238 \mark \markup { \italic { colla parte } }
244 Elle peut aussi servir à insérer des signes de @emph{coda} ou de
245 @emph{segno}, ou bien un point d'orgue, au dessus d'une
246 barre de mesure. Couplez-la alors à la commande @code{\markup} pour
247 avoir accès au symbole approprié, selon les indications contenues au
248 chapitre @ref{Notation musicale dans du texte formaté}.
250 @lilypond[quote,verbatim,relative=2]
252 \mark \markup { \musicglyph #"scripts.ufermata" }
257 Le résultat de @code{\mark} n'apparaîtra que sur la portée supérieure
258 d'un système. Si vous introduisez la commande @code{\mark} au moment
259 d'une barre de mesure, la marque se placera au dessus de la barre. Si
260 vous y faites appel au milieu d'une mesure, cette marque sera
261 positionnée entre les notes. Si elle intervient en début de ligne,
262 elle sera placée juste avant la première note de cette portée. Enfin,
263 une marque qui tomberait sur un saut de ligne sera imprimée au début
264 de la ligne suivante.
266 @lilypond[quote,verbatim,relative=2]
276 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
277 {printing-marks-at-the-end-of-a-line.ly}
279 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
280 {aligning-marks-with-various-notation-objects.ly}
282 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
283 {printing-marks-on-every-staff.ly}
288 @ref{Indications de repère},
289 @ref{Mise en forme du texte},
290 @ref{Notation musicale dans du texte formaté},
296 Référence des propriétés internes :
297 @rinternals{MarkEvent},
298 @rinternals{Mark_engraver},
299 @rinternals{RehearsalMark}.
303 @c To be removed when Issue 69 in the tracker gets fixed. -vv
305 Au cas où il n'y aurait pas de ligne à suivre, la marque ne sera pas imprimée.
308 @node Texte indépendant
309 @unnumberedsubsubsec Texte indépendant
310 @translationof Separate text
312 @cindex texte indépendant
314 @cindex texte en préambule
315 @cindex top-level text
316 @cindex text, top-level
317 @cindex text, standalone
322 Un bloc @code{\markup} peut exister en lui-même, indépendamment de tout
323 bloc @code{\score}, et venir en préambule par exemple -- voir le
324 chapitre @ref{Structure de fichier} à ce propos.
326 @lilypond[verbatim,quote]
328 Tomorrow, and tomorrow, and tomorrow...
333 De cette manière, vous pouvez insérer du texte en dehors de la musique.
334 Ceci devient particulièrement utile lorsque le fichier source contient
335 plusieurs morceaux. Pour plus d'informations à ce propos, reportez-vous
336 au chapitre @ref{Plusieurs partitions dans un même ouvrage}.
338 @lilypond[quote,verbatim]
343 Tomorrow, and tomorrow, and tomorrow...
350 Les blocs de textes peuvent s'étendre sur plusieurs pages, ce qui permet
351 de générer des ouvrages complets uniquement grâce à LilyPond. Cette
352 fonctionnalité ainsi que la syntaxe appropriée est abordée plus en
353 détail au chapitre @ref{Texte avec sauts de page}.
358 @funindex \markuplines
359 @funindex markuplines
369 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
370 {stand-alone-two-column-markup.ly}
375 @ref{Mise en forme du texte},
376 @ref{Structure de fichier},
377 @ref{Plusieurs partitions dans un même ouvrage},
378 @ref{Texte avec sauts de page}.
383 Référence des propriétés internes :
384 @rinternals{TextScript}.
388 @node Mise en forme du texte
389 @subsection Mise en forme du texte
390 @translationof Formatting text
392 Nous allons voir dans les lignes qui suivent la manière de mettre en
393 forme du texte à l'aide de la syntaxe propre au mode @code{\markup}.
396 * Introduction au formatage de texte::
397 * Sélection de la fonte et de la taille::
398 * Alignement du texte::
399 * Éléments graphiques dans du texte formaté::
400 * Notation musicale dans du texte formaté::
401 * Texte avec sauts de page::
404 @node Introduction au formatage de texte
405 @unnumberedsubsubsec Introduction au formatage de texte
406 @translationof Text markup introduction
409 @cindex commentaire textuel
410 @cindex étiquette textuelle
416 La commande @code{\markup} permet d'ajouter du texte et dispose de sa
417 propre syntaxe que nous appellerons le @qq{mode @emph{markup}}.
419 @cindex markup, expressions
420 @cindex expressions markup
421 @cindex markup, syntaxe
422 @cindex syntaxe du mode markup
424 La syntaxe du mode @emph{markup} n'est pas différente de celle des
425 autres modes de LilyPond : une expression @code{\markup} est bornée par
426 des accolades @code{@{ @dots{} @}}. Un mot unique sera considéré comme
427 une expression minimale, et n'aura donc pas besoin d'être mis entre
430 Contrairement aux indications simples, du type "entre guillemets", les
431 blocs @code{\markup} peuvent contenir des expressions imbriquées ou
432 d'autres commandes @emph{markup}, dès lors qu'elles sont précédées du
433 caractère @code{\}. Ces commandes n'affecteront que la première
434 expression qui les suit.
436 @lilypond[quote,verbatim,relative=2]
438 a2^\markup { poco \italic più forte }
440 d2_\markup { \italic "string. assai" }
442 b1^\markup { \bold { molto \italic agitato } }
446 @cindex caractères spéciaux en mode markup
447 @cindex mode markup et caractères spéciaux
448 @cindex caractères réservés, impression
449 @cindex impression de caractères réservés
450 @cindex impression de caractères spéciaux
451 @cindex guillemets en mode markup
452 @cindex mode markup et guillemets
454 Un bloc @code{\markup} peut contenir du texte entre guillemets. De
455 telles chaines seront considérées comme des expressions textuelles
456 minimales ; à ce titre, toute commande de type @emph{markup} ou tout
457 caractère spécial -- tel un @code{\} ou un @code{#} -- sera imprimé
458 littéralement et sans influer sur le formatage du texte. Il est de ce
459 fait possible d'imprimer des guillemets informatiques @code{"} dès lors
460 qu'ils sont précédés d'une oblique inverse.
463 @lilypond[quote,verbatim,relative=2]
464 a1^"\italic markup..."
465 a_\markup { \italic "... imprime des lettres en \"italique\" !" }
469 Une liste de mots, pour pouvoir être traitée en tant qu'expression
470 distincte, doit être bornée par des @code{"} ou précédée d'une commande.
471 La manière de définir les expressions @emph{markup} aura une influence
472 sur la manière dont elles seront empilées, centrées ou alignées. Dans
473 l'exemple qui suit, la deuxième expression @code{\markup} est traitée
474 tout comme la première :
476 @lilypond[quote,verbatim,relative=2]
477 c1^\markup { \center-column { a bbb c } }
478 c1^\markup { \center-column { a { bbb c } } }
479 c1^\markup { \center-column { a \line { bbb c } } }
480 c1^\markup { \center-column { a "bbb c" } }
483 Vous pouvez stocker les étiquettes textuelles en tant que variables,
484 et attacher ces identificateurs à des notes, comme ici :
486 @lilypond[quote,verbatim]
487 allegro = \markup { \bold \large Allegro }
496 Pour une liste des différentes commandes spécifiques au mode
497 @code{\markup}, consultez l'annexe @ref{Text markup commands} (en
503 @ref{Text markup commands}.
508 Fichiers d'initialisation :
509 @file{scm/@/markup@/.scm}.
514 Les erreurs de syntaxe en mode @emph{markup} sont peu loquaces.
517 @node Sélection de la fonte et de la taille
518 @unnumberedsubsubsec Sélection de la fonte et de la taille
519 @translationof Selecting font and font size
521 @cindex fonte, changement
522 @cindex changement de fonte
534 Le mode @emph{markup} autorise des changements élémentaires de la fonte :
536 @lilypond[quote,verbatim,relative=2]
539 \italic { non troppo \underline Vivo }
542 d,_\markup { \italic quasi \smallCaps Tromba }
546 @cindex caratères, taille
547 @cindex texte, taille
558 La taille des caractères se modifie de différentes manières :
561 à partir de l'une des tailles standard prédéfinies,
564 en étant définie en valeur absolue,
567 en adoptant une valeur relative à celle précédemment définie.
571 Voici une illustration de ces trois différentes méthodes :
573 @lilypond[quote,verbatim,relative=1]
580 \fontsize #5 Sinfonia
587 \magnify #0.6 { e sentimento } )
600 Vous pouvez imprimer du texte en indice ou en exposant. Celui-ci sera
601 dans un taille plus petite, mais rien ne s'oppose à ce que vous lui
602 affectiez un taille normale :
604 @lilypond[quote,verbatim]
607 \line { 1 \super st movement }
608 \line { 1 \normal-size-super st movement
609 \sub { (part two) } }
614 @cindex fontes, familles
616 Le mode @emph{markup} vous permet de sélectionner d'autres familles de
617 fontes. Par défaut, LilyPond utilise une police avec empattement, du
618 type roman, et tout changement doit être explicite. Dans la dernière
619 ligne de l'exemple qui suit, vous noterez qu'il n'y a aucune différence
620 entre les premier et deuxième mots.
622 @lilypond[quote,verbatim]
625 \line { Act \number 1 }
626 \line { \sans { Scene I. } }
627 \line { \typewriter { Verona. An open place. } }
628 \line { Enter \roman Valentine and Proteus. }
634 Certaines familles de police spécifiques aux nombres ou aux nuances par
635 exemple, ne disposent pas de tous les caractères, comme nous l'avons vu
636 dans les chapitres @ref{Personnalisation des indications de nuance} et
637 @ref{Indications de reprise manuelles}.
639 @c \concat is actually documented in Align (it is not
640 @c a font-switching command). But we need it here. -vv
642 Lorsqu'un changement survient au milieu d'un mot, il se peut qu'un
643 espacement supplémentaire apparaîsse. Il suffit en pareil cas de
644 concaténer les différents éléments :
646 @lilypond[quote,verbatim]
650 \concat { 1 \super st }
654 \concat { \dynamic p , }
655 \italic { con dolce espressione }
661 Une liste des différentes commandes permettant de changer de fonte ou
662 d'utiliser des fontes personnalisées est disponible à l'annexe @ref{Font}.
664 Pour savoir comment personnaliser des fontes, reportez-vous au chapitre
673 @funindex \normalsize
700 @ref{Personnalisation des indications de nuance},
701 @ref{Indications de reprise manuelles},
707 Référence des propriétés internes :
708 @rinternals{TextScript}.
710 Fichiers d'initialisation :
711 @file{scm/@/define@/-markup@/-commands@/.scm}.
714 @node Alignement du texte
715 @unnumberedsubsubsec Alignement du texte
716 @translationof Text alignment
718 @cindex texte, alignement
719 @cindex alignement du texte
720 @cindex alignement des markups
721 @cindex markups, alignement
723 Cette partie traite de la manière de positionner du texte en mode
724 @emph{markup}. On déplace l'intégralité d'un objet @emph{markup} en
725 utilisant la syntaxe décrite au chapitre
726 @rlearning{Déplacement d'objets}.
728 @c Padding commands should be mentioned on this page, but
729 @c most of these require \box to be more clearly illustrated. -vv
731 @cindex texte, alignement horizontal
732 @cindex alignement horizontal du texte
734 @funindex \left-align
736 @funindex \center-align
737 @funindex center-align
738 @funindex \right-align
739 @funindex right-align
741 Les objets de type @emph{markup} peuvent s'aligner de différentes
742 manières. Une indication textuelle est par défaut alignée sur son
743 extrémité gauche. Dans l'exemple qui suit, il n'y a aucune différence
744 entre les deux premiers @emph{markups}.
746 @lilypond[quote,verbatim,relative=2]
749 d-\markup { \left-align poco }
751 d-\markup { \center-align { poco } }
753 d-\markup { \right-align poco }
759 L'alignement horizontal peut être ajusté à l'aide d'une valeur numérique :
761 @lilypond[quote,verbatim,relative=2]
762 a1-\markup { \halign #-1 poco }
764 a,-\markup { \halign #0 poco }
766 a,-\markup { \halign #0.5 poco }
768 a,-\markup { \halign #2 poco }
772 Certains objets possèdent leurs propres procédures d'alignement, qui
773 annuleront toute spécification d'alignement que vous pourriez affecter
774 à un argument de type @emph{markup} que vous leur auriez fourni. La
775 solution consiste alors à déplacer l'intégralité de ces objets
776 @emph{markup}, comme indiqué par exemple au chapitre
777 @ref{Indications textuelles}.
779 @cindex texte, alignement vertical
780 @cindex alignement vertical du texte
789 @c QUERY Should the function of ``\null'' be clarified? rp
791 L'alignement vertical est quant à lui un peu plus compliqué. Comme nous
792 l'avons vu ci-avant, les objets @emph{markup} peuvent être déplacés dans
793 leur intégralité. Il est néanmois possible de déplacer certains
794 éléments spécifiques au sein d'un bloc @emph{markup}. En pareil cas,
795 l'élément à déplacer doit être précédé d'un @qq{point d'ancrage} -- un
796 autre élément du @emph{markup} ou un objet invisible. L'exemple qui
797 suit illustre ces deux possibilités. Vous noterez par ailleurs que le
798 dernier @emph{markup}, dépourvu de point d'ancrage, n'est de ce fait pas
801 @lilypond[quote,verbatim,relative=1]
804 \raise #2 { Scène 1 }
809 \lower #4 \bold { Très modéré }
813 \raise #4 \italic { Une forêt. }
818 @funindex \general-align
819 @funindex general-align
822 @funindex \translate-scaled
823 @funindex translate-scaled
825 Certaines commandes permettent de régler l'alignement des objets
826 textuels en mode @emph{markup}, tant au niveau horizontal que vertical.
827 Tout objet soumis à ces commandes doit être précédé d'un point d'ancrage.
829 @lilypond[quote,verbatim,relative=1]
832 \translate #'(-1 . 2) "Scène 1"
837 \general-align #Y #3.2 \bold "Très modéré"
842 \translate-scaled #'(-1 . 2) \teeny "Une forêt."
847 @cindex multi-ligne, markup
848 @cindex markup multi-ligne
849 @cindex multi-ligne, texte
850 @cindex texte multi-ligne
851 @cindex texte en colonnes
852 @cindex colonnes de texte
856 @funindex \center-column
857 @funindex center-column
859 Un objet de type @emph{markup} peut contenir plusieurs lignes de texte.
860 Dans l'exemple suivant, chaque élément ou expression ira se placer sur
861 sa propre ligne, tantôt alignée à gauche, tantôt centrée.
863 @lilypond[quote,verbatim]
879 @cindex centrage du texte sur la page
880 @cindex texte, centrage sur la page
881 @cindex markup, centrage sur la page
886 Pareillement, une liste d'éléments ou d'expressions sera répartie sur
887 une ligne entière, voire même centrée sur toute la page s'il n'y a qu'un
888 seul élément. De telles expressions peuvent à leur tour contenir du
889 texte multi-ligne ou une autre expression @emph{markup}.
891 @lilypond[quote,verbatim]
894 \line { William S. Gilbert }
896 \huge \smallCaps "The Mikado"
898 \smallCaps "The Town of Titipu"
900 \line { Sir Arthur Sullivan }
908 @cindex plusieurs lignes de texte
909 @cindex justifié, texte
910 @cindex texte justifié
911 @cindex texte sur plusieurs lignes
912 @cindex markup, texte wordwrapped
913 @cindex markup, texte justifié
920 Les indications textuelles, lorsqu'elles sont relativement longues,
921 peuvent se répartir sur plusieurs lignes en fonction de la largeur de
922 ligne. Le texte sera alors soit aligné à gauche, soit justifié, comme
923 le montre l'exemple suivant :
925 @lilypond[quote,verbatim]
928 \line \smallCaps { La vida breve }
929 \line \bold { Acto I }
931 (La escena representa el corral de una casa de
932 gitanos en el Albaicín de Granada. Al fondo una
933 puerta por la que se ve el negro interior de
934 una Fragua, iluminado por los rojos resplandores
939 \line \bold { Acto II }
940 \override #'(line-width . 50)
942 (Calle de Granada. Fachada de la casa de Carmela
943 y su hermano Manuel con grandes ventanas abiertas
944 a través de las que se ve el patio
945 donde se celebra una alegre fiesta)
951 @cindex commandes d'alignement du texte
952 @cindex markup, commandes d'alignement du texte
953 @cindex alignement du texte, commandes
955 Une liste des différentes commandes permettant d'aligner du texte en
956 mode @emph{markup} est disponible à l'annexe @ref{Align}.
960 Manuel d'initiation :
961 @rlearning{Déplacement d'objets}.
965 @ref{Indications textuelles}.
970 Référence des propriétés internes :
971 @rinternals{TextScript}.
973 Fichiers d'initialisation :
974 @file{scm/@/define@/-markup@/-commands@/.scm}.
977 @node Éléments graphiques dans du texte formaté
978 @unnumberedsubsubsec Éléments graphiques dans du texte formaté
979 @translationof Graphic notation inside markup
981 @cindex graphisme, tracé
982 @cindex tracé d'objets graphiques
983 @cindex graphiques, tracé d'objets
984 @cindex embedding graphic objects
985 @cindex objets graphiques, tracé
987 Vous pouvez, grâce aux mode @emph{markup}, ajouter divers objets
988 graphiques à votre partition.
990 @cindex décoration du texte
991 @cindex encadrement du texte
992 @cindex texte, encadrement
993 @cindex texte, décoration
994 @cindex markup, ornementation du texte
995 @cindex markup, encadrement du texte
1001 @funindex \rounded-box
1002 @funindex rounded-box
1008 Certaines commandes de @emph{markup} permettent d'ornementer des
1009 éléments textuels avec des graphismes, à l'instar de l'exemple suivant :
1011 @lilypond[quote,verbatim]
1012 \markup \fill-line {
1020 \bracket "1866 - 1925"
1023 \rounded-box \bold Prelude
1028 @cindex espacement autour du texte
1029 @cindex texte et rembourrage
1030 @cindex markup, rembourrage du texte
1032 @funindex \pad-markup
1033 @funindex pad-markup
1036 @funindex \pad-to-box
1037 @funindex pad-to-box
1038 @funindex \pad-around
1039 @funindex pad-around
1041 Certaines directives peuvent nécessiter d'accroître l'espacement autour
1042 du texte -- voir l'annexe @ref{Align} pour une liste des différentes
1043 commandes particulières au mode @emph{markup} ainsi que leur description.
1045 @lilypond[quote,verbatim]
1046 \markup \fill-line {
1048 \box "Charles Ives (1874 - 1954)"
1050 \box \pad-markup #2 "THE UNANSWERED QUESTION"
1051 \box \pad-x #8 "A Cosmic Landscape"
1058 \box \pad-to-box #'(-5 . 20) #'(0 . 5)
1059 \bold "Largo to Presto"
1062 "String quartet keeps very even time,
1063 Flute quartet keeps very uneven time."
1067 @cindex graphisme dans la notation
1068 @cindex symboles non musicaux
1069 @cindex non musicaux, symboles
1070 @cindex notation et graphisme
1074 @funindex \draw-circle
1075 @funindex draw-circle
1076 @funindex \filled-box
1077 @funindex filled-box
1080 @funindex \draw-line
1082 @funindex \arrow-head
1083 @funindex arrow-head
1085 Vous pouvez imprimer certains graphismes ou symboles sans qu'il n'y
1086 ait de texte. Ces objets peuvent même se combiner, à l'instar de
1087 n'importe quelle expression @emph{markup}.
1089 @lilypond[quote,verbatim]
1092 \draw-circle #4 #0.4 ##f
1093 \filled-box #'(-4 . 4) #'(-0.5 . 0.5) #1
1099 \draw-line #'(0 . 4)
1100 \arrow-head #Y #DOWN ##f
1105 @cindex intégration de graphiques
1106 @cindex images, intégration
1107 @cindex graphiques, intégration
1112 @funindex \postscript
1113 @funindex postscript
1115 Des fonctionnalités graphiques avancées vous permettent même d'inclure
1116 dans une partition un fichier image converti au format PostScript
1117 encapsulé (extension @code{eps}), ou bien de tracer un graphique
1118 directement dans le fichier source à partir d'instructions PostScript
1119 pures. Nous vous conseillons, en pareil cas, de toujours spécifier les
1120 dimensions du dessin, comme dans ce qui suit :
1122 @lilypond[quote,verbatim,relative=1]
1125 \epsfile #X #10 #"./context-example.eps"
1126 \with-dimensions #'(0 . 6) #'(0 . 10)
1142 L'annexe @ref{Graphic} répertorie les différentes commandes en matière
1147 Manuel de notation :
1149 @ref{Notation éditoriale}.
1154 Référence des propriétés internes :
1155 @rinternals{TextScript}.
1157 Fichiers d'initialisation :
1158 @file{scm/@/define@/-markup@/-commands@/.scm},
1159 @file{scm/@/stencil@/.scm}.
1162 @node Notation musicale dans du texte formaté
1163 @unnumberedsubsubsec Notation musicale dans du texte formaté
1164 @translationof Music notation inside markup
1166 @cindex notation dans un markup
1167 @cindex musique dans un markup
1168 @cindex markup, inclusion de musique
1170 Divers éléments de notation peuvent orner une partition, au moyen d'un
1171 objet @emph{markup}.
1173 Notes et altérations sont données à l'aide d'instructions @emph{markup} :
1175 @lilypond[quote,verbatim,relative=2]
1179 \note-by-number #1 #1 #1.5
1182 \natural \semiflat \flat
1183 \sesquiflat \doubleflat
1187 \natural \semisharp \sharp
1188 \sesquisharp \doublesharp
1193 Le mode @emph{markup} permet d'accéder à d'autres objets de notation :
1195 @lilypond[quote,verbatim,relative=1]
1202 fis_\markup { \dynamic rf }
1213 En règle générale, tout symbole musical peut être inclus dans un
1214 @emph{markup}, comme le montre l'exemple qui suit. Ces différents
1215 symboles sont répertoriés dans l'annexe @ref{La fonte Feta}.
1217 @lilypond[quote,verbatim,relative=2]
1219 c'^\markup { \musicglyph #"eight" }
1221 c,8._\markup { \musicglyph #"clefs.G_change" }
1223 c2^\markup { \musicglyph #"timesig.neomensural94" }
1226 Le sous-chapitre @ref{Tout savoir sur les fontes} contient d'autres
1227 informations sur l'impression de glyphes non alphabétiques, tels que des
1228 crochets ou accolades.
1230 Le mode @emph{markup} supporte aussi les diagrammes spécifiques à
1231 certains instruments :
1233 @lilypond[quote,verbatim,relative=2]
1235 \fret-diagram-terse #"x;x;o;2;3;2;"
1238 \harp-pedal #"^-v|--ov^"
1243 \musicglyph #"accordion.accDiscant"
1245 \raise #0.5 \musicglyph #"accordion.accDot"
1246 \raise #1.5 \musicglyph #"accordion.accDot"
1250 @c The accordion diagram is actually taken from a snippet.
1253 La documentation sur ces diagrammes se trouvent à l'annexe
1254 @ref{Instrument Specific Markup}.
1256 @cindex partition incluse dans un markup
1257 @cindex markup, inclusion de partition
1259 Rien ne s'oppose à ce qu'une étiquette ne comporte une partition. Il
1260 suffit que l'expression en question contienne un bloc @code{\score} et
1261 un bloc @code{\layout}.
1263 @lilypond[quote,verbatim,ragged-right]
1267 \relative { c4 d e f }
1275 Les différentes commandes @emph{markup} relatives à la notation musicale
1276 sont répertoriées à l'annexe @ref{Music}.
1280 Manuel de notation :
1282 @ref{La fonte Feta},
1283 @ref{Tout savoir sur les fontes}.
1288 Référence des propriétés internes :
1289 @rinternals{TextScript}.
1291 Fichiers d'initialisation :
1292 @file{scm/@/define@/-markup@/-commands@/.scm},
1293 @file{scm/@/fret@/-diagrams@/.scm},
1294 @file{scm/@/harp@/-pedals@/.scm}.
1297 @node Texte avec sauts de page
1298 @unnumberedsubsubsec Texte avec sauts de page
1299 @translationof Page wrapping text
1301 @cindex multi-page, markup
1302 @cindex markup multi-page
1303 @cindex markup, texte multi-page
1304 @cindex plusieurs pages de texte
1306 @funindex \markuplines
1307 @funindex markuplines
1308 @funindex \justified-lines
1309 @funindex justified-lines
1310 @funindex \wordwrap-lines
1311 @funindex wordwrap-lines
1313 Alors que @code{\markup} s'utilise pour traiter un bloc de texte
1314 insécable, @code{\markuplines} permet, employé en tête de partition,
1315 d'obtenir un bloc de lignes réparties différemment et, le cas échéant,
1316 sur plusieurs pages.
1319 @lilypond[quote,verbatim]
1322 Un long texte constitué de lignes justifiées.
1326 Un autre grand paragraphe.
1333 Cette syntaxe prend en charge une liste de @emph{markups} ; il peut s'agir
1336 d'une suite de commandes générant à leur tour des lignes de texte,
1338 d'une liste de lignes de texte,
1340 d'une liste d'étiquettes.
1343 Les différentes commandes permettant de générer des listes de lignes
1344 se trouve dans l'annexe @ref{Text markup list commands}.
1348 Manuel de notation :
1349 @ref{Text markup list commands},
1354 @c en attendant redécoupage et création de "extending" -jcm
1356 @c @rextend{New markup list command definition}.
1358 Référence des propriétés internes :
1359 @rinternals{TextScript}.
1361 Fichiers d'initialisation :
1362 @file{scm/@/define@/-markup@/-commands@/.scm}.
1365 @funindex \markuplines
1366 @funindex markuplines
1369 @code{\markuplines}.
1375 @translationof Fonts
1377 Ce chapitre est consacré aux fontes et polices de caractère, à leur
1378 gestion. Vous y apprendrez aussi comment changer de fonte en cours de
1382 * Tout savoir sur les fontes::
1383 * Attribution d'une fonte en particulier::
1384 * Choix des fontes par défaut::
1387 @node Tout savoir sur les fontes
1388 @unnumberedsubsubsec Tout savoir sur les fontes
1389 @translationof Fonts explained
1392 @cindex fontes, généralités
1393 @cindex accolades, taille
1394 @cindex fontes et markup
1395 @cindex markup et fontes
1397 @funindex font-interface
1399 La gestion des fontes est assurée par plusieurs bibliothèques :
1400 FontConfig se charge de répertorier les différentes fontes installées
1401 sur votre système ; quant à Pango, elle se charge plus particulièrement
1404 Les fontes musicales peuvent se décrire comme un jeu de glyphes
1405 spécifiques regroupés dans plusieurs familles. L'exemple qui suit
1406 montre la syntaxe à utiliser pour accéder, en mode @emph{markup}, aux
1407 différentes fontes @code{feta} non textuelles de LilyPond.
1409 @lilypond[quote,verbatim,relative=2]
1412 \override #'(font-encoding . fetaBraces)
1414 \override #'(font-encoding . fetaNumber)
1416 \override #'(font-encoding . fetaDynamic)
1418 \override #'(font-encoding . fetaMusic)
1419 \lookup #"noteheads.s0petrucci"
1425 Tous ces glyphes, à l'exception des accolades qui sont regroupées dans
1426 @code{fetaBraces}, sont accessibles avec la syntaxe indiquée dans
1427 @ref{Notation musicale dans du texte formaté}.
1429 Une remarque s'impose au sujet des glyphes contenus dans
1430 @code{fetaBraces} : chacun d'eux est formé du mot @emph{brace} auquel
1431 est accolé un numéro d'ordre. Lorsque vous désirez imprimer une
1432 accolade, vous devez la @qq{chercher} par son numéro d'ordre -- d'où la
1433 fonction @code{\lookup} de l'exemple ci-dessus --, tout en sachant qu'il
1434 est compris entre @code{0} (la plus petite) et @code{575} (la plus
1435 grande). Vous serez souvent amené à procéder par tatonnement pour
1436 arriver au résultat optimal. Par ailleurs, @code{fetaBraces} ne
1437 comporte que des accolades ouvrantes. Pour obtenir une accolade
1438 fermante, il suffit d'appliquer une rotation au glyphe sélectionné,
1439 comme indiqué au chapitre @ref{Rotation des objets}.
1441 Vous disposez de trois familles de fontes textuelles : @emph{roman}
1442 pour la police sérif ou avec empattement -- fixée par défaut à New
1443 Century Schoolbook --, une police sans empattement (@emph{sans} sérif)
1444 et une à chasse fixe (ou monospace) -- les deux dernières étant
1445 déterminées par l'installation de Pango.
1447 Chaque famille dispose en principe de différents styles et niveau de
1448 gras. L'exemple qui suit illustre la manière de changer la famille, le
1449 style, la graisse ou la taille. Notez bien que l'argument fourni à
1450 @code{font-size} correspond à la correction à apporter à la taille par
1453 @lilypond[quote,verbatim,relative=2]
1454 \override Score.RehearsalMark #'font-family = #'typewriter
1455 \mark \markup "Ouverture"
1456 \override Voice.TextScript #'font-shape = #'italic
1457 \override Voice.TextScript #'font-series = #'bold
1458 d2.^\markup "Allegro"
1459 \override Voice.TextScript #'font-size = #-3
1464 Cette syntaxe s'applique aussi en mode @emph{markup}, bien que celui-ci
1465 dispose d'une syntaxe allégée comme nous l'avons vu dans
1466 @ref{Sélection de la fonte et de la taille}:
1468 @lilypond[quote,verbatim]
1472 \override #'(font-shape . italic)
1473 \override #'(font-size . 4)
1477 \override #'(font-family . typewriter)
1479 \override #'(font-series . bold)
1483 \override #'(font-family . sans)
1490 En plus de pouvoir jongler entre les différentes fontes prédéfinies,
1491 LilyPond vous permet d'en utiliser d'autres, ce qui fait l'objet des
1492 deux prochaines parties : @ref{Attribution d'une fonte en particulier}
1493 et @ref{Choix des fontes par défaut}.
1497 Manuel de notation :
1498 @ref{La fonte Feta},
1499 @ref{Notation musicale dans du texte formaté},
1500 @ref{Sélection de la fonte et de la taille},
1504 @node Attribution d'une fonte en particulier
1505 @unnumberedsubsubsec Attribution d'une fonte en particulier
1506 @translationof Single entry fonts
1508 Vous pouvez utiliser n'importe quelle police installée sur votre
1509 système, du moment où elle est accessible par Fontconfig, en respectant
1510 la syntaxe suivante :
1512 @lilypond[quote,verbatim,relative=2]
1513 \override Staff.TimeSignature #'font-name = #"Bitstream Charter"
1514 \override Staff.TimeSignature #'font-size = #2
1518 \override #'(font-name . "Vera Bold")
1523 @cindex fontes disponibles
1524 @cindex disponibilité des fontes
1526 @funindex show-available-fonts
1528 Pour obtenir la liste de toutes les polices disponibles sur votre
1532 lilypond -dshow-available-fonts toto
1535 (quel qu'il soit, le dernier argument est obligatoire).
1539 Manuel de notation :
1540 @ref{Tout savoir sur les fontes},
1541 @ref{Choix des fontes par défaut}.
1546 @c A source file gets never installed...
1547 @c Fichiers d'initialisation :
1548 @c @file{lily/@/font@/-config@/-scheme@/.cc}.
1551 @node Choix des fontes par défaut
1552 @unnumberedsubsubsec Choix des fontes par défaut
1553 @translationof Entire document fonts
1555 Vous pouvez tout à fait préférer un autre jeu de polices par défaut que
1556 celui de LilyPond. Il vous faudra alors spécifier les différentes
1557 familles, en respectant l'ordre @emph{roman}, @emph{sans empattement} et
1558 @emph{monospace}, comme dans l'exemple suivant. Pour plus
1559 d'explications sur les fontes, relisez @ref{Tout savoir sur les fontes}.
1561 @cindex polices, choix par défaut
1562 @cindex fontes, choix par défaut
1564 @funindex make-pango-font-tree
1566 @lilypond[verbatim,quote]
1570 (make-pango-font-tree "Times New Roman"
1573 (/ myStaffSize 20)))
1580 \typewriter typewriter. }
1584 @c we don't do Helvetica / Courier, since GS incorrectly loads
1589 Manuel de notation :
1590 @ref{Tout savoir sur les fontes},
1591 @ref{Attribution d'une fonte en particulier},
1592 @ref{Sélection de la fonte et de la taille},