| Les deux révisions précédentesRévision précédenteProchaine révision | Révision précédente |
| wiki:tags [Le 21/01/2011, 05:53] – Tags particuliers YannUbuntu | wiki:tags [Le 24/09/2026, 12:09] (Version actuelle) – màj krodelabestiole |
|---|
| {{tag>wiki}} | {{tag>wiki wiki:tag}} |
| ---- | |
| |
| ====== Les « tags » ====== | ====== Les tags ====== |
| |
| Dans la documentation, les tags (liens verts situés au-dessus du titre de la page) permettent de créer des liens entre toutes les pages. 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 évidemment 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 ===== | ===== 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> | <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 ===== | ===== 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]]) | |
| * 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, 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, 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. | **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é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, |
| * à_supprimer : pour les pages que l'ont pense supprimer mais auxquelles 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 » ===== | |
| |
| Pour lister les pages ayant un tag particulier utilisez cette syntaxe : | Pour lister les pages ayant un tag particulier utilisez cette syntaxe : |
| |
| 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, 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>+}} |