python-sphinx - 在 reStructured Text 中添加自定义练习环境块

Question

是否有格式化练习的环境？就像是

.. exercise:: Count to 10

   Write down all the numbers from 1 to (including 10)

即，这是一个指导性文档，挑战读者阅读材料。

Answer 1

您可以使用admonition.

例如示例：

.. admonition:: description

        Here is some info for basic Plone troubleshooting, especially with add-on modules.

结果输出将具有admonition-descriptionCSS 类。然后，您可以使用 CSS:after和:before伪选择器设置样式，例如，如果您想在文本旁边添加一个练习图标。

一个随机的示例文件

• https://raw.github.com/collective/collective.developermanual/master/source/content/deleting.rst

• http://developer.plone.org/content/deleting.html