如何在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

官方文档：https://www.sphinx-doc.org/en/master/usage/restructuredtext/directives.html#including-content-based-on-tags