Instalação no macOS¶

Este guia aborda os seguintes tópicos:

Instalando dependências
Baixando o repositório
Configurando o ambiente de construção

Nota

Este guia depende bastante das ferramentas de linha de comando. Ele assume que você esteja ao menos um pouco familiarizado com o aplicativo de Terminal do macOS.

Instalando as dependências¶

Instale estes pacotes ou certifique-se que você já os tem em seu sistema.

When using Homebrew, run the following commands in the terminal:

python3 -m ensurepip
brew install git git-lfs
git lfs install

Baixando o repositório¶

Simply check out the Blender Manual’s repository using:

cd ~
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.

Configurando o ambiente de construção¶

Dica

It is recommended to setup and activate a virtual Python environment where dependencies will be installed:

python3 -m venv .venv
source .venv/bin/activate

Repeat the source .venv/bin/activate command to re-activate the virtual environment, whenever you open a new terminal to build the documentation.

Open a Terminal window.
Enter the blender-manual folder which was just added by git clone:
```
cd ~/blender-manual
```
Dentro desta pasta, existe um arquivo chamado requirements.txt, o qual contém uma lista de todas as dependências as quais precisamos, então, podemos usar o seguinte comando pip:
```
pip install -r requirements.txt
```

Nota

Every now and then you may want to make sure your dependencies are up to date using:

pip install -r requirements.txt --upgrade