Un peu de mise en page, correction de coquilles.

This commit is contained in:
mlnguyen 2004-03-12 16:38:18 +00:00
parent 11bd7dbdf7
commit 2c630c4b89

View file

@ -11,31 +11,32 @@ PUBLIC "-//ENS/Tuteurs//DTD TML 1//EN"
<h1>Faire un index avec MakeIndex</h1>
<p>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
<em>Mémoires</em> du duc de Luynes (vous pouvez le télécharger :
<a href="exemple.txt">exemple.txt</a>) :</p>
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 <cite>Mémoires</cite> du duc de Luynes (vous pouvez le
télécharger : <a href="exemple.txt">exemple.txt</a>) :</p>
<pre>À 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.</pre>
<pre>
À 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. </pre>
<h2>Avant toute chose</h2>
<p>Commencez par indiquer dans le préambule de votre document que vous
voulez le charger (attention, il faut bien écrire makeidx et non
makeindex) :</p>
voulez le charger (attention, il faut bien écrire <code>makeidx</code>
et non <code>makeindex</code>) :</p>
<pre>\usepackage{makeidx}</pre>
@ -49,46 +50,58 @@ Enfin, placez la commande</p>
<pre>\printindex</pre>
<p class="continue">à l'endroit où vous désirez placer l'index (à la fin,
normalement).</p>
<p class="continue">à l'endroit où vous désirez placer l'index (à la
fin, normalement).</p>
<h2>Les bases</h2>
<p>Pour obtenir une entrée dans l'index, il faut l'indiquer par la
commande <code>\index{mon_entree}</code>. Lors d'une première
compilation, LaTeX repérera tous les <code>\index</code> et écrira pour
chacun d'entre eux une entrée dans <a
href="exemple.idx"><code>exemple.idx</code></a>. Ensuite il faudra faire
une deuxième compilation à l'aide de la commande makeindex :</p>
compilation, LaTeX repérera tous les <code>\index</code> et écrira
pour chacun d'entre eux une entrée dans <a
href="exemple.idx"><code>exemple.idx</code></a>. Ensuite il faudra
faire une deuxième compilation à l'aide de la commande
<code>makeindex</code> :</p>
<pre>makeindex exemple.idx</pre>
<p class="continue">MakeIndex interprétera les entrées de
<code>exemple.idx</code> et les formatera, générant deux nouveaux
fichier, <a href="exemple.ilg"><code>exemple.ilg</code></a> qui contient
les messages de compilation de MakeIndex, et <a
fichier, <a href="exemple.ilg"><code>exemple.ilg</code></a> qui
contient les messages de compilation de MakeIndex, et <a
href="exemple.ind"><code>exemple.ind</code></a> qui contient l'index
formaté. Il faut ensuite une troisième compilation, avec latex, pour que
<code>exemple.ind</code> soit intégré à <code>exemple.tex</code> et
produise l'index.</p>
formaté. Il faut ensuite une troisième compilation, avec latex, pour
que <code>exemple.ind</code> soit intégré à <code>exemple.tex</code>
et produise l'index.</p>
<div class="attention"><p>Il faut préciser à chaque fois à
<code>makeindex</code> 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
<div class="encadre">
<strong>Important</strong> : il faut préciser <strong>à chaque
fois</strong> à <code>makeindex</code> ce que vous voulez indexer, il
ne le fait pas automatiquement.
</div>
<p>
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 <em>manque de souplesse</em>. 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 ».
</p>
<p class="continue">
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
<code>\index{Louis XIV}</code> après chaque mot ou expression que vous
voulez voir référencé.</p></div>
voulez voir référencé.</p>
<h3>Récapitulatif</h3>
<p>Il faut en tout trois compilations pour que l'index soit effectif :</p>
<p>Il faut en tout <strong>trois compilations</strong> pour que
l'index soit effectif :</p>
<pre>latex exemple.tex ; makeindex exemple.idx ; latex exemple.tex</pre>
<h2>Spécifier les entrées de l'index</h2>
@ -97,26 +110,37 @@ voulez voir r
d'exemple, les ducs et pairs. Vous placez donc, après l'expression à
référencer, un <code>\index{}</code> :</p>
<pre>À 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
(...)</pre>
<pre>
À 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 (...)
</pre>
<div class="attention"> Prenez garde à l'environnement dans lequel vous
êtes ! Un <code>\index{Louis XIV}</code> dans du texte « normal » et
un <code>\index{Louis XIV}</code> 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 <code>\index{}</code> juste avant ou juste après
l'environnement dans lequel se trouve l'expression à référencer.</div>
<div class="attention">
<strong>Piège à ...</strong> prenez garde à l'environnement dans
lequel vous êtes ! Un <code>\index{Louis XIV}</code> dans du texte
« normal » et un <code>\index{Louis XIV}</code> 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 !
</div>
<p class="continue">
Pour remédier à ce problème, il vous suffit de placer votre
<code>\index{}</code> juste avant ou juste après l'environnement dans
lequel se trouve l'expression à référencer.
</p>
<h3>Caractères accentués</h3>
<p>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
<code>\index{}</code>, 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 (@).</p>
<p>
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 <code>\index{}</code>, 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 (<code>@</code>).
</p>
<pre>\index{Princes etrangers@Princes étrangers}</pre>
@ -212,7 +236,8 @@ delim_2 "\\dotfill"
<div class="illustration"><img src="mylist.jpg" alt="Encore plus joli" /></div>
<div class="metainformation"> Auteurs : Marie-Lan Nguyen (2000).
Dernière modification le 2002-11-13 par François-Xavier Coudert. </div>
<div class="metainformation"> Auteurs : Marie-Lan Nguyen (2000) et
François-Xavier Coudert (2002).
Dernière modification&nbsp;: le <date value="$Date: 2004-03-12 16:38:18 $" />.
</div>
</body> </html>