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

  • Öffnen Sie ein Terminal-Fenster.

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

    cd ~/blender-manual

  • Install dependencies:

    make setup

Bemerkung

Every now and then you need to re-run this command, to make sure dependencies are up to date.

Tipp

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