github pages, sphinx

github pagesで数式を使いたいのでsphinxで作ったマニュアルのhtmlを置きたい。
基本的には、gh-pagesというbranchを作って、そこにファイルを置けば良い。sphinxは_imagesなどのディレクトリを作るけど、Pagesはそれを普通のファイルもしくはディレクトリと認識しない。それを解決するために、.nojekyllという空のファイルをrootディレクトリに置く必要がある。

Pagesに関するhelp
https://help.github.com/categories/20/articles
Manualのページの置き方
https://help.github.com/articles/creating-project-pages-manually
アンダースコアで始まるファイル名を使えるようにする
https://help.github.com/articles/files-that-start-with-an-underscore-are-missing

git, github使い方メモ

  • git push origin gh-pages
  • git pull origin gh-pages
  • git checkout gh-pages
  • git remote add origin git@github.com:atztogo/niggli.git