python - 在 Sphinx 中使用 rst_epilog 的动态 URL

Question

我最近一直在使用 python 编写 Sphinx 文档。在我的文档中，我有一些动态 URL，这些 URL 将在每个构建的文档中更新，并且来自我已经配置并且工作正常的数据库。像这样包含这些值rst_epilog。conf.py

rst_epilog = """
.. |value1| replace:: www.google.com
.. |value2| replace:: www.fb.com
"""

在我的文档中，我正在使用这样的东西

For more information search `here`_

.. _`here`: |value1|

但是有些如何|value1|不被替换www.google.com（它在段落中工作正常）并且它成为一个内部链接。

如果我做错了什么或者有解决这个问题的方法，那么我可以解决这个问题。

标签： pythonpython-sphinxsubstitution

Answer 1

正如史蒂夫在这里的回答中提到的那样。可以同时使用替代和 rst_epilog。对于上面的示例，更改将如下所示

在 conf.py

rst_epilog = """
.. |value1| replace:: value1
.. _value1: www.google.com
.. |value2| replace:: value2
.. _value2: www.fb.com
"""

在 .rst 文件中

For more information search |value1|_

这将导致替换，然后为 rst_epilog 动态生成超链接。