Django Web Framework известен своей отличной англоязычной документацией с множеством примеров и стандартных решений. Большую работу по переводу на русский язык выполняют создатели открытого проекта http://djbook.ru/. Исходники распологаются на  GitHub. Создатели проекта автоматически компилируют документацию в html и выкладывают на djbook.ru. Если вам нужна оффлайн-версия, вы можете собрать её сами. Как это сделать будет рассмотрено в статье. Я буду использовать дистрибутив ArchLinux. 

Скачать собранную версию

Можете просто скачать уже собранную версию для Django 1.8: djbook1.8.pdf (собрана 02.11.17). 

Если вы хотите получить более свежую версию, далее будет рассказано как собрать её самому.

Пакеты, необходимые для сборки

Для сборки нужен python2 и несколько модулей. Устанавливать модули мы будем в виртуальном окружении. Это позволит переключится на python2 при активации виртуального окружения и не засорять системный питон модулями. Для установки мы будем использовать pip. Также понадобится git для загрузки репозитария с исходникми:

sudo pacman -S python2 python2-virtualenv python2-pip git

Создаём виртуальное окружение с интерпретатором python второй версии:

virtualenv2 djbook_env

Активируем окружение находясь в баше:

cd djbook_env/
source bin/activate 

Скачиваем репозитарий:

git clone https://github.com/Alerion/django_documentation.git
cd django_documentation/

Устанавливаем нужные модули python (они перечислены в файле djbook/deps.txt): 

Переходим на нужную ветку: 

git checkout 1.8

 

Ставим зависимости:

pip install -r djbook/requirements.txt

Как обычно при неудавшейся установке возможно придется применять фиксы в зависимости от ситуации. Например при неудавшейся попытке установить cliff версии 1.3.3 наблюдалась ошибка которая исправилась при обновллении до 1.4 (просто прописать в `requirments.txt`). 

Сборка документации Django в HTML

Выполняем:

python translator.py create

Результат будет в _build/html/index.html. Сразу открыть документацию в браузере можно так:

python translator.py open

Сборка документации Django в PDF

Во первых для сборки PDF файла нужны пакеты latex:

pacman -S texlive-most texlive-lang

Для сборки выполняем:

make latexpdf LANGUAGE=ru

Учитывая отличия версий latex возможны ошибки, которые можно пропустить нажимая ентер (мейк тоже завершится с ошибкой). У меня из ошибок появились две "FancyVerb Error:   Empty verbatim environment", и "LaTeX Error: Command \dh unavailable in encoding T2A.". Если знаете как это исправить, пишите в комментариях. Несмотря на ошибки, результат будет находится в файле `_build/latex/django.pdf`