Setting up DokuWiki

DocuWiki is a nice simple Wiki software that doesn't require a database and is fairly simple and light weight. Here are some steps on how to get it set up on a Unix web server:

1. Download the latest package from here and extract the .tgz file in your home directory:
   
   tar -xzvf dokuwiki-yyyy-MM-DD.tgz
   
   From here on we'll assume that the package was extracted into ~/dokuwiki.
   
   
2. Move the extracted directory to a desired location in the web space:
   
   mv ~/dokuwiki ~/www/mywiki
   
   From here on we'll assume that the directory was moved to ~/www/mywiki.
   
   
3. Set the permissions by giving global write access to the following directories (yes this isn't ideal but then you'll have to have the web admin set up the permissions for you):
   
   chmod 0777 ~/www/mywiki/conf
   chmod -R 0777 ~/www/mywiki/data
   
   
4. Run the installer script by loading the page http://servername/mywiki/install.php. You may need to then change the permission of the file ~/dokuwiki/conf/local.php so that you can edit it in the proceeding steps:
   
   cp ~/dokuwiki/conf/local.php ~/dokuwiki/conf/local.php.cp
   mv -f ~/dokuwiki/conf/local.php.cp ~/dokuwiki/conf/local.php
   chmod 0666 ~/dokuwiki/conf/local.php
   
   
5. Perform the following steps to secure the install directories (details available here):
1. Create a dokuwiki directory outside of the www directory (e.g. ~/dokuwiki).
2. Move ~/www/mywiki/bin to ~/dokuwiki/bin.
3. Move ~/www/mywiki/data to ~/dokuwiki/data.
4. Add the following line to ~www/mywiki/conf/local.php:
   $conf['savedir']='~/dokuwiki/data'
   
5. Move ~/www/mywiki/conf to ~/dokuwiki/conf.
   
6. Create a file ~/dokuwiki/prepend.php containing the following lines:
   <?php
   define('DOKU_CONF','~/dokuwiki/conf/');
   
7. Add the following line to ~www/mywiki/.htaccess:
   php_value auto_prepend_file "~/dokuwiki/prepend.php"
   
8. Move ~/www/mywiki/inc to ~/dokuwiki/inc.
   
9. Add the following line to ~/dokuwiki/prepend.php:
   define('DOKU_INC','~/dokuwiki/');
   
10. Move ~/www/mywiki/lib to ~/dokuwiki/lib.
11. Create a symbolic link to the lib directory from the web directory:
    ln -s ~/dokuwiki/lib ~/www/mywiki/lib
12. To enable installation of plugins, change the permission of the plugins directory:
    chmod 077 ~/dokuwiki/lib/plugins
    
6. Go to http://servername/mywiki/, and log in as the administrator.
   
   
7. Install the PageMove plugin by clicking on the Admin button in the lower right corner, and then the "Manage Plugins" link, and enter the following URL into the URL textbox and click Download:
   
   http://www.isection.co.uk/lib/exe/fetch.php?id=start&cache=cache&media=pagemove.zip