What's that?

This Django application aims to have a really, really simple forge, using the well known (at least in the Python world) reST syntax.

It provide a simple way to store web page in your project repository.

By example, with this repository structure:

project1/
    README.rst
    www/
        index.rst
        somepage.rst

project2/
    TODO.rst
    www/
        index.rst

RstForge will build this page hierarchy:

/                           Index of all projects with a www/ folder

/project1/                  Page generated from project1/www/index.rst
/project1/somepage/         Page generated from project1/www/somepage.rst
/project1/code/README.rst   Page generated from part of source code

/project2/                  Page generated from project2/www/index.rst
/project2/code/TODO.rst

How to install

Just put the rstforge directory somewhere your Django site can find it. Refer rstforge in your master url file, like:

urlpatterns = patterns('',
    # all pages will be named like /forge/mypage/
    (r'^forge/', include('rstforge.urls')),
)

Then, set in your settings.py the REPO_DIR variable with the full path of the directory where are your repositories. That is!