在重新结构化文本中添加自定义练习环境块

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-description CSS 类。然后，您可以使用CSS，:after和:before伪选择器进行样式设置样式，例如，如果要在文本旁边添加练习图标。

随机示例文件

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

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