Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Use a githook to auto-generate sphinx documentation and dump it in your gh-pages before pushing

branch: master

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 bin
Octocat-spinner-32 source
Octocat-spinner-32 .gitignore
Octocat-spinner-32 Makefile
Octocat-spinner-32 README.md
README.md

sphinx-github-githook!

First:

My plan is to find a good way to auto-generate and push sphinx-generated documentation to github on pushes to master.

Issues so far:

  • pages.github.com doesn't like sphinx's underscored folders due to jekyll trying to process them.
  • the hook is so far EXTREMELY tempermental because it doesn't really have any way of dealing with unexpected behavior.
  • I think a lot of this can be mitigated by "priming" the gh-pages branch, so to speak.
  • the githook doesn't actually seem to be running, at least as a githook. Works okay as a stand-alone script.
  • I don't know RST.
Something went wrong with that request. Please try again.