Saturday 29 October 2011

Dokuwiki Installation on CENTOS


 Dokuwiki is an excellent wiki software that can be installed very easily on a CentOS 5 server by following the steps below:



1. Introduction

After reading about several wikis, I decided to go with DokuWiki. One advantage I see is that it does not use a backend database. All the files are stored on the filesystem. Easy backup and portability. Can view the files even when the internet or server is down.


2. Download



wget http://www.splitbrain.org/_media/projects/dokuwiki/dokuwiki-2011-05-25a.tgz
cd /var/www/html
tar -zxvf dokuwiki-2011-05-25a.tgz 


3. Setting Permissions

cd dokuwiki-2007-06-26b
chown -R apache:apache /opt/yourinstallationdirectory/dokuwiki-data/
chown -R apache:apache conf
chown -R apache:apache lib/plugins

4. Access the Dokuwiki install page by going to http://localhost/dokuwiki/install.php

Wiki Name: LinuxWiki
Check "Enable ACL"
Super User: Pick a Name
Full Name: Give name here
E-mail: your e-mail address
Password: give hard password
Initial ACL Policy: Closed Wiki (read,upload,write for registered users only)

Delete the install.php file and continue to dokuwiki page at http://localhost/dokuwiki

5. Configuration

Now Login with the admin username and password

chown -R root:root conf
chown apache:apache conf
chown apache:apache ./conf/local.php
chown apache:apache conf/users.auth.php
chown apache:apache conf/acl.auth.php
 

Move the data directory to outside of the DocumentRoot to /opt/your_install_dir/dokuwiki-data

6. Customizing the configuration

How to disable open user registration: In the Configuration manager, there is a disable DokuWiki Actions Options. Select "Register" to disable Open Registration. You can use Disable DokuWiki Actions to disable some unwanted buttons, like Recent Changes, Index, etc..., but it will disable these buttons for Admin as well. There is a plugin to disable actions by Groups. Check it out. Deleting a Page: To delete a page, just edit that page and remove all the wiki text in that page. it deletes this page automatically. Uploading a Document: How to upload a document: Click the MediaManager icon in the Edit page section, which will open up media manager interface. It can be used to upload the files. To add a link to the uploaded files, put the file name within double curly braces as follows: e.g. {noformat}{{file1.pdf}}{noformat}

7. Some Issues & Fixes


In firefox, when you go back, it doesn't remember the scroll bar position. To fix this issue, add the following line to inc/actions.php file, right after the Content-Type: head on line 122:
$headers[] = 'Cache-Control: private, must-revalidate, max-age=0';
 

  



No comments:

Post a Comment