Différences

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

--- fr:wikitools:syntaxe:tag [2014/08/21 19:01] – [Balise Tag] zatalyz
+++ 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]].
-<WRAP center round important 30%>
-A traduire, et ajouter syntaxe de pagelist, vu que les deux sont liés. Regardez les deux liens des plugins et leur texte de base pour traduire au mieux.
-</WRAP><WRAP clear></WRAP>
 ===== Plugin Tag =====
@@ Ligne 18: / Ligne 14: @@
   {{tag>Tag1 Tag2 Tag3}}
-Choisissez des tags pertinents, regardez et reprenez ceux qui existent déjà. Évitez les synonymes et ne mettez que les plus pertinents, ceux qui servent à rassembler les pages. Chacun de ces Tags (Le lien présent sur chaque tag dans la page) pointe vers une page listant toutes les autres pages portant le même tag. Ainsi les tag permettent de regrouper les pages par sujet.
+Choisissez des tags pertinents, regardez et reprenez ceux qui existent déjà. Évitez les synonymes et ne mettez que les plus pertinents, ceux qui servent à rassembler les pages. Chacun de ces Tags (le lien présent sur chaque tag dans la page) pointe vers une page listant toutes les autres pages portant le même tag. Ainsi les tags permettent de regrouper les pages par sujet.
@@ Ligne 33: / Ligne 29: @@
 ^ [tag] | la liste des tags pour lesquels on aimerait lister les pages les contenants | <wrap important>requis</wrap> |
-^ [flags] | pagelist flags delimited by ''&'', see [[pagelist#flags]] | optionnel |
+^ [flags] | flags de listes de pages séparés par des ''&'', voir [[#flags|flags]] | optionnel |
-This displays a list of all pages that contain the given category tag. The list is sorted alphabetically by page ID. You can also prepend the modifiers ''+'' and ''-''. ''+'' creates an intersection between the list of pages created by the already defined tags and the pages matching the tag following the ''+'' (AND), ''-'' removes all pages tagged with the given tag from the list of already found pages.
+Cela affiche une liste de toutes les pages qui contiennent cette catégorie de balise (//tag//). La liste est triée dans l'ordre alphabétique des ID de page. Vous pouvez également ajouter le modificateur ''+'' et ''-''. ''+'' crée une intersection entre la liste des pages créées par les balises (//tag//) déjà définies et les pages correspondant à la balise (//tag//) suivant le ''+'' (''+'' est un ET logique). ''-'' supprime toutes les pages marquées avec la balise (//tag//) donnée de la liste des pages déjà trouvées.
-Cela affiche une liste de toutes les pages qui contiennent cette catégorie de balise (//tag//). La liste est triée dans l'ordre alphabétique des ID de page. Vous pouvez également ajouter le modificateur ''+'' et ''-''. ''+'' Crée une intersection entre la liste des pages créées par les balises (//tag//) déjà définies et les pages correspondant à la balise (//tag//) suivant le ''+'' (''+'' est un ET logique). ''-'' supprime toutes les pages marquées avec la balise (//tag//) donnée de la liste des pages déjà trouvés.
+Exemple :
-Example:
+  * ''%%{{topic>tag1 -tag2}}%%'' -- Liste toutes les pages taggées avec tag1 mais pas avec tag2.
-  * ''%%{{topic>tag1 -tag2}}%%'' -- Lists all pages tagged with tag1 but not with tag2.
+  * ''%%{{topic>tag1 +tag2}}%%'' -- Liste toutes les pages taggées avec tag1 et tag2.
-  * ''%%{{topic>tag1 +tag2}}%%'' -- Lists all pages tagged with tag1 and tag2.
+  * ''%%{{topic>tag1 tag2}}%%'' -- Liste toutes les pages taggées avec soit tag1, soit tag2, soit les deux.
-  * ''%%{{topic>tag1 tag2}}%%'' -- Lists all pages tagged with either tag1 or tag2 or both.
+  * ''%%{{topic>ns1?tag1 tag2}}%%'' -- Liste toutes les pages dans le namespace ns1 taggée avect tag 1 ou tag2.
-  * ''%%{{topic>ns1?tag1 tag2}}%%'' -- List all pages inside namespace ns1 tagged with either tag1 or tag2
+  * ''%%{{topic>.?tag1 tag2}}%%'' -- Liste toutes les pages dans le namespace courant taggées avec tag1 ou tag2.
-  * ''%%{{topic>.?tag1 tag2}}%%'' -- List all pages inside the current namespace tagged with either tag1 or tag2
+  * ''%%{{topic>tag1 tag2 tag3&nodate&desc&sort}}%%'' (Ajoute des options de [[#plugin_pagelist|pagelist]] pour modifier le design)
-  * ''%%{{topic>tag1 tag2 tag3&nodate&desc&sort}}%%'' (Adding [[doku>plugin:pagelist|pagelist]] options to change the design)
 ==== Searchtags ====
@@ Ligne 52: / Ligne 46: @@
    {{searchtags&[flags]}}
-^ [flags] | pagelist flags delimited by ''&'', see [[pagelist#flags]] | optional |
+^ [flags] | flags de liste de page séparés par des ''&'', voir [[#flags|flags]] | optionnel |
-This displays a search form with the possibility to select a namespace and to select tags from a table of all tags that should either be in- or excluded with the option to choose if the tags should be associated with AND or OR. The results are displayed as in the topic component.
+Ceci affiche un formulaire de recherche avec la possibilité de choisir un espace de nom et les tags à partir d'un tableau de tous les tags, qui doivent être soit inclus soit exclus, avec l'option de choisir si les tags doivent être associés à l'aide d'un AND ou d'un OR. Les résultats s'affichent comme dans le composant Topic.
-Example:
+Exemple :
-  * ''%%{{searchtags}}%%'' -- The basic syntax
+  * ''%%{{searchtags}}%%'' -- La syntaxe de base
-  * ''%%{{searchtags&nodate&desc&sort}}%%'' -- with [[doku>plugin:pagelist|pagelist]] options to change the design
+  * ''%%{{searchtags&nodate&desc&sort}}%%'' -- avec les options de [[#plugin_pagelist|pagelist]] pour modifier le design
 ==== Count ====
@@ Ligne 64: / Ligne 58: @@
   {{count>[tag]}}
-^ [tag] | the category tag for which you want the list the occurrence | required |
+^ [tag] | le tag de catégorie dont vous voulez lister les apparitions | <wrap important>requis</wrap> |
-This part allow you to display an overview of your current used tags. It prints the tag and the related occurrence (how often is the tag used?) in your wiki. Either you can specify a ''+'' as tag-name, which results in a list of all used tags or just specify some tags separated by spaces.
+Cette partie vous permet d'afficher une vue d'ensemble des tags que vous utilisez actuellement : le tag et les apparitions associées (combien de fois le tag est utilisé) dans votre wiki. Vous pouvez utiliser soit ''+'' comme nom de tag, ce qui affiche la liste de tous les tags utilisés, ou simplement indiquer quelques tags séparés par des espaces.
-Example:
+Exemple :
-  * ''%%{{count>+}}%%'' -- List all tags with related occurrences.
+  * ''%%{{count>+}}%%'' -- Liste tous les tags avec les apparitions associées.
-  * ''%%{{count>tag1 tag2}}%%'' -- List the occurrence of tag1 and tag2.
+  * ''%%{{count>tag1 tag2}}%%'' -- Liste les apparitions des tag1 et tag2.
-  * ''%%{{count>tag1 tag2 tag3&. ns1 ns2}}%%'' -- List all occurrences for the given tags inside the namespaces (the dot specifies the root namespace)
+  * ''%%{{count>tag1 tag2 tag3&. ns1 ns2}}%%'' -- Liste toutes les apparitions avec tags spécifiés dans les espaces de noms (le point indique l'espace de nom racine).
-==== How to use tags which consist of multiple words? ====
+==== Comment utiliser des tags faits de plusieurs mots ? ====
-Just use an "_", it gets automatically replaced by a " " i.e.:
+Utiliser simplement un "_", qui remplace automatiquement un " ", c'est-à-dire :
 <code>
-{{tag>tag_with_multiple_words}}
+{{tag>tag_à_plusieurs_mots}}
 </code>
-Also, quotes seem to work:
+Les guillemets (anglais) semblent aussi fonctionner :
 <code>
-{{tag>"tag with multiple words"}}
+{{tag>"tag à plusieurs mots"}}
 </code>
-==== How to change the word tag and topic to another language ====
-> Is it possible to change the word tag used in syntax to something else, like another language <nowiki>{{tagInMylanguage>someTag}}</nowiki> --[[user>damascene]] //2012/04/10//
 ===== Plugin Pagelist =====
-===== Description =====
+Le plugin Pagelist, comme son nom l'indique, propose de jolies listes de pages wiki. Outre son fonctionnement comme plugin de syntaxe par lui-même, il est aussi utilisé comme plugin d'aide pour les plugins Blog, Discussion, Editor, Tag, Task et Dir.
-The Pagelist Plugin does -- as its name says -- list wiki pages in a nice way. Besides its function as a stand-alone syntax plugin, it serves as helper plugin for the [[Blog]], [[Discussion]], [[Editor]], [[Tag]], [[Task]] and [[Dir]] plugins.
+==== Syntaxe ====
-===== Syntax =====
+Encadrez simplement une liste non ordonnée de liens internes avec la balise ''%%<pagelist>%%'' :
-Just wrap a regular unordered list of internal links with the ''%%<pagelist>%%'' tag:
   <pagelist&[flags]>
@@ Ligne 106: / Ligne 93: @@
     * [[..:editor:|Editor Plugin]]
     * [[..:tag:|Tag Plugin]]
-    * [[..:wrap|Wrap Plugin|This is shown in the description cell]]
+    * [[..:wrap|Wrap Plugin|Ceci s'affiche dans la cellule de description]]
   </pagelist>
-^ [flags] | flags can be used to alter the appearance of the pagelist, see [[#flags]] | optional |
+^ [flags] | les flags peuvent être utilisés pour modifier l'apparence de liste de pages, voir [[#flags]] | optionnel |
 ==== Flags ====
-^ Setting ^ Default ^^ Alternative ^^
+^ Paramètre ^ Valeur par défaut ^^ Variante ^^
-| ''style'' ^ ''default'' | table with horizontal lines ^ ''table'', ''list'' or ''simplelist'' | standard DokuWiki table or list style |
+| ''style'' ^ ''default'' | tableau avec des lignes horizontales ^ ''table'', ''list'' ou ''simplelist'' | style de tableau ou de liste standard de DokuWiki |
-| ''showheader'' ^ ''noheader'' | hide the heading row of the pagelist table ^ ''header'' | show the header |
+| ''showheader'' ^ ''noheader'' | cache la ligne d'en-tête du tableau de liste des pages ^ ''header'' | montre l'en-tête |
-| ''showdate'' ^ ''date'' | show the creation or last modification date ^ ''nodate'' | hide the date |
+| ''showdate'' ^ ''date'' | affiche la date de création ou de dernière modification ^ ''nodate'' | cache la date |
-| ''showuser'' ^ ''user'' | show creator or contributors ^ ''nouser'' | hide the user |
+| ''showuser'' ^ ''user'' | affiche le créateur ou les contributeurs ^ ''nouser'' | cache l'utilisateur |
-| ''showdesc'' ^ ''nodesc'' | hide the description ^ ''desc'' | show the description (from metadata) |
+| ''showdesc'' ^ ''nodesc'' | cache la description ^ ''desc'' | affiche la description (à partir des metadonnées) |
-| ''showcomments'' ^ ''nocomments'' | hide the number of comments ^ ''comments'' | show the number of comments (if [[discussion|Discussion Plugin]] is installed) |
+| ''showcomments'' ^ ''nocomments'' | cache le nombre de commentaires ^ ''comments'' | affiche le nombre de commentaires (si le plugin Discussion est installé) |
-| ''showtags'' ^ ''notags'' | hide the tags ^ ''tags'' | show the tags (if [[tag|Tag Plugin]] is installed) |
+| ''showtags'' ^ ''notags'' | cache les tags ^ ''tags'' | affiche les tags (si le [[tag|Plugin Tag]] est installé) |
-| ''showfirsthl'' ^ ''firsthl'' | show the first headline ^ ''nofirsthl'' | show the page name |
+| ''showfirsthl'' ^ ''firsthl'' | affiche la ligne de titre ^ ''nofirsthl'' | affiche le nom de la page |
-| ''rsort/sort''        ^ ''nosort''    | no sortation of pages ^ ''rsort/sort'' | sorts the pages (reverse) alphabetically by pagename |
+| ''rsort/sort''        ^ ''nosort''    | pas de tri des pages ^ ''rsort/sort'' | trie les pages (à l'envers) par ordre alphabétique de nom de page |
-==== Example ====
+==== Exemple ====
   <pagelist&header&comments>
@@ Ligne 130: / Ligne 117: @@
   </pagelist>
-This will show a list of pages with a header line and a comments column (if the [[plugin:discussion|Discussion Plugin]] is installed).
+Ceci affichera la liste des pages avec la ligne de titre et une colonne commentaires (si le plugin Discussion est installé).
+===== 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.
-===== Configuration =====
+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.
-The plugin can be configured using the DokuWiki configuration manager available in the admin menu. The settings also apply to plugins which use the helper component of the pagelist plugin, like for example the archive component of the [[plugin:blog]] plugin.
-^ ''style'' | List style (default, list, table) |
+{{tag>Wiki Syntaxe}}
-^ ''showheader'' | Show table header |
-^ ''showdate'' | Shows/hides the date column (hide, creation date, modification date) |
-^ ''showuser'' | Shows/hides the user column (hide, creator, contributors) |
-^ ''showdesc'' | Shows/hides a short description taken from the first paragraph of a page (hide, max. 160 characters, max. 500 characters) |
-^ ''showcomments'' | Shows/hides comments of a page (requires the [[plugin:discussion]] plugin) |
-^ ''showlinkbacks'' | Shows/hides linkbacks of a page (requires the [[http://foosel.org/snippets/dokuwiki/linkback|linkback]] plugin) |
-^ ''showtags'' | Shows/hides tags of a page (requires the [[plugin:tag]] plugin) |
-^ ''sort''     | Sorts the pages alphabetically by pagename |