> For the complete documentation index, see [llms.txt](https://ayakaleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ayakaleaf-pro.ayaka.space/latex/fr/structure-du-document/04-indices.md). # Index Dans certains gros documents, par exemple des livres, il est d'usage d'établir une liste alphabétique contenant les principaux termes. Avec LaTeX et le programme d'assistance **imakeidx**, un index peut être généré assez facilement. ## Introduction Voyons un simple exemple fonctionnel. ```latex \documentclass{article} \usepackage[T1]{fontenc} \usepackage{imakeidx} \makeindex \begin{document} \section{Introduction} Dans cet exemple, plusieurs mots-clés\index{keywords} seront utilisés qui sont importants et méritent d'apparaître dans l'Index\index{Index}. Des termes comme generate\index{generate} et some\index{others} apparaîtront aussi. \printindex \end{document} ``` [Ouvrez cet exemple dans Overleaf](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Index+example\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%5BT1%5D%7Bfontenc%7D%0A%5Cusepackage%7Bimakeidx%7D%0A%5Cmakeindex%0A%0A%5Cbegin%7Bdocument%7D%0A%5Csection%7BIntroduction%7D%0AIn+this+example%2C+several+keywords%5Cindex%7Bkeywords%7D+will+be+used+%0Awhich+are+important+and+deserve+to+appear+in+the+Index%5Cindex%7BIndex%7D.%0A%0ATerms+like+generate%5Cindex%7Bgenerate%7D+and+some%5Cindex%7Bothers%7D+will+%0Aalso+show+up.+%0A%0A%5Cprintindex%0A%5Cend%7Bdocument%7D) L'image suivante montre le résultat produit par l'exemple ci-dessus : ![Index1OLV2.png](/files/208fb2efd6a87cf28fc0ec748f5a5c7969ebdf4c) Tout d'abord, le paquet est inclus dans le préambule par la ligne ```latex \usepackage{imakeidx} ``` Puis la commande `\makeindex` est indispensable pour que l'index fonctionne et peut prendre certains paramètres pour personnaliser son apparence ; dans les sections suivantes, cela deviendra clair. Pour ajouter une entrée à l'index, la commande `\index{}` est utilisée, où le mot à ajouter est inséré comme paramètre. Attention, cela n'affichera pas le mot à la position courante mais seulement dans l'index. Enfin, la commande `\printindex` rendra effectivement l'index. Si vous utilisez une localisation particulière au moyen du `babel` paquet, le titre sera traduit en conséquence. Remarque : au lieu de `imakeidx`, le paquet `makeidx` peut être importé mais offre moins de possibilités de personnalisation. ## Index sur Overleaf Lors de l'ajout d'un index à un projet sur Overleaf, il est **important de noter** que, pour que l'index se compile correctement, le principal `.tex` fichier doit se trouver dans le répertoire racine du projet, *en dehors de tout dossier*. Cela garantit que les fichiers auxiliaires nécessaires pour générer l'index sont mis en cache de manière à être accessibles au compilateur. ## Entrées et sous-entrées Comme mentionné dans la section précédente, la commande `\index` ajoutera le mot qui lui est transmis à l'index, mais ce n'est pas la seule manière de l'utiliser. ```latex \documentclass{article} \usepackage[T1]{fontenc} \usepackage{imakeidx} \makeindex \begin{document} \section{Introduction} Dans cet exemple, plusieurs mots-clés\index{keywords} seront utilisés qui sont importants et méritent d'apparaître dans l'Index\index{Index}. Des termes comme generate\index{generate} et some\index{others} apparaîtront aussi. Les termes de l'index peuvent aussi être imbriqués \index{Index!nested} \clearpage \section{Second section} Cette deuxième section\index{section} peut inclure un mot particulier, et étendre ceux déjà utilisés\index{keywords!used}. \printindex \end{document} ``` [Ouvrez cet exemple dans Overleaf](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Index+example+2\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%5BT1%5D%7Bfontenc%7D%0A%5Cusepackage%7Bimakeidx%7D%0A%5Cmakeindex%0A%0A%5Cbegin%7Bdocument%7D%0A%5Csection%7BIntroduction%7D%0AIn+this+example%2C+several+keywords%5Cindex%7Bkeywords%7D+will+be+used+%0Awhich+are+important+and+deserve+to+appear+in+the+Index%5Cindex%7BIndex%7D.%0A%0ATerms+like+generate%5Cindex%7Bgenerate%7D+and+some%5Cindex%7Bothers%7D+will+also+%0Ashow+up.+Terms+in+the+index+can+also+be+nested+%5Cindex%7BIndex%21nested%7D%0A%0A%5Cclearpage%0A%0A%5Csection%7BSecond+section%7D%0AThis+second+section%5Cindex%7Bsection%7D+may+include+some+special+word%2C+%0Aand+expand+the+ones+already+used%5Cindex%7Bkeywords%21used%7D.%0A%0A%5Cprintindex%0A%5Cend%7Bdocument%7D) L'image suivante montre le résultat produit par l'exemple ci-dessus : ![Index2OLV2.png](/files/a997a21ea99b59700a6e18ac32a55b15dcc74423) Il est courant d'étendre les termes de l'index pour inclure des adjectifs particuliers. Par exemple, le mot *Field* peut avoir une signification particulière s'il est précédé de l'adjectif *finite* ou suivi de *of characteristic 0*, et il peut être un peu fastidieux d'ajouter différents types de *Field*comme entrées séparées dans l'index. Pour de tels cas, vous pouvez ajouter un point d'exclamation "!" qui ajoutera les termes après ce signe comme sous-entrées du mot principal *Field*. Dans l'exemple, le mot "Index" a le mot "nested" comme sous-entrée. ## Mise en forme de l'index Une mise en forme simple de l'index, comme changer le titre de l'index, ajouter plusieurs colonnes et modifier la largeur des colonnes, peut se faire facilement en passant des valeurs optionnelles à `\makeindex`: ```latex \documentclass{article} \usepackage[T1]{fontenc} \usepackage{imakeidx} \makeindex[columns=3, title=Alphabetical Index] \begin{document} \section{Introduction} Dans cet exemple, plusieurs mots-clés\index{keywords} seront utilisés qui sont importants et méritent d'apparaître dans l'Index\index{Index}. Des termes comme generate\index{generate} et some\index{others} apparaîtront aussi. Les termes de l'index peuvent aussi être imbriqués \index{Index!nested} \clearpage \section{Second section} Cette deuxième section\index{section} peut inclure un mot particulier, et étendre ceux déjà utilisés\index{keywords!used}. \printindex \end{document} ``` [Ouvrez cet exemple dans Overleaf](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Index+example+3\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%5BT1%5D%7Bfontenc%7D%0A%5Cusepackage%7Bimakeidx%7D%0A%5Cmakeindex%5Bcolumns%3D3%2C+title%3DAlphabetical+Index%5D%0A%0A%5Cbegin%7Bdocument%7D%0A%5Csection%7BIntroduction%7D%0AIn+this+example%2C+several+keywords%5Cindex%7Bkeywords%7D+will+be+used+which+%0Aare+important+and+deserve+to+appear+in+the+Index%5Cindex%7BIndex%7D.%0A%0ATerms+like+generate%5Cindex%7Bgenerate%7D+and+some%5Cindex%7Bothers%7D+will+also+%0Ashow+up.+Terms+in+the+index+can+also+be+nested+%5Cindex%7BIndex%21nested%7D%0A%0A%5Cclearpage%0A%0A%5Csection%7BSecond+section%7D%0AThis+second+section%5Cindex%7Bsection%7D+may+include+some+special+word%2C+%0Aand+expand+the+ones+already+used%5Cindex%7Bkeywords%21used%7D.%0A%0A%5Cprintindex%0A%5Cend%7Bdocument%7D) L'image suivante montre le résultat produit par l'exemple ci-dessus : ![Index3OLV2.png](/files/9223eb30f6961d5a44c2e12078782b3b220abcba) Dans cet exemple, l'index est présenté dans un format à trois colonnes avec le paramètre `columns=3`, et le titre est changé en "Alphabetical Index" par `title=Alphabetical Index`; ces paramètres sont passés à `\makeindex` dans le préambule. Voir le [guide de référence](#reference-guide) pour une liste des paramètres disponibles et leur description. ### Utilisation de fichiers de style Pour personnaliser davantage l'index, on peut utiliser un fichier de style. Les fichiers de style informent `makeindex` sur le format prévu pour le résultat final. Les fichiers de style contiennent une liste de `` paires. Par exemple, si l'on doit regrouper les termes de l'index par leur lettre initiale et aligner les numéros de page à droite, le fichier de style suivant fera l'affaire : ```latex headings_flag 1 heading_prefix "\n\\centering\\large\\sffamily\\bfseries% \\noindent\\textbf{"heading_suffix "}\\par\\nopagebreak\n" item_0 "\n \\item \\small " delim_0 " \\hfill " delim_1 " \\hfill " delim_2 " \\hfill " ``` Les clés modifient différents éléments dans la sortie de l'index : * `headings_flag 1` active le regroupement en insérant l'en-tête de groupe (symboles, nombres ou lettres) avant un nouveau groupe. * `heading_prefix` met en forme l'en-tête à insérer avant qu'une nouvelle lettre ne commence. Il utilise les commandes de mise en forme habituelles pour la famille de police, la taille de police et l'alignement, mais les antislashs doivent être échappés à l'aide d'un double antislash au lieu d'un seul. * `item_0` est ce qui sera inséré entre deux éléments principaux. * `delim_*` est le délimiteur à insérer entre la clé et le premier numéro de page. Pour une liste complète des clés et des valeurs à utiliser dans un fichier .ist, voir [Le tableau inclus dans le guide de référence](#keys-to-create-styles-files). Supposons que le fichier précédent soit enregistré sous le nom "example\_style.ist". Pour l'utiliser dans le document, nous ajoutons le paramètre `options= -s example_style.ist` à la `\makeindex` commande. ```latex \documentclass{article} \usepackage[utf8]{inputenc} \usepackage[T1]{fontenc} \usepackage{imakeidx} \makeindex[columns=3, title=Alphabetical Index, options= -s example_style.ist] \begin{document} \tableofcontents \section{Introduction} Dans cet exemple, plusieurs mots-clés\index{keywords} seront utilisés, qui sont importants et méritent d'apparaître dans l'Index\index{Index}. Des termes comme generate\index{generate}, une excellente\index{great} liste et d'autres termes\index{others} qui pourraient être importants\index{important} apparaîtront aussi. Les termes de l'index peuvent aussi être imbriqués \index{Index!nested} \clearpage \section{Second section} Cette deuxième section\index{section} peut inclure un mot particulier, et étendre ceux déjà utilisés\index{keywords!used}. \printindex \end{document} ``` [Ouvrir un exemple utilisant un fichier de style d'index sur Overleaf](https://www.overleaf.com/project/new/template/20614?id=70756423\&templateName=Using+an+index+style+file\&latexEngine=pdflatex\&texImage=texlive-full%3A2020.1\&mainFile=) L'image suivante montre le résultat produit par l'exemple ci-dessus : ![Index4OLV2.png](/files/8ef93dc99757de176646da6eecf89bad332bc9e5) ## Inclure l'index dans la table des matières Par défaut, l'index n'est pas inclus dans la table des matières ; cela peut être facilement ajusté. ```latex \documentclass{article} \usepackage[T1]{fontenc} \usepackage{imakeidx} \makeindex[columns=3, title=Alphabetical Index, intoc] \begin{document} \tableofcontents \section{Introduction} Dans cet exemple, plusieurs mots-clés\index{keywords} seront utilisés, qui sont importants et méritent d'apparaître dans l' Index\index{Index}. Des termes comme generate\index{generate} et some\index{others} apparaîtront aussi. Les termes de l'index peuvent aussi être imbriqués \index{Index!nested} \clearpage \section{Second section} Cette deuxième section\index{section} peut inclure un mot particulier , et étendre ceux déjà utilisés\index{keywords!used}. \printindex \end{document} ``` [Ouvrez cet exemple dans Overleaf](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Index+example+3\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%5BT1%5D%7Bfontenc%7D%0A%5Cusepackage%7Bimakeidx%7D%0A%5Cmakeindex%5Bcolumns%3D3%2C+title%3DAlphabetical+Index%2C+intoc%5D%0A%0A%5Cbegin%7Bdocument%7D%0A%5Ctableofcontents%0A%0A%5Csection%7BIntroduction%7D%0AIn+this+example%2C+several+keywords%5Cindex%7Bkeywords%7D+will+be+%0Aused+which+are+important+and+deserve+to+appear+in+the+%0AIndex%5Cindex%7BIndex%7D.%0A%0ATerms+like+generate%5Cindex%7Bgenerate%7D+and+some%5Cindex%7Bothers%7D+%0Awill+also+show+up.+Terms+in+the+index+can+also+be+%0Anested+%5Cindex%7BIndex%21nested%7D%0A%0A%5Cclearpage%0A%0A%5Csection%7BSecond+section%7D%0AThis+second+section%5Cindex%7Bsection%7D+may+include+some+special+%0Aword%2C+and+expand+the+ones+already+used%5Cindex%7Bkeywords%21used%7D.%0A%0A%5Cprintindex%0A%5Cend%7Bdocument%7D) L'image suivante montre le résultat produit par l'exemple ci-dessus : ![Index5OLV2.png](/files/9bf716824ab5b0022f9a17c8d052dca4d456c958) En ajoutant le paramètre `intoc` à la commande `\makeindex` l'inclusion du titre de l'index dans la table des matières est activée. ## Guide de référence ### Paramètres de la commande \makeindex **title** Titre à composer au début de l'index concerné. Un exemple est présenté dans la mise en forme de l'index. **intoc** Si cette option est passée, le titre de l'index est placé dans la table des matières. **columns** Utilise la syntaxe key=value, la valeur doit être un entier représentant le nombre de colonnes. La valeur par défaut est 2. **columnsep** Spécifie les unités qui représentent l'espacement entre les colonnes. La syntaxe doit être key=value, par exemple columnsep=2em. **columnseprule** Si l'option est passée, un trait vertical sera affiché entre les colonnes. ### Clés pour créer des fichiers de style Le tableau suivant montre les clés, les valeurs par défaut et les descriptions pour créer des fichiers de style .ist. | key | Description | | --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `actual ` | '@' Symbole indiquant que l'entrée suivante doit apparaître dans le fichier de sortie. | | `arg_close ` | '}' Délimiteur de fermeture pour l'argument de l'entrée d'index. | | `arg_open ` | '{' Délimiteur d'ouverture pour l'argument de l'entrée d'index. | | `encap ` | ' Symbole indiquant que le reste de la liste des arguments doit être utilisé comme commande d'encapsulation pour le numéro de page. | | `escape ` | '\\\\' Symbole qui échappe la lettre suivante, à moins que son symbole précédent ne soit lui-même un symbole d'échappement. Remarque : quote est utilisé pour échapper la lettre qui le suit immédiatement, mais s'il est précédé d'un symbole d'échappement, il est traité comme un caractère ordinaire. Ces deux symboles doivent être distincts. | | `keyword ` | "\\\indexentry" Commande qui indique à makeindex que son argument est une entrée d'index. | | `level ` | '!' Délimiteur indiquant un nouveau niveau de sous-élément. | | `quote ` | '"' Remarque : quote est utilisé pour échapper la lettre qui le suit immédiatement, mais s'il est précédé d'un symbole d'échappement, il est traité comme un caractère ordinaire. Ces deux symboles doivent être distincts. | | `range_close ` | ')' Délimiteur de fermeture indiquant la fin d'une plage de pages explicite. | | `range_open ` | '(' Délimiteur d'ouverture indiquant le début d'une plage de pages explicite. | | `preamble ` | "\begin{theindex}\n" Préambule du fichier de sortie. | | `postamble ` | "\n\n\\\end{theindex}\n" Postambule du fichier de sortie. | | `setpage_prefix ` | "\n \\\setcounter{page}{" Préfixe de la commande qui fixe le numéro de page de départ. | | `setpage_suffix ` | "}\n" Suffixe de la commande qui fixe le numéro de page de départ. | | `group_skip ` | "\n\n \\\indexspace\n" Espace vertical à insérer avant le début d'un nouveau groupe. | | `headings_flag ` | 0 Indicateur du traitement des nouveaux en-têtes de groupe, qui sont insérés avant un nouveau groupe (symboles, nombres et les 26 lettres) : des valeurs positives entraînent l'insertion d'une lettre majuscule entre le préfixe et le suffixe, et des valeurs négatives entraînent l'insertion d'une lettre minuscule (la valeur par défaut est 0, ce qui ne produit aucun en-tête). | | `heading_prefix ` | "" Préfixe d'en-tête à insérer avant qu'une nouvelle lettre ne commence. | | `symhead_positive ` | "Symbols" En-tête pour les symboles à insérer si headings\_flag est positif. | | `symhead_negative ` | "symbols" En-tête pour les symboles à insérer si headings\_flag est négatif. | | `numhead_positive ` | "Numbers" En-tête pour les nombres à insérer si headings\_flag est positif. | | `numhead_negative ` | "numbers" En-tête pour les nombres à insérer si headings\_flag est négatif. | | `item_0 ` | "\n \\\item " Commande à insérer entre deux éléments principaux (niveau 0). | | `item_1 ` | "\n \\\subitem " Commande à insérer entre deux éléments secondaires (niveau 1). | | `item_2 ` | "\n \\\subsubitem " Commande à insérer entre deux éléments de niveau 2. | | `item_01 ` | "\n \\\subitem " Commande à insérer entre un élément de niveau 0 et un élément de niveau 1. | | `item_x1 ` | "\n \\\subitem " Commande à insérer entre un élément de niveau 0 et un élément de niveau 1, où l'élément de niveau 0 n'a pas de numéros de page associés. | | `item_12 ` | "\n \\\subsubitem " Commande à insérer entre un élément de niveau 1 et un élément de niveau 2. | | `item_x2 ` | "\n \\\subsubitem " Commande à insérer entre un élément de niveau 1 et un élément de niveau 2, où l'élément de niveau 1 n'a pas de numéros de page associés. | | `delim_0 ` | ", " Délimiteur à insérer entre une clé de niveau 0 et son premier numéro de page (par défaut : virgule suivie d'un espace). | | `delim_1 ` | ", " Délimiteur à insérer entre une clé de niveau 1 et son premier numéro de page (par défaut : virgule suivie d'un espace). | | `delim_2 ` | ", " Délimiteur à insérer entre une clé de niveau 2 et son premier numéro de page (par défaut : virgule suivie d'un espace). | | `delim_n ` | ", " Délimiteur à insérer entre deux numéros de page pour la même clé à n'importe quel niveau (par défaut : virgule suivie d'un espace). | | `delim_r ` | "--" Délimiteur à insérer entre les numéros de page de début et de fin d'une plage. | | `delim_t ` | "" Délimiteur à insérer à la fin d'une liste de pages. Ce délimiteur n'affecte pas les entrées qui n'ont pas de liste de pages associée. | | `encap_prefix ` | "\\\\" Première partie du préfixe de la commande qui encapsule le numéro de page. | | `encap_infix ` | "{" Deuxième partie du préfixe de la commande qui encapsule le numéro de page. | | `encap_suffix ` | "}". Suffixe de la commande qui encapsule le numéro de page. | | `line_max ` | 72 Longueur maximale d'une ligne dans la sortie, au-delà de laquelle la ligne revient à la ligne. | | `indent_space ` | "\t\t" Espace à insérer au début d'une ligne renvoyée à la ligne (par défaut : deux tabulations). | | `indent_length ` | 16 Longueur de indent\_space (par défaut : 16, équivalent à 2 tabulations). | ## Pour aller plus loin Pour plus d'informations, voir : * [Glossaires](/latex/fr/structure-du-document/05-glossaries.md) * [Listes des tableaux et des figures](/latex/fr/figures-et-tableaux/03-lists-of-tables-and-figures.md) * [Table des matières](/latex/fr/structure-du-document/02-table-of-contents.md) * [Sections et chapitres](/latex/fr/structure-du-document/01-sections-and-chapters.md) * [Hyperliens](/latex/fr/structure-du-document/09-hyperlinks.md) * [Prise en charge des langues internationales](/latex/fr/langues/03-international-language-support.md) * [Références croisées entre sections et équations](/latex/fr/structure-du-document/03-cross-referencing-sections-equations-and-floats.md) * [Gestion dans un grand projet](/latex/fr/structure-du-document/07-management-in-a-large-project.md) * [Projets LaTeX multi-fichiers](/latex/fr/structure-du-document/08-multi-file-latex-projects.md) * [Documentation du paquet imakeidx](http://mirror.math.ku.edu/tex-archive/macros/latex/contrib/imakeidx/imakeidx.pdf) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://ayakaleaf-pro.ayaka.space/latex/fr/structure-du-document/04-indices.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.