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.tex91
1 files changed, 46 insertions, 45 deletions
diff --git a/macros/latex/contrib/babel-contrib/french/frenchb-doc.tex b/macros/latex/contrib/babel-contrib/french/frenchb-doc.tex
index 467181d9dc..c5100059d6 100644
--- a/macros/latex/contrib/babel-contrib/french/frenchb-doc.tex
+++ b/macros/latex/contrib/babel-contrib/french/frenchb-doc.tex
@@ -6,7 +6,6 @@
\usepackage{iftex}[2019/10/24]
\RequireLuaTeX
-\usepackage{xspace}
\usepackage{array,longtable}
\usepackage{varioref}
\renewcommand{\reftextpagerange}[2]{\pageref{#1}--\pageref{#2}}
@@ -122,11 +121,11 @@
\title{Mode d’emploi du module \ext{babel-french}}
\author{\href{mailto:daniel.flipo@free.fr}{Daniel \textsc{Flipo}}}
-\newcommand*{\latestversion}{3.5m}
+\newcommand*{\latestversion}{3.5n}
\date{Version {\latestversion} -- \today}
\begin{document}
-%\def\today{30 juillet 2020}
+\def\today{18 avril 2022}
\maketitle
\thispagestyle{empty}
@@ -147,7 +146,6 @@
La présente documentation en français est également disponible sur CTAN,
il n’y a plus besoin de la récupérer sur mon site
personnel {\expandafter\expandafter\expandafter\url{\urlperso/babel-french}}.
-
\end{abstract}
\bgroup
@@ -161,19 +159,6 @@
\vspace{-\baselineskip}\noindent
\descindentFB=0pt
\begin{description}
- \item[8 juillet 2014] Ajout des sections~\ref{ssec:captions}
- p.~\pageref{ssec:captions} (\textit{caption names}) et \ref{ssec:biblatex}
- p.~\pageref{ssec:biblatex} (\biblatex).
- \item[28 juillet 2014] Présentation des listes,
- configuration d’\ext{enumitem} (section~\ref{ssec:lists}).
- \item[16 sept. 2014] Ajout de l’option \fbo{SmallCapsFigTabCaptions},
- voir p.~\pageref{scfigtab}.
- \item[9 avril 2015] Charger \ext{listings} après \ext{babel}
- (section~\ref{sec:Incomp}).
- \item[14 février 2016] Adaptation à la version 3.2a, voir
- section~\ref{ssec:changes-3.2}.
- \item[30 mars 2016] Charger \ext{subcaption} après \ext{babel}
- (section~\ref{sec:Incomp}).
\item[14 mai 2016] Mise à jour pour TeXLive~2016,
voir section~\ref{ssec:changes-3.2}. L’historique des changements
antérieurs à la version~3.0 a été supprimé.
@@ -199,6 +184,8 @@
voir p.~\pageref{listspacing}.
\item[14 mars 2019] Nouvelle commande |\NoEveryParQuote|, voir
p.~\pageref{frquote}.
+ \item[18 avril 2022] Nouvelle commande |\bname{}|, variante sans petites
+ capitales de |\bsc{}| voir p.~\pageref{bname}.
\end{description}
\end{abstract}
\egroup
@@ -458,21 +445,20 @@ au comportement standard de LaTeX (typographie américaine).
Des commandes ont été prévues pour faciliter la saisie :
\begin{itemize}
-\item Les guillemets peuvent être saisis grâce aux commandes |\og| et |\fg|%
- \footnote{Si les caractères « et » sont accessibles au clavier,
- ils peuvent être utilisés pour saisir les guillemets, voir
- la fin de la section~\ref{sec:Perso}, p.~\pageref{og-fg}.},
- ce qui donne selon la langue de travail « guillemets français » ou
- \begin{otherlanguage}{english}``english quotes’’\end{otherlanguage}.
+\item Les guillemets français peuvent être saisis grâce à la commande
+ |\frquote{|\textit{texte}|}| qui affiche \frquote{\textit{texte}}
+ avec les espaces insécables adéquats. Il est également possible de coder
+ |\og texte\fg{}| (ancienne syntaxe toujours valide).
+
+ Si les caractères « et » sont accessibles au clavier%
+ \footnote{grâce à une touche \texttt{Compose} par exemple…},
+ ils peuvent être utilisés pour saisir les guillemets français, voir
+ la fin de la section~\ref{sec:Perso}, p.~\pageref{og-fg}.
Notez que les guillemets français ne devraient \emph{jamais} être saisis
avec |<<| et |>>| contrairement à ce qui se fait avec
{e-French} (voir section~\ref{sec:CompatFP}).
- Depuis la version~3.1, une alternative, |\frquote{|\textit{texte}|}|, est
- proposée pour la saisie des guillemets français avec l’espace adéquat,
- le résultat est \frquote{\textit{texte}}.
-
L’usage de |\frquote{}| est recommandé pour les citations longues
(c.-à-d. s’étendant sur plus d’un paragraphe) et pour les citations
imbriquées.\hlabel{frquote}
@@ -584,12 +570,21 @@ vertical des lettres supérieures simulées par |\fup|
(voir dans le code de \file{frenchb.dtx} les commandes |\FBsupS| et
|\FBsupR|).
-\item L’usage français veut que les noms propres soient imprimés en
- petites capitales et ne soient pas coupés en bout de ligne, la commande
- |\bsc| (\textit{boxed small caps}) en facilite la saisie :
- on saisira par exemple |Leslie~\bsc{Lamport}| pour
- obtenir Leslie~\bsc{Lamport} sans risque de coupure \textsc{Lam-port}
- en bout de ligne.
+\item Les commandes |\bname{}|\label{bname} (\textit{boxed name})
+ et |\bsc{}| (\textit{boxed small caps}) facilitent la saisie des noms
+ propres : toutes deux empêchent la coupure de leur argument, sauf au niveau
+ du tiret pour les noms composés ;
+ la seconde imprime son argument en petites capitales, ce qui est d’usage par
+ exemple dans les bibliographies ou les signatures.\\
+ Exemples : |\bname{Montesquieu}|, |Albert~\bsc{Camus}|.\\
+ N.B. Ces commandes ne mettent pas leur argument dans une |\mbox{}|, leur
+ effet n’est pas aussi radical : un |\kern0pt| inhibe toute coupure du mot
+ suivant, ce qui marche bien pour les noms simples ou composés avec un tiret
+ et a l’avantage de préserver l’expansion éventuellement faite par
+ \pkg{microtype}. Les patronymes à particule peuvent poser problème : coder
+ |Jean~\bname{de La Fontaine}| n’aurait strictement aucun effet (les coupures
+ après `de’, après `La’ ou `Fon-taine’ restent possibles), en revanche
+ |Jean~de~La~\bname{Fontaine}| empêcherait toute coupure.
\item les commandes |\primo|, |\secundo|,
|\tertio| et |\quarto| peuvent
@@ -598,8 +593,8 @@ vertical des lettres supérieures simulées par |\fup|
Ensuite, |\FrenchEnumerate{6}| donne \FrenchEnumerate{6}.
\item Les abréviations de «numéro», \No, \Nos, \no{} et \nos, sont obtenues
- en tapant |\No|, |\Nos|, |\no| et |\nos| ;
- l’espace qui suit est insécable : coder |\no1| ou |\no 1|.
+ en tapant |\No|, |\Nos|, |\no| et |\nos| ; elles incluent
+ une espace insécable finale : coder |\no1| ou |\no 1| suffit.
\item Le caractère \degre{} (à ne pas confondre avec le petit «o» de \No)
est saisi |\degre|, mais comme les espaces avant
@@ -659,7 +654,10 @@ les commandes
|\ieme|, |\iemes|,
|\fg| et |\dots| sont
respectés sans avoir à les forcer par des |{}| ou
-des~\code{\boi\textvisiblespace}.
+des~\code{\boi\textvisiblespace}. Noter cependant que l’auteur de \pkg{xspace}
+ne recommande plus vraiment son utilisation, aussi peut-on préférer
+\emph{ne pas charger} \pkg{xspace} et gérer les espaces soi-même :
+« |les 1\ier, 2 et 3~mai| » ou « |le 1\ier~mai| » (espace insécable).
\section{Personnalisation}
\label{sec:Perso}
@@ -982,13 +980,12 @@ La liste étant longue, les options sont regroupées par thèmes.
\fbsetup{} sont optionnels.} ;
\hlabel{og-fg} lorsqu’on dispose de guillemets français au
clavier (grâce à une touche \textit{compose} par exemple), cette option permet
- d’utiliser directement ces guillemets à la place des commandes |\og| et |\fg|%
- \footnote{Toutefois, si des guillemets doivent être utilisés dans une
- commande \cs{index}, ils \emph{doivent} être codés en \cs{og} et
- \cs{fg}.}.
- On peut ainsi saisir \code{«guillemets»} ou \code{« guillemets »} (avec ou
- sans espaces à l’intérieur) pour obtenir «guillemets» avec espaces
- insécables adéquates en français. En revanche, si on active cette option,
+ d’utiliser directement ces guillemets à la place des commandes |\frquote{}|
+ ou |\og| et |\fg|.
+ On peut ainsi saisir \code{«guillemets»} (sans espace) ou
+ \code{« guillemets »} (avec espaces à l’intérieur) pour obtenir «guillemets»
+ avec les espaces insécables adéquates en français. En revanche, si on active
+ cette option,
\emph{il ne faut pas coder explicitement les espaces insécables} :
\code{«}|~|\code{guillemets}|~|\code{»}
produirait «~guillemets~» où l’espace qui suit le guillemet ouvrant est
@@ -1551,6 +1548,10 @@ etc.) sont maintenant prises en compte correctement.
|\textorpdfstring{}{}| (suggestion de l’équipe LaTeX3).
\end{itemize}
+La commande |\bname{}| (voir section~\pageref{bname}) a été ajoutée en
+version~3.5n, la documentation concernant la commande |\bsc{}| a été revue
+comme celle concernant la saisie des guillemets.
+
\subsection{Changements entre les versions 3.4d et 3.3d}
\label{ssec:changes-3.4}
@@ -1899,9 +1900,9 @@ cette liste.
virgule par une espace fine.
\item Dans une commande |\index{}|, les guillemets français doivent
- obligatoirement être codés sous la forme |\og|, |\fg| :
+ obligatoirement être codés sous la forme |\frquote{}| (ou |\og|, |\fg|) :
\hlabel{ch-doc4}
- |\index{\og toto\fg}| donne le résultat attendu, tandis que
+ |\index{\frquote{toto}| donne le résultat attendu, tandis que
|\index{«toto»}| provoque soit une erreur à la compilation (en LaTeX),
soit un mauvais classement de l’entrée |«toto»| dans l’index (en
XeLaTeX et LuaLaTeX).