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

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

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

  2. Installing Git 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.

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

Installing Git and Downloading the Repository

In this guide, we will use the official Git client, though any Git client will do.

  1. Download and install Git for Windows.

  2. Просто підтвердьте репозиторій підручника Blender Manual, використовуючи:

    cd ~
    git lfs install
    git clone https://projects.blender.org/blender/blender-manual.git
    
  3. Цей репозиторій тепер буде завантажено, що може тривати кілька хвилин, залежно від вашого інтернет з’єднання.

Примітка

This process can be completed using a graphical Git client, in that case you will just use the repository address in the URL field provided by your client:

https://projects.blender.org/blender/blender-manual.git

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

  • Відкрийте вікно Терміналу.

  • Enter the blender-manual folder which was just added by git clone:

    cd C:\blender-manual
    
  • Install dependencies:

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

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

During setup, some warnings may be shown, but do not worry about them. However, if any errors occur, they may cause some problems.

Примітка

Every now and then you need to re-run this command, to make sure dependencies are up to date.

Порада

make setup automatically creates a virtual environment using these commands:

python -m venv .venv
.venv/Scripts/pip install -r requirements.txt

This avoids interfering with the system Python installation, following PEP 668

The Sphinx command is available at:

.venv/Scripts/sphinx-build