X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Ffr%2Fnotation%2Ftext.itely;fp=Documentation%2Ffr%2Fnotation%2Ftext.itely;h=7d487ab2ab77c2318ff25dbdcff302be968989fc;hb=941dff9d2a67080e0dd8474f1e70f0c72ace6424;hp=0000000000000000000000000000000000000000;hpb=5a22d6233a39d3164e1ca043244794c268be4ad0;p=lilypond.git diff --git a/Documentation/fr/notation/text.itely b/Documentation/fr/notation/text.itely new file mode 100644 index 0000000000..7d487ab2ab --- /dev/null +++ b/Documentation/fr/notation/text.itely @@ -0,0 +1,1626 @@ +@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*- +@ignore + Translation of GIT committish: 057106293b07b74b00553fe4dc3dfac5c1f3b682 + + 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 Translators: Jean-Charles Malahieude +@c Translation checkers: Valentin Villenave, John Mandereau + +@node Texte +@section Texte +@translationof Text + +@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. + +@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 +@ref{Musique vocale} et des @ref{Titres et entêtes}. + +@menu +* Ajout de texte:: +* Mise en forme du texte:: +* Fontes:: +@end menu + +@node Ajout de texte +@subsection Ajout de texte +@translationof Writing text + +Cette partie constitue une introduction aux différentes manières +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}.} + +@menu +* Commentaires textuels:: +* Indication textuelle avec extension:: +* Indications textuelles:: +* Texte indépendant:: +@end menu + +@node Commentaires textuels +@unnumberedsubsubsec Commentaires textuels +@translationof Text scripts + +@cindex Étiquette de texte +@cindex blocs de texte +@cindex ajout de texte + +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. +@ref{Direction et positionnement}. + +@lilypond[quote,verbatim,relative=2] +a8^"pizz." g f e a4-"scherz." f +@end lilypond + +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 +@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 +@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{}: +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 +@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 +@funindex \textLengthOff +@funindex textLengthOff + +@predefined +@code{\textLengthOn}, +@code{\textLengthOff}. +@endpredefined + + +@seealso +Manuel d'initiation : +@rlearning{Positionnement des objets}. + +Manuel de notation : +@ref{Mise en forme du texte}, +@ref{Direction et positionnement}, +@ref{Articulations et ornements}. + +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 + +@example +\override Score.PaperColumn #'keep-inside-line = ##t +@end example + + +@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 @emph{rallentando}, +@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{}: + +@lilypond[verbatim,quote,relative=2] +\override TextSpanner #'(bound-details left text) = "rit." +b1\startTextSpan +e,\stopTextSpan +@end lilypond + +@cindex texte, mise en forme des prolongations +@cindex texte, mise en forme des extenseurs +@cindex extenseur, mise en forme + +@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{}; +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 +@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{Styles de ligne}. + +@funindex \textSpannerUp +@funindex textSpannerUp +@funindex \textSpannerDown +@funindex textSpannerDown +@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,lilyquote,texidoc,doctitle] +{dynamics-text-spanner-postfix.ly} + +@lilypondfile[verbatim,lilyquote,texidoc,doctitle] +{dynamics-custom-text-spanner-postfix.ly} + +@seealso +Manuel de notation : +@ref{Styles de ligne}, +@ref{Nuances}, +@ref{Mise en forme du texte}. + +Morceaux choisis : +@rlsrnamed{Text,Texte}, +@rlsrnamed{Expressive marks,Signes d'interprétation}. + +Référence des propriétés internes : +@rinternals{TextSpanner}. + + +@node Indications textuelles +@unnumberedsubsubsec Indications textuelles +@translationof Text marks + +@cindex indication textuelle +@cindex coda sur une barre de mesure +@cindex segno sur une barre de mesure +@cindex point d'orgue sur une barre de mesure +@cindex barres de mesure, symboles au dessus de + +@funindex \mark +@funindex mark +@funindex \markup +@funindex markup + +La commande @code{\mark} est tout d'abord conçue pour les +@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 + +@lilypond[verbatim,quote,relative=2] +c4 +\mark "Allegro" +c c c +@end lilypond + +Cette syntaxe rend possible l'adjonction de n'importe quel texte à une +barre de mesure. Ce texte peut être mis en forme de différentes +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] +1 +\mark \markup { \italic { colla parte } } +2 +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 +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] +2 +\mark \markup { \musicglyph #"scripts.ufermata" } +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 +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 +@end lilypond + + +@snippets + +@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle] +{printing-marks-at-the-end-of-a-line.ly} + +@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle] +{aligning-marks-with-various-notation-objects.ly} + +@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle] +{printing-marks-on-every-staff.ly} + + +@seealso +Manuel de notation : +@ref{Indications de repère}, +@ref{Mise en forme du texte}, +@ref{Notation musicale dans du texte formaté}, +@ref{La fonte Feta}. + +Morceaux choisis: +@rlsrnamed{Text,Texte}. + +Référence des propriétés internes : +@rinternals{MarkEvent}, +@rinternals{Mark_engraver}, +@rinternals{RehearsalMark}. + + +@node Texte indépendant +@unnumberedsubsubsec Texte indépendant +@translationof Separate text + +@cindex texte indépendant +@cindex texte isolé +@cindex texte en préambule +@cindex top-level text +@cindex text, top-level +@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. + +@lilypond[verbatim,quote] +\markup { + Tomorrow, and tomorrow, and tomorrow... +} +@end lilypond + +@noindent +De cette manière, vous pouvez insérer du texte en dehors de la musique. +Ceci devient particulièrement utile lorsque le fichier source contient +plusieurs morceaux. Pour plus d'informations à ce propos, reportez-vous +au chapitre @ref{Plusieurs partitions dans un même ouvrage}. + +@lilypond[quote,verbatim] +\score { + c'1 +} +\markup { + Tomorrow, and tomorrow, and tomorrow... +} +\score { + c'1 +} +@end lilypond + +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 +détail au chapitre @ref{Texte avec sauts de page}. + + +@funindex \markup +@funindex markup +@funindex \markuplines +@funindex markuplines + +@predefined +@code{\markup}, +@code{\markuplines}. +@endpredefined + + +@snippets + +@lilypondfile[verbatim,lilyquote,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{Texte avec sauts de page}. + +Morceaux choisis : +@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 + +Nous allons voir dans les lignes qui suivent la manière de mettre en +forme du texte à l'aide de la syntaxe propre au mode @code{\markup}. + +@menu +* Introduction au formatage de texte:: +* 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:: +@end menu + +@node Introduction au formatage de texte +@unnumberedsubsubsec Introduction au formatage de texte +@translationof Text markup introduction + +@cindex étiquette +@cindex commentaire textuel +@cindex étiquette textuelle +@cindex texte ajouté + +@funindex \markup +@funindex markup + +La commande @code{\markup} permet d'ajouter du texte et dispose de sa +propre syntaxe que nous appellerons le @qq{mode @emph{markup}}. + +@cindex markup, expressions +@cindex expressions markup +@cindex markup, syntaxe +@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 +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 +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 +@end lilypond + +@cindex caractères spéciaux en mode markup +@cindex mode markup et caractères spéciaux +@cindex caractères réservés, impression +@cindex impression de caractères réservés +@cindex impression de caractères spéciaux +@cindex guillemets 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. +@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 +@end lilypond + +Une liste de mots, pour pouvoir être traitée en tant qu'expression +distincte, doit être bornée par des @code{"} ou précédée d'une commande. +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{}: +@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" } } +@end lilypond + +Vous pouvez stocker les étiquettes textuelles en tant que variables, +et attacher ces identificateurs à des notes, comme ici@tie{}: + +@lilypond[quote,verbatim] +allegro = \markup { \bold \large Allegro } + +{ + d''8.^\allegro + d'16 d'4 r2 +} +@end lilypond + +@noindent +Pour une liste des différentes commandes spécifiques au mode +@code{\markup}, consultez l'annexe @ref{Text markup commands} (en +anglais). + + +@seealso +Manuel de notation : +@ref{Text markup commands}. + +Morceaux choisis : +@rlsrnamed{Text,Texte}. + +Fichiers d'initialisation : +@file{scm/markup.scm}. + + +@knownissues + +Les erreurs de syntaxe en mode @emph{markup} sont peu explicites. + + +@node Sélection de la fonte et de la taille +@unnumberedsubsubsec Sélection de la fonte et de la taille +@translationof Selecting font and font size + +@cindex fonte, changement +@cindex changement de fonte +@cindex italique +@cindex gras +@cindex souligné + +@funindex \italic +@funindex italic +@funindex \bold +@funindex bold +@funindex \underline +@funindex underline + +Le mode @emph{markup} autorise des changements élémentaires de la +fonte@tie{}: + +@lilypond[quote,verbatim,relative=2] +d1^\markup { + \bold { Più mosso } + \italic { non troppo \underline Vivo } +} +r2 r4 r8 +d,_\markup { \italic quasi \smallCaps Tromba } +f1 d2 r +@end lilypond + +@cindex caratères, taille +@cindex texte, taille + +@funindex \fontsize +@funindex fontsize +@funindex \smaller +@funindex smaller +@funindex \larger +@funindex larger +@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, + +@item +en étant définie en valeur absolue, + +@item +en adoptant une valeur relative à celle précédemment définie. +@end itemize + +@noindent +Voici une illustration de ces trois différentes méthodes@tie{}: + +@lilypond[quote,verbatim,relative=1] +f1_\markup { + \tiny espressivo + \large e + \normalsize intenso +} +a^\markup { + \fontsize #5 Sinfonia + \fontsize #2 da + \fontsize #3 camera +} +bes^\markup { (con + \larger grande + \smaller emozione + \magnify #0.6 { e sentimento } ) +} +d c2 r8 c bes a g1 +@end lilypond + +@cindex indice +@cindex exposant + +@funindex \super +@funindex super +@funindex \sub +@funindex sub + +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{}: + +@lilypond[quote,verbatim] +\markup { + \column { + \line { 1 \super st movement } + \line { 1 \normal-size-super st movement + \sub { (part two) } } + } +} +@end lilypond + +@cindex fontes, familles + +Le mode @emph{markup} vous permet de sélectionner d'autres familles de +fontes. Par défaut, LilyPond utilise une police avec empattement, du +type roman, et tout changement doit être explicite. Dans la dernière +ligne de l'exemple qui suit, vous noterez qu'il n'y a aucune différence +entre les premier et deuxième mots. + +@lilypond[quote,verbatim] +\markup { + \column { + \line { Act \number 1 } + \line { \sans { Scene I. } } + \line { \typewriter { Verona. An open place. } } + \line { Enter \roman Valentine and Proteus. } + } +} +@end lilypond + +@noindent +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}. + +@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 apparaisse. Il suffit en pareil cas de +concaténer les différents éléments@tie{}: + +@lilypond[quote,verbatim] +\markup { + \column { + \line { + \concat { 1 \super st } + movement + } + \line { + \concat { \dynamic p , } + \italic { con dolce espressione } + } + } +} +@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}. + +Pour savoir comment personnaliser des fontes, reportez-vous au chapitre +@ref{Fontes}. + +@funindex \teeny +@funindex teeny +@funindex \tiny +@funindex tiny +@funindex \small +@funindex small +@funindex \normalsize +@funindex normalsize +@funindex \large +@funindex large +@funindex \huge +@funindex huge +@funindex \smaller +@funindex smaller +@funindex \larger +@funindex larger + + +@predefined +@code{\teeny}, +@code{\tiny}, +@code{\small}, +@code{\normalsize}, +@code{\large}, +@code{\huge}, +@code{\smaller}, +@code{\larger}. +@endpredefined + + +@seealso +Manuel de notation : +@ref{Font}, +@ref{Personnalisation des indications de nuance}, +@ref{Indications de reprise manuelles}, +@ref{Fontes}. + +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 +espacements nettement moins réguliers que si vous utilisez +@code{\fontsize}. + + +@node Alignement du texte +@unnumberedsubsubsec Alignement du texte +@translationof Text alignment + +@cindex texte, alignement +@cindex alignement du texte +@cindex alignement des markups +@cindex markups, alignement + +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}. + +@c Padding commands should be mentioned on this page, but +@c most of these require \box to be more clearly illustrated. -vv + +@cindex texte, alignement horizontal +@cindex alignement horizontal du texte + +@funindex \left-align +@funindex left-align +@funindex \center-align +@funindex center-align +@funindex \right-align +@funindex right-align + +Les objets de type @emph{markup} peuvent s'aligner de différentes +manières. Une indication textuelle est par défaut alignée sur son +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 } +@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 } +@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 +@ref{Indications textuelles}. + +@cindex texte, alignement vertical +@cindex alignement vertical du texte + +@funindex \raise +@funindex raise +@funindex \lower +@funindex lower +@funindex \null +@funindex null + +@c QUERY Should the function of ``\null'' be clarified? rp + +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 +é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 +suit illustre ces deux possibilités. Vous noterez par ailleurs que le +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. } +} +a'4 a g2 a +@end lilypond + +@funindex \general-align +@funindex general-align +@funindex \translate +@funindex translate +@funindex \translate-scaled +@funindex translate-scaled + +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. + +@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." +} +a'4 a g2 a +@end lilypond + +@cindex multi-ligne, markup +@cindex markup multi-ligne +@cindex multi-ligne, texte +@cindex texte multi-ligne +@cindex texte en colonnes +@cindex colonnes de texte + +@funindex \column +@funindex column +@funindex \center-column +@funindex center-column + +Un objet de type @emph{markup} peut contenir plusieurs lignes de texte. +Dans l'exemple suivant, chaque élément ou expression ira se placer sur +sa propre ligne, tantôt alignée à gauche, tantôt centrée. + +@lilypond[quote,verbatim] +\markup { + \column { + a + "b c" + \line { d e f } + } + \hspace #10 + \center-column { + a + "b c" + \line { d e f } + } +} +@end lilypond + +@cindex centrage du texte sur la page +@cindex texte, centrage sur la page +@cindex markup, centrage sur la page + +@funindex \fill-line +@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 +seul élément. De telles expressions peuvent à leur tour contenir du +texte multi-ligne ou une autre expression @emph{markup}. + +@lilypond[quote,verbatim] +\markup { + \fill-line { + \line { William S. Gilbert } + \center-column { + \huge \smallCaps "The Mikado" + or + \smallCaps "The Town of Titipu" + } + \line { Sir Arthur Sullivan } + } +} +\markup { + \fill-line { 1885 } +} +@end lilypond + +@cindex plusieurs lignes de texte +@cindex justifié, texte +@cindex texte justifié +@cindex texte sur plusieurs lignes +@cindex markup, texte au kilomètre +@cindex markup, texte justifié + +@funindex \wordwrap +@funindex wordwrap +@funindex \justify +@funindex justify + +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{}: + +@lilypond[quote,verbatim] +\markup { + \column { + \line \smallCaps { La vida breve } + \line \bold { Acto I } + \wordwrap \italic { + (La escena representa el corral de una casa de + gitanos en el Albaicín de Granada. Al fondo una + puerta por la que se ve el negro interior de + una Fragua, iluminado por los rojos resplandores + del fuego.) + } + \hspace #0 + + \line \bold { Acto II } + \override #'(line-width . 50) + \justify \italic { + (Calle de Granada. Fachada de la casa de Carmela + y su hermano Manuel con grandes ventanas abiertas + a través de las que se ve el patio + donde se celebra una alegre fiesta) + } + } +} +@end lilypond + +@cindex commandes d'alignement du texte +@cindex markup, commandes d'alignement du texte +@cindex alignement du texte, commandes + +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}, +@ref{Indications textuelles}. + +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é +@translationof Graphic notation inside markup + +@cindex graphisme, tracé +@cindex tracé d'objets graphiques +@cindex graphiques, tracé d'objets +@cindex embedding graphic objects +@cindex objets graphiques, tracé + +Vous pouvez, grâce aux mode @emph{markup}, ajouter divers objets +graphiques à votre partition. + +@cindex décoration du texte +@cindex encadrement du texte +@cindex texte, encadrement +@cindex texte, décoration +@cindex markup, ornementation du texte +@cindex markup, encadrement du texte + +@funindex \box +@funindex box +@funindex \circle +@funindex circle +@funindex \rounded-box +@funindex rounded-box +@funindex \bracket +@funindex bracket +@funindex \hbracket +@funindex hbracket + +Certaines commandes de @emph{markup} permettent d'ornementer des +éléments textuels avec des graphismes, à l'instar de l'exemple +suivant@tie{}: + +@lilypond[quote,verbatim] +\markup \fill-line { + \center-column { + \circle Jack + \box "in the box" + \null + \line { + Erik Satie + \hspace #3 + \bracket "1866 - 1925" + } + \null + \rounded-box \bold Prelude + } +} +@end lilypond + +@cindex espacement autour du texte +@cindex texte et rembourrage +@cindex markup, rembourrage du texte + +@funindex \pad-markup +@funindex pad-markup +@funindex \pad-x +@funindex pad-x +@funindex \pad-to-box +@funindex pad-to-box +@funindex \pad-around +@funindex pad-around + +Certaines directives peuvent nécessiter d'accroître l'espacement autour +du texte -- voir l'annexe @ref{Align} pour une liste des différentes +commandes particulières au mode @emph{markup} ainsi que leur description. + +@lilypond[quote,verbatim] +\markup \fill-line { + \center-column { + \box "Charles Ives (1874 - 1954)" + \null + \box \pad-markup #2 "THE UNANSWERED QUESTION" + \box \pad-x #8 "A Cosmic Landscape" + \null + } +} +\markup \column { + \line { + \hspace #10 + \box \pad-to-box #'(-5 . 20) #'(0 . 5) + \bold "Largo to Presto" + } + \pad-around #3 + "String quartet keeps very even time, +Flute quartet keeps very uneven time." +} +@end lilypond + +@cindex graphisme dans la notation +@cindex symboles non musicaux +@cindex non musicaux, symboles +@cindex notation et graphisme + +@funindex \combine +@funindex combine +@funindex \draw-circle +@funindex draw-circle +@funindex \filled-box +@funindex filled-box +@funindex \triangle +@funindex triangle +@funindex \draw-line +@funindex draw-line +@funindex \arrow-head +@funindex arrow-head + +Vous pouvez imprimer certains graphismes ou symboles sans qu'il n'y +ait de texte. Ces objets peuvent même se combiner, à l'instar de +n'importe quelle expression @emph{markup}. + +@lilypond[quote,verbatim] +\markup { + \combine + \draw-circle #4 #0.4 ##f + \filled-box #'(-4 . 4) #'(-0.5 . 0.5) #1 + \hspace #5 + + \center-column { + \triangle ##t + \combine + \draw-line #'(0 . 4) + \arrow-head #Y #DOWN ##f + } +} +@end lilypond + +@cindex intégration de graphiques +@cindex images, intégration +@cindex graphiques, intégration +@cindex postscript + +@funindex \epsfile +@funindex epsfile +@funindex \postscript +@funindex postscript + +Des fonctionnalités graphiques avancées vous permettent même d'inclure +dans une partition un fichier image converti au format PostScript +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{}: + +@lilypond[quote,verbatim,relative=1] +c1^\markup { + \combine + \epsfile #X #10 #"./context-example.eps" + \with-dimensions #'(0 . 6) #'(0 . 10) + \postscript #" + -2 3 translate + 2.7 2 scale + newpath + 2 -1 moveto + 4 -2 4 1 1 arct + 4 2 3 3 1 arct + 0 4 0 3 1 arct + 0 0 1 -1 1 arct + closepath + stroke" + } +c +@end lilypond + +L'annexe @ref{Graphic} répertorie les différentes commandes en matière +de graphisme. + + +@seealso +Manuel de notation : +@ref{Graphic}, +@ref{Annotations éditoriales}, +@ref{Align}. + +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é +@translationof Music notation inside markup + +@cindex notation dans un markup +@cindex musique dans un markup +@cindex markup, inclusion de musique + +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}@tie{}: + +@lilypond[quote,verbatim,relative=2] +a2 a^\markup { + \note #"4" #1 + = + \note-by-number #1 #1 #1.5 +} +b1_\markup { + \natural \semiflat \flat + \sesquiflat \doubleflat +} +\glissando +a1_\markup { + \natural \semisharp \sharp + \sesquisharp \doublesharp +} +\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 +} +@end lilypond + +En règle générale, tout symbole musical peut être inclus dans un +@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" } +@end lilypond + +Le sous-chapitre @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{}: + +@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" + \combine + \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 +@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} +incluant un bloc @code{\layout}. + +@lilypond[quote,verbatim,relative=1] +c4 d^\markup { + \score { + \relative c' { c4 d e f } + \layout { } + } +} +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}, +@ref{Tout savoir sur les fontes}. + +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 +@translationof Page wrapping text + +@cindex multi-page, markup +@cindex markup multi-page +@cindex markup, texte multi-page +@cindex plusieurs pages de texte + +@funindex \markuplines +@funindex markuplines +@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, +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 { + \justified-lines { + Un long texte constitué de lignes justifiées. + ... + } + \wordwrap-lines { + Un autre grand paragraphe. + ... + } + ... +} +@end lilypond + +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, +@item +d'une liste de lignes de texte, +@item +d'une liste d'étiquettes. +@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}. + + +@seealso +Manuel de notation : +@ref{Text markup list commands}, + +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}. + +Fichiers d'initialisation : +@file{scm/define-markup-commands.scm}. + + +@funindex \markuplines +@funindex markuplines + +@predefined +@code{\markuplines}. +@endpredefined + + +@node Fontes +@subsection Fontes +@translationof Fonts + +Ce chapitre est consacré aux fontes et polices de caractère, à leur +gestion. Vous y apprendrez aussi comment changer de fonte en cours de +partition. + +@menu +* Tout savoir sur les fontes:: +* Attribution d'une fonte en particulier:: +* Choix des fontes par défaut:: +@end menu + +@node Tout savoir sur les fontes +@unnumberedsubsubsec Tout savoir sur les fontes +@translationof Fonts explained + +@cindex Pango +@cindex fontes, généralités +@cindex accolades, taille +@cindex fontes et markup +@cindex markup et fontes + +@funindex font-interface + +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@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 +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 { + \vcenter { + \override #'(font-encoding . fetaBraces) + \lookup #"brace120" + \override #'(font-encoding . fetaText) + \column { 1 3 sf } + \override #'(font-encoding . fetaMusic) + \lookup #"noteheads.s0petrucci" + } +} +@end lilypond + +@noindent +Tous ces glyphes, à l'exception des accolades qui sont regroupées dans +@code{fetaBraces}, sont accessibles avec la syntaxe indiquée dans +@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} +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 +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}. + +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 +déterminées par l'installation de Pango. + +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 +\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 +@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{}: + +@lilypond[quote,verbatim] +\markup { + \column { + \line { + \override #'(font-shape . italic) + \override #'(font-size . 4) + Idomeneo, + } + \line { + \override #'(font-family . typewriter) + { + \override #'(font-series . bold) + re + di + } + \override #'(font-family . sans) + Creta + } + } +} +@end lilypond + +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{}: +@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}. + + +@node Attribution d'une fonte en particulier +@unnumberedsubsubsec Attribution d'une fonte en particulier +@translationof Single entry fonts + +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{}: + +@lilypond[quote,verbatim,relative=2] +\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 } +} +@end lilypond + +@cindex fontes disponibles +@cindex disponibilité des fontes + +@funindex show-available-fonts + +Pour obtenir la liste de toutes les polices disponibles sur votre +machine, lancez + +@example +lilypond -dshow-available-fonts toto +@end example +@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}. + +Morceaux choisis : +@rlsrnamed{Text,Texte}. + +@c A source file gets never installed... +@c Fichiers d'initialisation : +@c @file{lily/font-config-scheme.cc}. + + +@node Choix des fontes par défaut +@unnumberedsubsubsec Choix des fontes par défaut +@translationof Entire document fonts + +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}. + +@cindex polices, choix par défaut +@cindex fontes, choix par défaut + +@funindex make-pango-font-tree + +@lilypond[verbatim,quote] +\paper { + myStaffSize = #20 + #(define fonts + (make-pango-font-tree "Times New Roman" + "Nimbus Sans" + "Luxi Mono" + (/ myStaffSize 20))) +} + +\relative c'{ + c1-\markup { + roman, + \sans sans, + \typewriter typewriter. } +} +@end lilypond + +@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}, +@ref{Sélection de la fonte et de la taille}, +@ref{Font}. +