如何在Sphinx .rst文件中输出配置值？

Question

我有以下内容conf.py：

def setup(app):
    app.add_config_value('base_url','http://localhost:2000', True)

如何将其放入我的.rst文件？我这样写：

:base_url:/my_app/api/application/

但是它仅打印:base_url:而不是实际的URL。

如何获取要发出的实际配置值？

Answer 1

对于链接的替换， extlinks
很好，因为可以按照问题中的要求包含任意配置值，所以可以使用rst_epilog进行替换（或使用rst_prolog进行文本替换，应将其添加到.rst文件的顶部）：

在您的conf.py中：

my_config_value = 42
rst_epilog = '.. |my_conf_val| replace:: %d' % my_config_value

在您的.rst来源中：

我的配置值为| my_conf_val |！

在您的输出中：

我的配置值为42！