Instalação no Windows¶
Este guia aborda os seguintes tópicos:
Instalando o Python (usado para «converter» os arquivos de fonte para HTML)
Instalando o Python¶
Download the Python installation package for Windows. In this guide version 3.9.x is used.
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):
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.
Installing Git and Downloading the Repository¶
In this guide, we will use the official Git client, though any Git client will do.
Download and install Git for Windows.
Simply check out the Blender Manual’s repository using:
cd ~ git lfs install git clone https://projects.blender.org/blender/blender-manual.git
The repository will now be downloaded which may take a few minutes depending on your internet connection.
Nota
This process can be completed using a graphical Git client, in that case you will just use the repository address in the URL field provided by your client:
https://projects.blender.org/blender/blender-manual.git
Configurando o ambiente de construção¶
Open a Terminal window.
Enter the
blender-manual
folder which was just added bygit clone
:cd C:\blender-manual
Install dependencies:
make setup
Se tudo correr bem, você deve ver a seguinte mensagem quando terminar:
Successfully installed Jinja2 MarkupSafe Pygments Sphinx docutils sphinx-rtd-theme Cleaning up...
During setup, some warnings may be shown, but do not worry about them. However, if any errors occur, they may cause some problems.
Nota
Every now and then you need to re-run this command, to make sure dependencies are up to date.
Dica
make setup
automatically creates a virtual environment using these commands:
python -m venv .venv
.venv/Scripts/pip install -r requirements.txt
This avoids interfering with the system Python installation, following PEP 668
The Sphinx command is available at:
.venv/Scripts/sphinx-build