Différences

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

Lien vers cette vue comparative

Les deux révisions précédentes Révision précédente
Prochaine révision
Révision précédente
wiki:tags [Le 25/04/2012, 08:55]
YoBoY refonte de la page
wiki:tags [Le 13/01/2022, 09:51] (Version actuelle)
bcag2 [Les tags de version : Bionic, Focal...] màj
Ligne 6: Ligne 6:
 **//Cette page est une sous partie de la page [[:​wiki/​chantiers|des chantiers du wiki]]//** **//Cette page est une sous partie de la page [[:​wiki/​chantiers|des chantiers du wiki]]//**
  
-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 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.+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 correctement,​ veillez à respecter les quelques règles qui suivent. Pour que les tags fonctionnent correctement,​ veillez à respecter les quelques règles qui suivent.
Ligne 17: Ligne 17:
 <​code>​{{tag>​liste des tags}}</​code>​ <​code>​{{tag>​liste des tags}}</​code>​
  
-__**Respectez ​ces règles de syntaxe ​:**__+**__Respectez ​ces règles de syntaxe__ ​:** 
   * Les tags doivent être au **singulier**.   * Les tags doivent être au **singulier**.
   * Les tags devant être **accentués** le sont. Exemples : [[:​matériel]],​ [[:​système]],​ [[:​sécurité]],​ etc.   * Les tags devant être **accentués** le sont. Exemples : [[:​matériel]],​ [[:​système]],​ [[:​sécurité]],​ etc.
-  * S'il y a des **espaces**,​ ils sont matérialisés ​par un **tiret bas** « _ ». +  * S'il y a des **espaces** ​dans le nom d'un tag, ils sont matérialisé(s) ​par un **tiret bas** « **_** ». 
-  * Les tags doivent être écrits en minuscule à l'​exception des tags de travail tels que BROUILLON, À_SUPPRIMER, VÉTUSTE, ... +  * 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 dans l'​ordre **versions** puis **catégorie principale** **catégorie secondaire** **compléments** **tags de travail**+  * 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 : Exemple :
-<​code>​{{tag>​oneiric precise ​matériel audio tutoriel BROUILLON</​code>​+<​code>​{{tag>​Bionic Xenial ​matériel audio tutoriel BROUILLON}}</​code>​
  
  
 ===== Recommandations ===== ===== Recommandations =====
  
-==== Les tags des versions ​hardy lucid natty oneiric precise ​==== +==== Les tags de version ​Bionic, Focal... ​==== 
-__**À mettre obligatoirement pour :**__ +**__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.\\ 
-  * informer que la page est valable pour les versions indiquées +Le cycle de vie des versions intermédiaires étant trop court (9 moispour maintenir correctement à jour la documentation.
-  * 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]])+
  
-__**Utiliser uniquement l'​adjectif du nom de code de la version.**__ +**__À mettre obligatoirement pour__ :** 
-  * ubuntu 12.10 : quantal +  * Informer que la page est valable pour les versions indiquées
-  * ubuntu 12.04 : precise +  * Répertorier les pages qui sont à jour
-  * ubuntu 11.10 oneiric +  * Répertorier les pages qui ne sont pas à jour ou qui contiennent des informations devenues inutiles (voir [[:tag_ancien|les anciens tags]]).
-  * ubuntu 11.04 natty +
-  * ubuntu 10.04 : lucid +
-  * ubuntu 8.04 : hardy+
  
-**Exception** : les pages [[:​portail|portails]] n'ont pas besoin de ces tags+**__Utiliser uniquement l'​adjectif du nom de code de la version__ :** 
 +  * Ubuntu 20.04 : Focal 
 +  * Ubuntu 18.04 : Bionic 
 + 
 + 
 +**Exception** : les pages [[:​portail|portails]] n'ont pas besoin de ces tags
 + 
 +:!: 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.
  
-:!: Si il y a des tags de versions plus anciennes, il faut nettoyer la page des informations relatives à ces versions et supprimer ensuite les tags associés. 
  
 ==== Choisir les bons tags ==== ==== Choisir les bons tags ====
-  ​* 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]]** +  ​* Un tag doit correspondre à une **page existante**,​ ainsi lorsqu'​on clique sur le tag, on est redirigé vers cette page. 
-  * Ne pas créer un nouveau tag s'il ne peut être placé sur 5 pages ou plus : voir [[:​wiki:​tag2|Suppression de Tags]]+  * 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. 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]] : 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 » =====
Ligne 77: Ligne 84:
 </​code>​ </​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 ==== ===== Tags à supprimer ====
 +
 Avec le temps des tags apparaissent par erreur ou ne sont plus nécessaires. Avec le temps des tags apparaissent par erreur ou ne sont plus nécessaires.
  
 Il existe deux pages pour répertorier ces tags : Il existe deux pages pour répertorier ces tags :
   * [[:​wiki:​tag2|La page sur la suppression des tags trop peu utilisés]]   * [[:​wiki:​tag2|La page sur la suppression des tags trop peu utilisés]]
-  * [[:​tag_ancien|La page des tags de version ​d'ubuntu ​qui ont cessé d'​être supportées]]+  * [[:​tag_ancien|La page des tags des versions ​d'Ubuntu ​qui ont cessé d'​être supportées]]
  
-Ces tags en trop doivent être supprimé, et les pages doivent être relus 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.+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. 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.1335336958.txt.gz
  • Dernière modification: Le 25/04/2012, 08:55
  • par YoBoY