Différences

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

--- composition:annexes:glossaire:commandes_de_base [2020/12/14 23:17] – Nettoyage de la page avant correction du texte. yannick.tanguy
+++ 3_composition:annexes:glossaire:commandes_de_base [2021/12/09 07:47] (Version actuelle) – Correction de la mise en forme. Correction de liens. yannick.tanguy
@@ Ligne 1: / Ligne 1: @@
-====== Quelles sont les commandes de base ? ======
+====== Comment obtenir un glossaire? ======
-Un glossaire, c'est à peu près la même chose qu'un index. Et comme pour l'index, <latex>\LaTeX</latex> ne fournit que la moitié des commandes nécessaires à la création du glossaire. Il va donc falloir faire appel à un package.
+Un glossaire, c'est à peu près la même chose qu'un index. Et, comme pour l'index, <latex>\LaTeX</latex> ne fournit pas par défaut les outils nécessaires pour obtenir un glossaire. Le passage par des extensions est obligatoire.
-Le package [[ctanpkg>nomencl|nomencl]] permet de générer des glossaires de la même façon que l'on génère des index :
+===== Avec l'extension “nomencl” =====
-  * ''\makeglossary'' dans le préambule, pour prévenir ;
-  * ''\nomenclature[prefix]{nom}{description}'' pour ajouter une entrée ;
+L'extension [[ctanpkg>nomencl]] permet de générer des glossaires de la même façon que l'on génère des index :
-  * ''\printglossary'' à l'endroit où on veut afficher le glossaire.
+  * ''\makenomenclature'' dans le préambule, pour indiquer qu'un glossaire doit être constitué ;
+  * ''\nomenclature[préfixe]{nom}{description}'' pour ajouter une entrée ;
+  * ''\printnomenclature'' à l'endroit où le glossaire doit être composé.
 Tout comme les index, le glossaire doit être « compilé » pour que les entrées soient triées et mises en page correctement. Avec ''makeindex'' on exécutera :
@@ Ligne 13: / Ligne 15: @@
 </code>
-où ''fichier.nlo'' a, théoriquement, été créé par <latex>\LaTeX</latex> à la compilation. On peut également utiliser ''xindy'' à la place de ''makeindex'' ; voir la question portant sur [[composition:annexes:index:xindy|xindy]] pour plus de renseignements.
+Le ''fichier.nlo'' a, théoriquement, été créé par <latex>\LaTeX</latex> à la compilation. Bien entendu, ''makeindex'' n'est pas la seule possibilité, par exemple, le programme ''[[3_composition/annexes/index/generateurs_d_index|xindy]]'' peut le remplacer.
-En voici un exemple :
+Voici un exemple de document :
+<WRAP column 45ex>
 <code latex>
 \documentclass{article}
@@ Ligne 26: / Ligne 29: @@
 \begin{document}
-\section{La F.A.Q.}
+\section{La FAQ}
-Ceci est la F.A.Q.\nomenclature{F.A.Q.}{(Foire Aux Questions) Réponses aux questions les plus
+Ceci est la FAQ\nomenclature{FAQ}{%
-fréquemment posées.} du groupe F.C.T.T.\nomenclature{F.C.T.T.}{Groupe \texttt{fr.comp.text.tex}.}
+(Foire Aux Questions) Réponses aux
-Elle contient en particulier une explication sur les glossaires.
+questions les plus fréquemment
+posées.} du groupe
+FCTT\nomenclature{FCTT}{Groupe
+\texttt{fr.comp.text.tex}.}. Elle
+contient en particulier une
+explication sur les glossaires.
 \printnomenclature
 \end{document}
 </code>
+</WRAP>
-{{htmlmetatags>metatag-keywords=(LaTeX)
+<WRAP column 45ex>
-metatag-og:title=(Quelles sont les commandes de base)
+<latexdoc>
+\documentclass{article}
+\usepackage[T1]{fontenc}
+\usepackage[utf8]{inputenc}
+\usepackage[body={8cm,8cm}]{geometry}
+\usepackage{nomencl}
+\pagestyle{empty}
+\makenomenclature
+\begin{document}
+\section{La FAQ}
+Ceci est la FAQ\nomenclature{FAQ}{(Foire Aux Questions) Réponses aux questions les plus
+fréquemment posées.} du groupe FCTT\nomenclature{FCTT}{Groupe \texttt{fr.comp.text.tex}.}.
+Elle contient en particulier une explication sur les glossaires.
+\begin{thenomenclature}
+\nomgroup{A}
+  \item [{FAQ}]\begingroup (Foire Aux Questions) Réponses aux questions les plus fréquemment posées.\nomeqref {0}\nompageref{1}
+  \item [{FCTT}]\begingroup Groupe \texttt{fr.comp.text.tex}.\nomeqref {0}\nompageref{1}
+\end{thenomenclature}
+\end{document}
+</latexdoc>
+</WRAP>
+<WRAP clear />
+===== Avec l'extension “glossaries” =====
+L'extension [[ctanpkg>glossaries|glossaries]] est probablement la plus complète sur le sujet. Elle permet d'obtenir des glossaires multiples, des listes d'acronymes, une gestion de différentes langues.
+En voici un exemple simple d'utilisation pour un glossaire en français. Cet exemple évite de passer par ''makeindex'' ou ''[[3_composition/annexes/index/generateurs_d_index|xindy]]'' mais il n'est recommandé pour des documents complexes, longs ou nécessitant des caractères hors de l'alphabet latin.
+<WRAP column 45ex>
+<code latex>
+\documentclass{article}
+\usepackage[french]{babel}
+\usepackage{glossaries}
+\newglossaryentry{ex}{%
+   name={exemple},%
+   description={illustration%
+   d'un concept}}
+\makenoidxglossaries
+\begin{document}
+Voici un bel \gls{ex}.
+\printnoidxglossaries
+\end{document}
+</code>
+</WRAP>
+<WRAP column 45ex>
+<latexdoc>
+\documentclass{article}
+\usepackage[french]{babel}
+\usepackage[body={8cm,8cm}]{geometry}
+\usepackage{glossaries}
+\newglossaryentry{ex}{name={exemple},description={illustration d'un concept}}
+\pagestyle{empty}
+\begin{document}
+Voici un bel \gls{ex}.
+\section*{Glossaire}
+\textbf{exemple} illustration d'un concept. 1
+\end{document}
+</latexdoc>
+</WRAP>
+<WRAP clear />
+{{htmlmetatags>metatag-keywords=(LaTeX,annexes,glossaires,nomencl,glossaries)
+metatag-og:title=(Comment obtenir un glossaire)
 metatag-og:site_name=(FAQ LaTeX francophone)
 }}