RST 中的多行替换

Question

我的文档有一个由一个短段落和几个短要点组成的模式。该模式在给定 RST 文件中使用的任何位置都包含相同的文本，但在每个文件中都不同。

这应该是一件简单的标记事情：将文本定义为每个文件中的替换。但我找不到一种方法来定义不适合一行的替换。

GitHub 中的 RST 文档 说：“使用替换来重用简短的内联内容...... 包含一个共享文件以重用更长、更复杂的内容。”对于短而简单、不长而复杂但不内联使用的文本，这里似乎有一个黑洞。

我真的不想在这里使用包含；这将使我的项目中的文件数量增加一倍，并在每个源文件中使用一个包含文件。还有其他办法吗？

Answer 1

一行没有固定限制，但 rST 替换仅限于行内元素。

以下是有效的替换定义：

.. |ok| replace:: 
 
   a long text 
   that spans :math:`n > 1` lines
   and contains **inline** markup.
   
This is |ok|.

您可以考虑提交功能请求。