====== DokuWiki Fehlerberichte ====== 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. ===== Sicherstellen, dass es ein Fehler ist ===== Bevor Sie einen Fehler melden, stellen Sie bitte sicher, dass es sich wirklich um einen solchen handelt. Vielleicht ist es aus irgendeinem Grund gewünschtes Verhalten? Oder es gibt eine [[config|Einstellung]], die Sie setzen können. Außerdem sollten Sie vorher im [[https://forum.dokuwiki.org/|Forum]] 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. ==== Überprüfen sie ob das Problem bereits gemeldet wurde ==== Alle DokuWiki Fehler sollten in unserem [[https://github.com/dokuwiki/dokuwiki/issues|Bug Tracker]] gelistet sein. 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 Sie zusätzliche Informationen liefern können, um das Problem zu beheben. Im Folgenden erfahren Sie wie das geht: ==== Einen Fehler melden ==== Wie oben bereits erwähnt sollen DokuWiki Fehler [[https://github.com/dokuwiki/dokuwiki/issues|hier]] gemeldet werden. Dafür benötigen Sie einen [[https://github.com/|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 [[http://www.chiark.greenend.org.uk/~sgtatham/bugs.html|How to Report Bugs Effectively (en)]] um zu erfahren wie Sie einen nützlichen Fehlerbericht anfertigen. ==== Zusätzliche Informationen erhalten ==== 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: === Server/PHP Fehlermeldungen === Immer wenn etwas fehlschlägt wird PHP Ihre Anfrage nicht richtig bearbeiten. Normalerweise resultiert das in einer leeren oder nur teilweise angezeigten Seite ([[faq:blankpage|Blankpage (en)]]). 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 [[https://secure.php.net/error_log|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. Eine andere Möglichkeit ist die [[plugin:showphperrors|showphperrors]] Erweiterung. In einigen Fällen zeigt es die PHP Fehlermeldungen im Browser an. === JavaScript Konsole === 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 ^ Browser ^ Windows/Linux ^ Mac ^ | Chrome | ''Strg''+''Shift''+''J'' | ''Cmd'' + ''Opt'' + ''J'' | | Firefox | ''Strg''+''Shift''+''K'' | ''Cmd'' + ''Opt'' + ''J'' | | Internet Explorer | ''F12'', dann auf den Konsolen Tab klicken | | Safari | | ''Cmd'' + ''Opt'' + ''C'' | Wenn Sie eine Fehlermeldung in Ihrer Konsole sehen (normalweise in rot dargestellt) gehen Sie in Ihren [[plugin:config|Konfigurationsmanager (en)]] und deaktivieren Sie die [[config:compress|"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. ==== Letzte angelegte Fehlerberichte ==== [[https://feeds.feedburner.com/dokuwiki-recently-opened-tasks|{{https://raw.githubusercontent.com/legacy-icons/famfamfam-silk/master/dist/png/feed.png?16x16&recache |Subscribe to ‘DokuWiki: Recently Opened Tasks’ by RSS}}]] {{rss>https://feeds.feedburner.com/dokuwiki-recently-opened-tasks date author}}