[latexrefman-commits] [SCM] latexrefman updated: r1004 - trunk

Wed Aug 25 22:47:03 CEST 2021

Author: vincentb1
Date: 2021-08-25 20:47:03 +0000 (Wed, 25 Aug 2021)
New Revision: 1004

Modified:
   trunk/ChangeLog
   trunk/latex2e-fr.texi
Log:
[fr] \ignorespaces & \ignorespacesafterend, xspace package, translate.

* latex2e-fr.texi (Definitions): add to menu ``\ignorespaces &
\ignorespacesafterend'' & ``xspace package''.
(\ignorespaces & \ignorespacesafterend, xspace package): and &
translate these nodes.
(Footnote parameters): typoes.
(Footnote parameters, \mathstrut, \strut): Add ``\'etai'' --- ie
strut --- to index.


Modified: trunk/ChangeLog
===================================================================

--- trunk/ChangeLog	2021-08-25 20:47:00 UTC (rev 1003)
+++ trunk/ChangeLog	2021-08-25 20:47:03 UTC (rev 1004)
@@ -1,5 +1,15 @@
 2021-08-25  Vincent Bela\"iche  <vincentb1 at users.sourceforge.net>
 
+	* latex2e-fr.texi (Definitions): add to menu ``\ignorespaces &
+	\ignorespacesafterend'' & ``xspace package''.
+	(\ignorespaces & \ignorespacesafterend, xspace package): and &
+	translate these nodes.
+	(Footnote parameters): typoes.
+	(Footnote parameters, \mathstrut, \strut): Add ``\'etai'' --- ie
+	strut --- to index.
+
+2021-08-25  Vincent Bela\"iche  <vincentb1 at users.sourceforge.net>
+
 	* latex2e-fr.texi (xr package): Translate from en.
 
 2021-08-25  Vincent Bela\"iche  <vincentb1 at users.sourceforge.net>

Modified: trunk/latex2e-fr.texi
===================================================================
--- trunk/latex2e-fr.texi	2021-08-25 20:47:00 UTC (rev 1003)
+++ trunk/latex2e-fr.texi	2021-08-25 20:47:03 UTC (rev 1004)
@@ -9570,14 +9570,16 @@
 @ftable @code
 @item \footnoterule
 Produit le filet de séparation entre texte principal sur une page et les
-notes en bas de cette page. Les dimension par défaut : épaisseur (ou
+notes en bas de cette page. Les dimensions par défaut : épaisseur (ou
 largeur) @code{0.4pt}, et longueur @code{0.4\columnwidth} dans les
 classes standard de document (à l'exception @code{slide}, où elle
 n'apparaît pas).
 
 @item \footnotesep
+ at anchor{footnote footnotesep}
+ at cindex étai
 La hauteur de l'étai placé au début de la note en bas de page. Par
-défaut, c'est réglé à l'étai nomal pour des police de taille
+défaut, c'est réglé à l'étai normal pour des polices de taille
 @code{\footnotesize} (@pxref{Font sizes}), donc il n'y a pas d'espace
 supplémentaire entre les notes. Cela vaut @samp{6.65pt} pour des polices
 à @samp{10pt}, @samp{7.7pt} pour @samp{11pt}, et @samp{8.4pt} pour
@@ -9607,7 +9609,9 @@
 * \newenvironment & \renewenvironment:: Définir un nouvel environnement.
 * \newtheorem:: Définir un nouvel environnement de semblable à @code{theorem}.
 * \newfont:: Définir un nouveau nom de police.
-* \protect:: Utiliser des commandes fragile.
+* \protect:: Utiliser des commandes fragiles.
+* \ignorespaces & \ignorespacesafterend:: Supprimer des espaces superflus.
+* xspace package:: Espace après une macros, conditionnellement.
 @end menu
 
 @node \newcommand & \renewcommand
@@ -10497,6 +10501,174 @@
 @end example
 
 
+ at node \ignorespaces & \ignorespacesafterend
+ at section @code{\ignorespaces & \ignorespacesafterend}
+
+ at findex \ignorespaces
+ at findex \ignorespacesafterend
+ at cindex espaces, ignorer au voisinage d'une commande
+ at cindex commandes, ignorer les espaces
+
+Synopsis :
+
+ at example
+\ignorespaces
+ at end example
+
+ at noindent
+ou
+
+ at example
+\ignorespacesafterend
+ at end example
+
+Les deux commandes ont pour effet que @LaTeX{} ignore l'espace blanc
+après la commande et jusqu'à rencontrer une boîte ou un caractère non
+blanc.  La premier commande vient de @value{PlainTeX}, et la seconde est
+spécifique à @LaTeX{}.
+
+La commande @code{\ignorespaces} est souvent utilisée quand on définit
+des commande au moyen de @code{\newcommand}, ou @code{\newenvironment},
+ou @code{\def}. Ceci est illustré par l'exemple plus bas. Il permet à un
+utilisateur d'afficher dans la marge combien de points rapporte chaque
+questions d'un questionnaire, mais il est malcommode parce que, comme
+illustré dans la liste @code{enumerate}, l'utilisateur ne doit pas
+mettre d'espace entre la commande et le texte de la question.
+
+ at example
+\newcommand@{\points@}[1]@{\makebox[0pt]@{\makebox[10em][l]@{#1~pts@}@}
+\begin@{enumerate@} 
+  \item\points@{10@}aucun espace superflu inséré ici
+  \item\points@{15@} ici un espace superflu entre le nombre et le mot « ici »
+\end@{enumerate@} 
+ at end example
+
+ at noindent
+La solution est de modifier comme ci-dessous :
+
+ at example
+\newcommand@{\points@}[1]@{%
+  \makebox[0pt]@{\makebox[10em][l]@{#1~pts@}@}\ignorespaces@}
+ at end example
+
+Dans le second exemple on illustre comment l'espace blanc est enlevé de
+devant le texte. Les commandes ci-dessous permettent à utilisateur
+d'attacher uniformément une civilité à un nom. Mais si, quand il est
+donné, une civilité commence accidentellement par un espace alors
+ at code{\nomcomplet} le reproduira.
+
+ at example
+\newcommand@{\honorific@}[1]@{\def\honorific@{#1@}@} % mémorise le titre
+\newcommand@{\fullname@}[1]@{\honorific~#1@}   % met le titre devant le nom
+
+\begin@{tabular@}@{|l|@}
+\honorific@{M./Mme@}  \fullname@{Jean@} \\  % sans espace superflu
+\honorific@{ M./Mme@} \fullname@{Jean@}     % espace superflu devant la civilité
+\end@{tabular@}
+ at end example
+
+ at noindent
+Pour réparer cela, modifier le en
+ at code{\newcommand@{\fullname@}[1]@{\ignorespaces\honorific~#1@}}.
+
+Le @code{\ignorespaces} est aussi souvent utilisé dans un
+ at code{\newenvironment} à la fin de la clause @var{begin}, comme dans
+ at code{\begin@{newenvironment@}@{@var{env
+name}@}@{... \ignorespaces@}@{...@}}.
+
+Pour enlever l'espace blanc venant immédiatement après un environnement
+utilisez @code{\ignorespacesafterend}.  Dans l'exemple ci-dessous on
+affichier un espace vertical bien plus grand entre les première et
+deuxième environnement qu'entre le deuxième et le troisième.
+
+ at example
+\newenvironment@{eq@}@{\begin@{equation@}@}@{\end@{equation@}@}
+\begin@{eq@}
+e=mc^2
+\end@{eq@}
+\begin@{equation@}
+F=ma
+\end@{equation@}
+\begin@{equation@}
+E=IR
+\end@{equation@}
+ at end example
+
+On peut faire disparaître l'espace vertical en mettant un
+caractère @code{%} de commentaire immédiatement après le
+ at code{\end@{eq@}}, mais cela est malcommode.  La solution est de
+modifier en
+ at code{\newenvironment@{eq@}@{\begin@{equation@}@}@{\end@{equation@}\ignorespacesafterend@}}.
+
+
+ at node xspace package
+ at section xspace package
+
+ at findex \xspace
+ at cindex espaces, ignorer autour des commandes
+ at cindex commandes, ignorer les espaces
+
+Synopsis :
+
+ at example
+\usepackage@{xspace@}
+  ...
+\newcommand@{...@}@{...\xspace@}
+ at end example
+
+La macro @code{\xspace}, quand utilisée à la fin de la définition d'une
+commande, ajoute une espace à moins que la commande soit suivie de
+certains caractères de poinctuation.
+
+Après la séquence de contrôle d'une commande qui est un mot de contrôle
+(@pxref{Control sequences}, contrairement aux symboles de contrôle tels
+que @code{\$}), @TeX{} avale les caractères blancs. Ainsi, dans la
+première phrase ci-dessous, en sortie on a @samp{Provence} placé
+parfaitement contre le point, sans espace entre les deux.
+
+ at example
+\newcommand@{\PR@}@{Provence@}
+Notre école est en \PR .
+Les étés en \PR@{@} sont agréables.
+ at end example
+
+Mais à cause de l'avalement, la seconde phrase a besoin de l'adjonction
+d'accolades, sans quoi il n'y aurait pas d'espace entre @samp{Provence}
+et @samp{sont}.  (Beaucoup d'auteurs utilisent plutôt un @code{\ } pour
+cela.  @xref{\(SPACE)}.)
+
+Le paquetage @file{xspace} fournit la commande @code{\xspace}.  Elle
+sert à écrire des commandes conçues pour être utilisées essentiellement
+dans du texte. Elle doit être placée à la toute fin de la définition de
+ces commandes. Elle insère un espace après la commande à moins que ce qui
+la suive immédiatement soit dans une liste d'exceptions.  Dans l'exemple
+suivant, on peut se passer de l'adjonction d'accolades.
+
+ at example
+\newcommand@{\PR@}@{Provence\xspace@}
+Notre école est en \PR .
+Les étés en \PR@{@} sont agréables.
+ at end example
+
+La liste d'exceptions par défaut contient les caractères
+ at code{,.'/?;:!~-)}, ainsi que l'accolade ouvrante, la commande
+contr'olbique-espace discutée plus haut, et les commandes
+ at code{\footnote} ou @code{\footnotemark}.  On peut ajouter des éléments
+à cette liste comme avec @code{\xspaceaddexceptions@{\manotebdpi
+\manotebdpii@}} qui rajoute les séquences de contrôle @code{\manotebdpi}
+et @code{\manotebdpii} à la liste, et retrancher un élément de la liste
+comme avec @code{\xspaceremoveexception@{!@}}.
+
+ at c David Carlisle https://tex.stackexchange.com/a/86620/339
+Comment : nombre d'experts préfèrent ne pas utiliser @code{\xspace}.  La
+mettre dans une définition signifie que la commande sera en général
+suivie du bon espacement. Mais il n'est pas aisé de prédire quand
+ajouter les accolades @code{@{@}} parce que @code{\xspace} se sera
+trompé, comme lorsque elle est suivie d'une autre commande, et donc
+ at code{\xspace} peut rendre l'édition d'un matériel plus difficile et
+plus faillible que de mettre systématiquement les accolades.
+
+
 @node Counters
 @chapter Compteurs
 @cindex compteurs, a list of
@@ -13127,6 +13299,7 @@
 @cindex mode mathématique, espacement
 @cindex invisible, caractère
 @cindex caractère invisible
+ at cindex étai mathématique
 
 Synopsis :
 
@@ -14355,7 +14528,7 @@
 @section @code{\strut}
 
 @findex \strut
- at cindex strut
+ at cindex étai
 
 Synopsis :
 
@@ -14363,7 +14536,7 @@
 \strut
 @end example
 
-Assure que la ligne courante a une hauteur d'au moins
+Étai. Assure que la ligne courante a une hauteur d'au moins
 @code{0.7\baselineskip} et une profondeur d'au moins
 @code{0.3\baselineskip}.  Pour l'essentiel, @LaTeX{} insère dans la
 ligne un rectangle de largeur nulle,

