1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
4 Translation of GIT committish: 53cff5245f682708a6c77d580f418ece2923c2e4
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{Mise en forme du texte},
123 @ref{Direction et positionnement},
124 @ref{Articulations et ornements}.
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{Styles de ligne},
217 @ref{Mise en forme du texte}.
220 @rlsrnamed{Text,Texte},
221 @rlsrnamed{Expressive marks,Signes d'interprétation}.
223 Référence des propriétés internes :
224 @rinternals{TextSpanner}.
227 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]
259 Cette syntaxe rend possible l'adjonction de n'importe quel texte à une
260 barre de mesure. Ce texte peut être mis en forme de différentes
261 manières dès lors qu'est utilisé un bloc @code{\markup}, comme indiqué
262 au chapitre @ref{Mise en forme du texte}.
264 @lilypond[quote,verbatim]
267 \mark \markup { \italic { colla parte } }
274 Elle peut aussi servir à insérer des signes de @emph{coda} ou de
275 @emph{segno}, ou bien un point d'orgue, au-dessus d'une
276 barre de mesure. Couplez-la alors à la commande @code{\markup} pour
277 avoir accès au symbole approprié, selon les indications contenues au
278 chapitre @ref{Notation musicale dans du texte formaté}.
280 @lilypond[quote,verbatim]
283 \mark \markup { \musicglyph #"scripts.ufermata" }
289 Le résultat de @code{\mark} n'apparaîtra que sur la portée supérieure
290 d'un système. Si vous introduisez la commande @code{\mark} au moment
291 d'une barre de mesure, la marque se placera au-dessus de la barre. Si
292 vous y faites appel au milieu d'une mesure, cette marque sera
293 positionnée entre les notes. Si elle intervient en début de ligne,
294 elle sera placée juste avant la première note de cette portée. Enfin,
295 une marque qui tomberait sur un saut de ligne sera imprimée au début
296 de la ligne suivante.
298 @lilypond[quote,verbatim,ragged-right]
307 @funindex \markLengthOn
308 @funindex markLengthOn
309 @funindex \markLengthOff
310 @funindex markLengthOff
313 @code{\markLengthOn},
314 @code{\markLengthOff}.
318 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
319 {printing-marks-at-the-end-of-a-line.ly}
321 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
322 {printing-marks-on-every-staff.ly}
326 @ref{Indications de repère},
327 @ref{Mise en forme du texte},
328 @ref{Notation musicale dans du texte formaté},
332 @rlsrnamed{Text,Texte}.
334 Référence des propriétés internes :
335 @rinternals{MarkEvent},
336 @rinternals{Mark_engraver},
337 @rinternals{RehearsalMark}.
340 @node Texte indépendant
341 @unnumberedsubsubsec Texte indépendant
342 @translationof Separate text
344 @cindex texte indépendant
346 @cindex texte en préambule
347 @cindex top-level, texte
348 @cindex texte, top-level
349 @cindex indépendant, texte
354 Un bloc @code{\markup} peut exister en lui-même, indépendamment de tout
355 bloc @code{\score}, et venir en préambule par exemple -- voir le
356 chapitre @ref{Structure de fichier} à ce propos.
358 @lilypond[verbatim,quote]
360 Tomorrow, and tomorrow, and tomorrow...
365 De cette manière, vous pouvez insérer du texte en dehors de la musique.
366 Ceci devient particulièrement utile lorsque le fichier source contient
367 plusieurs morceaux. Pour plus d'informations à ce propos, reportez-vous
368 au chapitre @ref{Plusieurs partitions dans un même ouvrage}.
370 @lilypond[quote,verbatim]
375 Tomorrow, and tomorrow, and tomorrow...
382 Les blocs de textes peuvent s'étendre sur plusieurs pages, ce qui permet
383 de générer des ouvrages complets uniquement grâce à LilyPond. Cette
384 fonctionnalité, ainsi que la syntaxe appropriée, est abordée plus en
385 détail au chapitre @ref{Texte avec sauts de page}.
389 @funindex \markuplist
398 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
399 {stand-alone-two-column-markup.ly}
403 @ref{Mise en forme du texte},
404 @ref{Structure de fichier},
405 @ref{Plusieurs partitions dans un même ouvrage},
406 @ref{Texte avec sauts de page}.
409 @rlsrnamed{Text,Texte}.
411 Référence des propriétés internes :
412 @rinternals{TextScript}.
415 @node Mise en forme du texte
416 @subsection Mise en forme du texte
417 @translationof Formatting text
419 Nous allons voir dans les lignes qui suivent la manière de mettre en
420 forme du texte à l'aide de la syntaxe propre au mode @code{\markup}.
423 * Introduction au formatage de texte::
424 * Sélection de la fonte et de la taille::
425 * Alignement du texte::
426 * Éléments graphiques dans du texte formaté::
427 * Notation musicale dans du texte formaté::
428 * Texte avec sauts de page::
432 @node Introduction au formatage de texte
433 @unnumberedsubsubsec Introduction au formatage de texte
434 @translationof Text markup introduction
437 @cindex commentaire textuel
438 @cindex étiquette textuelle
445 La commande @code{\markup} permet d'ajouter du texte et dispose de sa
446 propre syntaxe que nous appellerons le @qq{mode @emph{markup}}.
448 @cindex markup, expressions
449 @cindex expressions markup
450 @cindex markup, syntaxe
451 @cindex syntaxe du mode markup
453 La syntaxe du mode @emph{markup} n'est pas différente de celle des
454 autres modes de LilyPond : une expression @code{\markup} est bornée
455 par des accolades @code{@{ @dots{} @}}. Un mot unique sera
456 considéré comme une expression minimale, et n'aura donc pas besoin
457 d'être mis entre accolades.
459 Contrairement aux indications simples, du type "entre guillemets", les
460 blocs @code{\markup} peuvent contenir des expressions imbriquées ou
461 d'autres commandes @emph{markup}, dès lors qu'elles sont précédées du
462 caractère @code{\}. Ces commandes n'affecteront que la première
463 expression qui les suit.
465 @lilypond[quote,verbatim]
468 a2^\markup { poco \italic più forte }
470 d2_\markup { \italic "string. assai" }
472 b1^\markup { \bold { molto \italic agitato } }
477 @cindex caractères spéciaux en mode markup
478 @cindex mode markup et caractères spéciaux
479 @cindex caractères réservés, impression
480 @cindex impression de caractères réservés
481 @cindex impression de caractères spéciaux
482 @cindex guillemets en mode markup
483 @cindex mode markup et guillemets
485 Un bloc @code{\markup} peut contenir du texte entre guillemets. De
486 telles chaînes seront considérées comme des expressions textuelles
487 minimales ; à ce titre, toute commande de type @emph{markup} ou
488 tout caractère spécial -- tel un @code{\} ou un @code{#} --
489 sera imprimé littéralement et sans influer sur le formatage du texte.
490 Il est de ce fait possible d'imprimer des guillemets
491 informatiques @code{"} dès lors qu'ils sont précédés d'une oblique
493 @c repeat double quote for pairing "
496 @lilypond[quote,verbatim]
498 a'1^"\italic markup..."
499 a_\markup { \italic "... imprime des lettres en \"italique\" !" }
504 Une liste de mots, pour pouvoir être traitée en tant qu'expression
505 distincte, doit être bornée par des @code{"} ou précédée d'une commande.
506 La manière de définir les expressions @emph{markup} aura une influence
507 sur la manière dont elles seront empilées, centrées ou alignées. Dans
508 l'exemple qui suit, la deuxième expression @code{\markup} est traitée
509 tout comme la première :
510 @c repeat double quote for pairing "
512 @lilypond[quote,verbatim]
514 c1^\markup { \center-column { a bbb c } }
515 c1^\markup { \center-column { a { bbb c } } }
516 c1^\markup { \center-column { a \line { bbb c } } }
517 c1^\markup { \center-column { a "bbb c" } }
521 Vous pouvez stocker les étiquettes textuelles en tant que variables,
522 et attacher ces identificateurs à des notes, comme ici :
524 @lilypond[quote,verbatim]
525 allegro = \markup { \bold \large Allegro }
534 Pour une liste des différentes commandes spécifiques au mode
535 @code{\markup}, consultez l'annexe @ref{Commandes pour markup} (en
540 @ref{Commandes pour markup}.
542 Fichiers d'initialisation :
543 @file{scm/markup.scm}.
546 @rlsrnamed{Text,Texte}.
549 Les erreurs de syntaxe en mode @emph{markup} sont peu explicites.
552 @node Sélection de la fonte et de la taille
553 @unnumberedsubsubsec Sélection de la fonte et de la taille
554 @translationof Selecting font and font size
556 @cindex fonte, changement
557 @cindex changement de fonte
569 Le mode @emph{markup} autorise des changements élémentaires de la
572 @lilypond[quote,verbatim]
576 \italic { non troppo \underline Vivo }
579 d,_\markup { \italic quasi \smallCaps Tromba }
584 @cindex caractères, taille
585 @cindex texte, taille
587 @funindex \abs-fontsize
597 La taille des caractères se modifie, relativement à la taille globale
598 des portées, de différentes manières.
600 Vous pouvez adopter l'une des tailles prédéfinies, comme ici :
602 @lilypond[quote,verbatim]
604 b1_\markup { \huge Sinfonia }
605 b1^\markup { \teeny da }
606 b1-\markup { \normalsize camera }
610 Vous pouvez la modifier relativement à sa valeur précédente :
612 @lilypond[quote,verbatim]
614 b1_\markup { \larger Sinfonia }
615 b1^\markup { \smaller da }
616 b1-\markup { \magnify #0.6 camera }
620 Vous pouvez l'augmenter ou la diminuer par rapport à la taille globale
623 @lilypond[quote,verbatim]
625 b1_\markup { \fontsize #-2 Sinfonia }
626 b1^\markup { \fontsize #1 da }
627 b1-\markup { \fontsize #3 camera }
631 Vous pouvez lui attribuer une valeur arbitraire quelle que soit la
632 taille de portée globale :
634 @lilypond[quote,verbatim]
636 b1_\markup { \abs-fontsize #20 Sinfonia }
637 b1^\markup { \abs-fontsize #8 da }
638 b1-\markup { \abs-fontsize #14 camera }
642 Lorsque le texte comporte des espaces, mieux vaut le borner par des
643 guillemets informatiques ; s'en suivra une meilleure adéquation entre la
644 taille des espaces et celle des autres caractères :
646 @lilypond[quote,verbatim]
647 \markup \fontsize #6 \bold { Sinfonia da camera }
648 \markup \fontsize #6 \bold { "Sinfonia da camera" }
658 @funindex \normal-size-super
659 @funindex normal-size-super
661 Vous pouvez imprimer du texte en indice ou en exposant. Celui-ci sera
662 dans une taille plus petite, mais rien ne s'oppose à ce que vous lui
663 affectiez un taille normale :
665 @lilypond[quote,verbatim]
668 \line { 1 \super st movement }
669 \line { 1 \normal-size-super st movement
670 \sub { (part two) } }
675 @cindex fontes, familles
677 Le mode @emph{markup} vous permet de sélectionner d'autres familles de
678 fontes. Par défaut, LilyPond utilise une police avec empattement, du
679 type roman, et tout changement doit être explicite. Dans la dernière
680 ligne de l'exemple qui suit, vous noterez qu'il n'y a aucune différence
681 entre les premier et deuxième mots.
683 @lilypond[quote,verbatim]
686 \line { Act \number 1 }
687 \line { \sans { Scene I. } }
688 \line { \typewriter { Verona. An open place. } }
689 \line { Enter \roman Valentine and Proteus. }
695 Certaines familles de police spécifiques aux nombres ou aux nuances par
696 exemple, ne disposent pas de tous les caractères, comme nous l'avons vu
697 dans les chapitres @ref{Personnalisation des indications de nuance} et
698 @ref{Indications de reprise manuelles}.
700 @c \concat is actually documented in Align (it is not
701 @c a font-switching command). But we need it here. -vv
703 Lorsqu'un changement survient au milieu d'un mot, il se peut qu'un
704 espacement supplémentaire apparaisse. Il suffit en pareil cas de
705 concaténer les différents éléments :
707 @lilypond[quote,verbatim]
711 \concat { 1 \super st }
715 \concat { \dynamic p , }
716 \italic { con dolce espressione }
722 Une liste des différentes commandes permettant de changer de fonte ou
723 d'utiliser des fontes personnalisées est disponible à l'annexe
726 Pour savoir comment personnaliser des fontes, reportez-vous au chapitre
735 @funindex \normalsize
760 @ref{Personnalisation des indications de nuance},
761 @ref{Indications de reprise manuelles},
764 Fichiers d'initialisation :
765 @file{scm/define-markup-commands.scm}.
768 @rlsrnamed{Text,Texte}.
770 Référence des propriétés internes :
771 @rinternals{TextScript}.
774 Le recours aux commandes @code{\teeny}, @code{\tiny},@code{\small},
775 @code{\normalsize}, @code{\large} et @code{\huge} produiront des
776 espacements nettement moins réguliers que si vous utilisez
780 @node Alignement du texte
781 @unnumberedsubsubsec Alignement du texte
782 @translationof Text alignment
784 @cindex texte, alignement
785 @cindex alignement du texte
786 @cindex alignement des markups
787 @cindex markups, alignement
789 Cette partie traite de la manière de positionner du texte en mode
790 @emph{markup}. On déplace l'intégralité d'un objet @emph{markup} en
791 utilisant la syntaxe décrite au chapitre
792 @rlearning{Déplacement d'objets}.
794 @c Padding commands should be mentioned on this page, but
795 @c most of these require \box to be more clearly illustrated. -vv
797 @cindex texte, alignement horizontal
798 @cindex alignement horizontal du texte
800 @funindex \left-align
802 @funindex \center-align
803 @funindex center-align
804 @funindex \right-align
805 @funindex right-align
807 Les objets de type @emph{markup} peuvent s'aligner de différentes
808 manières. Une indication textuelle est par défaut alignée sur son
809 extrémité gauche. Dans l'exemple qui suit, il n'y a aucune différence
810 entre les deux premiers @emph{markups}.
812 @lilypond[quote,verbatim]
814 d''1-\markup { poco }
816 d-\markup { \left-align poco }
818 d-\markup { \center-align { poco } }
820 d-\markup { \right-align poco }
827 L'alignement horizontal peut être ajusté à l'aide d'une valeur
830 @lilypond[quote,verbatim]
832 a'1-\markup { \halign #-1 poco }
834 a,-\markup { \halign #0 poco }
836 a,-\markup { \halign #0.5 poco }
838 a,-\markup { \halign #2 poco }
843 Certains objets possèdent leurs propres procédures d'alignement, qui
844 annuleront toute spécification d'alignement que vous pourriez leur
845 affecter. La solution consiste alors à déplacer l'intégralité de ces
846 objets @emph{markup}, comme indiqué par exemple au chapitre
847 @ref{Indications textuelles}.
849 @cindex texte, alignement vertical
850 @cindex alignement vertical du texte
859 @c QUERY Should the function of ``\null'' be clarified? rp
861 L'alignement vertical est quant à lui un peu plus compliqué. Comme nous
862 l'avons vu ci-avant, les objets @emph{markup} peuvent être déplacés dans
863 leur intégralité. Il est néanmoins possible de déplacer certains
864 éléments spécifiques au sein d'un bloc @emph{markup}. En pareil cas,
865 l'élément à déplacer doit être précédé d'un @qq{point d'ancrage} -- un
866 autre élément du @emph{markup} ou un objet invisible. L'exemple qui
867 suit illustre ces deux possibilités. Vous noterez par ailleurs que le
868 dernier @emph{markup}, dépourvu de point d'ancrage, n'est de ce fait pas
871 @lilypond[quote,verbatim]
875 \raise #2 { Scène 1 }
880 \lower #4 \bold { Très modéré }
884 \raise #4 \italic { Une forêt. }
890 @funindex \general-align
891 @funindex general-align
894 @funindex \translate-scaled
895 @funindex translate-scaled
897 Certaines commandes permettent de régler l'alignement des objets
898 textuels en mode @emph{markup}, tant au niveau horizontal que vertical.
899 Tout objet soumis à ces commandes doit être précédé d'un point
902 @lilypond[quote,verbatim]
906 \translate #'(-1 . 2) "Scène 1"
911 \general-align #Y #3.2 \bold "Très modéré"
916 \translate-scaled #'(-1 . 2) \teeny "Une forêt."
922 @cindex multiligne, markup
923 @cindex markup multiligne
924 @cindex multiligne, texte
925 @cindex texte multiligne
926 @cindex texte en colonnes
927 @cindex colonnes de texte
931 @funindex \center-column
932 @funindex center-column
934 Un objet de type @emph{markup} peut contenir plusieurs lignes de texte.
935 Dans l'exemple suivant, chaque élément ou expression ira se placer sur
936 sa propre ligne, tantôt alignée à gauche, tantôt centrée.
938 @lilypond[quote,verbatim]
954 @cindex centrage du texte sur la page
955 @cindex texte, centrage sur la page
956 @cindex markup, centrage sur la page
961 Pareillement, une liste d'éléments ou d'expressions sera répartie sur
962 une ligne entière, voire même centrée sur toute la page s'il n'y a qu'un
963 seul élément. De telles expressions peuvent à leur tour contenir du
964 texte multiligne ou une autre expression @emph{markup}.
966 @lilypond[quote,verbatim]
969 \line { William S. Gilbert }
971 \huge \smallCaps "The Mikado"
973 \smallCaps "The Town of Titipu"
975 \line { Sir Arthur Sullivan }
983 @cindex plusieurs lignes de texte
984 @cindex justifié, texte
985 @cindex texte justifié
986 @cindex texte sur plusieurs lignes
987 @cindex markup, texte au kilomètre
988 @cindex markup, texte justifié
995 Les indications textuelles, lorsqu'elles sont relativement longues,
996 peuvent se répartir sur plusieurs lignes en fonction de la largeur de
997 ligne. Le texte sera alors soit aligné à gauche, soit justifié, comme
998 le montre l'exemple suivant :
1000 @lilypond[quote,verbatim]
1003 \line \smallCaps { La vida breve }
1004 \line \bold { Acto I }
1006 (La escena representa el corral de una casa de
1007 gitanos en el Albaicín de Granada. Al fondo una
1008 puerta por la que se ve el negro interior de
1009 una Fragua, iluminado por los rojos resplandores
1014 \line \bold { Acto II }
1015 \override #'(line-width . 50)
1017 (Calle de Granada. Fachada de la casa de Carmela
1018 y su hermano Manuel con grandes ventanas abiertas
1019 a través de las que se ve el patio
1020 donde se celebra una alegre fiesta)
1026 @cindex commandes d'alignement du texte
1027 @cindex markup, commandes d'alignement du texte
1028 @cindex alignement du texte, commandes
1030 Une liste des différentes commandes permettant d'aligner du texte en
1031 mode @emph{markup} est disponible à l'annexe @ref{Align}.
1034 Manuel d'initiation :
1035 @rlearning{Déplacement d'objets}.
1037 Manuel de notation :
1039 @ref{Indications textuelles}.
1041 Fichiers d'initialisation :
1042 @file{scm/define-markup-commands.scm}.
1045 @rlsrnamed{Text,Texte}.
1047 Référence des propriétés internes :
1048 @rinternals{TextScript}.
1051 @node Éléments graphiques dans du texte formaté
1052 @unnumberedsubsubsec Éléments graphiques dans du texte formaté
1053 @translationof Graphic notation inside markup
1055 @cindex graphisme, tracé
1056 @cindex tracé d'objets graphiques
1057 @cindex graphiques, tracé d'objets
1058 @cindex intégration d'objet graphique
1059 @cindex objets graphiques, tracé
1061 Vous pouvez, grâce aux mode @emph{markup}, ajouter divers objets
1062 graphiques à votre partition.
1064 @cindex décoration du texte
1065 @cindex encadrement du texte
1066 @cindex texte, encadrement
1067 @cindex texte, décoration
1068 @cindex markup, ornementation du texte
1069 @cindex markup, encadrement du texte
1075 @funindex \rounded-box
1076 @funindex rounded-box
1082 Certaines commandes de @emph{markup} permettent d'ornementer des
1083 éléments textuels avec des graphismes, à l'instar de l'exemple
1086 @lilypond[quote,verbatim]
1087 \markup \fill-line {
1095 \bracket "1866 - 1925"
1098 \rounded-box \bold Prelude
1103 @cindex espacement autour du texte
1104 @cindex texte et rembourrage
1105 @cindex markup, rembourrage du texte
1107 @funindex \pad-markup
1108 @funindex pad-markup
1111 @funindex \pad-to-box
1112 @funindex pad-to-box
1113 @funindex \pad-around
1114 @funindex pad-around
1116 Certaines directives peuvent nécessiter d'accroître l'espacement autour
1117 du texte -- voir l'annexe @ref{Align} pour une liste des différentes
1118 commandes particulières au mode @emph{markup} ainsi que leur description.
1120 @lilypond[quote,verbatim]
1121 \markup \fill-line {
1123 \box "Charles Ives (1874 - 1954)"
1125 \box \pad-markup #2 "THE UNANSWERED QUESTION"
1126 \box \pad-x #8 "A Cosmic Landscape"
1133 \box \pad-to-box #'(-5 . 20) #'(0 . 5)
1134 \bold "Largo to Presto"
1137 "String quartet keeps very even time,
1138 Flute quartet keeps very uneven time."
1142 @cindex graphisme dans la notation
1143 @cindex symboles non musicaux
1144 @cindex non musicaux, symboles
1145 @cindex notation et graphisme
1149 @funindex \draw-circle
1150 @funindex draw-circle
1151 @funindex \filled-box
1152 @funindex filled-box
1155 @funindex \draw-line
1157 @funindex \arrow-head
1158 @funindex arrow-head
1160 Vous pouvez imprimer certains graphismes ou symboles sans qu'il n'y
1161 ait de texte. Ces objets peuvent même se combiner, à l'instar de
1162 n'importe quelle expression @emph{markup}.
1164 @lilypond[quote,verbatim]
1167 \draw-circle #4 #0.4 ##f
1168 \filled-box #'(-4 . 4) #'(-0.5 . 0.5) #1
1174 \draw-line #'(0 . 4)
1175 \arrow-head #Y #DOWN ##f
1180 @cindex intégration de graphiques
1181 @cindex images, intégration
1182 @cindex graphiques, intégration
1187 @funindex \postscript
1188 @funindex postscript
1190 Des fonctionnalités graphiques avancées vous permettent même d'inclure
1191 dans une partition un fichier image converti au format PostScript
1192 encapsulé (extension @code{eps}), ou bien de tracer un graphique
1193 directement dans le fichier source à partir d'instructions PostScript
1194 pures. Nous vous conseillons, en pareil cas, de toujours spécifier les
1195 dimensions du dessin, comme dans ce qui suit :
1197 @lilypond[quote,verbatim,fragment]
1200 \epsfile #X #10 #"./context-example.eps"
1201 \with-dimensions #'(0 . 6) #'(0 . 10)
1217 L'annexe @ref{Graphic} répertorie les différentes commandes en matière
1221 Manuel de notation :
1223 @ref{Annotations éditoriales},
1227 Fichiers d'initialisation :
1228 @file{scm/define-markup-commands.scm},
1229 @file{scm/stencil.scm}.
1232 @rlsrnamed{Text,Texte}.
1234 Référence des propriétés internes :
1235 @rinternals{TextScript}.
1238 @node Notation musicale dans du texte formaté
1239 @unnumberedsubsubsec Notation musicale dans du texte formaté
1240 @translationof Music notation inside markup
1242 @cindex notation dans un markup
1243 @cindex musique dans un markup
1244 @cindex markup, inclusion de musique
1246 Divers éléments de notation peuvent orner une partition, au moyen d'un
1247 objet @emph{markup}.
1249 Notes et altérations sont données à l'aide d'instructions
1252 @lilypond[quote,verbatim,fragment]
1256 \note-by-number #1 #1 #1.5
1259 \natural \semiflat \flat
1260 \sesquiflat \doubleflat
1264 \natural \semisharp \sharp
1265 \sesquisharp \doublesharp
1270 Le mode @emph{markup} permet d'accéder à d'autres objets de
1273 @lilypond[quote,verbatim]
1276 ees\finger \markup \tied-lyric #"4~1"
1277 fis_\markup { \dynamic rf }
1289 En règle générale, tout symbole musical peut être inclus dans un
1290 @emph{markup}, comme le montre l'exemple qui suit. Ces différents
1291 symboles sont répertoriés dans l'annexe @ref{La fonte Feta}.
1293 @lilypond[quote,verbatim]
1296 c'^\markup { \musicglyph #"eight" }
1298 c,8._\markup { \musicglyph #"clefs.G_change" }
1300 c2^\markup { \musicglyph #"timesig.neomensural94" }
1304 La rubrique @ref{Tout savoir sur les fontes} contient d'autres
1305 informations sur l'impression de glyphes non alphabétiques, tels que des
1306 crochets ou accolades.
1308 Le mode @emph{markup} supporte aussi les diagrammes spécifiques à
1309 certains instruments :
1311 @lilypond[quote,verbatim]
1314 \fret-diagram-terse #"x;x;o;2;3;2;"
1317 \harp-pedal #"^-v|--ov^"
1322 \musicglyph #"accordion.discant"
1324 \raise #0.5 \musicglyph #"accordion.dot"
1325 \raise #1.5 \musicglyph #"accordion.dot"
1330 @c The accordion diagram is actually taken from a snippet.
1333 La documentation sur ces diagrammes se trouvent à l'annexe
1334 @ref{Instrument Specific Markup}.
1336 @cindex partition incluse dans un markup
1337 @cindex markup, inclusion de partition
1339 Rien ne s'oppose à ce qu'une étiquette ne comporte une partition. Il
1340 suffit que l'expression en question contienne un bloc @code{\score}
1341 incluant un bloc @code{\layout}.
1343 @lilypond[quote,verbatim]
1347 \relative { c'4 d e f }
1356 Les différentes commandes @emph{markup} relatives à la notation musicale
1357 sont répertoriées à l'annexe @ref{Music}.
1360 Manuel de notation :
1362 @ref{La fonte Feta},
1363 @ref{Tout savoir sur les fontes}.
1365 Fichiers d'initialisation :
1366 @file{scm/define-markup-commands.scm},
1367 @file{scm/fret-diagrams.scm},
1368 @file{scm/harp-pedals.scm}.
1371 @rlsrnamed{Text,Texte}.
1373 Référence des propriétés internes :
1374 @rinternals{TextScript}.
1377 @node Texte avec sauts de page
1378 @unnumberedsubsubsec Texte avec sauts de page
1379 @translationof Page wrapping text
1381 @cindex multi-page, markup
1382 @cindex markup multi-page
1383 @cindex markup, texte multi-page
1384 @cindex plusieurs pages de texte
1386 @funindex \markuplist
1387 @funindex markuplist
1388 @funindex \justified-lines
1389 @funindex justified-lines
1390 @funindex \wordwrap-lines
1391 @funindex wordwrap-lines
1393 Alors que @code{\markup} s'utilise pour traiter un bloc de texte
1394 insécable, @code{\markuplist} permet, employé en tête de partition,
1395 d'obtenir un bloc de lignes réparties différemment et, le cas échéant,
1396 sur plusieurs pages.
1399 @lilypond[quote,verbatim]
1402 Un long texte constitué de lignes justifiées.
1406 Un autre grand paragraphe.
1413 Cette syntaxe prend en charge une liste de @emph{markups} ; il peut
1417 d'une suite de commandes générant à leur tour des lignes de texte,
1419 d'une liste de lignes de texte,
1421 d'une liste d'étiquettes.
1424 Les différentes commandes permettant de générer des listes de lignes
1425 se trouve dans l'annexe @ref{Commandes pour liste de markups} (en
1433 Manuel de notation :
1434 @ref{Commandes pour liste de markups}.
1436 Manuel d'extension :
1437 @rextend{Définition d'une nouvelle commande de liste de markups}.
1439 Fichiers d'initialisation :
1440 @file{scm/define-markup-commands.scm}.
1443 @rlsrnamed{Text,Texte}.
1445 Référence des propriétés internes :
1446 @rinternals{TextScript}.
1451 @translationof Fonts
1453 Ce chapitre est consacré aux fontes et polices de caractère, à leur
1454 gestion. Vous y apprendrez aussi comment changer de fonte en cours de
1458 * Tout savoir sur les fontes::
1459 * Attribution d'une fonte en particulier::
1460 * Choix des fontes par défaut::
1464 @node Tout savoir sur les fontes
1465 @unnumberedsubsubsec Tout savoir sur les fontes
1466 @translationof Fonts explained
1469 @cindex fontes, généralités
1470 @cindex accolades, taille
1471 @cindex fontes et markup
1472 @cindex markup et fontes
1474 @funindex font-interface
1476 La gestion des fontes est assurée par plusieurs bibliothèques :
1477 FontConfig se charge de répertorier les différentes fontes installées
1478 sur votre système ; quant à Pango, elle se charge plus
1479 particulièrement de leur rendu.
1481 Les fontes musicales peuvent se décrire comme un jeu de glyphes
1482 spécifiques regroupés dans plusieurs familles. L'exemple qui suit
1483 montre la syntaxe à utiliser pour accéder, en mode @emph{markup}, aux
1484 différentes fontes @code{feta} non textuelles de LilyPond.
1486 @lilypond[quote,verbatim,fragment]
1489 \override #'(font-encoding . fetaBraces)
1491 \override #'(font-encoding . fetaText)
1493 \override #'(font-encoding . fetaMusic)
1494 \lookup #"noteheads.s0petrucci"
1500 Tous ces glyphes, à l'exception des accolades qui sont regroupées dans
1501 @code{fetaBraces}, sont accessibles avec la syntaxe indiquée dans
1502 @ref{Notation musicale dans du texte formaté}.
1504 Une remarque s'impose au sujet des glyphes contenus dans
1505 @code{fetaBraces} : chacun d'eux est formé du mot @emph{brace}
1506 auquel est accolé un numéro d'ordre. Lorsque vous désirez imprimer une
1507 accolade, vous devez la @qq{chercher} par son numéro d'ordre -- d'où la
1508 fonction @code{\lookup} de l'exemple ci-dessus --, tout en sachant qu'il
1509 est compris entre @code{0} (la plus petite) et @code{575} (la plus
1510 grande). Vous serez souvent amené à procéder par tâtonnement pour
1511 arriver au résultat optimal. Par ailleurs, @code{fetaBraces} ne
1512 comporte que des accolades ouvrantes. Pour obtenir une accolade
1513 fermante, il suffit d'appliquer une rotation au glyphe sélectionné,
1514 comme indiqué à la rubrique @ref{Rotation des objets}.
1516 Vous disposez de trois familles de fontes textuelles : @emph{roman} pour
1517 la police sérif ou avec empattement -- fixée par défaut à New Century
1518 Schoolbook --, une police sans empattement (@emph{sans} sérif) et une à
1519 chasse fixe (monospace ou @emph{typewriter}) -- les deux dernières étant
1520 déterminées par l'installation de Pango.
1522 @warning{Aucune police par défaut n'est associée aux familles
1523 @emph{sans} et @emph{typewriter}. Lorsque l'une d'elles apparaît dans
1524 un fichier source, le résultat peut varier d'un ordinateur à l'autre.
1525 Le résultat sera homogène quelque soit la plateforme dès lors que ces
1526 polices auront été spécifiées par leur nom et qu'elles sont disponibles
1527 pour tout système amené à traiter le fichier. Voir
1528 @ref{Attribution d'une fonte en particulier} et
1529 @ref{Choix des fontes par défaut}.}
1531 Chaque famille dispose en principe de différents styles et niveaux de
1532 gras. L'exemple qui suit illustre la manière de changer la famille, le
1533 style, la graisse ou la taille. Notez bien que l'argument fourni à
1534 @code{font-size} correspond à la correction à apporter à la taille par
1537 @lilypond[quote,verbatim,fragment]
1538 \override Score.RehearsalMark.font-family = #'typewriter
1539 \mark \markup "Ouverture"
1540 \override Voice.TextScript.font-shape = #'italic
1541 \override Voice.TextScript.font-series = #'bold
1542 d''2.^\markup "Allegro"
1543 \override Voice.TextScript.font-size = #-3
1548 Cette syntaxe s'applique aussi en mode @emph{markup}, bien que celui-ci
1549 dispose d'une syntaxe allégée comme nous l'avons vu dans
1550 @ref{Sélection de la fonte et de la taille} :
1552 @lilypond[quote,verbatim]
1556 \override #'(font-shape . italic)
1557 \override #'(font-size . 4)
1561 \override #'(font-family . typewriter)
1563 \override #'(font-series . bold)
1567 \override #'(font-family . sans)
1574 En plus de pouvoir jongler entre les différentes fontes prédéfinies,
1575 LilyPond vous permet d'en utiliser d'autres, ce qui fait l'objet des
1576 deux prochaines parties :
1577 @ref{Attribution d'une fonte en particulier}
1578 et @ref{Choix des fontes par défaut}.
1581 Manuel de notation :
1582 @ref{La fonte Feta},
1583 @ref{Notation musicale dans du texte formaté},
1584 @ref{Rotation des objets},
1585 @ref{Sélection de la fonte et de la taille},
1589 @node Attribution d'une fonte en particulier
1590 @unnumberedsubsubsec Attribution d'une fonte en particulier
1591 @translationof Single entry fonts
1593 Vous pouvez utiliser n'importe quelle police installée sur votre
1594 système, dès lors qu'elle est accessible par Fontconfig et que vous
1595 respectez la syntaxe suivante :
1597 @lilypond[quote,verbatim,fragment]
1598 \override Staff.TimeSignature.font-name = #"Bitstream Charter"
1599 \override Staff.TimeSignature.font-size = #2
1603 \override #'(font-name . "Vera Bold")
1608 @cindex fontes disponibles
1609 @cindex disponibilité des fontes
1611 @funindex show-available-fonts
1613 LilyPond, lancé avec l'option suivante, affiche la liste de toutes
1614 les polices disponibles sur votre machine :
1617 lilypond -dshow-available-fonts toto
1620 (quel qu'il soit, le dernier argument est obligatoire).
1623 Manuel de notation :
1624 @ref{Tout savoir sur les fontes},
1625 @ref{Choix des fontes par défaut}.
1628 @rlsrnamed{Text,Texte}.
1630 @c A source file gets never installed...
1631 @c Fichiers d'initialisation :
1632 @c @file{lily/font-config-scheme.cc}.
1635 @node Choix des fontes par défaut
1636 @unnumberedsubsubsec Choix des fontes par défaut
1637 @translationof Entire document fonts
1639 Vous pouvez tout à fait préférer un autre jeu de polices par défaut que
1640 celui de LilyPond. Il vous faudra alors spécifier les différentes
1641 familles, en respectant l'ordre @emph{roman}, @emph{sans empattement} et
1642 @emph{monospace}, comme dans l'exemple suivant ; ces fontes seront
1643 automatiquement mises à l'échelle de la taille globale des
1644 portées. Pour plus d'explications sur les fontes, relisez
1645 @ref{Tout savoir sur les fontes}.
1647 @cindex polices, choix par défaut
1648 @cindex fontes, choix par défaut
1650 @funindex make-pango-font-tree
1652 @lilypond[verbatim,quote]
1655 (make-pango-font-tree "Times New Roman"
1658 (/ staff-height pt 20)))
1665 \typewriter typewriter. }
1669 @c we don't do Helvetica / Courier, since GS incorrectly loads
1673 Manuel de notation :
1674 @ref{Tout savoir sur les fontes},
1675 @ref{Attribution d'une fonte en particulier},
1676 @ref{Sélection de la fonte et de la taille},