Différences

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

--- fr:wikitools:syntaxe:tag [2015/07/15 15:23] – Ajout de tags Lyne
+++ fr:wikitools:syntaxe:tag [2021/12/03 19:19] (Version actuelle) – modification externe 127.0.0.1
@@ Ligne 1: / Ligne 1: @@
 ====== Catégories ou Tags ======
-La gestion des catégories se fait grâce aux plugins [[doku>plugin:tag|tag]] et [[doku>plugin:pagelist|pagelist]].
+La gestion des catégories se fait grâce aux plugins [[doku>plugin:tag|tag]], [[doku>plugin:pagelist|pagelist]] et [[doku>plugin:tagfilter|tagfilter]].
 ===== Plugin Tag =====
@@ Ligne 119: / Ligne 119: @@
 Ceci affichera la liste des pages avec la ligne de titre et une colonne commentaires (si le plugin Discussion est installé).
-{{tag>Wiki Syntaxe}}
+===== Tagfilter =====
+Lorsque les tags sont indiqués suivant la syntaxe lue par tagfilter, on peut ensuite les trier via un menu déroulant.
+{{ https://www.dokuwiki.org/lib/exe/fetch.php?tok=a068ca&media=https%3A%2F%2Fgithub.com%2Flisps%2Ftagfilter%2Fraw%2Fmaster%2Fexample%2Fexample1.png?nolink |}}
+==== Écrire des tags analysables par tagfilter ====
+Il faut écrire les tags comme s'ils étaient dans des espaces de nom.
+  {{tag>exemple1:exemple2 exemple3:exemple4}}
+Ici, ''exemple1'' et ''exemple3'' serviront à définir un groupe de tag, ''exemple2'' et ''exemple4'' étant les choix possibles.
+  {{tag>couleur:rouge taille:gros}}
+  {{tag>couleur:noir taille:petit}}
+  {{tag>couleur:vert taille:énorme}}
+On pourra, avec l'exemple précédent, afficher toutes les pages dont la couleur est "rouge" et la taille "petit", par exemple.
+==== Trier les tags ====
+  {{tagfilter>(namespace)?(tags-filter-groups)&(flags)}}
+  * (namespace) définit l'espace de nom où les pages seront filtrés
+  * (tags-filter-groups) définit les différents champs des listes déroulantes ''Syntax (Label)=(RegExpr)=(Standard)'' séparés par ''|''
+     * (Label) : le nom du champ
+     * (RegExpr) : une expression régulière permettant de sélectionner les options de la sélection
+     * (Standard) : Valeur par défaut de la liste déroulante.
+  * (flags) ajoute des options sur la façon dont les listes s'affichent
+    * ''multi'' : permet de choisir plusieurs tags
+    * ''chosen'' <wrap important>J'ai rien compris sur la page en anglais, merci de compléter ce bout de doc</wrap>
+    * ''cache=<seconds>'' : temps de mise en cache
+    * Tous les drapeaux (flag) utilisés par le plugin pagelist
+Exemple
+<code>{{tagfilter>Status=status:.*=status:ready|Version=version:.*&nouser&nodate&multi&chosen}}
+{{tagfilter>Status=status:.*=status:ready|Version=version:.*&nouser&nodate&multi}}
+{{tagfilter>Status=status:.*=status:ready|Version=version:.*&nouser&nodate}}</code>
+==== Un exemple complet ====
+Tagfilter est entre autre utilisé sur le [[taf>|TAF]] pour le statut des différentes tâches ainsi que les personnes à qui elles sont affectées.
+Un tag général "Statut" peut avoir 4 possibilités :
+  * À_faire
+  * En_cours
+  * À_vérifier
+  * Fini
+Le tag général "Pour" est suivi de nom de personnes. Par exemple, sur une tâche, on peut avoir la balise suivante, si elle est "à faire" et attribuée à plusieurs personnes :
+  {{tag>Statut:À_faire Pour:Zatalyz Pour:Yannk Pour:Personne}}
+Si, par la suite, je veux afficher les filtres concernant les tâches "à faire" qui sont attribués à Zatalyz, je peux insérer ce code dans une page :
+  {{tagfilter>État=statut:.*=status:À_faire|Attribué à=Pour:.*}}
+  * "État" et "Attribué à" peuvent être remplacé par ce qu'on veut : c'est juste le titre des listes.
+  * Ce qui est situé derrière les signes ''='' indique quelle sorte de tag je vais filtrer, il faut donc bien utiliser ce qui nous a servi avant. Ici, "statut" et "pour".
+  * Le symbole ''.*'' est une expression régulière voulant dire "prend tout". Donc, dans la liste déroulante, le choix existera entre tous les "statuts" répertoriés sur le wiki.
+Gardez en tête que si vous mettez un tag séparé d'un autre par deux points, il pourra ensuite être analysé par tagfilter.
+{{tag>Wiki Syntaxe}}