Différences

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

--- wiki:tags [Le 11/02/2011, 11:21] – maj : ajout section problèmes thibault.lemaitre
+++ wiki:tags [Le 24/09/2026, 12:09] (Version actuelle) – màj krodelabestiole
@@ Ligne 1: / Ligne 1: @@
 {{tag>wiki wiki:tag}}
-----
-====== Les « tags » ======
+====== Les tags ======
-<note tip>Cette page est une sous partie de la page [[:wiki/chantiers|des chantiers du wiki]]</note>
+<note>Cette page est une sous partie de la page [[:wiki/chantiers|des chantiers du wiki]].</note>
-Dans la documentation, les tags (liens normalement situés au-dessus du trait en haut de page (lui même situé au-dessus du titre de la page)) 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 quelle pages parlent de tel ou tel sujet. Les tags sont en quelque sorte utilisés pour catégoriser une page.
+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.
+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 =====
-  * Un tag doit correspondre à une **page existante**, ainsi lorsqu'on clique sur le tag, on est redirigé vers cette page
+==== Les tags de version : Bionic, Focal... ====
-  * 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 [[:wiki:tag2|Suppression de Tags]]
-  * S'il y a des **espaces**, ils sont matérialisés par un **tiret bas** « _ ».
-  * Les tags doivent être au **singulier**.
-  * Les tags devant être **accentués** le sont. Exemples : [[:matériel]], [[:système]], [[:sécurité]], etc.
-<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**. Quelques **exceptions** : le tag **BROUILLON** doit être écrit en **majuscules** 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 des versions d'Ubuntu (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 [[:portail|portails]]. On utilise uniquement l'adjectif du nom de code de la version. [[:tag_ancien|Plus d'informations à ce sujet]].
+**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 d'Ubuntu> <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é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
+  * [[: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,
+  * [[: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,
-  * [[:a_recycler]] : pour les pages qui peuvent être intéressante dans leur contenus mais qui doivent être intégrée à d'autres pages,
+  * [[:À_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'ont pense supprimer mais auxquelles ont attend une éventuelle ré-écriture.
+  * [[:À_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 63: / Ligne 72: @@
 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]].
-===== Les « nuages de tags » =====
+===== Tags à supprimer ====
-Pour afficher les tags utilisés sur la documentation, utilisez cette syntaxe :
-<code>~~TAGCLOUD:number~~</code>
-Remplacer //number// par le nombre de tag que vous voulez afficher (compris entre 1 et 999). Si vous ne préciser pas //number// (ou que vous le laisser), 50 tags sont affichés.
-La page [[:catégories]] utilise cette syntaxe.
-===== Problèmes connus =====
-Les balises topics, précédemment présentées ne fonctionnent pas toujours correctement, sans que la cause soit bien déterminée. Ce problème fait l'objet du rapport de bogue [[https://bugs.launchpad.net/ubuntu-fr-doc/+bug/400175|suivant]].
+Avec le temps des tags apparaissent par erreur ou ne sont plus nécessaires.
-Ce problème a également lieu quand on recherche toutes les pages contenant un certain tag, comme c'est le cas dans beaucoup de liens de [[:wiki:tag2|la page sur la suppression des tags trop peu utilisés]].
+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]]
-Pour savoir si ce bogue a lieu en ce moment, le lien  [[:?do=showtag&tag=maverick|suivant]] devrait vous donner bien plus que 5 résultats (tag maverick).
+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.
-===== Voir aussi =====
+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.
-  * Le système de tag est un plugin de Dokuwiki : plus d'infos sur ce plugin [[doku>plugin:tag|ici]]
+===== Liste des tags ====
-  * Le nuage de tag est un plugin distinct du pugin tag : plus d'infos sur ce plugin [[doku>plugin:cloud|ici]]
+{{count>+}}

Différences

Outils de la page

Outils du site

Divers