@fata1ex12 янв 2010 в 08:32

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

1 мин

1.3K

Django *

+18

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

@Co0l3r 12 янв 2010 в 10:27

а если windows?

@fata1ex 12 янв 2010 в 10:33

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

@kmike 12 янв 2010 в 11:02

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

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

@overPlumbum 12 янв 2010 в 20:01

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

@overPlumbum 12 янв 2010 в 20:05

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

@fata1ex 12 янв 2010 в 20:13

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

@overPlumbum 12 янв 2010 в 20:19

пожалуйста

@fata1ex 12 янв 2010 в 20:43

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

@kmike 12 янв 2010 в 11:12

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

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

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

@fata1ex 12 янв 2010 в 15:41

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

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

@kmike 12 янв 2010 в 16:05

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

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

@fata1ex 12 янв 2010 в 16:09

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

@spanasik 12 янв 2010 в 16:08

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

@krylatij 12 янв 2010 в 16:11

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

@prefer 12 янв 2010 в 17:38

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