Installation unter Windows¶
Diese Anleitung deckt folgende Themen ab:
Installation von Python (wird benutzt um die Quelldateien in HTML zu „konvertieren“)
Python installieren¶
Download the Python installation package for Windows. In this guide version 3.9.x is used.
Installieren Sie Python mit dem Assistenten. Bitte stellen Sie sicher, dass die Option „Add Python to PATH“ aktiviert ist:
Die Option muss aktiviert sein, damit Sie das Handbuch mithilfe des „make-Skripts“ erstellen können.¶
Alle anderen Einstellungen können bei ihren Standardwerten belassen werden.
Installing Git and Downloading the Repository¶
In this guide, we will use the official Git client, though any Git client will do.
Download and install Git for Windows.
Führen Sie nun einfach den „Check-out“ des Blender-Nutzerhandbuch-Repository durch mit:
cd ~ git lfs install git clone https://projects.blender.org/blender/blender-manual.git
Das Repository wird nun heruntergeladen, was je nach Internetverbindung einige Minuten dauern kann.
Bemerkung
This process can be completed using a graphical Git client, in that case you will just use the repository address in the URL field provided by your client:
https://projects.blender.org/blender/blender-manual.git
Die Erstellungs-Umgebung einrichten¶
Öffnen Sie ein Terminal-Fenster.
Enter the
blender-manual
folder which was just added bygit clone
:cd C:\blender-manual
Install dependencies:
make setup
Wenn alles funktioniert, sollten Sie nach dem Abschluss folgende Meldung sehen:
Successfully installed Jinja2 MarkupSafe Pygments Sphinx docutils sphinx-rtd-theme Cleaning up...
During setup, some warnings may be shown, but do not worry about them. However, if any errors occur, they may cause some problems.
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:
python -m venv .venv
.venv/Scripts/pip install -r requirements.txt
This avoids interfering with the system Python installation, following PEP 668
The Sphinx command is available at:
.venv/Scripts/sphinx-build