Installation on 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

Installation von Python

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

  2. Install Python with the installation wizard. Please make sure that you enable the „Add Python to PATH“ option:

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

    The option must be enabled so you can build the manual with the make script.

    All other settings can remain as set by default.

Installation von SVN und herunterladen des Repositorys

In dieser Anleitung werden wir TortoiseSVN verwenden, wenngleich es mit jedem Subversion-Client funktioniert.

  1. Download TortoiseSVN for Windows.
  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 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. Open the new folder, right-click and choose SVN Checkout… from the context menu.
  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. Click OK – the repository will now be downloaded which may take a few minutes depending on your internet connection.

Die Erstellungs-Umgebung einrichten

  • Open a Command Prompt. (Run as Administrator)

  • Enter the blender_docs folder which was just added by the SVN checkout:

    cd C:\blender_docs

  • Inside that folder is a file called requirements.txt which contains a list of all the dependencies we need. Install all the dependencies using Python’s pip command:

    pip install -r requirements.txt

  • If all goes well, you should see the following message when it is finished:

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

Währens des Setups könnten Warnungen angezeigt werden; diese können Sie ignorieren. Falls jedoch Fehler auftauchen, 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

Continue with the next step: Building.