From 2c630c4b89a0c3fbe91fcb08a0df80f560e2ba20 Mon Sep 17 00:00:00 2001 From: mlnguyen Date: Fri, 12 Mar 2004 16:38:18 +0000 Subject: [PATCH] Un peu de mise en page, correction de coquilles. --- logiciels/latex/makeindex.tml | 151 ++++++++++++++++++++-------------- 1 file changed, 88 insertions(+), 63 deletions(-) diff --git a/logiciels/latex/makeindex.tml b/logiciels/latex/makeindex.tml index 5fadb34..4cb842a 100644 --- a/logiciels/latex/makeindex.tml +++ b/logiciels/latex/makeindex.tml @@ -11,31 +11,32 @@ PUBLIC "-//ENS/Tuteurs//DTD TML 1//EN"

Faire un index avec MakeIndex

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) :

+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.
+
+À 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.

Avant toute chose

Commencez par indiquer dans le préambule de votre document que vous -voulez le charger (attention, il faut bien écrire makeidx et non -makeindex) :

+voulez le charger (attention, il faut bien écrire makeidx +et non makeindex) :

\usepackage{makeidx}
@@ -49,46 +50,58 @@ Enfin, placez la commande

\printindex
-

à l'endroit où vous désirez placer l'index (à la fin, -normalement).

+

à l'endroit où vous désirez placer l'index (à la +fin, normalement).

Les bases

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 :

+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.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.

+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 +

+Important : il faut préciser à chaque +fois à makeindex ce que vous voulez indexer, il +ne le fait pas automatiquement. +
+ +

+Pourquoi ? Bien sûr, vous 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 », voire un bête +« il ». 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é.

+voulez voir référencé.

Récapitulatif

-

Il faut en tout trois compilations pour que l'index soit effectif :

+

Il faut en tout trois compilations pour que +l'index soit effectif :

+ 
latex exemple.tex ; makeindex exemple.idx ; latex exemple.tex

Spécifier les entrées de l'index

@@ -97,26 +110,37 @@ voulez voir r 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
-(...)
+
+À 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 (...)
+
-
Prenez garde à l'environnement dans lequel vous -êtes ! Un \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.
+
+Piège à ... prenez garde à l'environnement dans +lequel vous êtes ! Un \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. +

Caractères accentués

-

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 (@).

+

+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}
@@ -212,7 +236,8 @@ delim_2 "\\dotfill"
Encore plus joli
-
Auteurs : Marie-Lan Nguyen (2000). -Dernière modification le 2002-11-13 par François-Xavier Coudert.
- +
Auteurs : Marie-Lan Nguyen (2000) et + François-Xavier Coudert (2002). +Dernière modification : le . +