@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
@ignore
- Translation of GIT committish: 22b6ca7247b6f0d596934d38aa2c75d5e45206eb
+ Translation of GIT committish: efd763abb78bf960a175b9a6aab571a3e02221b6
When revising a translation, copy the HEAD committish of the
version that you are working on. For details, see the Contributors'
Guide, node Updating translation committishes..
@end ignore
-@c \version "2.12.0"
+@c \version "2.13.36"
@c Translators: Jean-Charles Malahieude
@c Translation checkers: Valentin Villenave, John Mandereau
@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
En plus d'indications textuelles, les notes peuvent se voir attacher des
-articulations, comme indiqué au chapitre @ref{Articulations et ornements}.
+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
@ref{Direction et positionnement}.
Morceaux choisis :
-@rlsr{Text}.
+@rlsrnamed{Text,Texte}.
Référence des propriétés internes :
@rinternals{TextScript}.
S'assurer que tous les éléments textuels et les paroles respectent
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
+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@tie{}:
@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
@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},
@cindex texte en préambule
@cindex top-level text
@cindex text, top-level
-@cindex text, standalone
+@cindex indépendant, texte
@funindex \markup
@funindex markup
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}.
@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
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.
+@c repeat double quote for pairing "
@c KEEP LY
@lilypond[quote,verbatim,relative=2]
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@tie{}:
+@c repeat double quote for pairing "
@lilypond[quote,verbatim,relative=2]
c1^\markup { \center-column { a bbb c } }
@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}.
+@file{scm/markup.scm}.
@knownissues
-Les erreurs de syntaxe en mode @emph{markup} sont peu loquaces.
+Les erreurs de syntaxe en mode @emph{markup} sont peu explicites.
@node Sélection de la fonte et de la taille
@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,
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
+espacement supplémentaire apparaisse. Il suffit en pareil cas de
concaténer les différents éléments@tie{}:
@lilypond[quote,verbatim]
@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}.
Fichiers d'initialisation :
-@file{scm/@/define@/-markup@/-commands@/.scm}.
+@file{scm/define-markup-commands.scm}.
+
+@knownissues
+Le recours aux commandes @code{\teeny}, @code{\tiny},@code{\small},
+@code{\normalsize}, @code{\large} et @code{\huge} produiront des
+espacements nettement moins réguliers que si vous utilisez
+@code{\fontsize}.
@node Alignement du texte
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
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}.
@cindex justifié, texte
@cindex texte justifié
@cindex texte sur plusieurs lignes
-@cindex markup, texte wordwrapped
+@cindex markup, texte au kilomètre
@cindex markup, texte justifié
@funindex \wordwrap
@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@tie{}:
@ref{Indications textuelles}.
Morceaux choisis :
-@rlsr{Text}.
+@rlsrnamed{Text,Texte}.
Référence des propriétés internes :
@rinternals{TextScript}.
Fichiers d'initialisation :
-@file{scm/@/define@/-markup@/-commands@/.scm}.
+@file{scm/define-markup-commands.scm}.
@node Éléments graphiques dans du texte formaté
@funindex hbracket
Certaines commandes de @emph{markup} permettent d'ornementer des
-éléments textuels avec des graphismes, à l'instar de l'exemple suivant@tie{}:
+éléments textuels avec des graphismes, à l'instar de l'exemple
+suivant@tie{}:
@lilypond[quote,verbatim]
\markup \fill-line {
@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}.
Fichiers d'initialisation :
-@file{scm/@/define@/-markup@/-commands@/.scm},
-@file{scm/@/stencil@/.scm}.
+@file{scm/define-markup-commands.scm},
+@file{scm/stencil.scm}.
@node Notation musicale dans du texte formaté
c
c^\markup {
\combine
- \musicglyph #"accordion.accDiscant"
+ \musicglyph #"accordion.discant"
\combine
- \raise #0.5 \musicglyph #"accordion.accDot"
- \raise #1.5 \musicglyph #"accordion.accDot"
+ \raise #0.5 \musicglyph #"accordion.dot"
+ \raise #1.5 \musicglyph #"accordion.dot"
}
@end lilypond
@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}.
-
-@lilypond[quote,verbatim,ragged-right]
-\relative {
- c4 d^\markup {
- \score {
- \relative { c4 d e f }
- \layout { }
- }
+suffit que l'expression en question contienne un bloc @code{\score}
+incluant un bloc @code{\layout}.
+
+@lilypond[quote,verbatim,relative=1]
+c4 d^\markup {
+ \score {
+ \relative c' { c4 d e f }
+ \layout { }
}
- e f
}
+e f |
+c d e f
@end lilypond
Les différentes commandes @emph{markup} relatives à la notation musicale
@ref{Tout savoir sur les fontes}.
Morceaux choisis :
-@rlsr{Text}.
+@rlsrnamed{Text,Texte}.
Référence des propriétés internes :
@rinternals{TextScript}.
Fichiers d'initialisation :
-@file{scm/@/define@/-markup@/-commands@/.scm},
-@file{scm/@/fret@/-diagrams@/.scm},
-@file{scm/@/harp@/-pedals@/.scm}.
+@file{scm/define-markup-commands.scm},
+@file{scm/fret-diagrams.scm},
+@file{scm/harp-pedals.scm}.
@node Texte avec sauts de page
@ref{Text markup list commands},
Morceaux choisis :
-@rlsr{Text}.
+@rlsrnamed{Text,Texte}.
-@c en attendant redécoupage et création de "extending" -jcm
+@c TODO en attendant redécoupage et création de "extending" -jcm
@c Extension :
@c @rextend{New markup list command definition}.
@rinternals{TextScript}.
Fichiers d'initialisation :
-@file{scm/@/define@/-markup@/-commands@/.scm}.
+@file{scm/define-markup-commands.scm}.
@funindex \markuplines
\vcenter {
\override #'(font-encoding . fetaBraces)
\lookup #"brace120"
- \override #'(font-encoding . fetaNumber)
- \column { 1 3 }
- \override #'(font-encoding . fetaDynamic)
- sf
+ \override #'(font-encoding . fetaText)
+ \column { 1 3 sf }
\override #'(font-encoding . fetaMusic)
\lookup #"noteheads.s0petrucci"
}
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@tie{}: @emph{roman}
pour la police sérif ou avec empattement -- fixée par défaut à New
et une à chasse fixe (ou monospace) -- les deux dernières étant
déterminées par l'installation de Pango.
-Chaque famille dispose en principe de différents styles et niveau de
+Chaque famille dispose en principe de différents styles et niveaux de
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
@translationof Single entry fonts
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@tie{}:
+système, dès lors qu'elle est accessible par Fontconfig et que vous
+respectez 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 :
-@c @file{lily/@/font@/-config@/-scheme@/.cc}.
+@c @file{lily/font-config-scheme.cc}.
@node Choix des fontes par défaut
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