Inštalácia pre Windows

Tento návod sa zaoberá nasledujúcimi témami:

1. Inštalácia jazyka Python (slúži na „konvertovanie“ zdrojových súborov na HTML)

2. Inštalácia SVN a stiahnutie úložiska

3. Nastavenie prostredia pre zostavenie

Inštalácia Pythonu

1. Stiahnite si inštalačný balík Python pre Windows. V tejto príručke sa používa verzia 3.9.x.

2. Nainštalujte Python pomocou sprievodcu inštaláciou. Uistite sa, že ste povolili možnosť „Pridať Python do PATH“:

   

   Táto možnosť musí byť povolená, aby ste mohli vytvoriť manuál so skriptom make.

   Všetky ostatné nastavenia môžu zostať tak, ako sú predvolene nastavené.

Varovanie

Python 3.10 zatiaľ nie je podporovaný, odporúča sa používať Python 3.9 alebo starší.

Inštalácia SVN a stiahnutie úložiska

V tejto príručke budeme používať TortoiseSVN, hoci to urobí každý klient Subversion.

1. Stiahnite si program TortoiseSVN pre Windows.

2. Nainštalujte TortoiseSVN pomocou sprievodcu inštaláciou. Pri výbere funkcií, ktoré sa majú nainštalovať, sa odporúča povoliť klientské nástroje príkazového riadku, aby ste mali prístup k SVN z príkazového riadku (nie je to na škodu, môže to byť užitočné, ak narazíte na akýkoľvek problém).

3. Po dokončení inštalácie vytvorte nový priečinok, ktorý bude obsahovať všetko, čo sa týka Blender manuálu. V tomto návode použijeme C:\blender_docs.

4. Otvorte nový priečinok, kliknite pravým tlačidlom myši a v kontextovej ponuke vyberte možnosť SVN Checkout….

5. Do poľa URL of reposity zadajte: https://svn.blender.org/svnroot/bf-manual/trunk/blender_docs.

6. Do poľa Checkout directory zadajte: C:\blender_docs.

7. Kliknite na OK - úložisko sa teraz stiahne, čo môže trvať niekoľko minút, v závislosti od vášho internetového pripojenia.

Nastavovanie zostavenia prostredia

• Otvorte príkazový riadok. (Spustiť ako správca)

• Prejdite do priečinka blender_docs, ktorý bol práve pridaný kontrolným výstupom SVN:

  cd C:\blender_docs
  

• V tomto priečinku sa nachádza súbor s názvom requirements.txt, ktorý obsahuje zoznam všetkých závislostí, ktoré potrebujeme. Nainštalujte všetky závislosti použitím Python príkazu pip:

  pip install -r requirements.txt
  

• Ak všetko pôjde dobre, po dokončení by sa mala zobraziť nasledujúca správa:

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

Počas nastavenia sa môžu zobraziť niektoré varovania, ale nemusíte sa ich obávať. Ak sa však vyskytnú chyby, môžu spôsobiť určité problémy.

Poznámka

Občas budete chcieť ubezpečiť, či vaše závislosti sú aktuálne, a to použitím:

pip install -r requirements.txt --upgrade