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 inscrits dans la requête.

Vous pouvez placer un tiret - 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 [ -"expression à exclure" ] pour exclure une expression.

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 américains (doubles quotes) autour d'un ensemble de mots, par exemple [ "installer dokuwiki" ].

Vous pouvez restreindre la recherche aux espaces de noms. Pour cela, préfixez l'espace de nom par @ ou par ns:. Pour ne pas rechercher des pages au sein d'un espace de noms, préfixez par ^ ou par -ns:.

Par exemple, la requête [ dokuwiki @wiki ^wiki:docs ] trouvera les pages qui contiennent le mot « dokuwiki », sont situées dans l'espace de noms « wiki » mais pas dans l'espace de noms « 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é 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 sur un espace de noms, 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 tous les espaces de noms, 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 l'espace de noms « 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 de la recherche d'un site web dans votre navigateur. Il est pris en charge par tous les navigateurs web modernes. DokuWiki permet la recherche avec OpenSearch.

Voici comment ajouter votre recherche wiki pour Firefox (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 très 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. Ainsi chaque page possède une image invisible (https://fr.wikipedia.org/wiki/Pixel_espion) qui appele le processus de mise à jour de l'index en cas de nécessité ²⁾.

L'index est constitué de 3 fichiers nommés respectivement index.idx, page.idx et word.idx situés dans le répertoire « cache ». w[n].idx contient une liste de tous les mots (à l'exception des mots listés dans stopwords.txt) d'une longueur de n qui apparaissent sur les pages wiki. Pour chaque ligne du fichier w[n].idx il y a une ligne dans le fichier correspondant i[n].idx qui contient des références de pages sous la forme pn*freq. pn est un numéro de ligne pour 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.

Les programmes d'indexation utilisent des fichiers spécifiques à chaque langue contenant une liste de mots très communs (comme l'article le en Français). La recherche sur un tel mot ne retourne aucun résultat. Vous pouvez éditer le fichier stopwords.txt situé dans le répertoire 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.

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"