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

时间:2012-07-26 19:59:28

标签: python python-sphinx

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

例如,这个网站有很多灰色的div或盒子(不是Note):http://sphinx.pocoo.org/ext/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。如果他们在开头没有“注意:”,“SeeAlso”或“警告”这些词,那么这些盒子对我来说会很有效。

非常感谢任何帮助。

2 个答案:

答案 0 :(得分:8)

注释,警告等内容称为admonitions。不幸的是,你不能创建没有标题的,因为reStructuredText需要它。

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

还有其他几种方法可以获得你想要的东西。你可以embed raw HTML,但这令人不悦。另一种选择可能是write an extension创建一个指令,为您提供所需的功能。

答案 1 :(得分:2)

这是一个简单的source code block