Merge tag 'upstream/2.19.80' into debian-experimental

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

diff --git a/Documentation/fr/notation/text.itely b/Documentation/fr/notation/text.itely
index 345543a5852f6f666a1455736aa291a0ab4c1cc8..305e2e797acbc55da253a4c3a2de98bb01ab13d8 100644 (file)
--- a/Documentation/fr/notation/text.itely
+++ b/Documentation/fr/notation/text.itely
@@ -1,7 +1,7 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
 
 @ignore
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
 
 @ignore

-   Translation of GIT committish: 1e5c6b0f54079eb3285dcc4c7e53f17d8bb03933
+   Translation of GIT committish: f9d8763d2e83aa653582123d79731e029aea83d9

 
    When revising a translation, copy the HEAD committish of the
    version that you are working on.  For details, see the Contributors'
 
    When revising a translation, copy the HEAD committish of the
    version that you are working on.  For details, see the Contributors'


@@ -1451,18 +1451,54 @@ que des accolades ouvrantes.  Pour obtenir une accolade fermante, il
 suffit d'appliquer une rotation au glyphe sélectionné, comme indiqué à
 la rubrique @ref{Rotation des objets}.
 
 suffit d'appliquer une rotation au glyphe sélectionné, comme indiqué à
 la rubrique @ref{Rotation des objets}.
 

-Vous disposez de trois familles de fontes textuelles :
-@itemize
-@item
-@emph{roman} pour la police sérif ou avec empattement -- fixée par
-défaut à LilyPond Serif (alias de TeX Gyre Schola),
-@item
-une police sans empattement (@emph{sans} sérif) -- fixée par défaut à
-LilyPond Sans Serif (alias de TeX Gyre Heros) et
-@item
-une police à chasse fixe (monospace ou @emph{typewriter}) -- fixée par
-défaut à LilyPond Monospace (alias de TeX Gyre Cursor).
-@end itemize
+Vous disposez de trois familles de fontes textuelles : @emph{roman} pour
+la police sérif ou avec empattement, une police sans empattement
+(@emph{sans} sérif) et une police à chasse fixe (monospace ou
+@emph{typewriter}).
+
+Pour le moteur @code{svg} :
+@multitable @columnfractions .15 .30
+@headitem Famille @tab Fonte par défaut
+@item @emph{roman} @tab @code{serif}
+@item @emph{sans} @tab @code{sans-serif}
+@item @emph{typewriter} @tab @code{monospace}
+@end multitable
+
+@code{serif}, @code{sans-serif} et @code{monospace} sont des
+@code{generic-family} au titre des spécifications SVG et CSS.
+
+Pour les autres moteurs :
+@multitable @columnfractions .15 .30 .55
+@headitem Famille @tab Fonte par défaut (alias) @tab Listes de définition des alias
+@item @emph{roman}
+@tab @code{LilyPond Serif}
+@tab
+TeX Gyre Schola,
+C059, Century SchoolBook URW, Century Schoolbook L,
+DejaVu Serif,
+..., serif
+@item @emph{sans}
+@tab @code{LilyPond Sans Serif}
+@tab
+TeX Gyre Heros,
+Nimbus Sans, Nimbus Sans L, DejaVu Sans,
+..., sans-serif
+@item @emph{typewriter}
+@tab @code{LilyPond Monospace}
+@tab
+TeX Gyre Cursor,
+Nimbus Mono PS, Nimbus Mono, Nimbus Mono L,
+DejaVu Sans Mono,
+..., monospace
+@end multitable
+
+@code{LilyPond Serif}, @code{LilyPond Sans Serif} et @code{LilyPond
+Monospace} sont des alias de fonte définis dans le fichier de
+configuration de FontConfig spécifique à LilyPond
+@code{00-lilypond-fonts.conf}.  Lorsqu'un caractère est absent de la
+première fonte listée, il sera remplacé par celui de la fonte suivante.
+Pour plus de détails sur les définitions des alias, consultez le fichier
+@code{00-lilypond-fonts.conf} dans le répertoire d'installation.

 
 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
 
 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


@@ -1507,6 +1543,44 @@ dispose d'une syntaxe allégée comme nous l'avons vu dans
 }
 @end lilypond
 
 }
 @end lilypond
 

+@noindent
+Le recours aux fontes OpenType permet d'utiliser certaines
+fonctionnalités de ces fontes.  Toutefois, les fontes OpenType ne
+disposent pas toutes de l'intégralité de ces fonctions.  Dans le cas où
+la fonctionnalité demandée n'est pas disponible dans la fonte choisie,
+cette fonctionnalité est tout bonnement ignorée.
+
+@lilypond[quote,verbatim]
+% Vraies petites capitales
+\markup { Style normal : Hello HELLO }
+\markup { \caps { Petites capitales : Hello } }
+\markup { \override #'(font-features . ("smcp"))
+          { Vraies petites capitales : Hello } }
+
+% Styles numériques
+\markup { Style numérique normal : 0123456789 }
+\markup { \override #'(font-features . ("onum"))
+          { Style numérique ancien : 0123456789 } }
+
+% Alternatives stylistiques
+\markup { \override #'(font-features . ("salt 0"))
+          { Alternative stylistique 0 : εφπρθ } }
+\markup { \override #'(font-features . ("salt 1"))
+          { Alternative stylistique 1 : εφπρθ } }
+
+% Fonctionnalités multiples
+\markup { \override #'(font-features . ("onum" "smcp" "salt 1"))
+          { Fonctionnalités multiples : Hello 0123456789 εφπρθ } }
+@end lilypond
+
+@noindent Une liste exhaustive des fonctionnalités des fontes OpenType
+est disponible à l'adresse
+@uref{https://www.microsoft.com/typography/otspec/featurelist.htm}
+
+@noindent Les différents types de fonctionnalité des fontes OpenType
+sont recensées dans le message
+@uref{http://lists.gnu.org/archive/html/lilypond-devel/2017-08/msg00004.html}
+

 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 :
 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 :


@@ -1610,12 +1684,91 @@ d'explications sur les fontes, relisez @ref{Tout savoir sur les fontes}.
 }
 @end lilypond
 
 }
 @end lilypond
 

+Note : @code{make-pango-font-tree} réinitialise les fontes musicales à
+leur valeur par défaut, à savoir Emmentaler.
+

 @c we don't do Helvetica / Courier, since GS incorrectly loads
 @c Apple TTF fonts
 
 @c we don't do Helvetica / Courier, since GS incorrectly loads
 @c Apple TTF fonts
 

+La syntaxe suivante permet de substituer une fonte particulière tout en
+laissant les autres à leur valeur par défaut. L'exemple ci-dessous
+produit les mêmes effets que celui utilisant
+@code{make-pango-font-tree}. De même qu'avec
+@code{make-pango-font-tree}, il est possible de fournir une liste de
+fontes séparées par une virgule pour les catégories @code{roman},
+@code{sans} et @code{typewriter}. Dès lors que la taille de portée reste
+à sa valeur par défaut de 20 pt, l'instruction
+@code{#:factor (/ staff-height pt 20)} n'est pas nécessaire.
+
+@funindex set-global-fonts
+
+@example
+\paper @{
+  #(define fonts
+    (set-global-fonts
+     #:roman "Times New Roman"
+     #:sans "Nimbus Sans,Nimbus Sans L"
+     #:typewriter "Luxi Mono"
+     #:factor (/ staff-height pt 20) ; inutile si taille de portée par défaut
+    ))
+@}
+@end example
+
+Il est aussi posible de substituer les fontes musicales. L'exemple
+ci-dessous produit les mêmes effets que ceux qui précèdent dans la
+mesure où les fontes musicales sont fixées à leur valeur par défaut.
+Pour de plus amples informations, voir
+@ref{Changement des fontes musicales}.
+
+@example
+\paper @{
+  #(define fonts
+    (set-global-fonts
+     #:music "emmentaler"            ; défaut
+     #:brace "emmentaler"            ; défaut
+     #:roman "Times New Roman"
+     #:sans "Nimbus Sans,Nimbus Sans L"
+     #:typewriter "Luxi Mono"
+     #:factor (/ staff-height pt 20) ; inutile si taille de portée par défaut
+    ))
+@}
+@end example
+
+En tout état de cause, tout appel à @code{set-global-fonts} réinitialise
+aussi bien les fontes musicales que les fontes textuelles. Dès lors que
+l'une de ces catégories n'est pas mentionnée sera utilisée la fonte par
+défaut y afférente.@*
+Par ailleurs, chaque appel à @code{set-global-fonts} affecte les fontes
+du bloc @code{\book} qui le suit ; chaque bloc @code{\book} consécutif
+peut donc disposer de son propre jeu de fontes grâce à un simple appel à
+@code{set-global-fonts}, comme ici :
+
+@example
+\paper @{
+  #(define fonts
+    (set-global-fonts
+     @dots{}
+    ))
+@}
+\book @{
+  @dots{}
+@}
+
+\paper @{
+  #(define fonts
+    (set-global-fonts
+     @dots{}
+    ))
+@}
+\book @{
+  @dots{}
+@}
+@end example
+

 @seealso
 Manuel de notation :
 @ref{Attribution d'une fonte en particulier},
 @rusernamed{Font,Fonte},
 @seealso
 Manuel de notation :
 @ref{Attribution d'une fonte en particulier},
 @rusernamed{Font,Fonte},

+@ref{Changement des fontes musicales},

 @ref{Sélection de la fonte et de la taille},
 @ref{Tout savoir sur les fontes}.
 @ref{Sélection de la fonte et de la taille},
 @ref{Tout savoir sur les fontes}.