reStructuredText (ReST): Быстрый способ ввода таблиц

Когда дело касается больших таблиц, то их не очень удобно набирать вручную. Так как мне приходится работать в основном над переносом текста из LibreOffice (odf, doc, docx и т.д.), то я нашел быстрый, легкий и удобный способ с использованием CSV-таблиц и LibreOffice.

Руководство: Генератор документации Sphinx

Тот случай, когда для работы над одним руководством, приходится писать другое.

В руководстве подробно описан процесс генерации документации с помощью связки reStructuredText, Python Sphinx, GitHub и сервиса Read the Docs.

Доступно в трёх форматах — онлайн, HTML и ePub.

Структура руководства

В главе «Генератор документации Sphinx» описана установка и основные настройки Sphinx.

В главе «Стандартный синтаксис разметки reStructuredText» приведен стандартный синтаксис разметки reStructuredText. Глава «Конструкции разметки Sphinx» содержит описание дополнительных конструкции разметки, вносимых Sphinx. Данные конструкции значительно расширяют функционал reStructuredText, но не поддерживаются стандартной разметкой и поэтому не могут быть применены вне Sphinx.

Глава «Система управления версиями Git» является справочником по основным командам Git.

Глава «GitHub и Read The Docs» рассматривает веб-сервис для хостинга IT-проектов GitHub, сервис Read The Docs и их взаимодействие.

В главах «Известные проблемы» и «Часто задаваемые вопросы» описаны основные проблемы, с которыми я столкнулся.

Авторские права

Руководство распространяется на условиях лицензии «Attribution-ShareAlike» («Атрибуция — На тех же условиях») 4.0 Всемирная (CC BY-SA 4.0).

Содержание

Проще, чем заметки на рулоне туалетной бумаги

Похоже, я нашел землю обетованную для каждого, кто занимается написанием и оформлением документации. Заметка посвящена команде русскоязычного сообщества LibreOffice.

Совместная работа над документацией по LibreOffice

Статья о том, как организовать работу по написанию и переводу официальной документации LibreOffice.

Упрощаем публикацию статей в Blogger (Blogspot)

Кто сталкивался с Blogger, он же Blogspot.com, знает, что его визуальный редактор довольно капризная штука.

В рамках подготовки следующей статьи, которую опубликую чуть позже, я нашел один из способов упростить и сделать более комфортным процесс написания статей в Blogger. Может он не очень гениален и есть способы проще, но в моем случае пока удобно именно так.

Суть заключается в использовании языка разметки Markdown и программы ReText.