Как просматривать (без текстового редактора).rst файлы?

Во многих проектах django в каталоге docs я могу видеть файлы *.rst:

Каков наилучший способ их просмотра (без использования текстового редактора, конечно)?

Возможно ли сгенерировать HTML?

Ответы

Ответ 1

.rst файлы ReStructuredText. Они выглядят как текстовые файлы, но могут быть отображены в HTML с пакетом Python docutils.

Ответ 2

Как говорит zjk, вы можете использовать restview:

restview доступен из Индекса пакетов Python: http://pypi.python.org/pypi/restview. Вы также можете установить пакет restup.

Вот что я сделал, чтобы проверить это с помощью виртуальной среды:

mkdir restview
cd restview/
virtualenv-2.7 venv   # The second system I used just used 'virtualenv venv'
./venv/bin/pip install restview
./venv/bin/restview ~/path/MANUAL.rst

Это запустило веб-сервер и открыло страницу документации в моем браузере.

Примечание. Я использовал только virtualenv, потому что мне не нравится устанавливать вещи во всем мире. Это может быть излишним для многих других, но мне также повезло с этими одноразовыми экологическими сетями. Когда я пробовал pip install restview на Ubuntu 14.04 VM, он потерпел неудачу, тогда как вышеприведенный подход работал как прелесть для меня в этой системе, а также в этом.

Ответ 3

Попробуйте restview

Ответ 4

Эта страница описывает, как создать собственную документацию Django в HTML, через библиотеку Sphinx. Другие проекты, вероятно, будут работать одинаково.

Ответ 5

просто переименуйте расширение файла в .txt, а затем откройте файл любым текстовым редактором.

Люди склонны устанавливать границы и препятствия, чтобы скрыть свои знания - талию времени.