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

【问题标题】：Displaying a warning box on pages generated by python-sphinx在 python-sphinx 生成的页面上显示警告框
【发布时间】：2018-04-27 20:35:59
【问题描述】：

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

Warning

Do not use the directives sectnum, header and footer.

我想将上述消息显示为：（抱歉，不允许我在此处将图片嵌入帖子中）
请忽略文本格式，我的主要目的是显示一个带有一些文本的框以引起用户的注意like on sphinx-doc site

【问题讨论】：

【解决方案1】：

您想要的 reStructuredText 语法适用于名为 admonition directives 的东西。

该具体示例存在于documentation source：

.. warning::

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

【讨论】：

我不确定，但我得到一个只有warning 的盒子，在我收到警告信息的盒子外面。示例图片：gist.github.com/avatar-lavventura/…
@alper 你可以使用custom CSS 来设置你喜欢的 HTML 标记样式。