Discussion :

[Benoists]

Bonjour à tous,

Je viens soumettre quelques propositions pour compléter la FAQ concernant la création d'un glossaire.

Comment créer un glossaire avec le package "Glossaries" ?

Tout d'abord il faut inclure le package et dire à LaTeX qu'on va générer un glossaire :

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
\usepackage{glossaries}
\makeglossaries

Ensuite, il faut définir les termes du glossaire. La commande \newglossaryentry est faite pour ça.

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
4
5
6
7
\newglossaryentry{<mot à utiliser pour appeler le terme du glossaire>}
{%
	name={<terme>}, % le terme à référencer (l'entrée qui apparaitra dans le glossaire)
	description={<description>}, % la description du terme (sans retour à la ligne)
	sort={<terme>}, % si le mot contient des caractère spéciaux, ils ne seront pas pris en compte
	plural={<termes>} % la forme plurielle du terme
}

Pour appeler le terme du glossaire, "Glossaries" met 4 commandes à disposition:

• \gls: singlulier sans majuscule;
• \Gls: singlulier avec majuscule;
• \glspl: pluriel sans majuscule;
• \Glspl: pluriel avec majuscule.

L'affichage du glossaire se fait grâce à la commande \pringlossaries.

En ce qui concerne la compilation il faut faire une passe avec LaTeX puis pour le glossaire, il y a deux options:

• la commande "makeglossaries" qui se charge de tout;
• la commande "makeindex" : "makeindex fichier.glo -t fichier.glg -s fichier.ist -o fichier.gls".

Enfin une dernière passe avec LaTeX pour assembler le tout.

Comment créer une liste des abréviations avec le package "Glossaries" ?

Tout d'abord il faut charger le package "glossaries" avec l'option "acronym" :

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
\usepackage[acronym]{glossaries}
\makeglossaries

La définition d'une abréviation se fait grâce à la commande \newacronym :

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

\newacronym[longplural={<version longue au pluriel>}]{<mot pour appeler l'abréviation>}{<abréviation>}{<version longue>}

L'appel de l'abréviation se fait de la même manière que pour un terme du glossaire (voir "créer un glossaire").

Pour afficher la liste des abréviation, deux options sont à notre disposition :

• mélanger le glossaire et la liste des abréviations : \printglossaries;
• séparer la liste des abréviation du glossaire : \printglossary[type=\acronymtype] pour la liste des abréviations et \printglossary pour le glossaire.

Enfin, la compilation se fait en 3 étapes :

1. LaTeX;
2. makeglossaries (plus simple, pour gérer tous les fichiers);
3. LaTeX.

Comment créer plusieurs glossaires avec le package "Glossaries" ?

Tout d'abord il faut charger le package "glossaries" :

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

\usepackage{glossaries}

Ensuite il faut définir les nouveaux glossaires :

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

\newglossary[<ext fichier log>]{<nom du glossaire>}{<ext fichier entrée>}{<ext fichier sortie>}{<titre du glossaire>}

Puis il faut indiquer à LaTeX qu'on souhaite utiliser le glossaire :

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

\makeglossaries

Pour ajouter un terme à notre nouveau glossaire, il faut utiliser l'option "type" de la commande \newglossaryentry :

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
4
5
\newglossaryentry{<label>}
{%
	type=<nom du glossaire>,
	% autres options classiques...
}

L'affichage des différents glossaires se fait de la même manière que pour la liste des abréviations, avec la commande \pringlossary[type=<nom du glossaire>]Enfin, la compilation se fait de la même manière que pour la liste des abréviations.

J'ai essayé d'être le plus clair possible, tout en restant assez simple dans les explications. J'attends vos retours

Benoist.

[-Nikopol-]

Tout d'abord, beau boulot, c'est dans l'ensemble assez clair.

1. Pour la première Q/R : j'aime mieux utiliser exttension que package dans le texte (mais ca n'engage que moi)
   Peut être faire un glossaire prenant en compte les \gls\Gls\glsp\GlsplOn met le code qui permet de faire le glossaire et ensuite l'image.
2. Pour la deuxième : pour la compilation c'est pas forcement clair makeglossarie. Idem un petit code à ajouter avant l'image
3. pour la troisième : \newglossary[<ext fichier log>]{<nom du glossaire>}{<ext fichier entrée>}{<ext fichier sortie>}{<titre du glossaire>}, mériterait d’être expliqué je pense. Ajouter le code qui généré l'image.

Je trouve important d'avoir des exemples simples à appliquer avant de pouvoir personnaliser par la suite. C'est souvent ce que je reproche aux documentation des extensions, souvent très peu d'exemples et souvent très TeXnique.

[Winnt]

Salut,

Superbe travail
Rien à redire en dehors des observations déjà faites par -Nikopol-.
Personnellement depuis que j'ai découverts que le pluriel et les majuscules pouvait être géré avec glossaries et \gls, \glsp, Gls... j'en abuse un peu

[Benoists]

Merci pour vos remarques

C'est vrai que extension fait plus français, à vrai dire j'ai utilisé package parce que c'est le terme qu'on utilise pour charger une extension. Je vais tâcher de franciser tout ça.

J'ai hésité à détailler comme tu le décris, seulement le support Q/R implique une question précise et la réponse qui va avec. Si je détaille tout, c'est plutôt un tuto qu'il faut. Par contre, tes propositions m'ont donné une idée, je vais découper tout ça en parties plus ciblées et donc plus détaillées. Je pense faire quelque chose comme ça:

1. qu'est-ce qu'un glossaire ?
2. comment faire un glossaire avec LaTeX ? (présentation de l'extension);
3. comment faire une liste des abréviations ?
4. l'adaptation des termes au contexte (pluriel, singulier, majuscule, minuscule);
5. le processus de compilation (là je détaille les deux démarches, avec makeindex et makeglossaries);
6. comment réaliser plusieurs glossaires dans un même document ?

ça divise beaucoup, mais ça m'évitera de me répéter comme c'est le cas actuellement ou je répète sans cesse comment compiler le fichier ou par exemple ça évitera de dire à chaque fois qu'il faut insérer le package. Les Q/R suivantes traiterons d'un point précis, et modifierons les Q/R précédentes si besoin. L'idée est d'aller du basique vers du plus avancé.

Est-ce que cette organisation vous semble correcte ? L'interdépendance des Q/R est-elle problématique ?

Bonne soirée,
Benoist.

[Winnt]

Bonsoir,

Est-ce que cette organisation vous semble correcte ? L'interdépendance des Q/R est-elle problématique ?

C'est tout à fait correct bien au contraire. Les sujets liés ont toujours un minimum d'interdépendance.

Très bon boulot. Tu as presque un plan pour un tuto complet

[-Nikopol-]

Pour une faq il faut se répéter, lorsque je cherche une réponse, j'ai pas envie de devoir lire toutes les autres Q/R : il faut une réponse complète sans devoir aller chercher ailleurs

Winnt a raison :
Tu as un plan pour un tutoriel que l'on ajoutera dans les pages cours juste a coté des index.
Donc ce que tu peux faire est de finaliser les Q/R, je les posterai rapidement et ensuite remettre le tout en ordre pour avoir un bel article.