dwBiliki-0.1 is out!
Promised to share what I did to make a Bliki out of DokuWiki and WordPress. Here you are. dwBiliki-0.1 is out. As you have quickly guessed, d = DokuWiki and w = WordPress. See this and that for what motivated me to work on dwBliki.
dwBliki is a WordPress plugin that makes use of the WordPress plugin API. The API is a great feature from WP. It suffices all the needs to make dwBliki to work. I wished not to touch a single line of the DokuWiki code. I almost did with one exception - actually one line. See below (step 2).
Installation
- If you haven’t already, download, install and configure DokuWiki (2005-02-06 or up) and WordPress (tested only on 1.5). Make sure both are working individually.
- Here comes the single line hack in the DokuWiki code. Cd to /path/to/dokuwiki/install. Edit inc/common.php. Replace line 23
session_start();withif (!headers_sent()) session_start();The reason for this change is to suppress the “header has been sent” warning. The change seems harmless to DokuWiki when it’s run individually. Andreas Gohr, the DokuWiki author, has promised to make this change. See comments blow.
- Download the latest dwBiliki: .tar.gz or .zip. Extract to the WordPress plugins directory.
$ cd /path/to/wordpress/install
$ cd wp-content/plugins
$ tar xvfz dwbliki.latest.tar.gz
$ unzip dwbliki.latest.zip # (for .zip) - Configure dwBliki. Assume you are still in the WordPress plugins directory. Edit dwbliki/config.php. This is the only config file you need to take care. Follow the instructions in that file.
- Point your browser to your WordPress site admin page. Click on menu “Plugins”. After screen refreshed, you should be able to see dwBliki listed as a plugin. Activate it and click “View site”.
- If you have configured the DokuWiki path and relative url path correctly (in dwbliki/config.php), after you click “View site” and refresh the WordPress a few times, you should be able to see your Wiki pages in WordPress now.
- If you run into problems that you cannot resolve after trying, drop comments to this post.
A note
Please note that dwBliki-0.1 does not import your Wiki pages all at once. Instead it does a kind of lazy loading. Initially it only imports the starting page of your Wiki. It acts up on the Wiki links (a.k.a. “[[…]]”) in that page and maps them into WordPress posts. As you browse more pages, it maps more and eventually brings every Wiki page into WordPress.
Acknowledgment
A special word of gratitude is extended to the hardworking DokuWiki and WordPress teams.
Happy bliki’ing!