External substitutions file

[Olivier Carrere]

Hi,

How can I put all my substitutions in a dedicated, external file, and include them in my conf.py?

I tried to insert an  external substitutions file with via literalinclude with rst_prolog or rst_epilog, but then, substitions are not evaluated at build time and appear literally in the HTML output.

Thanks

[Stefano David]

Hi,

Assuming your substitutions are in replace.txt, in conf. py write

rst_epilog = open("replace.txt", "r").read()

or

rst_prolog = open("replace.txt", "r").read()

Since I use the same replace.txt for different projects, I have a slight different definition of rst_epilog, which I report in case someone finds it useful.

rst_epilog = """
.. |product| replace:: %s
.. |company| replace:: %s
"""  % (project, comp) + open("replace.txt", "r").read()

Here, project and comp are variables defined in conf.py that vary with the project I am working on.

HTH,

Stefano

[Olivier Carrere]

It does work!

Thanks a lot, Stefano!