Tips

Automatically Build

Auto-building Sphinx docs (thank you Jacob Kaplan-Moss):

$ pip install watchdog
$ watchmedo shell-command \
    --patterns="*.txt" \
    --ignore-pattern='_build/*' \
    --recursive \
    --command='make html'

For another way to automatically build your documentation, see ../../mercurial/hooks.

Single File

To convert a single file from rst to html, install Sphinx and run (Sphinx installs /usr/bin/rst2html):

rst2html wip.rst > ~/temp/wip.html