python - Sphinx ドキュメントの条件付き出力

Question

Sphinxを使用していくつかのドキュメントを書いていますが、特定のテキスト ブロックを HTML ドキュメント用にのみ出力したいと考えています。LaTeX ドキュメント用ではありません。これを行うことができるはずだと何かが教えてくれますが、sphinx.ext.ifconfig方法がわかりません。誰もこれを行う方法を知っていますか?

Answer 1

延長は必要ありません。onlyディレクティブを使用するだけです。

(古いリンク、オリジナルの 2010 投稿から)
https://web.archive.org/web/20100129001557/http://sphinx.pocoo.org/markup/misc.html#include-content-based-on-tags

(最新のリンク)
https://www.sphinx-doc.org/en/master/usage/restructuredtext/directives.html#include-content-based-on-tags

それはこのように動作します：

.. のみ:: ラテックス

    ここにあるものは、ラテックス出力にのみ表示されます。

.. のみ:: html

    このブロック内のものは、HTML 出力にのみ表示されます。これは
    このディレクティブを一緒に使用すると便利なことがよくあります。

    ..生::html

        動画などの埋め込みに適しています。