Отображение окна предупреждения на страницах, созданных python-sphinx

Question

Как отобразить окно предупреждения в html, сгенерированном с помощью sphinx-build?

Warning

Do not use the directives sectnum, header and footer.

Я хочу показать приведенное выше сообщение примерно так: (извините, ТАК не позволяет мне вставлять изображение в пост здесь)
Пожалуйста, не обращайте внимания на форматирование текста, моя главная цель показать коробку с текстом, чтобы привлечь внимание пользователя как на сайте sphinx-doc

Answer 1

Синтаксис reStructuredText, который вы хотите, предназначен для вещей, называемых директивами admonition .

Этот конкретный пример существует в источнике документации :

.. warning::

   Do *not* use the directives :dudir:`sectnum`, :dudir:`header` and
   :dudir:`footer`.