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

Wed Aug 25 22:47:26 CEST 2021

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

Modified:
   trunk/ChangeLog
   trunk/latex2e-fr.texi
Log:
[fr] \index, realign node on en.

* latex-fr.texi (\index): realign on English.


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

--- trunk/ChangeLog	2021-08-25 20:47:23 UTC (rev 1013)
+++ trunk/ChangeLog	2021-08-25 20:47:25 UTC (rev 1014)
@@ -1,5 +1,9 @@
 2021-08-25  Vincent Bela\"iche  <vincentb1 at users.sourceforge.net>
 
+	* latex-fr.texi (\index): realign on English.
+
+2021-08-25  Vincent Bela\"iche  <vincentb1 at users.sourceforge.net>
+
 	* latex2e-fr.texi (\printindex): Align on English.
 	(makeindex): move some text from \printindex.
 

Modified: trunk/latex2e-fr.texi
===================================================================
--- trunk/latex2e-fr.texi	2021-08-25 20:47:23 UTC (rev 1013)
+++ trunk/latex2e-fr.texi	2021-08-25 20:47:25 UTC (rev 1014)
@@ -18695,34 +18695,171 @@
 
 @node \index
 @subsection @code{\index}
- at c xx revoir la trad.  cf. r662 & r955
 
-
 @findex \index
 @cindex @file{.idx}, fichier
-La commande @code{\index@{@var{texte}@}} écrit un article d'index pour
- at var{texte} dans un fichier auxiliaire nommé avec une extention
- at file{.idx}.
 
- at findex \indexentry
-Plus précisément, ce qui est écrit est la commande
- at code{\indexentry@{@var{texte}@}@{@var{numpage}@}}, où @var{numpage} est
-la valeur courante de @code{\thepage}.
+Synopsis :
 
- at cindex Voir et Voir aussi, article d'index
- at cindex article d'index, « Voir » et « Voir aussi »
-Pour générer un article d'index pour « toto » qui dit « Voir titi »,
-utilisez une barre verticale : @code{\index@{toto|see@{titi@}@}}.
-Utilisez @code{seealso} au lieu de @code{see} pour fabriquer un article
-en « Voir aussi ».
+ at example
+\index@{@var{chaîne-article-index}@}
+ at end example
 
+Déclare un article dans l'index.  Cette commande est fragile
+(@pxref{\protect}).
+
+Par exemple, comme décrit dans @ref{Indexes}, une façon d'obtenir un
+index du code ci-dessous est de compiler le document avec @code{pdflatex
+test}, puis de traiter les articles de l'index avec @code{makeindex
+test}, et ensuite de compiler de nouveau avec @code{pdflatex test}.
+
+ at example
+% fichier test.tex
+  ...
+W~Ackermann (1896--1962).\index@{Ackermann@}
+  ...
+fonction d'Ackermann\index@{Ackermann!fonction@}
+  ...
+taux de croissance\index@{Ackermann!fonction!taux de croissance@}
+ at end example
+
+ at cindex index, articles, sous-articles
+ at noindent
+Les trois articles obtiendront un numéro de page, comme dans
+ at samp{Ackermann, 22}.  @LaTeX{} formate le deuxième comme un
+sous-article du premier, sur la ligne du dessous et renfoncé, et le
+troisième comme un sous-article du deuxième. On ne peut pas imbriquer
+les articles au delà du troisième niveau de sous-articles.  (Si vous
+ajoutez @code{\index@{Ackermann!fonction!taux de
+croissance!comparaison@}} alors @command{makeindex} dit @samp{Scanning
+input file test.idx....done (4 entries accepted, 1 rejected)} et le
+quatrième niveau est silencieusement absent de l'index).
+
+Si vous saisissez un deuxième @code{\index} avec la même
+ at var{chaîne-article-index} alors vous obtiendrez un unique article
+d'index avec deux numéros de page (à moins qu'il se trouve que les deux
+soient sur la même page). Ainsi, ajouter @code{comme pour
+Ackermann.\index@{Ackermann@}} plus loin dans le même document que
+ci-dessus donnera un article d'index du genre de @samp{Ackermann, 22,
+151}.  Notez aussi que vous pouvez saisir les articles d'index dans un
+ordre quelconque, ainsi par exemple @code{\index@{Ackermann!fonction@}}
+peut arriver avant @code{\index@{Ackermann@}}.
+
+ at cindex index, plage de pages
+Obtenez une plage de page en sortie, du genre de @samp{Hilbert, 23--27},
+comme avec le code ci-dessous :
+
+ at example
+W~Ackermann (1896--1962).\index@{Ackermann@}
+  ...
+D~Hilbert (1862--1943)\index@{Ackermann!Hilbert|(@}
+  ...
+désapprouvait son mariage.\index@{Ackermann!Hilbert|)@}
+ at end example
+
+ at noindent
+Si le début et la fin de la plage de pages sont égaux alors le systène
+ne donne qu'un seul numéro de page, et non une plage.
+
+Si vous indexez des sous-articles mais sans article principal, comme
+dans @code{\index@{Jones!programme@}} et
+ at code{\index@{Jones!resultats@}}, alors la sortie est l'article
+ at samp{Jones} sans virgule ni numéro de page, suivi de deux
+sous-articles, du genre de @samp{programme, 50} et @samp{resultats, 51}.
+
+ at cindex voir et voir aussi, articles d'index
+ at cindex index, articles, « voir » et « voir aussi »
 @findex \seename
 @findex \alsoname
 @PkgIndex{babel} @PkgIndex{polyglossia}
-Le texte « Voir » est défini par la macro @code{\seename}, et le texte
-« Voir aussi » par la macro @code{\alsoname}.  Ils peuvent être redéfinis
-pour d'autres langages.
 
+On génère un article d'index qui dit @samp{Voir} en utilisant un
+caractère barre verticale :
+ at code{\index@{Ackermann!function|see@{fonction de P\'eter@}@}}.  On peut
+également obtenir @samp{voir aussi} avec @code{seealso}.  (Le texte
+ at samp{voir} est défini par @code{\seename}, et @samp{voir ausi} par
+ at code{\alsoname} lorsqu'on charge un paquetage d'internationalisation
+tel que @file{babel} or @file{polyglossia}, et que la langue
+sélectionnée est le français, sinon par défaut c'est @samp{see} et
+ at samp{see also}, on peut aussi les redéfinir directement avec
+quelque-chose du genre de @code{\renewcommand@{\seename@}@{cf.@}
+\renewcommand@{\alsoname@}@{ibid.@}}).
+
+La production du mot @samp{voir} fait partie d'une fonctionalité plus
+générale. Après la barre verticale vous pouvez mettre le nom @var{cmd}
+d'une commande @code{\@var{cmd}} à un argment, comme dans
+ at code{\index@{group|textit@}} (notez l'absence de contr'oblique sur la
+commande @code{\textit}) et le système appliquera cette commande au
+numéro de page dans l'article d'indexe, donnant ici quelque-chose du
+genre de @code{\textit@{7@}}.  Vous pouvez aussi définir vos propres
+commandes comme dans
+ at code{\newcommand@{\pagecours@}[1]@{@{\color@{blue@}#1@}@}} et ensuite
+ at code{\index@{Ackermann!function|pagecours@}} donnera un numéro de page
+en bleu (@pxref{Color}).  Voici in autre exemple, moins pratique :
+
+ at c credit Ian Thompson https://tex.stackexchange.com/a/272572/121234
+ at example
+\newcommand\pageindex[1]@{#1, \thepage@}
+  ... Epimenides.\index@{self-reference|pageindex@}
+ at end example
+
+ at noindent
+qui crée une article citant le numéro de page dans le listing de l'index.
+
+Les deux fonctions décrites plus haut peuvent être combinées, comme dans :
+
+ at example
+\index@{Ackermann!fonction|(pagecours@}
+  ...
+\index@{Ackermann!fonction|)@}
+ at end example
+
+ at noindent
+ce qui en sortie produit un article d'index du genre de @samp{fonction,
+23--27} où la plage de numéros de page est en bleu.
+
+Considérez un article d'index tel que @samp{@BES{β,\beta}-testeur}. Le
+saisir telle que @code{$\beta$-testeur} aura pour effet qu'il sera
+classé selon le signe dollar. Vous pouvez le saisir en utilisant une
+arobe, comme dans @code{\index@{bêta-testeur@@$\beta$-testeur@}}.
+Lorsque vous spécifiez un article avec une arobe qui sépare deux chaînes,
+ at code{@var{pos}@@@var{texte}}, alors @var{pos} donne la position
+alphabétique de l'article alors que @var{texte} produit le texte de
+l'article. Un autre exemple est que @code{\index@{Saint Michael's
+College@@SMC@}} produit un article d'index @samp{SMC} classé dans un
+autre endroit que son épellation donnerait naturellement.
+
+Pour mettre le caractère @code{!}, @code{@@}, @code{|} ou @code{"} dans
+un article d'index, échappez le en le précédant d'un guillement anglais
+double, @code{"}.  (Le guillemet double est ignoré pour le classement
+alphabétique).
+
+ at PkgIndex{index}
+Nombre de paquetages sur le CTAN apportent des fonctionnalités
+supplémentaires allant au-délà de celles fournies par @package{makeidx}.
+L'un deux est @package{index} qui permet d'avoir des index multiples et
+contient une commande @code{\index*@{@var{index-entry-string}@}} qui
+imprime la @var{chaîne-article-index} en plus de l'indexer.
+
+ at findex \indexentry
+ at cindex idx, fichier
+La commande @code{\index} écrit l'information d'indexation dans le
+fichier @file{@var{nom-racine}.idx}.  Plus spécifiquement, elle écrit le
+texte de la commande
+ at code{\indexentry@{@var{chaîne-article-index}@}@{@var{num-page}@}}, où
+ at var{num-page} est la valeur du compteur @code{\thepage}.  Il peut
+arriver, lorsque la commande @code{\printindex} perd les pédales, que
+vous ayez à détruire ce fichier pour repartir de bases saines.
+
+Si vous oubliez l'accolade fermante sur une commande @code{\index} alors
+vous obtiendrez un message du genre de :
+
+ at example
+Runaway argument?  @{Ackermann!function
+!  Paragraph ended before \@@wrindex was complete.
+ at end example
+
+
 @node makeindex
 @subsection @command{makeindex}
 @c xx revoir la trad.  cf. r662 & r955

