Différences

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

--- composition:annexes:glossaire:commandes_de_base [2016/10/16 07:40] – 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: @@
-\question{Quelles sont les commandes de base ?} %17.1
+====== Comment obtenir un glossaire? ======
-\reponse Un glossaire, c'est \`a peu pr\`es la même chose 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{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 \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é ;
-\prog{makeindex} on exécutera :
+  * ''\nomenclature[préfixe]{nom}{description}'' pour ajouter une entrée ;
-\cmdline{makeindex -s nomencl.ist -o fichier.nls fichier.nlo}
+  * ''\printnomenclature'' à l'endroit où le glossaire doit être composé.
-\noindent où \fichier{fichier.nlo} a, théoriquement, été créé par \LaTeX{} à
-la compilation. On peut également utiliser \prog{xindy} à la place de
-\prog{makeindex} ; voir la question~\vref{qu=xindy} pour plus de
-renseignements.
-Voir l'exemple~\vref{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 35: / 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}
+\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}
-\end{docexemple}
+</latexdoc>
+</WRAP>
+<WRAP clear />
-\endinput
+{{htmlmetatags>metatag-keywords=(LaTeX,annexes,glossaires,nomencl,glossaries)
+metatag-og:title=(Comment obtenir un glossaire)
+metatag-og:site_name=(FAQ LaTeX francophone)
+}}