Wenn ich im Suchfeld innerhalb von DokuWiki nach einem Begriff suche, erscheint entweder keine Seite als Suchergebnis oder einige Seiten, aber nicht alle, in denen der Suchbegriff enthalten ist. Was kann ich machen, damit wieder alle Seiten, die den Suchbegriff enthalten, im Suchergebnis erscheinen?

DokuWiki benutzt einen Suchindex um eine Volltextsuche bereitzustellen. Da die Indizierung einer Seite einige Zeit in Anspruch nimmt, wird dies während des Speicherns der Seite durchgeführt, sondern immer dann, wenn ein Benutzer die Seite aufruft und die Seite betrachtet. Der Indizierungsvorgang findet währenddessen im Hintergrund statt.

Um Beschädigungen am Index zu vermeiden, darf der Index immer nur um die Inhalte einer Seite ergänzt werden. Für alle anderen Seiten ist der Index in diesem Moment gesperrt. Dadurch kann es dazu kommen, dass DokuWikis die von vielen Nutzern gleichzeitig besucht werden, neue Seiten erst nach einiger Zeit in den Index aufnehmen.

Der Indizierungsprozess wird von einem kleinen Bild ausgelöst, welches in das Template eingebunden ist und das Indizierungsprogramm aufruft. Bei der Verwendung eines Drittanbieter-Templates kann es vorkommen, dass der Einbau dieser „Web-Wanze“ vergessen wurde. Sollte die Indizierung mit Ihrem Template nicht funktionieren, können Sie die Template-Datei main.php (englisch) überprüfen.

Einige Werbe-Blocker blockieren die „Web-Wanze“ in der Annahme, das diese zur Verfolgung der Besucher eingesetzt würde. Dadurch wird jedoch auch verhindert, dass der Index von DokuWiki aktualisiert wird. Hinweis: DokuWiki verwendet diese Funktion nicht, um Besucher zu verfolgen.

Wenn sichergestellt ist, dass die „Web-Wanze“ richtig eingebunden ist und noch immer keine Suchergebnisse erscheinen, sollte geprüft werden, ob der manuelle Aufruf der „Web-Wanze“ über http://yourwiki.com/dokuwiki/lib/exe/taskrunner.php?id=wiki:syntax einen Fehler ausgibt. Wenn alles richtig funktioniert sollte ein 1×1 Pixel großes transparentes Bild zurückgegeben werden. Funktioniert dieser Aufruf nicht, probieren Sie den erweiterten Aufruf im Debug-Modus aus. Gehen Sie dazu wie folgt vor: Aktivieren Sie den Debug-Modus in der Konfiguration unter debugging. Rufen Sie dann die URL http://yourwiki.com/dokuwiki/lib/exe/indexer.php?id=wiki:syntax&debug=1 auf. Hinweis: In beiden Fällen kann es vorkommen, dass Sie die Seite nicht aufrufen können, weil die Verzeichnisberechtigungen eingeschränkt sind.

Wird der Microsoft IIS mit PHP als CGI verwendet, so muss die Option broken_iua aktiviert werden, damit die Indizierung funktioniert.

Manchmal ist es auch nötig den Index manuell zu erstellen. Beispiel: Sie haben neue Seiten extern erstellt und per FTP in einen Namensraum kopiert oder der Suchindex funktioniert aus anderen Gründen nicht mehr. In diesen Fällen erstellen Sie den Index neu, indem Sie das Kommandozeilenwerkzeug indexer.php nutzen. Alternativ dazu können Sie auch das Plugin searchindex (englisch) installieren und danach über die Admin-Konsole den Befehl „Suchindex Manager“ ausführen.