Sphinxの拡張機能のsphinxcontrib-blockdiagを使ってみる

昨日、Sphinxとblockdiagを試してみて良さげだなぁという印象を受けたのですが、 Twitterで@tk0miyaさんから、Sphinxの拡張機能を使えばreSTにblockdiagを埋め込めます！と。 make htmlするだけでOK。ありがたい情報でございます。　さっそくblockdiagのSphinx拡張のページをみると↓。なるほどなるほど。 http://blockdiag.com/ja/blockdiag/sphinxcontrib.html ＝＝ Sphinx の拡張機能として blockdiag によるブロック図を埋め込むことができます。ブロック図の埋め込みには blockdiag ディレクティブを利用します。　＝＝　ということで、このページのやり方に従ってsphinxのプロジェクトにあるconf.pyに - extensionsの定義と - フォントの設定(とりあえずMSゴシック)を入れてみます。

# Add any Sphinx extension module names here, as strings. They can be extensions
# coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
extensions = ['sphinxcontrib.blockdiag']

# Fontpath for blockdiag (truetype font)
blockdiag_fontpath = 'C:WindowsFontsmsgothic.ttc'

　 index.rstを以下のようにしてmake htmlしてみます。

Indices and tables
==================

* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`

.. blockdiag::

    site {
      hoge <- aaa;
      hoge <- bbb;
      hoge <- ccc;
      ccc <- xxx;
    }

　すると、、、↓。おぉ、コマンド一発ですね。便利。