Installation unter macOS#

Diese Anleitung deckt folgende Themen ab:

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

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.

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