Sphinx中尖括号旁的替代符

Question

我正在尝试在我的 Sphinx 文档 中使用 替换，并且是在一个 解析的文字块 中，像这样：

<dependency>
  ...
  <version>|release|</version>
</dependency>

这段代码渲染出来的效果是这样的：

<dependency>
  ...
  <version>|release|</version>
</dependency>

而我想要的效果是这样的：

<dependency>
  ...
  <version>1.7.3</version>
</dependency>

如果我在源代码中添加空格围绕替换内容，我得到的结果是：

<dependency>
  ...
  <version> 1.7.3 </version>
</dependency>

所以我知道 release 的定义是我所期望的。那我该如何去掉这些空格呢？

Answer 1

这个可以用：

.. parsed-literal::

   <version>\ |release|\ </version>

.. |release| replace:: 1.7.3

参考链接：http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#escaping-mechanism