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

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

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

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

но я не могу понять синтаксис правильно.


person andreas-h    schedule 08.01.2012    source источник


Ответы (1)


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

.. only:: html

   .. raw:: html

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

.. only:: latex

   latex specific

Официальная документация: https://www.sphinx-doc.org/en/master/usage/restructuredtext/directives.html#включая-content-based-on-tags

person jmu    schedule 09.03.2012