Installation unter Windows

Diese Anleitung deckt folgende Themen ab:

  1. Installation von Python (wird benutzt um die Quelldateien in HTML zu „konvertieren“)

  2. Installation von SVN und Herunterladen des Repositorys

  3. Die Erstellungs-Umgebung einrichten

Python installieren

  1. Download the Python installation package for Windows. In this guide version 3.9.x is used.

  2. Installieren Sie Python mit dem Assistenten. Bitte stellen Sie sicher, dass die Option „Add Python to PATH“ aktiviert ist:

    ../../../_images/about_contribute_install_windows_installer.png

    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.

Warnung

Python 3.10 is not yet support, it is recommended to use Python 3.9 or earlier.

Installation von SVN und Herunterladen des Dateiverzeichnisses (Repository)

In dieser Anleitung werden wir TortoiseSVN verwenden, wenngleich jeder Subversion-Client funktioniert.

  1. Laden Sie TortoiseSVN für Windows herunter.

  2. Installieren Sie TortoiseSVN mit dem Assistenten. Bei der Auswahl der zu installierenden Komponenten wird empfohlen, das Häkchen bei command line client tools zu setzen, um SVN von der Kommandozeile aus verwenden zu können (das schadet nicht und kann hilfreich sein, falls Sie je Probleme bekommen).

  3. Nachdem die Installation beendet ist, erstellen Sie einen neuen Ordner, der alles enthalten wird, was mit dem Blender-Handbuch zu tun hat. In dieser Anleitung werden wir C:\blender_docs verwenden.

  4. Öffnen Sie den neuen Ordner, rechtsklicken Sie und wählen Sie SVN Checkout… aus dem Kontextmenü.

  5. Im Feld URL of repository geben Sie https://svn.blender.org/svnroot/bf-manual/trunk/blender_docs ein.

  6. Im Feld Checkout directory geben Sie C:\blender_docs ein.

  7. Klicken Sie OK um das Repository herunterzuladen. Dies kann -abhängig von Ihrer Internetverbindung- ein paar Minuten dauern.

Die Erstellungs-Umgebung einrichten

  • Öffnen Sie eine Kommandozeile. (als Administrator ausführen)

  • Öffnen Sie den blender_docs-Ordner, der gerade vom SVN-Checkout hinzugefügt wurde:

    cd C:\blender_docs

  • 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

  • Wenn alles funktioniert, sollten Sie nach dem Abschluss folgende Meldung sehen:

    Successfully installed Jinja2 MarkupSafe Pygments Sphinx docutils sphinx-rtd-theme Cleaning up...

Währens des Setups können einige Warnungen angezeigt werden; diese können Sie ignorieren. Falls jedoch Fehler auftauchen sollten, können daraus Probleme entstehen.

Bemerkung

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

pip install -r requirements.txt --upgrade