Система документации Sphinx - множественные замены с rst_prolog

Question

Как определить несколько глобальных подстановок в Sphinx?

Я вижу in this question как создавать глобальные подстановки с использованием rst_prolog в conf.py. НАПРИМЕР,

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