Как стать автором
Обновить

Комментарии 6

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

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

вопрос к знающим людям: как можно заставить autodoc отключить режим «respect __all__»? Полтора дня (потом плюнул — устал ;) ) изучения сорцов дали знание, что есть некий параметр при вызовах парсеров, но так и не смог найти где его поменять без «пересборки» Sphinx-а :(
Жалко, что не рассказали о недостатках. Например, таблицы в RST очень трудоемко оформлять, особенно редактировать.
Я хотел просто сделать ознакомительную статью, чтобы показать возможности. Сложностей много, конечно, например, русификация и собственные шаблоны. Но это на порядки проще и надёжнее, чем ставить CMS, и на порядки проще, чем делать всё вручную.
Только полноправные пользователи могут оставлять комментарии. Войдите, пожалуйста.