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

Question

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

我在这个问题中看到如何使用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
"""