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

Question

我是 Sphinx 和 reStructuredText 的新手。

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

Hello Earth.

或

Hello Mars.

或

Hello Saturn.

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

.. include:: planet.rst

with planet.rst 和此文件中行星的占位符：

Hello <planet>.

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

Hello Earth.
Hello Mars.
Hello Saturn.

在我的第一个文件中，例如火星：

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

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

中找到包含指令的有用选项

如何将参数 (variable/value) 传递给包含的文件以替换占位符？

感谢托马斯的提示

Answer 1

"Replacement Text (replace)" 的指令应该适用于包含的文件。

planet.rst:

Hello |planet|.

earth.rst:

.. |planet| replace:: Earth

.. include:: planet.rst

Sphinx and reStructuredText: pass parameter in include directive