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"
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.
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 écriremakeidx
+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).
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 :
\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.
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
+
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é.
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
\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 (...) +-
\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.\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 (@).
+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" - - +