Logo Khaganat

Wikhan

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édentesRévision précédente
Prochaine révision		Révision précédente
fr:wikitools:syntaxe:pagequery [2015/07/15 17:35] – Traduction Lynefr:wikitools:syntaxe:pagequery [2021/12/03 19:19] (Version actuelle) – modification externe 127.0.0.1
Ligne 1: Ligne 1:
-====== Index et recherche de pages ======+====== Index et recherches de pages ======
  
 <WRAP center round todo 60%> <WRAP center round todo 60%>
-Traduction à terminer+Traduction à relire pour corriger les coquilles et compléter ce qui n'est éventuellement pas clair.
 </WRAP> </WRAP>
  
  
-La gestion des index et recherche de pages se fait grâce au plugin [[doku>plugin:pagequery|pagequery]] : il s'agit d'un outil de navigation polyvalent pour créer des pages d'index, faire des recherches ou des filtres sur du texte ou des noms de page, et afficher les résultats en colonnes, regroupés, triés. Il propose même des info-bulles pour prévisualiser le contenu.+La gestion des index et des recherches de pages se fait grâce au plugin [[doku>plugin:pagequery|pagequery]] : il s'agit d'un outil de navigation polyvalent pour créer des pages d'index, faire des recherches ou des filtres sur du texte ou des noms de page, et afficher les résultats, regroupés et/ou triés, en colonnes. Il propose même des info-bulles pour prévisualiser le contenu.
  
-Comme pagequery a fait un usage éhonté des excellentes fonctions disponibles dans DokuWiki (en particulier [[doku>search]]), il n'y a pas de nouvelle syntaxe à apprendre. Mais il apporte un petit quelque chose dans l'arrangement des puissantes options de tri et de regroupement.+Comme pagequery a fait un usage éhonté des excellentes fonctions disponibles dans DokuWiki (en particulier [[doku>search]]), il n'y a pas de nouvelle syntaxe à apprendre. Mais il apporte un petit quelque chose en plus dans l'arrangement des puissantes options de tri et de regroupement.
  
 Quelques utilisations possibles : Quelques utilisations possibles :
Ligne 18: Ligne 18:
  
 ===== Syntaxe et utilisation ===== ===== Syntaxe et utilisation =====
-Insérer la mention pageguery dans le texte de la page là où vous voulez que la page apparaisse. Vous pouvez avoir différentes listes ''pagequery'' dans la même page((Ça fonctionne très bien avec le [[doku>plugin:columns|plugin columns]])).+Insérer la mention pageguery dans le texte de la page là où vous voulez que la liste apparaisse. Vous pouvez avoir différentes listes ''pagequery'' dans la même page((Ça fonctionne très bien avec le [[doku>plugin:columns|plugin columns]])).
  
-Il peut s'agir de la version simple :+Il peut s'agir d'une version simple :
   {{pagequery>}}   {{pagequery>}}
      
-Ou, plus compliqué :+Ou, plus compliquée :
   {{pagequery>[query];fulltext;sort=key:direction,key2:direction;group;limit=10;cols=2;spelldate;proper}}   {{pagequery>[query];fulltext;sort=key:direction,key2:direction;group;limit=10;cols=2;spelldate;proper}}
      
-Ou alors à l'ancienne, et vraiment __trop__ compliqué... :+Ou alors à l'ancienne, et vraiment __trop__ compliquée... :
   {{pagequery>[query];fulltext;sort=key:direction,key2:direction;group;limit=100;cols=6;spelldate;proper;snippet=5;border=inside;hidestart;case;natsort}}   {{pagequery>[query];fulltext;sort=key:direction,key2:direction;group;limit=100;cols=6;spelldate;proper;snippet=5;border=inside;hidestart;case;natsort}}
      
-**Remarque :** la syntaxe peut être affichée sur plusieurs lignes pour améliorer la lisibilité. Les espaces sont tout simplement ignorés. Par exemple :+**Remarque :** la syntaxe peut être affichée sur plusieurs lignes pour améliorer la lisibilité. Les espaces sont alors tout simplement ignorés. Par exemple :
 <code> <code>
 {{pagequery>query; {{pagequery>query;
Ligne 52: Ligne 52:
  
 ^Option  ^Description  ^Exemples de syntaxe  ^Valeur par défaut ^ ^Option  ^Description  ^Exemples de syntaxe  ^Valeur par défaut ^
-^query  |Place l'expression de recherche immédiatement après le ''>'', par exemple %%{{ pagequery>help;... }}%% \\ Par défaut, il cherche seulement dans les noms de pages (ou les identifiants). Pour faire une recherche dans le contenu des pages du wiki, utiliser l'option ''fulltext'' ci-dessous |* \\ help \\ test |  //toutes les pages//  | +^query  |Place l'expression de recherche immédiatement après le ''>'', par exemple %%{{ pagequery>help;... }}%% \\ Par défaut, il cherche seulement dans les noms de pages (ou les identifiants). Pour faire une recherche dans le contenu des pages du wiki, utiliser l'option ''fulltext'' ci-dessous. |* \\ help \\ test |  //toutes les pages//  | 
-|       |Vous pouvez utiliser des //expressions régulières//((on dit aussi : regex ; faites une recherche Google pour de l'aide sur les expressions régulières si ça vous intéresse d'utiliser cette puissante fonctionnalité)) dans les recherches de nom de page. Pour voir toutes les pages, utiliser * ou .* , ou laissez le simplement à blanc.((tant que vous ne filtrez pas par espaces de nom : voir la note suivante !)) |''^p.+'' \\ [mots commençants par ''p'']  |  |+|       |Vous pouvez utiliser des //expressions régulières//((On dit aussi "regex". Faites une recherche Google pour en savoir plus sur les expressions régulières si ça vous intéresse d'utiliser cette puissante fonctionnalité)) dans les recherches de nom de page. Pour voir toutes les pages, utilisez * ou .* , ou laissez simplement à blanc((Tant que vous ne filtrez pas par espaces de nom : voir la note suivante !)). |''^p.+'' \\ [mots commençants par ''p'']  |  |
 |       |//**Note :** ''*'' en lui-même est juste une commodité. Dans n'importe quelle autre regex, il vous faudra suivre les règles de la regex.//  ||| |       |//**Note :** ''*'' en lui-même est juste une commodité. Dans n'importe quelle autre regex, il vous faudra suivre les règles de la regex.//  |||
-|namespaces  |La recherche sur les noms de page accepte les mêmes options d'espaces de noms que [[doku>:search|la recherche dans le texte]], c'est-à-dire : ''^ ou -ns:'' signifie exclure, ''@ ou ns:'' signifie inclure |''^:work @:home:games *''  |  //none//  | +|namespaces  |La recherche sur les noms de page accepte les mêmes options d'espaces de noms que [[doku>:search|la recherche dans le texte]], c'est-à-dire : ''^ ou -ns:'' signifie exclure, ''@ ou ns:'' signifie inclure. |''^:work @:home:games *''  |  //rien//  | 
-|       |Les [[doku>:namespaces|espaces de noms]] relatifs (.) et parent (..) sont aussi compatibles((utilisez la syntaxe présentée dans la page des espaces de nom.))  ||| +|       |Les [[doku>:namespaces|espaces de noms]] relatifs (.) et parent (..) sont aussi compatibles((Utilisez la syntaxe présentée dans la page des espaces de nom.)).  ||| 
-|       |//**Note :** si vous utilisez l'option namespace, il vous faudra également fournir une requête de nom de page (au minimum ''*''), parce que, par exemple, la fonction regex ne peut pas distinguer ''^work'' (espace de nom) et ''^work'' (noms de pages commençant par "work") //  ||| +|       |//**Note :** si vous utilisez l'option namespace, il vous faudra également fournir une requête de nom de page (au minimum ''*''), parce que, par exemple, la fonction regex ne peut pas distinguer ''^work'' (espace de nom) et ''^work'' (noms de pages commençant par "work"). //  ||| 
-^fulltext  |Utilise une recherche sur tout le texte, ce qui autorise toutes les options de recherche DokuWiki. Cette option vous permet de faire tout un tas de recherches compliquées : reportez vous à la page [[doku>:search]] pour plus de détails |''fulltext''  |  |+^fulltext  |Utilise une recherche sur tout le texte, ce qui autorise toutes les options de recherche DokuWiki. Cette option vous permet de faire tout un tas de recherches compliquées : reportez vous à la page [[doku>:search]] pour plus de détails. |''fulltext''  |  |
 ^fullregex  |Vous permet de faire une recherche sur l'identifiant complet de la page (c'est-à-dire y compris son espace de nom) à l'aide d'expressions régulières. C'est un mode //brut// pour utilisateurs avancés... mais ça ne fonctionne que sur les identifiants de page. |''fullregex''  |  | ^fullregex  |Vous permet de faire une recherche sur l'identifiant complet de la page (c'est-à-dire y compris son espace de nom) à l'aide d'expressions régulières. C'est un mode //brut// pour utilisateurs avancés... mais ça ne fonctionne que sur les identifiants de page. |''fullregex''  |  |
-^sort  |Clés à utiliser pour le tri, par ordre d'application dans le tri. Chaque clé peut être suivie par un ordre de tri préféré, ''sort=key:direction,key2:direction''  |''sort=a:asc,name:asc'' \\ ''sort=cyear,cmonth,name''  |  //none//  |+^sort  |Clés à utiliser pour le tri, par ordre d'application dans le tri. Chaque clé peut être suivie par un ordre de tri préféré : ''sort=key:direction,key2:direction''  |''sort=a:asc,name:asc'' \\ ''sort=cyear,cmonth,name''  |  //rien//  |
 |**Clés** de tri :     |||| |**Clés** de tri :     ||||
-|a, ab, abc         |Par 1ère lettre, 2 premières lettres ou 3 premières lettres |''sort=a'' \\ ''sort=ab''  | |+|a, ab, abc         |Sur la 1ère, les 2 premières ou les 3 premières lettres. |''sort=a'' \\ ''sort=ab''  | |
 |name, pagename     |Par nom de page((sans espace de nom)) //[non groupé]//  |''sort=name''  |  | |name, pagename     |Par nom de page((sans espace de nom)) //[non groupé]//  |''sort=name''  |  |
 |title, heading     |Par titre de page (ou première ligne d'en-tête) //[non groupé]//  |''sort=title:desc''  |  | |title, heading     |Par titre de page (ou première ligne d'en-tête) //[non groupé]//  |''sort=title:desc''  |  |
Ligne 68: Ligne 68:
 |ns                 |Par espace de nom (sans nom de page) |''sort=ns''  |  | |ns                 |Par espace de nom (sans nom de page) |''sort=ns''  |  |
 |mdate, cdate       |Par date de création/modification (complète) //[non groupé]//|''sort=mdate''  |  | |mdate, cdate       |Par date de création/modification (complète) //[non groupé]//|''sort=mdate''  |  |
-|m[year][month][day]|Par [année][mois][jour] de [m]odification; toutes les combinaisons sont acceptées |''sort=myearmonthday'' \\ ''sort=mmonthday''  |  |+|m[year][month][day]|Par [année][mois][jour] de [m]odification ; toutes les combinaisons sont acceptées |''sort=myearmonthday'' \\ ''sort=mmonthday''  |  |
 |c[year][month][day]|Par [année][mois][jour] de [c]réation; toutes les combinaisons sont acceptées |''sort=cyearmonthday''  |  | |c[year][month][day]|Par [année][mois][jour] de [c]réation; toutes les combinaisons sont acceptées |''sort=cyearmonthday''  |  |
 |creator            |Par auteur de page |''sort=creator''  |  | |creator            |Par auteur de page |''sort=creator''  |  |
Ligne 76: Ligne 76:
 |**Sens** de tri :  |||| |**Sens** de tri :  ||||
 |asc, a             |Ordre ascendant, c'est-à-dire a -> z, 1 -> 10 |''sort=name:asc''  |  //asc//  | |asc, a             |Ordre ascendant, c'est-à-dire a -> z, 1 -> 10 |''sort=name:asc''  |  //asc//  |
-|desc, d         |Ordre descendant, c'est-à-dire z -> a, 10 -> 1 |''sort=mdate:desc''  |  | +|desc, d         |Ordre décroissant, c'est-à-dire z -> a, 10 -> 1 |''sort=mdate:desc''  |  | 
-|        |//Note : dates default to a descending sort (most recent date at top), text to ascending sort (A - Z)//||| +|        |//Note : par défaut, les dates sont triées par ordre décroissant (les dates les plus récentes en haut), et les textes par ordre ascendant (A - Z)//||| 
-^filter  |Filter the result list by any of the above sort **keys**, using regular expressions, to //include// or //exclude// certain pages  ||| +^filter  |Filtre la liste de résultats par n'importe laquelle des **clés** de tris ci-dessus, à l'aide d'expressions régulière pour //inclure// ou //exclure// certaines pages  ||| 
-|include  |Syntax is similar to the ''sort'' above: ''filter=<key>:<expression>,<key2>:<expression2>''  |''filter=creator:harry'' \\ ''filter=contrib:.*(harry|sally).*'' || +|include  |La syntaxe est identique à celle du ''sort'' ci-dessus : ''filter=<key>:<expression>,<key2>:<expression2>''  |''filter=creator:harry'' \\ ''filter=contrib:.*(harry|sally).*'' || 
-|exclude |To exclude pages from the results put a **^** or **!** before the key instead: ''filter=!<key>:<expression>''  |''filter=!creator:harry''  || +|exclude |Pour exclure des pages des résultats, mettre un **^** ou un  **!** devant la clé : ''filter=!<key>:<expression>''  |''filter=!creator:harry''  || 
-|dates   |//filter=// option now recognises real dates and allows you to filter by them correctly.  E.g. ''filter=cdate:3 years ago%%->%%3 months ago''||| +|dates   |//filter=// l'option reconnait désormais les dates réelles et vous permet de les filtrer correctement. Par exemple : ''filter=cdate:3 years ago%%->%%3 months ago''||| 
-|        |A begin and/or end date can be provided, separated by the %%->%% arrow symbols.  It uses the PHP strtotime function which accepts a wide array of formats, check the [[http://www.php.net/manual/en/datetime.formats.php|php function]] for information.||| +|        |Une date de début et/ou de fin peut être donnée, séparée par le symbole flèche %%->%%.  Ceci utilise la fonction PHP strtotime qui accepte une grande variété de formats, se reporter aux [[http://www.php.net/manual/en/datetime.formats.php|fonctions php de date]] pour plus d'information.||| 
-|        |From a certain date until now  |''filter=mdate:24.1.2009%%->%%''  || +|        |Depuis une date donnée jusqu'à maintenant |''filter=mdate:24.1.2009%%->%%''  || 
-|        |Up to a certain date only  |''filter=mdate:%%->%%24.12.2012''  || +|        |Seulement jusqu'à une date donnée |''filter=mdate:%%->%%24.12.2012''  || 
-|        |Last three months only  |''filter=mdate:3 months ago%%->%%''  || +|        |Seulement les trois derniers mois |''filter=mdate:3 months ago%%->%%''  || 
-^group   |Show a group header for each change in sort keys.((For a more detailed explanation of grouping see the note after this table))  |''group''  |  //not grouped//  | +^group   |Affiche un en-tête de groupe pour chaque changement dans la clé de tri.((Pour une explication plus détaillée des regroupements, voir la note après ce tableau)) |''group''  |  //non groupé//  | 
-|        |For example, if you sorted by [myear] (i.e. modified year) then a group header will \\ be inserted every time the year changes (2010...2009...2008...etc...)  ||| +|        |Par exemple, si vous avez trié par [myear] (c'est-à-dire année de modification) alors l'en-tête du groupe sera inséré à chaque fois que l'année change \\ (2010...2009...2008...etc...)  ||| 
-|        |Namespaces are grouped by all sub-namespaces up to the ''maxns'' limit((see below))  ||| +|        |Les espaces de noms sont groupés par tous les sous-espaces de noms jusqu'à la limite ''maxns''((voir ci-dessous)) ||| 
-|        |Note: keys that are all unique cannot be grouped (i.e. name, page/id, mdate, cdate)  ||| +|        |Note : les clés qui sont toutes uniques ne peuvent pas être groupées (c'est-à-dire les noms, les identifiants de page, la date de modification (mdate) ou de création(cdate) ) ||| 
-^limit   |Maximum number of results to return.  0 = return all (default)  |''limit=10''|  //all//  | +^limit   |Nombre maximum de résultats à ramener. 0 = ramener tout (défaut) |''limit=10''|  //tout//  | 
-^spelldate  |Use real month and day names instead of numeric dates.  |''spelldate''  |  //numeric dates//  | +^spelldate |Utilise le vrai nom du mois ou du jour à la place de dates numériques.((A voir si ça marche en français, ou seulement avec les noms anglais.)) |''spelldate''  |  //dates numériques//  | 
-^cols    |Number of columns in displayed list (max = 6)  |''cols=3''  |  1  | +^cols    |Nombre de colonnes dans la liste affichée (max = 6)  |''cols=3''  |  1  | 
-^proper  |Display page names and/or namespaces in Proper Case (i.e. every word capitalised, and no _'s). |  |  //none//  | +^proper  |Affiche les noms des pages et/ou les espaces de noms avec la casse correcte (c'est-à-dire une majuscule à chaque mot et pas de _'s)((Là encore, ce sont les règles de la casse anglaise qui semblent s'appliquer : à vérifier comment ça se traduit en français.)). |  |  //rien//  | 
-|name    |Display page names in proper-case  |''proper=name''  |  | +|name    |Affiche les noms de page dans la casse correcte |''proper=name''  |  | 
-|header  |Display group headers in proper-case  |''proper=header'' \\ ''proper=hdr''  |  | +|header  |Affiche les en-têtes de groupe dans la casse correcte |''proper=header'' \\ ''proper=hdr''  |  | 
-|both    |Both the above options!  |''proper=both'' \\ ''proper''  |  | +|both    |Les deux options ci-dessus !  |''proper=both'' \\ ''proper''  |  | 
-|        |//Note: this is different from the ''UseHeading'' option in DokuWiki and many other plugins (see ''display'' option below)//||| +|        |//Note : ceci est différent de l'option ''UseHeading'' dans DokuWiki et de nombreux autres plugins (voir l'option ''display'' ci-dessous)//||| 
-^border  |Show a border around table columns |  |  //none//  | +^border  |Affiche une bordure autour des colonnes du tableau |  |  //rien//  | 
-|none    |do not show any borders (default)  |''border=none''  |  | +|none    |N'affiche aucune bordure (défaut)  |''border=none''  |  | 
-|inside  |show borders between the columns only  |''border=inside''  |  | +|inside  |Affiche des bordures seulement entre les colonnes  |''border=inside''  |  | 
-|outside |show a border around the whole pagequery table  |''border=outside''  |  | +|outside |Affiche une bordure autour de tout le tableau pagequery  |''border=outside''  |  | 
-|both    |show borders around both table and columns  |''border=both'' \\ ''border''  |  | +|both    |Affiche des bordures à la fois autour du tableau et des colonnes |''border=both'' \\ ''border''  |  | 
-^hidestart |Ignore any default //start// pages in the namespace(s).  |''hidestart''  |  //show start pages//  | +^hidestart |Ignore toutes les pages //start// par défaut dans les espaces de nom.  |''hidestart''  |  //montres les pages start//  | 
-|        |//Note: start pages **must** be named as per the start setting in your configuration for this option to work correctly!//  ||| +|        |//Note : les pages start **doivent** être nommées en accord avec les paramètres de votre configuration pour que cette option fonctionne correctement !//  ||| 
-^display |How to display the page links.  For example you can display just the page name, page title, page id, page date, or other combination of the page's metadata.||| +^display |Comment afficher les liens des pages. Par exemple, vous pouvez afficher juste le nom de la page, le titre de la page, l'identifiant de la page, la date de la page, ou toute autre combinaison des méta-données de la page.||| 
-|      |The //display=// option accepts template-style replacement strings|''display={name} ({cdate})'' \\  "Name-of-page (20 Jan 2013)" || +|      |L'option //display=// accepte les chaînes de remplacement de style-modèle|''display={name} ({cdate})'' \\  "Name-of-page (20 Jan 2013)" || 
-|      |NOTE: all metadata names must be in curly braces {}, otherwise they are just considered as normal words!||| +|      |Note : tous les noms de méta-données doivent être entre accolades {}, ou ils seront considérés comme de simples mots !||| 
-|      |All of the Dokuwiki meta data fields are accepted, plus any pagequery meta columns in use.  To get at the nested Dokuwiki metadata use key:subkey.|''display={date:created} {title}''|| +|      |Tous les champs de méta-données de DokuWiki sont acceptés, plus toute méta-colonne pagequery en cours d'utilisation. Pour utiliser les méta-données imbriquées de DokuWiki, utiliser key:subkey.|''display={date:created} {title}''|| 
-|      |See [[devel:metadata|metadata]] for a list of field names you can use.||| +|      |Voir [[doku>devel:metadata|les métadonnées]] pour une liste des noms de champ que vous pouvez utiliser.||| 
-^snippet |Controls how the page snippet (preview) is displayed:  |  |  //tooltip//  | +^snippet |Contrôle comment la page de coupures (aperçu) est affichée : |  |  //tooltip//  | 
-|tooltip |As a pop-up/tool-tip on each page link  |''snippet=tooltip'' \\ ''snippet''  |  | +|tooltip |Comme un pop-up/une info-bulle sur le lien de chaque page |''snippet=tooltip'' \\ ''snippet''  |  | 
-|        |The next three options use the following syntax: <format>,<count>,<extent> ||| +|        |Les trois prochaines options utilisent la syntaxe suivante : <format>,<count>,<extent> ||| 
-|        |<format>: one of the formats listed below: //inline, plain, quoted//  ||| +|        |<format>: l'un des formats listés ci-dessous : //inline, plain, quoted//  ||| 
-|        |<count>: to show 1st <count> items in list with an preview  ||  //all//  | +|        |<count>: pour afficher les premiers <count> objets dans la liste avec un aperçu ||  //tout//  | 
-|        |<extent>: can be choice of [c]hars, [w]ords, [l]ines, or [~]<stop at>\\ e.g. c? = ? chars, w? = ? words, l? = ? lines, ~? = search up to ? text/char/symbol  ||  //all//  | +|        |<extent>: peut être un choix entre les [c]aractères, [w]mots, [l]ignes, ou [~]<s'arrêter à>\\ par exemple : c? = ? caractères, w? = ? mots, l? = ? lignes, ~? = chercher jusqu'au caractère/texte/symbole ? ||  //tout//  | 
-|inline  |show in-line with the link  |''snippet=inline,5,c20''  |  | +|inline  |afficher sur la même ligne que le lien |''snippet=inline,5,c20''  |  | 
-|plain   |show as simple text below the link (mimimal formatting)  |''snippet=plain,10,w30''  |  | +|plain   |affiche comme du texte simple en-dessous du lien (mise en forme minimale) |''snippet=plain,10,w30''  |  | 
-|quoted  |show in tidy quotation box  |''snippet=quoted,3,l3''  |  |         +|quoted  |afficher dans boite de citation ordonnée |''snippet=quoted,3,l3''  |  |         
-^maxns   |The number of namespace levels to display.  |  |  //show all//  | +^maxns   |Le nombre de niveaux d'espaces de noms à afficher.  |  |  //affiche tout//  | 
-|        |Display no more than 3 namespace levels, e.g. one:two:three  |''maxns=3''  |  | +|        |N'affiche pas plus de 3 niveaux d'espace de noms, c'est-à-dire un:deux:trois  |''maxns=3''  |  | 
-|        |''maxns=0'' => show all levels (default)  |  |  | +|        |''maxns=0'' => affiche tous les niveaux (valeur par défaut) |  |  | 
-^case    |Honour case when sorting, i.e. a..z then A..Z  |''case''  |  //case insensitive//  | +^case    |Tient compte de la casse pendant le tri, c'est-à-dire a..z puis A..Z |''case''  |  //non sensible à la casse//  | 
-^natsort |Use PHP's natural sorting functions, e.g. ''1,2,10,12'' rather than ''1,10,12,2''  |''natsort''  |  //normal sorting//  | +^natsort |Utiliser les fonctions de tri naturelles de PHP, c'est-à-dire''1,2,10,12'' plutôt que ''1,10,12,2''  |''natsort''  |  //tri normal//  | 
-^underline  |show a faint underline between each link for clarity  |''underline''  |  //none//  | +^underline  |afficher un léger soulignement entre chaque lien pour plus de lisibilité |''underline''  |  //rien//  | 
-^label   |A label to be displayed at the top of the PageQuery list  |''label=A-Z of All Pages''  |  //nothing//  | +^label   |Une étiquette à afficher en haut de la liste PageQuery |''label=A-Z of All Pages''  |  //rien//  | 
-^hidemsg   |Hide any empty result messages  |''hidemsg''  |  //visible//  | +^hidemsg   |Cache n'importe quel message de résultat |''hidemsg''  |  //visible//  | 
-^hidejump  |Hide the "Jump To Top" link  |''hidejump''  |  //visible//  | +^hidejump  |Cache le lien "Retour en haut de la page" |''hidejump''  |  //visible//  | 
-^showcount |Show the total count of page links at bottom of list  |''showcount''  |  //hidden//  | +^showcount |Affiche le nombre total de liens de page en bas de la liste |''showcount''  |  //caché//  | 
-^layout  |choose between **table** or **column** layout\\ //table//: based on html table, compatible with most browsers \\ //column//: uses new CSS3 column-layout feature, doesn't work in older browsers((please do not write telling me that it doesn't work in IE 6-10...that's life.))  |''layout=column''  |  //layout=table//  | +^layout  |choisir entre l'affichage en **tableau** ou en **colonne**\\ //tableau// : basé sur un tableau html, compatible avec la plupart des navigateurs \\ //colonne// : utilise la nouvelle fonctionnalité de mise en page de colonne CSS3, ne fonctionne pas avec les plus anciens navigateurs((par exemple, IE 6-10))  |''layout=column''  |  //mise en page = tableau//  | 
-^fontsize  |Set the base font size for the pagequery list.  You can use any CSS size unit, e.g. 12px, 1.2em, 80%, etc...  |''fontsize=80%''  |  //90%//  | +^fontsize  |Fixe la taille de base pour la police de la liste pagequery. Vous pouvez utiliser n'importe qu'elle unité de taille CSS, c'est-à-dire 12px, 1.2em, 80%, etc...  |''fontsize=80%''  |  //90%//  | 
-^bullet    |Bullet style for list items (links) \\ Choose from none, disc, circle, or square  |''bullet=square''  |  //none//  |+^bullet    |Style des puces pour les objets de listes (liens) \\ Choisissez entre aucune, disque, cercle, ou carré (none, disc, circle, square)  |''bullet=square''  |  //aucun//  |
 |      ||| |      |||
-^  //Note: All options are optional, and left to its own devices the plugin will default to \\ a long, boring, 1-column list... so you might want to take charge!//  |||| +^  //Note : Toutes les options sont optionnelles et, laissé à lui-même, le plugin va se rabattre sur \\ une longue, et très ennuyeuse, liste sur une colonne... donc ça vous intéressera peut-être de prendre les choses en main !//  ||||
-==== Sorting and Grouping ==== +
-A few pointers about sorting and grouping successfully.  Pagequery offers many sorting options, most of which are designed to be grouped.  So if you intend to group your list by its main headers then it makes the most sense to sort from the broadest category to the narrowest.  +
  
-For example: ''year => month => name''.  The sorting algorithm will first sort the list of pages by ''year'', then the pages within //each// year will be sorted by ''month'', and finally the pages within //each// month will be sorted by ''name''.  Sorting the other way around would not make much sense, as all names are unique: hence there would be nothing to "group"!+==== Trier et Regrouper ==== 
 +Quelques conseils pour trier et grouper avec succès : pagequery propose de très nombreuses options de tri, dont la plupart sont prévues pour pouvoir être regroupées. Donc si vous avez l'intention de grouper votre liste sur ses principaux en-têtes, il est plus intéressant de trier de la catégorie la plus large à la plus restreinte.
  
-If you grouped the above sort it would result in the following arrangement: +Par exemple : ''année => mois => nom''.  L'algorithme de tri va trier d'abord les pages par ''année'', puis à l'intérieur de //chaque// année par ''mois'', et enfin à l'intérieur de //chaque// mois par ''nom''. Trier dans l'autre sens ne serait pas très intéressant, car tous les noms sont uniques : donc il n'y aurait pas de "groupes" ! 
-  * Year + 
-    * Month +Si vous regroupez le tri ci-dessus, vous obtiendrez le résultat suivant : 
-      * Name +  * Année 
-      * Name +    * Mois 
-    * Month2 +      * Nom 
-      * Name +      * Nom 
-      * Name+    * Mois2 
 +      * Nom 
 +      * Nom
       * etc...       * etc...
  
-The basic rule is: __start with the least specific and work your way to the most specific options.__+La règle de base est : __commencez par l'option la moins spécifique et progressez vers la plus précise.__
  
  
-===== FAQ and Tips ===== +===== Trucs et astuces ===== 
-:?: I've added new pages but they do not show up in my nice new pagequery list.  Why? +:?: J'ai ajouté de nouvelles pages, mais elles n'apparaissent pas dans ma mâââââgnifique nouvelle liste pagequery. Pourquoi ?I've added new pages but they do not show up in my nice new pagequery list.  Why? 
-  * You need to turn off page caching for the page containing the list.  Put  <code> ~~NOCACHE~~ </code>  somewhere on the page and you should then see instant updates.+  * Il faut désactiver les caches pour la page contenant la liste. Ajoutez <code> ~~NOCACHE~~ </code> n'importe où dans la page, et vous devriez voir les mises à jour instantanément.
  
-:?: I have many default 'start' pages in my wiki and I don't want to see them when I list the contents of namespaces; how can I make them disappear? +:?: J'ai plein de pages 'start' que je ne veux pas voir quand je fait la liste du contenu des espaces de noms... 
-  * Just add the ''hidestart'' option.  Make sure that the //start// option in your configuration corresponds to the start page name you are using!+  * Utilisez l'option ''hidestart''. Et vérifiez que l'option //start// de votre configuration correspond bien aux noms de page start que vous utilisez !((Et lisez le tableau ci-dessus. C'était écrit dedans. Si, si, cherchez bien... :-P))
  
-:?: I would much rather see the page title instead of the page name.  How can I enable that? +:?: Je préfère voir le titre des pages plutôt que leur nom. C'est possible ? 
-  * Put the ''display=title'' option somewhere in your pagequery markup+  * Ajoutez l'option ''display=title'' quelque part dans votre pagequery.((Et lisez le tableau ! A quoi ça sert de faire une doc si personne ne la lit ? :-P))
  
-:?: After migrating my wiki contents to a new dokuwiki version, pagequery doesn't list any pages. Only after editing the pages, they show up in pagequery again. +:?: J'ai migré le contenu de mon wiki sur une nouvelle version de DokuWiki, et pagequery ne me ramène aucune page, ou seulement après que j'aie modifié les pages. 
-  * Use the [[plugin:searchindex|SearchIndex]] plugin to rebuild the index of your wiki, or make sure that you copy over the indexes as well as the content.  This problem has nothing to do with pagequery itself. +  * Utilisez le [[doku>plugin:searchindex|plugin SearchIndex]] pour reconstruire l'index de votre wiki, ou vérifiez que vous avez copié les index en même temps que le contenu.((Ceci n'a rien à voir avec pagequery.))
-===== Examples ===== +
-For example, if you want to list all the pages in a certain namespace by A-Z, the following should do the trick: +
-  {{pagequery>@namespace;fulltext;sort=a,name;group}}           [fulltext version] +
-Or: +
-  {{pagequery>@namespace *;sort=a,name;group;proper;cols=2}}    [pagename version: allows regex's]+
  
-This would retrieve results from @namespace only (as there is no other search query you would get all the pages), and the list would be sorted by the //first letter// ('sort=a') then alphabetically ('sort=name') within each letter.  The //group// option will then cause the list to be grouped by the first letter only (you cannot group by name as each one is unique). 
  
-If you wanted to see the results in 3 columns and to have the links in "Sentence Case" with no underscores, then add this:+===== Quelques exemples ===== 
 +  * Afficher toutes les pages d'un espace de nom par ordre alphabétique :
  
-  {{pagequery>@namespace *;sort=a,name;group;cols=3;proper}}+  {{pagequery>@namespace;fulltext;sort=a,name;group}}           [version texte entier]
      
-Another example, grouping by //year created//, then //month created//, then by //name//, in 2 columns, and displaying the real month name, plus having the links in "Sentence Case" with no underscores, and to top it off: a border around the table columns:+Ou : 
 + 
 +  {{pagequery>@namespace *;sort=a,name;group;proper;cols=2}}    [version nom de page : permet l'utilisation de regex] 
 + 
 +Ceci ramènera les résultats uniquement dans @namespace, et la liste sera triée alphabétiquement sur la //première lettre// ('sort=a'), puis alphabétiquement ('sort=name') à l'intérieur de chaque lettre. L'option //group// ne groupera que sur la première lettre (on ne peut pas grouper par nom, puisque chacun est unique). 
 + 
 +   * Pour voir le résultat sur 3 colonnes et avoir les liens en "Casse de phrase" sans soulignement : 
 + 
 +  {{pagequery>@namespace *;sort=a,name;group;cols=3;proper}} 
 + 
 +   * Grouper par //année// puis //mois de création//, et ensuite par //nom//, sur 2 colonnes, en affichant le vrai nom du mois, plus les liens en "Casse de phrase" sans soulignement, et pour couronner le tout : une bordure autour des colonnes du tableau :
  
   {{pagequery>@namespace *;sort=cyear,cmonth,name;group;spelldate;proper;cols=2;border}}   {{pagequery>@namespace *;sort=cyear,cmonth,name;group;spelldate;proper;cols=2;border}}
-   + 
-The same query, but now searching for pages contenting the word "help" (NOTE: ''fulltext'' means search in the page "content" not just its "name":+   * La même chose, mais en ne ramenant maintenant que les pages avec le mot "help" (NOTE : ''fulltext'' signifie qu'on cherche dans le contenu de la page, et pas seulement dans son nom) :
  
   {{pagequery>@namespace help;fulltext;sort=cyear,cmonth,name;group;spelldate;proper;cols=2}}   {{pagequery>@namespace help;fulltext;sort=cyear,cmonth,name;group;spelldate;proper;cols=2}}
-   
-**Update:** Namespaces are now supported when searching by pagename (pageid) only.  Use the same syntax as fulltext [[:search]], i.e. @namespace|^namespace.  I haven't provide support for relative namespaces yet.  In addition, you can use regular expressions when searching by pagename. 
  
-E.g. Search for all pages in the "drafts" namespace, listing only files beginning with a number, sorted by name:+   * Chercher toutes les pages de l'espace de nom "brouillon", en ne ramenant que les fichiers dont le nom commence par un nombre, et triés par nom :
  
-  {{pagequery>@drafts [0-9]+.*;sort=name}} +  {{pagequery>@brouillon [0-9]+.*;sort=name}} 
-   + 
-Or, all files in the "happy:go:lucky" namespace, sorted by year, then date created, in proper case, in 2 columns, and display the page's //title//, not the //name// in the listing:+   * Et si c'est dans l'espace de nom "happy:go:lucky", en triant par année puis date de création, dans la jolie casse, sur 2 colonnes, et en affichant le //titre// de la page plutôt que le //nom// :
  
   {{pagequery>@happy:go:lucky *;sort=cyear,cdate;group;proper;display={title};cols=2}}   {{pagequery>@happy:go:lucky *;sort=cyear,cdate;group;proper;display={title};cols=2}}
-   + 
-Hopefully these examples will help to understand the workings of pagequery.+
  
  
 {{tag>Wiki Syntaxe}} {{tag>Wiki Syntaxe}}
CC Attribution-Share Alike 4.0 International Driven by DokuWiki
fr/wikitools/syntaxe/pagequery.1436974555.txt.gz · Dernière modification : 2021/12/03 19:18 (modification externe)
Licences Mentions légales Accueil du site Contact