2005-09-18 16:16:02 GMT
I've just installed DokuWiki as the engine of my mother's home page. Its content is expected to be edited for some weeks until it'll be ready. There are many things why DokuWiki rocks so much. My favorite features are:
- Very usable wikilanguage.
- Super clean stylesheet borrowed from Plone. Yeah!
- Simple, but usable design.
There are several (painful and boring) steps to install DokuWiki as the basis of your homepage and they are related to user account management and usability improvements. I wanna save you and myself from the pain of figuring this all out again in the future so here are the steps to make this stuff work:
- Make the source work on the platform: Sometimes it's not as easy as it might sound. My domain is hosted on http://ultraweb.hu. Unfortunately the paranoid sysadmins have decided to disable several critical PHP functions that DokuWiki happens to use extensively such as
realpath. In order to solve that problem one needs to hack DokuWiki by using a replacement function. Fortunately the PHP community has provided many of them and a fine implementation is made by <carlosreche at yahoo dot com> which can be downloaded from here. If you have the same problem, just copy it to every DokuWiki directories that has a file that needs
realpath, require_once it in them and replace the
realpath calls with
myrealpath. That's all.
- Manage user accounts: If you want DokuWiki as your home page engine, you should restrict its default permissions because you don't want allow anyone to edit it.
- Restrict visitors to only see, but not to edit the pages: In
1 and set
superuser to "
@admin". Below when I say "set the variable x to y" I mean this file. In
<dokuwiki_root>/conf/acl.auth.php you only need the following line:
"* @ALL 1".
- Register the users through the web interface.
- Change the passwords of the users and make them admin: Unfortunately DokuWiki doesn't provide an interface for that very basic feature so it needs to be done manually. This nifty script I've written will do the work if you use the default smd5 crypt method. Take its output and replace the second field in every line of
<dokuwiki_root>/conf/users.auth.php with it as well as the last field with "
- Disable user registrations: Since you don't want anyone to edit your page, set variable
- Allow inline HTML: DokuWiki has a rich and very usable markup language, but for several tasks (such as centering an object on the page) it's not enough. Thats when HTML comes handy. To use it, set the
htmlok variable to
- Set descriptive document headings: By default the heading of the document is their wikipath which is not very intuitive for most users. Because of that you should set
1 to display the title of the documents instead of their wikipath.
- Install a more usable template: A default DokuWiki installation has some usability deficiencies. The most apparent is feeling lost because no navigation bar is present. The other minor problem is that the title of the documents is located in the upper right corner rather than in the upper left. There is a awesome template that you should install to solve these problems.