Generate gh-pages with sphinx

Generate gh-pages

$ cd repo
$ git checkout --orphan gh-pages
$ git rm -rf .
$ echo "First commit" > index.html
$ git add .
$ git commit -m "Just to create the branch."
$ git push origin gh-pages

Run sphinx-quickstart

$ git checkout master
$ sphinx-quickstart # in second option you should say yes

Add build target

Add below in Makefile.

GH_PAGES_SOURCES = source code wiki Makefile

...

gh-pages:
    git checkout gh-pages
    rm -rf build _sources _static
    git checkout master $(GH_PAGES_SOURCES)
    git reset HEAD
    make html
    mv -fv build/html/* ./
    rm -rf $(GH_PAGES_SOURCES) build
    git add -A
    git ci -m "Generated gh-pages for `git log master -1 --pretty=short --abbrev-commit`" && git push origin gh-pages ; git checkout master

Add documents

$ vim source/expert_python.rst
$ make gh-pages

Reference