salida condicional en Sphinx Documentación

Question

Estoy escribiendo algún tipo de documentación con Sphinx y me gustaría para imprimir un determinado bloque de texto sólo para la documentación HTML, no para la documentación de LaTeX. Algo me dice que debería ser capaz de hacer esto con sphinx.ext.ifconfig pero no puedo encontrar la manera. ¿Alguien sabe cómo hacer esto?

Answer 1

No se requiere ninguna extensión. Sólo tiene que utilizar la única directiva . Funciona de esta manera:

.. 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.