Tagged: wp-dokuwiki

WP-Dokuwiki development update

I’ve decided to move the development of WP-Dokuwiki over to the official [[http://dev.wp-plugins.org/ | WordPress plugins repository]]. Why did I do this? [[http://dev.wp-plugins.org/wiki/GetHosted|This page]] explains it all.

The source for the plugin can now be found at [[http://dev.wp-plugins.org/browser/wp-dokuwiki/]]. Please use the [[http://dev.wp-plugins.org/newticket|bug tracker]] to for bugs. If you want to test the bleeding edge code, you can track the trunk:

$ cd /path/to/wp-content/plugins
$ svn co http://svn.wp-plugins.org/wp-dokuwiki/trunk/wp-dokuwiki

I will continue to host the tar-balls for each version. Meanwhile you can always download the plugin directly from dev.wp-plugins.org, or get a Zip file from [[http://redalt.com/External/plugins.php|RedAlt's WordPress plugin download interface]].

WP Dokuwiki 0.3

A new release is out! Grab it [[http://floatingsun.net/code/wp-dokuwiki-0.3.tar.bz2|here]]. More details on installation and usage available from the [[http://floatingsun.net/blog/code/wp-dokuwiki/|plugin page]]. This release has some **major changes** so I highly recommend upgrading. Here’s a quick summary of changes:

* Updated the plugin to the latest version of Dokuwiki (2006-03-09). Look at the [[http://wiki.splitbrain.org/wiki:changes|ChangeLog]] to see what all has changed. This is a significantly improvement over the last release of Dokuwiki, so you get all those niceties in your plugin as well.
* Added support for the [[http://wiki.splitbrain.org/plugin:google_maps|Google Maps]] plugin. So now you can have pretty google maps in your posts/pages.
* Added support for the [[http://wiki.splitbrain.org/plugin:boxes|Boxes]] plugin. This plugin is really flexible, and you can easily define your own box types.
* I’ve removed the [[http://wiki.splitbrain.org/plugin:note|Note plugin]], since I think the functionality of the Boxes plugin supercedes that of the Note plugin. Don’t worry, you can still get all those pretty boxes. Instead of using ”note classic” and ”note important”, you can now do ”box note” and ”box important”.

Also, I’ve added a demo [[http://floatingsun.net/blog/code/wp-dokuwiki/test-page/|test page]] to showcase and test all of the functionality available in the plugin. So go ahead and take a peek.


WP-Dokuwiki 0.2

This is a major release, with some new features and bug fixes.

New Features:
* Support for multiple wiki tags.
* Enabled Javascript based toggling of ToC, as in Dokuwiki.
* Added answers.com interwiki link.
* Added acronym for SCM.
* Removed the template directory — this cuts down significantly on the size.
* Support for formatting of ‘urlextern’ links.

Get the tarball [[http://floatingsun.net/code/wp-dokuwiki-0.2.tar.bz2|here]].

Further details on installation, usage and older versions can be found on the [[http://floatingsun.net/blog/code/wp-dokuwiki|WP-Dokuwiki page]].


Ladies and gentlemen, I present to you my first WordPress plugin — [[http://floatingsun.net/blog/code/wp-dokuwiki|WP-Dokuwiki]]!!

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!

Ever since I moved to this new blog, I have been writing my posts in the excellent [[http://wiki.splitbrain.org/wiki:syntax|Dokuwiki markup]] enabled by the [[https://granny.homelinux.org/CryForHelp/?page_id=199|Dokuwiki markup plugin]] (that plugin is also currently [[http://dev.wp-plugins.org/browser/dokuwiki-markup/|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 [[http://dev.wp-plugins.org/ticket/249|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 [[http://wiki.splitbrain.org/wiki:dokuwiki|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 [[http://wiki.splitbrain.org/wiki:parser|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 [[http://wiki.splitbrain.org/wiki%3Aplugins|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 [[http://floatingsun.net/blog/code/wp-dokuwiki|WP-Dokuwiki]] page.