buildout を利用して Sphinx 環境を構築する
buildout を利用して Sphinx 環境を構築する¶ 複数人で Sphinx 文章を扱う場合、ネックになりがちなのが各々のマシンに Sphinx をインストールすることです。特に、Sphinx に加えて外部の Sphinx 拡張を利用している場合は混乱が生じがちです。 ここでは開発環境構築ツールである buildout を利用して、Sphinx 環境の構築を行います。 buildout の導入¶ buildout は以下の 2つのファイルで構成されます。 bootstrap.pybuildout の実行環境を構築するスクリプトです。各マシン上で最初に 1度だけ実行します。 Web 上に公開されているものを wget コマンドで取得します: buildout.cfg環境定義のための設定ファイルです。インストールするパッケージなどを記述することができます。 vi などのテキストエディタ
sphinx-autobuild
Rebuild Sphinx documentation on changes, with hot reloading in the browser. Installation sphinx-autobuild is available on PyPI. It can be installed using pip: pip install sphinx-autobuild Usage To build a classical Sphinx documentation set, run: sphinx-autobuild docs docs/_build/html This will start a server at http://127.0.0.1:8000 and start watching for changes in the docs/ directory. When a cha
Live Sphinx Documentation Preview
Update (2015-06-11): There is now a nice installable package to make this even easier, sphinx-autobuild. All you have to do is Update (2013-04-23): livereload now has a ‘shell’ compiler, which simplifies the Guardfile. The post has been modified to reflect this. The big idea I’ve been working with Middleman quite a bit, and really enjoyed their integration with livereload.js. When you save a chang
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
Sphinx(reStructuredText)のエディタ選択の話 | Tech Blog | CRESCO Tech Blog
