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

官方文件： http://sphinx.pocoo.org/markup/misc.html?highlight=format#including-content-based-on-tags