reStructuredText
reStructuredText («ристракчурэдтекст», rst) — облегчённый язык разметки. Хорошо применим для создания простых веб-страниц и других документов, а также в качестве вспомогательного языка при написании комментариев в программном коде. Используется в системе подготовки технической документации Docutils[1], написанной в основном Девидом Гуджером (David Goodger)[2]. reStructuredText можно считать потомком легковесных систем разметки StructuredText и Setext. Парсер reStructuredText поддерживает достаточное количество конечных форматов, в том числе PDF, HTML, ODT, LaTeX и формат презентаций S5. Система документирования Sphinx[3], написанная для нужд документирования языка программирования Python на сайте docs.python.org, применяется уже в нескольких десятках проектов[4]. Формат rst является одним из языков разметки, используемых на github[5], в частности, для README-файлов.
Пример синтаксиса
================== Название документа ================== Заголовок --------- Какой-нибудь простой текст, *текст курсивом*, **текст жирным шрифтом** и ссылка_: * список1 * список2 1. нумерованный список1 2. нумерованный список2 .. figure:: /media/wikipedia/commons/f/f6/Wikipedia-logo-v2-ru.png Логотип русской Википедии .. _ссылка: http://ru.wikipedia.org
Поддержка текстовыми редакторами
Универсальные текстовые редакторы:
- emacs (с помощью специального пакета rst-mode[6]),
- Vim (в базовой версии доступна подсветка синтаксиса),
- JED (доступен специальный режим[7]),
- ReText (специализированный редактор для языков разметки Markdown и ReST), Geany.
Примечания
- ↑ Mertz, David. XML Matters: reStructuredText. IBM developerWorks (1 февраля 2003). Дата обращения: 28 декабря 2011.
- ↑ docutils on Ohloh
- ↑ Sphinx documentation generator
- ↑ Projects using Sphinx
- ↑ GitHub Markup
- ↑ Emacs Support for reStructuredText (англ.)
- ↑ Mode for reStructuredText (англ.)