Добавление пользовательских блоков среды упражнений в реструктурированный текст

Есть ли среда для упражнений по форматированию? Что-то типа

.. exercise:: Count to 10

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

т.е. это для учебной документации, которая побуждает читателя работать с материалом.


python-sphinx restructuredtext docutils
person wirrbel    schedule 05.11.2013    source источник

Ответы (1)


arrow_upward
2
arrow_downward

Вы можете добавить свою собственную семантику и стиль с помощью admonition.

Например. пример:

.. admonition:: description

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

Результирующий вывод будет иметь admonition-description класс CSS. Затем вы можете стилизовать с помощью псевдоселекторов CSS, :after и :before, например. если вы хотите добавить значок упражнения рядом с текстом.

Случайный пример файла

person Mikko Ohtamaa    schedule 07.11.2013