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> <h1>Faire un index avec MakeIndex</h1>
<p>Vous disposez d'un fichier tex qui contient votre maîtrise, votre <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 autobiographie, ce que vous voulez. Pour faciliter la vie du lecteur
votre document final, vous désirez indexer les termes clefs de votre de votre document final, vous désirez indexer les termes clefs de
texte. Le package MakeIndex vous permet de créer un index. Tout au long votre texte. Le package MakeIndex vous permet de créer un index. Tout
de ce cours nous allons utiliser un petit texte d'exemple, tiré des au long de ce cours nous allons utiliser un petit texte d'exemple,
<em>Mémoires</em> du duc de Luynes (vous pouvez le télécharger : tiré des <cite>Mémoires</cite> du duc de Luynes (vous pouvez le
<a href="exemple.txt">exemple.txt</a>) :</p> 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 <pre>
jeter de l'eau bénite, le feu Roi décida que si les princes lorrains s'y À la mort de M. le duc de Bourgogne, lorsqu'il fut question d'aller
presenteroient, qu'eux ni les ducs n'en jetteroient ; mais que si MM. de jeter de l'eau bénite, le feu Roi décida que si les princes lorrains
Rohan et de Bouillon y étoient, les ducs jetteroient de l'eau bénite s'y presenteroient, qu'eux ni les ducs n'en jetteroient ; mais que si
avant eux : ce qui arriva effectivement ; mais MM. de Rohan et de MM. de Rohan et de Bouillon y étoient, les ducs jetteroient de l'eau
Bouillon, voyant les ducs passer avant eux, s'en allèrent. Ce qui avoit bénite avant eux : ce qui arriva effectivement ; mais MM. de Rohan et
été décidé en faveur de MM. les ducs fut écrit sur le registre de M. de de Bouillon, voyant les ducs passer avant eux, s'en allèrent. Ce qui
Dreux ; mais deux ans après, les représentations de Mme de Maintenon avoit été décidé en faveur de MM. les ducs fut écrit sur le registre
déterminèrent le Roi à faire un changement et à ordonner à M. de Dreux de M. de Dreux ; mais deux ans après, les représentations de Mme de
que cet article seroit rayé sur le registre. Il fut mis en marge que le Maintenon déterminèrent le Roi à faire un changement et à ordonner à
Roi n'avoit jamais voulu décider entre les ducs et MM. de Rohan et de M. de Dreux que cet article seroit rayé sur le registre. Il fut mis en
Bouillon.</pre> 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> <h2>Avant toute chose</h2>
<p>Commencez par indiquer dans le préambule de votre document que vous <p>Commencez par indiquer dans le préambule de votre document que vous
voulez le charger (attention, il faut bien écrire makeidx et non voulez le charger (attention, il faut bien écrire <code>makeidx</code>
makeindex) :</p> et non <code>makeindex</code>) :</p>
<pre>\usepackage{makeidx}</pre> <pre>\usepackage{makeidx}</pre>
@ -49,46 +50,58 @@ Enfin, placez la commande</p>
<pre>\printindex</pre> <pre>\printindex</pre>
<p class="continue">à l'endroit où vous désirez placer l'index (à la fin, <p class="continue">à l'endroit où vous désirez placer l'index (à la
normalement).</p> fin, normalement).</p>
<h2>Les bases</h2> <h2>Les bases</h2>
<p>Pour obtenir une entrée dans l'index, il faut l'indiquer par la <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 commande <code>\index{mon_entree}</code>. Lors d'une première
compilation, LaTeX repérera tous les <code>\index</code> et écrira pour compilation, LaTeX repérera tous les <code>\index</code> et écrira
chacun d'entre eux une entrée dans <a pour chacun d'entre eux une entrée dans <a
href="exemple.idx"><code>exemple.idx</code></a>. Ensuite il faudra faire href="exemple.idx"><code>exemple.idx</code></a>. Ensuite il faudra
une deuxième compilation à l'aide de la commande makeindex :</p> faire une deuxième compilation à l'aide de la commande
<code>makeindex</code> :</p>
<pre>makeindex exemple.idx</pre> <pre>makeindex exemple.idx</pre>
<p class="continue">MakeIndex interprétera les entrées de <p class="continue">MakeIndex interprétera les entrées de
<code>exemple.idx</code> et les formatera, générant deux nouveaux <code>exemple.idx</code> et les formatera, générant deux nouveaux
fichier, <a href="exemple.ilg"><code>exemple.ilg</code></a> qui contient fichier, <a href="exemple.ilg"><code>exemple.ilg</code></a> qui
les messages de compilation de MakeIndex, et <a contient les messages de compilation de MakeIndex, et <a
href="exemple.ind"><code>exemple.ind</code></a> qui contient l'index href="exemple.ind"><code>exemple.ind</code></a> qui contient l'index
formaté. Il faut ensuite une troisième compilation, avec latex, pour que formaté. Il faut ensuite une troisième compilation, avec latex, pour
<code>exemple.ind</code> soit intégré à <code>exemple.tex</code> et que <code>exemple.ind</code> soit intégré à <code>exemple.tex</code>
produise l'index.</p> et produise l'index.</p>
<div class="attention"><p>Il faut préciser à chaque fois à <div class="encadre">
<code>makeindex</code> ce que vous voulez indexer, il ne le fait pas <strong>Important</strong> : il faut préciser <strong>à chaque
automatiquement. Pourquoi ? Bien sûr, voue préfereriez avoir à ne donner fois</strong> à <code>makeindex</code> ce que vous voulez indexer, il
le mot à indexer qu'une seule fois et laisser l'ordinateur faire le ne le fait pas automatiquement.
reste, mais cette procédure manque de souplesse. Admettons que vous </div>
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 <p>
XIV ». Mais vous aimeriez sans doute aussi recenser les pages ou vous Pourquoi ? Bien sûr, vous préfereriez avoir à ne donner le mot à
n'avez pas écrit textuellement « Louis XIV », mais où vous en avez indexer qu'une seule fois et laisser l'ordinateur faire le reste, mais
parlé sous les périphrases « le roi de France », « le monarque », cette procédure <em>manque de souplesse</em>. Admettons que vous
etc... Ce que vous permet l'apposition à la main de commandes 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 <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> <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> <pre>latex exemple.tex ; makeindex exemple.idx ; latex exemple.tex</pre>
<h2>Spécifier les entrées de l'index</h2> <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 à d'exemple, les ducs et pairs. Vous placez donc, après l'expression à
référencer, un <code>\index{}</code> :</p> référencer, un <code>\index{}</code> :</p>
<pre>À la mort de M. le duc de Bourgogne, lorsqu'il fut question d'aller <pre>
jeter de l'eau bénite, le feu Roi décida que si les princes lorrains s'y À la mort de M. le duc de Bourgogne, lorsqu'il fut question d'aller
presenteroient, qu'eux ni les ducs\index{Ducs et pairs} n'en jetteroient jeter de l'eau bénite, le feu Roi décida que si les princes lorrains
(...)</pre> 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 <div class="attention">
êtes ! Un <code>\index{Louis XIV}</code> dans du texte « normal » et <strong>Piège à ...</strong> prenez garde à l'environnement dans
un <code>\index{Louis XIV}</code> dans dans une note en bas de page, ou lequel vous êtes ! Un <code>\index{Louis XIV}</code> dans du texte
dans un tableau, ne produiront pas une entrée avec deux références, mais « normal » et un <code>\index{Louis XIV}</code> dans dans une note en
deux entrées identiques ! Pour remédier à ce problème, il vous suffit de bas de page, ou dans un tableau, ne produiront pas une entrée avec
placer votre <code>\index{}</code> juste avant ou juste après deux références, mais deux entrées identiques !
l'environnement dans lequel se trouve l'expression à référencer.</div> </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> <h3>Caractères accentués</h3>
<p>MakeIndex n'a pas été conçu pour les langues possédant des accents : <p>
dès qu'un mot contenant des caractères accentués se trouvera dans votre MakeIndex n'a pas été conçu pour les langues possédant des accents :
<code>\index{}</code>, il le classera au début des mots commençant par dès qu'un mot contenant des caractères accentués se trouvera dans
cette même lettre... Il vous faut donc indiquer vous-même à makeindex où votre <code>\index{}</code>, il le classera au début des mots
classer la référence : on utilise pour cela une arobase (@).</p> 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> <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="illustration"><img src="mylist.jpg" alt="Encore plus joli" /></div>
<div class="metainformation"> Auteurs : Marie-Lan Nguyen (2000). <div class="metainformation"> Auteurs : Marie-Lan Nguyen (2000) et
Dernière modification le 2002-11-13 par François-Xavier Coudert. </div> François-Xavier Coudert (2002).
Dernière modification&nbsp;: le <date value="$Date: 2004-03-12 16:38:18 $" />.
</div>
</body> </html> </body> </html>