Merge branch 'master' of carldsorensen@git.sv.gnu.org:/srv/git/lilypond into ralph

[lilypond.git] / Documentation / fr / user / text.itely

diff --git a/Documentation/fr/user/text.itely b/Documentation/fr/user/text.itely
index 67b49fa684d877022a645bb1b1dcfe359c3221dd..be7b015717401113785bbe641d0861fa6db46a90 100644 (file)
--- a/Documentation/fr/user/text.itely
+++ b/Documentation/fr/user/text.itely
@@ -1,12 +1,12 @@
 @c -*- coding: utf-8; mode: texinfo; -*-
 @ignore
-    Translation of GIT committish: f7420240e4ce1fe2217646482a47d00f566af52c
+    Translation of GIT committish: bdf8540b74167817eab96ed3d13b35477217f9fe
 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  See TRANSLATION for details.
 @end ignore
 
-@c \version "2.11.38"
+@c \version "2.12.0"
 
 @c Translators: Jean-Charles Malahieude
 @c Translation checkers: Valentin Villenave, John Mandereau
@@ -14,8 +14,10 @@
 @node Text
 @section Text
 
-Nous allons voir ici comment insérer du texte, selon différents
-formatages, dans vos partitions.
+@lilypondfile[quote]{text-headword.ly}
+
+Nous allons voir ici comment insérer dans une partition du texte, avec
+différentes possibilité de formatage.
 
 @cindex Texte, autres langues
 Pour écrire des accents et autres caractères spéciaux, il suffit de
@@ -23,25 +25,10 @@ les insérer directement dans votre fichier LilyPond.  Ce fichier devra
 être sauvegardé avec l'encodage UTF-8.  Pour plus d'informations, voir
 @ref{Text encoding}.
 
-@lilypond[fragment,ragged-right,staffsize=16,quote]
-c'4^\markup { bla \bold bla }
-@end lilypond
-
-@lilypond[fragment,ragged-right,staffsize=16,quote]
-c'4^\markup { bla \bold bla }
-@end lilypond
-
-@lilypond[fragment,ragged-right,staffsize=16,quote]
-c'4^\markup { bla \bold bla }
-@end lilypond
-
-@lilypond[fragment,ragged-right,staffsize=16,quote]
-c'4^\markup { bla \bold bla }
-@end lilypond
-
 @menu
 * Writing text::                
-* Text markup::                 
+* Formatting text::             
+* Fonts::                       
 @end menu
 
 
@@ -53,7 +40,6 @@ c'4^\markup { bla \bold bla }
 * Text and line spanners::      
 * Text spanners::               
 * Text marks::                  
-* New dynamic marks::           
 @end menu
 
 @node Text scripts
@@ -69,7 +55,7 @@ c'4^\markup { bla \bold bla }
 @cindex ajout de texte
 
 Vous pouvez placer arbitrairement des chaînes de caractères, ou
-@ref{Text markup} en langage LilyPond, au dessus ou au dessous des
+@ref{Formatting text} en langage LilyPond, au dessus ou au dessous des
 notes en employant la syntaxe @code{c^"text"}.  Par défaut, ces
 indications n'affecteront en rien l'espacement des notes, sauf à
 utiliser la commande @code{\textLengthOn}.
@@ -89,15 +75,15 @@ c'4^\markup { bla \bold bla }
 @end lilypond
 
 La commande @code{\markup} est décrite plus en détails dans la section
-@ref{Text markup}.
+@ref{Formatting text}.
 
 
 @predefined
-
 @funindex \textLengthOn
 @code{\textLengthOn},
 @funindex \textLengthOff
 @code{\textLengthOff}.
+@endpredefined
 
 
 @commonprop
@@ -113,8 +99,7 @@ Vous pouvez cependant l'y forcer en définissant
 
 
 @seealso
-
-Dans ce manuel : @ref{Text markup}.
+Dans ce manuel : @ref{Formatting text}.
 
 Référence du programme : @rinternals{TextScript}.
 
@@ -155,7 +140,7 @@ régler vous-même :
 
 @lilypond[relative=2,ragged-right,verbatim,fragment]
 e2 \glissando f
-\once \override Glissando #'bound-details #'right #'Y = #-2
+\once \override Glissando #'(bound-details right Y) = #-2
 e2 \glissando f
 @end lilypond
 
@@ -176,7 +161,7 @@ dans l'exemple suivant :
 
 @lilypond[relative=2,ragged-right,verbatim,fragment]
 \override Glissando #'breakable = ##T 
-\override Glissando #'bound-details #'right-broken #'Y = #-3
+\override Glissando #'(bound-details right-broken Y) = #-3
 c1 \glissando \break
 f1
 @end lilypond
@@ -212,7 +197,7 @@ Marqueur qui sera analysé pour alimenter @code{stencil}.  On y trouve
 habituellement les @i{cresc.} ou @i{tr} des extenseurs horizontaux.
 
 @lilypond[quote,ragged-right,fragment,relative=2,verbatim]
-\override TextSpanner #'bound-details #'left #'text
+\override TextSpanner #'(bound-details left text)
    = \markup { \small \bold Slower }
 c2\startTextSpan b c a\stopTextSpan
 @end lilypond
@@ -226,11 +211,11 @@ vous pouvez décaler le coin du marqueur par rapport à l'extrémité de
 la ligne.
 
 @lilypond[relative=1,fragment,verbatim]
-\override TextSpanner #'bound-details #'left #'stencil-align-dir-y = #DOWN
-\override TextSpanner #'bound-details #'right #'stencil-align-dir-y = #UP
+\override TextSpanner #'(bound-details left stencil-align-dir-y) = #DOWN
+\override TextSpanner #'(bound-details right stencil-align-dir-y) = #UP
 
-\override TextSpanner #'bound-details #'left #'text = #"gggg"
-\override TextSpanner #'bound-details #'right #'text = #"hhhh"
+\override TextSpanner #'(bound-details left text) = #"gggg"
+\override TextSpanner #'(bound-details right text) = #"hhhh"
 c4^\startTextSpan c c c \stopTextSpan
 @end lilypond
 
@@ -245,13 +230,13 @@ début et la fin d'un glissando seraient en plein milieu des têtes de note.
 
 @end table
 
-@seealso
 
+@seealso
 Référence du programme : @rinternals{TextSpanner},
 @rinternals{Glissando}, @rinternals{VoiceFollower},
 @rinternals{TrillSpanner}, @rinternals{line-spanner-interface}.
 
-Exemples : @lsr{expressive,line-styles.ly}, @lsr{expressive,line-arrows.ly}
+Exemples : @rlsr{Expressive marks}.
 
 
 @node Text spanners
@@ -272,24 +257,25 @@ propriétés, comme ici :
 @lilypond[quote,ragged-right,fragment,relative=1,verbatim]
 c1
 \textSpannerDown
-\override TextSpanner #'bound-details #'left #'text =
+\override TextSpanner #'(bound-details left text) =
   \markup { \upright "rall" } 
 c2\startTextSpan b c\stopTextSpan a
 \break
 \textSpannerUp
-\override TextSpanner #'bound-details #'left #'text =
+\override TextSpanner #'(bound-details left text) =
   \markup { \italic "rit" } 
 c2\startTextSpan b c\stopTextSpan a
 @end lilypond
 
-@predefined
 
+@predefined
 @funindex textSpannerUp
 @code{\textSpannerUp},
 @funindex textSpannerDown
 @code{\textSpannerDown},
 @funindex textSpannerNeutral
 @code{\textSpannerNeutral}.
+@endpredefined
 
 
 @commonprop
@@ -302,7 +288,6 @@ Pour obtenir une ligne pleine, utilisez
 
 
 @seealso
-
 Référence du programme : @rinternals{TextSpanner}.
 
 
@@ -452,58 +437,16 @@ affectation à chacune des portées :
 
 
 @seealso
-
 Référence du programme : @rinternals{RehearsalMark}.
 
 
-@node New dynamic marks
-@unnumberedsubsubsec New dynamic marks
-
-Grâce à la commande @code{make-dynamic-script}, vous pouvez créer de
-nouvelles marques textuelles de nuances que vous combinerez
-éventuellement avec les signes de nuances.
-Notez bien que la police des nuances en contient que les caractères
-@code{f,m,p,r,s} and @code{z}. 
-
-Certains composants, tels que les marques de nuances, possèdent des
-propriétés particulières et prédéfinies quant à leur police.  Lorsque
-vous créez du texte en pareille situation, nous vous recommandons
-d'utiliser @code{normal-text} pour annuler ces propriétés.  Voir 
-@ref{Text markup commands} pour plus de détails.
-
-@cindex make-dynamic-script
-
-@lilypond[quote,verbatim,ragged-right]
-sfzp = #(make-dynamic-script "sfzp")
-\relative c' {
-  c4 c c\sfzp c
-}
-@end lilypond
-
-@cindex Nuances éditoriales
-@cindex Nuances, entre parenthèses
-
-Vous pouvez aussi encadrer les nuances entre parenthèses ou entre
-crochets.  Ceci est souvent utilisé pour ajouter des nuances propres à
-une édition donnée.
-
-@lilypond[quote,verbatim,ragged-right]
-rndf = \markup{ \center-align {\line { \bold{\italic (}
-  \dynamic f \bold{\italic )} }} }
-boxf = \markup{ \bracket { \dynamic f } }
-{ c'1_\rndf c'1_\boxf }
-@end lilypond
-
-
-
-@node Text markup
-@subsection Text markup
+@node Formatting text
+@subsection Formatting text
 
 @menu
 * Text markup introduction::    
 * Nested scores::               
 * Page wrapping text::          
-* Font selection::              
 @end menu
 
 @node Text markup introduction
@@ -545,7 +488,7 @@ pour traiter du texte avec LilyPond.
 
     \set Staff.instrumentName = \markup{ \column{ Alto solo } }
     c2^\markup{ don't be \flat }
-    \override TextSpanner #'bound-details #'left #'text = \markup{\italic rit }
+    \override TextSpanner #'(bound-details left text) = \markup{\italic rit }
     b2\startTextSpan
     a2\mark \markup{ \large \bold Fine }
     r2\stopTextSpan
@@ -586,17 +529,17 @@ En mode @emph{markup}, vous pouvez composer des expressions comme
 en mathématiques, des documents XML ou bien les expressions musicales.
 Vous pouvez empiler ces expressions grâce à la commande
 @code{\column}, ou les centrer par rapport à leur milieu avec
-@code{\center-align}. 
+@code{\center-column}. 
 
 @lilypond[quote,verbatim,fragment,relative=1]
 c1^\markup { \column { a bbbb \line { c d } } }
-c1^\markup { \center-align { a bbbb c } }
+c1^\markup { \center-column { a bbbb c } }
 c1^\markup { \line { a b c } }
 @end lilypond
 
 Des listes non précédées de commande ne sont pas isolées. Ainsi, 
 @example
-\center-align @{ @{ a b @} @{ c d @} @}
+\center-column @{ @{ a b @} @{ c d @} @}
 @end example
 
 @noindent
@@ -604,7 +547,7 @@ Des listes non précédées de commande ne sont pas isolées. Ainsi,
 est la même expression que
 
 @example
-\center-align @{ a b c d @}
+\center-column @{ a b c d @}
 @end example
 
 @noindent
@@ -614,10 +557,10 @@ différencier les listes de mots.
 
 @lilypond[quote,verbatim,fragment,relative=1]
 \textLengthOn
-c4^\markup{ \center-align { on three lines } }
-c4^\markup{ \center-align { "all one line" } }
-c4^\markup{ \center-align { { on three lines } } }
-c4^\markup{ \center-align { \line { on one line } } }
+c4^\markup{ \center-column { on three lines } }
+c4^\markup{ \center-column { "all one line" } }
+c4^\markup{ \center-column { { on three lines } } }
+c4^\markup{ \center-column { \line { on one line } } }
 @end lilypond
 
 Vous pouvez stocker les étiquettes textuelles en tant que variables,
@@ -656,7 +599,6 @@ en utilisant @code{normal-text}.  Pour plus d'informations, consultez
 
 
 @seealso
-
 Dans ce manuel : @ref{Text markup commands}.
 
 Référence du programme : @rinternals{TextScript}.
@@ -729,19 +671,20 @@ tour des lignes de texte, comme ici :
 Les différentes commandes permettant de générer des listes de lignes
 se trouve dans @ref{Text markup list commands}.
 
-@seealso
 
+@seealso
 Dans ce manuel : @ref{Text markup list commands}, 
 @ref{New markup list command definition}.
 
-@predefined
 
+@predefined
 @funindex \markuplines
-@code{\markuplines}
+@code{\markuplines}.
+@endpredefined
 
 
-@node Font selection
-@unnumberedsubsubsec Font selection
+@node Fonts
+@subsection Fonts
 
 @cindex sélection de polices
 @cindex grossissement des polices
@@ -845,9 +788,6 @@ du texte respectivement en roman, sans serif et monospace, comme ici :
 @c Apple TTF fonts
 
 
-
 @seealso
-
-Exemples : @lsr{text,font@/-family@/-override.ly}.
-
+Exemples : @rlsr{Text}.