Как сделать зависимую от выходного формата замену в Sphinx

Question

Используя Sphinx, как я могу сделать замену в зависимости от формата вывода?

В принципе, я хотел бы иметь что-то вроде

if html: 
     |CLICK| unicode:: U+21E8 
    elif latex: 
     |CLICK| raw:: latex 

       $\LongRightArrow$ 

, но я не могу показаться, чтобы получить правильный синтаксис.

Answer 1

Вместо этого используйте директиву .. only::. В то время как обычно используется с флагами (или меток, как сфинкс ставит его), формат вывода доступен в качестве тега, а также:

.. only:: html 

    .. raw:: html 

     <a href="http://www.google.com">google</a> 

.. only:: latex 

    latex specific 

Официальная документация: http://sphinx.pocoo.org/markup/misc.html?highlight=format#including-content-based-on-tags