Differences

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

--- config:basedir [2012-11-26 11:17] – [Configuration Setting: basedir] removed irrelevant example. this setting is not about the server working dir 24.134.29.150
+++ config:basedir [2012-11-27 22:43] (current) – layouting Klap-in
@@ Line 1: / Line 1: @@
 ====== Configuration Setting: basedir ======
-Location of dokuwiki on server - blank for autodetect
+Path part of dokuwiki URL - blank for autodetect
   * Type: String
   * Default: ''''
-Usually DokuWiki can detect the directory that it is installed in 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 directory here.
+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.
-The path you should set here, is the path from the server root to your DokuWiki installation.
+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 wiki is available at\\
+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!
-''%%http://www.yourserver.com/dokuwiki/%%'' you are likely to set basedir 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.yourserver.com%%'' you should set the basedir to\\
+''%%http://www.subdomain.yourdomain.com%%'' you should set the basedir to ''/'' a **single** slash.
-''/'' 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.