We're using Pelican to generate static site. All source files are placed in the _src/
directory. Generated content is placed under root directory.
~$ virtualenv allura-site ~$ pip install pelican markdown
~$ cd _src
In two separate terminal windows run the following commands:
~$ make regenerate # watch source files and regenerate site ~$ make serve # serve generated site at http://localhost:8000
When changes are looking good - commit them (including generated files).