如何在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

在你的第一个来源:

我的配置值是| my_conf_val |!

在你的输出中:

我的配置值是42!