Estou gerando periodicamente, através do Sphinx, um PDF e um arquivo compactado com os HTMLs de toda a documentação do Django atualizada para acesso offline. A primeira página do PDF mostra a data em que a documentação foi gerada e o link permanente para baixar sempre a versão mais atual é: http://dl.dropbox.com/u/1477113/material_didatico/python/django.pdf
Já para baixar os HTMLs para acesso offline basta acessar: http://dl.dropbox.com/u/1477113/material_didatico/python/django_html.zip
Para quem tiver interesse em gerar seu próprio PDF e a documentação do Django em HTML para acesso offline, basta seguir o seguintes passos:
1. Baixar a última versão da documentação através de Subversion a partir do comando a seguir:
svn co http://code.djangoproject.com/svn/django/trunk/docs/ django_docs
1.1 O passo acima só precisa ser feito da primeira vez. Para novas atualizações basta executar:
svn update
Caso você não tenha o subversion instalado, basta fazer o seguinte no Ubuntu:
sudo apt-get install subversion
2. Mudar para o diretório da documentação:
cd django_docs/
3. Gerar a documentação em HTML:
make html
4. Gerar a documentação em PDF:
make latexpdf
Para que tudo isso funcione é necessário que o Sphinx e o Latex estejam instalados.
No meu caso, fiz o seguinte para que tudo funcionasse no Ubuntu:
sudo easy_install Sphinx sudo apt-get install texlive-latex-base texlive-fonts-recommended texlive-latex-recommended texlive-latex-extra
Caso você não tenha o easy_install instalado, ainda será necessário mais um passo antes de instalar o Sphinx:
sudo apt-get install python-setuptools
Quem quiser evitar esses passos, é só acessar os arquivos que estou gerando e que vou atualizar periodicamente.
0sem comentários ainda