Sphinx

Built with Sphinx, a small tutorial about Sphinx.

What?

+--------+
|   rst  |+        +----------+
|  Files ||  ===>  |  Sphinx  |  ===>  HTML/PDF
+--------+|        +----------+
 +--------+

Installation

sudo pip install sphinx

Installing the development version of Sphinx is straight forward too.

sudo easy-install jinja  # <-- templating engine
wajig install mercurial  # <-- the version control system, sphinx developers use
checkouts=$HOME/checkouts  # <-- where we'll keep the checkout
mkdir -p $checkouts
cd $checkouts
hg clone http://bitbucket.org/birkenfeld/sphinx/
cd sphinx
sudo python setup.py install

Some resources

See also: