Создание локальной копии документации Django

[Co0l3r]

а если windows?

[fata1ex]

А в чем проблемы? make, насколько я знаю, существует и для windows, убрать sudo, думаю, тоже не составит труда :)

[kmike]

sphinx, по идее, кладет файл make.bat (который делает то же, что и make+Makefile) в ту же папку, так что даже make для windows можно не ставить.

Правда сейчас глянул, у джанги этого файла нет)

[overPlumbum]

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

[overPlumbum]

Инструкция по сборке под Windows: softwaremaniacs.org/forum/django/4683/

[fata1ex]

С вашего позволения добавлю ссылку на инструкцию или саму инструкцию в пост

[overPlumbum]

пожалуйста

[fata1ex]

Спасибо, добавил :)

[kmike]

Ну да, многие не знают про это почему-то.

С другой стороны, это стандартный и общепринятый способ распространения документации в питоне, и очень часто пакеты содержат точно такую же документацию. Сам питон, к примеру, большинство известных джанго-приложений (если не все) и тд. Это такая общепринятая штука в питоне, которая может быть новостью для людей, начавших свое обучение с django и знакомых с питоном не очень давно.

Кстати, писать документацию в sphinx — сплошное удовольствие.

[fata1ex]

Кстати, писать документацию в sphinx — сплошное удовольствие

Поделитесь статьёй на эту тему. Думаю, многим будет интересно ;)

[kmike]

Можно почитать первые четыре раздела из sphinx.pocoo.org/contents.html, потом еще sphinx.pocoo.org/ext/autodoc.html — и готово. А статьи от меня про sphinx не будет ;)

Кстати, в документации, которую генерит sphinx, есть один очень интересный момент, показавшийся сперва даже удивительным. Там есть поиск, который работает на чистом html+js. Т.е. он будет работать без интернет-соединения и без какой-бы то ни было серверной части.

[fata1ex]

Их документацию я уже просмотрел, на досуге надо будет его попробовать. А про статью жаль )

[spanasik]

Присоединяюсь.

[krylatij]

К слову, можно и в PDF. Как я понял, для этого конвертится сначала в latex, а потом уже в pdf

[prefer]

Спасибо, работает!
Поясните пожалуйста, зачем это: _build/index.html? К тому же у меня там не оказалось index.html, этот файл лежит в _build/html/index.html

[fata1ex]

Пожалуйста. И вам спасибо, досадная опечатка

[fata1ex]

«досадная опечатка» это не обращение :)

[apkawa]

известное дело. Я даже собрал PKGBUILD для Arch Linux, который собирает документацию из svn/

aur.archlinux.org/packages.php?ID=32893

[anthonio]

for gentoo users:

    USE="doc" emerge -v django

;)