Python sphinx 斯芬克斯内联包括

我想使用

。。include:：

函数内联，但如果我用前一个文本中的两行新行将其分隔开，我只能使它实际包含我想要的文件

---

在任何人询问之前，我想要包含的文件是一个协议号，所以不，它根本不受益于新行。我希望能够轻松地更改它，以便在文档的多个位置使用它。我猜一个例子是“我们目前使用协议（proto.txt）。”我对Sphinx和rst不熟悉，所以可能有一个非常明显的解决方案我还没有找到。

Sphinx不可能使用内联包含

但是，您可以在您的

rst\u epilog

变量中定义global

例如，可以将以下行添加到

conf.py

文件中：

rst_epilog = """
  .. |version| replace:: 4.1
  .. |protocol| replace:: httpx
"""

现在，您可以从项目中的任何.rst文件访问变量

| version |

和

| protocol |

，例如：

Version | Version |使用|协议|协议。

变成

4.1版使用httpx协议。

---

如果软件的其他部分要求在特定文件或格式中指定

协议

（或其他变量），您可以编写一个脚本，将其作为变量读取到Sphinx配置文件中。

到目前为止您做了哪些尝试？@Sachith我在操作中说，除了用换行符分隔外，我什么都想不出来。谢谢！正如我所说，我想象有某种方式，真的很感激！：）