codox を使った GitHub へのもう少し手抜きな API doc 公開方法メモ
GitHub へ API doc を deploy する方法としては既に codox の HowTo としてもあるんだが、ここではもう少し手抜きな方法をメモしておく。GitHub Pages となるリポジトリは既に作っているものとする。
- lein doc してできた doc フォルダを普通に git commit&push
- codox でドキュメント作ってるプロジェクトの GitHub リモートリポジトリで gh-pages の名前のブランチを切る
- どこでやるかは公式の
Create a gh-pages branch
参照
- どこでやるかは公式の
- 10 分ほど待つ
- http://your-account.github.io/your-project/doc/ にアクセス
後はプロジェクトリポジトリの README.md とか適当な所にリンクを張れば終了。
これだけ。API doc の URL がプロジェクト名直下でないとヤダとかでなければ Deploying to GitHub Pages に書かれているようなコマンドライン打つ必要が無い分だけちょっと楽。
git とコマンドライン少し詳しければこの手順取らなくてもバッチなりシェルスクリプトなりで 対応可能かもしれんけどまあ一つの方法として参考になれば。