在 python-sphinx 生成的页面上显示警告框

Displaying a warning box on pages generated by python-sphinx

如何在使用sphinx-build生成的html中显示警告框?

Warning

Do not use the directives sectnum, header and footer.

我想将上面的消息显示为如下所示: (抱歉,所以不允许我在 post 中嵌入图片)
请忽略文本格式,我的主要目的是显示一个带有一些文本的框以引起用户的注意like on sphinx-doc site

您想要的 reStructuredText 语法适用于名为 admonition directives.

的内容

那个具体的例子存在于documentation source:

.. warning::

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