Как создать глобальную роль/роли в Sphinx?

Это продолжение «ReST Strikethrough» ReST Strikethrough, но в Sphinx, а не в ReST. контекст.Мой вопрос заключается в том, есть ли в sphinx центральное место для размещения директивы «роль» или действительно ли эта директива должна повторяться в каждом первом файле в документации sphinx.

Более подробно:

Можно легко определить пользовательские стили CSS для встроенного текста (см. пример ReST Strikethrough), используя директиву роли:

.. role:: custom
   :class: custom

This is an :custom:`inline text`.

, которая транслируется в html-рендеринг

.. This is an inline text.  ..

Таблицу стилей можно легко добавить в sphinx (см. http://www.tinkerer.me/doc/theming.html), где добавить селектор класса CSS для управления отображением «нестандартного» текста (цвет, зачеркивание, шрифт, размер...)

Что меня беспокоит, так это то, что в моих экспериментах мне приходилось повторять директиву роли в каждом файле ReST, в котором использовалась пользовательская роль. Есть ли «центральное» место, где я могу определить это один раз для всего сайта?

19
задан Community 23 May 2017 в 11:54
поделиться