25.3 Index

Si vous dites à LaTeX les termes que vous voulez voir apparaître dans un index, alors il peut produire cet index, classé alphabétiquement et en maintenant automatiquement les numéros de page. Ce qui suit illustre les bases.

\documentclass{article}
\usepackage{makeidx}    % Fournit les commandes d'indexation
  \makeindex
% \usepackage{showidx}  % Affiche les notes en marge des articles
                        % de l'index
  ...
\begin{document}
  ...
Le théorème de Wilson\index{Théorème de Wilson} dit qu'un nombre $n>1$
est premier si et seulement si la factorielle de $n-1$ est congurente à
$-1$ modulo~$n$.\index{congruence!et théorème de Wilson}
  ...
\printindex
\end{document}

Comme illustré ci-dessus, on déclare des articles d’index avec la commande \index (voir \index). Quand vous exécutez LaTeX, le \index inscrit son information, telle que ‘Théorème de Wilson’, et le numéro de page, dans un fichier auxiliaire dont le nom finit en .idx. Ensuite, pour classer par ordre alphabétique, et pour d’autre manipulations, on exécute un program externe, typiquement makeindex (voir makeindex), ce qui écrit un fichier dont le nom finit en .ind. Finalement, \printindex ramène cette information manipulée dans la sortie (voir \printindex).

Ainsi, si le code de l’exemple plus haut est dans le fichier numth.tex alors exécuter ‘pdflatex numth’ sauvegarde l’information de l’article d’index et son numéro de page dans numth.idx. Et ensuite exécuter ‘makeindex numth’ classe par ordre alphabétique et sauvegarde les résultats dans numth.ind. Finalement, exécuter de nouveau ‘pdflatex numth’ affiche l’index désiré, à l’endroit où la commande \printindex est dans le code source.

Il, y a beaucoup d’options pour contrôler la sortie. Un exemple est que le point d’exclamation dans \index{congruence!et théorème de Wilson} produit un article principal pour ‘congruence’ avec un sous-article pour ‘et théorème de Wilson’. Pour plus d’information, voir makeindex.

Les commandes \makeindex et \printindex sont indépendantes. Ne pas mettre le \makeindex arrête que LaTeX sauvegarde les articles d’index dans le fichier auxiliaire. Ne pas mettre le \printindex a pour effet que LaTeX n’affiche pas l’index dans la sortie.

Nombre de paquetages existent concernant l’indexation. Le paquetage showidx a pour effet que chaque article d’index est affiché dans la marge sur la page où le \index apparaît. Ceci peut être utile pour préparer l’index. Le paquetage multind, avec d’autres, prend en charge les indexes multiples. Voir aussi l’article de la FAQ TeX sur ce sujet, https://www.texfaq.org/FAQ-multind, et le sujet CTAN, https://ctan.org/topic/index-multi.