python-sphinx - 如何在 Sphinx 中进行依赖于输出格式的替换

Question

使用 Sphinx ，如何根据输出格式进行替换？
基本上，我想要类似的东西

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

但我似乎无法正确使用语法。

Answer 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#including-content-based-on-tags