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