Symfony2ドキュメントのビルド用にconfigurationblock拡張を組み込む

Symfony2 Sphinx

Symfony2のオンラインドキュメントはSphinxを使っています。
Sphinxは高機能なドキュメントシステムで、コードのハイライト機能などはデフォルトのままでとても優秀です。

1つ、Symfony2のドキュメントで独自に拡張機能を使っている部分があり、それがタイトルにも書いた「configuration-block」というやつです。

これはfabienさんがSymfony2のドキュメント用に作った物で、つい最近公開されました。

configuration-blockエクステンションを組み込むには？

まだ正しい方法は私には分かっていませんが、以下の手順で有効にできました。

  1. ドキュメントのプロジェクトのconf.pyがあるディレクトリに、上記リポジトリのconfigurationblock.pyを保存する
  2. conf.py中の以下の行のコメントを解除（これで、conf.pyと同一ディレクトリのモジュールを読み込むようになる）
    1. sys.path.insert(0, os.path.abspath('.'))
  3. conf.pyのextensionsに「configurationblock」を追加