Haut
de
page
Table
des
matières
Article
précédant
Article
suivant

Les descriptions

Fleuron

Ce type de liste permet d'associer un mot à sa définition ou description un peu comme dans un dictionnaire.

Fleuron

1 - Définir une description

Comme la majorité des listes que nous allons étudier, la première chose à faire est de définir l'élément, puis de lui ajouter des options pour obtenir le résultat voulu. La définition d'une description ce fait avec la commande \definedescription. Pour notre exemple nous allons définir une liste de description que nous appelons dico (tu peux choisir n'importe quel nom).

\definedescription[dico]

Voici un petit exemple qui montre comment utiliser notre description dico et le résultat obtenu après compilation.

\definedescription[dico]
\starttext
\dico{Néandertalien}
est un représentant fossile du genre Homo qui a vécu en Europe et en Asie occidentale au Paléolithique moyen, entre environ 250 000 et 28 000 ans avant le présent.\par
\dico{Levalloisien}
terme qualifiant une technique de la taille de la pierre utilisée par les Néandertaliens.\par
\stoptext

Attention, n'oublie pas le \par à la fin de chaque définition sous peine d'erreur de compilation.

Le résultat de la compilation :


Si dans ta définition tu utilises des paragraphes, il vaut mieux utiliser les commandes suivantes :

\definedescription[dico] \starttext \startdico{Néandertalien}
est un représentant fossile du genre Homo qui a vécu en Europe et en Asie occidentale au Paléolithique moyen, entre environ 250 000 et 28 000 ans avant le présent.

Il utilise une technique de la taille de la pierre appelée méthode Levallois.
\stopdico
\stoptext

Maintenant nous allons améliorer l'aspect visuel de notre description à l'aide d'options

2 - headstyle

Cette option permet de modifier l'aspect de notre entête. Elle peut prendre les valeurs suivantes :

Tu as deux façons d'indiquer une option, soit à la suite de \definedescription par exemple pour mettre l'entête en capitale :

\definedescription[dico][headstyle=cap]

soit en utilisant la commande \setupdescriptions[nom-description][option1=x,option2=y,. . .]

\setupdescriptions[dico][headstyle=cap]

Attention, n'oublie pas le s à la fin de \setupdescriptions.

Dans les deux cas, tu peux mettre plusieurs options, il faut juste les séparer par une virgule. Si tu as défini plusieurs listes de description auxquelles tu veux appliquer les mêmes options tu procèdes comme suit :

\setupdescriptions[dico,glossaire][headstyle=cap]

Tu peux en ajouter autant que tu veux il suffit de les séparer par des virgules. Tu peux également avoir un tronc commun et des variantes pour chaque description par exemple toutes en capitale, mais les dico en rouge et les glossaire en vert :

\definedescription[dico,glossaire][headstyle=cap]
\setupdescriptions[glossaire][color=green]
\setupdescriptions[dico][color=red]

Cet exemple te montre l'utilité des deux méthodes.

Revenons à nos options pour headstyle. Voici le résultat de la commande suivante :

\definedescription[dico][headstyle=cap]


Maintenant si tu veux mettre l'entête en rouge, il faut utiliser une commande comme ceci :

\definedescription[dico][headstyle=\red]


Tu peux mettre plusieurs commandes comme par exemple en rouge et en petites capitales :

\definedescription[dico][headstyle=\sc\red]


3 - style

Identique à headstyle, mais affecte le texte de la définition. Possède exactement les mêmes options.

\setupdescriptions[dico][style=slanted]


4 - color

Permet de modifier la couleur du texte de la définition, n'affecte pas l'entête.

Pour avoir le texte en rouge :

\setupdescriptions[dico][color=red]


5 - width

Contrôle la largeur de l'entête. Par défaut cette largeur est d'environ 3 cm ou 7 em.

\definedescription[dico]
\starttext
\dico{Eu}Ville normande.\par
\dico{Anticonstitutionnellement}Le plus long mot de la langue française.\par
\stoptext


Ça coince un peu. width est la pour t'aider. Il peut prendre 3 valeurs :

fit la largeur de l'entête s'adapte au mot.

\definedescription[dico][width=fit]
\starttext
\dico{Eu}Ville normande.\par
\dico{Anticonstitutionnellement}Le plus long mot de la langue française.\par
\stoptext


broad identique à fit mais l'espace entre le mot et le texte de la définition est définit par distance.

\definedescription[dico][width=broad]
\starttext
\dico{Eu}Ville normande.\par
\dico{Anticonstitutionnellement}Le plus long mot de la langue française.\par
\stoptext


Enfin tu peux attribuer une dimension, toutes les unité reconnues par ConTeXt sont acceptées.

\definedescription[dico][width=6cm]
\starttext
\dico{Eu}Ville normande.\par
\dico{Anticonstitutionnellement}Le plus long mot de la langue française.\par
\stoptext


6 - distance

Gère l'espace entre le mot et la définition il ne peut prendre en valeur qu'une dimension :

\definedescription[dico][distance=4cm]
\starttext
\dico{Néandertalien}
est un représentant fossile du genre Homo qui a vécu en Europe et en Asie occidentale au Paléolithique moyen, entre environ 250 000 et 28 000 ans avant le présent.\par
\dico{Levalloisien}
terme qualifiant une technique de la taille de la pierre utilisée par les Néandertaliens.\par
\stoptext


7 - text

Permet d'ajouter un texte avant l'entête :

\definedescription[dico][text={Préhistoire : },width=fit] \starttext
\dico{Néandertalien}
est un représentant fossile du genre Homo qui a vécu en Europe et en Asie occidentale au Paléolithique moyen, entre environ 250 000 et 28 000 ans avant le présent.\par
\dico{Levalloisien}
terme qualifiant une technique de la taille de la pierre utilisée par les Néandertaliens.\par
\stoptext


8 - align

Gère la position de l'ensemble de la description (mot plus définition) sur la page prend 3 valeurs left, middle et right:

\definedescription[dico][align=middle]
\starttext
\dico{Néandertalien}
est un représentant fossile du genre Homo qui a vécu en Europe et en Asie occidentale au Paléolithique moyen,entre environ 250 000 et 28 000 ans avant le présent.\par
\dico{Levalloisien}
terme qualifiant une technique de la taille de la pierre utilisée par les Néandertaliens.\par
\stoptext


9 - margin

Règle la distance entre la marge et la description. Par défaut il n'y a pas de retrait :

\definedescription[dico]
\starttext
\input knuth
\dico{Néandertalien}
est un représentant fossile du genre Homo qui a vécu en Europe et en Asie occidentale au Paléolithique moyen, entre environ 250 000 et 28 000 ans avant le présent.\par
\dico{Levalloisien}
terme qualifiant une technique de la taille de la pierre utilisée par les Néandertaliens.\par
\stoptext


Les valeurs possible sont standard, yes, no et une dimension. Avec standard et yes on a un retrait :

\definedescription[dico][margin=yes]
\starttext
\input knuth
\dico{Néandertalien}
est un représentant fossile du genre Homo qui a vécu en Europe et en Asie occidentale au Paléolithique moyen, entre environ 250 000 et 28 000 ans avant le présent.\par
\dico{Levalloisien}
terme qualifiant une technique de la taille de la pierre utilisée par les Néandertaliens.\par
\stoptext


Avec no pas de retrait et avec dimension on peut préciser la taille du retrait :

\definedescription[dico][margin=2cm]
\starttext
\input knuth
\dico{Néandertalien}
est un représentant fossile du genre Homo qui a vécu en Europe et en Asie occidentale au Paléolithique moyen, entre environ 250 000 et 28 000 ans avant le présent.\par
\dico{Levalloisien}
terme qualifiant une technique de la taille de la pierre utilisée par les Néandertaliens.\par
\stoptext


10 - alternative

Attention l'ancienne option location ne marche plus avec les versions récentes de MKIV, elle est remplacée par alternative

Permet de préciser la position de l'entête par rapport à la définition. Par défaut sa valeur est left. Avec rigth on obtient :

\definedescription[dico][alternative=right]
\starttext
\dico{Néandertalien}
est un représentant fossile du genre Homo qui a vécu en Europe et en Asie occidentale au Paléolithique moyen, entre environ 250 000 et 28 000 ans avant le présent.\par
\dico{Levalloisien}
terme qualifiant une technique de la taille de la pierre utilisée par les Néandertaliens.\par
\stoptext


Les autres valeurs possibles sont : top, serried, inmargin, inleft, inright et hanging''.

top place l'entête au-dessus de la définition :


serried supprime le retrait du texte de la définition :


inmargin met l'entête dans la marge :


Attention il faut prévoir des marges suffisamment grande pour contenir l'entête ou re-dimensionner ce dernier :

\definedescription[dico][location=inmargin,width=0.6\leftmarginwidth]


inleft et inright même effet que inmargin mais uniquement et respectivement dans les marges de gauches et de droites.

hanging provoque un retrait de la définition :


11 - hang

Provoque un retrait des premières lignes de la définition. Peut prendre 3 valeurs, fit, broad et un nombre.

fit n'autorise que le retrait de la première ligne.

\definedescription[dico][hang=fit]
\starttext
\dico{Knuth}\input knuth\par
\stoptext


broad permet le retrait des deux premières lignes :

\definedescription[dico][hang=broad]
\starttext
\dico{Knuth}\input knuth\par
\stoptext


Si tu indiques un nombre, le retrait affecte le nombre de ligne équivalent.

\definedescription[dico][hang=5]
\starttext
\dico{Knuth}\input knuth\par
\stoptext


Comme tu peux le voir sur l'exemple précédent ne nombre de ligne affectées ne peut dépasser une fin de paragraphe.

L'exemple suivant sans paragraphe donne le bon résultat :

\definedescription[dico][hang=5]
\starttext
\dico{Knuth} Thus, I came to the conclusion that the designer of a new system must not only be the implementer and first large--scale user; the designer should also write the first user manual. The separation of any of these four components would have hurt \TeX\ significantly. If I had not participated fully in all these activities, literally hundreds of improvements would never have been made, because I would never have thought of them or perceived why they were important. But a system cannot be successful if it is too strongly influenced by a single person. Once the initial design is complete and fairly robust, the real test begins as people with many different viewpoints undertake their own experiments.\par
\stoptext


12 - before, inbetween et after

Ces trois options permettent d'ajouter des commandes dont l'action interviendra respectivement avant entre et après une description.

inbetween ne marche que si location=top

Par exemple si tu veux obtenir une présentation sophistiqué, comme ajouter un trait entre le mot et la définition.

\definedescription[dico][location=top,inbetween={\vrule width 0.5\textwidth height1pt\blank}]
\starttext
\dico{Néandertalien}
est un représentant fossile du genre Homo qui a vécu en Europe et en Asie occidentale au Paléolithique moyen, entre environ 250 000 et 28 000 ans avant le présent.\par
\dico{Levalloisien}
terme qualifiant une technique de la taille de la pierre utilisée par les Néandertaliens.\par
\stoptext


Si tu veux augmenter l'espace entre les définitions :

\definedescription[dico][before={\blank[3*big]},after={\blank[5*big]}]
\starttext
Un texte d'introduction.
\dico{Néandertalien}
est un représentant fossile du genre Homo qui a vécu en Europe et en Asie occidentale au Paléolithique moyen, entre environ 250 000 et 28 000 ans avant le présent.\par
\dico{Levalloisien}
terme qualifiant une technique de la taille de la pierre utilisée par les Néandertaliens.\par
La suite du texte.
\stoptext


Attention n'oublie pas les { } dans before et after sous peine d'erreur de compilation.

13 - closesymbol

Permet de mettre à la fin de la définition un élément de texte comme par exemple un symbol :

\definedescription[dico][closesymbol=\mathematics{\square}] \starttext
\dico{Néandertalien}
est un représentant fossile du genre Homo qui a vécu en Europe et en Asie occidentale au Paléolithique moyen, entre environ 250 000 et 28 000 ans avant le présent.\par
\dico{Levalloisien}
terme qualifiant une technique de la taille de la pierre utilisée par les Néandertaliens.\par
\stoptext


Tu peux ajouter une image, par exemple le logo debian, pour ce faire voici comment procéder, il faut d'abord créer une commande qui affiche notre dessin :

\def\logo{\externalfigure[debian.png][width=0.5cm]}
\definedescription[dico][closesymbol=\logo]
\starttext
\dico{Néandertalien}
est un représentant fossile du genre Homo qui a vécu en Europe et en Asie occidentale au Paléolithique moyen, entre environ 250 000 et 28 000 ans avant le présent.\par
\dico{Levalloisien}
terme qualifiant une technique de la taille de la pierre utilisée par les Néandertaliens.\par
\stoptext

Fleuron

Table des Matières concise

Fleuron

Table des Matières complète

Fleuron

Si tu veux aller directement à l'article suivant ou précédant regarde bien dans les marges j'ai mis des liens pour cela. Il est pas balèze le Bébert ?