python-sphinx - 在重构文本中添加自定义锻炼环境 block

Question

有格式化练习的环境吗？类似的东西

.. exercise:: Count to 10

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

即这是一份指导性文档，要求读者阅读该 Material 。

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