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

        它适用于嵌入内容，例如视频。