Différences
Ci-dessous, les différences entre deux révisions de la page.
Les deux révisions précédentesRévision précédenteProchaine révision | Révision précédente | ||
wiki:tags [Le 11/02/2016, 13:20] – [Les tags de version : Lucid Precise Quantal Raring] Précisions concernant uniquement les versions LTS cafecho | wiki:tags [Le 03/06/2018, 20:21] (Version actuelle) – L'Africain | ||
---|---|---|---|
Ligne 1: | Ligne 1: | ||
+ | {{tag> | ||
+ | ---- | ||
+ | |||
+ | ====== Les « tags » ====== | ||
+ | |||
+ | **//Cette page est une sous partie de la page [[: | ||
+ | |||
+ | Dans la documentation, | ||
+ | |||
+ | Pour que les tags fonctionnent correctement, | ||
+ | |||
+ | |||
+ | ===== Syntaxe ===== | ||
+ | |||
+ | Pour utiliser des //tags// (mots-clés) dans les pages de la documentation : | ||
+ | |||
+ | < | ||
+ | |||
+ | **__Respectez ces règles de syntaxe__ :** | ||
+ | |||
+ | * Les tags doivent être au **singulier**. | ||
+ | * Les tags devant être **accentués** le sont. Exemples : [[: | ||
+ | * 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' | ||
+ | * Les tags doivent être dans l' | ||
+ | |||
+ | Exemple : | ||
+ | < | ||
+ | |||
+ | |||
+ | ===== Recommandations ===== | ||
+ | |||
+ | ==== Les tags de version : Bionic, Xenial... ==== | ||
+ | **__Utiliser uniquement les tags de [[: | ||
+ | Le cycle de vie des versions intermédiaires étant trop court (9 mois) pour maintenir correctement à jour la documentation. | ||
+ | |||
+ | **__À 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 : [[: | ||
+ | |||
+ | **__Utiliser uniquement l' | ||
+ | * Ubuntu 18.04 : Bionic | ||
+ | * Ubuntu 16.04 : Xenial | ||
+ | |||
+ | |||
+ | **Exception** : les pages [[: | ||
+ | |||
+ | :!: Si il y a des tags de [[: | ||
+ | |||
+ | |||
+ | ==== Choisir les bons tags ==== | ||
+ | |||
+ | * Un tag doit correspondre à une **page existante**, | ||
+ | * Choisissez vos tags parmi **[[: | ||
+ | * **Ne pas créer un nouveau tag s'il ne peut être placé sur 5 pages ou plus** : voir la page sur la [[: | ||
+ | |||
+ | |||
+ | ==== Tags particuliers ==== | ||
+ | |||
+ | Pour le fonctionnement interne de la documentation certains tags peuvent être placés sur des pages spécifiques afin d' | ||
+ | |||
+ | Ces tags sont : | ||
+ | * [[: | ||
+ | * [[: | ||
+ | * [[: | ||
+ | * [[: | ||
+ | |||
+ | |||
+ | ===== Les « topics » ===== | ||
+ | |||
+ | Pour lister les pages ayant un tag particulier utilisez cette syntaxe : | ||
+ | |||
+ | < | ||
+ | |||
+ | Si vous venez d' | ||
+ | |||
+ | D' | ||
+ | < | ||
+ | {{topic> | ||
+ | {{topic> | ||
+ | {{topic> | ||
+ | </ | ||
+ | Pour plus de détails, se référer à l' | ||
+ | |||
+ | |||
+ | ===== 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 : | ||
+ | * [[: | ||
+ | * [[: | ||
+ | |||
+ | 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:// | ||