apatheia.info

sphinxの更新をguard-livereloadで検知してブラウザを自動リロードする

Published on 03 Jun 2012

sphinxでドキュメントを書く際に生じる「文章の記述 => ビルド => ブラウザでの確認」という一連のサイクルを人力でやるのは効率が悪い。いろいろな省力化対策が考えられるが、ここでは guard-livereloadを使って、文章のビルドとブラウザのリロードを自動化する方法を説明する。

作業環境

検証に使った環境は以下の通り。環境に依存する部分は少ないので、他のOSでも動くと思う。

事前準備

サーバー側準備

用意するのは3ファイル

https://gist.github.com/2862843

これら3ファイルをsphinxの作業ディレクトリ内に配置する。製生後のhtmlファイルはbuld/htmlディレクトリに格納されていることを期待した設定になっているので、必要であれば適宜修正する。

ファイルの設置が終わったら、ライブラリをインストールする。

bundle install

ブラウザ側準備

好きなブラウザにlivereloadのブラウザ拡張をインストールする。

http://help.livereload.com/kb/general-use/browser- extensions

利用方法

サーバー側でファイルの監視とlivereloadを開始する。

foreman start

ブラウザで http://localhost:3000/ (3000以外にしたい場合は Procfile 内で変更)にアクセスしてlivereloadのブラウザ拡張を有効化すれば、あとはファイルの更新に合わせて自動的にビルドとブラウザのリロードが行われる。

参考