summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/babel-contrib/french/frenchb-doc.tex
diff options
context:
space:
mode:
Diffstat (limited to 'macros/latex/contrib/babel-contrib/french/frenchb-doc.tex')
-rw-r--r--macros/latex/contrib/babel-contrib/french/frenchb-doc.tex144
1 files changed, 75 insertions, 69 deletions
diff --git a/macros/latex/contrib/babel-contrib/french/frenchb-doc.tex b/macros/latex/contrib/babel-contrib/french/frenchb-doc.tex
index 4b639840da..8fd5aa56d5 100644
--- a/macros/latex/contrib/babel-contrib/french/frenchb-doc.tex
+++ b/macros/latex/contrib/babel-contrib/french/frenchb-doc.tex
@@ -11,26 +11,26 @@
\usepackage{url,alltt,shortvrb}
\usepackage{graphics}
\usepackage[dvipsnames]{xcolor}
-\usepackage{luatexbase} %%% Provisoire : pour microtype
%%% Fontes OpenType avec moteur LuaTeX : Erewhon/Cabin/Inconsolata
-\usepackage{fourier-otf}
+\usepackage[no-math]{fontspec}
\usepackage{realscripts}
-\setsansfont{Cabin}[Scale=MatchLowercase]
+\setmainfont{erewhon}
+%\setsansfont{Cabin}[Scale=MatchLowercase]
\setmonofont{Inconsolatazi4}% voir inconsolata-doc.pdf
- [Scale=MatchLowercase, HyphenChar=None, StylisticSet={2,3},
- ItalicFont = *-Regular, ItalicFeatures={FakeSlant=0.225}, % 13°
- SlantedFont= *-Regular, SlantedFeatures={FakeSlant=0.225},
- BoldItalicFont = *-Bold, BoldItalicFeatures={FakeSlant=0.225},
- BoldSlantedFont= *-Bold, BoldSlantedFeatures={FakeSlant=0.225},
- ]
+ [Scale=MatchLowercase, HyphenChar=None, StylisticSet={2,3},
+ ItalicFont = *-Regular, ItalicFeatures={FakeSlant=0.225}, % 13°
+ SlantedFont= *-Regular, SlantedFeatures={FakeSlant=0.225},
+ BoldItalicFont = *-Bold, BoldItalicFeatures={FakeSlant=0.225},
+ BoldSlantedFont= *-Bold, BoldSlantedFeatures={FakeSlant=0.225},
+ ]
%%% *** APRÈS fontspec ***
\usepackage{babel}
\frenchbsetup{og=«, fg=», AutoSpacePunctuation=false}
\frenchbsetup{ListItemsAsPar}
-\usepackage[babel=true,expansion=true,protrusion=true]{microtype}
+\usepackage{microtype}
% Mise en page
\usepackage[textwidth=160mm,textheight=247mm,hmarginratio=1:1
@@ -58,8 +58,7 @@
\def\verbatim@font{\ColorVerb\verbatim@fontORI}
\makeatother
% options de frenchb :
- \def\ColorArg{\color{Sepia}}
-% N.B. URL color = ForestGreen
+\def\ColorArg{\color{Sepia}}
%
\newcommand*{\file}[1]{\texttt{\ColorVerb #1}}
\newcommand*{\cls}[1]{\texttt{\ColorVerb #1}}
@@ -72,12 +71,13 @@
\newcommand*{\lang}[1]{\texttt{\ColorVerb #1}}
\newcommand*{\code}[1]{\texttt{\ColorVerb #1}}
\newcommand*{\argum}[1]{\textit{#1}}
-\newcommand*{\meta}[1]{\textit{\ColorArg #1}}
+\newcommand*{\meta}[1]{\textit{< #1 >}}
+\newcommand*{\LEFTmargin}{\texttt{<=}}
\providecommand\marg[1]{% % from ltxdoc.cls
- {\ttfamily\char`\{}\meta{#1}{\ttfamily\char`\}}}
+ {\ttfamily\char`\{}\textit{\ColorArg #1}{\ttfamily\char`\}}}
\providecommand\oarg[1]{%
- {\ttfamily[}\meta{#1}{\ttfamily]}}
+ {\ttfamily[}\textit{\ColorArg #1}{\ttfamily]}}
\DeclareRobustCommand\cs[1]{\texttt{\ColorVerb \char`\\#1}}% from ltxdoc.cls
\newcommand*\fbo[1]{\texttt{\ColorArg #1}}
@@ -113,8 +113,8 @@
unicode,
bookmarksopen,
colorlinks,
- urlcolor=ForestGreen,
- linkcolor=black, % appel note bas de page en noir
+ urlcolor=PineGreen,
+ linkcolor=Blue,
}
\newcommand*{\hlabel}[1]{\phantomsection\label{#1}}
% notes bas de page consécutives avec le même numéro
@@ -125,11 +125,11 @@
%
\title{Documentation sur le module \ext{babel-french}}
\author{\href{mailto:daniel.flipo@free.fr}{Daniel \textsc{Flipo}}}
-\newcommand*{\latestversion}{3.5g}
+\newcommand*{\latestversion}{3.5h}
\date{Version {\latestversion} -- \today}
\begin{document}
-\def\today{30 janvier 2020}
+\def\today{18 avril 2020}
\maketitle
\thispagestyle{empty}
@@ -198,7 +198,8 @@
\item[6 juillet 2018] Nouvelle option \fbo{ListItemsAsPar},
voir p.~\pageref{ListAsPar}.
\item[24 janvier 2019] L’option \fbo{StandardListSpacing=true} est à utiliser
- de préférence à \fbo{ReduceListSpacing=false}, voir p.~\pageref{ListAsPar}.
+ de préférence à \fbo{ReduceListSpacing=false},
+ voir p.~\pageref{listspacing}.
\item[14 mars 2019] Nouvelle commande |\NoEveryParQuote|, voir
p.~\pageref{frquote}.
\end{description}
@@ -213,7 +214,7 @@
\newpage
\section{Appel de l’extension Babel}
-Babel est installé en standard dans toutes distributions \LaTeXe,
+Babel est installé en standard dans toutes distributions LaTeX,
pour disposer des langues française et anglaise%
\footnote{En fait américaine (US-english), il existe une variante
\opt{british} pour l’anglais « britannique ».},
@@ -257,11 +258,11 @@ par exemple |\selectlanguage{british}| et pour revenir en français
Pour passer \emph{localement} dans une autre langue on peut utiliser
l’environnement \\
|\begin{otherlanguage}{|\argum{langue}|}|\\
-\hspace*{1em}\argum{texte\dots}\\
+\hspace*{1em}\argum{texte…}\\
|\end{otherlanguage}|\\
ou pour une courte citation dans un paragraphe\\
|\foreignlanguage{|\argum{langue}%
-|}{|\argum{texte\dots}|}|.
+|}{|\argum{texte…}|}|.
Depuis la version~3.10 de Babel, une syntaxe allégée est proposée pour les
changements de langue : en ajoutant par exemple dans le préambule
@@ -341,7 +342,8 @@ principale, \ext{babel-french} ne modifie en rien la présentation globale du
document : celle-ci est imposée uniquement par la classe et les autres
extensions chargées.
-Lorsque le français est la langue principale, la présentation globale du
+\goodbreak
+Lorsque le français est la langue principale, la présentation du
document (ou maquette) est modifiée de la façon suivante%
\footnote{Il est possible, pour chacun des points suivants, de revenir aux
réglages standard de LaTeX, voir section~\ref{sec:Perso}.} :
@@ -441,7 +443,9 @@ produit les effets suivants :
supprimer l’espace qui suit (cet espace est gênant devant une
parenthèse par exemple\dots)%
\footnote{Certains auteurs préfèrent en français «...» (codé \code{...}
- sans espace) à «\dots» (codé \cs{dots}).}.
+ sans espace) à «\dots» (codé \cs{dots}). Le mieux est d’utiliser
+ directement le caractère … dans le texte source dès lors que celui-ci est
+ codé en utf-8.}.
\item La commande |\today| retourne la date en français.
@@ -481,6 +485,11 @@ Des commandes ont été prévues pour faciliter la saisie :
au début de chaque paragraphe, sauf si \fbo{EveryParGuill=close} (guillemet
fermant dans ce cas) ou si \fbo{EveryParGuill=none} (aucun ajout).
+ Une commande |\NoEveryParQuote| permet de supprimer localement des guillemets
+ de début de paragraphe ajoutés inconsidérément par la commande |\frquote{}|
+ notamment dans les listes (après les labels) ; elle doit être utilisée dans
+ un environnement ou un groupe pour en limiter la portée.
+
Pour les citations imbriquées, plusieurs présentations sont proposées selon
les options choisies :
\begin{itemize}
@@ -503,6 +512,7 @@ Des commandes ont été prévues pour faciliter la saisie :
ce faire, il suffit de coder la citation interne avec |\frquote*{}| au lieu
de |\frquote{}|.
+\pagebreak
Exemple de citation imbriquée :
\vspace{0.5\baselineskip}
@@ -546,11 +556,6 @@ Le codage est le suivant :
{\ttfamily\ColorVerb Xavier raconte… |\frquote{|Au moment… l’hôtesse m’a
dit tout bonnement : |\frquote*{|Je suis désolée, … en anglais.|}}|}
- Une commande |\NoEveryParQuote| permet de supprimer localement des guillemets
- de début de paragraphe ajoutés inconsidérément par la commande |\frquote{}|
- notamment dans les listes (après les labels) ; elle doit être utilisée dans
- un environnement ou un groupe pour en limiter la portée.
-
\item La commande |\up| facilite la saisie des exposants en mode texte :
|M\up{me}| imprime M\up{me},
|1\up{er}| donne 1\up{er} ; % 1\ier ;
@@ -654,7 +659,7 @@ vertical des lettres supérieures simulées par |\fup|
En ajoutant |\usepackage{xspace}| dans le préambule, les espaces suivant
les commandes
-|\ier|,\dots, |\ieres|,
+|\ier|,…, |\ieres|,
|\ieme|, |\iemes|,
|\fg| et |\dots| sont
respectés sans avoir à les forcer par des |{}| ou
@@ -677,8 +682,7 @@ utilisée par d’autres extensions comme \ext{geometry} ou \ext{hyperref}.
Le recours à un fichier de configuration \file{frenchb.cfg} a été supprimé en
version~3.0.
-\subsection[\textbackslash frenchsetup{}]
- {\fbsetup{\textsl{$\langle$options$\rangle$}}}
+\subsection[\textbackslash frenchsetup{}]{\fbsetup{\meta{options}}}
\label{ssec:frenchbsetup}
La commande \fbsetup{ShowOptions} affiche dans le fichier \file{.log} la liste
@@ -700,6 +704,7 @@ La liste étant longue, les options sont regroupées par thèmes.
\subsubsection*{Inventaire des options}
\begin{description}
+ \setlength{\labelsep}{0.1666em}
\item [ShowOptions=true (false)]
affiche dans le fichier \file{.log} toutes les options
disponibles, ce qui permet de retrouver leurs noms facilement.
@@ -756,7 +761,7 @@ La liste étant longue, les options sont regroupées par thèmes.
modifie (en général en les réduisant, sauf pour les classes SMF)
les espaces verticaux%
\footnote{Il s’agit de \cs{itemsep}, \cs{parsep}, \cs{topsep}
- et \cs{partopsep}.}
+ et \cs{partopsep}.} \label{listspacing}
dans \emph{toutes les listes} produites à partir de l’environnement
\env{list}, en particulier les listes \env{enumerate}, \env{itemize} et
\env{description} mais aussi \env{abstract}, \env{quote}, \env{quotation},
@@ -882,11 +887,12 @@ La liste étant longue, les options sont regroupées par thèmes.
Le moteur LuaTeX permet un contrôle fin de l’ajout d’espace devant le
deux-points : si ce caractère n’est pas précédé d’un espace et que celui qui
- le suit est de type \textit{glyphe} (lettre, chiffre, /, \textbackslash, etc.)
- aucune espace n’est ajoutée en sortie, ce qui évite les espaces parasites
- dans les URLs (ftp://monsite), les chemins MSDOS (C:\textbackslash) et les
- horaires (10:55). Avec XeTeX ou pdfTeX |\textsf{http://truc}| donne
- \textsf{http~://truc} (espace parasite avant le «:»).
+ le suit est de type \textit{glyphe} (lettre, chiffre, /, \textbackslash,
+ etc.) aucune espace n’est ajoutée en sortie, ce qui évite les espaces
+ parasites dans les URLs (ftp://monsite), les chemins MSDOS
+ (C:\textbackslash), les horaires (10:55) et les ratios (1:1).
+ Avec XeTeX ou pdfTeX |http://truc| et |1:1| donnent http~://truc et 1~:1
+ (espace parasite avant le «:»).
Il y a une autre exception avec les moteurs LuaTeX et XeTeX :
si l’utilisateur code une espace insécable U+00A0 (\emph{pas}
@@ -997,7 +1003,7 @@ La liste étant longue, les options sont regroupées par thèmes.
produit \foreignlanguage{german}{(»Auf Deutsch«)}. %»
Ceci fonctionne en (pdf)LaTeX pour les codages d’entrée 8-bits (latin1,
- latin9, ansinew, applemac,\dots) et pour les codages sur plusieurs octets
+ latin9, ansinew, applemac,…) et pour les codages sur plusieurs octets
comme utf8 ou utf8x. Ceci fonctionne également avec LuaLaTeX et XeLaTeX ;
avec ces deux derniers toutefois, comme pour la ponctuation haute,
\ext{babel-french} respecte les espaces insécables U+00A0 et U+202F (fine).
@@ -1164,7 +1170,7 @@ Commande Babel & Commande pour le français & Intitulé par défaut en français
\name{part} & Première partie, Deuxième partie…\\
\name{encl} & P.~J.\\
\name{cc} & Copie à \\
-\name{headto} & $\langle$\textit{vide}$\rangle$\\
+\name{headto} & \meta{vide}\\
\name{page} & page\\
\name{see} & voir\\
\name{also} & voir aussi\\*
@@ -1185,7 +1191,7 @@ fonctionne toujours.\hlabel{captionsfrench}
\emph{Attention}, dans les deux cas, le nom de la langue est
\emph{obligatoirement} \opt{french}, les variantes \opt{frenchb} ou
\opt{francais} seraient sans effet ! Les commandes
-|\acadianabstractname|, \dots, |\acadianproofname| sont, elles, définies
+|\acadianabstractname|, …, |\acadianproofname| sont, elles, définies
(comme leurs homologues françaises) et personnalisables pour le français du
Canada (option \lang{acadian}).
\par}
@@ -1225,15 +1231,15 @@ premier niveau sur le retrait (|\parindent|) de début de paragraphe) :\par
{\centering
\fbox{\begin{minipage}[t]{.40\textwidth}\raggedright
\FBListItemsAsParfalse \parindent=1.5em \listindentFB=1.5em
- \noindent$\Leftarrow$ Marge gauche\par
+ \noindent\LEFTmargin{} Marge gauche\par
Paragraphe précédant la liste
\begin{itemize}
- \item Premier élément sur plus d’une ligne\dots{}
+ \item Premier élément sur plus d’une ligne…
\begin{itemize}
\item Un élément niveau 2,
\item Second élément niveau 2,
\end{itemize}
- \item Second élément\dots
+ \item Second élément…
\end{itemize}
\end{minipage}}\par
}
@@ -1265,15 +1271,15 @@ listes \env{itemize}, \env{enumerate} et \env{description} :
\begin{minipage}[t]{.45\textwidth}
\fbox{\begin{minipage}[t]{0.9\textwidth}\raggedright
\FBListItemsAsParfalse \parindent=0pt \listindentFB=1.5em
- \noindent$\Leftarrow$ Marge gauche\par
+ \noindent\LEFTmargin{} Marge gauche\par
Paragraphe précédant la liste
\begin{itemize}
- \item Premier élément sur plus d’une ligne\dots{}
+ \item Premier élément sur plus d’une ligne…
\begin{itemize}
\item Un élément niveau 2,
\item Second élément niveau 2,
\end{itemize}
- \item Second élément\dots
+ \item Second élément…
\end{itemize}
\end{minipage}
}\\
@@ -1284,15 +1290,15 @@ listes \env{itemize}, \env{enumerate} et \env{description} :
\hspace*{\fill}
\fbox{\begin{minipage}[t]{.9\textwidth}\raggedright % .72
\FBListItemsAsParfalse \parindent=0em \listindentFB=0em
- \noindent$\Leftarrow$ Marge gauche\par
+ \noindent\LEFTmargin{} Marge gauche\par
Paragraphe précédant la liste
\begin{itemize}
- \item Premier élément sur plus d’une ligne\dots{}
+ \item Premier élément sur plus d’une ligne…
\begin{itemize}
\item Un élément niveau 2,
\item Second élément niveau 2,
\end{itemize}
- \item Second élément\dots
+ \item Second élément…
\end{itemize}
\end{minipage}
}\hspace*{\fill}\\
@@ -1312,15 +1318,15 @@ listes \env{itemize}, \env{enumerate} et \env{description} :
\begin{minipage}[t]{.45\textwidth}
\fbox{\begin{minipage}[t]{.9\textwidth}\raggedright
\FBListItemsAsParfalse \parindent=1.5em \listindentFB=1.5em
- \noindent$\Leftarrow$ Marge gauche\par
+ \noindent\LEFTmargin{} Marge gauche\par
Paragraphe précédant la liste
\begin{enumerate}
- \item Premier élément sur plus d’une ligne\dots{}
+ \item Premier élément sur plus d’une ligne…
\begin{enumerate}
\item Un élément niveau 2,
\item Second élément niveau 2,
\end{enumerate}
- \item Second élément\dots
+ \item Second élément…
\end{enumerate}
\end{minipage}
}\\
@@ -1334,16 +1340,16 @@ listes \env{itemize}, \env{enumerate} et \env{description} :
\hspace*{\fill}
\fbox{\begin{minipage}[t]{0.9\textwidth}\raggedright
\FBListItemsAsParfalse \parindent=1.5em \listindentFB=1.5em
- \noindent$\Leftarrow$ Marge gauche\par
+ \noindent\LEFTmargin{} Marge gauche\par
Paragraphe précédant la liste
\begin{enumerate}
- \item Premier élément sur plus d’une ligne\dots{}
+ \item Premier élément sur plus d’une ligne…
\settowidth{\labelwidthFB}{(a)}%
\begin{enumerate}
\item Un élément niveau 2,
\item Second élément niveau 2,
\end{enumerate}
- \item Second élément\dots
+ \item Second élément…
\end{enumerate}
\end{minipage}
}\hspace*{\fill}\\
@@ -1367,15 +1373,15 @@ listes \env{itemize}, \env{enumerate} et \env{description} :
\fbox{\begin{minipage}[t]{0.9\textwidth}\raggedright
\FBListItemsAsParfalse
\parindent=0pt \listindentFB=1.5em \descindentFB=1.5em
- \noindent$\Leftarrow$ Marge gauche\par
+ \noindent\LEFTmargin{} Marge gauche\par
Paragraphe précédant la liste
\begin{description}
- \item [Premier] élément occupant plus d’une ligne\dots{}
+ \item [Premier] élément occupant plus d’une ligne…
\begin{itemize}
\item Un élément niveau 2,
\item Second élément niveau 2,
\end{itemize}
- \item [Second] élément\dots
+ \item [Second] élément…
\end{description}
\end{minipage}
}\\
@@ -1387,15 +1393,15 @@ listes \env{itemize}, \env{enumerate} et \env{description} :
\fbox{\begin{minipage}[t]{.9\textwidth}\raggedright % .72
\FBListItemsAsParfalse
\parindent=0pt \listindentFB=1.5em \descindentFB=0pt
- \noindent$\Leftarrow$ Marge gauche\par
+ \noindent\LEFTmargin{} Marge gauche\par
Paragraphe précédant la liste
\begin{description}
- \item [Premier] élément occupant plus d’une ligne\dots{}
+ \item [Premier] élément occupant plus d’une ligne…
\begin{itemize}
\item Un élément niveau 2,
\item Second élément niveau 2,
\end{itemize}
- \item [Second] élément\dots
+ \item [Second] élément…
\end{description}
\end{minipage}
}\hspace*{\fill}\\
@@ -1424,7 +1430,7 @@ sections~\ref{sec:description} (listes \env{itemize}) et
\begin{minipage}[t]{.45\textwidth}
\fbox{\begin{minipage}[t]{0.9\textwidth}\raggedright
\FBListItemsAsParfalse \parindent=1.5em \listindentFB=1.5em
- \noindent$\Leftarrow$ Marge gauche\par
+ \noindent\LEFTmargin{} Marge gauche\par
Paragraphe précédant la liste et qui s’étend sur deux lignes.
\begin{itemize}
\item Premier élément qui se prolonge sur plusieurs…
@@ -1432,7 +1438,7 @@ sections~\ref{sec:description} (listes \env{itemize}) et
\item Un élément niveau 2,
\item Second élément niveau 2 sur plus d’une ligne…
\end{itemize}
- \item Second élément\dots
+ \item Second élément…
\end{itemize}
\end{minipage}
}\\
@@ -1443,7 +1449,7 @@ sections~\ref{sec:description} (listes \env{itemize}) et
\hspace*{\fill}
\fbox{\begin{minipage}[t]{.9\textwidth}\raggedright % .72
\FBListItemsAsPartrue \parindent=1.5em \listindentFB=1.5em
- \noindent$\Leftarrow$ Marge gauche\par
+ \noindent\LEFTmargin{} Marge gauche\par
Paragraphe précédant la liste et qui s’étend sur deux lignes.
\begin{itemize}
\item Premier élément qui se prolonge sur plusieurs lignes…
@@ -1451,7 +1457,7 @@ sections~\ref{sec:description} (listes \env{itemize}) et
\item Un élément niveau 2,
\item Second élément niveau 2 sur plus d’une ligne…
\end{itemize}
- \item Second élément\dots
+ \item Second élément…
\end{itemize}
\end{minipage}
}\hspace*{\fill}\\
@@ -1515,7 +1521,7 @@ est inchangée.
Quelques bogues affectant la commande |\frquote{}| ont été corrigées dans les
versions 3.5b à 3.5d. Cette dernière introduit une nouvelle option
\fbo{StandardListSpacing} à utiliser à la place de \fbo{ReduceListSpacing},
-voir p.~\pageref{ListAsPar}. La présente documentation est maintenant
+voir p.~\pageref{listspacing}. La présente documentation est maintenant
incluse dans la distribution \ext{babel-french} sur CTAN.
La commande |\NoEveryParQuote| a été ajoutée en version~3.5e, voir
@@ -1751,7 +1757,7 @@ avec ces moteurs%
cette section ne concerne \emph{que les vieux moteurs} TeX’82 et pdfTeX.
Normalement, le nécessaire est fait par Babel pour que les caractères rendus
-actifs ne perturbent pas les autres extensions\dots{} mais il y a hélas des
+actifs ne perturbent pas les autres extensions… mais il y a hélas des
exceptions (\ext{tikz}, \ext{xypic}, \ext{xcolor}, \ext{autonum}, \ext{arabtex},
\ext{cleveref} par exemple). Il faut savoir que les caractères
rendus actifs par une langue \emph{le restent dans tout le document}, repasser