How do I output a config value in a Sphinx .rst file?

python, python-sphinx

Solution

For the substitution of links extlinks is fine, for including arbitrary config values as asked in your question you can use rst_epilog for substitutions (or rst_prolog for text, that should be added on top of your .rst files):

In your conf.py:

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

In your .rst source:

My config value is |my_conf_val|!

In your output:

My config value is 42!

Problem

I've got the following in `conf.py`: ``` def setup(app): app.add_config_value('base_url','http://localhost:2000', True) ``` How do I get this into my .rst files? I wrote this: ``` :base_url:/my_app/api/application/ ``` But it only prints `:base_url:` instead of the actual URL. How do I get the actual config value to be emitted?

Original source

Related problems