代码块中的 Sphinx 变量替换答案

【问题标题】：Sphinx variable substitution in code blocks代码块中的 Sphinx 变量替换
【发布时间】：2014-12-10 03:36:33
【问题描述】：

使用 Sphinx 1.2.3 并给出这个 RST sn-p：

.. code-block:: xml

    <foo>
        <bar>|version|</bar>
    </foo>

在conf.py 我有：

version = '1.0.2'

如何保证上面的 RST sn-p 呈现为：

<foo>
    <bar>1.0.2</bar>
</foo>

这个previous question 表示我们应该使用.. parsed-literal:: 而不是.. code-block::，但这不起作用，该问题中引用的链接也不起作用。

我还想保留语法高亮。

【问题讨论】：

以下是如何让替换工作：stackoverflow.com/a/25557867/407651。但不可能同时保留语法高亮（参见stackoverflow.com/q/27185467/407651）。
@mzjn 感谢您的评论 - 如果您想提供一个正常的答案，我会奖励它。谢谢！

【解决方案1】：

你可以使用backslash-escaped whitespace得到想要的输出：

.. parsed-literal::

  <foo>
       <bar>\ |release|\ </bar>
  </foo>

不幸的是，不能同时保留语法高亮（当然，您可以使用 code-block 指令来实现，但这样替换将不起作用）。

【讨论】：