在 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
"""