Instal·lació en macOS

Aquesta guia cobreix els temes següents:

  1. Instal·lar dependencies

  2. Descarregar el repositori

  3. Configuració de l’entorn de compilació

Nota

Aquesta guia es basa en gran mesura en les eines de línia d’ordres. Se suposa que esteu familiaritzat amb l’aplicació Terminal del macOS.

Instal·lar dependències

Instal·leu aquests paquests o assegureu que els teniu en el vostre sistema.

Quan s’empra Homebrew, executeu les ordres següents al terminal:

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

Decarregar el repositori

Obtenir el manual del Blender des del repositori utilitzant:

cd ~
git clone https://projects.blender.org/blender/blender-manual.git

El repositori es descarregarà, el que pot suposar uns quants minuts en funció de la velocitat de la conexió a internet.

Preparar l’entorn de compilació

Truc

Es recomana configurar i activar un entorn virtual de Python on s’instal·laran les dependències:

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

Repetiu l’ordre source .venv/bin/activate per a reactivar l’entorn virtual sempre que obriu un nou terminal per a confegir la documentació.

  • Obrir una finestra del terminal.

  • Entreu a la carpeta blender-manual que acaba de crear git clone:

    cd ~/blender-manual
    
  • Dins d’aquesta carpeta hi un document anomenat requirements.txt que conte una llista de totes les dependencies que es necessiten. Per instal·lar-es es pot utilitzar la instrucció pip:

    pip install -r requirements.txt
    

Nota

De tant en tant, podeu assegurar-vos que les vostres dependències estiguin actualitzades mitjançant:

pip install -r requirements.txt --upgrade