如何制作狮身人面像彩盒

Question

我正在尝试使用Sphinx制作Python的彩色盒子。

例如，这个网站有很多灰色的div或box（不是Note-one）：http://sphinx.pocoo.org/ext/autodoc.html

我想知道他们是如何创建thoses框的，因为这个网站也是使用sphinx创建的。

我发现，狮身人面像是用彩色盒子做的，如图所示：http://openalea.gforge.inria.fr/doc/openalea/doc/_build/html/source/sphinx/rest_syntax.html#colored-boxes-note-seealso-todo-and-warnings。如果这些盒子一开始没有“注意：”、“另请参阅”或“警告”字样，那么它们对我来说将是完美的。

任何帮助都非常感谢。

Answer 1

像注释、警告之类的东西叫做admonitions。不幸的是，您不能创建没有标题的，因为reStructuredText需要这样做。

该页上的其他框来自code blocks。代码块通过Pygments颜色语法高亮显示。

有很多其他的方法可以得到你想要的。你可以embed raw HTML，但那是不受欢迎的。另一种选择可能是write an extension创建一个指令，为您提供所需的功能。

Answer 2

这是一个简单的source code block。