Principes

Les cat�gories sont un moyen de classer et de retrouver des pages ayant un point commun. Elles existent d�j� au sein de PmWiki 2 et, dans la plupart des wikis, elles ne n�cessitent pas de code ou de balises personnalis�es : Elles sont juste une convention utile dans les pages Wiki. L'id�e est que chaque page qui appartient � une cat�gorie donn�e doit avoir un lien avec une page commune contenant elle-m�me des liens vers les autres pages de la Cat�gorie. Ces pages communes sont cr�es dans le groupe Category (valeur par d�faut ind�pendante de la langue, mais modifiable au moyen de la variable $CategoryGroup).

Mise en œuvre

L'utilisation des cat�gories se d�roule en deux phases :

• Cr�er des liens vers les pages communes,
• Retrouver les pages de la cat�gorie.

Une cat�gorie XYZ est cr��e par l'existence d'un lien vers la page Category.XYZ. Le fait de mettre un tel lien dans une page est equivalent � dire que cette page appartient � la cat�gorie XYZ.

Afin de faciliter la cr�ation de ces liens, une nouvelle balise existe maintenant : La syntaxe [[!XYZ]] est (presque) �quivalente � [[Category/XYZ]]. L'utilisation de cette nouvelle balise est recommand�e, ne serait-ce que pour la clart� du texte source.

Le fait de cliquer sur ce lien va, tr�s probablement, ouvrir une page vide nomm�e Category.XYZ. Pour retrouver les pages li�es � cette page, il va nous suffire de cr�er un pied de page du groupe Category comme suit :

Cependant, pourront appara�tre dans cette liste des pages contenant des liens vers la page Category.XYZ, m�me s'il s'agit de pages que nous consid�rons ne pas faire partie de la cat�gorie XYZ. C'est pourquoi l'on aura plut�t recours � la syntaxe (:pagelist '!{$Name}' list=normal:) car, outre le fait qu'elle ne fait pas r�f�rence explicitement au groupe Category (ce qui laisse des possibilit�s d'�volution du logiciel), seules les pages utilisant la nouvelle balise seront affich�es.

Les Wikis utilisant des cat�gories � plusieurs mots auront avantage � utiliser la syntaxe (:pagelist '!{$Namespaced}' list=normal:).

Enfin, noter que la liste des pages de la cat�gorie pourra se trouver aussi bien dans Category.GroupHeader que dans Category.GroupFooter. Tout d�pend si l'on souhaite voir cette liste appara�tre avant ou apr�s le texte que l'on mettra �ventuellement sur les pages Category.XYZ.

En r�sum�

L'ajout d'un lien [[!Film]] dans une page d�finit l'appartenance de cette page � la cat�gorie Film. Sous r�serve de l'utilisation de la directive (:pagelist:), comme d�crit plus haut, il sera ais� de faire afficher la liste de toutes les pages contenant cette instruction, c'est-�-dire des pages de la cat�gorie Film.

Imbrication des cat�gories

Les cat�gories disposent d'un potentiel tr�s �lev�, car les pages du groupe Category peuvent elles-m�mes �tre plac�es dans leur(s) prope(s) cat�gorie(s).

Pour reprendre l'excellent exemple de John Rankin (non traduit), imaginons que les pages suivantes appartiennent aux cat�gories indiqu�es � droite :

 Film.SeanOfTheDead    [[!Horror]] [[!Comedy]] [[!2003]]
 Film.InMyFathersDen   [[!Drama]]              [[!2004]]
 Film.TheCorporation   [[!Documentary]]        [[!2003]]

Sous r�serve de cr�er maintenant les pages Category.Horror, Category.Comedy, Category.Drama et Category.Documentary, et d'y mettre un lien [[!Genre]], et de faire de m�me avec les pages Category.2003=) et [=Category.2004 avec [[!Year]], nous avons maintenant cr�� une structure � plusieurs niveaux.

En effet, si nous affichons la page Category.Genre, nous voyons s'afficher Horror, Comedy, Drama et Documentary. Si nous cliquons maintenant sur l'un de ces mots, nous verrons tous les films de cette "sous-cat�gorie". De la m�me fa�on, nous aurions pu cliquer sur un lien dans la page Category.Year pour voir tous les films de l'ann�e choisie.

Et si, maintenant, nous mettons un lien [[!Category]] dans chaque cat�gorie principale (Genre et Year), nous avons fabriqu� ceci :

Category.Category
    Category.Genre
        Category.Comedy
            Film.SeanOfTheDead
        Category.Drama
            Film.InMyFathersDen
        Category.Documentary
            Film.TheCorporation
        Category.Horror
            Film.SeanOfTheDead
    Category.Year
        Category.2003
            Film.SeanOfTheDead
            Film.TheCorporation
        Category.2004
            Film.InMyFathersDen

Notons cependant qu'il ne s'agit pas d'une structure hi�rarchique au sens strict, puisqu'une page peut appartenir � plusieurs cat�gories en m�me temps.

Enfin, il est tout � fait possible de mettre des informations relatives � la cat�gorie sur la page correspondante, que ce soit pour donner des indications ou pour renvoyer sur des cat�gories connexes.

Le fonctionnement de la nouvelle directive

Comme indiqu� pr�c�demment, tout ce qui est n�cessaire � l'utilisation des cat�gories est inclus dans PmWiki 2. Pour ceux que cela int�resse, voici le fonctionnement interne de la directive.

Tout d'abord, la variable $CategoryGroup d�finit le nom du groupe contenant les pages de cat�gorie (par d�faut Category).

Ensuite, la fonction Markup est utilis�e pour r�soudre les appels [[!XYZ]].

Markup('[[!','<links','/\[\[!([^\|\]] ?)\]\]/',
  "<span class='category'>[[$CategoryGroup/$1]]</span>");

Le fait d'utiliser une directive sp�ciale permet aux auteurs de pages de clairement distinguer entre une appartenance � une cat�gorie et un lien avec une page qui se trouve �tre une page de cat�gorie.

D�marrer avec une bonne structure de cat�gories

La partie la plus difficile, dans la mise en place des cat�gories, reste le choix d'un vocabulaire adapt�. Les gestionnaires du contenu d'un site peuvent s'inspirer des normes ISO 2788-1986 et ISO ISO 5964-1985.

Parmi les questions � aborder, nous trouvons :

• Un sch�ma ou une structure d�j� existants sont-ils r�utilisables ?
• Combien de niveaux de cat�gories ? Pas trop plat, ni trop profond (peut-�tre 3).
• À combien de cat�gorie une page appartient-elle ? Ni trop, ni trop peu (peut-�tre 3).
• Comment utiliser de fa�ons coh�rentes le singulier et le pluriel ? [[Mercure]] est une [[!planete]], ou [[Mercure]] appartient � la cat�gorie des [[!planetes]] ?
• Faut-il utiliser des cat�gories � plusieurs mots, comme [[!Instruments medicaux]] et [[!Instruments musicaux]], ou utiliser le module compl�mentaire Subpage Markup? avec [[!Instruments*medicaux]] et [[!Instruments*musicaux]] ?

L'on peut aussi, parfois, laisser les auteurs libres des termes qu'ils utilisent, afin de voir �merger un langage commun que l'on retiendra.

Voir aussi dans la page en anglais l'exercice SolaRoof?.

Nouvelle traduction le 12 octobre 2005 par Jean-Dom?.

Traduction de Categories - Page originale sur PmWiki:PmWikiFr.UtiliserLesCat�gories