DokuWiki

It's better when it's simple

User Tools

Site Tools


bugs

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
bugs [2015-08-22 13:46] – [Recently opened tasks] please change feed, Yahoo Pipes discontinued achbugs [2023-12-12 22:58] (current) Aleksandr
Line 5: Line 5:
 ===== Make sure it is a Bug ===== ===== Make sure it is a Bug =====
  
-Before you report something, try to research if the problem you encounter really is a bug. Maybe it is intended behavior for some reason? Maybe there's a [[config|setting]] you could tune?+Before you report something, try to research if the problem you encounter really is a bug. Maybe it is intended behavior for some reason? Maybe there's a [[:config|setting]] you could tune?
  
-You should also search the [[https://forum.dokuwiki.org|forum]] if people had the same problem before. Maybe there's a fix already?+You should also search the [[https://forum.dokuwiki.org/|forum]] if people had the same problem before. Maybe there's a fix already?
  
 However, if still in doubt, just open a bug report. We can always close it should it turn out to not be a bug. However, if still in doubt, just open a bug report. We can always close it should it turn out to not be a bug.
Line 13: Line 13:
 ===== Check if the problem is already reported ===== ===== Check if the problem is already reported =====
  
-All bugs should be reported in our bug tracker at GitHub located at: https://github.com/splitbrain/dokuwiki/issues+All DokuWiki bugs should be reported in our bug tracker at GitHub located at: [[https://github.com/dokuwiki/dokuwiki/issues]]. For bugs in plugins and templates use the plugin's own bugtracker --- you'll find a link to that on the plugin's documentation page.
  
-Use the search to check if your problem already has been reported. Also make sure you search through closed bugs as well - the bug might have been fixed already in development.+Use the search to check if your problem already has been reported. Also make sure you search through closed bugs as well --- the bug might have been fixed already in development.
  
 If the bug was reported already, check if you can provide additional information to aid fixing the bug. See below on how. If the bug was reported already, check if you can provide additional information to aid fixing the bug. See below on how.
Line 21: Line 21:
 ===== Report a Bug ===== ===== Report a Bug =====
  
-As mentioned above, bugs **have** to be reported at https://github.com/splitbrain/dokuwiki/issues. You will need a free GitHub account to do so. Please **do not** report bugs anywhere else (IRC, Twitter, Forum). The Bug Tracker at GitHub is the only canonical way to report a bug.+As mentioned above, DokuWiki bugs **have** to be reported at [[https://github.com/dokuwiki/dokuwiki/issues]]. You will need a free GitHub account to do so. Please **do not** report bugs anywhere else (IRC, Twitter, Forum). The Bug Tracker at GitHub is the only canonical way to report a bug. Again: report plugin bugs in the plugin's bug tracker.
  
 When reporting a bug you should try to include as much information as possible that helps developers with identifying the problem. When reporting a bug you should try to include as much information as possible that helps developers with identifying the problem.
Line 32: Line 32:
   * The used PHP version   * The used PHP version
   * The used browsers (try multiple)   * The used browsers (try multiple)
-  * Everything that's special about your setup (plugins, auth backends, weird network config, etc.)+  * Everything that's special about your setup (plugins, template, auth backends, weird network config, etc.)
   * Exact steps to reproduce the problem   * Exact steps to reproduce the problem
   * Screenshots   * Screenshots
 +  * What did you try to fix the problem and what where the exact results?
  
 It is especially important to gather exact error messages! See if you can find error logs from the web server and the JavaScript console (see below). It is especially important to gather exact error messages! See if you can find error logs from the web server and the JavaScript console (see below).
  
-Please also read [[http://www.chiark.greenend.org.uk/~sgtatham/bugs.html|How to Report Bugs Effectively]] for more tips on submitting useful bug reports.+Please also read [[https://www.chiark.greenend.org.uk/~sgtatham/bugs.html|How to Report Bugs Effectively]] for more tips on submitting useful bug reports.
  
 ===== How to obtain additional info ===== ===== How to obtain additional info =====
Line 52: Line 53:
 Typical locations are: Typical locations are:
  
-  * /var/log/apache2/error.log +  * ''/var/log/apache2/error.log'' 
-  * /var/log/apache/error.log +  * ''/var/log/apache/error.log'' 
-  * /var/log/httpd/error.log +  * ''/var/log/httpd/error.log'' 
-  * /var/log/syslog+  * ''/var/log/syslog''
  
-If you are on a hosted server, best ask your provider where to find that log.+If you are on a hosted server, best ask your provider where to find that log.  If you don't have access to ''php.ini'' and can't find the log file you could also try adding the following to the ''.htaccess'' file in your DokuWiki root folder: 
 + 
 +<code> 
 +php_value display_errors 1 
 +php_value display_startup_errors 1 
 +</code> 
 + 
 +That may send the error message to the browser. 
 + 
 +Another solution might be the [[plugin:showphperrors]] plugin, it could be able to show the error in the browser in some cases. 
 + 
 +==== DokuWiki Error logs ==== 
 + 
 +Since the Igor release (July 2022), DokuWiki logs also errors. Via admin interface you can use the [[plugin:LogViewer]]. If the LogViewer cannot reached, you can find the log files in your file system in ''[wiki_folder]/data/log/error/<date>.log''.
  
 ==== JavaScript Console log ==== ==== JavaScript Console log ====
Line 69: Line 83:
 | Safari  |                              | ''Cmd'' + ''Opt'' + ''C'' | | Safari  |                              | ''Cmd'' + ''Opt'' + ''C'' |
  
-If you see any errors (usually shown in red) in the console, go to your [[plugin:config|config manager]] and disable the [[config:compress|"compresssetting]]. Reload the page and check the JavaScript console for errors again+If you see any errors (usually shown in red) in the console, go to your [[plugin:config|config manager]] and disable the [[config:compress|compress” setting]]. Reload the page and check the JavaScript console for errors again.
- +
-If you find errors in the JavaScript console you should always attach them to your bug report. Preferably the ones found with the "compress" setting disabled. However, sometimes errors only show up with "compress enabled" - in that case send us these error messages.+
  
 +If you find errors in the JavaScript console you should always attach them to your bug report. Preferably the ones found with the "compress" setting disabled. However, sometimes errors only show up with "compress enabled" --- in that case send us these error messages.
  
 ===== Recently opened tasks ===== ===== Recently opened tasks =====
  
-{{rss>http://pipes.yahoo.com/pipes/pipe.run?_id=02bfefe73ba14054570ce82f1929e433&_render=rss&owner=splitbrain&repo=dokuwiki 1h date}} +[[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}}]] 
-FIXME Yahoo Pipes will be discontinued on 30 September 2015, please change the feed to something else by then.+ 
 +{{rss>https://feeds.feedburner.com/dokuwiki-recently-opened-tasks date author}} 
  
bugs.1440244013.txt.gz · Last modified: 2015-08-22 13:46 by ach

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki