Sphinx：对不同的输出格式使用不同的指令

Question

假设您有一个reStructuredText文档，并希望使用Sphinx 2.x以两种格式导出它：HTML和PDF。

您想在这两种格式中放入一些略有不同的内容。例如，文本“”我是HTML“显示在HTML版本中，而”我是PDF“显示在PDF版本中文档的相同位置。

使用如下所示的替换指令将为您提供“我是HTML”，而与导出格式无关。

.. |foo| replace:: HTML

⋮

I am |foo|

您可以对其他导出格式使用不同的指令吗？

Answer 1

这有点笨拙，但是对我有用：

.. role:: latex(raw)
   :format: latex

.. role:: html(raw)
   :format: html

.. |foo| replace:: :latex:`LaTeX text`:html:`HTML text`
.. |bar| replace:: :latex:`other latex text`:html:`other html text`