shithub: werc

ref: 71565c1d5b70ea052515cd2efaa110c6d55c8bf9
dir: /sites/werc.cat-v.org/apps/dirdir/index.md/

View raw version
DirDir - A directory-oriented WikiWiki
======================================

DirDir is the next generation [diri wiki](http://repo.cat-v.org/diri/), now implemented on top of werc and
taking advantage of its user, site management frameworks and other
infrastructure.  

Features
--------

DirDir is still somewhat experimental, but already all features diri had, plus some extras thanks to werc's power:

    * Hierarchical organization.
    * Markdown formatting.
    * Easily customizable templates
    * Simple and fine grained user permisions system.
    * Completely database free.
    * All needed to setup diridiri is to set a flag in your _werc/config file.
    * Automatically wiki-fy existing werc documents.
    * Implemented in about two dozen lines of rc scripts.


Documentation
-------------

Just login, go to any page, and click the `Edit` button.

To create a new page, go to the address where you want to create the new page, click `Edit`, enter the initial contents, `Save`, and you are done.


Status
------

Mostly usable, all basic features already implemented in the latest werc source
tree. 


TODO
----

* Do some markdown preprocessing, for example: `[[Foo Bar]]` -> `[Foo Bar](foo-bar)`


About the name
--------------

DirDir is a pun on its predecessor diri and WikiWiki, and [Dirdir is also the title of a novel](http://www.amazon.com/gp/product/0879974788?ie=UTF8&tag=catv-20&linkCode=as2&camp=1789&creative=390957&creativeASIN=0879974788) by science fiction and literature grand master [Jack Vance](http://www.amazon.com/gp/redirect.html?ie=UTF8&location=http%3A%2F%2Fwww.amazon.com%2Fs%3Fie%3DUTF8%26redirect%3Dtrue%26search-type%3Dss%26index%3Dbooks%26ref%3Dntt%255Fathr%255Fdp%255Fsr%255F1%26field-author%3DJack%2520Vance&tag=catv-20&linkCode=ur2&camp=1789&creative=39095).