Comment générer un index ?#
Par défaut, un index s’obtient en utilisant l’extension makeidx
et des programmes de traitement d’index. L’extension définit en particulier
la précieuse commande \printindex
décrite ci-dessous et redéfinit
quelques commandes présentes dans LaTeX.
1. Les commandes à placer dans le document#
Dans les faits, pour générer un index, trois commandes sont nécessaires :
\makeindex
à mettre dans le préambule pour indiquer à LaTeX qu’il doit stocker, dans un fichier.idx
, les entrées de l’index. Sans cette commande, l’index sera vide ;\index{⟨mot⟩}
permet d’ajouter l’entrée⟨mot⟩
dans l’index. Elle se trouve donc à de multiples reprises dans le corps du texte et permet, par le biais de certains symboles, d’obtenir des effets particuliers (voir ici les questions « Comment construire un index hiérarchique ? ») ;\printindex
place l’index dans le document à l’endroit où cette commande est disposée. Cette commande a principalement pour rôle d’inclure le fichier.ind
contenant l’index trié.
Voici un exemple minimaliste de cette utilisation :
\documentclass[french]{article}
\usepackage[T1]{fontenc} % Encodage T1 (adapté au français)
\usepackage{lmodern} % Caractères plus lisibles
\usepackage{babel} % Réglages linguistiques (avec french)
\pagestyle{empty} % N'affiche pas de numéro de page
\usepackage{makeidx}
\makeindex
\begin{document}
Il ne se passe pas un jour\index{jour} sans que je pense à cette
mélodie\index{mélodie}.
\printindex
\end{document}
2. L’appel à un programme de génération d’index#
Le fichier .idx
contient vos entrées d’index (avec leur numéro de page)
telles qu’elles arrivent au fur et à mesure dans votre document. Elles sont
dès lors sans mise en forme et non triées. La résolution de ces deux problèmes
passe par l’utilisation d’un des programmes évoqués à la question
« Quels sont les programmes générateurs d’index ? ». Ces programmes lisent
le fichier .idx
et le transforment en .ind
qui contient
vos entrées ordonnées mises en forme.
Voici le cas du programme makeindex. Pour créer l’index
de votre fichier mondoc.tex
, vous exécuteriez (après avoir compilé
votre document LaTeX une première fois) :
makeindex mondoc.idx
C’est lors d’une compilation consécutive de votre document mondoc.tex
que vous pourrez observer l’index.
Dans le cas de makeindex
, il est possible d’indiquer un fichier de style
d’index (fichier .ist
) par l’option -s
. Dans le cas où vous disposeriez
d’un fichier de style monstyle.ist
, vous exécuteriez :
makeindex -s monstyle.ist mondoc.idx