1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
4 Translation of GIT committish: 3c0f38115857598db730782b1d2ff0a19fd833af
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. For details, see the Contributors'
8 Guide, node Updating translation committishes..
13 @c Translators: Jean-Charles Malahieude
14 @c Translation checkers: Valentin Villenave, John Mandereau
20 @lilypondfile[quote]{text-headword.ly}
22 Nous allons voir ici comment insérer du texte dans une partition, ainsi
23 que différentes manières de le mettre en forme.
26 Certains éléments de texte ne sont pas abordés ici mais dans des
27 chapitres qui leur sont dédiés. C'est le cas de la
28 @ref{Musique vocale} et des @ref{Titres et entêtes}.
32 * Mise en forme du texte::
38 @subsection Ajout de texte
39 @translationof Writing text
41 Cette partie constitue une introduction aux différentes manières
42 d'ajouter du texte à une partition.
44 @cindex Texte, autres langues
45 @warning{Pour écrire des accents et autres caractères spéciaux, il
46 suffit de les insérer directement dans votre fichier LilyPond. Ce
47 fichier devra être sauvegardé avec l'encodage UTF-8. Pour plus
48 d'informations, voir @ref{Codage du texte}.}
51 * Commentaires textuels::
52 * Indication textuelle avec extension::
53 * Indications textuelles::
58 @node Commentaires textuels
59 @unnumberedsubsubsec Commentaires textuels
60 @translationof Text scripts
62 @cindex étiquette de texte
64 @cindex ajout de texte
66 Vous pouvez ajouter à une partition des indications sous forme textuelle,
67 comme dans l'exemple suivant. Ces indications se placeront manuellement
68 au-dessus ou au-dessous de la portée selon la syntaxe utilisée -- cf.
69 @ref{Direction et positionnement}.
71 @lilypond[quote,verbatim]
72 \relative { a'8^"pizz." g f e a4-"scherz." f }
75 Cette syntaxe est en fait un raccourci. Des constructions plus
76 élaborées d'annotation peuvent être obtenues en ayant recours à un bloc
77 @code{\markup} et selon les préceptes énoncés dans
78 @ref{Mise en forme du texte}.
80 @lilypond[quote,verbatim]
82 a'8^\markup { \italic pizz. } g f e
83 a4_\markup { \tiny scherz. \bold molto } f }
86 Par défaut, ces indications n'affectent en rien l'espacement des
87 notes. Leur longueur peut néanmoins être prise en considération :
88 dans l'exemple qui suit, le premier commentaire n'influe pas sur
89 l'espacement, à l'inverse du second.
91 @lilypond[quote,verbatim]
99 En plus d'indications textuelles, les notes peuvent se voir attacher des
100 articulations, comme indiqué au chapitre
101 @ref{Articulations et ornements}.
103 Pour de plus amples détails sur la manière de combiner indications
104 textuelles et articulations, reportez-vous au chapitre
105 @rlearning{Positionnement des objets}.
107 @funindex \textLengthOn
108 @funindex textLengthOn
109 @funindex \textLengthOff
110 @funindex textLengthOff
113 @code{\textLengthOn},
114 @code{\textLengthOff}.
118 Manuel d'initiation :
119 @rlearning{Positionnement des objets}.
122 @ref{Articulations et ornements},
123 @ref{Direction et positionnement},
124 @ref{Mise en forme du texte}.
127 @rlsrnamed{Text,Texte}.
129 Référence des propriétés internes :
130 @rinternals{TextScript}.
132 @cindex texte hors marges
133 @cindex marges, texte qui dépasse
134 @cindex texte, maintien dans les marges
135 @cindex texte, maintien dans les marges
138 S'assurer que tous les éléments textuels et les paroles respectent
139 les marges du document requiert des calculs relativement lourds ;
140 vous pouvez toutefois vous en affranchir en ajoutant
143 \override Score.PaperColumn.keep-inside-line = ##f
147 @node Indication textuelle avec extension
148 @unnumberedsubsubsec Indication textuelle avec extension
149 @translationof Text spanners
151 @cindex texte et extenseur
152 @cindex prolongation de texte
155 Certaines indications d'interprétation comme @emph{rallentando},
156 @emph{accelerando} ou @emph{trilles}, s'inscrivent textuellement et se
157 prolongent sur plusieurs notes à l'aide d'une ligne pleine, pointillée
158 ou ondulée. Ces objets, que l'on appelle @qq{extenseurs}, se dessinent
159 entre deux notes à l'aide de la syntaxe suivante :
161 @lilypond[verbatim,quote]
163 \override TextSpanner.bound-details.left.text = "rit."
169 @cindex texte, mise en forme des prolongations
170 @cindex texte, mise en forme des extenseurs
171 @cindex extenseur, mise en forme
174 Le texte à imprimer est spécifié en tant que propriété de l'objet
175 @code{TextSpanner}. Il apparaîtra par défaut en italique ;
176 cependant, rien ne s'oppose à un autre graphisme dès lors que vous
177 faites appel à un bloc @code{\markup} --
178 voir @ref{Mise en forme du texte}.
180 @lilypond[quote,verbatim]
182 \override TextSpanner.bound-details.left.text =
183 \markup { \upright "rit." }
189 Le style de ligne se définit lui aussi comme une propriété de l'objet.
190 Les détails concernant la syntaxe à utiliser sont expliqués au chapitre
191 @ref{Styles de ligne}.
193 @funindex \textSpannerUp
194 @funindex textSpannerUp
195 @funindex \textSpannerDown
196 @funindex textSpannerDown
197 @funindex \textSpannerNeutral
198 @funindex textSpannerNeutral
201 @code{\textSpannerUp},
202 @code{\textSpannerDown},
203 @code{\textSpannerNeutral}.
207 @lilypondfile[verbatim,quote,texidoc,doctitle]
208 {dynamics-text-spanner-postfix.ly}
210 @lilypondfile[verbatim,quote,texidoc,doctitle]
211 {dynamics-custom-text-spanner-postfix.ly}
215 @ref{Mise en forme du texte},
217 @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}.
227 LilyPond ne peut traiter qu'un seul extenseur à la fois par voix.
230 @node Indications textuelles
231 @unnumberedsubsubsec Indications textuelles
232 @translationof Text marks
234 @cindex indication textuelle
235 @cindex coda sur une barre de mesure
236 @cindex segno sur une barre de mesure
237 @cindex point d'orgue sur une barre de mesure
238 @cindex barres de mesure, symboles au dessus de
245 La commande @code{\mark} est tout d'abord conçue pour les
246 @ref{Indications de repère}.
248 @c \mark needs to be placed on a separate line (it's not
249 @c attached to an object like \markup is). -vv
251 @lilypond[verbatim,quote]
262 Cette syntaxe rend possible l'adjonction de n'importe quel texte à une
263 barre de mesure. Ce texte peut être mis en forme de différentes
264 manières dès lors qu'est utilisé un bloc @code{\markup}, comme indiqué
265 au chapitre @ref{Mise en forme du texte}.
267 @lilypond[quote,verbatim]
270 \mark \markup { \italic { colla parte } }
277 Elle peut aussi servir à insérer des signes de @emph{coda} ou de
278 @emph{segno}, ou bien un point d'orgue, au-dessus d'une
279 barre de mesure. Couplez-la alors à la commande @code{\markup} pour
280 avoir accès au symbole approprié, selon les indications contenues au
281 chapitre @ref{Notation musicale dans du texte formaté}.
283 @lilypond[quote,verbatim]
286 \mark \markup { \musicglyph #"scripts.ufermata" }
292 Le résultat de @code{\mark} n'apparaîtra que sur la portée supérieure
293 d'un système. Si vous introduisez la commande @code{\mark} au moment
294 d'une barre de mesure, la marque se placera au-dessus de la barre. Si
295 vous y faites appel au milieu d'une mesure, cette marque sera
296 positionnée entre les notes. Si elle intervient en début de ligne,
297 elle sera placée juste avant la première note de cette portée. Enfin,
298 une marque qui tomberait sur un saut de ligne sera imprimée au début
299 de la ligne suivante.
301 @lilypond[quote,verbatim,ragged-right]
310 @funindex \markLengthOn
311 @funindex markLengthOn
312 @funindex \markLengthOff
313 @funindex markLengthOff
316 @code{\markLengthOn},
317 @code{\markLengthOff}.
321 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
322 {printing-marks-at-the-end-of-a-line.ly}
324 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
325 {printing-marks-on-every-staff.ly}
329 @ref{Indications de repère},
331 @ref{Mise en forme du texte},
332 @ref{Notation musicale dans du texte formaté}.
335 @rlsrnamed{Text,Texte}.
337 Référence des propriétés internes :
338 @rinternals{MarkEvent},
339 @rinternals{Mark_engraver},
340 @rinternals{RehearsalMark}.
343 @node Texte indépendant
344 @unnumberedsubsubsec Texte indépendant
345 @translationof Separate text
347 @cindex texte indépendant
349 @cindex texte en préambule
350 @cindex top-level, texte
351 @cindex texte, top-level
352 @cindex indépendant, texte
357 Un bloc @code{\markup} peut exister en lui-même, indépendamment de tout
358 bloc @code{\score}, et venir en préambule par exemple -- voir le
359 chapitre @ref{Structure de fichier} à ce propos.
361 @lilypond[verbatim,quote]
363 Tomorrow, and tomorrow, and tomorrow...
368 De cette manière, vous pouvez insérer du texte en dehors de la musique.
369 Ceci devient particulièrement utile lorsque le fichier source contient
370 plusieurs morceaux. Pour plus d'informations à ce propos, reportez-vous
371 au chapitre @ref{Plusieurs partitions dans un même ouvrage}.
373 @lilypond[quote,verbatim]
378 Tomorrow, and tomorrow, and tomorrow...
385 Les blocs de textes peuvent s'étendre sur plusieurs pages, ce qui permet
386 de générer des ouvrages complets uniquement grâce à LilyPond. Cette
387 fonctionnalité, ainsi que la syntaxe appropriée, est abordée plus en
388 détail au chapitre @ref{Texte avec sauts de page}.
392 @funindex \markuplist
401 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
402 {stand-alone-two-column-markup.ly}
406 @ref{Mise en forme du texte},
407 @ref{Plusieurs partitions dans un même ouvrage},
408 @ref{Structure de fichier},
409 @ref{Texte avec sauts de page}.
412 @rlsrnamed{Text,Texte}.
414 Référence des propriétés internes :
415 @rinternals{TextScript}.
418 @node Mise en forme du texte
419 @subsection Mise en forme du texte
420 @translationof Formatting text
422 Nous allons voir dans les lignes qui suivent la manière de mettre en
423 forme du texte à l'aide de la syntaxe propre au mode @code{\markup}.
426 * Introduction au formatage de texte::
427 * Sélection de la fonte et de la taille::
428 * Alignement du texte::
429 * Éléments graphiques dans du texte formaté::
430 * Notation musicale dans du texte formaté::
431 * Texte avec sauts de page::
435 @node Introduction au formatage de texte
436 @unnumberedsubsubsec Introduction au formatage de texte
437 @translationof Text markup introduction
440 @cindex commentaire textuel
441 @cindex étiquette textuelle
448 La commande @code{\markup} permet d'ajouter du texte et dispose de sa
449 propre syntaxe que nous appellerons le @qq{mode @emph{markup}}.
451 @cindex markup, expressions
452 @cindex expressions markup
453 @cindex markup, syntaxe
454 @cindex syntaxe du mode markup
456 La syntaxe du mode @emph{markup} n'est pas différente de celle des
457 autres modes de LilyPond : une expression @code{\markup} est bornée
458 par des accolades @code{@{ @dots{} @}}. Un mot unique sera
459 considéré comme une expression minimale, et n'aura donc pas besoin
460 d'être mis entre accolades.
462 Contrairement aux indications simples, du type "entre guillemets", les
463 blocs @code{\markup} peuvent contenir des expressions imbriquées ou
464 d'autres commandes @emph{markup}, dès lors qu'elles sont précédées du
465 caractère @code{\}. Ces commandes n'affecteront que la première
466 expression qui les suit.
468 @lilypond[quote,verbatim]
471 a2^\markup { poco \italic più forte }
473 d2_\markup { \italic "string. assai" }
475 b1^\markup { \bold { molto \italic agitato } }
480 @cindex caractères spéciaux en mode markup
481 @cindex mode markup et caractères spéciaux
482 @cindex caractères réservés, impression
483 @cindex impression de caractères réservés
484 @cindex impression de caractères spéciaux
485 @cindex guillemets en mode markup
486 @cindex mode markup et guillemets
488 Un bloc @code{\markup} peut contenir du texte entre guillemets. De
489 telles chaînes seront considérées comme des expressions textuelles
490 minimales ; à ce titre, toute commande de type @emph{markup} ou
491 tout caractère spécial -- tel un @code{\} ou un @code{#} --
492 sera imprimé littéralement et sans influer sur le formatage du texte.
493 Il est de ce fait possible d'imprimer des guillemets
494 informatiques @code{"} dès lors qu'ils sont précédés d'une oblique
496 @c repeat double quote for pairing "
499 @lilypond[quote,verbatim]
501 a'1^"\italic markup..."
502 a_\markup { \italic "... imprime des lettres en \"italique\" !" }
507 Une liste de mots, pour pouvoir être traitée en tant qu'expression
508 distincte, doit être bornée par des @code{"} ou précédée d'une commande.
509 La manière de définir les expressions @emph{markup} aura une influence
510 sur la manière dont elles seront empilées, centrées ou alignées. Dans
511 l'exemple qui suit, la deuxième expression @code{\markup} est traitée
512 tout comme la première :
513 @c repeat double quote for pairing "
515 @lilypond[quote,verbatim]
517 c1^\markup { \center-column { a bbb c } }
518 c1^\markup { \center-column { a { bbb c } } }
519 c1^\markup { \center-column { a \line { bbb c } } }
520 c1^\markup { \center-column { a "bbb c" } }
524 Vous pouvez stocker les étiquettes textuelles en tant que variables,
525 et attacher ces identificateurs à des notes, comme ici :
527 @lilypond[quote,verbatim]
528 allegro = \markup { \bold \large Allegro }
537 Pour une liste des différentes commandes spécifiques au mode
538 @code{\markup}, consultez l'annexe @ref{Commandes pour markup} (en
543 @ref{Commandes pour markup}.
545 Fichiers d'initialisation :
546 @file{scm/markup.scm}.
549 @rlsrnamed{Text,Texte}.
552 Les erreurs de syntaxe en mode @emph{markup} sont peu explicites.
555 @node Sélection de la fonte et de la taille
556 @unnumberedsubsubsec Sélection de la fonte et de la taille
557 @translationof Selecting font and font size
559 @cindex fonte, changement
560 @cindex changement de fonte
572 Le mode @emph{markup} autorise des changements élémentaires de la
575 @lilypond[quote,verbatim]
579 \italic { non troppo \underline Vivo }
582 d,_\markup { \italic quasi \smallCaps Tromba }
587 @cindex caractères, taille
588 @cindex texte, taille
590 @funindex \abs-fontsize
600 La taille des caractères se modifie, relativement à la taille globale
601 des portées, de différentes manières.
603 Vous pouvez adopter l'une des tailles prédéfinies, comme ici :
605 @lilypond[quote,verbatim]
607 b1_\markup { \huge Sinfonia }
608 b1^\markup { \teeny da }
609 b1-\markup { \normalsize camera }
613 Vous pouvez la modifier relativement à sa valeur précédente :
615 @lilypond[quote,verbatim]
617 b1_\markup { \larger Sinfonia }
618 b1^\markup { \smaller da }
619 b1-\markup { \magnify #0.6 camera }
623 Vous pouvez l'augmenter ou la diminuer par rapport à la taille globale
626 @lilypond[quote,verbatim]
628 b1_\markup { \fontsize #-2 Sinfonia }
629 b1^\markup { \fontsize #1 da }
630 b1-\markup { \fontsize #3 camera }
634 Vous pouvez lui attribuer une valeur arbitraire quelle que soit la
635 taille de portée globale :
637 @lilypond[quote,verbatim]
639 b1_\markup { \abs-fontsize #20 Sinfonia }
640 b1^\markup { \abs-fontsize #8 da }
641 b1-\markup { \abs-fontsize #14 camera }
645 Lorsque le texte comporte des espaces, mieux vaut le borner par des
646 guillemets informatiques ; s'en suivra une meilleure adéquation entre la
647 taille des espaces et celle des autres caractères :
649 @lilypond[quote,verbatim]
650 \markup \fontsize #6 \bold { Sinfonia da camera }
651 \markup \fontsize #6 \bold { "Sinfonia da camera" }
661 @funindex \normal-size-super
662 @funindex normal-size-super
664 Vous pouvez imprimer du texte en indice ou en exposant. Celui-ci sera
665 dans une taille plus petite, mais rien ne s'oppose à ce que vous lui
666 affectiez un taille normale :
668 @lilypond[quote,verbatim]
671 \line { 1 \super st movement }
672 \line { 1 \normal-size-super st movement
673 \sub { (part two) } }
678 @cindex fontes, familles
680 Le mode @emph{markup} vous permet de sélectionner d'autres familles de
681 fontes. Par défaut, LilyPond utilise une police avec empattement, du
682 type roman, et tout changement doit être explicite. Dans la dernière
683 ligne de l'exemple qui suit, vous noterez qu'il n'y a aucune différence
684 entre les premier et deuxième mots.
686 @lilypond[quote,verbatim]
689 \line { Act \number 1 }
690 \line { \sans { Scene I. } }
691 \line { \typewriter { Verona. An open place. } }
692 \line { Enter \roman Valentine and Proteus. }
698 Certaines familles de police spécifiques aux nombres ou aux nuances par
699 exemple, ne disposent pas de tous les caractères, comme nous l'avons vu
700 dans les chapitres @ref{Personnalisation des indications de nuance} et
701 @ref{Indications de reprise manuelles}.
703 @c \concat is actually documented in Align (it is not
704 @c a font-switching command). But we need it here. -vv
706 Lorsqu'un changement survient au milieu d'un mot, il se peut qu'un
707 espacement supplémentaire apparaisse. Il suffit en pareil cas de
708 concaténer les différents éléments :
710 @lilypond[quote,verbatim]
714 \concat { 1 \super st }
718 \concat { \dynamic p , }
719 \italic { con dolce espressione }
725 Une liste des différentes commandes permettant de changer de fonte ou
726 d'utiliser des fontes personnalisées est disponible à l'annexe
729 Pour savoir comment personnaliser des fontes, reportez-vous au chapitre
738 @funindex \normalsize
762 @rusernamed{Font,Fonte},
764 @ref{Indications de reprise manuelles},
765 @ref{Personnalisation des indications de nuance}.
767 Fichiers d'initialisation :
768 @file{scm/define-markup-commands.scm}.
771 @rlsrnamed{Text,Texte}.
773 Référence des propriétés internes :
774 @rinternals{TextScript}.
777 Le recours aux commandes @code{\teeny}, @code{\tiny},@code{\small},
778 @code{\normalsize}, @code{\large} et @code{\huge} produiront des
779 espacements nettement moins réguliers que si vous utilisez
783 @node Alignement du texte
784 @unnumberedsubsubsec Alignement du texte
785 @translationof Text alignment
787 @cindex texte, alignement
788 @cindex alignement du texte
789 @cindex alignement des markups
790 @cindex markups, alignement
792 Cette partie traite de la manière de positionner du texte en mode
793 @emph{markup}. On déplace l'intégralité d'un objet @emph{markup} en
794 utilisant la syntaxe décrite au chapitre
795 @rlearning{Déplacement d'objets}.
797 @c Padding commands should be mentioned on this page, but
798 @c most of these require \box to be more clearly illustrated. -vv
800 @cindex texte, alignement horizontal
801 @cindex alignement horizontal du texte
803 @funindex \left-align
805 @funindex \center-align
806 @funindex center-align
807 @funindex \right-align
808 @funindex right-align
810 Les objets de type @emph{markup} peuvent s'aligner de différentes
811 manières. Une indication textuelle est par défaut alignée sur son
812 extrémité gauche. Dans l'exemple qui suit, il n'y a aucune différence
813 entre les deux premiers @emph{markups}.
815 @lilypond[quote,verbatim]
817 d''1-\markup { poco }
819 d-\markup { \left-align poco }
821 d-\markup { \center-align { poco } }
823 d-\markup { \right-align poco }
830 L'alignement horizontal peut être ajusté à l'aide d'une valeur
833 @lilypond[quote,verbatim]
835 a'1-\markup { \halign #-1 poco }
837 a,-\markup { \halign #0 poco }
839 a,-\markup { \halign #0.5 poco }
841 a,-\markup { \halign #2 poco }
846 Certains objets possèdent leurs propres procédures d'alignement, qui
847 annuleront toute spécification d'alignement que vous pourriez leur
848 affecter. La solution consiste alors à déplacer l'intégralité de ces
849 objets @emph{markup}, comme indiqué par exemple au chapitre
850 @ref{Indications textuelles}.
852 @cindex texte, alignement vertical
853 @cindex alignement vertical du texte
862 @c QUERY Should the function of ``\null'' be clarified? rp
864 L'alignement vertical est quant à lui un peu plus compliqué. Comme nous
865 l'avons vu ci-avant, les objets @emph{markup} peuvent être déplacés dans
866 leur intégralité. Il est néanmoins possible de déplacer certains
867 éléments spécifiques au sein d'un bloc @emph{markup}. En pareil cas,
868 l'élément à déplacer doit être précédé d'un @qq{point d'ancrage} -- un
869 autre élément du @emph{markup} ou un objet invisible. L'exemple qui
870 suit illustre ces deux possibilités. Vous noterez par ailleurs que le
871 dernier @emph{markup}, dépourvu de point d'ancrage, n'est de ce fait pas
874 @lilypond[quote,verbatim]
878 \raise #2 { Scène 1 }
883 \lower #4 \bold { Très modéré }
887 \raise #4 \italic { Une forêt. }
893 @funindex \general-align
894 @funindex general-align
897 @funindex \translate-scaled
898 @funindex translate-scaled
900 Certaines commandes permettent de régler l'alignement des objets
901 textuels en mode @emph{markup}, tant au niveau horizontal que vertical.
902 Tout objet soumis à ces commandes doit être précédé d'un point
905 @lilypond[quote,verbatim]
909 \translate #'(-1 . 2) "Scène 1"
914 \general-align #Y #3.2 \bold "Très modéré"
919 \translate-scaled #'(-1 . 2) \teeny "Une forêt."
925 @cindex multiligne, markup
926 @cindex markup multiligne
927 @cindex multiligne, texte
928 @cindex texte multiligne
929 @cindex texte en colonnes
930 @cindex colonnes de texte
934 @funindex \center-column
935 @funindex center-column
937 Un objet de type @emph{markup} peut contenir plusieurs lignes de texte.
938 Dans l'exemple suivant, chaque élément ou expression ira se placer sur
939 sa propre ligne, tantôt alignée à gauche, tantôt centrée.
941 @lilypond[quote,verbatim]
957 @cindex centrage du texte sur la page
958 @cindex texte, centrage sur la page
959 @cindex markup, centrage sur la page
964 Pareillement, une liste d'éléments ou d'expressions sera répartie sur
965 une ligne entière, voire même centrée sur toute la page s'il n'y a qu'un
966 seul élément. De telles expressions peuvent à leur tour contenir du
967 texte multiligne ou une autre expression @emph{markup}.
969 @lilypond[quote,verbatim]
972 \line { William S. Gilbert }
974 \huge \smallCaps "The Mikado"
976 \smallCaps "The Town of Titipu"
978 \line { Sir Arthur Sullivan }
986 @cindex plusieurs lignes de texte
987 @cindex justifié, texte
988 @cindex texte justifié
989 @cindex texte sur plusieurs lignes
990 @cindex markup, texte au kilomètre
991 @cindex markup, texte justifié
998 Les indications textuelles, lorsqu'elles sont relativement longues,
999 peuvent se répartir sur plusieurs lignes en fonction de la largeur de
1000 ligne. Le texte sera alors soit aligné à gauche, soit justifié, comme
1001 le montre l'exemple suivant :
1003 @lilypond[quote,verbatim]
1006 \line \smallCaps { La vida breve }
1007 \line \bold { Acto I }
1009 (La escena representa el corral de una casa de
1010 gitanos en el Albaicín de Granada. Al fondo una
1011 puerta por la que se ve el negro interior de
1012 una Fragua, iluminado por los rojos resplandores
1017 \line \bold { Acto II }
1018 \override #'(line-width . 50)
1020 (Calle de Granada. Fachada de la casa de Carmela
1021 y su hermano Manuel con grandes ventanas abiertas
1022 a través de las que se ve el patio
1023 donde se celebra una alegre fiesta)
1029 @cindex commandes d'alignement du texte
1030 @cindex markup, commandes d'alignement du texte
1031 @cindex alignement du texte, commandes
1033 Une liste des différentes commandes permettant d'aligner du texte en
1034 mode @emph{markup} est disponible à l'annexe @ref{Align}.
1037 Manuel d'initiation :
1038 @rlearning{Déplacement d'objets}.
1040 Manuel de notation :
1041 @rusernamed{Align,Alignement},
1042 @ref{Indications textuelles}.
1044 Fichiers d'initialisation :
1045 @file{scm/define-markup-commands.scm}.
1048 @rlsrnamed{Text,Texte}.
1050 Référence des propriétés internes :
1051 @rinternals{TextScript}.
1054 @node Éléments graphiques dans du texte formaté
1055 @unnumberedsubsubsec Éléments graphiques dans du texte formaté
1056 @translationof Graphic notation inside markup
1058 @cindex graphisme, tracé
1059 @cindex tracé d'objets graphiques
1060 @cindex graphiques, tracé d'objets
1061 @cindex intégration d'objet graphique
1062 @cindex objets graphiques, tracé
1064 Vous pouvez, grâce aux mode @emph{markup}, ajouter divers objets
1065 graphiques à votre partition.
1067 @cindex décoration du texte
1068 @cindex encadrement du texte
1069 @cindex texte, encadrement
1070 @cindex texte, décoration
1071 @cindex markup, ornementation du texte
1072 @cindex markup, encadrement du texte
1078 @funindex \rounded-box
1079 @funindex rounded-box
1085 Certaines commandes de @emph{markup} permettent d'ornementer des
1086 éléments textuels avec des graphismes, à l'instar de l'exemple
1089 @lilypond[quote,verbatim]
1090 \markup \fill-line {
1098 \bracket "1866 - 1925"
1101 \rounded-box \bold Prelude
1106 @cindex espacement autour du texte
1107 @cindex texte et rembourrage
1108 @cindex markup, rembourrage du texte
1110 @funindex \pad-markup
1111 @funindex pad-markup
1114 @funindex \pad-to-box
1115 @funindex pad-to-box
1116 @funindex \pad-around
1117 @funindex pad-around
1119 Certaines directives peuvent nécessiter d'accroître l'espacement autour
1120 du texte -- voir l'annexe @ref{Align} pour une liste des différentes
1121 commandes particulières au mode @emph{markup} ainsi que leur description.
1123 @lilypond[quote,verbatim]
1124 \markup \fill-line {
1126 \box "Charles Ives (1874 - 1954)"
1128 \box \pad-markup #2 "THE UNANSWERED QUESTION"
1129 \box \pad-x #8 "A Cosmic Landscape"
1136 \box \pad-to-box #'(-5 . 20) #'(0 . 5)
1137 \bold "Largo to Presto"
1140 "String quartet keeps very even time,
1141 Flute quartet keeps very uneven time."
1145 @cindex graphisme dans la notation
1146 @cindex symboles non musicaux
1147 @cindex non musicaux, symboles
1148 @cindex notation et graphisme
1152 @funindex \draw-circle
1153 @funindex draw-circle
1154 @funindex \filled-box
1155 @funindex filled-box
1158 @funindex \draw-line
1160 @funindex \arrow-head
1161 @funindex arrow-head
1163 Vous pouvez imprimer certains graphismes ou symboles sans qu'il n'y
1164 ait de texte. Ces objets peuvent même se combiner, à l'instar de
1165 n'importe quelle expression @emph{markup}.
1167 @lilypond[quote,verbatim]
1170 \draw-circle #4 #0.4 ##f
1171 \filled-box #'(-4 . 4) #'(-0.5 . 0.5) #1
1177 \draw-line #'(0 . 4)
1178 \arrow-head #Y #DOWN ##f
1183 @cindex intégration de graphiques
1184 @cindex images, intégration
1185 @cindex graphiques, intégration
1190 @funindex \postscript
1191 @funindex postscript
1193 Des fonctionnalités graphiques avancées vous permettent même d'inclure
1194 dans une partition un fichier image converti au format PostScript
1195 encapsulé (extension @code{eps}), ou bien de tracer un graphique
1196 directement dans le fichier source à partir d'instructions PostScript
1197 pures. Nous vous conseillons, en pareil cas, de toujours spécifier les
1198 dimensions du dessin, comme dans ce qui suit :
1200 @lilypond[quote,verbatim,fragment]
1203 \epsfile #X #10 #"./context-example.eps"
1204 \with-dimensions #'(0 . 6) #'(0 . 10)
1220 L'annexe @ref{Graphic} répertorie les différentes commandes en matière
1224 Manuel de notation :
1225 @rusernamed{Align,Alignement},
1226 @ref{Annotations éditoriales},
1228 @rusernamed{Graphic,Graphique}.
1230 Fichiers d'initialisation :
1231 @file{scm/define-markup-commands.scm},
1232 @file{scm/stencil.scm}.
1235 @rlsrnamed{Text,Texte}.
1237 Référence des propriétés internes :
1238 @rinternals{TextScript}.
1241 @node Notation musicale dans du texte formaté
1242 @unnumberedsubsubsec Notation musicale dans du texte formaté
1243 @translationof Music notation inside markup
1245 @cindex notation dans un markup
1246 @cindex musique dans un markup
1247 @cindex markup, inclusion de musique
1249 Divers éléments de notation peuvent orner une partition, au moyen d'un
1250 objet @emph{markup}.
1252 Notes et altérations sont données à l'aide d'instructions
1255 @lilypond[quote,verbatim,fragment]
1259 \note-by-number #1 #1 #1.5
1262 \natural \semiflat \flat
1263 \sesquiflat \doubleflat
1267 \natural \semisharp \sharp
1268 \sesquisharp \doublesharp
1273 Le mode @emph{markup} permet d'accéder à d'autres objets de
1276 @lilypond[quote,verbatim]
1279 ees\finger \markup \tied-lyric #"4~1"
1280 fis_\markup { \dynamic rf }
1292 En règle générale, tout symbole musical peut être inclus dans un
1293 @emph{markup}, comme le montre l'exemple qui suit. Ces différents
1294 symboles sont répertoriés dans l'annexe @ref{La fonte Feta}.
1296 @lilypond[quote,verbatim]
1299 c'^\markup { \musicglyph #"eight" }
1301 c,8._\markup { \musicglyph #"clefs.G_change" }
1303 c2^\markup { \musicglyph #"timesig.neomensural94" }
1307 La rubrique @ref{Tout savoir sur les fontes} contient d'autres
1308 informations sur l'impression de glyphes non alphabétiques, tels que des
1309 crochets ou accolades.
1311 Le mode @emph{markup} supporte aussi les diagrammes spécifiques à
1312 certains instruments :
1314 @lilypond[quote,verbatim]
1317 \fret-diagram-terse #"x;x;o;2;3;2;"
1320 \harp-pedal #"^-v|--ov^"
1325 \musicglyph #"accordion.discant"
1327 \raise #0.5 \musicglyph #"accordion.dot"
1328 \raise #1.5 \musicglyph #"accordion.dot"
1333 @c The accordion diagram is actually taken from a snippet.
1336 La documentation sur ces diagrammes se trouvent à l'annexe
1337 @ref{Instrument Specific Markup}.
1339 @cindex partition incluse dans un markup
1340 @cindex markup, inclusion de partition
1342 Rien ne s'oppose à ce qu'une étiquette ne comporte une partition. Il
1343 suffit que l'expression en question contienne un bloc @code{\score}
1344 incluant un bloc @code{\layout}.
1346 @lilypond[quote,verbatim]
1350 \relative { c'4 d e f }
1359 Les différentes commandes @emph{markup} relatives à la notation musicale
1360 sont répertoriées à l'annexe @ref{Music}.
1363 Manuel de notation :
1364 @ref{La fonte Feta},
1365 @rusernamed{Music,Musique},
1366 @ref{Tout savoir sur les fontes}.
1368 Fichiers d'initialisation :
1369 @file{scm/define-markup-commands.scm},
1370 @file{scm/fret-diagrams.scm},
1371 @file{scm/harp-pedals.scm}.
1374 @rlsrnamed{Text,Texte}.
1376 Référence des propriétés internes :
1377 @rinternals{TextScript}.
1380 @node Texte avec sauts de page
1381 @unnumberedsubsubsec Texte avec sauts de page
1382 @translationof Page wrapping text
1384 @cindex multi-page, markup
1385 @cindex markup multi-page
1386 @cindex markup, texte multi-page
1387 @cindex plusieurs pages de texte
1389 @funindex \markuplist
1390 @funindex markuplist
1391 @funindex \justified-lines
1392 @funindex justified-lines
1393 @funindex \wordwrap-lines
1394 @funindex wordwrap-lines
1396 Alors que @code{\markup} s'utilise pour traiter un bloc de texte
1397 insécable, @code{\markuplist} permet, employé en tête de partition,
1398 d'obtenir un bloc de lignes réparties différemment et, le cas échéant,
1399 sur plusieurs pages.
1402 @lilypond[quote,verbatim]
1405 Un long texte constitué de lignes justifiées.
1409 Un autre grand paragraphe.
1416 Cette syntaxe prend en charge une liste de @emph{markups} ; il peut
1420 d'une suite de commandes générant à leur tour des lignes de texte,
1422 d'une liste de lignes de texte,
1424 d'une liste d'étiquettes.
1427 Les différentes commandes permettant de générer des listes de lignes
1428 se trouve dans l'annexe @ref{Commandes pour liste de markups} (en
1436 Manuel de notation :
1437 @ref{Commandes pour liste de markups}.
1439 Manuel d'extension :
1440 @rextend{Définition d'une nouvelle commande de liste de markups}.
1442 Fichiers d'initialisation :
1443 @file{scm/define-markup-commands.scm}.
1446 @rlsrnamed{Text,Texte}.
1448 Référence des propriétés internes :
1449 @rinternals{TextScript}.
1454 @translationof Fonts
1456 Ce chapitre est consacré aux fontes et polices de caractère, à leur
1457 gestion. Vous y apprendrez aussi comment changer de fonte en cours de
1461 * Tout savoir sur les fontes::
1462 * Attribution d'une fonte en particulier::
1463 * Choix des fontes par défaut::
1467 @node Tout savoir sur les fontes
1468 @unnumberedsubsubsec Tout savoir sur les fontes
1469 @translationof Fonts explained
1472 @cindex fontes, généralités
1473 @cindex accolades, taille
1474 @cindex fontes et markup
1475 @cindex markup et fontes
1477 @funindex font-interface
1479 La gestion des fontes est assurée par plusieurs bibliothèques :
1480 FontConfig se charge de répertorier les différentes fontes installées
1481 sur votre système ; quant à Pango, elle se charge plus
1482 particulièrement de leur rendu.
1484 Les fontes musicales peuvent se décrire comme un jeu de glyphes
1485 spécifiques regroupés dans plusieurs familles. L'exemple qui suit
1486 montre la syntaxe à utiliser pour accéder, en mode @emph{markup}, aux
1487 différentes fontes @code{feta} non textuelles de LilyPond.
1489 @lilypond[quote,verbatim,fragment]
1492 \override #'(font-encoding . fetaBraces)
1494 \override #'(font-encoding . fetaText)
1496 \override #'(font-encoding . fetaMusic)
1497 \lookup #"noteheads.s0petrucci"
1503 Tous ces glyphes, à l'exception des accolades qui sont regroupées dans
1504 @code{fetaBraces}, sont accessibles avec la syntaxe indiquée dans
1505 @ref{Notation musicale dans du texte formaté}.
1507 Une remarque s'impose au sujet des glyphes contenus dans
1508 @code{fetaBraces} : chacun d'eux est formé du mot @emph{brace}
1509 auquel est accolé un numéro d'ordre. Lorsque vous désirez imprimer une
1510 accolade, vous devez la @qq{chercher} par son numéro d'ordre -- d'où la
1511 fonction @code{\lookup} de l'exemple ci-dessus --, tout en sachant qu'il
1512 est compris entre @code{0} (la plus petite) et @code{575} (la plus
1513 grande). Vous serez souvent amené à procéder par tâtonnement pour
1514 arriver au résultat optimal. Par ailleurs, @code{fetaBraces} ne
1515 comporte que des accolades ouvrantes. Pour obtenir une accolade
1516 fermante, il suffit d'appliquer une rotation au glyphe sélectionné,
1517 comme indiqué à la rubrique @ref{Rotation des objets}.
1519 Vous disposez de trois familles de fontes textuelles :
1522 @emph{roman} pour la police sérif ou avec empattement -- fixée par
1523 défaut à LilyPond Serif (alias de TeX Gyre Schola),
1525 une police sans empattement (@emph{sans} sérif) -- fixée par défaut à
1526 LilyPond Sans Serif (alias de TeX Gyre Heros) et
1528 une police à chasse fixe (monospace ou @emph{typewriter}) -- fixée par
1529 défaut à LilyPond Monospace (alias de TeX Gyre Cursor).
1532 Chaque famille dispose en principe de différents styles et niveaux de
1533 gras. L'exemple qui suit illustre la manière de changer la famille, le
1534 style, la graisse ou la taille. Notez bien que l'argument fourni à
1535 @code{font-size} correspond à la correction à apporter à la taille par
1538 @lilypond[quote,verbatim,fragment]
1539 \override Score.RehearsalMark.font-family = #'typewriter
1540 \mark \markup "Ouverture"
1541 \override Voice.TextScript.font-shape = #'italic
1542 \override Voice.TextScript.font-series = #'bold
1543 d''2.^\markup "Allegro"
1544 \override Voice.TextScript.font-size = #-3
1549 Cette syntaxe s'applique aussi en mode @emph{markup}, bien que celui-ci
1550 dispose d'une syntaxe allégée comme nous l'avons vu dans
1551 @ref{Sélection de la fonte et de la taille} :
1553 @lilypond[quote,verbatim]
1557 \override #'(font-shape . italic)
1558 \override #'(font-size . 4)
1562 \override #'(font-family . typewriter)
1564 \override #'(font-series . bold)
1568 \override #'(font-family . sans)
1575 En plus de pouvoir jongler entre les différentes fontes prédéfinies,
1576 LilyPond vous permet d'en utiliser d'autres, ce qui fait l'objet des
1577 deux prochaines parties :
1578 @ref{Attribution d'une fonte en particulier}
1579 et @ref{Choix des fontes par défaut}.
1582 Manuel de notation :
1583 @ref{La fonte Feta},
1584 @ref{Notation musicale dans du texte formaté},
1585 @ref{Rotation des objets},
1586 @ref{Sélection de la fonte et de la taille},
1587 @rusernamed{Font,Fonte}.
1590 @node Attribution d'une fonte en particulier
1591 @unnumberedsubsubsec Attribution d'une fonte en particulier
1592 @translationof Single entry fonts
1594 Vous pouvez utiliser n'importe quelle police installée sur votre
1595 système, dès lors qu'elle est accessible par Fontconfig et que vous
1596 respectez la syntaxe suivante :
1598 @lilypond[quote,verbatim,fragment]
1599 \override Staff.TimeSignature.font-name = #"Bitstream Charter"
1600 \override Staff.TimeSignature.font-size = #2
1604 \override #'(font-name . "Bitstream Vera Sans,sans-serif, Oblique Bold")
1605 { Vera Oblique Bold }
1609 @cindex fontes disponibles
1610 @cindex disponibilité des fontes
1612 @var{font-name} peut se décrire sous la forme d'une liste de polices
1613 séparées par une virgule, une espace et une liste de styles. Dès lors
1614 que la police présente dans la liste est installée et comporte le glyphe
1615 requis, elle sera utilisée ; c'est la suivante dans la liste qui sera
1616 utilisée dans le cas contraire.
1618 @funindex show-available-fonts
1620 LilyPond, lancé avec l'option suivante, affiche la liste de toutes
1621 les polices disponibles sur votre machine :
1624 lilypond -dshow-available-fonts toto
1627 (quel qu'il soit, le dernier argument est obligatoire).
1630 Manuel de notation :
1631 @ref{Choix des fontes par défaut},
1632 @ref{Tout savoir sur les fontes}.
1635 @rlsrnamed{Text,Texte}.
1637 @c A source file gets never installed...
1638 @c Fichiers d'initialisation :
1639 @c @file{lily/font-config-scheme.cc}.
1642 @node Choix des fontes par défaut
1643 @unnumberedsubsubsec Choix des fontes par défaut
1644 @translationof Entire document fonts
1646 Vous pouvez tout à fait préférer un autre jeu de polices par défaut que
1647 celui de LilyPond. Il vous faudra alors spécifier les différentes
1648 familles, en respectant l'ordre @emph{roman}, @emph{sans empattement} et
1649 @emph{monospace}, comme dans l'exemple suivant ; ces fontes seront
1650 automatiquement mises à l'échelle de la taille globale des portées.
1651 Tout comme indiqué dans @ref{Attribution d'une fonte en particulier},
1652 il peut s'agir d'une liste de polices séparées par une virgule, à ceci
1653 près qu'il n'est pas possible de spécifier de style. Pour plus
1654 d'explications sur les fontes, relisez @ref{Tout savoir sur les fontes}.
1656 @cindex polices, choix par défaut
1657 @cindex fontes, choix par défaut
1659 @funindex make-pango-font-tree
1661 @lilypond[verbatim,quote]
1664 (make-pango-font-tree "Times New Roman"
1665 "Nimbus Sans,Nimbus Sans L"
1667 (/ staff-height pt 20)))
1674 \typewriter typewriter. }
1678 @c we don't do Helvetica / Courier, since GS incorrectly loads
1682 Manuel de notation :
1683 @ref{Attribution d'une fonte en particulier},
1684 @rusernamed{Font,Fonte},
1685 @ref{Sélection de la fonte et de la taille},
1686 @ref{Tout savoir sur les fontes}.