make output from restructured text generator useable
Merge pull request #43 from tychoish/rst-fixes

Clean up Restructured Text support.
Merge remote-tracking branch 'refs/remotes/parent/master' into new-theme