Sphinx で Github pages する (sphinx-to-github の submodule ぶんどりから html を吐いて push するまで)
タイトル通りのことをする。
- アカウント名.github.com という名前のリポジトリを作る
- それcloneする
- cd アカウント名.github.com
- git submodule add git://github.com/michaeljones/sphinx-to-github
- いっぺんとりあえず git commit -m "added sphinx-to-github as submodule" && git push する
- sphinx-quickstart (全部適当にenter、なんかいれなきゃなんないのは適当に書いてenter)
- rm -rf _*
- conf.py の中を html_static_path = ['static'] と変更 アンド extensions = [ "sphinxtogithub" ] と変更 アンド 末尾にでも sphinx_to_github = True; sphinx_to_github_verbose = True と行追加
- Makefileの中を BUILDDIR = . と変更 アンド htmlターゲットの末尾の/htmlを削って ...$(BUILDDIR)で改行するように変更
- PYTHONPATH=./sphinx-to-github/sphinxtogithub make html
これでリポジトリのトップ下にhtmlが吐かれるんで全部pushする必要はないかもしれんが
git add -A && git commit -m "first commit" -a && git push
とするとなんかよーわからんが
となる。
以上