@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
@ignore
- Translation of GIT committish: 548ef200973bd3d46ea75c5498461d9e5f168334
+ Translation of GIT committish: a06cb0b0d9593ba110e001f2b0f44b8bef084693
When revising a translation, copy the HEAD committish of the
version that you are working on. For details, see the Contributors'
@lilypondfile[quote]{text-headword.ly}
-Nous allons voir ici comment insérer du texte dans une partition, ainsi que
-différentes manières de le mettre en forme.
+Nous allons voir ici comment insérer du texte dans une partition, ainsi
+que différentes manières de le mettre en forme.
@noindent
Certains éléments de texte ne sont pas abordés ici mais dans des
-chapitres qui leur sont dédiés. C'est le cas de la
+chapitres qui leur sont dédiés. C'est le cas de la
@ref{Musique vocale} et des @ref{Titres et entêtes}.
@menu
-* Ajout de texte::
-* Mise en forme du texte::
-* Fontes::
+* Ajout de texte::
+* Mise en forme du texte::
+* Fontes::
@end menu
@node Ajout de texte
d'ajouter du texte à une partition.
@cindex Texte, autres langues
-@warning{Pour écrire des accents et autres caractères spéciaux, il suffit de
-les insérer directement dans votre fichier LilyPond. Ce fichier devra
-être sauvegardé avec l'encodage UTF-8. Pour plus d'informations, voir
-@ref{Codage du texte}.}
+@warning{Pour écrire des accents et autres caractères spéciaux, il
+suffit de les insérer directement dans votre fichier LilyPond. Ce
+fichier devra être sauvegardé avec l'encodage UTF-8. Pour plus
+d'informations, voir @ref{Codage du texte}.}
@menu
-* Commentaires textuels::
-* Indications textuelles et lignes d'extension::
-* Indications textuelles::
-* Texte indépendant::
+* Commentaires textuels::
+* Indication textuelle avec extension::
+* Indications textuelles::
+* Texte indépendant::
@end menu
@node Commentaires textuels
Vous pouvez ajouter à une partition des indications sous forme texuelle,
comme dans l'exemple suivant. Ces indications se placeront manuellement
-au-dessus ou au-dessous de la portée selon la syntaxe utilisée -- cf.
+au-dessus ou au-dessous de la portée selon la syntaxe utilisée -- cf.
@ref{Direction et positionnement}.
@lilypond[quote,verbatim,relative=2]
Cette syntaxe est en fait un raccourci. Des constructions plus
élaborées d'annotation peuvent être obtenues en ayant recours à un bloc
-@code{\markup} et selon les préceptes énoncés dans
+@code{\markup} et selon les préceptes énoncés dans
@ref{Mise en forme du texte}.
@lilypond[quote,verbatim,relative=2]
@end lilypond
Par défaut, ces indications n'affectent en rien l'espacement des
-notes. Leur longueur peut néanmoins être prise en considération : dans
-l'exemple qui suit, le premier commentaire n'influe pas sur
+notes. Leur longueur peut néanmoins être prise en considération@tie{}:
+dans l'exemple qui suit, le premier commentaire n'influe pas sur
l'espacement, à l'inverse du second.
@lilypond[quote,verbatim,relative=2]
a4_"scherzando" f
@end lilypond
+En plus d'indications textuelles, les notes peuvent se voir attacher des
+articulations, comme indiqué au chapitre
+@ref{Articulations et ornements}.
+
+Pour de plus amples détails sur la manière de combiner indications
+textuelles et articulations, reportez-vous au chapitre
+@rlearning{Positionnement des objets}.
@funindex \textLengthOn
@funindex textLengthOn
@seealso
+Manuel d'initiation :
+@rlearning{Positionnement des objets}.
+
Manuel de notation :
@ref{Mise en forme du texte},
@ref{Direction et positionnement}.
Morceaux choisis :
-@rlsr{Text}.
+@rlsrnamed{Text,Texte}.
Référence des propriétés internes :
@rinternals{TextScript}.
@knownissues
S'assurer que tous les éléments textuels et les paroles respectent
-les marges du document requiert des calculs relativement lourds ; c'est
-la raison pour laquelle LilyPond, par défaut, ne s'en préoccupe pas.
-Vous pouvez cependant l'y forcer en définissant
+les marges du document requiert des calculs relativement lourds@tie{};
+c'est la raison pour laquelle LilyPond, par défaut, ne s'en préoccupe
+pas. Vous pouvez cependant l'y forcer en définissant
@example
\override Score.PaperColumn #'keep-inside-line = ##t
@end example
-@node Indications textuelles et lignes d'extension
-@unnumberedsubsubsec Indications textuelles et lignes d'extension
+@node Indication textuelle avec extension
+@unnumberedsubsubsec Indication textuelle avec extension
@translationof Text spanners
@cindex texte et extenseur
@cindex prolongation de texte
@cindex extenseur
-Certaines indications d'interprétation comme @i{rallentando},
-@i{accelerando} ou @i{trilles}, s'incrivent textuellement et se
+Certaines indications d'interprétation comme @i{rallentando},
+@i{accelerando} ou @i{trilles}, s'inscrivent textuellement et se
prolongent sur plusieurs notes à l'aide d'une ligne pleine, pointillée
ou ondulée. Ces objets, que l'on appelle @qq{extenseurs}, se dessinent
-entre deux notes à l'aide de la syntaxe suivante :
+entre deux notes à l'aide de la syntaxe suivante@tie{}:
@lilypond[verbatim,quote,relative=2]
\override TextSpanner #'(bound-details left text) = "rit."
@noindent
Le texte à imprimer est spécifié en tant que propriété de l'objet
-@code{TextSpanner}. Il apparaîtra par défaut en italique ; cependant,
-rien ne s'oppose à un autre graphisme dès lors que vous faites appel à
-un bloc @code{\markup} -- voir @ref{Mise en forme du texte}.
+@code{TextSpanner}. Il apparaîtra par défaut en italique@tie{};
+cependant, rien ne s'oppose à un autre graphisme dès lors que vous
+faites appel à un bloc @code{\markup} --
+voir @ref{Mise en forme du texte}.
@lilypond[quote,relative=2,verbatim]
\override TextSpanner #'(bound-details left text) =
@end lilypond
Le style de ligne se définit lui aussi comme une propriété de l'objet.
-Les détails concernant la syntaxe à utiliser sont expliqués au chapitre
-@ref{Lignes}.
+Les détails concernant la syntaxe à utiliser sont expliqués au chapitre
+@ref{Styles de ligne}. Les extenseurs sont rattachés au contexte
+@code{Dynamics} -- cf. @rinternals{Dynamics}.
@funindex \textSpannerUp
@code{\textSpannerNeutral}.
@endpredefined
+@knownissues
+LilyPond ne peut traiter qu'un seul extenseur à la fois par voix.
+
+@snippets
+
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{dynamics-text-spanner-postfix.ly}
+
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{dynamics-custom-text-spanner-postfix.ly}
@seealso
Manuel de notation :
-@ref{Lignes},
+@ref{Styles de ligne},
@ref{Nuances}.
Morceaux choisis :
-@rlsr{Text}.
+@rlsrnamed{Text,Texte},
+@rlsrnamed{Expressive marks,Signes d'interprétation}.
Référence des propriétés internes :
-@rinternals{TextSpanner}.
+@rinternals{TextSpanner},
+@rinternals{Dynamics}.
@node Indications textuelles
@funindex markup
La commande @code{\mark} est tout d'abord conçue pour les
-@ref{Indications de repère}.
+@ref{Indications de repère}.
@c \mark needs to be placed on a separate line (it's not
@c attached to an object like \markup is). -vv
@ref{La fonte Feta}.
Morceaux choisis:
-@rlsr{Text}.
+@rlsrnamed{Text,Texte}.
Référence des propriétés internes :
@rinternals{MarkEvent},
@rinternals{RehearsalMark}.
-@knownissues
-@c To be removed when Issue 69 in the tracker gets fixed. -vv
-
-Au cas où il n'y aurait pas de ligne à suivre, la marque ne sera pas imprimée.
-
-
@node Texte indépendant
@unnumberedsubsubsec Texte indépendant
@translationof Separate text
Un bloc @code{\markup} peut exister en lui-même, indépendamment de tout
bloc @code{\score}, et venir en préambule par exemple -- voir le
-chapitre @ref{Structure de fichier} à ce propos.
+chapitre @ref{Structure de fichier} à ce propos.
@lilypond[verbatim,quote]
\markup {
Les blocs de textes peuvent s'étendre sur plusieurs pages, ce qui permet
de générer des ouvrages complets uniquement grâce à LilyPond. Cette
-fonctionnalité ainsi que la syntaxe appropriée est abordée plus en
+fonctionnalité, ainsi que la syntaxe appropriée, est abordée plus en
détail au chapitre @ref{Texte avec sauts de page}.
@ref{Texte avec sauts de page}.
Morceaux choisis :
-@rlsr{Text}.
+@rlsrnamed{Text,Texte}.
Référence des propriétés internes :
@rinternals{TextScript}.
-
@node Mise en forme du texte
@subsection Mise en forme du texte
@translationof Formatting text
@menu
* Introduction au formatage de texte::
-* Sélection de la fonte et de la taille::
+* Sélection de la fonte et de la taille::
* Alignement du texte::
* Éléments graphiques dans du texte formaté::
-* Notation musicale dans du texte formaté::
-* Texte avec sauts de page::
+* Notation musicale dans du texte formaté::
+* Texte avec sauts de page::
@end menu
@node Introduction au formatage de texte
@cindex syntaxe du mode markup
La syntaxe du mode @emph{markup} n'est pas différente de celle des
-autres modes de LilyPond : une expression @code{\markup} est bornée par
-des accolades @code{@{ @dots{} @}}. Un mot unique sera considéré comme
-une expression minimale, et n'aura donc pas besoin d'être mis entre
-accolades.
+autres modes de LilyPond@tie{}: une expression @code{\markup} est bornée
+par des accolades @code{@{@tie{}@dots{}@tie{}@}}. Un mot unique sera
+considéré comme une expression minimale, et n'aura donc pas besoin
+d'être mis entre accolades.
Contrairement aux indications simples, du type "entre guillemets", les
blocs @code{\markup} peuvent contenir des expressions imbriquées ou
Un bloc @code{\markup} peut contenir du texte entre guillemets. De
telles chaines seront considérées comme des expressions textuelles
-minimales ; à ce titre, toute commande de type @emph{markup} ou tout
-caractère spécial -- tel un @code{\} ou un @code{#} -- sera imprimé
+minimales@tie{}; à ce titre, toute commande de type @emph{markup} ou
+tout caractère spécial -- tel un @code{\} ou un @code{#} -- sera imprimé
littéralement et sans influer sur le formatage du texte. Il est de ce
fait possible d'imprimer des guillemets informatiques @code{"} dès lors
qu'ils sont précédés d'une oblique inverse.
La manière de définir les expressions @emph{markup} aura une influence
sur la manière dont elles seront empilées, centrées ou alignées. Dans
l'exemple qui suit, la deuxième expression @code{\markup} est traitée
-tout comme la première :
+tout comme la première@tie{}:
@lilypond[quote,verbatim,relative=2]
c1^\markup { \center-column { a bbb c } }
@end lilypond
Vous pouvez stocker les étiquettes textuelles en tant que variables,
-et attacher ces identificateurs à des notes, comme ici :
+et attacher ces identificateurs à des notes, comme ici@tie{}:
@lilypond[quote,verbatim]
allegro = \markup { \bold \large Allegro }
@noindent
Pour une liste des différentes commandes spécifiques au mode
@code{\markup}, consultez l'annexe @ref{Text markup commands} (en
-anglais).
+anglais).
@seealso
@ref{Text markup commands}.
Morceaux choisis :
-@rlsr{Text}.
+@rlsrnamed{Text,Texte}.
Fichiers d'initialisation :
@file{scm/@/markup@/.scm}.
@funindex \underline
@funindex underline
-Le mode @emph{markup} autorise des changements élémentaires de la fonte :
+Le mode @emph{markup} autorise des changements élémentaires de la
+fonte@tie{}:
@lilypond[quote,verbatim,relative=2]
d1^\markup {
@funindex \magnify
@funindex magnify
-La taille des caractères se modifie de différentes manières :
+La taille des caractères se modifie de différentes manières@tie{}:
@itemize
@item
à partir de l'une des tailles standard prédéfinies,
@end itemize
@noindent
-Voici une illustration de ces trois différentes méthodes :
+Voici une illustration de ces trois différentes méthodes@tie{}:
@lilypond[quote,verbatim,relative=1]
f1_\markup {
Vous pouvez imprimer du texte en indice ou en exposant. Celui-ci sera
dans un taille plus petite, mais rien ne s'oppose à ce que vous lui
-affectiez un taille normale :
+affectiez un taille normale@tie{}:
@lilypond[quote,verbatim]
\markup {
Certaines familles de police spécifiques aux nombres ou aux nuances par
exemple, ne disposent pas de tous les caractères, comme nous l'avons vu
dans les chapitres @ref{Personnalisation des indications de nuance} et
-@ref{Indications de reprise manuelles}.
+@ref{Indications de reprise manuelles}.
@c \concat is actually documented in Align (it is not
@c a font-switching command). But we need it here. -vv
Lorsqu'un changement survient au milieu d'un mot, il se peut qu'un
-espacement supplémentaire apparaîsse. Il suffit en pareil cas de
-concaténer les différents éléments :
+espacement supplémentaire apparaisse. Il suffit en pareil cas de
+concaténer les différents éléments@tie{}:
@lilypond[quote,verbatim]
\markup {
@end lilypond
Une liste des différentes commandes permettant de changer de fonte ou
-d'utiliser des fontes personnalisées est disponible à l'annexe @ref{Font}.
+d'utiliser des fontes personnalisées est disponible à l'annexe
+@ref{Font}.
-Pour savoir comment personnaliser des fontes, reportez-vous au chapitre
+Pour savoir comment personnaliser des fontes, reportez-vous au chapitre
@ref{Fontes}.
@funindex \teeny
@ref{Fontes}.
Morceaux choisis :
-@rlsr{Text}.
+@rlsrnamed{Text,Texte}.
Référence des propriétés internes :
@rinternals{TextScript}.
Cette partie traite de la manière de positionner du texte en mode
@emph{markup}. On déplace l'intégralité d'un objet @emph{markup} en
-utilisant la syntaxe décrite au chapitre
-@rlearning{Déplacement d'objets}.
+utilisant la syntaxe décrite au chapitre
+@rlearning{Déplacement d'objets}.
@c Padding commands should be mentioned on this page, but
@c most of these require \box to be more clearly illustrated. -vv
@funindex \halign
@funindex halign
-L'alignement horizontal peut être ajusté à l'aide d'une valeur numérique :
+L'alignement horizontal peut être ajusté à l'aide d'une valeur
+numérique@tie{}:
@lilypond[quote,verbatim,relative=2]
a1-\markup { \halign #-1 poco }
annuleront toute spécification d'alignement que vous pourriez affecter
à un argument de type @emph{markup} que vous leur auriez fourni. La
solution consiste alors à déplacer l'intégralité de ces objets
-@emph{markup}, comme indiqué par exemple au chapitre
+@emph{markup}, comme indiqué par exemple au chapitre
@ref{Indications textuelles}.
@cindex texte, alignement vertical
Certaines commandes permettent de régler l'alignement des objets
textuels en mode @emph{markup}, tant au niveau horizontal que vertical.
-Tout objet soumis à ces commandes doit être précédé d'un point d'ancrage.
+Tout objet soumis à ces commandes doit être précédé d'un point
+d'ancrage.
@lilypond[quote,verbatim,relative=1]
d2^\markup {
@funindex fill-line
Pareillement, une liste d'éléments ou d'expressions sera répartie sur
-une ligne entière, voire même centrée sur toute la page s'il n'y a qu'un
+une ligne entière, voire même centrée sur toute la page s'il n'y a qu'un
seul élément. De telles expressions peuvent à leur tour contenir du
texte multi-ligne ou une autre expression @emph{markup}.
@funindex justify
Les indications textuelles, lorsqu'elles sont relativement longues,
-peuvent se répartir sur plusieurs lignes en fonction de la largeur de
+peuvent se répartir sur plusieurs lignes en fonction de la largeur de
ligne. Le texte sera alors soit aligné à gauche, soit justifié, comme
-le montre l'exemple suivant :
+le montre l'exemple suivant@tie{}:
@lilypond[quote,verbatim]
\markup {
@ref{Indications textuelles}.
Morceaux choisis :
-@rlsr{Text}.
+@rlsrnamed{Text,Texte}.
Référence des propriétés internes :
@rinternals{TextScript}.
@funindex hbracket
Certaines commandes de @emph{markup} permettent d'ornementer des
-éléments textuels avec des graphismes, à l'instar de l'exemple suivant :
+éléments textuels avec des graphismes, à l'instar de l'exemple
+suivant@tie{}:
@lilypond[quote,verbatim]
\markup \fill-line {
encapsulé (extension @code{eps}), ou bien de tracer un graphique
directement dans le fichier source à partir d'instructions PostScript
pures. Nous vous conseillons, en pareil cas, de toujours spécifier les
-dimensions du dessin, comme dans ce qui suit :
+dimensions du dessin, comme dans ce qui suit@tie{}:
@lilypond[quote,verbatim,relative=1]
c1^\markup {
@seealso
Manuel de notation :
@ref{Graphic},
-@ref{Notation éditoriale}.
+@ref{Annotations éditoriales}.
Morceaux choisis :
-@rlsr{Text}.
+@rlsrnamed{Text,Texte}.
Référence des propriétés internes :
@rinternals{TextScript}.
Divers éléments de notation peuvent orner une partition, au moyen d'un
objet @emph{markup}.
-Notes et altérations sont données à l'aide d'instructions @emph{markup} :
+Notes et altérations sont données à l'aide d'instructions
+@emph{markup}@tie{}:
@lilypond[quote,verbatim,relative=2]
a2 a^\markup {
\glissando b
@end lilypond
-Le mode @emph{markup} permet d'accéder à d'autres objets de notation :
+Le mode @emph{markup} permet d'accéder à d'autres objets de
+notation@tie{}:
@lilypond[quote,verbatim,relative=1]
g1 bes
crochets ou accolades.
Le mode @emph{markup} supporte aussi les diagrammes spécifiques à
-certains instruments :
+certains instruments@tie{}:
@lilypond[quote,verbatim,relative=2]
c1^\markup {
@c The accordion diagram is actually taken from a snippet.
@noindent
-La documentation sur ces diagrammes se trouvent à l'annexe
+La documentation sur ces diagrammes se trouvent à l'annexe
@ref{Instrument Specific Markup}.
@cindex partition incluse dans un markup
@cindex markup, inclusion de partition
Rien ne s'oppose à ce qu'une étiquette ne comporte une partition. Il
-suffit que l'expression en question contienne un bloc @code{\score} et
-un bloc @code{\layout}.
+suffit que l'expression en question contienne un bloc @code{\score}
+incluant un bloc @code{\layout}.
@lilypond[quote,verbatim,ragged-right]
\relative {
@ref{Tout savoir sur les fontes}.
Morceaux choisis :
-@rlsr{Text}.
+@rlsrnamed{Text,Texte}.
Référence des propriétés internes :
@rinternals{TextScript}.
}
@end lilypond
-Cette syntaxe prend en charge une liste de @emph{markups} ; il peut s'agir
+Cette syntaxe prend en charge une liste de @emph{markups}@tie{}; il peut
+s'agir
@itemize
@item
d'une suite de commandes générant à leur tour des lignes de texte,
@ref{Text markup list commands},
Morceaux choisis :
-@rlsr{Text}.
+@rlsrnamed{Text,Texte}.
@c en attendant redécoupage et création de "extending" -jcm
@c Extension :
@funindex font-interface
-La gestion des fontes est assurée par plusieurs bibliothèques :
+La gestion des fontes est assurée par plusieurs bibliothèques@tie{}:
FontConfig se charge de répertorier les différentes fontes installées
-sur votre système ; quant à Pango, elle se charge plus particulièrement
-de leur rendu.
+sur votre système@tie{}; quant à Pango, elle se charge plus
+particulièrement de leur rendu.
Les fontes musicales peuvent se décrire comme un jeu de glyphes
spécifiques regroupés dans plusieurs familles. L'exemple qui suit
@ref{Notation musicale dans du texte formaté}.
Une remarque s'impose au sujet des glyphes contenus dans
-@code{fetaBraces} : chacun d'eux est formé du mot @emph{brace} auquel
-est accolé un numéro d'ordre. Lorsque vous désirez imprimer une
+@code{fetaBraces}@tie{}: chacun d'eux est formé du mot @emph{brace}
+auquel est accolé un numéro d'ordre. Lorsque vous désirez imprimer une
accolade, vous devez la @qq{chercher} par son numéro d'ordre -- d'où la
fonction @code{\lookup} de l'exemple ci-dessus --, tout en sachant qu'il
est compris entre @code{0} (la plus petite) et @code{575} (la plus
arriver au résultat optimal. Par ailleurs, @code{fetaBraces} ne
comporte que des accolades ouvrantes. Pour obtenir une accolade
fermante, il suffit d'appliquer une rotation au glyphe sélectionné,
-comme indiqué au chapitre @ref{Rotation des objets}.
+comme indiqué au chapitre @ref{Rotation des objets}.
-Vous disposez de trois familles de fontes textuelles : @emph{roman}
+Vous disposez de trois familles de fontes textuelles@tie{}: @emph{roman}
pour la police sérif ou avec empattement -- fixée par défaut à New
Century Schoolbook --, une police sans empattement (@emph{sans} sérif)
et une à chasse fixe (ou monospace) -- les deux dernières étant
gras. L'exemple qui suit illustre la manière de changer la famille, le
style, la graisse ou la taille. Notez bien que l'argument fourni à
@code{font-size} correspond à la correction à apporter à la taille par
-défaut.
+défaut.
@lilypond[quote,verbatim,relative=2]
\override Score.RehearsalMark #'font-family = #'typewriter
@noindent
Cette syntaxe s'applique aussi en mode @emph{markup}, bien que celui-ci
dispose d'une syntaxe allégée comme nous l'avons vu dans
-@ref{Sélection de la fonte et de la taille}:
+@ref{Sélection de la fonte et de la taille}@tie{}:
@lilypond[quote,verbatim]
\markup {
En plus de pouvoir jongler entre les différentes fontes prédéfinies,
LilyPond vous permet d'en utiliser d'autres, ce qui fait l'objet des
-deux prochaines parties : @ref{Attribution d'une fonte en particulier}
+deux prochaines parties@tie{}:
+@ref{Attribution d'une fonte en particulier}
et @ref{Choix des fontes par défaut}.
Vous pouvez utiliser n'importe quelle police installée sur votre
système, du moment où elle est accessible par Fontconfig, en respectant
-la syntaxe suivante :
+la syntaxe suivante@tie{}:
@lilypond[quote,verbatim,relative=2]
\override Staff.TimeSignature #'font-name = #"Bitstream Charter"
@funindex show-available-fonts
Pour obtenir la liste de toutes les polices disponibles sur votre
-machine, lancez
+machine, lancez
@example
lilypond -dshow-available-fonts toto
@ref{Choix des fontes par défaut}.
Morceaux choisis :
-@rlsr{Text}.
+@rlsrnamed{Text,Texte}.
@c A source file gets never installed...
@c Fichiers d'initialisation :
celui de LilyPond. Il vous faudra alors spécifier les différentes
familles, en respectant l'ordre @emph{roman}, @emph{sans empattement} et
@emph{monospace}, comme dans l'exemple suivant. Pour plus
-d'explications sur les fontes, relisez @ref{Tout savoir sur les fontes}.
+d'explications sur les fontes, relisez @ref{Tout savoir sur les fontes}.
@cindex polices, choix par défaut
@cindex fontes, choix par défaut