Installation on Windows

Ta vodič se osredotoča na naslednje teme:

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

  2. Nameščanje SVN-ja in prenašanje repozitorija

  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.

Nameščanje SVN-ja in prenašanje repozitorija

V tem vodiču bomo uporabili TortoiseSVN, čeprav bo zadovoljiv vsak Subversion klient.

  1. Download TortoiseSVN for Windows.

  2. S pomočjo čarovnika za namestitev namestite TortoiseSVN. Ko izbirate, katere funkcije bodo nameščene, priporočamo, da vključite command line client tools. Tako boste dobili dostop do SVN-ja prek ukazne vrstice (to vam ne bo povzročilo težav, celo uporabno bo, če kdaj naletite na težave).

  3. Ko je namestitev končana, ustvarite novo mapo, ki bo vsebovala vse v povezavi s priročnikom. V tem vodiču bomo uporabili lokacijo C:\blender_docs.

  4. Odprite novo mapo, kliknite z desnim gumbom in v meniju izberite SVN Checkout….

  5. V polje URL of repository vpišite: https://svn.blender.org/svnroot/bf-manual/trunk/blender_docs.

  6. V polje Checkout directory vpišite: C:\blender_docs.

  7. Kliknite OK – repozitorij se bo prenesel, kar utegne trajati nekaj minut, odvisno od vaše internetne povezave.

Nastavljanje okolja za gradnjo priročnika

  • Open a Command Prompt. (Run as Administrator)

  • Premaknite se v mapo blender_docs, ki je nastala ob SVN-odjavi:

    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