Comments 19
а если windows?
А в чем проблемы? make, насколько я знаю, существует и для windows, убрать sudo, думаю, тоже не составит труда :)
точно можно, я собирал, и на каком-то форуме выкладывал инструкцию, напишу если вспомню где.
в принципе там ничего особо хитрого
в принципе там ничего особо хитрого
Инструкция по сборке под Windows: softwaremaniacs.org/forum/django/4683/
Ну да, многие не знают про это почему-то.
С другой стороны, это стандартный и общепринятый способ распространения документации в питоне, и очень часто пакеты содержат точно такую же документацию. Сам питон, к примеру, большинство известных джанго-приложений (если не все) и тд. Это такая общепринятая штука в питоне, которая может быть новостью для людей, начавших свое обучение с django и знакомых с питоном не очень давно.
Кстати, писать документацию в sphinx — сплошное удовольствие.
С другой стороны, это стандартный и общепринятый способ распространения документации в питоне, и очень часто пакеты содержат точно такую же документацию. Сам питон, к примеру, большинство известных джанго-приложений (если не все) и тд. Это такая общепринятая штука в питоне, которая может быть новостью для людей, начавших свое обучение с django и знакомых с питоном не очень давно.
Кстати, писать документацию в sphinx — сплошное удовольствие.
Кстати, писать документацию в sphinx — сплошное удовольствиеПоделитесь статьёй на эту тему. Думаю, многим будет интересно ;)
Можно почитать первые четыре раздела из sphinx.pocoo.org/contents.html, потом еще sphinx.pocoo.org/ext/autodoc.html — и готово. А статьи от меня про sphinx не будет ;)
Кстати, в документации, которую генерит sphinx, есть один очень интересный момент, показавшийся сперва даже удивительным. Там есть поиск, который работает на чистом html+js. Т.е. он будет работать без интернет-соединения и без какой-бы то ни было серверной части.
Кстати, в документации, которую генерит sphinx, есть один очень интересный момент, показавшийся сперва даже удивительным. Там есть поиск, который работает на чистом html+js. Т.е. он будет работать без интернет-соединения и без какой-бы то ни было серверной части.
Присоединяюсь.
К слову, можно и в PDF. Как я понял, для этого конвертится сначала в latex, а потом уже в pdf
Спасибо, работает!
Поясните пожалуйста, зачем это: _build/index.html? К тому же у меня там не оказалось index.html, этот файл лежит в _build/html/index.html
Поясните пожалуйста, зачем это: _build/index.html? К тому же у меня там не оказалось index.html, этот файл лежит в _build/html/index.html
известное дело. Я даже собрал PKGBUILD для Arch Linux, который собирает документацию из svn/
aur.archlinux.org/packages.php?ID=32893
aur.archlinux.org/packages.php?ID=32893
for gentoo users:
;)
USE="doc" emerge -v django
;)
Sign up to leave a comment.
Создание локальной копии документации Django