This is a custom theme for the Apache Aurora documentation to use the most wonderful mkdocs project for rendering html documentation.
This is an experiment to try and make contributing to Aurora's documentation an easier process.
First things first, you'll need a clone of the upstream aurora.git:
git clone https://git-wip-us.apache.org/repos/asf/aurora
You'll also need to install mkdocs:
pip install mkdocs
Check out aurora_theme into the root of the aurora git checkout.
cd aurora && git clone https:/SEJeff/aurora_theme
Ensure the configuration file, mkdocs.yml, is in the correct place:
ln -s aurora_theme/mkdocs.yml .
This is really cool, so what gives?
Currently, mkdocs doesn't support rendering README.md as the index page. Move docs/README.md to docs/index.md.
mv docs/{README,index}.md
The docs/README.md contains a link to ../CONTRIBUTING.md, which mkdocs doesn't appear to handle very well at the moment. This results in a broken link to the contributing documentation.
From the root of the aurora git checkout with aurora_theme setup start the mkdocs dev server.
mkdocs serve
Open up a browser to http://localhost:8000
Building the documentation is straightforward.
mkdocs build --clean