Un peu de mise en page, correction de coquilles.
This commit is contained in:
parent
11bd7dbdf7
commit
2c630c4b89
1 changed files with 88 additions and 63 deletions
|
@ -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 : le <date value="$Date: 2004-03-12 16:38:18 $" />.
|
||||
</div>
|
||||
</body> </html>
|
||||
|
|
Loading…
Reference in a new issue