]> git.donarmstrong.com Git - lilypond.git/blob - Documentation/fr/notation/text.itely
Docs: reorganize documentation directory structure
[lilypond.git] / Documentation / fr / notation / text.itely
1 @c -*- coding: utf-8; mode: texinfo; -*-
2 @ignore
3     Translation of GIT committish: bdf8540b74167817eab96ed3d13b35477217f9fe
4
5     When revising a translation, copy the HEAD committish of the
6     version that you are working on.  See TRANSLATION for details.
7 @end ignore
8
9 @c \version "2.12.0"
10
11 @c Translators: Jean-Charles Malahieude
12 @c Translation checkers: Valentin Villenave, John Mandereau
13
14 @node Text
15 @section Text
16
17 @lilypondfile[quote]{text-headword.ly}
18
19 Nous allons voir ici comment insérer dans une partition du texte, avec
20 différentes possibilité de formatage.
21
22 @cindex Texte, autres langues
23 Pour écrire des accents et autres caractères spéciaux, il suffit de
24 les insérer directement dans votre fichier LilyPond.  Ce fichier devra
25 être sauvegardé avec l'encodage UTF-8.  Pour plus d'informations, voir
26 @ref{Text encoding}.
27
28 @menu
29 * Writing text::                
30 * Formatting text::             
31 * Fonts::                       
32 @end menu
33
34
35 @node Writing text
36 @subsection Writing text
37
38 @menu
39 * Text scripts::                
40 * Text and line spanners::      
41 * Text spanners::               
42 * Text marks::                  
43 @end menu
44
45 @node Text scripts
46 @unnumberedsubsubsec Text scripts
47
48 @c I'm not fond of this "étiquette" wording of yours Jean-Charles;
49 @c j'utiliserais simplement l'expression "bloc \markup" afin
50 @c d'éviter toute confusion avec les \tags (qui méritent davantage
51 @c le titre d'étiquette, stricto sensu) -vv
52
53 @cindex Étiquette de texte
54 @cindex blocs de texte
55 @cindex ajout de texte
56
57 Vous pouvez placer arbitrairement des chaînes de caractères, ou
58 @ref{Formatting text} en langage LilyPond, au dessus ou au dessous des
59 notes en employant la syntaxe @code{c^"text"}.  Par défaut, ces
60 indications n'affecteront en rien l'espacement des notes, sauf à
61 utiliser la commande @code{\textLengthOn}.
62
63 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
64 c4^"longtext" \textLengthOn c4_"longlongtext" c4
65 @end lilypond
66
67 @noindent
68 Pour revenir à l'espacement par défaut, utilisez @code{\textLengthOff}.
69
70 Des constructions plus élaborées d'étiquette peuvent être obtenues en
71 ayant recours à la commande @emph{markup} :
72
73 @lilypond[fragment,ragged-right,verbatim,quote]
74 c'4^\markup { bla \bold bla }
75 @end lilypond
76
77 La commande @code{\markup} est décrite plus en détails dans la section
78 @ref{Formatting text}.
79
80
81 @predefined
82 @funindex \textLengthOn
83 @code{\textLengthOn},
84 @funindex \textLengthOff
85 @code{\textLengthOff}.
86 @endpredefined
87
88
89 @commonprop
90
91 S'assurer que tous les éléments textuels et les paroles respectent
92 les marges du document requiert des calculs relativement lourds ; c'est
93 la raison pour laquelle LilyPond, par défaut, ne s'en préoccupe pas.
94 Vous pouvez cependant l'y forcer en définissant
95
96 @example
97 \override Score.PaperColumn #'keep-inside-line = ##t
98 @end example
99
100
101 @seealso
102 Dans ce manuel : @ref{Formatting text}.
103
104 Référence du programme : @rinternals{TextScript}.
105
106
107 @node Text and line spanners
108 @unnumberedsubsubsec Text and line spanners
109
110 Certaines indications d'interprétation comme @i{rallentando}, 
111 @i{accelerando} ou @i{trilles}, s'incrivent textuellement et se
112 prolongent sur plusieurs mesures à l'aide d'une ligne pleine, pointillée
113 ou ondulée.
114
115 Les routines chargées de matérialiser un @emph{glissando} sont tout à
116 fait adaptées à une gestion précise, à la fois du placement du texte, et
117 du calcul de l'envergure de sa ligne d'extension.  La routine
118 @code{ly:line-interface::print} est plus particulièrement en charge de
119 déterminer les points d'ancrage de la ligne et de la dessiner selon le
120 style requis.
121   
122 Voici un exemple qui illustre les différents styles de ligne
123 disponibles, ainsi que la manière de les personnaliser.
124
125 @lilypond[relative=2,ragged-right,verbatim,fragment]
126 d2 \glissando d'2
127 \once \override Glissando #'style = #'dashed-line
128 d,2 \glissando d'2
129 \override Glissando #'style = #'dotted-line
130 d,2 \glissando d'2
131 \override Glissando #'style = #'zigzag
132 d,2 \glissando d'2
133 \override Glissando #'style = #'trill
134 d,2 \glissando d'2
135 @end lilypond
136
137 L'information qui va déterminer les extrémités est calculée à la
138 volée pour chaque objet graphique.  Il est tout à fait possible de les
139 régler vous-même :
140
141 @lilypond[relative=2,ragged-right,verbatim,fragment]
142 e2 \glissando f
143 \once \override Glissando #'(bound-details right Y) = #-2
144 e2 \glissando f
145 @end lilypond
146
147 L'objet @code{Glissando}, comme tous ceux qui utilisent la routine
148 @code{ly:line-interface::print}, comporte une liste 
149 d'associations.  Dans le code ci-dessus, la valeur de @code{Y} est
150 fixée, dans la liste d'associations, à @code{-2} pour l'ancrage à
151 droite.  Vous pouvez naturellement ajuster l'extrémité gauche en
152 remplaçant @code{right} (pour @code{droite}) par @code{left}.
153
154 Si @code{Y} n'est pas fixé, sa valeur sera calculée en fonction de la
155 hauteur du point de référence droite de la ligne.
156
157 Lorsque survient un saut de ligne, la liste des ancrages est
158 augmentée d'une liste complémentaire contenant @code{left-broken}
159 (brisure à gauche) et @code{right-broken} (brisure à droite), comme
160 dans l'exemple suivant :
161
162 @lilypond[relative=2,ragged-right,verbatim,fragment]
163 \override Glissando #'breakable = ##T 
164 \override Glissando #'(bound-details right-broken Y) = #-3
165 c1 \glissando \break
166 f1
167 @end lilypond
168
169 Vous disposez des propriétés suivantes :
170
171 @table @code
172 @item Y
173 Fixe l'ordonnée (coordonnée-Y) de l'extrémité, mesurée en taille de
174 portée.  Il s'agit par défaut du centre de l'objet de rattachement ;
175 pour un glissando, ce sera le milieu de la tête de note.
176
177 Pour des marques horizontales, telles du texte ou le trait d'un
178 trille, cette valeur est figée à 0.
179
180 @item attach-dir
181 Détermine l'endroit où la ligne commence et finit, relativement à
182 l'objet de rattachement. Autrement dit, une valeur de @code{-1} (ou
183 @code{LEFT} pour gauche) fera commencer ou finir la ligne du côté
184 gauche de la tête de note de référence.
185
186 @item X
187 Coordonnée absolue du point final. Dans la mesure où elle est calculée
188 à la volée, il n'y a pas vraiment de raison de l'outrepasser.
189
190 @item stencil
191 Sous-propriété contenant les éventuels symboles présents avant ou
192 après la ligne. Destinée à un usage interne, nous vous recommendons
193 d'utiliser plutôt @code{text}.
194
195 @item text
196 Marqueur qui sera analysé pour alimenter @code{stencil}.  On y trouve
197 habituellement les @i{cresc.} ou @i{tr} des extenseurs horizontaux.
198
199 @lilypond[quote,ragged-right,fragment,relative=2,verbatim]
200 \override TextSpanner #'(bound-details left text)
201    = \markup { \small \bold Slower }
202 c2\startTextSpan b c a\stopTextSpan
203 @end lilypond
204
205 @item stencil-align-dir-y
206 @item stencil-offset
207 Lorsqu'ils ne sont pas définis, le tracé est tout simplement
208 positionné conformément aux sous-propriétés @code{X} et @code{Y}.  En
209 fixant soit @code{stencil-align-dir-y}, soit @code{stencil-offset},
210 vous pouvez décaler le coin du marqueur par rapport à l'extrémité de
211 la ligne.
212
213 @lilypond[relative=1,fragment,verbatim]
214 \override TextSpanner #'(bound-details left stencil-align-dir-y) = #DOWN
215 \override TextSpanner #'(bound-details right stencil-align-dir-y) = #UP
216
217 \override TextSpanner #'(bound-details left text) = #"gggg"
218 \override TextSpanner #'(bound-details right text) = #"hhhh"
219 c4^\startTextSpan c c c \stopTextSpan
220 @end lilypond
221
222 @item arrow
223 Assigner à cette sous-propriété la valeur @code{vrai} (@code{#t})
224 produira une terminaison en pointe de flèche.
225
226 @item padding
227 Cette sous-propriété contrôle l'espace entre les extrémités de la
228 ligne, telles que définies, et la réalité.  Sans ce léger décalage, le
229 début et la fin d'un glissando seraient en plein milieu des têtes de note.
230
231 @end table
232
233
234 @seealso
235 Référence du programme : @rinternals{TextSpanner},
236 @rinternals{Glissando}, @rinternals{VoiceFollower},
237 @rinternals{TrillSpanner}, @rinternals{line-spanner-interface}.
238
239 Exemples : @rlsr{Expressive marks}.
240
241
242 @node Text spanners
243 @unnumberedsubsubsec Text spanners
244
245 @cindex Prolongateurs de texte
246
247 Certaines indications d'interprétation comme @i{rallentando} ou 
248 @i{accelerando} s'incrivent en toutes lettres et se prolongent sur
249 plusieurs mesures grâce à une ligne pointillée.  Les commandes
250 @code{\startTextSpan} et @code{\stopTextSpan}, respectivement
251 attachées à la première et à la dernière note qu'elles concernent,
252 déterminent l'envergure de ces prolongateurs, ou extenseurs.
253
254 La chaîne à imprimer, ainsi que son style, sont définis par des
255 propriétés, comme ici :
256
257 @lilypond[quote,ragged-right,fragment,relative=1,verbatim]
258 c1
259 \textSpannerDown
260 \override TextSpanner #'(bound-details left text) =
261   \markup { \upright "rall" } 
262 c2\startTextSpan b c\stopTextSpan a
263 \break
264 \textSpannerUp
265 \override TextSpanner #'(bound-details left text) =
266   \markup { \italic "rit" } 
267 c2\startTextSpan b c\stopTextSpan a
268 @end lilypond
269
270
271 @predefined
272 @funindex textSpannerUp
273 @code{\textSpannerUp},
274 @funindex textSpannerDown
275 @code{\textSpannerDown},
276 @funindex textSpannerNeutral
277 @code{\textSpannerNeutral}.
278 @endpredefined
279
280
281 @commonprop
282
283 Pour obtenir une ligne pleine, utilisez
284
285 @example
286 \override TextSpanner #'style = #'line
287 @end example
288
289
290 @seealso
291 Référence du programme : @rinternals{TextSpanner}.
292
293
294 @node Text marks
295 @unnumberedsubsubsec Text marks
296
297 @cindex coda sur une barre de mesure
298 @cindex segno sur une barre de mesure
299 @cindex point d'orgue sur une barre de mesure
300 @cindex barres de mesure, symboles au dessus de
301 @funindex \mark
302
303 La commande @code{\mark} est tout d'abord conçue pour les
304 @ref{Rehearsal marks}.  Elle peut néanmoins servir à insérer des
305 signes de coda ou de segno, ou bien un point d'orgue, au dessus d'une
306 barre de mesure.  Couplez-la alors à la commande @code{\markup} pour
307 avoir accès au symbole approprié (ils sont répertoriés dans 
308 @ref{The Feta font}).
309
310
311 @lilypond[fragment,quote,ragged-right,verbatim,relative=2]
312 c1 \mark \markup { \musicglyph #"scripts.ufermata" }
313 c1
314 @end lilypond
315
316 @noindent
317 Le résultat de @code{\mark} n'apparaîtra que sur la portée supérieure
318 d'un système.  Si vous introduisez la commande @code{\mark} au moment
319 d'une barre de mesure, la marque se placera au dessus de la barre.  Si
320 vous y faites appel au milieu d'une mesure, cette marque sera
321 positionnée entre les notes.  Si elle intervient en début de ligne,
322 elle sera placée juste avant la première note de cette portée.  Enfin,
323 une marque qui tomberait sur un saut de ligne sera imprimée au début
324 de la ligne suivante.
325 @c  IMO this is a bug; hopefully it'll be fixed soon, so I can
326 @c  delete this sentence.   -gp
327 Au cas où il n'y aurait pas de ligne à suivre, la marque ne sera pas imprimée.
328
329
330 @commonprop
331
332 Pour imprimer une marque à la fin de la portée en cours, procédez
333 ainsi :
334
335 @example
336 \override Score.RehearsalMark
337   #'break-visibility = #begin-of-line-invisible
338 @end example
339
340 @code{\mark} est souvent bien utile pour porter une indication à la
341 fin d'une mesure.  Pensez alors à modifier la propriété
342 @code{#'self-alignment}.  
343
344 @lilypond[fragment,quote,ragged-right,verbatim,relative=2]
345 \override Score.RehearsalMark
346   #'break-visibility = #begin-of-line-invisible
347 c1 c c c4 c c c
348 \once \override Score.RehearsalMark #'self-alignment-X = #right
349 \mark "D.S. al Fine "
350 @end lilypond
351
352 Les indications textuelles peuvent s'aligner par rapport à d'autres
353 objets que des barres de mesure, tels que l'armure, la clé ou le chiffre de
354 mesure : 
355
356 @lilypond[fragment,quote,ragged-right,verbatim,relative=2]
357 \relative {
358   c1
359   \key cis \major
360   \clef alto
361   \override Score.RehearsalMark #'break-align-symbols = #'(key-signature)
362   \mark "on key"
363   cis
364   \key ces \major
365   \override Score.RehearsalMark #'break-align-symbols = #'(clef)
366   \clef treble
367   \mark "on clef"
368   ces
369   \override Score.RehearsalMark #'break-align-symbols = #'(time-signature)
370   \key d \minor
371   \clef tenor
372   \time 3/4
373   \mark "on time"
374   c
375 }
376 @end lilypond
377
378 Les symboles pris en charge par @code{break-align-symbols} sont :
379 @code{ambitus}, @code{breathing-sign}, @code{clef}, @code{custos},
380 @code{staff-bar}, @code{left-edge}, @code{key-cancellation},
381 @code{key-signature}, et @code{time-signature}.
382
383 Par défaut, les indications textuelles sont alignées avec le milieu
384 des objets de notation. Bien entendu, vous pouvez modifier les
385 propriétés @code{break-align-anchor-alignment} ou
386 @code{break-align-anchor} des objets en question pour obtenir un autre
387 résultat.
388
389 @c KEEP LY
390 @lilypond[fragment,quote,ragged-right,verbatim]
391 {
392   \override Score.RehearsalMark #'break-align-symbols = #'(key-signature)
393   c1
394   \key cis \major
395
396   % La marque sera alignée sur le côté gauche de l'armure
397   \once \override Staff.KeySignature #'break-align-anchor-alignment = #LEFT
398   \mark \default
399   cis1
400   \key ces \major
401
402   % La marque sera alignée sur le côté droit de l'armure
403   \once \override Staff.KeySignature #'break-align-anchor-alignment = #RIGHT
404   \mark \default
405   ces1
406   \key cis \major
407
408   %  La marque sera alignée sur le côté gauche de l'armure,
409   % puis décalée vers la droite de 2 unités.
410   \once \override Staff.KeySignature #'break-align-anchor = #2
411   \mark \default
412   ces1
413 }
414 @end lilypond
415
416 Bien que ces indications textuelles ne soient habituellement imprimées
417 qu'au niveau de la portée supérieure, vous pouvez forcer leur
418 affectation à chacune des portées :
419
420 @lilypond[quote,ragged-right,verbatim,relative=2]
421 {
422   \new Score \with {
423     \remove "Mark_engraver"
424   }
425   <<
426     \new Staff \with {
427       \consists "Mark_engraver"
428     }
429     { c''1 \mark "foo" c'' }
430     \new Staff \with {
431       \consists "Mark_engraver"
432     }
433     { c'1 \mark "foo" c' }
434   >>
435 }
436 @end lilypond
437
438
439 @seealso
440 Référence du programme : @rinternals{RehearsalMark}.
441
442
443 @node Formatting text
444 @subsection Formatting text
445
446 @menu
447 * Text markup introduction::    
448 * Nested scores::               
449 * Page wrapping text::          
450 @end menu
451
452 @node Text markup introduction
453 @unnumberedsubsubsec Text markup introduction
454
455 @cindex étiquette
456 @cindex commentaire textuel
457 @cindex étiquette textuelle
458 @cindex texte ajouté
459
460 La commande @code{\markup} permet d'ajouter du texte.  Vous pouvez y
461 inclure des commandes, précédées d'un antislash @code{\} ; les
462 caractères @code{\} et @code{#} doivent être encadrés de guillemets
463 informatiques @code{"}.
464
465 @lilypond[quote,verbatim,fragment,relative=1]
466 c1^\markup { hello }
467 c1_\markup { hi there }
468 c1^\markup { hi \bold there, is \italic {anyone home?} }
469 c1_\markup { "\special {weird} #characters" }
470 @end lilypond
471
472 @noindent
473 Pour une liste des différentes commandes disponibles, consultez
474 @ref{Text markup commands}. 
475
476
477 @code{\markup} est avant tout conçu pour gérer les
478 @rinternals{TextScript}s, mais rien ne s'oppose à son utilisation
479 pour traiter du texte avec LilyPond.
480
481 @lilypond[quote,verbatim]
482 \header{ title = \markup{ \bold { foo \italic { bar! } } } }
483 \score{
484   \relative c'' {
485     \override Score.RehearsalMark
486       #'break-visibility = #begin-of-line-invisible
487     \override Score.RehearsalMark #'self-alignment-X = #right
488
489     \set Staff.instrumentName = \markup{ \column{ Alto solo } }
490     c2^\markup{ don't be \flat }
491     \override TextSpanner #'(bound-details left text) = \markup{\italic rit }
492     b2\startTextSpan
493     a2\mark \markup{ \large \bold Fine }
494     r2\stopTextSpan
495     \bar "||"
496   }
497   \addlyrics { bar, foo \markup{ \italic bar! } }
498 }
499 @end lilypond
500
501 La commande @code{\markup} peut intervenir à tout moment, y compris en
502 dehors d'un bloc @code{\score}. Voir à ce sujet 
503 @ref{Multiple scores in a book}. 
504
505 @lilypond[quote,ragged-right,verbatim]
506 \markup{ Here is some text. }
507 @end lilypond
508
509 @cindex changer de police
510
511 Le @emph{markup} de l'exemple précédent montre comment utiliser les
512 commandes de changement de police. Les commandes @code{\bold} et
513 @code{\italic} n'affectent que le premier mot qui les suit ; encadrez
514 les par des accolades si vous désirez que ces commandent s'appliquent
515 à plusieurs mots.
516
517 @example
518 \markup @{ \bold @{ c'est moi @} @}
519 @end example
520
521 @noindent
522 Une bonne habitude à prendre consiste à utiliser des accolades même
523 pour un seul mot, comme ici :
524 @example
525 \markup @{ qui \italic @{ est @} là ? @}
526 @end example
527
528 En mode @emph{markup}, vous pouvez composer des expressions comme
529 en mathématiques, des documents XML ou bien les expressions musicales.
530 Vous pouvez empiler ces expressions grâce à la commande
531 @code{\column}, ou les centrer par rapport à leur milieu avec
532 @code{\center-column}. 
533
534 @lilypond[quote,verbatim,fragment,relative=1]
535 c1^\markup { \column { a bbbb \line { c d } } }
536 c1^\markup { \center-column { a bbbb c } }
537 c1^\markup { \line { a b c } }
538 @end lilypond
539
540 Des listes non précédées de commande ne sont pas isolées. Ainsi, 
541 @example
542 \center-column @{ @{ a b @} @{ c d @} @}
543 @end example
544
545 @noindent
546
547 est la même expression que
548
549 @example
550 \center-column @{ a b c d @}
551 @end example
552
553 @noindent
554
555 L'utilisation des @code{"} ou de la commande @code{\line} permet de
556 différencier les listes de mots.
557
558 @lilypond[quote,verbatim,fragment,relative=1]
559 \textLengthOn
560 c4^\markup{ \center-column { on three lines } }
561 c4^\markup{ \center-column { "all one line" } }
562 c4^\markup{ \center-column { { on three lines } } }
563 c4^\markup{ \center-column { \line { on one line } } }
564 @end lilypond
565
566 Vous pouvez stocker les étiquettes textuelles en tant que variables,
567 et attacher ces identificateurs à des notes, comme
568 @example
569 allegro = \markup @{ \bold \large @{ Allegro @} @}
570  @{ a^\allegro b c d @}
571 @end example
572
573 Certains objets possèdent leurs propres procédures d'alignement, qui
574 annuleront toute spécification d'alignement que vous pourriez affecter
575 à un argument de type @emph{markup} que vous leur auriez fourni.  Par
576 exemple, les @rinternals{RehearsalMark} sont centrées
577 horizontalement ; de fait, utiliser 
578 @code{\mark \markup @{ \left-align .. @}} sera sans effet.
579
580 Par ailleurs, le placement vertical n'est effectué qu'après la
581 création de l'objet @emph{étiquette textuelle}. Si donc vous souhaitez
582 déplacer une étiquette, il vous faudra utiliser la propriété
583 @code{#'padding} ou créer un @qq{point d'ancrage} à l'intérieur même
584 de l'étiquette (généralement avec @code{\hspace #0}).
585
586 @lilypond[quote,verbatim,fragment,relative=1]
587 \textLengthOn
588 c'4^\markup{ \raise #5 "not raised" }
589 \once \override TextScript #'padding = #3
590 c'4^\markup{ raised }
591 c'4^\markup{ \hspace #0 \raise #1.5 raised }
592 @end lilypond
593
594 Certaines situations particulières, telles que les indications de
595 nuance, possèdent des propriétés prédéfinies quant à leur police.
596 Nous vous conseillons, en pareil cas, de réinitialiser ces propriétés
597 en utilisant @code{normal-text}.  Pour plus d'informations, consultez
598 @ref{Text markup commands}. 
599
600
601 @seealso
602 Dans ce manuel : @ref{Text markup commands}.
603
604 Référence du programme : @rinternals{TextScript}.
605
606 Fichiers d'initialisation : @file{scm/@/new@/-markup@/.scm}.
607
608
609 @knownissues
610
611 Le crénage ou la génération de ligatures ne sont accessibles que lors
612 d'un retraitement par @TeX{}.  Dans ce cas, LilyPond n'en tient pas
613 compte, et l'espacement de tels textes sera trop large.
614
615 Les erreurs de syntaxe sont peu loquaces.
616
617
618 @node Nested scores
619 @unnumberedsubsubsec Nested scores
620
621 Rien ne s'oppose à ce qu'une étiquette ne comporte de la musique.  Il
622 suffit que l'expression en question contienne un bloc @code{\score} et
623 un bloc @code{\layout}.
624
625 @lilypond[quote,verbatim,ragged-right]
626 \relative {
627   c4 d^\markup {
628     \score {
629       \relative { c4 d e f }
630       \layout { }
631     }
632   }
633   e f
634 }
635 @end lilypond
636
637 @node Page wrapping text
638 @unnumberedsubsubsec Page wrapping text
639 Alors que @code{\markup} s'utilise pour traiter un bloc de texte
640 insécable, @code{\markuplines} permet, employé en tête de partition,
641 d'obtenir un bloc de lignes réparties différemment et au cas où sur
642 plusieurs pages.
643
644 @verbatim
645 \markuplines {
646   \justified-lines {
647     Un long texte constitué de lignes justifiées.
648     ...
649   }
650   \justified-lines {
651     Un autre grand paragraphe justifié.
652     ...
653   }
654   ...
655 }
656 @end verbatim
657
658 @code{\markuplines} prend en argument une liste de lignes de texte,
659 qui peut elle-même consister en une suite de commandes générant à leur
660 tour des lignes de texte, comme ici :
661
662 @verbatim
663 \markuplines {
664   \line { ... }    % une ligne alignée à gauche
665   \fill-line { \line { ... } } % une ligne centrée
666   \wordwrap-lines { ... } % une liste de lignes alignées à gauche
667   \justified-lines { ... } % une liste de lignes justifiées
668 }
669 @end verbatim
670
671 Les différentes commandes permettant de générer des listes de lignes
672 se trouve dans @ref{Text markup list commands}.
673
674
675 @seealso
676 Dans ce manuel : @ref{Text markup list commands}, 
677 @ref{New markup list command definition}.
678
679
680 @predefined
681 @funindex \markuplines
682 @code{\markuplines}.
683 @endpredefined
684
685
686 @node Fonts
687 @subsection Fonts
688
689 @cindex sélection de polices
690 @cindex grossissement des polices
691 @funindex font-interface
692
693 C'est en jouant sur les propriétés des objets décrites ci-après que
694 vous pourrez sélectionner une police parmi les familles de fontes
695 préconfigurées.  LilyPond utilise par défaut la police musicale feta.
696 Pour le texte, les polices sont sélectionnées par Pango/Fontconfig.
697 C'est New Century Schoolbook qui sert de police sérif par défaut, et
698 celles définies lors de l'installation de Pango pour ce qui est du
699 sans-serif et du @q{typewriter}.
700
701
702 @itemize @bullet
703 @item @code{font-encoding}
704 symbolise le tracé des glyphes. N'utilisez cette propriété que pour
705 traiter des éléments non textuels, comme :
706
707
708 @code{fetaBraces} pour les accolades de partition pianistique,
709 @code{fetaMusic} pour de la musique (y compris musique ancienne),
710 @code{fetaDynamic} pour les nuances et @code{fetaNumber} pour les
711 chiffres. 
712
713 @item @code{font-family}
714 symbolise les différentes familles de police : @code{roman} (Computer
715 Modern), @code{sans}-serif et @code{typewriter} (espacement fixe).
716
717 @item @code{font-shape}
718 symbolise le style des caractères. En pratique, chaque famille de
719 police dispose de @code{italic}, @code{caps} (petites capitales) ou
720 @code{upright} (droit).
721
722 @item @code{font-series}
723 symbolise le niveau de gras des caractères. Chaque style dispose, pour
724 chaque famille, de @code{medium} et @code{bold} (gras).
725
726 @end itemize
727
728 Les variantes ci-dessus mentionnées font référence à une feuille de
729 style prédéfinie.  Vous pouvez cependant faire appel à une autre
730 police, en utilisant la propriété @code{font-name} :
731
732 @lilypond[fragment,verbatim]
733 {
734   \override Staff.TimeSignature #'font-name = #"Charter"
735   \override Staff.TimeSignature #'font-size = #2
736   \time 3/4
737   c'1_\markup {
738     \override #'(font-name . "Vera Bold")
739       { This text is in Vera Bold }
740   }
741 }
742 @end lilypond
743
744 @noindent
745 Vous pouvez utiliser n'importe quelle police, du moment qu'elle est
746 accessible par Pango/Fontconfig.  Pour obtenir la liste de toutes
747 les polices disponibles sur votre machine, lancez
748 @example
749 lilypond -dshow-available-fonts blabla
750 @end example
751 (quel qu'il soit, le dernier argument est obligatoire).
752
753
754 La propriété @code{font-size} permet de régler la taille de la police.
755 La taille effective que vous obtiendrez dépend de
756 @code{text-font-size} tel que défini dans le bloc @code{\paper}.
757
758 @cindex taille de police
759 @cindex police, augmenter la taille
760
761
762 Vous pouvez aussi changer la police par défaut au niveau du document.
763 Il suffit alors de faire appel à @code{make-pango-font-tree} au sein
764 du bloc @code{paper}.  Vous définirez alors la police à utiliser pour
765 du texte respectivement en roman, sans serif et monospace, comme ici : 
766
767 @cindex polices, définir 
768 @cindex Pango
769
770
771 @lilypond[verbatim]
772 \paper  {
773   myStaffSize = #20
774
775   #(define fonts
776     (make-pango-font-tree "Times New Roman"
777                           "Nimbus Sans"
778                           "Luxi Mono"
779                            (/ myStaffSize 20)))
780 }
781
782 {
783   c'^\markup { roman: foo \sans bla \typewriter bar }
784 }
785 @end lilypond
786
787 @c we don't do Helvetica / Courier, since GS incorrectly loads
788 @c Apple TTF fonts
789
790
791 @seealso
792 Exemples : @rlsr{Text}.
793