Différences

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

--- wiki:tags [Le 08/06/2010, 20:28] – créée pour alléger la page syntaxe YoBoY
+++ wiki:tags [Le 24/09/2026, 12:09] (Version actuelle) – màj krodelabestiole
@@ Ligne 1: / Ligne 1: @@
-{{tag>wiki}}
+{{tag>wiki wiki:tag}}
-----
-====== Les « tags » ======
+====== Les tags ======
-Dans la documentation, les tags permettent de créer des liens entre toutes les pages, ainsi 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 évidement avec une orthographe correcte (accents y compris) et au singulier.
+<note>Cette page est une sous partie de la page [[:wiki/chantiers|des chantiers du wiki]].</note>
-Ces tags permettent de construire des portails associés où toutes les pages présentant un tag sont listées.
+Dans la [[:wiki|documentation]], les //[[wpfr>Tag_(métadonnée)|tags]]// (parfois aussi appelés étiquettes) sont les liens situés au-dessus de la page (au-dessus du titre de la page, sous la barre de menu principal). Ce sont des mots-clés qui permettent de créer des liens entre toutes les pages facilement. Comme l'explique [[#Les « topics »|cette section]], toutes les pages contenant un même //tag// peuvent être listées très facilement afin de voir quelles pages parlent de tel ou tel sujet. Les //tags// sont en quelque sorte utilisés pour catégoriser les différentes pages de la documentation.
+Pour que les //tags// fonctionnent correctement, veillez à respecter les quelques règles qui suivent.
 ===== Syntaxe =====
-Pour utiliser des //tags// (mots-clés) dans les pages du wiki :
+Pour utiliser des //tags// dans les pages de la documentation :
 <code>{{tag>liste des tags}}</code>
-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]].
+**Respectez ces règles de syntaxe :**
+  * Les tags doivent être au **singulier**.
+  * Les tags devant être **accentués** le sont. Exemples : [[:matériel]], [[:système]], [[:sécurité]], etc.
+  * S'il y a des **espaces** dans le nom d'un tag, ils sont matérialisé(s) par un **tiret bas** ''_''.
+  * Les différents tags sont simplement séparés par une espace : ne pas mettre de virgule (ou de point-virgule) !
+  * Les tags doivent être écrits **en minuscule** à l'exception des tags de travail tels que BROUILLON, VÉTUSTE, À_RECYCLER, À_SUPPRIMER, ... \\ Et les tags des versions qui prennent une majuscule au début de l'adjectif.
+  * Les tags doivent être dans l'ordre **versions** puis **catégorie principale**, **catégorie secondaire**, **compléments**, **tags de travail**.
+Exemple :
+<code>{{tag>Bionic Xenial matériel audio tutoriel BROUILLON}}</code>
 ===== Recommandations =====
-  * Les tags devant être accentués le sont. Exemples : [[:matériel]], [[:système]], [[:sécurité]], etc.
+==== Les tags de version : Bionic, Focal... ====
-<code>{{tag>matériel système sécurité}}</code>
+**Utiliser uniquement les tags de [[:lts|version LTS]]**, sauf si la page ou un de ses chapitres concerne une version intermédiaire bien spécifique.\\
+Le cycle de vie des versions intermédiaires étant trop court (9 mois) pour maintenir correctement à jour la documentation.
-  * 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.
+**À mettre obligatoirement pour :**
+  * Informer que la page est valable pour les versions indiquées.
+  * Répertorier les pages qui sont à jour.
+  * Répertorier les pages qui ne sont pas à jour ou qui contiennent des informations devenues inutiles (voir : [[:tag_ancien|les anciens tags]]).
-  * Les tags de versions (Dapper, Jaunty, Karmic, Lucid, Maverick, ...) correspondent aux versions pour lesquelles la page est valide; ils sont utiles pour toutes les pages de la documentation sauf les [[:portail|portails]]. On utilise uniquement l'adjectif du nom de code de la version.
+**Utiliser uniquement l'adjectif du nom de code de la version :**
+  * Ubuntu 20.04 : Focal
+  * Ubuntu 18.04 : Bionic
-  * Les tags doivent suivre l'ordre suivant :
+**Exception** : les pages [[:portail|portails]] n'ont pas besoin de ces tags.
-<code>{{tag><Versions> <domaine_principal> <domaines spécifiques> <autres_tags> <tutoriel si c'est un tutoriel ou autre> BROUILLON}}</code>
+:!: Si il y a des tags de  [[:old-releases|versions plus anciennes (fin de vie)]], il faut nettoyer la page des informations relatives à ces versions et supprimer ensuite les tags associés.
-  * On fait suivre la liste des tags d'un trait pour bien séparer du texte grâce à la syntaxe :
+==== Choisir les bons tags ====
-<code>----</code>
-Ce qui donne
-----
+  * Un tag doit correspondre à une **page existante**, ainsi lorsqu'on clique sur le tag, on est redirigé vers cette page.
+  * Choisissez vos tags parmi **[[:thesaurus|les tags existants]]**.
+  * **Ne pas créer un nouveau tag s'il ne peut être placé sur 5 pages ou plus** : voir la page sur la [[:wiki:tag2|suppression des tags trop peu utilisés]].
-===== Tags particuliers =====
+==== Tags particuliers ====
-Pour le fonctionnement interne de la documentation certains tags peuvent être placé sur des pages spécifiques afin d'attirer l'attention.
-Ces tags sont :
+Pour le fonctionnement interne de la documentation certains tags peuvent être placés sur des pages spécifiques afin d'attirer l'attention.
-  * Brouillon -- pour les pages en cours de rédaction,
-  * vétuste -- pour les pages n'ayant pas d'informations récente et n'ayant pas été validée pour une version encore supportée,
-  * à_supprimer -- pour les pages que l'ont pense supprimer mais auquelles ont attend une éventuelle ré-écriture.
-Voir le [[:wiki/chantiers#gestions_des_tags|chantier des tags]]
+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,
+  * [[:À_RECYCLER]] : pour les pages qui peuvent être intéressante dans leur contenus mais qui doivent être intégrée à d'autres pages,
+  * [[:À_SUPPRIMER]] : pour les pages que l'on pense supprimer mais pour lesquelles on attend une éventuelle ré-écriture.
-===== Les « topics » =====
+===== Les topics =====
 Pour lister les pages ayant un tag particulier utilisez cette syntaxe :
@@ Ligne 53: / Ligne 69: @@
 <code>{{topic>nom_du_tag}}</code>
-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 du 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.).
+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 :
+<code>
   {{topic>tag1 +tag2}}           (tag1 ET tag2)
   {{topic>tag1 -tag2}}           (tag1 SAUF tag2)
   {{topic>tag1 tag2}}            (tag1 OU tag2)
+</code>
 Pour plus de détails, se référer à l'[[doku>plugin:tag#topic|aide de l'élément Topic sur DokuWiki]].
+===== Tags à supprimer ====
+Avec le temps des tags apparaissent par erreur ou ne sont plus nécessaires.
+Il existe deux pages pour répertorier ces tags :
+  * [[:wiki:tag2|La page sur la suppression des tags trop peu utilisés]]
+  * [[:tag_ancien|La page des tags des versions d'Ubuntu qui ont cessé d'être supportées]]
+Ces tags en trop doivent être supprimés, et les pages doivent être relues et mises à jour en conséquence. Par exemple si il s'agit de tags de versions, il faut supprimer les informations relatives à ces versions. Si il s'agit de tags peu utilisés mais pointant vers des pages existantes, pensez à mettre ces liens dans le descriptifs où c'est souvent leur place.
+En cas de doutes, le [[https://forum.ubuntu-fr.org/viewforum.php?id=208/|forum]] et les [[:salons IRC]] sont là pour trouver de l'aide.
+===== Liste des tags ====
+{{count>+}}

Différences

Outils de la page

Outils du site

Divers