wamw Friday I/O 5日目です。
株式会社ワムウでは、毎週金曜日は興味がある事柄に取り組み、その成果を何らかの形でアウトプットする日としています。

概要

おかげさまで先日作成した suttang/sphinx-rtd が、一部地域でご好評頂いております。

ある案件でドキュメントを書くに際して、Sphinxで構築しようと思って作成し、それは無事に完了したんですが、使い終わっての反省点として下記が残りました。

3は置いといて、このダルいポイント1, 2を解決するために自動でビルド・ブラウザリロードするようにしました。

エディタの拡張機能とかで解決しようとも思ったんですが、ローカルに環境を作る必要がある、とかblockdiagビルドできないじゃん、とかそういう理由でgulpで構築。

作ったもの

上記リポジトリを クローン するなり zipでおｋ するなりします。
その後 npm install を行い、 npm run build:dev するだけです。

ゼロコンフィギュレーションなのでなかなか便利です。

git clone https://github.com/suttang/docker-sphinx-rtd-theme-auto-build
cd docker-sphinx-rtd-theme-auto-build
npm install
npm run build:dev

するだけです。
まるで魔法。

ワンライナーでドキュメントが構築できます。

git clone https://github.com/suttang/docker-sphinx-rtd-theme-auto-build && cd docker-sphinx-rtd-theme-auto-build && npm install && npm run build:dev

よかったら使ってみてください。