From 97a12e763d6717c510787651d9d1cc62198f3ac1 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Sat, 18 Apr 2020 20:56:42 +0000 Subject: babel-french (18apr20) git-svn-id: svn://tug.org/texlive/trunk@54787 c570f23f-e606-0410-a88d-b1316a301751 --- .../texmf-dist/doc/generic/babel-french/README.md | 12 +- .../doc/generic/babel-french/frenchb-doc.pdf | Bin 156507 -> 153525 bytes .../doc/generic/babel-french/frenchb-doc.tex | 144 +++++++++++---------- .../doc/generic/babel-french/frenchb.pdf | Bin 246075 -> 308091 bytes 4 files changed, 83 insertions(+), 73 deletions(-) (limited to 'Master/texmf-dist/doc') diff --git a/Master/texmf-dist/doc/generic/babel-french/README.md b/Master/texmf-dist/doc/generic/babel-french/README.md index 103c7cc15a4..50845e36843 100644 --- a/Master/texmf-dist/doc/generic/babel-french/README.md +++ b/Master/texmf-dist/doc/generic/babel-french/README.md @@ -1,7 +1,8 @@ The babel-french package (formerly known as `frenchb') ====================================================== -## Description +Description +----------- This package provides support for the French language for the babel multilingual system. @@ -20,7 +21,8 @@ The bundle consists of the following files: * frenchb-doc.tex: source file of frenchb-doc.pdf, * README.md (this file). -## License +License +------- Released under the LaTeX Project Public License v1.3 or later See http://www.latex-project.org/lppl.txt @@ -36,12 +38,14 @@ distribution, do the following: (default location: $TEXMF/tex/generic/babel-french/); * rebuild the database (mktexlsr or so). -## Documentation +Documentation +------------- See the included manuals for usage instructions: frenchb.pdf in English or the French documentation frenchb-doc.pdf. -## Changes +Changes +------- See the included manual frenchb.pdf, section "Change History". diff --git a/Master/texmf-dist/doc/generic/babel-french/frenchb-doc.pdf b/Master/texmf-dist/doc/generic/babel-french/frenchb-doc.pdf index f97bf7df858..bf2992cf943 100644 Binary files a/Master/texmf-dist/doc/generic/babel-french/frenchb-doc.pdf and b/Master/texmf-dist/doc/generic/babel-french/frenchb-doc.pdf differ diff --git a/Master/texmf-dist/doc/generic/babel-french/frenchb-doc.tex b/Master/texmf-dist/doc/generic/babel-french/frenchb-doc.tex index 4b639840da7..8fd5aa56d59 100644 --- a/Master/texmf-dist/doc/generic/babel-french/frenchb-doc.tex +++ b/Master/texmf-dist/doc/generic/babel-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 diff --git a/Master/texmf-dist/doc/generic/babel-french/frenchb.pdf b/Master/texmf-dist/doc/generic/babel-french/frenchb.pdf index c1454ccc36d..f6b1da437cd 100644 Binary files a/Master/texmf-dist/doc/generic/babel-french/frenchb.pdf and b/Master/texmf-dist/doc/generic/babel-french/frenchb.pdf differ -- cgit v1.2.3