close

Реструктурированный текст

Перейти к навигации Перейти к поиску
реструктурированный текст
Логотип ReStructuredText.svg
разработчик
Дэвид Гуджер
https://docutils.sourceforge.io/rst.html
Главная Информация
расширение файла первый
пантомима текст/x-первый
Последняя версия Редакция 7629
11 марта 2013 г.
тип формата Техническая документация
открытый формат ?

Проект ReStructured Text — это облегченный язык разметки, созданный для удобного и быстрого написания форматированного текста. Он является частью проекта Docutils в сообществе Python и формализован группой Python Doc-SIG (Специальная группа по вопросам документации). Его основное преимущество заключается в том, что этот текст можно использовать для создания эквивалентных документов в HTML, LaTeX, docbook и т. д. Это эволюция структурированного текста .

Часто термин реструктурированный текст сокращается до ReST или reST, что приводит к путанице с термином REST (передача репрезентативного состояния) — типом интерфейса через протокол HTTP , который не имеет отношения к формату, который нас интересует в этой статье.

Примеры синтаксиса

Нижеследующее не является исчерпывающим списком синтаксиса reST. См. более полную ссылку первого краткого справочника для получения дополнительной информации.

Заголовки:

заголовок раздела
==========================

Заголовок подраздела
-----------------------------

Списки:

- Элемент в ненумерованном списке

- Другой элемент в списке

  - Подпункт

- Третий элемент
1) Элемент нумерованного списка

2) Второй элемент

   а) Подэлемент

      i) Под-подэлемент

3) Третий элемент
# Еще один элемент нумерованного списка

# Второй элемент

Именованные ссылки:

Предложение со ссылкой на Википедию_ и `архив ядра Linux`_.

.. _Википедия: http://www.wikipedia.org/ 
.. _Архив ядра Linux: http://www.kernel.org/

анонимные ссылки:

Еще одно предложение с «анонимной ссылкой на сайт Python»__.

__ http://www.python.org/

Встроенные ссылки:

`Python < http://www.python.org/ >`_.

Обратите внимание, что ссылки заключают тексты с серьезным ударением (`), а не с апострофом ('). Если на вашей клавиатуре нет клавиши обратной кавычки; в Microsoft Windows вы можете ввести число на цифровой клавиатуре с комбинацией Alt+96, в GNU / Linux Ubuntu используйте MAYÚS+ CTRL+ , Uа затем нажмите 6, 0и ESPACIO.

Картинки:

..image::images/ball1.gif

Внешние ссылки