WP-Dokuwiki

Ladies and gentlemen, I present to you my first Wordpress plugin – WP-Dokuwiki!!

<note important>
I have fixed a couple of important bugs (related to the path names) since the announcement. So make sure you are using the latest tarball!
</note>

Ever since I moved to this new blog, I have been writing my posts in the excellent Dokuwiki markup enabled by the Dokuwiki markup plugin (that plugin is also currently hosted on wp-plugins.org). The plugin was working very well for me, so why did I write my own you ask? Well couple of reasons actually:

• A while back, I discovered a severe bug in the plugin – it leaves a hanging unclosed tag in the generated content. Forget about balanced code, this is not even valid HTML! Trying to be a good user, I quickly reported the bug, and even submitted a patch to fix it. That was almost 6 months back. The patch has not been applied, and the plugin remains buggy. Of course I was using a fixed version locally.
• In the meantime, a new version of Dokuwiki was released. Apart from syntactical goodness and new features, this release had a very important feature – a vastly improved architecture. You have to look at the code to see what I mean, but just looking at the through documentation on the parser will give you some idea of what I mean. Infact, of all the wiki's I've used, Dokuwiki has been by far the most impressive and robust. I really like the neat architecture of the lexer, parser and the hooks for the plugins. It makes writing plugins for building your own syntax really easy (take a look at some of the available plugins). I was craving to use this new code for the markup plugin, instead of the earlier code. But dokuwiki-markup was not being maintained/developed, so I could not wait anymore.
• In constructing this plugin, I have tried to make minimal changes to the original dokuwiki code. In fact, I only had to modify 5 lines in ONE file in the original dokuwiki code. Of course I removed a lot of files from the distribution that I didn't need to make the plugin – I basically retained the parser and threw away everything else. And then I just wrote a wrapper around it that would invoked the parser and render the formatted text. The nice thing now is that when a new version of Dokuwiki comes out, I have to make minimal changes to make it work with my plugin.
• dokuwiki-markup requires manual configuration for installation – make symlinks to certain directories, copy over CSS rules by hand etc. WP-Dokuwiki on the other hand provides complete automated install – no extra manual configuration required!

I don't mean to bash on dokuwiki-markup – its a great plugin, one that introduced me to Dokuwiki in the first place, and for that I'm grateful. However, I do believe WP-Dokuwiki is a much better plugin, and since I'm eating my own dog food here (this site runs on WP-Dokuwiki), you can be sure I'll keep it updated

So give it a shot. Details on the plugin features, syntax support, and installation information can be found on the WP-Dokuwiki page.