Інсталяція на 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.6.x.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • Увійдіть у теку blender_docs, яка була щойно додана опцією SVN checkout:

    cd C:\blender_docs

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

    pip install -r requirements.txt

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

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

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

Примітка

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

pip install -r requirements.txt --upgrade

Продовжимо на наступному етапі: Building.