Différences

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

Lien vers cette vue comparative

Prochaine révision
Révision précédente
wiki:tags [Le 08/06/2010, 20:28]
YoBoY créée pour alléger la page syntaxe
wiki:tags [Le 13/01/2022, 09:51] (Version actuelle)
bcag2 [Les tags de version : Bionic, Focal...] màj
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ésbien évidement avec une orthographe correcte (accents y compris) et au singulier.+**//Cette page est une sous partie de la page [[:​wiki/​chantiers|des chantiers du wiki]]//​** 
 + 
 +Dans la documentation,​ les [[wpfr>​Tag_(métadonnée)|tags]] (parfois nommés étiquettes) sont les liens situés au-dessus du trait en haut de page (au-dessus du titre de la page). Ils 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 correctementveillez à respecter les quelques règles qui suivent.
  
-Ces tags permettent de construire des portails associés où toutes les pages présentant un tag sont listées. 
  
 ===== Syntaxe ===== ===== Syntaxe =====
  
-Pour utiliser des //tags// (mots-clés) dans les pages du wiki :+Pour utiliser des //tags// (mots-clés) dans les pages de la documentation ​:
  
 <​code>​{{tag>​liste des tags}}</​code>​ <​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) car la virgule qui apparaît ​sur la page est ajoutée automatiquement ! 
 +  * 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 ===== ===== Recommandations =====
  
-  * Les tags devant être accentués le sont. Exemples ​[[:​matériel]], [[:système]], [[:​sécurité]],​ etc.+==== Les tags de version ​BionicFocal... ==== 
 +**__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.
  
-<​code>​{{tag>​matériel système sécurité}}</​code>​+**__À 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 doivent être intégralement écrits en minuscule, excepté le tag « **BROUILLON** » afin qu'il soit visibleLes tags des versions d'Ubuntu ​peuvent prendre une majuscule.+**__Utiliser uniquement l'​adjectif du nom de code de la version__ :** 
 +  ​Ubuntu 20.04 : Focal 
 +  * Ubuntu ​18.04 : Bionic
  
-  * 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. 
  
-  ​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 : 
-<​code>​----</​code>​ 
-Ce qui donne 
----- 
  
 +==== Choisir les bons tags ====
  
-===== Tags particuliers ​===== +  * Un tag doit correspondre à une **page existante**,​ ainsi lorsqu'​on clique sur le tag, on est redirigé vers cette page. 
-Pour le fonctionnement interne de la documentation certains tags peuvent être placé ​sur des pages spécifiques afin d'​attirer l'​attention.+  * 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 ==== 
 + 
 +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 : Ces tags sont :
-  * Brouillon -- pour les pages en cours de rédaction,​ +  * [[:​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écente ​et n'​ayant pas été validée ​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,​ 
-  * à_supprimer -- pour les pages que l'ont pense supprimer mais auquelles ont attend une éventuelle ré-écriture.+  * [[:​À_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.
  
-Voir le [[:​wiki/​chantiers#​gestions_des_tags|chantier des tags]] 
  
 ===== Les « topics » ===== ===== Les « topics » =====
Ligne 53: Ligne 75:
 <​code>​{{topic>​nom_du_tag}}</​code>​ <​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 : D'​autres syntaxes sont également possibles :
 +<​code>​
   {{topic>​tag1 +tag2}} ​          (tag1 ET tag2)   {{topic>​tag1 +tag2}} ​          (tag1 ET tag2)
   {{topic>​tag1 -tag2}} ​          (tag1 SAUF tag2)   {{topic>​tag1 -tag2}} ​          (tag1 SAUF tag2)
   {{topic>​tag1 tag2}} ​           (tag1 OU 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]]. 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, la [[http://​listes.ubuntu-fr.org/​info/​ubuntu_wiki-fr|liste de discussion de la documentation]] et le [[http://​webchat.freenode.net/?​channels=ubuntu-fr-doc|salon IRC #​ubuntu-fr-doc]] sont là pour trouver de l'​aide.
  
  • wiki/tags.1276021688.txt.gz
  • Dernière modification: Le 18/04/2011, 14:45
  • (modification externe)