https://master--suspicious-stonebraker-7d2d21.netlify.app/tags/sphinx/ Recent content in Sphinx on Nikhil's blog Hugo -- gohugo.io en-US Sat, 25 Aug 2012 18:15:00 +0000 https://master--suspicious-stonebraker-7d2d21.netlify.app/post/2012/automatic-github-pages-generation-from/ Sat, 25 Aug 2012 18:15:00 +0000 https://master--suspicious-stonebraker-7d2d21.netlify.app/post/2012/automatic-github-pages-generation-from/ Sphinx is a very common documentation tool which gobbles up ReStructuredText and other free-form markup formats and outputs great HTML, PDF and other formats. It is meant for reference manuals and API documentation due to its good integration with source code (especially Python). The libuv book is written using Sphinx so that it looks so good with minimum effort. Sphinx uses make to generate the HTML, which is great. The only problem is that deploying this to Github Pages requires multiple commands to switch branches to gh-pages, pull in the source text, then cleanup the working copy and switch back to master.