Sphinx文档系统 - 使用rst_prolog进行多次替换

Question

如何在Sphinx中定义多个全局替换？

我看到in this question如何使用conf.py中的rst_prolog创建全局替换。如，

rst_prolog = '.. |my_conf_val| replace:: 42'

我能找到的所有这些例子只能在rst_prolog中定义一个替换，但我想做多个。我试过这个：

rst_prolog = """.. |sub1| replace:: mine1\
         .. |sub2| replace:: mine2"""

当我把| sub1 |到第一个文件中的文本，| sub1 |是（毫不奇怪）替换为：

mine1 .. |sub2| replace:: mine2

这里的语法是什么？

Answer 1

确保替换定义的对齐方式一致。不需要反斜杠。这有效：

rst_prolog = """
.. |sub1| replace:: mine1
.. |sub2| replace:: mine2
"""