Comments 6
Спасибо за наводку на inotifywait.
Про существование библиотеки знал, а вот про существование консольной утилиты нет.
Про существование библиотеки знал, а вот про существование консольной утилиты нет.
PDF очень советую делать через latex.
В своё время я так скомпилировал документацию по Django 1.0 и распечатал.
Получилась очень приятная бумажная книжка почти на 500 листов.
Если б не Sphinx, вряд ли бы я решился с монитора читать документацию от корки до корки.
В своё время я так скомпилировал документацию по Django 1.0 и распечатал.
Получилась очень приятная бумажная книжка почти на 500 листов.
Если б не Sphinx, вряд ли бы я решился с монитора читать документацию от корки до корки.
Сравнительно активно использую Sphinx (+autodoc) для изучения чужих библиотек — удобно :)
вопрос к знающим людям: как можно заставить autodoc отключить режим «respect __all__»? Полтора дня (потом плюнул — устал ;) ) изучения сорцов дали знание, что есть некий параметр при вызовах парсеров, но так и не смог найти где его поменять без «пересборки» Sphinx-а :(
вопрос к знающим людям: как можно заставить autodoc отключить режим «respect __all__»? Полтора дня (потом плюнул — устал ;) ) изучения сорцов дали знание, что есть некий параметр при вызовах парсеров, но так и не смог найти где его поменять без «пересборки» Sphinx-а :(
Жалко, что не рассказали о недостатках. Например, таблицы в RST очень трудоемко оформлять, особенно редактировать.
Я хотел просто сделать ознакомительную статью, чтобы показать возможности. Сложностей много, конечно, например, русификация и собственные шаблоны. Но это на порядки проще и надёжнее, чем ставить CMS, и на порядки проще, чем делать всё вручную.
Добавил в конец текста: редактор преформатированных таблиц для SublimeText
github.com/vkocubinsky/SublimeTableEditor
github.com/vkocubinsky/SublimeTableEditor
Sign up to leave a comment.
Делаем учебник или документацию за час на Сфинксе