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 ~$ RELATIVE=1 make regenerate # only use RELATIVE for local dev
Then open the html files directly, or run a little server with:
~$ make serve # serve generated site at http://localhost:8000
When changes are looking good - commit them (including generated files).
~$ make html # for a single publish