Installation on Windows

Este guia aborda os seguintes tópicos:

  1. Instalando o Python (usado para «converter» os arquivos de fonte para HTML)
  2. Instalando o SVN e baixando o repositório
  3. Configurando o ambiente de construção

Instalando o Python

  1. Download the Python installation package for Windows. In this guide version 3.6.x is used.

  2. Instale Python com o assistente de instalação. Por favor, certifique-se de habilitar a opção «Add Python to Path» (Adicionar Python para o caminho):

    ../../../_images/about_contribute_install_windows_installer.png

    A opção deve ser habilitada de maneira que você possa construir o manual usando o script «make».

    Todas as outras configurações podem permanecer como definidas por padrão.

Instalando o SVN e baixando o repositório

Neste guia, nós utilizaremos o software TortoiseSVN, mesmo assim, qualquer outro software cliente de Subversion servirá para a tarefa.

  1. Download TortoiseSVN for Windows.
  2. Instale o TortoiseSVN através dos passos do assistente de instalação. Ao ser perguntado sobre quais funcionalidades serão instaladas, é recomendável que você habilite a opção Ferramentas de linha de comando para cliente ( «command line client tools») para que você tena acesso ao SVN a partir da linha de comando (não há qualquer risco em instalar dessa maneira, e isso pode ser útil caso você por alguma razão, tenha quaisquer problemas).
  3. Uma vez que a instalação tenha terminado, crie uma nova pasta que irá conter todas as coisas relacionadas ao manual do Blender. Neste guia, nós utilizaremos C:\blender_docs.
  4. Abra a nova pasta, clique com o botão direito e escolha SVN Checkout… a partir do menu de contexto.
  5. Dentro do campo URL of repository, entre com o seguinte texto: https://svn.blender.org/svnroot/bf-manual/trunk/blender_docs.
  6. Dentro do campo Checkout directory, entre com o seguinte texto: C:\blender_docs.
  7. Clique em OK – o repositório agora irá ser baixado, o que pode demorar alguns minutos dependendo de sua conexão de internet.

Configurando o ambiente de construção

  • Open a Command Prompt. (Run as Administrator)

  • Entre na pasta blender_docs que foi recém adicionada pelo SVN checkout:

    cd C:\blender_docs

  • Dentro dessa pasta está um arquivo chamado requirements.txt que contém uma lista de todas as dependências que precisamos. Instale todas as dependências usando o comando pip do Python:

    pip install -r requirements.txt

  • Se tudo correr bem, você deve ver a seguinte mensagem quando terminar:

    Successfully installed Jinja2 MarkupSafe Pygments Sphinx docutils sphinx-rtd-theme Cleaning up...

Durante a configuração, alguns avisos podem ser mostrados, mas não se preocupe com eles. Contudo, caso quaisquer erros ocorram, eles podem causar alguns problemas.

Nota

Daqui em diante, talvez você queira ter certeza de que suas dependências estão atualizadas usando:

pip install -r requirements.txt --upgrade

Continue com o próximo passo: Construindo