Différences

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

--- composition:annexes:glossaire:commandes_de_base [2002/08/10 09:51] – markey
+++ 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: @@
-\question{Quelles sont les commandes de base ?} %17.1
+====== Comment obtenir un glossaire? ======
-\reponse Un glossaire, c'est \`a peu pr\`es pareil qu'un index.
+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.
-Et comme pour l'index, \LaTeX ne fournit que la moiti\'e des commandes
-n\'ecessaires \`a la cr\'eation du glossaire. Il va donc falloir faire appel
-\`a un package.
-\reponse Le package \pack{nomencl} permet de générer des glossaires de
+===== Avec l'extension “nomencl” =====
-la même façon que l'on génère des index :
-\begin{itemize}
-\item \cmd{makeglossary} dans le préambule, pour prévenir ;
-\item \cmd{nomeclature}\oarg{prefix}\marg{nom}\marg{description} pour
-ajouter une entrée ;
-\item \cmd{printindex} à l'endroit où on veut afficher le glossaire.
-\end{itemize}
-Tout comme les index, le glossaire doit être \og compilé\fg{} pour
+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 :
-que les entrées soient triées et mises en page correctement. Avec
+  * ''\makenomenclature'' dans le préambule, pour indiquer qu'un glossaire doit être constitué ;
-\texttt{makeindex} on exécutera :
+  * ''\nomenclature[préfixe]{nom}{description}'' pour ajouter une entrée ;
-\begin{noexemple}
+  * ''\printnomenclature'' à l'endroit où le glossaire doit être composé.
-\makeindex -s nomencl.ist -o fichier.gls fichier.glo
-\end{noexemple}
-\noindent où \fichier{fichier.glo} a, théoriquement, été créé par \LaTeX{} à la
-compilation. On peut également utiliser \texttt{xindy} à la place de
-\texttt{makeindex} ; voir~\ref{xindy} pour plus de renseignements.
-Voir l'exemple~\ref{exnomencl} pour ce qui est de la pratique.
+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>
-\begin{docexemple}{Exemple de nomenclature\label{exnomencl}}
+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.
+Voici un exemple de document :
+<WRAP column 45ex>
+<code latex>
 \documentclass{article}
 \usepackage[T1]{fontenc}
@@ Ligne 33: / Ligne 26: @@
 \usepackage{nomencl}
-\makeglossary
+\makenomenclature
 \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
-\printglossary
 \end{document}
-\end{docexemple}
+</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}
-\endinput
+\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)
+}}