1

我正在尝试使用 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。如果这些框的开头没有“Note:”、“SeeAlso”或“Warning”的话，它们对我来说非常适合。

任何帮助是极大的赞赏。

4

2 回答 2

11

诸如注释、警告之类的东西称为警告。不幸的是，您不能创建没有标题的标题，因为它是 reStructuredText 所要求的。

该页面上的其他框来自代码块。代码块通过Pygments颜色语法荧光笔运行。

还有其他几种方法可以得到你想要的。您可以嵌入原始 HTML，但这是不受欢迎的。另一种选择可能是编写一个扩展来创建一个指令，为您提供所需的功能。

于 2012-07-27T08:05:51.140 回答
1

这是一个简单的源代码块。

于 2012-07-26T20:08:18.553 回答