読者です 読者をやめる 読者になる 読者になる

Sphinx で Github pages する (sphinx-to-github の submodule ぶんどりから html を吐いて push するまで)

タイトル通りのことをする。

  1. アカウント名.github.com という名前のリポジトリを作る
  2. それcloneする
  3. cd アカウント名.github.com
  4. git submodule add git://github.com/michaeljones/sphinx-to-github
  5. いっぺんとりあえず git commit -m "added sphinx-to-github as submodule" && git push する
  6. sphinx-quickstart (全部適当にenter、なんかいれなきゃなんないのは適当に書いてenter)
  7. rm -rf _*
  8. conf.py の中を html_static_path = ['static'] と変更 アンド extensions = [ "sphinxtogithub" ] と変更 アンド 末尾にでも sphinx_to_github = True; sphinx_to_github_verbose = True と行追加
  9. Makefileの中を BUILDDIR = . と変更 アンド htmlターゲットの末尾の/htmlを削って ...$(BUILDDIR)で改行するように変更
  10. PYTHONPATH=./sphinx-to-github/sphinxtogithub make html

これでリポジトリのトップ下にhtmlが吐かれるんで全部pushする必要はないかもしれんが

git add -A && git commit -m "first commit" -a && git push

とするとなんかよーわからんが

http://kozo2.github.com/

となる。
以上