For one of my projects, python-weka-wrapper, I used pythonhosted.org approach for hosting my sphinx-generated documentation. However, pythonhosted.org was recently down with the documentation no longer accessible. Hence I decided to use the Pages feature from Github. Considering that the documentation doesn’t change very often, I decided to go for manual updates. Here is what I did:
git clone https://github.com/fracpete/python-weka-wrapper3.git python-weka-wrapper3.gh-pages cd python-weka-wrapper3.gh-pages git checkout --orphan gh-pages git rm -rf . <copy sphinx-generated files over from doc/build/html> touch .nojekyll git add -A git commit -a -m "added documentation" git push origin gh-pages
And, voilà, the documentation is served at http://fracpete.github.io/python-weka-wrapper/