設定にしたがってコンテンツを表示する

ifconfig拡張は引数として与えられた式がTrueの時にだけ、コンテンツをドキュメントに追加します。

準備として、conf.pyのextensionsにifconfigを追加します。

extensions = ['sphinx.ext.ifconfig' ]

こうしておいて、以下のように記述します。

.. ifconfig:: version in ('0.0.1')

  versionが0.0.1の時のみ表示されます。

ここでversionconf.pyで定義された値です。

独自の設定値を追加したい場合はconf.pyファイルにsetup関数を書き加え、その中でadd_config_value()を使用します。

def setup(app):
    app.add_config_value('releaselevel', '', True)

2つめの引数はデフォルト値です。3つ目の引数はTrueにしてください。この引数は、設定値が変更された場合に、ドキュメントを再読み込みするかを指定します。