Поддержка ReST
Файлы с расширением .rst
интерпретируются как файлы в формате ReST (reStructuredText).
Важной особенностью ReST является концепция ролей — произвольных типов элементов, обозначаемых через префикс. Например: :myrole:`Text`
. По умолчанию Собирака поддерживает роль doc
для вставки ссылок на другие страницы документации, например: :doc:`Text <otherpage.rst>`
. Обработчик страниц может реализовать поддержку любых других ролей с помощью функций process_role_*()
.
Также в файлах ReST, как и в любых текстовых файлах для Собираки, можно использовать директивы и синтаксис Jinja.