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

Vincent Belaiche INVALID.NOREPLY at gnu.org.ua
Thu Aug 12 23:36:57 CEST 2021


Author: vincentb1
Date: 2021-08-12 21:36:57 +0000 (Thu, 12 Aug 2021)
New Revision: 985

Modified:
   trunk/ChangeLog
   trunk/latex2e-fr.texi
Log:
[fr] \contentsline: translate, \addcontentsline: realign on English.

* latex2e-fr.texi (Table of contents etc., \contentsline): Add
node \contentsline and translate it.
(\addcontentsline): Realign on English.


Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog	2021-08-12 21:36:55 UTC (rev 984)
+++ trunk/ChangeLog	2021-08-12 21:36:57 UTC (rev 985)
@@ -1,5 +1,11 @@
 2021-08-12  Vincent Bela\"iche  <vincentb1 at users.sourceforge.net>
 
+	* latex2e-fr.texi (Table of contents etc., \contentsline): Add
+	node \contentsline and translate it.
+	(\addcontentsline): Realign on English.
+
+2021-08-12  Vincent Bela\"iche  <vincentb1 at users.sourceforge.net>
+
 	* latex2e-fr.texi (\fbox & \framebox): realign on English.
 
 2021-08-12  Vincent Bela\"iche  <vincentb1 at users.sourceforge.net>

Modified: trunk/latex2e-fr.texi
===================================================================
--- trunk/latex2e-fr.texi	2021-08-12 21:36:55 UTC (rev 984)
+++ trunk/latex2e-fr.texi	2021-08-12 21:36:57 UTC (rev 985)
@@ -14847,7 +14847,7 @@
 Les deux invocations de commande
 @code{\sbox@{@var{cmd-boîte}@}@{@var{texte}@}} et
 @code{\savebox@{@var{cmd-boîte}@}@{@var{texte}@}} sont sensiblement
-équivalentes.  Quant à la troisième et la quatrième, les arguments
+équivalentes.  Quant aux troisième et quatrième, les arguments
 optionnels vous permettent de spécifier la largeur de la boîte comme
 @var{largeur}, et la position du texte au sein de cette boîte comme
 @var{position}.  @xref{\mbox & \makebox}, pour une description complète.
@@ -14963,7 +14963,6 @@
 (@pxref{\protect}).
 
 @node Color
- at c xxx trad à revoir
 @chapter Couleur
 
 @cindex couleur
@@ -14977,7 +14976,7 @@
 que si le préambule de votre document contient
 @code{\usepackage@{color@}}, qui fournit le paquetage standard.
 
-Beaucoup d'autres paquetages complémentent également les possibilité de
+Beaucoup d'autres paquetages complémentent également les possibilités de
 @LaTeX{} en matière de couleurs.  Notamment @file{xcolor} est largement
 utilisé et étend significativement les possibilités décrites ici, y
 compris par l'ajout des modèles de couleur @samp{HTML} et @samp{Hsb}.
@@ -17480,7 +17479,7 @@
 @chapter Parties pré/post-liminaires
 
 @menu
-* Table des matières etc.: Table of contents etc.. Table des matière, liste des figures, liste des tableaux.
+* Table des matières etc.: Table of contents etc.. Table des matières, liste des figures, liste des tableaux.
 * Glossaires: Glossaries. Génère un glossaire.
 * Index:Indexes. Génère un indexe.
 @end menu
@@ -17624,6 +17623,7 @@
 @menu
 * \addcontentsline::    Ajouter une entrée dans la table des matières etc.
 * \addtocontents::      Ajouter du texte directement au fichier table des matières etc.
+* \contentsline::       Règle une ligne de table des matières, etc.
 * \nofiles::            Empêche l'écriture dans les fichiers auxiliaires.
 @end menu
 
@@ -17632,7 +17632,6 @@
 @subsection @code{\addcontentsline}
 @findex \addcontentsline@{@var{ext}@}@{@var{unit}@}@{@var{texte}@}
 @cindex table des matières, ajouter manuellement un article
- at c xx Revoir la trad.
 
 Synopsis :
 
@@ -17640,25 +17639,72 @@
 \addcontentsline@{@var{ext}@}@{@var{unit}@}@{@var{texte}@}
 @end example
 
-La commande @code{\addcontentsline} ajoute une entrée a la liste ou
-table specifiée où :
+ at findex \contentsline
+Ajoute un article dans le fichier auxiliaire dont l'extension de nom est
+ at var{ext}.
 
+L'exemple suivant a pour effet d'ajouter une ligne @samp{Appendices} à
+la table des matières :
+
+ at example
+\addcontentsline@{toc@}@{section@}@{\protect\textbf@{Appendices@}@}
+ at end example
+
+ at noindent
+elle apparaîtra au même niveau de renfoncement que les rubriques, sera en
+caractères gras, et recevra le numéro de page correspondant au point où
+la commande apparaît dans le fichier d'entrée.
+
+La commande @code{\addcontentsline} écrit de l'information dans le
+fichier @file{@var{nom-racine}. at var{ext}}, où @var{nom-racine} est le
+nom du fichier racine (@pxref{Splitting the input}). Il écrit cette
+information comme le texte de la commande
+ at code{\contentsline@{@var{unit}@}@{@var{texte}@}@{@var{numéro}@}}, où
+ at code{@var{numéro}} est la valeur courante du compteur @code{@var{unit}}
+(@pxref{\contentsline}). Le cas le plus fréquent est la table des
+matières et dans ce cas @var{numéro} est la valeur du compteur
+ at var{unit} dans la première page produite où la commande
+ at code{\addcontentsline} correspondante fut utilisée.
+
+Cette commande est invoquées par les commandes de rubricage
+ at code{\chapter}, etc. (@pxref{Sectioning}), et aussi par @code{\caption}
+au sein d'un environnement flottant (@pxref{Floats}). Mais elle est
+aussi directement utilisées par des auteurs. Par exemple, un auteur
+écrivant un livre dont le style est d'avoir une préface non numérotée
+pourrait utiliser @code{\chapter*}. Mais cette commande ne produit pas
+d'article dans la table des matière, on peut alors l'entrer manuellement
+ainsi :
+
+ at example
+\chapter*@{Preface@}
+\addcontentsline@{toc@}@{chapter@}@{\protect\numberline@{@}Préface@}
+ at end example
+
+ at noindent
+Dans le fichier @file{@var{nom-racine}.toc} @LaTeX{} insère alors la
+ligne @code{\contentsline @{chapter@}@{\numberline @{@}Préface@}@{3@}} ;
+notez que le numéro de page @samp{3} est généré automatiquement par le
+système, et non saisi manuellement.
+
+Tous les arguments de @code{\addcontentsline} sont obligatoires.
+
+
 @table @var
 @item ext
-L'extension de nom de fichier du fichier dans lequel l'information doit
-être écrite, typiquement c'est l'une des trois suivante :: @code{toc}
-pour la table des matière (« table of contents » en langue anglaise),
- at code{lof} pour la liste des figures (« list of figures »), ou
- at code{lot} pour la liste des tableaux (« list of tables »).
+Typiquement c'est l'une des trois chaînes suivantes : @code{toc} pour la
+table des matière (« table of contents » en langue anglaise), @code{lof}
+pour la liste des figures (« list of figures »), ou @code{lot} pour la
+liste des tableaux (« list of tables »).  L'extension de nom de fichier
+du fichier dans lequel l'information doit être écrite.
 
 @item unit
-Le nom de l'unité sectionnelle à ajouter, typiquement l'une des
-suivantes, selon la valeur de l'argument @var{ext} :
+Une chaîne dépendant de la valeur de l'argument @var{ext}, typiquement
+l'une des suivantes :
 
 @table @code
 @item toc
-Les unités sectionnelles : @code{part}, @code{chapter},
- at code{section}, @code{subsection}, @code{subsubsection}.
+Pour la table des matières, c'est le nom d'une unité sectionnelle : @code{part}, @code{chapter},
+ at code{section}, @code{subsection}, @code{subsubsection}, etc.
 @item lof
 Pour la liste des figures : @code{figure}.
 @item lot
@@ -17666,18 +17712,31 @@
 @end table
 
 @item texte
-Le texte de l'entrée.
+Le texte de l'entrée. On doit précéder de @code{\protect} toute commande
+fragile (@pxref{\protect}) y figurant.
 @end table
 
- at findex \contentsline
-Ce qui est écrit dans le fichier @file{. at var{ext}} est la commande
- at code{\contentsline@{@var{unit}@}@{@var{texte}@}@{@var{numéro}@}}, où
- at code{@var{numéro}} est la valeur courante du compteur
- at code{@var{unit}}.
+La commande @code{\addcontentsline} a une interaction avec
+ at code{\include} (@pxref{\include & \includeonly}). Si vous les utilisez
+au même niveau comme dans
+ at code{\addcontentsline@{...@}@{...@}@{...@}\include@{...@}}, alors les
+lignes dans la table des matières risquent de sortir dans un ordre
+erroné. La solution est de déplacer @code{\addcontentsline} dans le
+fichier qu'on inclut.
 
- at c ?? how hardwired are these values?  other unit names?
+Si vous utiliser une @var{unit} que @LaTeX{} ne reconnaît pas, comme
+la coquille dans l'exemple suivant
 
+ at example
+\addcontentsline@{toc@}@{setcion@}@{\protect\textbf@{Appendices@}@}
+ at end example
 
+ at noindent
+alors vous n'obtiendrez pas une erreur mais le formatage de la table des
+matières sera incohérent.
+
+
+
 @node \addtocontents
 @subsection @code{\addtocontents}
 @findex \addtocontents@{@var{ext}@}@{@var{texte}@}
@@ -17698,6 +17757,73 @@
 Le texte à écrire.
 @end table
 
+ at node \contentsline
+ at subsection @code{\contentsline}
+
+ at cindex table des matière
+ at findex \contentsline
+ at findex \tableofcontents
+ at findex .toc, @r{fichier}
+ at findex \listoffigures
+ at findex \listoftables
+ at findex .lof, @r{fichier}
+ at findex .lot, @r{fichier}
+ at findex \l@@chapter
+ at findex \l@@section
+ at findex \l@@subsection
+
+Synopsis :
+
+ at example
+\contentsline@{@var{unit}@}@{@var{texte}@}@{@var{numéro-page}@}
+ at end example
+
+Utilisé en interne par @LaTeX{} pour composer un article dans une table
+des matières, table des figures, ou table des tableaux (@pxref{Table of
+contents etc.}). Les auteurs ne saisissent pas directement les commandes
+ at code{\contentsline}.
+
+En général l'ajout de matériel à ces table est fait automatiquement par
+les commande @code{\chapter}, @code{\section}, etc. pour la table des
+matières, ou par la commande @code{\caption} au sein d'un environnement
+ at code{\figure} ou @code{\table} (@pxref{figure} et @pxref{table}).
+Ainsi, en supposant que le fichier raacine est @file{these.tex}, et
+qu'il contient la déclaration @code{\tableofcontents}, la commande
+ at code{\chapter@{Chapitre premier@}} produit quelque-chose de ce genre
+dans le ifchier @file{these.toc} :
+
+ at example
+\contentsline @{chapter@}@{\numberline @{1@}Chapitre premier@}@{3@}
+ at end example
+
+Si le fichier contient la déclaration @code{\listoffigures} alors un
+environnement figure comprenant @code{\caption@{Essai@}} produira quelque-chose de ce genre dans @file{these.lof}.
+
+ at example
+\contentsline @{figure@}@{\numberline @{1.1@}@{\ignorespaces Essai@}@}@{6@}
+ at end example
+
+Pour ajouter manuellement du matériel, utilisez
+ at code{\addcontentsline@{@var{typefic}@}@{@var{unit}@}@{\@var{texte}@}},
+où @var{typefic} est @code{toc}, @code{lof}, ou @code{lot}
+(@pxref{\addcontentsline}).
+
+ at PkgIndex{tocloft}
+Pour manipuler la façon dont le matériel de la commande
+ at code{\contentline} est composé, voir le paquetage @file{tocloft}.
+
+ at PkgIndex{hyperref}
+
+Notez que le paquetage @code{hyperref} change la définition de
+ at code{\contentsline} (et de @code{\addcontentsline}) pour ajouter plus
+d'arguments, fabriquer des hyperliens.  C'est la source de l'erreur
+ at code{Argument of \contentsline has an extra @}} quand on
+ajoute/supprime l'utilisation d'@file{hyperref} et qu'une compilation a
+déjà été faite.  Pour réparer cette erreur, détruisez les fichiers
+ at file{.toc}, @file{.lof} ou @file{.lot}, et exécutez de nouveau
+ at LaTeX{}.
+
+
 @node \nofiles
 @subsection @code{\nofiles}
 



More information about the latexrefman-commits mailing list.