Différences

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

--- fr:wikitools:syntaxe:pagequery [2015/07/15 19:23] – Lyne
+++ fr:wikitools:syntaxe:pagequery [2015/07/17 16:32] – Relecture - suite Lyne
@@ Ligne 1: / Ligne 1: @@
-====== Index et recherche de pages ======
+====== Index et recherches de pages ======
 <WRAP center round todo 60%>
-Traduction à terminer
+Traduction à relire pour corriger les coquilles et compléter ce qui n'est éventuellement pas clair.
 </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 :
@@ Ligne 18: / Ligne 18: @@
 ===== 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>}}
-Ou, plus compliqué :
+Ou, plus compliquée :
   {{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}}
-**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>
 {{pagequery>query;
@@ Ligne 52: / Ligne 52: @@
 ^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.//  |||
-|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//  |
+|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''  |  |
-^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//  |
+^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 :     ||||
-|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''  |  |
 |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''  |  |
 |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''  |  |
 |creator            |Par auteur de page |''sort=creator''  |  |
@@ Ligne 86: / Ligne 86: @@
 |        |Seulement jusqu'à une date donnée |''filter=mdate:%%->%%24.12.2012''  ||
 |        |Seulement les trois derniers mois |''filter=mdate:3 months ago%%->%%''  ||
-^group   |Affiche un en-tête de groupe pour chaque changement dans la clé de tri.((Pour une explication plus détailler des regroupements, voir la note après ce tableau)) |''group''  |  //non groupé//  |
+^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é//  |
-|        |Par exemple, si vous avez trié par [myear] (c'est-à-dire année de modification) alors l'entête du groupe sera \\ inséré à chaque fois que l'année change (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...)  |||
 |        |Les espaces de noms sont groupés par tous les sous-espaces de noms jusqu'à la limite ''maxns''((voir ci-dessous)) |||
 |        |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) ) |||
@@ Ligne 115: / Ligne 115: @@
 |        |<format>: l'un des formats listés ci-dessous : //inline, plain, quoted//  |||
 |        |<count>: pour afficher les premiers <count> objets dans la liste avec un aperçu ||  //tout//  |
-|        |<extent>: peut être un choix entre les [c]aractères, [w]mots, [l]inges, ou [~]<s'arrêter à>\\ par exemple : c? = ? caractères, w? = ? wmots, l? = ? lignes, ~? = chercher jusqu'au caractère/texte/symbole ? ||  //tout//  |
+|        |<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...
-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}}
-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}}
-**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}}
-Hopefully these examples will help to understand the workings of pagequery.
 {{tag>Wiki Syntaxe}}