Ir para o conteúdo
ou

Software livre Brasil

 Voltar a Projeto Soft...
Tela cheia Sugerir um artigo

Regis Pires: PDF e HTMLs com documentação completa do Django atualizada

7 de Agosto de 2010, 0:00 , por Software Livre Brasil - 0sem comentários ainda | Ninguém está seguindo este artigo ainda.
Visualizado 233 vezes

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.



Fonte: http://regispires.wordpress.com/2010/08/07/pdf-e-htmls-com-documentacao-completa-do-django-atualizada/

0sem comentários ainda

Enviar um comentário

Os campos são obrigatórios.

Se você é um usuário registrado, pode se identificar e ser reconhecido automaticamente.