Differences

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

--- config:basedir [2009-01-01 13:40] – ach
+++ config:basedir [2012-11-27 22:43] (current) – layouting Klap-in
@@ Line 1: / Line 1: @@
 ====== Configuration Setting: basedir ======
-Usually DokuWiki can detect the directory that it is installed in on its own. But sometimes this does not work for various reasons.  If DokuWiki does not seem to function properly and cannot find things such as images for its web pages, you can set the directory here.
+Path part of dokuwiki URL - blank for autodetect
-The path you should set here, is the path from the server root to your DokuWiki installation. Eg. if your wiki is available at ''%%http://www.yourserver.com/dokuwiki/%%'' you should set basedir to ''/dokuwiki/''. Be sure to have a leading and a trailing slash!
   * Type: String
-  * Default:
+  * Default: ''''
+Usually DokuWiki can detect the full URL it is available at on its own (autodetect). But sometimes this does not work for various reasons.  If DokuWiki does not seem to function properly and cannot find things such as images for its web pages, you can set the path here.
+Please, note that despite its name, this option is only vaguely related to files and directory. In fact, it is the path part of the [[wp>URL]] that leads to your DokuWiki installation. It frequently happens that the path part of the URL is also the relative directory from the web server root to the DokuWiki installation directory, hence the name.
+If your DokuWiki is located at ''%%http://www.someserver.org%%**/dokuwiki/**'',\\ you are likely to set this option to ''**/dokuwiki/**''.  Be sure to have a leading and a trailing slash!
+If your DokuWiki installation is located directly inside the server root or a subdomain like\\
+''%%http://www.subdomain.yourdomain.com%%'' you should set the basedir to ''/'' a **single** slash.
+The general rule is : If your DokuWiki is located at ''%%http://something.org%%**/whatever**'', you are likely to set this option to ''**/whatever/**''.  Be sure to have a leading and a trailing slash!
+{{:config:danger.png  }} **Danger**: Changing this option could make your wiki and the configuration menu inaccessible.
 ===== See also =====
@@ Line 13: / Line 23: @@
   * [[:config:|Configuring DokuWiki]]
   * [[config:baseurl]]
+  * [[config:savedir]]