1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
4 Translation of GIT committish: 1e5c6b0f54079eb3285dcc4c7e53f17d8bb03933
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 \textLengthOff
111 @code{\textLengthOn},
112 @code{\textLengthOff}.
116 Manuel d'initiation :
117 @rlearning{Positionnement des objets}.
120 @ref{Articulations et ornements},
121 @ref{Direction et positionnement},
122 @ref{Mise en forme du texte}.
125 @rlsrnamed{Text,Texte}.
127 Référence des propriétés internes :
128 @rinternals{TextScript}.
130 @cindex texte hors marges
131 @cindex marges, texte qui dépasse
132 @cindex texte, maintien dans les marges
133 @cindex texte, maintien dans les marges
136 S'assurer que tous les éléments textuels et les paroles respectent
137 les marges du document requiert des calculs relativement lourds ;
138 vous pouvez toutefois vous en affranchir en ajoutant
141 \override Score.PaperColumn.keep-inside-line = ##f
145 @node Indication textuelle avec extension
146 @unnumberedsubsubsec Indication textuelle avec extension
147 @translationof Text spanners
149 @cindex texte et extenseur
150 @cindex prolongation de texte
153 Certaines indications d'interprétation comme @emph{rallentando},
154 @emph{accelerando} ou @emph{trilles}, s'inscrivent textuellement et se
155 prolongent sur plusieurs notes à l'aide d'une ligne pleine, pointillée
156 ou ondulée. Ces objets, que l'on appelle @qq{extenseurs}, se dessinent
157 entre deux notes à l'aide de la syntaxe suivante :
159 @lilypond[verbatim,quote]
161 \override TextSpanner.bound-details.left.text = "rit."
167 @cindex texte, mise en forme des prolongations
168 @cindex texte, mise en forme des extenseurs
169 @cindex extenseur, mise en forme
172 Le texte à imprimer est spécifié en tant que propriété de l'objet
173 @code{TextSpanner}. Il apparaîtra par défaut en italique ;
174 cependant, rien ne s'oppose à un autre graphisme dès lors que vous
175 faites appel à un bloc @code{\markup} --
176 voir @ref{Mise en forme du texte}.
178 @lilypond[quote,verbatim]
180 \override TextSpanner.bound-details.left.text =
181 \markup { \upright "rit." }
187 Le style de ligne se définit lui aussi comme une propriété de l'objet.
188 Les détails concernant la syntaxe à utiliser sont expliqués au chapitre
189 @ref{Styles de ligne}.
191 @funindex \textSpannerUp
192 @funindex \textSpannerDown
193 @funindex \textSpannerNeutral
196 @code{\textSpannerUp},
197 @code{\textSpannerDown},
198 @code{\textSpannerNeutral}.
202 @lilypondfile[verbatim,quote,texidoc,doctitle]
203 {dynamics-text-spanner-postfix.ly}
205 @lilypondfile[verbatim,quote,texidoc,doctitle]
206 {dynamics-custom-text-spanner-postfix.ly}
210 @ref{Mise en forme du texte},
212 @ref{Styles de ligne}.
215 @rlsrnamed{Text,Texte},
216 @rlsrnamed{Expressive marks,Signes d'interprétation}.
218 Référence des propriétés internes :
219 @rinternals{TextSpanner}.
222 LilyPond ne peut traiter qu'un seul extenseur à la fois par voix.
225 @node Indications textuelles
226 @unnumberedsubsubsec Indications textuelles
227 @translationof Text marks
229 @cindex indication textuelle
230 @cindex coda sur une barre de mesure
231 @cindex segno sur une barre de mesure
232 @cindex point d'orgue sur une barre de mesure
233 @cindex barres de mesure, symboles au dessus de
238 La commande @code{\mark} est tout d'abord conçue pour les
239 @ref{Indications de repère}.
241 @c \mark needs to be placed on a separate line (it's not
242 @c attached to an object like \markup is). -vv
244 @lilypond[verbatim,quote]
255 Cette syntaxe rend possible l'adjonction de n'importe quel texte à une
256 barre de mesure. Ce texte peut être mis en forme de différentes
257 manières dès lors qu'est utilisé un bloc @code{\markup}, comme indiqué
258 au chapitre @ref{Mise en forme du texte}.
260 @lilypond[quote,verbatim]
263 \mark \markup { \italic { colla parte } }
270 Elle peut aussi servir à insérer des signes de @emph{coda} ou de
271 @emph{segno}, ou bien un point d'orgue, au-dessus d'une
272 barre de mesure. Couplez-la alors à la commande @code{\markup} pour
273 avoir accès au symbole approprié, selon les indications contenues au
274 chapitre @ref{Notation musicale dans du texte formaté}.
276 @lilypond[quote,verbatim]
279 \mark \markup { \musicglyph #"scripts.ufermata" }
285 Le résultat de @code{\mark} n'apparaîtra que sur la portée supérieure
286 d'un système. Si vous introduisez la commande @code{\mark} au moment
287 d'une barre de mesure, la marque se placera au-dessus de la barre. Si
288 vous y faites appel au milieu d'une mesure, cette marque sera
289 positionnée entre les notes. Si elle intervient en début de ligne,
290 elle sera placée juste avant la première note de cette portée. Enfin,
291 une marque qui tomberait sur un saut de ligne sera imprimée au début
292 de la ligne suivante.
294 @lilypond[quote,verbatim,ragged-right]
303 @funindex \markLengthOn
304 @funindex \markLengthOff
307 @code{\markLengthOn},
308 @code{\markLengthOff}.
312 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
313 {printing-marks-at-the-end-of-a-line.ly}
315 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
316 {printing-marks-on-every-staff.ly}
320 @ref{Indications de repère},
321 @ref{La fonte Emmentaler},
322 @ref{Mise en forme du texte},
323 @ref{Notation musicale dans du texte formaté}.
326 @rlsrnamed{Text,Texte}.
328 Référence des propriétés internes :
329 @rinternals{MarkEvent},
330 @rinternals{Mark_engraver},
331 @rinternals{RehearsalMark}.
334 @node Texte indépendant
335 @unnumberedsubsubsec Texte indépendant
336 @translationof Separate text
338 @cindex texte indépendant
340 @cindex texte en préambule
341 @cindex top-level, texte
342 @cindex texte, top-level
343 @cindex indépendant, texte
347 Un bloc @code{\markup} peut exister en lui-même, indépendamment de tout
348 bloc @code{\score}, et venir en préambule par exemple -- voir le
349 chapitre @ref{Structure de fichier} à ce propos.
351 @lilypond[verbatim,quote]
353 Tomorrow, and tomorrow, and tomorrow...
358 De cette manière, vous pouvez insérer du texte en dehors de la musique.
359 Ceci devient particulièrement utile lorsque le fichier source contient
360 plusieurs morceaux. Pour plus d'informations à ce propos, reportez-vous
361 au chapitre @ref{Plusieurs partitions dans un même ouvrage}.
363 @lilypond[quote,verbatim]
368 Tomorrow, and tomorrow, and tomorrow...
375 Les blocs de textes peuvent s'étendre sur plusieurs pages, ce qui permet
376 de générer des ouvrages complets uniquement grâce à LilyPond. Cette
377 fonctionnalité, ainsi que la syntaxe appropriée, est abordée plus en
378 détail au chapitre @ref{Texte avec sauts de page}.
381 @funindex \markuplist
389 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
390 {stand-alone-two-column-markup.ly}
394 @ref{Mise en forme du texte},
395 @ref{Plusieurs partitions dans un même ouvrage},
396 @ref{Structure de fichier},
397 @ref{Texte avec sauts de page}.
400 @rlsrnamed{Text,Texte}.
402 Référence des propriétés internes :
403 @rinternals{TextScript}.
406 @node Mise en forme du texte
407 @subsection Mise en forme du texte
408 @translationof Formatting text
410 Nous allons voir dans les lignes qui suivent la manière de mettre en
411 forme du texte à l'aide de la syntaxe propre au mode @code{\markup}.
414 * Introduction au formatage de texte::
415 * Sélection de la fonte et de la taille::
416 * Alignement du texte::
417 * Éléments graphiques dans du texte formaté::
418 * Notation musicale dans du texte formaté::
419 * Texte avec sauts de page::
423 @node Introduction au formatage de texte
424 @unnumberedsubsubsec Introduction au formatage de texte
425 @translationof Text markup introduction
428 @cindex commentaire textuel
429 @cindex étiquette textuelle
435 La commande @code{\markup} permet d'ajouter du texte et dispose de sa
436 propre syntaxe que nous appellerons le @qq{mode @emph{markup}}.
438 @cindex markup, expressions
439 @cindex expressions markup
440 @cindex markup, syntaxe
441 @cindex syntaxe du mode markup
443 La syntaxe du mode @emph{markup} n'est pas différente de celle des
444 autres modes de LilyPond : une expression @code{\markup} est bornée
445 par des accolades @code{@{ @dots{} @}}. Un mot unique sera
446 considéré comme une expression minimale, et n'aura donc pas besoin
447 d'être mis entre accolades.
449 Contrairement aux indications simples, du type "entre guillemets", les
450 blocs @code{\markup} peuvent contenir des expressions imbriquées ou
451 d'autres commandes @emph{markup}, dès lors qu'elles sont précédées du
452 caractère @code{\}. Ces commandes n'affecteront que la première
453 expression qui les suit.
455 @lilypond[quote,verbatim]
458 a2^\markup { poco \italic più forte }
460 d2_\markup { \italic "string. assai" }
462 b1^\markup { \bold { molto \italic agitato } }
467 @cindex caractères spéciaux en mode markup
468 @cindex mode markup et caractères spéciaux
469 @cindex caractères réservés, impression
470 @cindex impression de caractères réservés
471 @cindex impression de caractères spéciaux
472 @cindex guillemets en mode markup
473 @cindex mode markup et guillemets
475 Un bloc @code{\markup} peut contenir du texte entre guillemets. De
476 telles chaînes seront considérées comme des expressions textuelles
477 minimales ; à ce titre, toute commande de type @emph{markup} ou
478 tout caractère spécial -- tel un @code{\} ou un @code{#} --
479 sera imprimé littéralement et sans influer sur le formatage du texte.
480 Il est de ce fait possible d'imprimer des guillemets
481 informatiques @code{"} dès lors qu'ils sont précédés d'une oblique
483 @c repeat double quote for pairing "
486 @lilypond[quote,verbatim]
488 a'1^"\italic markup..."
489 a_\markup { \italic "... imprime des lettres en \"italique\" !" }
494 Une liste de mots, pour pouvoir être traitée en tant qu'expression
495 distincte, doit être bornée par des @code{"} ou précédée d'une commande.
496 La manière de définir les expressions @emph{markup} aura une influence
497 sur la manière dont elles seront empilées, centrées ou alignées. Dans
498 l'exemple qui suit, la deuxième expression @code{\markup} est traitée
499 tout comme la première :
500 @c repeat double quote for pairing "
502 @lilypond[quote,verbatim]
504 c1^\markup { \center-column { a bbb c } }
505 c1^\markup { \center-column { a { bbb c } } }
506 c1^\markup { \center-column { a \line { bbb c } } }
507 c1^\markup { \center-column { a "bbb c" } }
511 Vous pouvez stocker les étiquettes textuelles en tant que variables,
512 et attacher ces identificateurs à des notes, comme ici :
514 @lilypond[quote,verbatim]
515 allegro = \markup { \bold \large Allegro }
524 Pour une liste des différentes commandes spécifiques au mode
525 @code{\markup}, consultez l'annexe @ref{Commandes pour markup} (en
530 @ref{Commandes pour markup}.
532 Fichiers d'initialisation :
533 @file{scm/markup.scm}.
536 @rlsrnamed{Text,Texte}.
539 Les messages d'erreur de syntaxe en mode @emph{markup} sont peu
543 @node Sélection de la fonte et de la taille
544 @unnumberedsubsubsec Sélection de la fonte et de la taille
545 @translationof Selecting font and font size
547 @cindex fonte, changement
548 @cindex changement de fonte
557 Le mode @emph{markup} autorise des changements élémentaires de la
560 @lilypond[quote,verbatim]
564 \italic { non troppo \underline Vivo }
567 d,_\markup { \italic quasi \smallCaps Tromba }
572 @cindex caractères, taille
573 @cindex texte, taille
575 @funindex \abs-fontsize
581 La taille des caractères se modifie, relativement à la taille globale
582 des portées, de différentes manières.
584 Vous pouvez adopter l'une des tailles prédéfinies, comme ici :
586 @lilypond[quote,verbatim]
588 b1_\markup { \huge Sinfonia }
589 b1^\markup { \teeny da }
590 b1-\markup { \normalsize camera }
594 Vous pouvez la modifier relativement à sa valeur précédente :
596 @lilypond[quote,verbatim]
598 b1_\markup { \larger Sinfonia }
599 b1^\markup { \smaller da }
600 b1-\markup { \magnify #0.6 camera }
604 Vous pouvez l'augmenter ou la diminuer par rapport à la taille globale
607 @lilypond[quote,verbatim]
609 b1_\markup { \fontsize #-2 Sinfonia }
610 b1^\markup { \fontsize #1 da }
611 b1-\markup { \fontsize #3 camera }
615 Vous pouvez lui attribuer une valeur arbitraire quelle que soit la
616 taille de portée globale :
618 @lilypond[quote,verbatim]
620 b1_\markup { \abs-fontsize #20 Sinfonia }
621 b1^\markup { \abs-fontsize #8 da }
622 b1-\markup { \abs-fontsize #14 camera }
626 Lorsque le texte comporte des espaces, mieux vaut le borner par des
627 guillemets informatiques ; s'en suivra une meilleure adéquation entre la
628 taille des espaces et celle des autres caractères :
630 @lilypond[quote,verbatim]
631 \markup \fontsize #6 \bold { Sinfonia da camera }
632 \markup \fontsize #6 \bold { "Sinfonia da camera" }
640 @funindex \normal-size-super
642 Vous pouvez imprimer du texte en indice ou en exposant. Celui-ci sera
643 dans une taille plus petite, mais rien ne s'oppose à ce que vous lui
644 affectiez un taille normale :
646 @lilypond[quote,verbatim]
649 \line { 1 \super st movement }
650 \line { 1 \normal-size-super st movement
651 \sub { (part two) } }
656 @cindex fontes, familles
658 Le mode @emph{markup} vous permet de sélectionner d'autres familles de
659 fontes. Par défaut, LilyPond utilise une police avec empattement, du
660 type roman, et tout changement doit être explicite. Dans la dernière
661 ligne de l'exemple qui suit, vous noterez qu'il n'y a aucune différence
662 entre les premier et deuxième mots.
664 @lilypond[quote,verbatim]
667 \line { Act \number 1 }
668 \line { \sans { Scene I. } }
669 \line { \typewriter { Verona. An open place. } }
670 \line { Enter \roman Valentine and Proteus. }
676 Certaines familles de police spécifiques aux nombres ou aux nuances par
677 exemple, ne disposent pas de tous les caractères, comme nous l'avons vu
678 dans les chapitres @ref{Personnalisation des indications de nuance} et
679 @ref{Indications de reprise manuelles}.
681 @c \concat is actually documented in Align (it is not
682 @c a font-switching command). But we need it here. -vv
684 Lorsqu'un changement survient au milieu d'un mot, il se peut qu'un
685 espacement supplémentaire apparaisse. Il suffit en pareil cas de
686 concaténer les différents éléments :
688 @lilypond[quote,verbatim]
692 \concat { 1 \super st }
696 \concat { \dynamic p , }
697 \italic { con dolce espressione }
703 Une liste des différentes commandes permettant de changer de fonte ou
704 d'utiliser des fontes personnalisées est disponible à l'annexe
707 Pour savoir comment personnaliser des fontes, reportez-vous au chapitre
713 @funindex \normalsize
732 @rusernamed{Font,Fonte},
734 @ref{Indications de reprise manuelles},
735 @ref{Personnalisation des indications de nuance}.
737 Fichiers d'initialisation :
738 @file{scm/define-markup-commands.scm}.
741 @rlsrnamed{Text,Texte}.
743 Référence des propriétés internes :
744 @rinternals{TextScript}.
747 Le recours aux commandes @code{\teeny}, @code{\tiny},@code{\small},
748 @code{\normalsize}, @code{\large} et @code{\huge} produiront des
749 espacements nettement moins réguliers que si vous utilisez
753 @node Alignement du texte
754 @unnumberedsubsubsec Alignement du texte
755 @translationof Text alignment
757 @cindex texte, alignement
758 @cindex alignement du texte
759 @cindex alignement des markups
760 @cindex markups, alignement
762 Cette partie traite de la manière de positionner du texte en mode
763 @emph{markup}. On déplace l'intégralité d'un objet @emph{markup} en
764 utilisant la syntaxe décrite au chapitre
765 @rlearning{Déplacement d'objets}.
767 @c Padding commands should be mentioned on this page, but
768 @c most of these require \box to be more clearly illustrated. -vv
770 @cindex texte, alignement horizontal
771 @cindex alignement horizontal du texte
773 @funindex \left-align
774 @funindex \center-align
775 @funindex \right-align
777 Les objets de type @emph{markup} peuvent s'aligner de différentes
778 manières. Une indication textuelle est par défaut alignée sur son
779 extrémité gauche. Dans l'exemple qui suit, il n'y a aucune différence
780 entre les deux premiers @emph{markups}.
782 @lilypond[quote,verbatim]
784 d''1-\markup { poco }
786 d-\markup { \left-align poco }
788 d-\markup { \center-align { poco } }
790 d-\markup { \right-align poco }
796 L'alignement horizontal peut être ajusté à l'aide d'une valeur
799 @lilypond[quote,verbatim]
801 a'1-\markup { \halign #-1 poco }
803 a,-\markup { \halign #0 poco }
805 a,-\markup { \halign #0.5 poco }
807 a,-\markup { \halign #2 poco }
812 Certains objets possèdent leurs propres procédures d'alignement, qui
813 annuleront toute spécification d'alignement que vous pourriez leur
814 affecter. La solution consiste alors à déplacer l'intégralité de ces
815 objets @emph{markup}, comme indiqué par exemple au chapitre
816 @ref{Indications textuelles}.
818 @cindex texte, alignement vertical
819 @cindex alignement vertical du texte
825 @c QUERY Should the function of ``\null'' be clarified? rp
827 L'alignement vertical est quant à lui un peu plus compliqué. Comme nous
828 l'avons vu ci-avant, les objets @emph{markup} peuvent être déplacés dans
829 leur intégralité. Il est néanmoins possible de déplacer certains
830 éléments spécifiques au sein d'un bloc @emph{markup}. En pareil cas,
831 l'élément à déplacer doit être précédé d'un @qq{point d'ancrage} -- un
832 autre élément du @emph{markup} ou un objet invisible. L'exemple qui
833 suit illustre ces deux possibilités. Vous noterez par ailleurs que le
834 dernier @emph{markup}, dépourvu de point d'ancrage, n'est de ce fait pas
837 @lilypond[quote,verbatim]
841 \raise #2 { Scène 1 }
846 \lower #4 \bold { Très modéré }
850 \raise #4 \italic { Une forêt. }
856 @funindex \general-align
858 @funindex \translate-scaled
860 Certaines commandes permettent de régler l'alignement des objets
861 textuels en mode @emph{markup}, tant au niveau horizontal que vertical.
862 Tout objet soumis à ces commandes doit être précédé d'un point
865 @lilypond[quote,verbatim]
869 \translate #'(-1 . 2) "Scène 1"
874 \general-align #Y #3.2 \bold "Très modéré"
879 \translate-scaled #'(-1 . 2) \teeny "Une forêt."
885 @cindex multiligne, markup
886 @cindex markup multiligne
887 @cindex multiligne, texte
888 @cindex texte multiligne
889 @cindex texte en colonnes
890 @cindex colonnes de texte
893 @funindex \center-column
895 Un objet de type @emph{markup} peut contenir plusieurs lignes de texte.
896 Dans l'exemple suivant, chaque élément ou expression ira se placer sur
897 sa propre ligne, tantôt alignée à gauche, tantôt centrée.
899 @lilypond[quote,verbatim]
915 @cindex centrage du texte sur la page
916 @cindex texte, centrage sur la page
917 @cindex markup, centrage sur la page
921 Pareillement, une liste d'éléments ou d'expressions sera répartie sur
922 une ligne entière, voire même centrée sur toute la page s'il n'y a qu'un
923 seul élément. De telles expressions peuvent à leur tour contenir du
924 texte multiligne ou une autre expression @emph{markup}.
926 @lilypond[quote,verbatim]
929 \line { William S. Gilbert }
931 \huge \smallCaps "The Mikado"
933 \smallCaps "The Town of Titipu"
935 \line { Sir Arthur Sullivan }
943 @cindex plusieurs lignes de texte
944 @cindex justifié, texte
945 @cindex texte justifié
946 @cindex texte sur plusieurs lignes
947 @cindex markup, texte au kilomètre
948 @cindex markup, texte justifié
953 Les indications textuelles, lorsqu'elles sont relativement longues,
954 peuvent se répartir sur plusieurs lignes en fonction de la largeur de
955 ligne. Le texte sera alors soit aligné à gauche, soit justifié, comme
956 le montre l'exemple suivant :
958 @lilypond[quote,verbatim]
961 \line \smallCaps { La vida breve }
962 \line \bold { Acto I }
964 (La escena representa el corral de una casa de
965 gitanos en el Albaicín de Granada. Al fondo una
966 puerta por la que se ve el negro interior de
967 una Fragua, iluminado por los rojos resplandores
972 \line \bold { Acto II }
973 \override #'(line-width . 50)
975 (Calle de Granada. Fachada de la casa de Carmela
976 y su hermano Manuel con grandes ventanas abiertas
977 a través de las que se ve el patio
978 donde se celebra una alegre fiesta)
984 @cindex commandes d'alignement du texte
985 @cindex markup, commandes d'alignement du texte
986 @cindex alignement du texte, commandes
988 Une liste des différentes commandes permettant d'aligner du texte en
989 mode @emph{markup} est disponible à l'annexe @ref{Align}.
992 Manuel d'initiation :
993 @rlearning{Déplacement d'objets}.
996 @rusernamed{Align,Alignement},
997 @ref{Indications textuelles}.
999 Fichiers d'initialisation :
1000 @file{scm/define-markup-commands.scm}.
1003 @rlsrnamed{Text,Texte}.
1005 Référence des propriétés internes :
1006 @rinternals{TextScript}.
1009 @node Éléments graphiques dans du texte formaté
1010 @unnumberedsubsubsec Éléments graphiques dans du texte formaté
1011 @translationof Graphic notation inside markup
1013 @cindex graphisme, tracé
1014 @cindex tracé d'objets graphiques
1015 @cindex graphiques, tracé d'objets
1016 @cindex intégration d'objet graphique
1017 @cindex objets graphiques, tracé
1019 Vous pouvez, grâce aux mode @emph{markup}, ajouter divers objets
1020 graphiques à votre partition.
1022 @cindex décoration du texte
1023 @cindex encadrement du texte
1024 @cindex texte, encadrement
1025 @cindex texte, décoration
1026 @cindex markup, ornementation du texte
1027 @cindex markup, encadrement du texte
1031 @funindex \rounded-box
1035 Certaines commandes de @emph{markup} permettent d'ornementer des
1036 éléments textuels avec des graphismes, à l'instar de l'exemple
1039 @lilypond[quote,verbatim]
1040 \markup \fill-line {
1048 \bracket "1866 - 1925"
1051 \rounded-box \bold Prelude
1056 @cindex espacement autour du texte
1057 @cindex texte et rembourrage
1058 @cindex markup, rembourrage du texte
1060 @funindex \pad-markup
1062 @funindex \pad-to-box
1063 @funindex \pad-around
1065 Certaines directives peuvent nécessiter d'accroître l'espacement autour
1066 du texte -- voir l'annexe @ref{Align} pour une liste des différentes
1067 commandes particulières au mode @emph{markup} ainsi que leur description.
1069 @lilypond[quote,verbatim]
1070 \markup \fill-line {
1072 \box "Charles Ives (1874 - 1954)"
1074 \box \pad-markup #2 "THE UNANSWERED QUESTION"
1075 \box \pad-x #8 "A Cosmic Landscape"
1082 \box \pad-to-box #'(-5 . 20) #'(0 . 5)
1083 \bold "Largo to Presto"
1086 "String quartet keeps very even time,
1087 Flute quartet keeps very uneven time."
1091 @cindex graphisme dans la notation
1092 @cindex symboles non musicaux
1093 @cindex non musicaux, symboles
1094 @cindex notation et graphisme
1097 @funindex \draw-circle
1098 @funindex \filled-box
1100 @funindex \draw-line
1101 @funindex \arrow-head
1103 Vous pouvez imprimer certains graphismes ou symboles sans qu'il n'y
1104 ait de texte. Ces objets peuvent même se combiner, à l'instar de
1105 n'importe quelle expression @emph{markup}.
1107 @lilypond[quote,verbatim]
1110 \draw-circle #4 #0.4 ##f
1111 \filled-box #'(-4 . 4) #'(-0.5 . 0.5) #1
1117 \draw-line #'(0 . 4)
1118 \arrow-head #Y #DOWN ##f
1123 @cindex intégration de graphiques
1124 @cindex images, intégration
1125 @cindex graphiques, intégration
1129 @funindex \postscript
1131 Des fonctionnalités graphiques avancées vous permettent même d'inclure
1132 dans une partition un fichier image converti au format PostScript
1133 encapsulé (extension @code{eps}), ou bien de tracer un graphique
1134 directement dans le fichier source à partir d'instructions PostScript
1135 pures. Nous vous conseillons, en pareil cas, de toujours spécifier les
1136 dimensions du dessin, comme dans ce qui suit :
1138 @lilypond[quote,verbatim,fragment]
1141 \epsfile #X #10 #"./context-example.eps"
1142 \with-dimensions #'(0 . 6) #'(0 . 10)
1158 L'annexe @ref{Graphic} répertorie les différentes commandes en matière
1162 Manuel de notation :
1163 @rusernamed{Align,Alignement},
1164 @ref{Annotations éditoriales},
1166 @rusernamed{Graphic,Graphique}.
1168 Fichiers d'initialisation :
1169 @file{scm/define-markup-commands.scm},
1170 @file{scm/stencil.scm}.
1173 @rlsrnamed{Text,Texte}.
1175 Référence des propriétés internes :
1176 @rinternals{TextScript}.
1179 @node Notation musicale dans du texte formaté
1180 @unnumberedsubsubsec Notation musicale dans du texte formaté
1181 @translationof Music notation inside markup
1183 @cindex notation dans un markup
1184 @cindex musique dans un markup
1185 @cindex markup, inclusion de musique
1187 Divers éléments de notation peuvent orner une partition, au moyen d'un
1188 objet @emph{markup}.
1190 Notes et altérations sont données à l'aide d'instructions
1193 @lilypond[quote,verbatim,fragment]
1197 \note-by-number #1 #1 #1.5
1200 \natural \semiflat \flat
1201 \sesquiflat \doubleflat
1205 \natural \semisharp \sharp
1206 \sesquisharp \doublesharp
1211 Le mode @emph{markup} permet d'accéder à d'autres objets de
1214 @lilypond[quote,verbatim]
1217 ees\finger \markup \tied-lyric #"4~1"
1218 fis_\markup { \dynamic rf }
1230 En règle générale, tout symbole musical peut être inclus dans un
1231 @emph{markup}, comme le montre l'exemple qui suit. Ces différents
1232 symboles sont répertoriés dans l'annexe @ref{La fonte Emmentaler}.
1234 @lilypond[quote,verbatim]
1237 c'^\markup { \musicglyph #"eight" }
1239 c,8._\markup { \musicglyph #"clefs.G_change" }
1241 c2^\markup { \musicglyph #"timesig.neomensural94" }
1245 La rubrique @ref{Tout savoir sur les fontes} contient d'autres
1246 informations sur l'impression de glyphes non alphabétiques, tels que des
1247 crochets ou accolades.
1249 Le mode @emph{markup} supporte aussi les diagrammes spécifiques à
1250 certains instruments :
1252 @lilypond[quote,verbatim]
1255 \fret-diagram-terse #"x;x;o;2;3;2;"
1258 \harp-pedal #"^-v|--ov^"
1263 \musicglyph #"accordion.discant"
1265 \raise #0.5 \musicglyph #"accordion.dot"
1266 \raise #1.5 \musicglyph #"accordion.dot"
1271 @c The accordion diagram is actually taken from a snippet.
1274 La documentation sur ces diagrammes se trouvent à l'annexe
1275 @ref{Instrument Specific Markup}.
1277 @cindex partition incluse dans un markup
1278 @cindex markup, inclusion de partition
1280 Rien ne s'oppose à ce qu'une étiquette ne comporte une partition. Il
1281 suffit que l'expression en question contienne un bloc @code{\score}
1282 incluant un bloc @code{\layout}.
1284 @lilypond[quote,verbatim]
1288 \relative { c'4 d e f }
1297 Les différentes commandes @emph{markup} relatives à la notation musicale
1298 sont répertoriées à l'annexe @ref{Music}.
1301 Manuel de notation :
1302 @ref{La fonte Emmentaler},
1303 @rusernamed{Music,Musique},
1304 @ref{Tout savoir sur les fontes}.
1306 Fichiers d'initialisation :
1307 @file{scm/define-markup-commands.scm},
1308 @file{scm/fret-diagrams.scm},
1309 @file{scm/harp-pedals.scm}.
1312 @rlsrnamed{Text,Texte}.
1314 Référence des propriétés internes :
1315 @rinternals{TextScript}.
1318 @node Texte avec sauts de page
1319 @unnumberedsubsubsec Texte avec sauts de page
1320 @translationof Page wrapping text
1322 @cindex multi-page, markup
1323 @cindex markup multi-page
1324 @cindex markup, texte multi-page
1325 @cindex plusieurs pages de texte
1327 @funindex \markuplist
1328 @funindex \justified-lines
1329 @funindex \wordwrap-lines
1331 Alors que @code{\markup} s'utilise pour traiter un bloc de texte
1332 insécable, @code{\markuplist} permet, employé en tête de partition,
1333 d'obtenir un bloc de lignes réparties différemment et, le cas échéant,
1334 sur plusieurs pages.
1337 @lilypond[quote,verbatim]
1340 Un long texte constitué de lignes justifiées.
1344 Un autre grand paragraphe.
1351 Cette syntaxe prend en charge une liste de @emph{markups} ; il peut
1355 d'une suite de commandes générant à leur tour des lignes de texte,
1357 d'une liste de lignes de texte,
1359 d'une liste d'étiquettes.
1362 Les différentes commandes permettant de générer des listes de lignes
1363 se trouve dans l'annexe @ref{Commandes pour liste de markups} (en
1371 Manuel de notation :
1372 @ref{Commandes pour liste de markups}.
1374 Manuel d'extension :
1375 @rextend{Définition d'une nouvelle commande de liste de markups}.
1377 Fichiers d'initialisation :
1378 @file{scm/define-markup-commands.scm}.
1381 @rlsrnamed{Text,Texte}.
1383 Référence des propriétés internes :
1384 @rinternals{TextScript}.
1389 @translationof Fonts
1391 Ce chapitre est consacré aux fontes et polices de caractère, à leur
1392 gestion. Vous y apprendrez aussi comment changer de fonte en cours de
1396 * Tout savoir sur les fontes::
1397 * Attribution d'une fonte en particulier::
1398 * Choix des fontes par défaut::
1402 @node Tout savoir sur les fontes
1403 @unnumberedsubsubsec Tout savoir sur les fontes
1404 @translationof Fonts explained
1407 @cindex fontes, généralités
1408 @cindex accolades, taille
1409 @cindex fontes et markup
1410 @cindex markup et fontes
1412 @funindex font-interface
1414 La gestion des fontes est assurée par plusieurs bibliothèques :
1415 FontConfig se charge de répertorier les différentes fontes installées
1416 sur votre système ; quant à Pango, elle se charge plus particulièrement
1419 Les fontes musicales peuvent se décrire comme un jeu de glyphes
1420 spécifiques regroupés dans plusieurs familles. L'exemple qui suit
1421 montre la syntaxe à utiliser pour accéder, en mode @emph{markup}, aux
1422 différents glyphes @code{Feta} non textuels de LilyPond.
1424 @lilypond[quote,verbatim,fragment]
1427 \override #'(font-encoding . fetaBraces)
1429 \override #'(font-encoding . fetaText)
1431 \override #'(font-encoding . fetaMusic)
1432 \lookup #"noteheads.s0petrucci"
1438 Tous ces glyphes, à l'exception des accolades qui sont regroupées dans
1439 @code{fetaBraces}, sont accessibles avec la syntaxe indiquée dans
1440 @ref{Notation musicale dans du texte formaté}.
1442 Une remarque s'impose au sujet des glyphes contenus dans
1443 @code{fetaBraces} : chacun d'eux est formé du mot @emph{brace} auquel
1444 est accolé un numéro d'ordre. Lorsque vous désirez imprimer une
1445 accolade, vous devez la @qq{chercher} par son numéro d'ordre -- d'où la
1446 fonction @code{\lookup} de l'exemple ci-dessus --, tout en sachant qu'il
1447 est compris entre @code{0} (la plus petite) et @code{575} (la plus
1448 grande). Vous serez souvent amené à procéder par tâtonnement pour
1449 arriver au résultat optimal. Par ailleurs, @code{fetaBraces} ne comporte
1450 que des accolades ouvrantes. Pour obtenir une accolade fermante, il
1451 suffit d'appliquer une rotation au glyphe sélectionné, comme indiqué à
1452 la rubrique @ref{Rotation des objets}.
1454 Vous disposez de trois familles de fontes textuelles :
1457 @emph{roman} pour la police sérif ou avec empattement -- fixée par
1458 défaut à LilyPond Serif (alias de TeX Gyre Schola),
1460 une police sans empattement (@emph{sans} sérif) -- fixée par défaut à
1461 LilyPond Sans Serif (alias de TeX Gyre Heros) et
1463 une police à chasse fixe (monospace ou @emph{typewriter}) -- fixée par
1464 défaut à LilyPond Monospace (alias de TeX Gyre Cursor).
1467 Chaque famille dispose en principe de différents styles et niveaux de
1468 gras. L'exemple qui suit illustre la manière de changer la famille, le
1469 style, la graisse ou la taille. Notez bien que l'argument fourni à
1470 @code{font-size} correspond à la correction à apporter à la taille par
1473 @lilypond[quote,verbatim,fragment]
1474 \override Score.RehearsalMark.font-family = #'typewriter
1475 \mark \markup "Ouverture"
1476 \override Voice.TextScript.font-shape = #'italic
1477 \override Voice.TextScript.font-series = #'bold
1478 d''2.^\markup "Allegro"
1479 \override Voice.TextScript.font-size = #-3
1484 Cette syntaxe s'applique aussi en mode @emph{markup}, bien que celui-ci
1485 dispose d'une syntaxe allégée comme nous l'avons vu dans
1486 @ref{Sélection de la fonte et de la taille} :
1488 @lilypond[quote,verbatim]
1492 \override #'(font-shape . italic)
1493 \override #'(font-size . 4)
1497 \override #'(font-family . typewriter)
1499 \override #'(font-series . bold)
1503 \override #'(font-family . sans)
1510 En plus de pouvoir jongler entre les différentes fontes prédéfinies,
1511 LilyPond vous permet d'en utiliser d'autres, ce qui fait l'objet des
1512 deux prochaines parties :
1513 @ref{Attribution d'une fonte en particulier}
1514 et @ref{Choix des fontes par défaut}.
1517 Manuel de notation :
1518 @ref{La fonte Emmentaler},
1519 @ref{Notation musicale dans du texte formaté},
1520 @ref{Rotation des objets},
1521 @ref{Sélection de la fonte et de la taille},
1522 @rusernamed{Font,Fonte}.
1525 @node Attribution d'une fonte en particulier
1526 @unnumberedsubsubsec Attribution d'une fonte en particulier
1527 @translationof Single entry fonts
1529 Vous pouvez utiliser n'importe quelle police installée sur votre
1530 système, dès lors qu'elle est accessible par Fontconfig et que vous
1531 respectez la syntaxe suivante :
1533 @lilypond[quote,verbatim,fragment]
1534 \override Staff.TimeSignature.font-name = #"Bitstream Charter"
1535 \override Staff.TimeSignature.font-size = #2
1539 \override #'(font-name . "Bitstream Vera Sans,sans-serif, Oblique Bold")
1540 { Vera Oblique Bold }
1544 @cindex fontes disponibles
1545 @cindex disponibilité des fontes
1547 @var{font-name} peut se décrire sous la forme d'une liste de polices
1548 séparées par une virgule, une espace et une liste de styles. Dès lors
1549 que la police présente dans la liste est installée et comporte le glyphe
1550 requis, elle sera utilisée ; c'est la suivante dans la liste qui sera
1551 utilisée dans le cas contraire.
1553 @funindex show-available-fonts
1555 LilyPond, lancé avec l'option suivante, affiche la liste de toutes
1556 les polices disponibles sur votre machine :
1559 lilypond -dshow-available-fonts toto
1562 (quel qu'il soit, le dernier argument est obligatoire).
1565 Manuel de notation :
1566 @ref{Choix des fontes par défaut},
1567 @ref{Tout savoir sur les fontes}.
1570 @rlsrnamed{Text,Texte}.
1572 @c A source file gets never installed...
1573 @c Fichiers d'initialisation :
1574 @c @file{lily/font-config-scheme.cc}.
1577 @node Choix des fontes par défaut
1578 @unnumberedsubsubsec Choix des fontes par défaut
1579 @translationof Entire document fonts
1581 Vous pouvez tout à fait préférer un autre jeu de polices par défaut que
1582 celui de LilyPond. Il vous faudra alors spécifier les différentes
1583 familles, en respectant l'ordre @emph{roman}, @emph{sans empattement} et
1584 @emph{monospace}, comme dans l'exemple suivant ; ces fontes seront
1585 automatiquement mises à l'échelle de la taille globale des portées.
1586 Tout comme indiqué dans @ref{Attribution d'une fonte en particulier},
1587 il peut s'agir d'une liste de polices séparées par une virgule, à ceci
1588 près qu'il n'est pas possible de spécifier de style. Pour plus
1589 d'explications sur les fontes, relisez @ref{Tout savoir sur les fontes}.
1591 @cindex polices, choix par défaut
1592 @cindex fontes, choix par défaut
1594 @funindex make-pango-font-tree
1596 @lilypond[verbatim,quote]
1599 (make-pango-font-tree "Times New Roman"
1600 "Nimbus Sans,Nimbus Sans L"
1602 (/ staff-height pt 20)))
1609 \typewriter typewriter. }
1613 @c we don't do Helvetica / Courier, since GS incorrectly loads
1617 Manuel de notation :
1618 @ref{Attribution d'une fonte en particulier},
1619 @rusernamed{Font,Fonte},
1620 @ref{Sélection de la fonte et de la taille},
1621 @ref{Tout savoir sur les fontes}.