Условный вывод в Sphinx Documentation

Question

Я пишу некоторую документацию с Sphinx , и я хотел бы распечатать определенный блок текста только для документации HTML, а не для документации LaTeX. Что-то говорит мне, что я должен быть в состоянии сделать это с sphinx.ext.ifconfig, но я не могу понять, как. Кто-нибудь знает, как это сделать?

Answer 1

Расширение не требуется. Просто используйте директиву only . Это работает так:

.. only:: latex

    The stuff in here only appears in the latex output.

.. only:: html

    The stuff in this block only appears in the HTML output. It's
    often useful to use this directive with it:

    .. raw:: html

        It's good for embedding stuff, like video.