Мы используем sphinx для создания инструкций для наших клиентов.Теперь каждый раз, когда мы выпускаем новую версию, нам необходимо последовательно обновлять номер версии нового выпуска в руководстве.
Для этого представляется целесообразным использовать предопределенную замену |version|.
index.rst
User manual
#######################
*Product |version|* can be used to ...
.. toctree::
:maxdepth: 1
:numbered:
tutorial
tutorial.rst
Tutorial
############
We are glad, that you are using *Product |version|*!
Теперь сгенерированный HTML-код правильно заменяет | версию |в теге index.rst, но, к сожалению, в tutorial.rst замены нет.
Кто-нибудь знает, что здесь не так?