Условный вывод в документации Sphinx

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

Ответы

Ответ 1

Не требуется расширение. Просто используйте директиву . Он работает следующим образом:

.. 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 good for embedding stuff, like video.