Différences

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

--- composition:annexes:glossaire:commandes_de_base [2018/12/09 09:21] – jejust
+++ 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 pas par défaut les outils nécessaires pour obtenir un glossaire. Le passage par des extensions est obligatoire.
-$\Reponse$  Un glossaire, c'est à peu près la même chose qu'un index.
+===== Avec l'extension “nomencl” =====
-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.
+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 :
+  * ''\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é.
-$\Reponse$  Le package [[ctanpkg>nomencl|nomencl]] permet de générer des glossaires de
+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 :
-la même façon que l'on génère des index :
-\begin{descrcmd}
-\item[makeglossary] dans le préambule, pour prévenir ;
-\item[nomenclature\oarg{prefix}\marg{nom}\marg{description}] pour
-ajouter une entrée ;
-\item[printglossary] à l'endroit où on veut afficher le glossaire.
-\end{descrcmd}
-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 :
 <code bash>
 makeindex -s nomencl.ist -o fichier.nls fichier.nlo
 </code>
-\noindent où ''fichier.nlo'' a, théoriquement, été créé par <latex>\LaTeX</latex> à
+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.
-la compilation. On peut également utiliser ''xindy'' à la place de
-''makeindex'' ; voir la question~\vref{qu=xindy} pour plus de
-renseignements.
-Voir l'exemple~\vref{exnomencl} pour ce qui est de la pratique.
+Voici un exemple de document :
-Exemple de nomenclature\label{exnomencl}
+<WRAP column 45ex>
 <code latex>
 \documentclass{article}
@@ Ligne 43: / Ligne 29: @@
 \begin{document}
-\section{La F.A.Q.}
+\section{La FAQ}
-Ceci est la F.A.Q.\nomenclature{F.A.Q.}{(Foire
+Ceci est la FAQ\nomenclature{FAQ}{%
-Aux Questions) Réponses aux questions les plus
+(Foire Aux Questions) Réponses aux
-fréquemment posées.} du groupe
+questions les plus fréquemment
-F.C.T.T.\nomenclature{F.C.T.T.}{Groupe
+posées.} du groupe
-\texttt{fr.comp.text.tex}.} Elle contient
+FCTT\nomenclature{FCTT}{Groupe
-en particulier une explication sur les
+\texttt{fr.comp.text.tex}.}. Elle
-glossaires.
+contient en particulier une
+explication sur les glossaires.
 \printnomenclature
 \end{document}
 </code>
+</WRAP>
+<WRAP column 45ex>
+<latexdoc>
+\documentclass{article}
+\usepackage[T1]{fontenc}
+\usepackage[utf8]{inputenc}
+\usepackage[body={8cm,8cm}]{geometry}
+\usepackage{nomencl}
+\pagestyle{empty}
+\makenomenclature
+\begin{document}
-{{htmlmetatags>metatag-keywords=(LaTeX)
+\section{La FAQ}
-metatag-og:title=(Quelles sont les commandes de base?)
+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)
 }}