Інсталяція на Windows

Цей путівник охоплює такі теми:

  1. Інсталювання Python – Installing Python (використовується для «конвертування» джерельних файлів у HTML)

  2. Інсталювання SVN та Завантаження Репозиторію – Installing SVN and Downloading the Repository

  3. Укладання Середовища Вибудування – Setting up the Build Environment

Інсталювання Python – Installing Python

  1. Завантажте пакет інсталяції Python installation package для Windows. У цьому путівнику використовується версія 3.9.x.

  2. Інсталюйте Python за допомогою майстра інсталяції. Будь ласка, переконайтеся, що ви увімкнути опції «Add Python to PATH»:

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

    Ця опція повинна бути увімкнена, щоб ви могли вибудувати цей довідник за допомогою скрипту make.

    Усі інші устави можуть бути залишені, як вони задані стандартно.

Попередження

Python 3.10 поки не підтримується, рекомендується використовувати Python 3.9 або раніше.

Інсталювання SVN та Завантаження Репозиторію – Installing SVN and Downloading the Repository

У цьому путівнику ми будемо використовувати TortoiseSVN через будь-який клієнт Subversion.

  1. Завантажте TortoiseSVN для Windows.

  2. Інсталюйте TortoiseSVN за допомогою майстра інсталяції. При виборі, які функціональності будуть інстальовані, рекомендується, щоб ви увімкнули засоби клієнта для командного рядка command line client tools, щоб надати вам доступ до SVN з командного рядка (це не зашкодить, і може бути корисним, якщо ви коли-небудь зіткнетеся з якоюсь халепою).

  3. Як тільки інсталяція завершена, створіть нову теку, що буде містити все, що стосується цього посібника Blender Manual. У цьому путівнику ми будемо використовувати C:\blender_docs.

  4. Відкрийте цю нову теку, клацніть ПКМ та виберіть для вивірення SVN Checkout… з контекстного меню.

  5. У полі опції URL of repository уведіть: https://svn.blender.org/svnroot/bf-manual/trunk/blender_docs.

  6. У полі опції Checkout directory, уведіть: C:\blender_docs.

  7. Клацніть OK – цей репозиторій буде завантажено, що може тривали кілька хвилин, залежно від вашого інтернет-з’єднання.

Setting up the Build Environment – Установка Середовища Вибудування

  • Відкрий командний рядок Command Prompt. (Запуск від імені адміністратора Run as Administrator)

  • У терміналі уведіть blender_docs, в яку буде додане вивірення SVN:

    cd C:\blender_docs

  • Всередині цієї теки знаходиться файл з іменем requirements.txt, який містить список усіх залежностей, що нам необхідні. Інсталюйте всі залежності за допомогою команди pip для Python’а:

    pip install -r requirements.txt

  • Якщо все пройшло добре, то ви повинні отримати наступне повідомлення після закінчення процесу:

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

Під час налаштування можуть показуватися деякі попередження, але не турбуйтеся щодо них. Проте, якщо трапляються якісь помилки, вони можуть спричинити деякі проблеми.

Примітка

Час від часу ви можете переконуватися, що ваші залежності в актуальному стані за допомогою:

pip install -r requirements.txt --upgrade