先日 SphinxCon JP 2015 で発表の機会に恵まれたんだけど、意外と sphinx-autobuild について知られていなかったようなのでブログにも書いてみることにする。 まず、内容を確認するのに HTML を使っている場合、通常であれば Sphinx の執筆作業は以下の工程の繰り返しになるとおもう。 この繰り返しは本当にめんどうくさいから、執筆への集中を阻害する原因になる。 ドキュメントのソースファイルを編集する Sphinx でビルドする ブラウザにフォーカスを移す ブラウザをリロードする 内容を確認する そこで sphinx-autobuild を使うと (2) から (4) までの作業を自動化してくれる。 これで執筆に集中できるから効率も上がるというもの。 使ってみよう 検証した環境には Mac OS X を使っている。 $ sw_vers ProductName: