Jede Software enthält Fehler. Wir geben unser Bestes aber Fehler passieren. Diese Seite unterstützt dabei diese zu melden und damit unsere Entwicklung zu unterstützen.

Bevor Sie einen Fehler melden, stellen Sie bitte sicher, dass es sich wirklich um solchen handelt. Vielleicht ist es aus irgendeinem Grund gewünschtes Verhalten? Oder es gibt eine Einstellung, die Sie setzen können.

Außerdem sollten Sie vorher im Forum (en) nachsehen, ob andere das selbe Problem haben. Vielleicht wird dort auch bereits eine Möglichkeit angegeben, das Problem zu beheben.

Im Zweifel legen Sie einfach einen Fehlerbericht (en: Bug Report) an. Wir können ihn immernoch schließen, sollte sich rausstellen, dass es sich nicht um einen Fehler handelt.

Alle DokuWiki Fehler sollten in unserem Bug Tracker gelistet sein. Fehler in Erweiterungen (en: Plugins) und Vorlagen (en: Templates) benutzen ihre eigenen Bug Tracker. Sie finden den Link auf der jeweiligen Dokumentationsseite.

Benutzen Sie die Suche um zu überprüfen ob Ihr Problem bereits gemeldet wurde. Bitte durchsuchen Sie auch die bereits geschlossenen Fehlerberichte. Ihr Fehler könnte für die nächste DokuWiki Version bereits behoben sein.

Wenn ihr Fehler bereits gemeldet wurde überprüfen Sie ob die zusätzliche Informationen liefern können, um das Problem zu beheben. Im Folgenden erfahren Sie wie das geht:

Wie oben bereits erwähnt sollen DokuWiki Fehler hier gemeldet werden. Dafür benötigen Sie einen GitHub Benutzerkonto. Bitte melden Sie keine Bugs irgendwo anders (IRC, Twitter, Forum).

Der Bug Tracker von GitHub ist der einzige Ort um Fehler zu melden. Nochmal: Melden Sie Fehler in Erweiterungen und Vorlagen in deren jeweiligen eigenen Bug Trackern.

Wenn Sie einen Fehler melden, sollten Sie versuchen so viel Informationen wie möglich zu liefern. Sie helfen damit den Entwicklern das Problem zu beheben.

Beispielsweise sollten/können Sie folgenden Informationen liefern:

• DokuWiki Version
• Betriebssystem auf Ihrem Server sowie Ihrem Client
• Welchen Webserver benutzen Sie?
• Welche PHP Version benutzen Sie?
• In welchem Browser tritt das Problem auf? (Versuchen Sie mehrere)
• Alles was speziell ist an Ihrer Installation (Erweiterungen, Vorlagen, Authentifizierungsbackends, Netzwerkeinstellungen, usw. )
• Wie genau lässt sich das Problem reproduzieren?
• Bildschirmfotos (en: Screenshots)
• Was haben Sie versucht um das Problem zu beheben? Was waren die Ergebnisse?

Es ist besonders wichtig dass Sie die exakten Fehlermeldungen mitliefern. Versuchen Sie die Logs aus dem Webserver und der Javascript Konsole mitzuliefern. (Siehe unten)

Bitte lesen Sie How to Report Bugs Effectively (en) um zu erfahren wie Sie einen nützlichen Fehlerbericht anfertigen.

Wie oben erwähnt brauchen DokuWiki Entwickler sehr detailierte Fehlermeldungen um ein Problem zu untersuchen. Manchmal werden die benötigten Fehlermeldungen direkt im DokuWiki angezeigt, aber manchmal auch nicht. In diesen Fällen können sie folgenden Optionen nutzen:

Immer wenn etwas fehlschlägt wird PHP Ihre Anfrage nicht richtig bearbeiten. Normalerweise resultiert das in einer leeren oder nur teilweise angezeigten Seite (en: Blankpage).

In all diesen Fällen wird PHP einen Fehlermeldung in eine Logdatei schreiben. Wo dieses Logdatei liegt ist unterschiedlich je nach verwendetem System. Auf manchen System werden Fehlermeldungen in die Logdatei des Webserver geschrieben, in anderen in die globale Logdatei oder eine spezifische PHP Logdatei. Wohin geloggt wird kann mittels der error_log (en) Direktive in der Datei php.ini eingestellt werden.

Typische Pfade für Logdateien:

• /var/log/apache2/error.log
• /var/log/apache/error.log
• /var/log/httpd/error.log
• /var/log/apache2/error.log
• /var/log/syslog

Wenn Sie einen gehosteten Server verwenden fragen Sie am besten Ihren Provider wo Sie die Logdatei finden. Wenn Sie keinen Zugang zur Datei php.ini haben und die Logdatei nicht finden können, versuchen die das folgenden zu Ihrer .htaccess Datei in Ihrem DokuWiki Wurzelverzeichnis hinzuzufügen:

php_value display_errors 1
php_value display_startup_errors 1

Das sendet Fehlermeldungen an Ihren Browser.

Manchmal gehen Dinge auch client-seitig (in Ihrem Browser) kaputt. Um das herauszufinden brauchen Sie Zugang zu der JavaScript Konsole ihres Browsers. Das erreichen Sie über folgende Tastenkombinationen

Wenn Sie eine Fehlermeldung in Ihrer Konsole sehen (normalweise in rot dargestellt) gehen Sie in Ihren Konfigurationsmanager (en) und deaktivieren Sie die "compress" Einstellung (en). Laden Sie die Seite neu und überprüfen Sie die Konsole erneut auf Fehlermeldungen.

Wenn Sie Fehlermeldungen in der Konsole sehen sollten Sie diese immer in Ihren Fehlerbericht einfügen. Bevorzugt diejenigen, die bereits ohne die compress Einstellung angezeigt wurden. Manchmal werden Fehlermeldungen nur mit der compress Einstellung angezeigt, in diesem Fall senden Sie uns diese Fehlermeldungen.

• GitHub actions triggered on forks von dregad (2024-04-11 18:31)
• DokuWiki can't be opened von pelayojove (2024-04-11 10:44)
• RFC: Official Docker Image von splitbrain (2024-04-10 13:12)
• New line in text should be rendered as such and not appended to the line von D267-dev (2024-04-05 18:24)
• Automatically set the release date of bundled plugins to match that of DokuWiki von dregad (2024-04-04 12:29)
• Kaos 55.1 - E_WARNING: Undefined array key 0 von Zweihorn (2024-03-29 20:54)
• Media Manager error with Release 2024-02-06a "Kaos" & Bootstrap3 von Calistenie (2024-03-29 11:53)
• Portrait Images not displaying von POpus (2024-03-28 22:31)