Installation sous macOS#

Ce guide couvre les sujets suivants :

  1. Installation des dépendances

  2. Téléchargement du dépôt

  3. Préparation de l’environnement de construction

Note

Ce guide repose beaucoup sur les outils en ligne de commande. Il suppose que vous êtes pour le moins familier avec l’application Terminal de macOS.

Installation des dépendances#

Installez ces paquets ou assurez-vous que vous les avez sur votre système.

Si vous utlisez Homebrew, lancez la commande suivante dans le terminal :

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

Téléchargement du dépôt#

Récupérer simplement le dépôt du manuel de Blender avec la commande :

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

À présent le dépôt va être téléchargé, ce qui pourrait prendre quelques minutes selon votre connexion Internet.

Préparation de l’environnement de construction#

Astuce

Il est recommandé de configurer et d’activer un environnement Python virtuel dans lequel les dépendances seront installées :

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

Répétez la commande source .venv/bin/activate pour réactiver l’environnement virtuel, chaque fois que vous ouvrez un nouveau terminal pour créer la documentation.

  • Ouvrez une fenêtre Terminal.

  • Entrez dans le dossier blender-manual qui vient d’être ajouté par la commande git clone :

    cd ~/blender-manual

  • Dans ce dossier, il y a un fichier nommé requirements.txt qui contient une liste de toutes les dépendances nécessaires. Pour installer ces dépendances, nous pouvons utiliser la commande pip :

    pip install -r requirements.txt

Note

À tout moment vous pouvez vous assurer que les dépendances de bibliothèques sont à jour avec la commande :

pip install -r requirements.txt --upgrade