Делаем учебник или документацию за час на Сфинксе

[archim]

Спасибо за наводку на inotifywait.
Про существование библиотеки знал, а вот про существование консольной утилиты нет.

[archim]

PDF очень советую делать через latex.
В своё время я так скомпилировал документацию по Django 1.0 и распечатал.
Получилась очень приятная бумажная книжка почти на 500 листов.

Если б не Sphinx, вряд ли бы я решился с монитора читать документацию от корки до корки.

[av0000]

Сравнительно активно использую Sphinx (+autodoc) для изучения чужих библиотек — удобно :)

вопрос к знающим людям: как можно заставить autodoc отключить режим «respect __all__»? Полтора дня (потом плюнул — устал ;) ) изучения сорцов дали знание, что есть некий параметр при вызовах парсеров, но так и не смог найти где его поменять без «пересборки» Sphinx-а :(

[Sapien2]

Жалко, что не рассказали о недостатках. Например, таблицы в RST очень трудоемко оформлять, особенно редактировать.

[siberiano]

Я хотел просто сделать ознакомительную статью, чтобы показать возможности. Сложностей много, конечно, например, русификация и собственные шаблоны. Но это на порядки проще и надёжнее, чем ставить CMS, и на порядки проще, чем делать всё вручную.

[siberiano]

Добавил в конец текста: редактор преформатированных таблиц для SublimeText
github.com/vkocubinsky/SublimeTableEditor