Installation unter macOS

Diese Anleitung deckt folgende Themen ab:

  1. Unterprogramme (Dependencies) installieren

  2. Das Dateiverzeichnis (Repository) herunterladen

  3. Die Erstellungs-Umgebung einrichten

Bemerkung

Diese Anleitung stützt sich stark auf Befehlszeilen-Tools. Es wird vorausgesetzt, dass Sie mindestens mit der macOS-Terminal-Anwendung vertraut sind.

Dependencies installieren

Installieren Sie diese Pakete, oder stellen Sie sicher, dass Sie sie auf Ihrem System haben.

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

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

Das Repository herunterladen

Führen Sie nun einfach den „Check-out“ des Blender-Nutzerhandbuch-Repository durch mit:

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

Das Repository wird nun heruntergeladen, was je nach Internetverbindung einige Minuten dauern kann.

Die Erstellungs-Umgebung einrichten

Tipp

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.

  • Öffnen Sie ein Terminal-Fenster.

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

    cd ~/blender-manual
    
  • In diesem Ordner befindet sich eine Datei namens requirements.txt, welche eine Auflistung all der benötigten „Unterdateien“ (dependencies) enthält. Installieren Sie alle diese Unterdateien mithilfe von Pythons pip-Befehl:

    pip install -r requirements.txt
    

Bemerkung

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

pip install -r requirements.txt --upgrade