Insérer un index

Exploiter les index

Dans les ouvrages longs et bien structurés, il est quasiment indispensable de proposer aux lecteurs un index. L’index va afficher une liste de mots, de termes techniques ou scientifiques, de commandes informatiques, de noms propres… utilisés dans l’ouvrage. En face de chacune de ces entrées, le lecteur trouvera un ou plusieurs numéros de page indiquant où se trouve l’entrée concernée dans le livre. Ainsi, le lecteur pourra se rendre très facilement aux pages concernées par sa recherche.

Vous pourrez afficher des index simples ou imbriqués et des index avec des renvois. LaTeX permet d’exploiter ces index avec efficacité et rigueur.

Connaître la structure des index

Pour créer un index dans LaTeX, vous devez utiliser plusieurs éléments. Tout d’abord, vous ajouterez le package makeidx dans le préambule, puis, à sa suite, vous insérerez la commande \makeindex. Cette commande indique à LaTeX que le document inclut un index.

Dans le document, il faut insérer la commande \printindex là où vous souhaitez afficher l’index du document. Ensuite, vous utiliserez la commande \index{Terme à indexer} pour signaler chaque terme à indexer.

Ajouter le package makeidx

Pour insérer un index dans un document, il faut utiliser le package makeidx. Attention à la syntaxe particulière du nom de ce package. Puis vous saisissez la commande \makeindex, qui indique à LaTeX que le document inclut un index. Ces deux éléments s’insèrent bien sûr dans le préambule.

Voici un exemple pour une classe de document de type livre :

\documentclass[11pt,a4paper]{book} 
\usepackage[utf8]{inputenc} 
\usepackage[french]{babel} 
\usepackage[T1]{fontenc} 
\usepackage{lmodern} 
% Ajouter le package makeidx 
\usepackage{makeidx} 
\makeindex 

Marquer les termes à indexer

Maintenant, dans le document, vous devez marquer tous les termes qui doivent être indexés. Pour cela, utilisez la commande \index{Terme à indexer}. Entre les accolades de la commande, vous indiquez le terme à indexer. Assez souvent, mais ce n’est pas une règle absolue, le terme à indexer est composé d’un seul mot, mais il y a de nombreuses exceptions, comme pour des noms propres.

Dans cet exemple, c’est le mot commodo qui est indexé :

tellus ac cursus commodo\index{commodo}, tortor mauris condimentum 

Juste après le mot dans le texte courant, vous ajoutez la commande \index{...}. 

Vous devez donc faire ceci pour tous les termes que vous souhaitez indexer. En fonction de l’éditeur LaTeX que vous utilisez, vous pouvez utiliser les fonctions de recherche et de remplacement pour vous aider dans cette tâche.

Vous pouvez rechercher le mot commodo et le remplacer par commodo\index{commodo}. 

Avec Texmaker, vous pouvez insérer la commande \index{•} dans la barre des outils, en cliquant sur le bouton ref :

Insérer l’index dans le document

Pour insérer l’index dans le document, vous devez utiliser la commande \printindex. Vous  insérez cette commande dans le code du document, là où vous souhaitez que l’index soit affiché. Usuellement, l’index d’un ouvrage est affiché en fin de document, mais vous faites ce que vous voulez.

Dans cet exemple, l’index est inséré à la fin du document, juste avant sa fermeture :

...consectetur est at lobortis. 
 
\printindex 
\end{document} 

Connaître le problème des caractères accentués

Sachez qu’il peut exister une problématique dans l’affichage par ordre alphabétique des entrées ayant des caractères accentués. Voici un exemple très concret :

Il mange des pâtes\index{pâtes} et des patates\index{patates}. 

Nous avons deux entrées d’index : pâtes et patates. Voici l’affichage de l’index généré :

L’ordre alphabétique d’affichage n’est pas correct.

Pour pallier ce problème, il faut indiquer une version avec les accents et une version sans les accents. Voici la syntaxe à utiliser :

Il mange des pâtes\index{pates@pâtes} et des 
patates\index{patates}. 

Dans la commande index{•}, le premier terme est celui qu’il faut utiliser dans l’affichage alphabétique de l’index, et le deuxième est le terme qu’il faut afficher dans l’index.

Voici l’affichage obtenu avec la correction de la syntaxe :

Vous pourriez aussi rencontrer ce type de problème avec les majuscules des mots.

Insérer des liens hypertextes dans l’index

Lorsque le document LaTeX est rendu en PDF, il est très appréciable pour les lecteurs d’avoir des liens hypertextes sur les numéros des pages qui permettent d’accéder immédiatement au texte courant correspondant.

Pour cela, il suffit tout simplement de déclarer le package hyperref dans le préambule du document. Et c’est tout ! Le package va automatiquement détecter les numéros de pages des entrées dans l’index et la position des commandes index{•} correspondantes dans le document courant. Les liens seront donc aussitôt utilisables dans le document PDF.

Voici le préambule complet :

\documentclass[11pt,a4paper]{book} 
\usepackage[utf8]{inputenc} 
\usepackage[french]{babel} 
\usepackage[T1]{fontenc} 
\usepackage{lmodern} 
% Ajout du package hyperref 
\usepackage{hyperref} 
% Ajouter le package makeidx 
\usepackage{makeidx} 
\makeindex 

Le document ne change pas, il possède toujours toutes ces entrées d’index, mais, maintenant, il y a des liens hypertextes sur les numéros des pages.

Voici l’affichage obtenu dans le PDF :