@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
+
@ignore
- Translation of GIT committish: 057106293b07b74b00553fe4dc3dfac5c1f3b682
+ Translation of GIT committish: caa4700b4acbc870158d70ee257efaa723c550f0
- 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..
+ 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.14.0"
+@c \version "2.19.21"
@c Translators: Jean-Charles Malahieude
@c Translation checkers: Valentin Villenave, John Mandereau
* Fontes::
@end menu
+
@node Ajout de texte
@subsection Ajout de texte
@translationof Writing text
* Texte indépendant::
@end menu
+
@node Commentaires textuels
@unnumberedsubsubsec Commentaires textuels
@translationof Text scripts
-@cindex Ã\89tiquette de texte
-@cindex blocs de texte
+@cindex étiquette de texte
+@cindex bloc de texte
@cindex ajout de texte
-Vous pouvez ajouter à une partition des indications sous forme texuelle,
+Vous pouvez ajouter à une partition des indications sous forme textuelle,
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.
@ref{Direction et positionnement}.
-@lilypond[quote,verbatim,relative=2]
-a8^"pizz." g f e a4-"scherz." f
+@lilypond[quote,verbatim]
+\relative { a'8^"pizz." g f e a4-"scherz." f }
@end lilypond
Cette syntaxe est en fait un raccourci. Des constructions plus
@code{\markup} et selon les préceptes énoncés dans
@ref{Mise en forme du texte}.
-@lilypond[quote,verbatim,relative=2]
-a8^\markup { \italic pizz. } g f e
-a4_\markup { \tiny scherz. \bold molto } f
+@lilypond[quote,verbatim]
+\relative {
+ a'8^\markup { \italic pizz. } g f e
+ a4_\markup { \tiny scherz. \bold molto } f }
@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@tie{}:
+notes. Leur longueur peut néanmoins être prise en considération :
dans l'exemple qui suit, le premier commentaire n'influe pas sur
l'espacement, à l'inverse du second.
-@lilypond[quote,verbatim,relative=2]
-a8^"pizz." g f e
-\textLengthOn
-a4_"scherzando" f
+@lilypond[quote,verbatim]
+\relative {
+ a'8^"pizz." g f e
+ \textLengthOn
+ a4_"scherzando" f
+}
@end lilypond
En plus d'indications textuelles, les notes peuvent se voir attacher des
@code{\textLengthOff}.
@endpredefined
-
@seealso
Manuel d'initiation :
@rlearning{Positionnement des objets}.
Manuel de notation :
-@ref{Mise en forme du texte},
+@ref{Articulations et ornements},
@ref{Direction et positionnement},
-@ref{Articulations et ornements}.
+@ref{Mise en forme du texte}.
Morceaux choisis :
@rlsrnamed{Text,Texte}.
Référence des propriétés internes :
@rinternals{TextScript}.
-
@cindex texte hors marges
@cindex marges, texte qui dépasse
@cindex texte, maintien dans les marges
@cindex texte, maintien dans les marges
-
@knownissues
-
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
+les marges du document requiert des calculs relativement lourds ;
+vous pouvez toutefois vous en affranchir en ajoutant
@example
-\override Score.PaperColumn #'keep-inside-line = ##t
+\override Score.PaperColumn.keep-inside-line = ##f
@end example
@emph{accelerando} ou @emph{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{}:
+entre deux notes à l'aide de la syntaxe suivante :
-@lilypond[verbatim,quote,relative=2]
-\override TextSpanner #'(bound-details left text) = "rit."
-b1\startTextSpan
-e,\stopTextSpan
+@lilypond[verbatim,quote]
+\relative {
+ \override TextSpanner.bound-details.left.text = "rit."
+ b'1\startTextSpan
+ e,\stopTextSpan
+}
@end lilypond
@cindex texte, mise en forme des prolongations
@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@tie{};
+@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}.
-@lilypond[quote,relative=2,verbatim]
-\override TextSpanner #'(bound-details left text) =
- \markup { \upright "rit." }
-b1\startTextSpan c
-e,\stopTextSpan
+@lilypond[quote,verbatim]
+\relative {
+ \override TextSpanner.bound-details.left.text =
+ \markup { \upright "rit." }
+ b'1\startTextSpan c
+ e,\stopTextSpan
+}
@end lilypond
Le style de ligne se définit lui aussi comme une propriété de l'objet.
@funindex \textSpannerNeutral
@funindex textSpannerNeutral
-
@predefined
@code{\textSpannerUp},
@code{\textSpannerDown},
@code{\textSpannerNeutral}.
@endpredefined
-@knownissues
-LilyPond ne peut traiter qu'un seul extenseur à la fois par voix.
-
@snippets
-
@lilypondfile[verbatim,quote,texidoc,doctitle]
{dynamics-text-spanner-postfix.ly}
@seealso
Manuel de notation :
-@ref{Styles de ligne},
+@ref{Mise en forme du texte},
@ref{Nuances},
-@ref{Mise en forme du texte}.
+@ref{Styles de ligne}.
Morceaux choisis :
@rlsrnamed{Text,Texte},
Référence des propriétés internes :
@rinternals{TextSpanner}.
+@knownissues
+LilyPond ne peut traiter qu'un seul extenseur à la fois par voix.
+
@node Indications textuelles
@unnumberedsubsubsec Indications textuelles
@c \mark needs to be placed on a separate line (it's not
@c attached to an object like \markup is). -vv
-@lilypond[verbatim,quote,relative=2]
-c4
-\mark "Allegro"
-c c c
+@lilypond[verbatim,quote]
+\relative {
+ c''4
+ \mark "Allegro"
+ c c c
+}
@end lilypond
Cette syntaxe rend possible l'adjonction de n'importe quel texte à une
manières dès lors qu'est utilisé un bloc @code{\markup}, comme indiqué
au chapitre @ref{Mise en forme du texte}.
-@lilypond[quote,verbatim,relative=1]
-<c e>1
-\mark \markup { \italic { colla parte } }
-<d f>2 <e g>
-<c f aes>1
+@lilypond[quote,verbatim]
+\relative {
+ <c' e>1
+ \mark \markup { \italic { colla parte } }
+ <d f>2 <e g>
+ <c f aes>1
+}
@end lilypond
@noindent
Elle peut aussi servir à insérer des signes de @emph{coda} ou de
-@emph{segno}, ou bien un point d'orgue, au dessus d'une
+@emph{segno}, ou bien un point d'orgue, au-dessus d'une
barre de mesure. Couplez-la alors à la commande @code{\markup} pour
avoir accès au symbole approprié, selon les indications contenues au
chapitre @ref{Notation musicale dans du texte formaté}.
-@lilypond[quote,verbatim,relative=2]
-<bes f>2 <aes d>
-\mark \markup { \musicglyph #"scripts.ufermata" }
-<e g>1
+@lilypond[quote,verbatim]
+\relative {
+ <bes' f>2 <aes d>
+ \mark \markup { \musicglyph #"scripts.ufermata" }
+ <e g>1
+}
@end lilypond
@noindent
Le résultat de @code{\mark} n'apparaîtra que sur la portée supérieure
d'un système. Si vous introduisez la commande @code{\mark} au moment
-d'une barre de mesure, la marque se placera au dessus de la barre. Si
+d'une barre de mesure, la marque se placera au-dessus de la barre. Si
vous y faites appel au milieu d'une mesure, cette marque sera
positionnée entre les notes. Si elle intervient en début de ligne,
elle sera placée juste avant la première note de cette portée. Enfin,
une marque qui tomberait sur un saut de ligne sera imprimée au début
de la ligne suivante.
-@lilypond[quote,verbatim,relative=2]
-\mark "Allegro"
-c1 c
-\mark "assai" \break
-c c
+@lilypond[quote,verbatim,ragged-right]
+\relative c'' {
+ \mark "Allegro"
+ c1 c
+ \mark "assai" \break
+ c c
+}
@end lilypond
+@funindex \markLengthOn
+@funindex markLengthOn
+@funindex \markLengthOff
+@funindex markLengthOff
-@snippets
+@predefined
+@code{\markLengthOn},
+@code{\markLengthOff}.
+@endpredefined
+@snippets
@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
{printing-marks-at-the-end-of-a-line.ly}
-@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
-{aligning-marks-with-various-notation-objects.ly}
-
@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
{printing-marks-on-every-staff.ly}
-
@seealso
Manuel de notation :
@ref{Indications de repère},
+@ref{La fonte Feta},
@ref{Mise en forme du texte},
-@ref{Notation musicale dans du texte formaté},
-@ref{La fonte Feta}.
+@ref{Notation musicale dans du texte formaté}.
Morceaux choisis:
@rlsrnamed{Text,Texte}.
@cindex texte indépendant
@cindex texte isolé
@cindex texte en préambule
-@cindex top-level text
-@cindex text, top-level
+@cindex top-level, texte
+@cindex texte, top-level
@cindex indépendant, texte
@funindex \markup
fonctionnalité, ainsi que la syntaxe appropriée, est abordée plus en
détail au chapitre @ref{Texte avec sauts de page}.
-
@funindex \markup
@funindex markup
-@funindex \markuplines
-@funindex markuplines
+@funindex \markuplist
+@funindex markuplist
@predefined
@code{\markup},
-@code{\markuplines}.
+@code{\markuplist}.
@endpredefined
-
@snippets
-
@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
{stand-alone-two-column-markup.ly}
-
@seealso
Manuel de notation :
@ref{Mise en forme du texte},
-@ref{Structure de fichier},
@ref{Plusieurs partitions dans un même ouvrage},
+@ref{Structure de fichier},
@ref{Texte avec sauts de page}.
Morceaux choisis :
* Texte avec sauts de page::
@end menu
+
@node Introduction au formatage de texte
@unnumberedsubsubsec Introduction au formatage de texte
@translationof Text markup introduction
@cindex commentaire textuel
@cindex étiquette textuelle
@cindex texte ajouté
+@cindex annotation
@funindex \markup
@funindex markup
@cindex syntaxe du mode markup
La syntaxe du mode @emph{markup} n'est pas différente de celle des
-autres modes de LilyPond@tie{}: une expression @code{\markup} est bornée
-par des accolades @code{@{@tie{}@dots{}@tie{}@}}. Un mot unique sera
+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.
Contrairement aux indications simples, du type "entre guillemets", les
blocs @code{\markup} peuvent contenir des expressions imbriquées ou
d'autres commandes @emph{markup}, dès lors qu'elles sont précédées du
-caractère @code{\}. Ces commandes n'affecteront que la première
+caractère @code{\}. Ces commandes n'affecteront que la première
expression qui les suit.
-@lilypond[quote,verbatim,relative=2]
-a1-\markup intenso
-a2^\markup { poco \italic più forte }
-c e1
-d2_\markup { \italic "string. assai" }
-e
-b1^\markup { \bold { molto \italic agitato } }
-c
+@lilypond[quote,verbatim]
+\relative {
+ a'1-\markup intenso
+ a2^\markup { poco \italic più forte }
+ c e1
+ d2_\markup { \italic "string. assai" }
+ e
+ b1^\markup { \bold { molto \italic agitato } }
+ c
+}
@end lilypond
@cindex caractères spéciaux en mode markup
@cindex mode markup et guillemets
Un bloc @code{\markup} peut contenir du texte entre guillemets. De
-telles chaines seront considérées comme des expressions textuelles
-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.
+telles chaînes 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é 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]
-a1^"\italic markup..."
-a_\markup { \italic "... imprime des lettres en \"italique\" !" }
-a a
+@lilypond[quote,verbatim]
+\relative {
+ a'1^"\italic markup..."
+ a_\markup { \italic "... imprime des lettres en \"italique\" !" }
+ a a
+}
@end lilypond
Une liste de mots, pour pouvoir être traitée en tant qu'expression
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@tie{}:
+tout comme la première :
@c repeat double quote for pairing "
-@lilypond[quote,verbatim,relative=2]
-c1^\markup { \center-column { a bbb c } }
-c1^\markup { \center-column { a { bbb c } } }
-c1^\markup { \center-column { a \line { bbb c } } }
-c1^\markup { \center-column { a "bbb c" } }
+@lilypond[quote,verbatim]
+\relative c'' {
+ c1^\markup { \center-column { a bbb c } }
+ c1^\markup { \center-column { a { bbb c } } }
+ c1^\markup { \center-column { a \line { bbb c } } }
+ 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@tie{}:
+et attacher ces identificateurs à des notes, comme ici :
@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
+@code{\markup}, consultez l'annexe @ref{Commandes pour markup} (en
anglais).
-
@seealso
Manuel de notation :
-@ref{Text markup commands}.
-
-Morceaux choisis :
-@rlsrnamed{Text,Texte}.
+@ref{Commandes pour markup}.
Fichiers d'initialisation :
@file{scm/markup.scm}.
+Morceaux choisis :
+@rlsrnamed{Text,Texte}.
@knownissues
-
Les erreurs de syntaxe en mode @emph{markup} sont peu explicites.
@funindex underline
Le mode @emph{markup} autorise des changements élémentaires de la
-fonte@tie{}:
+fonte :
-@lilypond[quote,verbatim,relative=2]
-d1^\markup {
- \bold { Più mosso }
- \italic { non troppo \underline Vivo }
+@lilypond[quote,verbatim]
+\relative {
+ d''1^\markup {
+ \bold { Più mosso }
+ \italic { non troppo \underline Vivo }
+ }
+ r2 r4 r8
+ d,_\markup { \italic quasi \smallCaps Tromba }
+ f1 d2 r
}
-r2 r4 r8
-d,_\markup { \italic quasi \smallCaps Tromba }
-f1 d2 r
@end lilypond
-@cindex caratères, taille
+@cindex caractères, taille
@cindex texte, taille
+@funindex \abs-fontsize
@funindex \fontsize
@funindex fontsize
@funindex \smaller
@funindex \magnify
@funindex magnify
-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,
+La taille des caractères se modifie, relativement à la taille globale
+des portées, de différentes manières.
-@item
-en étant définie en valeur absolue,
+Vous pouvez adopter l'une des tailles prédéfinies, comme ici :
-@item
-en adoptant une valeur relative à celle précédemment définie.
-@end itemize
+@lilypond[quote,verbatim]
+\relative b' {
+ b1_\markup { \huge Sinfonia }
+ b1^\markup { \teeny da }
+ b1-\markup { \normalsize camera }
+}
+@end lilypond
-@noindent
-Voici une illustration de ces trois différentes méthodes@tie{}:
+Vous pouvez la modifier relativement à sa valeur précédente :
-@lilypond[quote,verbatim,relative=1]
-f1_\markup {
- \tiny espressivo
- \large e
- \normalsize intenso
+@lilypond[quote,verbatim]
+\relative b' {
+ b1_\markup { \larger Sinfonia }
+ b1^\markup { \smaller da }
+ b1-\markup { \magnify #0.6 camera }
}
-a^\markup {
- \fontsize #5 Sinfonia
- \fontsize #2 da
- \fontsize #3 camera
+@end lilypond
+
+Vous pouvez l'augmenter ou la diminuer par rapport à la taille globale
+de portée :
+
+@lilypond[quote,verbatim]
+\relative b' {
+ b1_\markup { \fontsize #-2 Sinfonia }
+ b1^\markup { \fontsize #1 da }
+ b1-\markup { \fontsize #3 camera }
}
-bes^\markup { (con
- \larger grande
- \smaller emozione
- \magnify #0.6 { e sentimento } )
+@end lilypond
+
+Vous pouvez lui attribuer une valeur arbitraire quelle que soit la
+taille de portée globale :
+
+@lilypond[quote,verbatim]
+\relative b' {
+ b1_\markup { \abs-fontsize #20 Sinfonia }
+ b1^\markup { \abs-fontsize #8 da }
+ b1-\markup { \abs-fontsize #14 camera }
}
-d c2 r8 c bes a g1
+@end lilypond
+
+Lorsque le texte comporte des espaces, mieux vaut le borner par des
+guillemets informatiques ; s'en suivra une meilleure adéquation entre la
+taille des espaces et celle des autres caractères :
+
+@lilypond[quote,verbatim]
+\markup \fontsize #6 \bold { Sinfonia da camera }
+\markup \fontsize #6 \bold { "Sinfonia da camera" }
@end lilypond
@cindex indice
@funindex super
@funindex \sub
@funindex sub
+@funindex \normal-size-super
+@funindex normal-size-super
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@tie{}:
+dans une taille plus petite, mais rien ne s'oppose à ce que vous lui
+affectiez un taille normale :
@lilypond[quote,verbatim]
\markup {
Lorsqu'un changement survient au milieu d'un mot, il se peut qu'un
espacement supplémentaire apparaisse. Il suffit en pareil cas de
-concaténer les différents éléments@tie{}:
+concaténer les différents éléments :
@lilypond[quote,verbatim]
\markup {
@funindex \larger
@funindex larger
-
@predefined
@code{\teeny},
@code{\tiny},
@code{\larger}.
@endpredefined
-
@seealso
Manuel de notation :
-@ref{Font},
-@ref{Personnalisation des indications de nuance},
+@rusernamed{Font,Fonte},
+@ref{Fontes},
@ref{Indications de reprise manuelles},
-@ref{Fontes}.
+@ref{Personnalisation des indications de nuance}.
+
+Fichiers d'initialisation :
+@file{scm/define-markup-commands.scm}.
Morceaux choisis :
@rlsrnamed{Text,Texte}.
Référence des propriétés internes :
@rinternals{TextScript}.
-Fichiers d'initialisation :
-@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
extrémité gauche. Dans l'exemple qui suit, il n'y a aucune différence
entre les deux premiers @emph{markups}.
-@lilypond[quote,verbatim,relative=2]
-d1-\markup { poco }
-f
-d-\markup { \left-align poco }
-f
-d-\markup { \center-align { poco } }
-f
-d-\markup { \right-align poco }
+@lilypond[quote,verbatim]
+\relative {
+ d''1-\markup { poco }
+ f
+ d-\markup { \left-align poco }
+ f
+ d-\markup { \center-align { poco } }
+ f
+ d-\markup { \right-align poco }
+}
@end lilypond
@funindex \halign
@funindex halign
L'alignement horizontal peut être ajusté à l'aide d'une valeur
-numérique@tie{}:
-
-@lilypond[quote,verbatim,relative=2]
-a1-\markup { \halign #-1 poco }
-e'
-a,-\markup { \halign #0 poco }
-e'
-a,-\markup { \halign #0.5 poco }
-e'
-a,-\markup { \halign #2 poco }
+numérique :
+
+@lilypond[quote,verbatim]
+\relative {
+ a'1-\markup { \halign #-1 poco }
+ e'
+ a,-\markup { \halign #0 poco }
+ e'
+ a,-\markup { \halign #0.5 poco }
+ e'
+ a,-\markup { \halign #2 poco }
+}
@end lilypond
@noindent
Certains objets possèdent leurs propres procédures d'alignement, qui
-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
+annuleront toute spécification d'alignement que vous pourriez leur
+affecter. La solution consiste alors à déplacer l'intégralité de ces
+objets @emph{markup}, comme indiqué par exemple au chapitre
@ref{Indications textuelles}.
@cindex texte, alignement vertical
L'alignement vertical est quant à lui un peu plus compliqué. Comme nous
l'avons vu ci-avant, les objets @emph{markup} peuvent être déplacés dans
-leur intégralité. Il est néanmois possible de déplacer certains
+leur intégralité. Il est néanmoins possible de déplacer certains
éléments spécifiques au sein d'un bloc @emph{markup}. En pareil cas,
l'élément à déplacer doit être précédé d'un @qq{point d'ancrage} -- un
autre élément du @emph{markup} ou un objet invisible. L'exemple qui
dernier @emph{markup}, dépourvu de point d'ancrage, n'est de ce fait pas
déplacé.
-@lilypond[quote,verbatim,relative=1]
-d2^\markup {
- Acte I
- \raise #2 { Scène 1 }
-}
-a'
-g_\markup {
- \null
- \lower #4 \bold { Très modéré }
-}
-a
-d,^\markup {
- \raise #4 \italic { Une forêt. }
+@lilypond[quote,verbatim]
+\relative {
+ d'2^\markup {
+ Acte I
+ \raise #2 { Scène 1 }
+ }
+ a'
+ g_\markup {
+ \null
+ \lower #4 \bold { Très modéré }
+ }
+ a
+ d,^\markup {
+ \raise #4 \italic { Une forêt. }
+ }
+ a'4 a g2 a
}
-a'4 a g2 a
@end lilypond
@funindex \general-align
Tout objet soumis à ces commandes doit être précédé d'un point
d'ancrage.
-@lilypond[quote,verbatim,relative=1]
-d2^\markup {
- Acte I
- \translate #'(-1 . 2) "Scène 1"
-}
-a'
-g_\markup {
- \null
- \general-align #Y #3.2 \bold "Très modéré"
-}
-a
-d,^\markup {
- \null
- \translate-scaled #'(-1 . 2) \teeny "Une forêt."
+@lilypond[quote,verbatim]
+\relative {
+ d'2^\markup {
+ Acte I
+ \translate #'(-1 . 2) "Scène 1"
+ }
+ a'
+ g_\markup {
+ \null
+ \general-align #Y #3.2 \bold "Très modéré"
+ }
+ a
+ d,^\markup {
+ \null
+ \translate-scaled #'(-1 . 2) \teeny "Une forêt."
+ }
+ a'4 a g2 a
}
-a'4 a g2 a
@end lilypond
-@cindex multi-ligne, markup
-@cindex markup multi-ligne
-@cindex multi-ligne, texte
-@cindex texte multi-ligne
+@cindex multiligne, markup
+@cindex markup multiligne
+@cindex multiligne, texte
+@cindex texte multiligne
@cindex texte en colonnes
@cindex colonnes de texte
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
seul élément. De telles expressions peuvent à leur tour contenir du
-texte multi-ligne ou une autre expression @emph{markup}.
+texte multiligne ou une autre expression @emph{markup}.
@lilypond[quote,verbatim]
\markup {
Les indications textuelles, lorsqu'elles sont relativement longues,
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{}:
+le montre l'exemple suivant :
@lilypond[quote,verbatim]
\markup {
Une liste des différentes commandes permettant d'aligner du texte en
mode @emph{markup} est disponible à l'annexe @ref{Align}.
-
@seealso
Manuel d'initiation :
@rlearning{Déplacement d'objets}.
Manuel de notation :
-@ref{Align},
+@rusernamed{Align,Alignement},
@ref{Indications textuelles}.
+Fichiers d'initialisation :
+@file{scm/define-markup-commands.scm}.
+
Morceaux choisis :
@rlsrnamed{Text,Texte}.
Référence des propriétés internes :
@rinternals{TextScript}.
-Fichiers d'initialisation :
-@file{scm/define-markup-commands.scm}.
-
@node Éléments graphiques dans du texte formaté
@unnumberedsubsubsec Éléments graphiques dans du texte formaté
@cindex graphisme, tracé
@cindex tracé d'objets graphiques
@cindex graphiques, tracé d'objets
-@cindex embedding graphic objects
+@cindex intégration d'objet graphique
@cindex objets graphiques, tracé
Vous pouvez, grâce aux mode @emph{markup}, ajouter divers objets
Certaines commandes de @emph{markup} permettent d'ornementer des
éléments textuels avec des graphismes, à l'instar de l'exemple
-suivant@tie{}:
+suivant :
@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@tie{}:
+dimensions du dessin, comme dans ce qui suit :
-@lilypond[quote,verbatim,relative=1]
-c1^\markup {
+@lilypond[quote,verbatim,fragment]
+c'1^\markup {
\combine
\epsfile #X #10 #"./context-example.eps"
\with-dimensions #'(0 . 6) #'(0 . 10)
closepath
stroke"
}
-c
+c'
@end lilypond
L'annexe @ref{Graphic} répertorie les différentes commandes en matière
de graphisme.
-
@seealso
Manuel de notation :
-@ref{Graphic},
+@rusernamed{Align,Alignement},
@ref{Annotations éditoriales},
-@ref{Align}.
+@ref{Dimensions},
+@rusernamed{Graphic,Graphique}.
+
+Fichiers d'initialisation :
+@file{scm/define-markup-commands.scm},
+@file{scm/stencil.scm}.
Morceaux choisis :
@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}.
-
@node Notation musicale dans du texte formaté
@unnumberedsubsubsec Notation musicale dans du texte formaté
objet @emph{markup}.
Notes et altérations sont données à l'aide d'instructions
-@emph{markup}@tie{}:
+@emph{markup} :
-@lilypond[quote,verbatim,relative=2]
-a2 a^\markup {
+@lilypond[quote,verbatim,fragment]
+a'2 a'^\markup {
\note #"4" #1
=
\note-by-number #1 #1 #1.5
}
-b1_\markup {
+b'1_\markup {
\natural \semiflat \flat
\sesquiflat \doubleflat
}
\glissando
-a1_\markup {
+a'1_\markup {
\natural \semisharp \sharp
\sesquisharp \doublesharp
}
-\glissando b
+\glissando b'
@end lilypond
Le mode @emph{markup} permet d'accéder à d'autres objets de
-notation@tie{}:
-
-@lilypond[quote,verbatim,relative=1]
-g1 bes
-ees-\markup {
- \finger 4
- \tied-lyric #"~"
- \finger 1
-}
-fis_\markup { \dynamic rf }
-bes^\markup {
- \beam #8 #0.1 #0.5
-}
-cis
-d-\markup {
- \markalphabet #8
- \markletter #8
+notation :
+
+@lilypond[quote,verbatim]
+\relative {
+ g1 bes
+ ees\finger \markup \tied-lyric #"4~1"
+ fis_\markup { \dynamic rf }
+ bes^\markup {
+ \beam #8 #0.1 #0.5
+ }
+ cis
+ d-\markup {
+ \markalphabet #8
+ \markletter #8
+ }
}
@end lilypond
@emph{markup}, comme le montre l'exemple qui suit. Ces différents
symboles sont répertoriés dans l'annexe @ref{La fonte Feta}.
-@lilypond[quote,verbatim,relative=2]
-c2
-c'^\markup { \musicglyph #"eight" }
-c,4
-c,8._\markup { \musicglyph #"clefs.G_change" }
-c16
-c2^\markup { \musicglyph #"timesig.neomensural94" }
+@lilypond[quote,verbatim]
+\relative {
+ c''2
+ c'^\markup { \musicglyph #"eight" }
+ c,4
+ c,8._\markup { \musicglyph #"clefs.G_change" }
+ c16
+ c2^\markup { \musicglyph #"timesig.neomensural94" }
+}
@end lilypond
-Le sous-chapitre @ref{Tout savoir sur les fontes} contient d'autres
+La rubrique @ref{Tout savoir sur les fontes} contient d'autres
informations sur l'impression de glyphes non alphabétiques, tels que des
crochets ou accolades.
Le mode @emph{markup} supporte aussi les diagrammes spécifiques à
-certains instruments@tie{}:
+certains instruments :
-@lilypond[quote,verbatim,relative=2]
-c1^\markup {
- \fret-diagram-terse #"x;x;o;2;3;2;"
-}
-c^\markup {
- \harp-pedal #"^-v|--ov^"
-}
-c
-c^\markup {
- \combine
- \musicglyph #"accordion.discant"
+@lilypond[quote,verbatim]
+\relative {
+ c''1^\markup {
+ \fret-diagram-terse #"x;x;o;2;3;2;"
+ }
+ c^\markup {
+ \harp-pedal #"^-v|--ov^"
+ }
+ c
+ c^\markup {
\combine
- \raise #0.5 \musicglyph #"accordion.dot"
- \raise #1.5 \musicglyph #"accordion.dot"
+ \musicglyph #"accordion.discant"
+ \combine
+ \raise #0.5 \musicglyph #"accordion.dot"
+ \raise #1.5 \musicglyph #"accordion.dot"
+ }
}
@end lilypond
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 { }
+@lilypond[quote,verbatim]
+\relative {
+ c'4 d^\markup {
+ \score {
+ \relative { c'4 d e f }
+ \layout { }
+ }
}
+ e f |
+ c d e f
}
-e f |
-c d e f
@end lilypond
Les différentes commandes @emph{markup} relatives à la notation musicale
sont répertoriées à l'annexe @ref{Music}.
-
@seealso
Manuel de notation :
-@ref{Music},
@ref{La fonte Feta},
+@rusernamed{Music,Musique},
@ref{Tout savoir sur les fontes}.
+Fichiers d'initialisation :
+@file{scm/define-markup-commands.scm},
+@file{scm/fret-diagrams.scm},
+@file{scm/harp-pedals.scm}.
+
Morceaux choisis :
@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}.
-
@node Texte avec sauts de page
@unnumberedsubsubsec Texte avec sauts de page
@cindex markup, texte multi-page
@cindex plusieurs pages de texte
-@funindex \markuplines
-@funindex markuplines
+@funindex \markuplist
+@funindex markuplist
@funindex \justified-lines
@funindex justified-lines
@funindex \wordwrap-lines
@funindex wordwrap-lines
Alors que @code{\markup} s'utilise pour traiter un bloc de texte
-insécable, @code{\markuplines} permet, employé en tête de partition,
+insécable, @code{\markuplist} permet, employé en tête de partition,
d'obtenir un bloc de lignes réparties différemment et, le cas échéant,
sur plusieurs pages.
@c KEEP LY
@lilypond[quote,verbatim]
-\markuplines {
+\markuplist {
\justified-lines {
Un long texte constitué de lignes justifiées.
...
}
@end lilypond
-Cette syntaxe prend en charge une liste de @emph{markups}@tie{}; il peut
+Cette syntaxe prend en charge une liste de @emph{markups} ; il peut
s'agir
@itemize
@item
@end itemize
Les différentes commandes permettant de générer des listes de lignes
-se trouve dans l'annexe @ref{Text markup list commands}.
+se trouve dans l'annexe @ref{Commandes pour liste de markups} (en
+anglais).
+@predefined
+@code{\markuplist}.
+@endpredefined
@seealso
Manuel de notation :
-@ref{Text markup list commands},
+@ref{Commandes pour liste de markups}.
-Morceaux choisis :
-@rlsrnamed{Text,Texte}.
-
-@c TODO en attendant redécoupage et création de "extending" -jcm
-@c Extension :
-@c @rextend{New markup list command definition}.
-
-Référence des propriétés internes :
-@rinternals{TextScript}.
+Manuel d'extension :
+@rextend{Définition d'une nouvelle commande de liste de markups}.
Fichiers d'initialisation :
@file{scm/define-markup-commands.scm}.
+Morceaux choisis :
+@rlsrnamed{Text,Texte}.
-@funindex \markuplines
-@funindex markuplines
-
-@predefined
-@code{\markuplines}.
-@endpredefined
+Référence des propriétés internes :
+@rinternals{TextScript}.
@node Fontes
* Choix des fontes par défaut::
@end menu
+
@node Tout savoir sur les fontes
@unnumberedsubsubsec Tout savoir sur les fontes
@translationof Fonts explained
@funindex font-interface
-La gestion des fontes est assurée par plusieurs bibliothèques@tie{}:
+La gestion des fontes est assurée par plusieurs bibliothèques :
FontConfig se charge de répertorier les différentes fontes installées
-sur votre système@tie{}; quant à Pango, elle se charge plus
+sur votre système ; quant à Pango, elle se charge plus
particulièrement de leur rendu.
Les fontes musicales peuvent se décrire comme un jeu de glyphes
montre la syntaxe à utiliser pour accéder, en mode @emph{markup}, aux
différentes fontes @code{feta} non textuelles de LilyPond.
-@lilypond[quote,verbatim,relative=2]
-a1^\markup {
+@lilypond[quote,verbatim,fragment]
+a'1^\markup {
\vcenter {
\override #'(font-encoding . fetaBraces)
\lookup #"brace120"
@ref{Notation musicale dans du texte formaté}.
Une remarque s'impose au sujet des glyphes contenus dans
-@code{fetaBraces}@tie{}: chacun d'eux est formé du mot @emph{brace}
+@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
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
-grande). Vous serez souvent amené à procéder par tatonnement pour
+grande). Vous serez souvent amené à procéder par tâtonnement pour
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é à la rubrique @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
-Century Schoolbook --, une police sans empattement (@emph{sans} sérif)
-et une à chasse fixe (ou monospace) -- les deux dernières étant
+Vous disposez de trois familles de fontes textuelles : @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 (monospace ou @emph{typewriter}) -- les deux dernières étant
déterminées par l'installation de Pango.
+@warning{Aucune police par défaut n'est associée aux familles
+@emph{sans} et @emph{typewriter}. Lorsque l'une d'elles apparaît dans
+un fichier source, le résultat peut varier d'un ordinateur à l'autre.
+Le résultat sera homogène quelque soit la plateforme dès lors que ces
+polices auront été spécifiées par leur nom et qu'elles sont disponibles
+pour tout système amené à traiter le fichier. Voir
+@ref{Attribution d'une fonte en particulier} et
+@ref{Choix des fontes par défaut}.}
+
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.
-@lilypond[quote,verbatim,relative=2]
-\override Score.RehearsalMark #'font-family = #'typewriter
+@lilypond[quote,verbatim,fragment]
+\override Score.RehearsalMark.font-family = #'typewriter
\mark \markup "Ouverture"
-\override Voice.TextScript #'font-shape = #'italic
-\override Voice.TextScript #'font-series = #'bold
-d2.^\markup "Allegro"
-\override Voice.TextScript #'font-size = #-3
-c4^smaller
+\override Voice.TextScript.font-shape = #'italic
+\override Voice.TextScript.font-series = #'bold
+d''2.^\markup "Allegro"
+\override Voice.TextScript.font-size = #-3
+c''4^smaller
@end lilypond
@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}@tie{}:
+@ref{Sélection de la fonte et de la taille} :
@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@tie{}:
+deux prochaines parties :
@ref{Attribution d'une fonte en particulier}
et @ref{Choix des fontes par défaut}.
-
@seealso
Manuel de notation :
@ref{La fonte Feta},
@ref{Notation musicale dans du texte formaté},
@ref{Rotation des objets},
@ref{Sélection de la fonte et de la taille},
-@ref{Font}.
+@rusernamed{Font,Fonte}.
@node Attribution d'une fonte en particulier
Vous pouvez utiliser n'importe quelle police installée sur votre
système, dès lors qu'elle est accessible par Fontconfig et que vous
-respectez la syntaxe suivante@tie{}:
+respectez la syntaxe suivante :
-@lilypond[quote,verbatim,relative=2]
-\override Staff.TimeSignature #'font-name = #"Bitstream Charter"
-\override Staff.TimeSignature #'font-size = #2
+@lilypond[quote,verbatim,fragment]
+\override Staff.TimeSignature.font-name = #"Bitstream Charter"
+\override Staff.TimeSignature.font-size = #2
\time 3/4
-a1_\markup {
- \override #'(font-name . "Vera Bold")
- { Vera Bold }
+a'1_\markup {
+ \override #'(font-name . "Bitstream Vera Sans,sans-serif, Oblique Bold")
+ { Vera Oblique Bold }
}
@end lilypond
@funindex show-available-fonts
-Pour obtenir la liste de toutes les polices disponibles sur votre
-machine, lancez
+LilyPond, lancé avec l'option suivante, affiche la liste de toutes
+les polices disponibles sur votre machine :
@example
lilypond -dshow-available-fonts toto
@noindent
(quel qu'il soit, le dernier argument est obligatoire).
-
@seealso
Manuel de notation :
-@ref{Tout savoir sur les fontes},
-@ref{Choix des fontes par défaut}.
+@ref{Choix des fontes par défaut},
+@ref{Tout savoir sur les fontes}.
Morceaux choisis :
@rlsrnamed{Text,Texte}.
Vous pouvez tout à fait préférer un autre jeu de polices par défaut que
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}.
+@emph{monospace}, comme dans l'exemple suivant ; ces fontes seront
+automatiquement mises à l'échelle de la taille globale des
+portées. Pour plus d'explications sur les fontes, relisez
+@ref{Tout savoir sur les fontes}.
@cindex polices, choix par défaut
@cindex fontes, choix par défaut
@lilypond[verbatim,quote]
\paper {
- myStaffSize = #20
#(define fonts
(make-pango-font-tree "Times New Roman"
- "Nimbus Sans"
+ "Nimbus Sans,Nimbus Sans L"
"Luxi Mono"
- (/ myStaffSize 20)))
+ (/ staff-height pt 20)))
}
\relative c'{
@c we don't do Helvetica / Courier, since GS incorrectly loads
@c Apple TTF fonts
-
@seealso
Manuel de notation :
-@ref{Tout savoir sur les fontes},
@ref{Attribution d'une fonte en particulier},
+@rusernamed{Font,Fonte},
@ref{Sélection de la fonte et de la taille},
-@ref{Font}.
-
+@ref{Tout savoir sur les fontes}.