python - 如何在 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 config value is |my_conf_val|!

在你的输出中:

My config value is 42!