python - 如何在狮身人面像中制作彩色盒子

Question

我正在尝试使用 Sphinx for Python 制作彩色框。

例如，这个网站有很多灰色的 div 或框(不是 Note 的):http://www.sphinx-doc.org/en/master/usage/extensions/autodoc.html

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

我发现的一件事是，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创建一个指令，为您提供所需的功能。