Почему замена | версия | не работает на сфинксе

Question

Я новичок в использовании sphinx для документирования своей работы, я хочу добавить номер версии и выпустить мою документацию в формате pdf

В файле conf.py определена переменная версии, которую мы можем использовать в файлах.rst, например:

| Версия |

Но это не работает для меня, я не знаю, делаю ли я что-то неправильно. Есть предложения?

Answer 1

Чтобы использовать подстановку, вам нужно определить ее в файле в формате:

.. |Version| replace:: 1.0

Тогда используйте это в тексте:

 "Latest version is |Version|"

Я обычно включаю все замены в один файл, который затем включается в каждый файл проекта с помощью директивы:

.. include:: substitutions-file-name