doc/plugins/404.mdwn

   1 [[!template id=plugin name=404 author="[[Simon_McVittie|smcv]]"]]
   2 [[!tag type/web]]
   3
   4 This plugin lets you use the IkiWiki CGI script as an Apache 404 handler,
   5 to give the behaviour of various other wiki engines where visiting a
   6 nonexistent page provides you with a link to create it.
   7
   8 To achieve this, put something like this in the wiki's Apache configuration
   9 file:
  10
  11     ErrorDocument 404 /ikiwiki.cgi
  12
  13 (The path here needs to be whatever the path is to the ikiwiki.cgi from
  14 the root of your web server.)
  15
  16 This plugin might also be useful on some non-Apache web servers, if they provide the
  17 `REDIRECT_STATUS` and `REDIRECT_URL` environment variables to their 404 handlers.
  18 `REDIRECT_STATUS` should be `404` and `REDIRECT_URL` should be the path
  19 part of the URL (for instance it would be `/plugins/404/` if this page was missing).
  20
  21 If you would like help with adapting this plugin for a different web server,
  22 you will need to provide the output of
  23 [[this 404 handler|forum/nginx:_404_plugin_not_working#comment-6b1607f7961d2873517d4780f56ac3ad]].