Instalação no macOS

Este guia aborda os seguintes tópicos:

  1. Instalando dependências

  2. Baixando o repositório

  3. 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

  • Open a Terminal window.

  • Enter the blender-manual folder which was just added by git clone:

    cd ~/blender-manual
    
  • Install dependencies:

    make setup
    

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:

python3 -m venv .venv
.venv/bin/pip install -r requirements.txt

This avoids interfering with the system Python installation, following PEP 668

The Sphinx command is available at:

.venv/bin/sphinx-build