Vous disposez d'un fichier tex qui contient votre maîtrise, votre autobiographie, ce que vous voulez. Pour faciliter la vie du lecteur de votre document final, vous désirez indexer les termes clefs de votre texte. Le package MakeIndex vous permet de créer un index. Tout au long de ce cours nous allons utiliser un petit texte d'exemple, tiré des Mémoires du duc de Luynes (vous pouvez le télécharger : exemple.txt) :
À la mort de M. le duc de Bourgogne, lorsqu'il fut question d'aller jeter de l'eau bénite, le feu Roi décida que si les princes lorrains s'y presenteroient, qu'eux ni les ducs n'en jetteroient ; mais que si MM. de Rohan et de Bouillon y étoient, les ducs jetteroient de l'eau bénite avant eux : ce qui arriva effectivement ; mais MM. de Rohan et de Bouillon, voyant les ducs passer avant eux, s'en allèrent. Ce qui avoit été décidé en faveur de MM. les ducs fut écrit sur le registre de M. de Dreux ; mais deux ans après, les représentations de Mme de Maintenon déterminèrent le Roi à faire un changement et à ordonner à M. de Dreux que cet article seroit rayé sur le registre. Il fut mis en marge que le Roi n'avoit jamais voulu décider entre les ducs et MM. de Rohan et de Bouillon.
Commencez par indiquer dans le préambule de votre document que vous voulez le charger (attention, il faut bien écrire makeidx et non makeindex) :
\usepackage{makeidx}
Ensuite, dans la suite du préambule, mettez la commande
\makeindex
qui demande à MakeIndex de se mettre au travail. Enfin, placez la commande
\printindex
à l'endroit où vous désirez placer l'index (à la fin, normalement).
Pour obtenir une entrée dans l'index, il faut l'indiquer par la
commande \index{mon_entree}. Lors d'une première
compilation, LaTeX repérera tous les \index et écrira pour
chacun d'entre eux une entrée dans exemple.idx. Ensuite il faudra faire
une deuxième compilation à l'aide de la commande makeindex :
makeindex exemple.idx
MakeIndex interprétera les entrées de
exemple.idx et les formatera, générant deux nouveaux
fichier, exemple.ilg qui contient
les messages de compilation de MakeIndex, et exemple.ind qui contient l'index
formaté. Il faut ensuite une troisième compilation, avec latex, pour que
exemple.ind soit intégré à exemple.tex et
produise l'index.
Il faut préciser à chaque fois à
makeindex ce que vous voulez indexer, il ne le fait pas
automatiquement. Pourquoi ? Bien sûr, voue préfereriez avoir à ne donner
le mot à indexer qu'une seule fois et laisser l'ordinateur faire le
reste, mais cette procédure manque de souplesse. Admettons que vous
vouliez créer une entrée d'index « Louis XIV ». Un indexage automatique
vous permettrait bien sûr de recenser toutes les occurrences de « Louis
XIV ». Mais vous aimeriez sans doute aussi recenser les pages ou vous
n'avez pas écrit textuellement « Louis XIV », mais où vous en avez
parlé sous les périphrases « le roi de France », « le monarque »,
etc... Ce que vous permet l'apposition à la main de commandes
\index{Louis XIV} après chaque mot ou expression que vous
voulez voir référencé.
Il faut en tout trois compilations pour que l'index soit effectif :
latex exemple.tex ; makeindex exemple.idx ; latex exemple.tex
La procédure de base est la suivante : vous voulez indexer, dans le texte
d'exemple, les ducs et pairs. Vous placez donc, après l'expression à
référencer, un \index{} :
À la mort de M. le duc de Bourgogne, lorsqu'il fut question d'aller
jeter de l'eau bénite, le feu Roi décida que si les princes lorrains s'y
presenteroient, qu'eux ni les ducs\index{Ducs et pairs} n'en jetteroient
(...)
\index{Louis XIV} dans du texte « normal » et
un \index{Louis XIV} dans dans une note en bas de page, ou
dans un tableau, ne produiront pas une entrée avec deux références, mais
deux entrées identiques ! Pour remédier à ce problème, il vous suffit de
placer votre \index{} juste avant ou juste après
l'environnement dans lequel se trouve l'expression à référencer.MakeIndex n'a pas été conçu pour les langues possédant des accents :
dès qu'un mot contenant des caractères accentués se trouvera dans votre
\index{}, il le classera au début des mots commençant par
cette même lettre... Il vous faut donc indiquer vous-même à makeindex où
classer la référence : on utilise pour cela une arobase (@).
\index{Princes etrangers@Princes étrangers}
veut dire que vous demandez à MakeIndex de classer « Princes étrangers » comme s'il n'y avait pas d'accent dans l'expression.
À noter : Vous pouvez utiliser cette technique pour classer par exemple des membres d'une même famille dans l'ordre chronologique, et non pas par ordre alphabétique de leur prénom :
\index{Guise1@Guise, Henri de Lorraine, duc de}
\index{Guise2@Guise, Charles de Lorraine, duc de}
Vous pouvez également l'utiliser pour formater à votre goût l'aspect d'une entrée d'index. Ainsi,
\index{Bourgogne@\textsc{Bourgogne}, Louis de France, duc de}
vous permet d'avoir le nom de famille en petites
majuscules. Vous pouvez évidemment remplacer \textsc{} par
n'importe quel type de fonte (italique, gras, penché...).
Pour produire une sous-entrée, vous devez d'abord indiquer l'entrée principale puis la sous-entrée, séparée par un point d'exclamation. Ainsi, si l'on reprend notre exemple, vous voulez faire du mot « registres » une sous-entrée de « service des Cérémonies » :
\index{Ceremonies@Cérémonies, service de!registres}
Vous pouvez faire des sous-sous-entrées. MakeIndex et LaTeX ne supportent que trois niveaux d'indexation : vous ne pouvez pas avoir de sous-sous-sous-entrées.
MakeIndex vous permet de faire des références croisées, qui ne renvoient pas à une page, mais à une autre entrée. Ainsi, dans notre exemple, on veut que le lecteur qui cherche une entrée à Bouillon soit renvoyé à « princes étrangers » :
\index{Bouillon|see{Princes étrangers}}
vous donnera :
Bouillon, voir Princes étrangers
La traduction de |see{} dépend du package de Babel que
vous utilisez.
Par défaut, l'index ressemble à ceci (c'est le résultat de
exemple.tex) :
Le texte s'étend sur deux colonnes. Si vous voulez modifier le
formatage de l'index, il vous faudra créer un fichier .ist
(perso.ist, par exemple) contenant vos personnalisations.
Pour utiliser ce fichier .ist, il faut le donner en option à
MakeIndex pendant la deuxième compilation :
makeindex -s perso.ist exemple.idx
Il faut insérer dans votre perso.ist les lignes suivantes :
heading_prefix "{\\bfseries\\hfil "
heading_suffix "\\hfil}\\nopagebreak\n"
headings_flag 1
Il faut insérer dans votre perso.ist les lignes suivantes :
delim_0 "\\dotfill" delim_1 "\\dotfill" delim_2 "\\dotfill"
