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

Wed Aug 25 22:53:38 CEST 2021

Author: vincentb1
Date: 2021-08-25 20:53:38 +0000 (Wed, 25 Aug 2021)
New Revision: 1017

Modified:
   trunk/ChangeLog
   trunk/latex2e-fr.texi
Log:
[fr] makeindex, align on en.

* latex2e-fr.texi (makeindex): Re-align node translation on English.


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

--- trunk/ChangeLog	2021-08-25 20:53:35 UTC (rev 1016)
+++ trunk/ChangeLog	2021-08-25 20:53:38 UTC (rev 1017)
@@ -1,5 +1,9 @@
 2021-08-25  Vincent Bela\"iche  <vincentb1 at users.sourceforge.net>
 
+	* latex2e-fr.texi (makeindex): Re-align node translation on English.
+
+2021-08-25  Vincent Bela\"iche  <vincentb1 at users.sourceforge.net>
+
 	* latex2e-fr.texi: Make formatting of package names uniform.
 
 2021-08-25  Vincent Bela\"iche  <vincentb1 at users.sourceforge.net>

Modified: trunk/latex2e-fr.texi
===================================================================
--- trunk/latex2e-fr.texi	2021-08-25 20:53:35 UTC (rev 1016)
+++ trunk/latex2e-fr.texi	2021-08-25 20:53:38 UTC (rev 1017)
@@ -18969,30 +18969,218 @@
 
 @node makeindex
 @subsection @command{makeindex}
- at c xx revoir la trad.  cf. r662 & r955
 
- at findex \makeindex
-La commande @code{\makeindex} active la création d'index.  Placez là dans le
-préambule.
-
- at cindex @command{makeindex}, programme
- at cindex @command{xindy}, programle
+ at findex index, traitement
+ at cindex makeindex, @r{programme}
 @cindex @file{.ind}, fichier
-Le fichier en @file{.idx} généré est ensuite trié avec une commande
-externe, d'ordinaire soit @command{makeindex}
-(@url{http://mirror.ctan.org/indexing/makeindex}) ou la commande (
-multi-lingue) @command{xindy} (@url{http://xindy.sourceforge.net}).
-Ceci résulte en un fichier en @file{.ind}, ce qui peut ensuite être lu
-pour composer l'index.
+ at cindex @file{.idx}, fichier
 
+Synopsis, l'un parmi :
 
+ at example
+makeindex @var{nomfic}
+makeindex -s @var{fichier-style} @var{nomfic}
+makeindex @var{options} @var{nomfic0} ...
+ at end example
 
+Trie l'indormation d'index dans le fichier auxiliaire, et fait d'autres
+traitements dessus. C'est un programme en ligne de commande. Il prend en
+entrée un ou plusieurs fichiers bruts d'index, les fichiers
+ at file{@var{nomfic}.idx}, et produit en sortie le ficher d'index fini, le
+fichier @file{@var{nomfic}.ind} qui est l'entrée de @code{\printindex}
+(@pxref{\printindex}).
+
+ at cindex @file{.isty}, fichier
+ at findex index, fichier de style
+ at findex makeindex, fichier de style
+La première forme de la commande suffit pour beaucoup d'usages. La
+deuxième permet de formatter l'index en utilisant un @dfn{fichier de
+style d'index}, un fichier @file{.isty}.  La troisième forme est la plus
+générale ; voir la documentation complète sur le CTAN.
+
+Ci-dessous on donne un exemple d'un fichier @file{.isty} simple :
+
+ at example
+% book.isty 
+%   $ makeindex -s book.isty -p odd book.idx
+% creates the index as book.ind, starting on an odd page. 
+preamble
+"\\pagestyle@{empty@}
+\\small
+\\begin@{theindex@}
+\\thispagestyle@{empty@}"
+
+postamble
+"\n
+\\end@{theindex@}"
+ at end example
+
+La présente description ne couvre que certaines des possibilités du
+ at var{fichier-style}. Pour une liste complète voir la documentation sur
+le CTAN.
+
+Un fichier de style consiste en une liste de couples :
+ at var{spécificateur} et @var{attribut}. Ils peuvent apparaître dans le
+fichier dans un ordre quelconque. Tous les @var{attribut}s sont des
+chaînes, sauf mention du contraire. Les chaînes sont entourées de
+guillemets anglais doubles, @code{"}, et la longueur maximale d'une
+chaîne est de 144 caractères.  Le @code{\n} représente un saut de ligne
+et le @code{\t} une tabulation. Les contr'obliques sont échappées avec
+une autre contr'oblique, comme cela : @code{\\}.  Si une ligne commence
+avec un signe pourcent, @code{%}, alors c'est un commentaire.
+
+ at ftable @code
+ at anchor{makeindex preamble}
+ at item preamble
+Préambule du fichier d'index de sortie. Définit le contexte dans lequel
+l'index est formaté. Vaut par défaut : @code{"\\begin@{theindex@}\n"}.
+
+ at anchor{makeindex postamble}
+ at item postamble
+Postambule du fichier d'index de sortie. Vaut par défaut :
+ at code{"\n\n\\end@{theindex@}\n"}.
+
+ at anchor{makeindex group skip}
+ at item group_skip
 @findex \indexspace
-La longueur élastique @code{\indexspace} est insérée avant chaque
-nouvelle lettre dans l'index imprimé ; sa valeur par défaut est
- at samp{10pt plus5pt minus3pt}.
+Traditionnellement les articles d'index sont répartis en groupes,
+typiquement un groupe pour les articles commençant pas la lettre
+ at samp{a}, etc.  Ce spécificateur donne ce qui est inséré quand un
+nouveau groupe commence.  Vaut par défaut : @code{"\n\n \\indexspace\n"}
+(@code{\indexspace} est une commande qui insère une longueur élastique,
+par défaut @code{10pt plus5pt minus3pt}).
 
+ at anchor{makeindex letheadflag}
+ at item lethead_flag
+Un entier. Il commande ce qui est inséré pour un nouveau groupe ou une
+nouvelle lettre. Lorsqu'il vaut 0 (ce qui est le réglage par défaut)
+alors rien d'autre que @code{group_skip} n'est inséré avant le
+groupe. S'il est positif, alors pour une nouvelle lettre les attributs
+ at code{lethead_prefix} et @code{lethead_suffix} sont insérés, avec cette
+lettre en capitale entre eux. S'il est négatif, alors ce qui est inséré
+est la lettre en bas de casse. Vaut par défaut 0.
 
+ at anchor{makeindex lethead prefix}
+ at item lethead_prefix
+Si un nouveau groupe commence avec une lettre différente alors c'est le
+préfixe inséré devant l'en-tête présentant la nouvelle lettre. Vaut par
+défaut : @code{""}
+
+ at anchor{makeindex lethead suffix}
+ at item lethead_suffix
+Si un nouveau groupe commence avec une lettre différente alors c'est le
+suffixe inséré après l'en-tête présentant la nouvelle lettre. Vaut par
+défaut : @code{""}
+
+ at anchor{makeindex item 0}
+ at item item_0 
+C'est ce qui est mis entre deux articles de niveau 0. Vaut par défaut :
+ at code{"\n \\item "}.
+
+ at anchor{makeindex item 1}
+ at item item_1
+Mis entre deux articles de niveau 1. Vaut par défaut : @code{"\n
+\\subitem "}.
+
+ at anchor{makeindex item 2}
+ at item item_2
+Mis entre deux articles de niveau 2. Vaut par défaut : @code{"\n
+\\subsubitem "}.
+
+ at anchor{makeindex item 01}
+ at item item_01
+C'est ce qui est mis entre un article de niveau 0 et un article de
+niveau 1. Vaut par défaut : @code{"\n \\subitem "}.
+
+ at anchor{makeindex item x1}
+ at item item_x1
+C'est ce qui est mis entre un article de niveau 0 et un article de
+niveau 1 dans le cas où l'article de niveau 0 n'a pas de numéro de page
+(comme dans @code{\index@{aaa|see@{bbb@}@}}). Vaut par défaut :
+ at code{"\n \\subitem "}.
+
+ at anchor{makeindex item 12}
+ at item item_12
+C'est ce qui est mis entre un article de niveau 1 et un article de
+niveau 2.  Vaut par défaut : @code{"\n \\subsubitem "}.
+
+ at anchor{makeindex item x2}
+ at item item_x2
+C'est ce qui est mis entre un article de niveau 1 et un article de
+niveau 2 si l'article de niveau 1 n'a pas de numéro de page. Vaut par
+défaut : @code{"\n \\subsubitem "}.
+
+ at anchor{makeindex delim 0}
+ at item delim_0
+Délimiteur mis entre une clef de niveau 0 et son premier numéro de
+page. Vaut par défaut : une virgule suivie d'un blanc, @code{", "}.
+
+ at anchor{makeindex delim 1}
+ at item delim_1
+Délimiteur mis entre une clef de niveau 1 et son premier numéro de
+page.  Vaut par défaut : une virgule suivie d'un blanc, @code{", "}.
+
+ at anchor{makeindex delim 2}
+ at item delim_2
+Délimiteur mis entre une clef de niveau 2 et son premier numéro de
+page.  Vaut par défaut : une virgule suivie d'un blanc, @code{", "}.
+
+ at anchor{makeindex delim n}
+ at item delim_n
+Délimiteur mis entre deux numéros de page de la même clef (quel que soit
+le niveau) .  Vaut par défaut : une virgule suivie d'un blanc, @code{",
+"}.
+
+ at anchor{makeindex delim r}
+ at item delim_r
+Délimiteur mis entre le numéro de début et le numéro de fin d'une plage
+de numéros de page deux numéros de page. Vaut par défaut : @code{"--"}.
+
+ at anchor{makeindex line max}
+ at item line_max
+Un entier. Longueur maximale d'une ligne d'article d'index dans la
+sortie au delà de quoi la ligne est repliée. Vaut par défaut :
+ at code{72}.
+
+ at anchor{makeindex indent space}
+ at item indent_space
+Ce qui est inséré au début d'une ligne repliée. Vaut par défaut :
+ at code{"\t\t"}.
+
+ at anchor{makeindex indent length}
+ at item indent_length
+Un nombre. La longueur d'un renfoncement de ligne repliée. La valeur par
+défaut d'@code{indent_space} est de deux tabulations, et chaque
+tabulation compte pour huit espaces de sorte que la valeur par défaut
+est @code{16}.
+
+ at anchor{makeindex page precedence}
+ at item page_precedence
+Un document peut avoir différents types de numérotations des pages. Par
+exemple, un livre peut avoir des matières préliminaires dont les pages
+sont numérotées en chiffres romains bas de casse alors que les pages de
+la matière principale sont en chiffres arabes. Cette chaîne spécifie
+l'ordre dans lequel ils apparaissent dans l'index. La commande
+ at command{makeindex} prend en charge cinq types différents de
+numérotation : romain bas de casse @code{r}, numérique ou arabe
+ at code{n}, alphabétique bas de casse @code{a}, romain capital @code{R},
+et alphabétique capital @code{A}.  Vaut par défaut : @code{"rnaRA"}.
+
+ at end ftable
+
+ at cindex xindy, @r{programme}
+Il y a plusieurs autres programmes faisant le même travail que
+ at command{makeindex}. L'un d'eux est @command{xindy}
+(@uref{https://ctan.org/pkg/xindy}), qui fait de l'internationalisation
+et peut traiter des documents balisés en utilisant @LaTeX{} et plusieurs
+autres langages. Il est écrit en Lisp, hautement configurable, à la fois
+en termes de balise et en termes d'ordre d'assemblage du texte, comme
+décrit dans sa documentation.
+
+ at findex xindex, @r{programme}
+Un programme d'indexation plus récent prenant en charge l'Unicode est
+ at code{xindex}, écrit en Lua (@url{https://ctan.org/pkg/xindex}).
+
 @node \printindex
 @subsection @command{\printindex}
 

