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