Sphinx和reStructuredText：在include指令中传递参数

Question

我是Sphinx和reStructuredText的新手。

我有n个第一个文件，我想在其中插入类似的文本（非代码）：

Hello Earth.

或

Hello Mars.

或

Hello Saturn.

我的想法是在我的rst文件中包含一个通用的rst文件。

.. include:: planet.rst

在此文件中带有planet.rst和一个占位符：

Hello <planet>.

我当前的解决方案是：planet.rst：

Hello Earth.
Hello Mars.
Hello Saturn.

以及在我的第一个文件中，例如对于火星：

.. include:: planet.rst
   :start-line: 1
   :end-line: 2

我正在寻找更好的解决方案。

我没有在http://docutils.sourceforge.net/docs/ref/rst/directives.html中找到include指令的有目的地选项>

如何将参数（变量/值）传递给包含的文件以替换占位符？

谢谢你的提示托马斯

我是Sphinx和reStructuredText的新手。我要在第一个文件中插入一个类似的文本（不是代码）：Hello Earth。或你好火星。或土星你好。我的想法是包括...

Answer 1

"Replacement Text (replace)"的指令应与包含的文件一起使用。