Installation on Windows

Ta vodič se osredotoča na naslednje teme:

  1. Nameščanje Pythona (ki bo „pretvoril“ izvorne datoteke v HTML)

  2. Installing SVN and Downloading the Repository

  3. Nastavljanje okolja za gradnjo priročnika

Nameščanje Pythona

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

  2. S pomočjo čarovnika za namestitev namestite Pythona. Prosimo, prepričajte se, da med namestitvijo odkljukate možnost „Add Python to PATH“:

    ../../_images/about_contribute_install_windows_installer.png

    Ta možnost mora biti omogočena, da boste lahko priročnik zgradili s skripto make.

    Vse ostale nastavitve lahko pustite take, kot so.

Installing SVN and Downloading the Repository

In this guide, we will use TortoiseSVN though any Subversion client will do.

  1. Download TortoiseSVN for Windows.

  2. Install TortoiseSVN with the installation wizard. When choosing which features will be installed, it is recommended that you enable command line client tools to give you access to SVN from the command line (there is no harm in doing this, and it may be helpful if you ever run into any trouble).

  3. Once the installation has finished, create a new folder that will contain everything related to the Blender Manual. In this guide, we will use C:\blender_docs.

  4. Open the new folder, right-click and choose SVN Checkout… from the context menu.

  5. In the URL of repository field, enter: https://svn.blender.org/svnroot/bf-manual/trunk/blender_docs.

  6. In the Checkout directory field, enter: C:\blender_docs.

  7. Click OK – the repository will now be downloaded which may take a few minutes depending on your internet connection.

Nastavljanje okolja za gradnjo priročnika

  • Open a Command Prompt. (Run as Administrator)

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

    cd C:\blender_docs

  • V tej mapi je datoteka, imenovana requirements.txt, ki vsebuje seznam vseh odvisnih paketov, ki jih potrebujete. Namestite jih z ukazom pip:

    pip install -r requirements.txt

  • Če bo šlo vse po sreči, boste ob koncu nameščanja videli sporočilo:

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

Med nameščanjem utegnete dobiti nekaj opozoril, vendar se zanje ne menite. Dosti bolj kočljivo je, če vam konzola javi napako.

Opomba

Od časa do časa se prepričajte, da imate najnovejše odvisne pakete:

pip install -r requirements.txt --upgrade