Les index sous LaTeX et leur personnalisation

Les caractères accentués ne sont pas gérés par la commande makeindex.

Aussi, pour correctement classer l'entrée dans l'index, il convient de définir ce dernier de la manière suivante : \index{sans_accents@avec_accents}.

Dans l'exemple qui suit, le mot « accentué » sera classé comme « accentue ».

\index{accentue@accentué}

Pour mémoire, la commande makeindex ne gère que trois niveaux d'entrées. Les différents niveaux d'entrées sont séparés par le caractère « ! » (point d'exclamation).

1. Entrée simple : \index{terme}.
2. Entrée à deux niveaux : \index{terme!sous-terme}.
3. Entrée à trois niveaux : \index{terme!sous-terme!sous-sous-terme}.

Il est possible de faire référence à une autre entrée de l'index pour un terme indexé. Cela se fait de la manière suivante : \index{Thermes|see{Bains}}.

Le caractère « | » est obtenu par la combinaison de touches « Alt Gr + 6 » sur un clavier azerty français.

\index{Thermes|see{Bains}} donnera dans l'index « Thermes, voir Bains ».

Les diverses commandes utilisées ci-dessus sont normalement connues d'un utilisateur de LaTeX :

• un groupe est créé avec {…} afin de limiter la portée des commandes au seul en-tête de groupe ;
• \bfseries permet d'activer la mise en gras ;
• \hfil insère un espace élastique ;
• À cet endroit, sera insérée la lettre correspondant à l'en-tête de groupe ;
• \hfil insère un espace élastique ;
• \nopagebreak indique que l'on ne souhaite pas de saut de page à cet endroit.

{\bfseries\hfil t \hfil}\nopagebreak

{\bfseries\hfil T \hfil}\nopagebreak

Il est possible d'ouvrir un groupe dans heading_prefix et de le fermer dans heading_suffix. Toutefois, attention à bien le fermer sinon des erreurs de compilation apparaîtront.

La façon la plus simple est, à mon avis, de concevoir la ligne de commande entière, puis de la couper une fois qu'elle est fonctionnelle et enfin de l'insérer dans le fichier ist personnalisé.

Personnellement, j'aime bien qu'entre le terme indexé et les numéros de pages, il y ait des points de suite. Je trouve que cela facilite la lecture.

Je vais donc vous montrer comment obtenir cela.

La liste qui suit vous permettra de comprendre chaque paramètre :

• delim_0 <string> : chaîne qui sera insérée entre le terme indexé de niveau 0 et le premier numéro de page, par défaut une virgule suivie d'une espace (", ") ;
• delim_1 <string> : chaîne qui sera insérée entre le terme indexé de niveau 1 et le premier numéro de page, par défaut une virgule suivie d'une espace (", ") ;
• delim_2 <string> : chaîne qui sera insérée entre le terme indexé de niveau 2 et le premier numéro de page, par défaut une virgule suivie d'une espace (", ") ;
• delim_n <string> : chaîne qui sera insérée entre deux numéros de page pour le même terme indexé, par défaut une virgule suivie d'une espace (", ") ;
• delim_r <string> : chaîne qui sera insérée entre le premier et le dernier numéro de page d'une plage, par défaut "--" ;
• delim_t <string> : chaîne qui sera insérée à la fin d'une liste de numéro de page, par défaut "". Cette chaîne n'aura aucun effet s'il n'y a aucune liste de numéros de page.

Fort de ces informations, il ne reste plus qu'à insérer les trois lignes ci-dessous dans notre fichier perso.ist et lancer une compilation :

delim_0 "\\hspace{6pt}\\dotfill\\hspace{6pt}"
delim_1 "\\hspace{6pt}\\dotfill\\hspace{6pt}"
delim_2 "\\hspace{6pt}\\dotfill\\hspace{6pt}"

Résultat de la compilation :

Joli résultat. À un détail près. Notre index semble ne prendre que la moitié de la largeur de la page. Rien de bien grave, le style de page utilisé pour l'index est le style plain en mode deux colonnes (personnellement, j'aime bien en deux colonnes). Peut-être qu'avec le package multicol, il est possible de passer en mode une ou trois colonnes. Je n'ai pas testé. Si quelqu'un sait comment faire, je suis preneur de l'information.

Si vous souhaitez redéfinir l'en-tête ou le pied de page, le package fancyhdr vous permettra de le faire sans difficultés.

La liste ci-dessous fournit toutes les informations permettant de mettre en forme les termes indexés :

• item_0 <string> : commande insérée entre deux niveaux primaires de l'index (level 0). Par défaut `\n \\item ` ;
• item_1 <string> : commande insérée entre deux niveaux secondaires de l'index (level 1). Par défaut `\n \\subitem ` ;
• item_2 <string> : commande insérée entre deux niveaux tertiaires de l'index (level 2). Par défaut `\n \\subsubitem ` ;
• item_01 <string> : commande insérée entre un niveau primaire (level 0) et un niveau secondaire (level 1) de l'index. Par défaut `\n \\subitem ` ;
• item_x1 <string> : commande insérée entre un niveau primaire (level 0) et un niveau secondaire (level 1) de l'index quand le niveau primaire n'a pas de numéro de page associé. Par défaut `\n \\subitem ` ;
• item_12 <string> : commande insérée entre un niveau secondaire (level 1) et un niveau tertiaire (level 2) de l'index. Par défaut `\n \\subsubitem ` ;
• item_x2 <string> : commande insérée entre un niveau secondaire (level 1) et un niveau tertiaire (level 2) de l'index quand le niveau secondaire n'a pas de numéro de page associé. Par défaut `\n \\subsubitem `.

Afin de faciliter la compréhension, nous allons ajouter les deux lignes suivantes dans notre fichier perso.ist :

item_0 "\n \\item \\bfseries{" 
item_x1 "}\\normalfont\n \\subitem "

Nous modifions aussi la ligne suivante :

delim_0 "}\\hspace{6pt}\\dotfill\\hspace{6pt}"

Avec ces modifications, les termes indexés de premier niveau seront en gras, tandis que les termes des deuxième et troisième niveaux seront en graisse normale.

Voici le résultat de la compilation prenant en compte les modifications précédentes.

Résultat de la compilation :

Ci-dessous le fichier exemple.ist final ayant permis la génération de l'index affiché au-dessus :

heading_prefix "{\\bfseries\\hfil\\fcolorbox{red}{lightgray}{\\textcolor{blue}{ "
heading_suffix "}}\\hfil}\\vspace*{3ex}\\nopagebreak\n"
headings_flag 1
symhead_positive "Symboles"
symhead_negative "symboles"
numhead_positive "Nombres"
numhead_negative "nombres"
delim_0 "}\\hspace{6pt}\\dotfill\\hspace{6pt}"
delim_1 "\\hspace{5pt}\\dotfill\\hspace{5pt}"
delim_2 "\\hspace{4pt}\\dotfill\\hspace{4pt}"
item_0 "\n \\item {\\bfseries " 
item_x1 "}\n \\normalfont\\subitem "