La recherche se fait dans la boîte prévue à cet effet, en haut à droite pour le thème de DokuWiki installé par défaut.

Fondamentalement, DokuWiki effectue la recherche par un « ET » logique. Cela signifie que tous les mots que vous avez mis dans la requête seront utilisés. La recherche est insensible à la casse.

Les syntaxes concernant la recherche avancée de DokuWiki sont décrites ci-dessous. Toutes les syntaxes peuvent être combinées ensembles. Dans cette section, nous allons utiliser les crochets […] pour représenter les caractères saisis dans la requête.

Vous pouvez placer un signe moins - juste avant un mot-clé pour exclure de vos résultats de recherche les pages qui contiennent ce mot-clé. Par exemple, la requête [ dokuwiki -plugin ] trouvera les pages qui contiennent « DokuWiki » mais pas « plugin ».

Vous pouvez utiliser cette syntaxe - pas seulement pour un mot-clé, mais aussi pour tout autre type de recherche décrit ci-dessous.

Par exemple, vous pouvez utiliser la requête [ -"phrase à exclure" ] pour exclure des résultats les pages contenant la suite exacte de mot « phrase à exclure ».

Vous pouvez effectuer une correspondance partielle en préfixant ou suffixant un astérisque * à un mot. Par exemple, la recherche de [ wiki ] ne trouvera que des « wiki », mais la recherche de [ *wiki ] trouvera également « DokuWiki » (suffixe correspondant).

Vous pouvez également utiliser [ doku* ] (préfixe correspondant) et [ *okuwik* ] (correspondance partielle).

Notez que * n'est pas un « joker », vous ne pouvez pas l'utiliser dans un mot : la recherche [ doku*iki ] ne trouvera rien.

Vous pouvez rechercher des expressions exactes en mettant des guillemets droits (doubles quotes) autour d'un ensemble de mots, par exemple [ "installer dokuwiki" ].

Vous pouvez restreindre la recherche à certaines catégories. Pour cela, préfixez la catégorie d'un @ ou de ns:. Pour ne pas rechercher des pages au sein d'une catégorie, préfixez la de ^ ou de -ns:.

Par exemple, la requête [ dokuwiki @wiki ^wiki:docs ] trouvera les pages qui contiennent le mot « dokuwiki », sont situées dans la catégorie « wiki » mais pas dans la catégorie « wiki:docs ». La requête [ dokuwiki ns:wiki -ns:wiki:docs ] fera la même chose.

Par défaut, DokuWiki effectue un ET logique pour la recherche, mais vous pouvez également utiliser un OU logique à l'aide de | ou de OR comme séparateur des termes que vous recherchez. Par exemple, la requête [ plugin | template ] trouvera les pages contenant « plugin » ou « template ». La requête [ plugin or template ] fera la même chose. Vous pouvez utiliser OR comme alternative simple à la correspondance partielle (*), par exemple pour trouver des pages sur des personnes avec des variations orthographiques comme [ Frank | Franck ].

L'opérateur OU a une plus faible priorité que celle de l'opérateur ET. Autrement dit, la requête [ dokuwiki plugin | template ] peut être représentée comme [ (dokuwiki plugin) | template ], mais pas comme [ dokuwiki (plugin | template) ] en utilisant un groupement de syntaxe (décrit ci-dessous).

Si vous voulez restreindre votre recherche à une catégorie, vous devez grouper votre recherche avec “()”, sinon une recherche du type [plugin | template @plugin] se comportera comme [ (plugin) | (template @plugin)], c'est-à-dire recherchera “plugin” OU “template @plugin” dans toutes les catégories, et non ce que vous pouvez obtenir avec l'expression correcte (plugin | template) @plugin] soit “plugin” OU “template” dans l'espace de noms plugin.

Vous pouvez grouper des termes de recherche en entourant ces termes avec des parenthèses ( … ). Ayant la plus haute priorité, les parenthèses peuvent être utilisées pour forcer la priorité.

Par exemple, la requête [ dokuwiki -(plugin | @plugin) ] trouvera les pages qui contiennent le mot « DokuWiki » mais pas celles qui contiennent « plugin » ou qui sont dans la catégorie « plugin ».

Vous pouvez entrer le début d'un nom de page dans la case de recherche et attendre une demi-seconde. Dans la plupart des navigateurs modernes, vous verrez automatiquement une boîte listant les pages trouvées.

OpenSearch est une norme facilitant l'intégration dans votre navigateur de la fonction de recherche d'un site web. Il est pris en charge par tous les navigateurs web modernes. DokuWiki permet la recherche avec OpenSearch.

Voici comment ajouter à Firefox la recherche dans votre wiki (le procédé est probablement similaire dans d'autres navigateurs) :

1. ouvrez votre wiki dans le navigateur ;
2. cliquez sur la petite flèche à gauche de votre zone de recherche ;
3. choisissez Ajouter « DokuWiki » ¹⁾

La version actuelle de DokuWiki intègre un index pour effectuer des recherches très rapidement même sur de gros wikis. Pour pouvoir trouver quelque chose l'index doit être à jour. Les informations contenues dans une page sont intégrées dans l'index de recherche quand cette page est visualisée par un visiteur. Chaque page possède une image invisible, un Pixel_espion dont le chargement déclenche le processus de mise à jour de l'index en cas de nécessité ²⁾, c'est à dire si la date de modification de la page est plus récente que la date de modification du fichier d'index.

L'index est constitué de fichiers nommés page.idx, i[n].idx, et w[n].idx situés dans le dossier index. w[n].idx contient la liste de tous les mots (à l'exception des mots écartés) d'une longueur de n qui apparaissent sur les pages du wiki. Pour chaque ligne du fichier w[n].idx il y a une ligne dans le fichier i[n].idx correspondant qui contient des références de pages sous la forme pn*freq. pn est l'offset en ligne dans le fichier page.idx et freq indique à quelle fréquence le mot apparaît sur la page. Les références de plusieurs pages sont séparées par deux points.

Certains mots sont écartés de l'index. Le programme d'indexation utilise des fichiers spécifiques à chaque langue contenant une liste de mots très communs (comme l'article le en Français). Ces mots sont écartés de l'index, la recherche sur un tel mot ne retourne aucun résultat. Vous pouvez éditer le fichier stopwords.txt situé dans le dossier de la langue d'installation de DokuWiki : <dokuwiki>/inc/lang/<language>/stopwords.txt pour ajouter ou supprimer des mots qui ne sont pas indexés dans votre langue. Malheureusement, ces modifications sont perdues lors des mises à jour de DokuWiki.

Si vous faites une mise à jour d'une ancienne version de votre wiki sans index, vos recherches ne renverrons rien tant que l'index ne sera pas mis à jour. Vous pouvez mettre à jour l'index en visitant manuellement chaque page de votre wiki ou en installant l'extension searchindex qui le fera pour vous. Un script en ligne de commande est également fourni avec DokuWiki.

• Problème d'indexation (pour la recherche de pages)
• Paramètre de configuration: search_fragment
• Paramètre de configuration: search_nslimit
• Paramètre de configuration: readdircache
• Extensions avec l'étiquette "search"

• Mise à jour : — Digitalin 2018-10-28 20:05
• Mise à jour : — schplurtz 2023-11-29 05:38