Ceci est une ancienne révision du document !
Les « tags »
Dans la documentation, les tags (liens verts situés au-dessus du titre de la page) permettent de créer des liens entre toutes les pages. Une page sans tags est une page qui sera très peu consultée et donc inutile à moins d'avoir d'autres pages qui pointent vers elle, c'est pourquoi il est nécessaire d'ajouter le champ des tags avec les tags appropriés, bien évidemment avec une orthographe correcte (accents y compris) et au singulier.
Ces tags permettent de construire des portails associés où toutes les pages présentant un tag sont listées.
Syntaxe
Pour utiliser des tags (mots-clés) dans les pages du wiki :
{{tag>liste des tags}}
Les tags de cette liste des tags sont séparés par des espaces. Pour inclure une espace dans le nom du tag, remplacez-la par un tiret bas. Vous pouvez voir une liste des tags utilisés dans la documentation sur la page catégories.
Recommandations
- Un tag doit correspondre à une page existante (ainsi lorsqu'on clique sur le tag, on est redirigé vers cette page)
- Choisissez vos tags parmi les tags existants
- ne pas créer un nouveau tag s'il ne peut être placé sur 5 pages ou plus (voir Suppression de Tags)
{{tag>matériel système sécurité}}
- Les tags doivent être intégralement écrits en minuscule, excepté le tag « BROUILLON » afin qu'il soit visible. Les tags des versions d'Ubuntu peuvent prendre une majuscule.
- Les tags de versions (Dapper, Hardy, Karmic, Lucid, Maverick, …) correspondent aux versions pour lesquelles la page est valide; ils sont utiles pour toutes les pages de la documentation sauf les portails. On utilise uniquement l'adjectif du nom de code de la version.
- Les tags doivent suivre l'ordre suivant :
{{tag><Versions> <domaine_principal> <domaines spécifiques> <autres_tags> <tutoriel si c'est un tutoriel ou autre> BROUILLON}}
- On fait suivre la liste des tags d'un trait pour bien séparer du texte grâce à la syntaxe :
----
Ce qui donne
Tags particuliers
Pour le fonctionnement interne de la documentation certains tags peuvent être placés sur des pages spécifiques afin d'attirer l'attention.
Ces tags sont :
- BROUILLON : ce tag indique que la page doit être relue, est en cours de rédaction ou doit être améliorée
- vétuste : pour les pages n'ayant pas d'informations récentes et n'ayant pas été validées pour une version encore supportée,
- à_supprimer : pour les pages que l'ont pense supprimer mais auxquelles ont attend une éventuelle ré-écriture.
Voir le chantier des tags
Les « topics »
Pour lister les pages ayant un tag particulier utilisez cette syntaxe :
{{topic>nom_du_tag}}
Si vous venez d'ajouter un tag à une page et qu'une page listant les pages contenant ce tag via « le wikicode topic » ne contient pas votre page, cela est peut-être dû au fait que votre page ne contient pas de titre de niveau 1. Veillez à bien structurer votre page de manière sémantique (c'est-à-dire avec des titres, etc.).
D'autres syntaxes sont également possibles :
{{topic>tag1 +tag2}} (tag1 ET tag2) {{topic>tag1 -tag2}} (tag1 SAUF tag2) {{topic>tag1 tag2}} (tag1 OU tag2)
Pour plus de détails, se référer à l'aide de l'élément Topic sur DokuWiki.