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

Да-да, это снова я и снова о документации Django :) На этот раз не будет длинных переводов, просто небольшая заметка.

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


Linux:

1. Запускаем командую строку и устанавливаем Sphinx:
   

   sudo easy_install Sphinx

   
   
2. Внутри вашей директории с Django находим папку docs, заходим в нее и:
   

   make html

   
   
3. Вот и все! Внутри docs выполняем:
   

   _build/html/index.html

   
   

Windows: (метод предоставил overPlumbum, за что ему «спасибо» :))

1. Запускаем командную строку, переходим в папку Scripts из директории с Python и устанавливаем Sphinx:
   

   cd C:\Python26\Scripts
   easy_install sphinx

   
   
2. Внутри вашей директории с Django находим папку docs, заходим в нее и создаем два новых раздела:
   

   cd C:\path_to_django_trunc\docs
   mkdir _build\html
   mkdir _build\doctrees

   
   
3. С помощью установленного Sphinx создаем документацию:
   

   С:\Python26\Scripts\sphinx-build.exe -b html -d _build/doctrees. _build/html

   
   
4. Ура! Теперь html-версия документации доступна здесь:
   

   C:\path_to_django_trunc\docs\_build\html\index.html

O чудо: теперь даже вдали от интернета вы можете ознакомиться с документацией :)