Інсталяція на Windows¶
Цей путівник охоплює такі теми:
Інсталювання Python – Installing Python (використовується для «конвертування» джерельних файлів у HTML)
Setting up the Build Environment – Укладання Середовища Вибудування
Інсталювання Python – Installing Python¶
Завантажте пакет інсталяції Python installation package для Windows. У цьому путівнику використовується версія 3.9.x.
Інсталюйте Python за допомогою майстра інсталяції. Будь ласка, переконайтеся, що ви увімкнути опції «Add Python to PATH»:
Ця опція повинна бути увімкнена, щоб ви могли вибудувати цей довідник за допомогою скрипту make.¶
Усі інші устави можуть бути залишені, як вони задані стандартно.
Installing Git and Downloading the Repository¶
In this guide, we will use the official Git client, though any Git client will do.
Download and install Git for Windows.
Просто підтвердьте репозиторій підручника Blender Manual, використовуючи:
cd ~ git lfs install git clone https://projects.blender.org/blender/blender-manual.git
Цей репозиторій тепер буде завантажено, що може тривати кілька хвилин, залежно від вашого інтернет з’єднання.
Примітка
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 bygit 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