我正在尝试使用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”或“警告”这些词,那么这些盒子对我来说会很有效。
非常感谢任何帮助。
答案 0 :(得分:8)
注释,警告等内容称为admonitions。不幸的是,你不能创建没有标题的,因为reStructuredText需要它。
该页面上的其他框来自code blocks。代码块通过Pygments颜色语法高亮显示器运行。
还有其他几种方法可以获得你想要的东西。你可以embed raw HTML,但这令人不悦。另一种选择可能是write an extension创建一个指令,为您提供所需的功能。
答案 1 :(得分:2)
这是一个简单的source code block。