Makefile command & script for GitHub Pages

[minrk]

GitHub has support for a special gh-pages website repo. You can use it to host Sphinx docs, and a sphinxtogithub extension is included to resolve small naming conflicts between sphinx and GitHub's use of jekyll.

I wrote a script for pushing sphinx docs to GitHub, and added a gh-pages command to the Makefile, so simply running:

make gh-pages

will push the sphinx html docs to the gh-pages branch, which is accessible at <user_or_org>.github.com/. For example: http://minrk.github.com/ipython has the output of running that in my fork.

I know that with the current hosting, the official docs are frequently offline or at least super slow, so maybe this will help.

[ellisonbg]

This looks fantastic and I think we should definitely host our docs at the github site. It makes it much easier for people other than Fernando to update the docs. Most of these changes are being used by other projects so this one should go right in.