Différences

Ci-dessous, les différences entre deux révisions de la page.

--- composition:annexes:index:commandes_de_base [2018/12/09 09:22] – jejust
+++ 3_composition:annexes:index:commandes_de_base [2022/11/29 19:45] (Version actuelle) – Usage de ⟨...⟩ dbitouze
@@ Ligne 1: / Ligne 1: @@
-====== Quelles sont les commandes de base? ======
+====== Comment générer un index? ======
+Par défaut, un index s'obtient en utilisant l'extension [[ctanpkg>makeidx]] et des programmes de traitement d'index. L'extension définit en particulier la précieuse commande ''\printindex'' décrite ci-dessous et redéfinit quelques commandes présentes dans <latex>\LaTeX</latex>.
-$\Reponse$  Il y a principalement trois commandes :
+===== Les commandes à placer dans le document =====
-\begin{descrcmd}
-\item[makeindex] à mettre dans le préambule pour indiquer que
-l'on souhaite créer un index. Elle indique à <latex>\LaTeX</latex> qu'il doit
-stocker, dans un fichier ''.idx'', les entrées de l'index. Sans
-cette commande, l'index sera vide ;
-\item[index\marg{mot}] permet d'ajouter l'entrée \emph{mot} dans
-l'index --- elle s'utilise ainsi :
+Dans les faits, pour générer un index, trois commandes sont nécessaires :
+  * ''\makeindex'' à mettre dans le préambule pour indiquer à <latex>\LaTeX</latex> qu'il doit stocker, dans un fichier ''.idx'', les entrées de l'index. Sans cette commande, l'index sera vide ;
+  * ''\index{⟨mot⟩}'' permet d'ajouter l'entrée ⟨mot⟩ dans l'index. Elle se trouve donc à de multiples reprises dans le corps du texte et permet, par le biais de certains symboles d'obtenir des effets particuliers (voir ici les questions « [[3_composition/annexes/index/changer_le_style_de_certains_mots_indexes|Comment changer le style de certains mots indexés ?]] », « [[3_composition/annexes/index/changer_le_style_des_pages_de_reference|Comment changer le style d'un numéro de page de référence ?]] » et « [[3_composition/annexes/index/construire_un_index_hierarchique|Comment construire un index hiérarchique ?]] ») ;
+  * ''\printindex'' place l'index dans le document à l'endroit où cette commande est disposée. Cette commande a principalement pour rôle d'inclure le fichier ''.ind'' contenant l'index trié.
+Voici un exemple minimaliste de cette utilisation :
 <code latex>
-  je mets ce mot\index{mot} en index.
+\documentclass{article}
-</code>
+\usepackage[french]{babel}
+\usepackage{makeidx}
+\makeindex
+\begin{document}
-\item[printindex] écrit l'index dans le document, à l'endroit où
+Il ne se passe pas un jour\index{jour} sans que je pense à cette mélodie\index{mélodie}.
-cette commande est placée. Cette commande a principalement pour rôle
-d'inclure le fichier ''.ind'' contenant l'index.
-\end{descrcmd}
-La mise en forme et le tri de l'index se font par le programme
+\printindex
-''makeindex'', qui lit le fichier ''.idx'' et le transforme
-en ''.ind''. Il est possible d'indiquer le fichier de style
-d'index (fichier ''.ist'') par l'option ''-s''.
-On exécutera donc, par exemple :
+\end{document}
-<code bash>
-makeindex -s fridx1.ist mondoc.idx
 </code>
-pour créer l'index du fichier ''mondoc.tex''.
+===== L'appel à un programme de génération d'index =====
+Le fichier ''.idx'' contient vos entrées d'index (avec leur numéro de page) telles qu'elles arrivent au fur et à mesure dans votre document. Elles sont dès lors sans mise en forme et non triées. La résolution de ces deux problèmes passe par l'utilisation d'un des programmes évoqués à la question « [[3_composition/annexes/index/generateurs_d_index|Quels sont les programmes générateurs d'index ?]] ». Ces programmes lisent le fichier ''.idx'' et le transforment en ''.ind'' qui contient vos entrées ordonnées mises en forme.
-<note>
+Voici le cas du programme ''makeindex''. Pour créer l'index de votre fichier ''mondoc.tex'', vous exécuteriez (après avoir compilé votre document <latex>\LaTeX</latex> une première fois) :
-Certains packages définissent la commande ''printindex'', mais elle n'est
-pas définie par défaut dans <latex>\LaTeX</latex>. Il peut donc être nécessaire d'inclure le
-package [[ctanpkg>makeidx|makeidx]].
-</note>
+<code bash>
+makeindex mondoc.idx
+</code>
+C'est lors d'une compilation consécutive de votre document ''mondoc.tex'' que vous pourrez observer l'index.
+Dans le cas de ''makeindex'', il est possible d'indiquer un fichier de style d'index (fichier ''.ist'') par l'option ''-s''. Dans le cas où vous disposeriez d'un fichier de style ''monstyle.ist'', vous exécuteriez :
-{{htmlmetatags>metatag-keywords=(LaTeX)
+<code bash>
-metatag-og:title=(Quelles sont les commandes de base?)
+makeindex -s monstyle.ist mondoc.idx
+</code>
+{{htmlmetatags>metatag-keywords=(LaTeX,index)
+metatag-og:title=(Comment générer un index)
 metatag-og:site_name=(FAQ LaTeX francophone)
 }}