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

Question

是否存在格式化练习的环境？像

这样的东西

.. exercise:: Count to 10

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

即。这是一个教学文档，挑战读者通过材料。

Answer 1

您可以使用admonition添加自定义语义和样式。

E.g。例子：

.. admonition:: description

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

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

随机示例文件

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

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