Permalink
Switch branches/tags
Nothing to show
Find file
Fetching contributors…
Cannot retrieve contributors at this time
15 lines (10 sloc) 609 Bytes

#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.