代码块中的Sphinx变量替换

Question

使用Sphinx 1.2.3并给出此RST片段：

.. code-block:: xml

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

并在conf.py我有：

version = '1.0.2'

如何确保上述RST代码段呈现为：

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

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

我还想保留语法高亮。

Answer 1

您可以使用backslash-escaped whitespace获得所需的输出：

.. parsed-literal::

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

不幸的是，也不可能保留语法高亮（当然，你可以使用code-block指令来获得它，但是替换不会起作用。）