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,relative=2]
72 a8^"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,relative=2]
81 a8^\markup { \italic pizz. } g f e
82 a4_\markup { \tiny scherz. \bold molto } f
85 Par défaut, ces indications n'affectent en rien l'espacement des
86 notes. Leur longueur peut néanmoins être prise en considération :
87 dans l'exemple qui suit, le premier commentaire n'influe pas sur
88 l'espacement, à l'inverse du second.
90 @lilypond[quote,verbatim,relative=2]
96 En plus d'indications textuelles, les notes peuvent se voir attacher des
97 articulations, comme indiqué au chapitre
98 @ref{Articulations et ornements}.
100 Pour de plus amples détails sur la manière de combiner indications
101 textuelles et articulations, reportez-vous au chapitre
102 @rlearning{Positionnement des objets}.
104 @funindex \textLengthOn
105 @funindex textLengthOn
106 @funindex \textLengthOff
107 @funindex textLengthOff
110 @code{\textLengthOn},
111 @code{\textLengthOff}.
115 Manuel d'initiation :
116 @rlearning{Positionnement des objets}.
119 @ref{Mise en forme du texte},
120 @ref{Direction et positionnement},
121 @ref{Articulations et ornements}.
124 @rlsrnamed{Text,Texte}.
126 Référence des propriétés internes :
127 @rinternals{TextScript}.
129 @cindex texte hors marges
130 @cindex marges, texte qui dépasse
131 @cindex texte, maintien dans les marges
132 @cindex texte, maintien dans les marges
135 S'assurer que tous les éléments textuels et les paroles respectent
136 les marges du document requiert des calculs relativement lourds ;
137 vous pouvez toutefois vous en affranchir en ajoutant
140 \override Score.PaperColumn.keep-inside-line = ##f
144 @node Indication textuelle avec extension
145 @unnumberedsubsubsec Indication textuelle avec extension
146 @translationof Text spanners
148 @cindex texte et extenseur
149 @cindex prolongation de texte
152 Certaines indications d'interprétation comme @emph{rallentando},
153 @emph{accelerando} ou @emph{trilles}, s'inscrivent textuellement et se
154 prolongent sur plusieurs notes à l'aide d'une ligne pleine, pointillée
155 ou ondulée. Ces objets, que l'on appelle @qq{extenseurs}, se dessinent
156 entre deux notes à l'aide de la syntaxe suivante :
158 @lilypond[verbatim,quote,relative=2]
159 \override TextSpanner.bound-details.left.text = "rit."
164 @cindex texte, mise en forme des prolongations
165 @cindex texte, mise en forme des extenseurs
166 @cindex extenseur, mise en forme
169 Le texte à imprimer est spécifié en tant que propriété de l'objet
170 @code{TextSpanner}. Il apparaîtra par défaut en italique ;
171 cependant, rien ne s'oppose à un autre graphisme dès lors que vous
172 faites appel à un bloc @code{\markup} --
173 voir @ref{Mise en forme du texte}.
175 @lilypond[quote,relative=2,verbatim]
176 \override TextSpanner.bound-details.left.text =
177 \markup { \upright "rit." }
182 Le style de ligne se définit lui aussi comme une propriété de l'objet.
183 Les détails concernant la syntaxe à utiliser sont expliqués au chapitre
184 @ref{Styles de ligne}.
186 @funindex \textSpannerUp
187 @funindex textSpannerUp
188 @funindex \textSpannerDown
189 @funindex textSpannerDown
190 @funindex \textSpannerNeutral
191 @funindex textSpannerNeutral
194 @code{\textSpannerUp},
195 @code{\textSpannerDown},
196 @code{\textSpannerNeutral}.
200 @lilypondfile[verbatim,quote,texidoc,doctitle]
201 {dynamics-text-spanner-postfix.ly}
203 @lilypondfile[verbatim,quote,texidoc,doctitle]
204 {dynamics-custom-text-spanner-postfix.ly}
208 @ref{Styles de ligne},
210 @ref{Mise en forme du texte}.
213 @rlsrnamed{Text,Texte},
214 @rlsrnamed{Expressive marks,Signes d'interprétation}.
216 Référence des propriétés internes :
217 @rinternals{TextSpanner}.
220 LilyPond ne peut traiter qu'un seul extenseur à la fois par voix.
223 @node Indications textuelles
224 @unnumberedsubsubsec Indications textuelles
225 @translationof Text marks
227 @cindex indication textuelle
228 @cindex coda sur une barre de mesure
229 @cindex segno sur une barre de mesure
230 @cindex point d'orgue sur une barre de mesure
231 @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,relative=2]
250 Cette syntaxe rend possible l'adjonction de n'importe quel texte à une
251 barre de mesure. Ce texte peut être mis en forme de différentes
252 manières dès lors qu'est utilisé un bloc @code{\markup}, comme indiqué
253 au chapitre @ref{Mise en forme du texte}.
255 @lilypond[quote,verbatim,relative=1]
257 \mark \markup { \italic { colla parte } }
263 Elle peut aussi servir à insérer des signes de @emph{coda} ou de
264 @emph{segno}, ou bien un point d'orgue, au-dessus d'une
265 barre de mesure. Couplez-la alors à la commande @code{\markup} pour
266 avoir accès au symbole approprié, selon les indications contenues au
267 chapitre @ref{Notation musicale dans du texte formaté}.
269 @lilypond[quote,verbatim,relative=2]
271 \mark \markup { \musicglyph #"scripts.ufermata" }
276 Le résultat de @code{\mark} n'apparaîtra que sur la portée supérieure
277 d'un système. Si vous introduisez la commande @code{\mark} au moment
278 d'une barre de mesure, la marque se placera au-dessus de la barre. Si
279 vous y faites appel au milieu d'une mesure, cette marque sera
280 positionnée entre les notes. Si elle intervient en début de ligne,
281 elle sera placée juste avant la première note de cette portée. Enfin,
282 une marque qui tomberait sur un saut de ligne sera imprimée au début
283 de la ligne suivante.
285 @lilypond[quote,verbatim,relative=2,ragged-right]
292 @funindex \markLengthOn
293 @funindex markLengthOn
294 @funindex \markLengthOff
295 @funindex markLengthOff
298 @code{\markLengthOn},
299 @code{\markLengthOff}.
303 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
304 {printing-marks-at-the-end-of-a-line.ly}
306 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
307 {printing-marks-on-every-staff.ly}
311 @ref{Indications de repère},
312 @ref{Mise en forme du texte},
313 @ref{Notation musicale dans du texte formaté},
317 @rlsrnamed{Text,Texte}.
319 Référence des propriétés internes :
320 @rinternals{MarkEvent},
321 @rinternals{Mark_engraver},
322 @rinternals{RehearsalMark}.
325 @node Texte indépendant
326 @unnumberedsubsubsec Texte indépendant
327 @translationof Separate text
329 @cindex texte indépendant
331 @cindex texte en préambule
332 @cindex top-level, texte
333 @cindex texte, top-level
334 @cindex indépendant, texte
339 Un bloc @code{\markup} peut exister en lui-même, indépendamment de tout
340 bloc @code{\score}, et venir en préambule par exemple -- voir le
341 chapitre @ref{Structure de fichier} à ce propos.
343 @lilypond[verbatim,quote]
345 Tomorrow, and tomorrow, and tomorrow...
350 De cette manière, vous pouvez insérer du texte en dehors de la musique.
351 Ceci devient particulièrement utile lorsque le fichier source contient
352 plusieurs morceaux. Pour plus d'informations à ce propos, reportez-vous
353 au chapitre @ref{Plusieurs partitions dans un même ouvrage}.
355 @lilypond[quote,verbatim]
360 Tomorrow, and tomorrow, and tomorrow...
367 Les blocs de textes peuvent s'étendre sur plusieurs pages, ce qui permet
368 de générer des ouvrages complets uniquement grâce à LilyPond. Cette
369 fonctionnalité, ainsi que la syntaxe appropriée, est abordée plus en
370 détail au chapitre @ref{Texte avec sauts de page}.
374 @funindex \markuplist
383 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
384 {stand-alone-two-column-markup.ly}
388 @ref{Mise en forme du texte},
389 @ref{Structure de fichier},
390 @ref{Plusieurs partitions dans un même ouvrage},
391 @ref{Texte avec sauts de page}.
394 @rlsrnamed{Text,Texte}.
396 Référence des propriétés internes :
397 @rinternals{TextScript}.
400 @node Mise en forme du texte
401 @subsection Mise en forme du texte
402 @translationof Formatting text
404 Nous allons voir dans les lignes qui suivent la manière de mettre en
405 forme du texte à l'aide de la syntaxe propre au mode @code{\markup}.
408 * Introduction au formatage de texte::
409 * Sélection de la fonte et de la taille::
410 * Alignement du texte::
411 * Éléments graphiques dans du texte formaté::
412 * Notation musicale dans du texte formaté::
413 * Texte avec sauts de page::
417 @node Introduction au formatage de texte
418 @unnumberedsubsubsec Introduction au formatage de texte
419 @translationof Text markup introduction
422 @cindex commentaire textuel
423 @cindex étiquette textuelle
430 La commande @code{\markup} permet d'ajouter du texte et dispose de sa
431 propre syntaxe que nous appellerons le @qq{mode @emph{markup}}.
433 @cindex markup, expressions
434 @cindex expressions markup
435 @cindex markup, syntaxe
436 @cindex syntaxe du mode markup
438 La syntaxe du mode @emph{markup} n'est pas différente de celle des
439 autres modes de LilyPond : une expression @code{\markup} est bornée
440 par des accolades @code{@{ @dots{} @}}. Un mot unique sera
441 considéré comme une expression minimale, et n'aura donc pas besoin
442 d'être mis entre accolades.
444 Contrairement aux indications simples, du type "entre guillemets", les
445 blocs @code{\markup} peuvent contenir des expressions imbriquées ou
446 d'autres commandes @emph{markup}, dès lors qu'elles sont précédées du
447 caractère @code{\}. Ces commandes n'affecteront que la première
448 expression qui les suit.
450 @lilypond[quote,verbatim,relative=2]
452 a2^\markup { poco \italic più forte }
454 d2_\markup { \italic "string. assai" }
456 b1^\markup { \bold { molto \italic agitato } }
460 @cindex caractères spéciaux en mode markup
461 @cindex mode markup et caractères spéciaux
462 @cindex caractères réservés, impression
463 @cindex impression de caractères réservés
464 @cindex impression de caractères spéciaux
465 @cindex guillemets en mode markup
466 @cindex mode markup et guillemets
468 Un bloc @code{\markup} peut contenir du texte entre guillemets. De
469 telles chaînes seront considérées comme des expressions textuelles
470 minimales ; à ce titre, toute commande de type @emph{markup} ou
471 tout caractère spécial -- tel un @code{\} ou un @code{#} --
472 sera imprimé littéralement et sans influer sur le formatage du texte.
473 Il est de ce fait possible d'imprimer des guillemets
474 informatiques @code{"} dès lors qu'ils sont précédés d'une oblique
476 @c repeat double quote for pairing "
479 @lilypond[quote,verbatim,relative=2]
480 a1^"\italic markup..."
481 a_\markup { \italic "... imprime des lettres en \"italique\" !" }
485 Une liste de mots, pour pouvoir être traitée en tant qu'expression
486 distincte, doit être bornée par des @code{"} ou précédée d'une commande.
487 La manière de définir les expressions @emph{markup} aura une influence
488 sur la manière dont elles seront empilées, centrées ou alignées. Dans
489 l'exemple qui suit, la deuxième expression @code{\markup} est traitée
490 tout comme la première :
491 @c repeat double quote for pairing "
493 @lilypond[quote,verbatim,relative=2]
494 c1^\markup { \center-column { a bbb c } }
495 c1^\markup { \center-column { a { bbb c } } }
496 c1^\markup { \center-column { a \line { bbb c } } }
497 c1^\markup { \center-column { a "bbb c" } }
500 Vous pouvez stocker les étiquettes textuelles en tant que variables,
501 et attacher ces identificateurs à des notes, comme ici :
503 @lilypond[quote,verbatim]
504 allegro = \markup { \bold \large Allegro }
513 Pour une liste des différentes commandes spécifiques au mode
514 @code{\markup}, consultez l'annexe @ref{Commandes pour markup} (en
519 @ref{Commandes pour markup}.
521 Fichiers d'initialisation :
522 @file{scm/markup.scm}.
525 @rlsrnamed{Text,Texte}.
528 Les erreurs de syntaxe en mode @emph{markup} sont peu explicites.
531 @node Sélection de la fonte et de la taille
532 @unnumberedsubsubsec Sélection de la fonte et de la taille
533 @translationof Selecting font and font size
535 @cindex fonte, changement
536 @cindex changement de fonte
548 Le mode @emph{markup} autorise des changements élémentaires de la
551 @lilypond[quote,verbatim,relative=2]
554 \italic { non troppo \underline Vivo }
557 d,_\markup { \italic quasi \smallCaps Tromba }
561 @cindex caractères, taille
562 @cindex texte, taille
564 @funindex \abs-fontsize
574 La taille des caractères se modifie, relativement à la taille globale
575 des portées, de différentes manières.
577 Vous pouvez adopter l'une des tailles prédéfinies, comme ici :
579 @lilypond[quote,verbatim,relative=2]
580 b1_\markup { \huge Sinfonia }
581 b1^\markup { \teeny da }
582 b1-\markup { \normalsize camera }
585 Vous pouvez la modifier relativement à sa valeur précédente :
587 @lilypond[quote,verbatim,relative=2]
588 b1_\markup { \larger Sinfonia }
589 b1^\markup { \smaller da }
590 b1-\markup { \magnify #0.6 camera }
593 Vous pouvez l'augmenter ou la diminuer par rapport à la taille globale
596 @lilypond[quote,verbatim,relative=2]
597 b1_\markup { \fontsize #-2 Sinfonia }
598 b1^\markup { \fontsize #1 da }
599 b1-\markup { \fontsize #3 camera }
602 Vous pouvez lui attribuer une valeur arbitraire quelle que soit la
603 taille de portée globale :
605 @lilypond[quote,verbatim,relative=2]
606 b1_\markup { \abs-fontsize #20 Sinfonia }
607 b1^\markup { \abs-fontsize #8 da }
608 b1-\markup { \abs-fontsize #14 camera }
611 Lorsque le texte comporte des espaces, mieux vaut le borner par des
612 guillemets informatiques ; s'en suivra une meilleure adéquation entre la
613 taille des espaces et celle des autres caractères :
615 @lilypond[quote,verbatim]
616 \markup \fontsize #6 \bold { Sinfonia da camera }
617 \markup \fontsize #6 \bold { "Sinfonia da camera" }
627 @funindex \normal-size-super
628 @funindex normal-size-super
630 Vous pouvez imprimer du texte en indice ou en exposant. Celui-ci sera
631 dans une taille plus petite, mais rien ne s'oppose à ce que vous lui
632 affectiez un taille normale :
634 @lilypond[quote,verbatim]
637 \line { 1 \super st movement }
638 \line { 1 \normal-size-super st movement
639 \sub { (part two) } }
644 @cindex fontes, familles
646 Le mode @emph{markup} vous permet de sélectionner d'autres familles de
647 fontes. Par défaut, LilyPond utilise une police avec empattement, du
648 type roman, et tout changement doit être explicite. Dans la dernière
649 ligne de l'exemple qui suit, vous noterez qu'il n'y a aucune différence
650 entre les premier et deuxième mots.
652 @lilypond[quote,verbatim]
655 \line { Act \number 1 }
656 \line { \sans { Scene I. } }
657 \line { \typewriter { Verona. An open place. } }
658 \line { Enter \roman Valentine and Proteus. }
664 Certaines familles de police spécifiques aux nombres ou aux nuances par
665 exemple, ne disposent pas de tous les caractères, comme nous l'avons vu
666 dans les chapitres @ref{Personnalisation des indications de nuance} et
667 @ref{Indications de reprise manuelles}.
669 @c \concat is actually documented in Align (it is not
670 @c a font-switching command). But we need it here. -vv
672 Lorsqu'un changement survient au milieu d'un mot, il se peut qu'un
673 espacement supplémentaire apparaisse. Il suffit en pareil cas de
674 concaténer les différents éléments :
676 @lilypond[quote,verbatim]
680 \concat { 1 \super st }
684 \concat { \dynamic p , }
685 \italic { con dolce espressione }
691 Une liste des différentes commandes permettant de changer de fonte ou
692 d'utiliser des fontes personnalisées est disponible à l'annexe
695 Pour savoir comment personnaliser des fontes, reportez-vous au chapitre
704 @funindex \normalsize
729 @ref{Personnalisation des indications de nuance},
730 @ref{Indications de reprise manuelles},
733 Fichiers d'initialisation :
734 @file{scm/define-markup-commands.scm}.
737 @rlsrnamed{Text,Texte}.
739 Référence des propriétés internes :
740 @rinternals{TextScript}.
743 Le recours aux commandes @code{\teeny}, @code{\tiny},@code{\small},
744 @code{\normalsize}, @code{\large} et @code{\huge} produiront des
745 espacements nettement moins réguliers que si vous utilisez
749 @node Alignement du texte
750 @unnumberedsubsubsec Alignement du texte
751 @translationof Text alignment
753 @cindex texte, alignement
754 @cindex alignement du texte
755 @cindex alignement des markups
756 @cindex markups, alignement
758 Cette partie traite de la manière de positionner du texte en mode
759 @emph{markup}. On déplace l'intégralité d'un objet @emph{markup} en
760 utilisant la syntaxe décrite au chapitre
761 @rlearning{Déplacement d'objets}.
763 @c Padding commands should be mentioned on this page, but
764 @c most of these require \box to be more clearly illustrated. -vv
766 @cindex texte, alignement horizontal
767 @cindex alignement horizontal du texte
769 @funindex \left-align
771 @funindex \center-align
772 @funindex center-align
773 @funindex \right-align
774 @funindex right-align
776 Les objets de type @emph{markup} peuvent s'aligner de différentes
777 manières. Une indication textuelle est par défaut alignée sur son
778 extrémité gauche. Dans l'exemple qui suit, il n'y a aucune différence
779 entre les deux premiers @emph{markups}.
781 @lilypond[quote,verbatim,relative=2]
784 d-\markup { \left-align poco }
786 d-\markup { \center-align { poco } }
788 d-\markup { \right-align poco }
794 L'alignement horizontal peut être ajusté à l'aide d'une valeur
797 @lilypond[quote,verbatim,relative=2]
798 a1-\markup { \halign #-1 poco }
800 a,-\markup { \halign #0 poco }
802 a,-\markup { \halign #0.5 poco }
804 a,-\markup { \halign #2 poco }
808 Certains objets possèdent leurs propres procédures d'alignement, qui
809 annuleront toute spécification d'alignement que vous pourriez leur
810 affecter. La solution consiste alors à déplacer l'intégralité de ces
811 objets @emph{markup}, comme indiqué par exemple au chapitre
812 @ref{Indications textuelles}.
814 @cindex texte, alignement vertical
815 @cindex alignement vertical du texte
824 @c QUERY Should the function of ``\null'' be clarified? rp
826 L'alignement vertical est quant à lui un peu plus compliqué. Comme nous
827 l'avons vu ci-avant, les objets @emph{markup} peuvent être déplacés dans
828 leur intégralité. Il est néanmoins possible de déplacer certains
829 éléments spécifiques au sein d'un bloc @emph{markup}. En pareil cas,
830 l'élément à déplacer doit être précédé d'un @qq{point d'ancrage} -- un
831 autre élément du @emph{markup} ou un objet invisible. L'exemple qui
832 suit illustre ces deux possibilités. Vous noterez par ailleurs que le
833 dernier @emph{markup}, dépourvu de point d'ancrage, n'est de ce fait pas
836 @lilypond[quote,verbatim,relative=1]
839 \raise #2 { Scène 1 }
844 \lower #4 \bold { Très modéré }
848 \raise #4 \italic { Une forêt. }
853 @funindex \general-align
854 @funindex general-align
857 @funindex \translate-scaled
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,relative=1]
868 \translate #'(-1 . 2) "Scène 1"
873 \general-align #Y #3.2 \bold "Très modéré"
878 \translate-scaled #'(-1 . 2) \teeny "Une forêt."
883 @cindex multiligne, markup
884 @cindex markup multiligne
885 @cindex multiligne, texte
886 @cindex texte multiligne
887 @cindex texte en colonnes
888 @cindex colonnes de texte
892 @funindex \center-column
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
922 Pareillement, une liste d'éléments ou d'expressions sera répartie sur
923 une ligne entière, voire même centrée sur toute la page s'il n'y a qu'un
924 seul élément. De telles expressions peuvent à leur tour contenir du
925 texte multiligne ou une autre expression @emph{markup}.
927 @lilypond[quote,verbatim]
930 \line { William S. Gilbert }
932 \huge \smallCaps "The Mikado"
934 \smallCaps "The Town of Titipu"
936 \line { Sir Arthur Sullivan }
944 @cindex plusieurs lignes de texte
945 @cindex justifié, texte
946 @cindex texte justifié
947 @cindex texte sur plusieurs lignes
948 @cindex markup, texte au kilomètre
949 @cindex markup, texte justifié
956 Les indications textuelles, lorsqu'elles sont relativement longues,
957 peuvent se répartir sur plusieurs lignes en fonction de la largeur de
958 ligne. Le texte sera alors soit aligné à gauche, soit justifié, comme
959 le montre l'exemple suivant :
961 @lilypond[quote,verbatim]
964 \line \smallCaps { La vida breve }
965 \line \bold { Acto I }
967 (La escena representa el corral de una casa de
968 gitanos en el Albaicín de Granada. Al fondo una
969 puerta por la que se ve el negro interior de
970 una Fragua, iluminado por los rojos resplandores
975 \line \bold { Acto II }
976 \override #'(line-width . 50)
978 (Calle de Granada. Fachada de la casa de Carmela
979 y su hermano Manuel con grandes ventanas abiertas
980 a través de las que se ve el patio
981 donde se celebra una alegre fiesta)
987 @cindex commandes d'alignement du texte
988 @cindex markup, commandes d'alignement du texte
989 @cindex alignement du texte, commandes
991 Une liste des différentes commandes permettant d'aligner du texte en
992 mode @emph{markup} est disponible à l'annexe @ref{Align}.
995 Manuel d'initiation :
996 @rlearning{Déplacement d'objets}.
1000 @ref{Indications textuelles}.
1002 Fichiers d'initialisation :
1003 @file{scm/define-markup-commands.scm}.
1006 @rlsrnamed{Text,Texte}.
1008 Référence des propriétés internes :
1009 @rinternals{TextScript}.
1012 @node Éléments graphiques dans du texte formaté
1013 @unnumberedsubsubsec Éléments graphiques dans du texte formaté
1014 @translationof Graphic notation inside markup
1016 @cindex graphisme, tracé
1017 @cindex tracé d'objets graphiques
1018 @cindex graphiques, tracé d'objets
1019 @cindex intégration d'objet graphique
1020 @cindex objets graphiques, tracé
1022 Vous pouvez, grâce aux mode @emph{markup}, ajouter divers objets
1023 graphiques à votre partition.
1025 @cindex décoration du texte
1026 @cindex encadrement du texte
1027 @cindex texte, encadrement
1028 @cindex texte, décoration
1029 @cindex markup, ornementation du texte
1030 @cindex markup, encadrement du texte
1036 @funindex \rounded-box
1037 @funindex rounded-box
1043 Certaines commandes de @emph{markup} permettent d'ornementer des
1044 éléments textuels avec des graphismes, à l'instar de l'exemple
1047 @lilypond[quote,verbatim]
1048 \markup \fill-line {
1056 \bracket "1866 - 1925"
1059 \rounded-box \bold Prelude
1064 @cindex espacement autour du texte
1065 @cindex texte et rembourrage
1066 @cindex markup, rembourrage du texte
1068 @funindex \pad-markup
1069 @funindex pad-markup
1072 @funindex \pad-to-box
1073 @funindex pad-to-box
1074 @funindex \pad-around
1075 @funindex pad-around
1077 Certaines directives peuvent nécessiter d'accroître l'espacement autour
1078 du texte -- voir l'annexe @ref{Align} pour une liste des différentes
1079 commandes particulières au mode @emph{markup} ainsi que leur description.
1081 @lilypond[quote,verbatim]
1082 \markup \fill-line {
1084 \box "Charles Ives (1874 - 1954)"
1086 \box \pad-markup #2 "THE UNANSWERED QUESTION"
1087 \box \pad-x #8 "A Cosmic Landscape"
1094 \box \pad-to-box #'(-5 . 20) #'(0 . 5)
1095 \bold "Largo to Presto"
1098 "String quartet keeps very even time,
1099 Flute quartet keeps very uneven time."
1103 @cindex graphisme dans la notation
1104 @cindex symboles non musicaux
1105 @cindex non musicaux, symboles
1106 @cindex notation et graphisme
1110 @funindex \draw-circle
1111 @funindex draw-circle
1112 @funindex \filled-box
1113 @funindex filled-box
1116 @funindex \draw-line
1118 @funindex \arrow-head
1119 @funindex arrow-head
1121 Vous pouvez imprimer certains graphismes ou symboles sans qu'il n'y
1122 ait de texte. Ces objets peuvent même se combiner, à l'instar de
1123 n'importe quelle expression @emph{markup}.
1125 @lilypond[quote,verbatim]
1128 \draw-circle #4 #0.4 ##f
1129 \filled-box #'(-4 . 4) #'(-0.5 . 0.5) #1
1135 \draw-line #'(0 . 4)
1136 \arrow-head #Y #DOWN ##f
1141 @cindex intégration de graphiques
1142 @cindex images, intégration
1143 @cindex graphiques, intégration
1148 @funindex \postscript
1149 @funindex postscript
1151 Des fonctionnalités graphiques avancées vous permettent même d'inclure
1152 dans une partition un fichier image converti au format PostScript
1153 encapsulé (extension @code{eps}), ou bien de tracer un graphique
1154 directement dans le fichier source à partir d'instructions PostScript
1155 pures. Nous vous conseillons, en pareil cas, de toujours spécifier les
1156 dimensions du dessin, comme dans ce qui suit :
1158 @lilypond[quote,verbatim,relative=1]
1161 \epsfile #X #10 #"./context-example.eps"
1162 \with-dimensions #'(0 . 6) #'(0 . 10)
1178 L'annexe @ref{Graphic} répertorie les différentes commandes en matière
1182 Manuel de notation :
1184 @ref{Annotations éditoriales},
1188 Fichiers d'initialisation :
1189 @file{scm/define-markup-commands.scm},
1190 @file{scm/stencil.scm}.
1193 @rlsrnamed{Text,Texte}.
1195 Référence des propriétés internes :
1196 @rinternals{TextScript}.
1199 @node Notation musicale dans du texte formaté
1200 @unnumberedsubsubsec Notation musicale dans du texte formaté
1201 @translationof Music notation inside markup
1203 @cindex notation dans un markup
1204 @cindex musique dans un markup
1205 @cindex markup, inclusion de musique
1207 Divers éléments de notation peuvent orner une partition, au moyen d'un
1208 objet @emph{markup}.
1210 Notes et altérations sont données à l'aide d'instructions
1213 @lilypond[quote,verbatim,relative=2]
1217 \note-by-number #1 #1 #1.5
1220 \natural \semiflat \flat
1221 \sesquiflat \doubleflat
1225 \natural \semisharp \sharp
1226 \sesquisharp \doublesharp
1231 Le mode @emph{markup} permet d'accéder à d'autres objets de
1234 @lilypond[quote,verbatim,relative=1]
1236 ees\finger \markup \tied-lyric #"4~1"
1237 fis_\markup { \dynamic rf }
1248 En règle générale, tout symbole musical peut être inclus dans un
1249 @emph{markup}, comme le montre l'exemple qui suit. Ces différents
1250 symboles sont répertoriés dans l'annexe @ref{La fonte Feta}.
1252 @lilypond[quote,verbatim,relative=2]
1254 c'^\markup { \musicglyph #"eight" }
1256 c,8._\markup { \musicglyph #"clefs.G_change" }
1258 c2^\markup { \musicglyph #"timesig.neomensural94" }
1261 La rubrique @ref{Tout savoir sur les fontes} contient d'autres
1262 informations sur l'impression de glyphes non alphabétiques, tels que des
1263 crochets ou accolades.
1265 Le mode @emph{markup} supporte aussi les diagrammes spécifiques à
1266 certains instruments :
1268 @lilypond[quote,verbatim,relative=2]
1270 \fret-diagram-terse #"x;x;o;2;3;2;"
1273 \harp-pedal #"^-v|--ov^"
1278 \musicglyph #"accordion.discant"
1280 \raise #0.5 \musicglyph #"accordion.dot"
1281 \raise #1.5 \musicglyph #"accordion.dot"
1285 @c The accordion diagram is actually taken from a snippet.
1288 La documentation sur ces diagrammes se trouvent à l'annexe
1289 @ref{Instrument Specific Markup}.
1291 @cindex partition incluse dans un markup
1292 @cindex markup, inclusion de partition
1294 Rien ne s'oppose à ce qu'une étiquette ne comporte une partition. Il
1295 suffit que l'expression en question contienne un bloc @code{\score}
1296 incluant un bloc @code{\layout}.
1298 @lilypond[quote,verbatim,relative=1]
1301 \relative { c'4 d e f }
1309 Les différentes commandes @emph{markup} relatives à la notation musicale
1310 sont répertoriées à l'annexe @ref{Music}.
1313 Manuel de notation :
1315 @ref{La fonte Feta},
1316 @ref{Tout savoir sur les fontes}.
1318 Fichiers d'initialisation :
1319 @file{scm/define-markup-commands.scm},
1320 @file{scm/fret-diagrams.scm},
1321 @file{scm/harp-pedals.scm}.
1324 @rlsrnamed{Text,Texte}.
1326 Référence des propriétés internes :
1327 @rinternals{TextScript}.
1330 @node Texte avec sauts de page
1331 @unnumberedsubsubsec Texte avec sauts de page
1332 @translationof Page wrapping text
1334 @cindex multi-page, markup
1335 @cindex markup multi-page
1336 @cindex markup, texte multi-page
1337 @cindex plusieurs pages de texte
1339 @funindex \markuplist
1340 @funindex markuplist
1341 @funindex \justified-lines
1342 @funindex justified-lines
1343 @funindex \wordwrap-lines
1344 @funindex wordwrap-lines
1346 Alors que @code{\markup} s'utilise pour traiter un bloc de texte
1347 insécable, @code{\markuplist} permet, employé en tête de partition,
1348 d'obtenir un bloc de lignes réparties différemment et, le cas échéant,
1349 sur plusieurs pages.
1352 @lilypond[quote,verbatim]
1355 Un long texte constitué de lignes justifiées.
1359 Un autre grand paragraphe.
1366 Cette syntaxe prend en charge une liste de @emph{markups} ; il peut
1370 d'une suite de commandes générant à leur tour des lignes de texte,
1372 d'une liste de lignes de texte,
1374 d'une liste d'étiquettes.
1377 Les différentes commandes permettant de générer des listes de lignes
1378 se trouve dans l'annexe @ref{Commandes pour liste de markups} (en
1386 Manuel de notation :
1387 @ref{Commandes pour liste de markups}.
1389 Manuel d'extension :
1390 @rextend{Définition d'une nouvelle commande de liste de markups}.
1392 Fichiers d'initialisation :
1393 @file{scm/define-markup-commands.scm}.
1396 @rlsrnamed{Text,Texte}.
1398 Référence des propriétés internes :
1399 @rinternals{TextScript}.
1404 @translationof Fonts
1406 Ce chapitre est consacré aux fontes et polices de caractère, à leur
1407 gestion. Vous y apprendrez aussi comment changer de fonte en cours de
1411 * Tout savoir sur les fontes::
1412 * Attribution d'une fonte en particulier::
1413 * Choix des fontes par défaut::
1417 @node Tout savoir sur les fontes
1418 @unnumberedsubsubsec Tout savoir sur les fontes
1419 @translationof Fonts explained
1422 @cindex fontes, généralités
1423 @cindex accolades, taille
1424 @cindex fontes et markup
1425 @cindex markup et fontes
1427 @funindex font-interface
1429 La gestion des fontes est assurée par plusieurs bibliothèques :
1430 FontConfig se charge de répertorier les différentes fontes installées
1431 sur votre système ; quant à Pango, elle se charge plus
1432 particulièrement de leur rendu.
1434 Les fontes musicales peuvent se décrire comme un jeu de glyphes
1435 spécifiques regroupés dans plusieurs familles. L'exemple qui suit
1436 montre la syntaxe à utiliser pour accéder, en mode @emph{markup}, aux
1437 différentes fontes @code{feta} non textuelles de LilyPond.
1439 @lilypond[quote,verbatim,relative=2]
1442 \override #'(font-encoding . fetaBraces)
1444 \override #'(font-encoding . fetaText)
1446 \override #'(font-encoding . fetaMusic)
1447 \lookup #"noteheads.s0petrucci"
1453 Tous ces glyphes, à l'exception des accolades qui sont regroupées dans
1454 @code{fetaBraces}, sont accessibles avec la syntaxe indiquée dans
1455 @ref{Notation musicale dans du texte formaté}.
1457 Une remarque s'impose au sujet des glyphes contenus dans
1458 @code{fetaBraces} : chacun d'eux est formé du mot @emph{brace}
1459 auquel est accolé un numéro d'ordre. Lorsque vous désirez imprimer une
1460 accolade, vous devez la @qq{chercher} par son numéro d'ordre -- d'où la
1461 fonction @code{\lookup} de l'exemple ci-dessus --, tout en sachant qu'il
1462 est compris entre @code{0} (la plus petite) et @code{575} (la plus
1463 grande). Vous serez souvent amené à procéder par tâtonnement pour
1464 arriver au résultat optimal. Par ailleurs, @code{fetaBraces} ne
1465 comporte que des accolades ouvrantes. Pour obtenir une accolade
1466 fermante, il suffit d'appliquer une rotation au glyphe sélectionné,
1467 comme indiqué à la rubrique @ref{Rotation des objets}.
1469 Vous disposez de trois familles de fontes textuelles : @emph{roman} pour
1470 la police sérif ou avec empattement -- fixée par défaut à New Century
1471 Schoolbook --, une police sans empattement (@emph{sans} sérif) et une à
1472 chasse fixe (monospace ou @emph{typewriter}) -- les deux dernières étant
1473 déterminées par l'installation de Pango.
1475 @warning{Aucune police par défaut n'est associée aux familles
1476 @emph{sans} et @emph{typewriter}. Lorsque l'une d'elles apparaît dans
1477 un fichier source, le résultat peut varier d'un ordinateur à l'autre.
1478 Le résultat sera homogène quelque soit la plateforme dès lors que ces
1479 polices auront été spécifiées par leur nom et qu'elles sont disponibles
1480 pour tout système amené à traiter le fichier. Voir
1481 @ref{Attribution d'une fonte en particulier} et
1482 @ref{Choix des fontes par défaut}.}
1484 Chaque famille dispose en principe de différents styles et niveaux de
1485 gras. L'exemple qui suit illustre la manière de changer la famille, le
1486 style, la graisse ou la taille. Notez bien que l'argument fourni à
1487 @code{font-size} correspond à la correction à apporter à la taille par
1490 @lilypond[quote,verbatim,relative=2]
1491 \override Score.RehearsalMark.font-family = #'typewriter
1492 \mark \markup "Ouverture"
1493 \override Voice.TextScript.font-shape = #'italic
1494 \override Voice.TextScript.font-series = #'bold
1495 d2.^\markup "Allegro"
1496 \override Voice.TextScript.font-size = #-3
1501 Cette syntaxe s'applique aussi en mode @emph{markup}, bien que celui-ci
1502 dispose d'une syntaxe allégée comme nous l'avons vu dans
1503 @ref{Sélection de la fonte et de la taille} :
1505 @lilypond[quote,verbatim]
1509 \override #'(font-shape . italic)
1510 \override #'(font-size . 4)
1514 \override #'(font-family . typewriter)
1516 \override #'(font-series . bold)
1520 \override #'(font-family . sans)
1527 En plus de pouvoir jongler entre les différentes fontes prédéfinies,
1528 LilyPond vous permet d'en utiliser d'autres, ce qui fait l'objet des
1529 deux prochaines parties :
1530 @ref{Attribution d'une fonte en particulier}
1531 et @ref{Choix des fontes par défaut}.
1534 Manuel de notation :
1535 @ref{La fonte Feta},
1536 @ref{Notation musicale dans du texte formaté},
1537 @ref{Rotation des objets},
1538 @ref{Sélection de la fonte et de la taille},
1542 @node Attribution d'une fonte en particulier
1543 @unnumberedsubsubsec Attribution d'une fonte en particulier
1544 @translationof Single entry fonts
1546 Vous pouvez utiliser n'importe quelle police installée sur votre
1547 système, dès lors qu'elle est accessible par Fontconfig et que vous
1548 respectez la syntaxe suivante :
1550 @lilypond[quote,verbatim,relative=2]
1551 \override Staff.TimeSignature.font-name = #"Bitstream Charter"
1552 \override Staff.TimeSignature.font-size = #2
1556 \override #'(font-name . "Vera Bold")
1561 @cindex fontes disponibles
1562 @cindex disponibilité des fontes
1564 @funindex show-available-fonts
1566 LilyPond, lancé avec l'option suivante, affiche la liste de toutes
1567 les polices disponibles sur votre machine :
1570 lilypond -dshow-available-fonts toto
1573 (quel qu'il soit, le dernier argument est obligatoire).
1576 Manuel de notation :
1577 @ref{Tout savoir sur les fontes},
1578 @ref{Choix des fontes par défaut}.
1581 @rlsrnamed{Text,Texte}.
1583 @c A source file gets never installed...
1584 @c Fichiers d'initialisation :
1585 @c @file{lily/font-config-scheme.cc}.
1588 @node Choix des fontes par défaut
1589 @unnumberedsubsubsec Choix des fontes par défaut
1590 @translationof Entire document fonts
1592 Vous pouvez tout à fait préférer un autre jeu de polices par défaut que
1593 celui de LilyPond. Il vous faudra alors spécifier les différentes
1594 familles, en respectant l'ordre @emph{roman}, @emph{sans empattement} et
1595 @emph{monospace}, comme dans l'exemple suivant ; ces fontes seront
1596 automatiquement mises à l'échelle de la taille globale des
1597 portées. Pour plus d'explications sur les fontes, relisez
1598 @ref{Tout savoir sur les fontes}.
1600 @cindex polices, choix par défaut
1601 @cindex fontes, choix par défaut
1603 @funindex make-pango-font-tree
1605 @lilypond[verbatim,quote]
1608 (make-pango-font-tree "Times New Roman"
1611 (/ staff-height pt 20)))
1618 \typewriter typewriter. }
1622 @c we don't do Helvetica / Courier, since GS incorrectly loads
1626 Manuel de notation :
1627 @ref{Tout savoir sur les fontes},
1628 @ref{Attribution d'une fonte en particulier},
1629 @ref{Sélection de la fonte et de la taille},