Início > Django, Python > PDF e HTMLs com documentação completa do Django atualizada

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

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 (versão 1.o ou superior) e o Latex estejam instalados.

No meu caso, fiz o seguinte para que tudo funcionasse no Ubuntu:

sudo easy_install -U Sphinx
sudo apt-get install texlive-latex-base texlive-fonts-recommended texlive-latex-recommended texlive-latex-extra

Observe que o comando sudo easy_install -U Sphinx não serve somente para instalar o Sphinx. Ele ainda permite a atualização para a última versão do Sphinx, caso uma versão anterior  já esteja instalada.

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.

Categorias:Django, Python Tags:,
  1. 21/08/2010 às 00:41

    Régis, parabéns pelo artigo, queria só fazer um adendo, o comando: make latexpdf só dá pra ser executado se o desenvolvedor tiver a versão do Sphinx 1.0 instalada.

    O ideal mesmo seria na instalação do Sphinx usar: sudo easy_install -U Sphinx para que atualize para última versão, caso já tenha alguma versão instalada.

    Release 1.0 (Jul 23, 2010)
    http://sphinx.pocoo.org/changes.html#features-added

    • regispires
      21/08/2010 às 09:01

      Obrigado pela observação, Charleno. Alterei o post para ficar de acordo com seu comentário.

  2. 21/08/2010 às 10:50

    To usando seu post como referência em documentação offline😉

    • regispires
      21/08/2010 às 10:55

      Novamente, obrigado, Charleno e qualquer contribuição sua será sempre bem vinda, amigo!!!

  1. 26/09/2014 às 23:31

Deixe uma resposta

Preencha os seus dados abaixo ou clique em um ícone para log in:

Logotipo do WordPress.com

Você está comentando utilizando sua conta WordPress.com. Sair / Alterar )

Imagem do Twitter

Você está comentando utilizando sua conta Twitter. Sair / Alterar )

Foto do Facebook

Você está comentando utilizando sua conta Facebook. Sair / Alterar )

Foto do Google+

Você está comentando utilizando sua conta Google+. Sair / Alterar )

Conectando a %s

%d blogueiros gostam disto: