Cluster Wiki

A PerlLanguage WikiEngine by BoLeuf, similar to QuickiWiki, except that it allows multiple wikis to run from the same code base. New wikis are defined by copying & customizing a generic gateway script that calls the main library wiki.lib, which handles the real work of serving/editing pages.

Included in the book TheWikiWay by BoLeuf and WardCunningham, but that version has munged line endings. A fixed version is downloadable from


Getting ClusterWiki running on a Windows box takes some work (figuring out path names, etc), but once it's configured it just keeps on running. Setting up additional wikis is a snap.

RCS note: on WindowsTwoThousand (and, I assume, WindowsNt/WindowsXp), you may have to run your Web server process as the same user who has the locks in RCS's ",v" files. If not, RCS could fail silently. This problem does not occur on WindowsNinetyFive, and doesn't always happen on Win2K. (This may be a problem with user/file permissions, rather than RCS or ClusterWiki itself.)

Alternate Text Formatting Rules

To take full advantage of ClusterWiki, you'll have to read TheWikiWay or the source code. Doing so reveals some alternate TextFormattingRules, as well as the way to delete a page.

Some formatting rules:

To delete a page on ClusterWiki, rename it to "KILLpageNOW".


Every time I want to add a feature to ClusterWiki -- e.g., the ability to use raw HTML -- a HappyCollision occurs. Also, it took just 47 lines to add support for GraphViz, GnuPlot, and LaTex. It's easy to extend this feature to other programs that take a text description and return an image.


EditText of this page (last edited January 4, 2007) or FindPage with title or text search