Read the Docs
Read the Docs - веб-сервис для генерации документации, построенный в рамках концепции Docs as code. Основным результатом работы сервиса является документация в HTML-формате, а также PDF-документ (все это размещается на сайте и он выступает таким образов в ролик хостинга документации). При работе с публичным проектом является бесплатным.
- Особенности Read the Docs
- В качестве генератора используется Sphinx.
- Для разметки текста используется w:reStructuredText.
- Исходные файлы, на основании которых генерится документация хранятся на w:Github.
- Генерация PDF осуществляется с помощью инструментов w:LaTex.
Начало работы
правитьНачало работы подробно описано в учебнике на официальном сайте[1].
Для использования русского языка в свойствах проекта на Read the Docs необходимо выбрать русский язык. Иначе генерация PDF с проектом содержащим русские буквы будет приводить к ошибке.
Конвертация из формата MS Word
правитьВыполняется с применением консольного приложения w:pandoc.
pandoc test.docx -t rst -o test.rst
См. также
правитьСсылки
править- Конвертация docx в rst с помощью pandoc
- Статья на Хабре
- https://docutils.sourceforge.io/docs/ref/rst/restructuredtext.html Спецификация только самого языка разметки
- https://www.sphinx-doc.org/en/master/usage/restructuredtext/ Все что дополнительно с разметкой reStructuredText применяется
- https://www.sphinx-doc.org/_/downloads/en/master/pdf/ в виде PDF документация Sphinx Documentation
- http://nick.volynkin.gitlab.io/index.html Видео на русском языке
- https://docs.acumos.org/en/elpis/docs-contributor-guide/rst-dev-tools.html Программы для работы с RST
- http://rst.ninjs.org/ Онлайн-редактор
- https://www.sphinx-doc.org/en/master/latex.html Как влиять на генерацию PDF