Установка на Windows

Это руководство покрывает следующие темы:

  1. Установка Python (используется для «преобразования» исходных файлов в HTML)

  2. Установка Git и загрузка репозитория

  3. Установка окружения сборки

Установка Python

  1. Загрузите пакет установки Python для Windows. В этом руководстве используется версия 3.9.x.

  2. Установите Python с помощью мастера установки. Пожалуйста, убедитесь, что вы включили опцию «Add Python to PATH»:

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

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

    Все остальные настройки можно оставить по умолчанию.

Установка Git и загрузка репозитория

В этом руководстве мы будем использовать официальный клиент Git, хотя подойдет любой другой клиент Git.

  1. Загрузите и установите Git для Windows.

  2. Просто ознакомьтесь с репозиторием руководства Blender, используя:

    cd ~
    git lfs install
    git clone https://projects.blender.org/blender/blender-manual.git
    
  3. Сейчас начнётся загрузка репозитория, что может занять несколько минут в зависимости от вашего интернет-соединения.

Примечание

Этот процесс можно выполнить с помощью графического клиента Git. В этом случае вам просто нужно будет указать адрес репозитория в поле URL, предоставленном вашим клиентом:

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

Установка окружения сборки

  • Откройте окно терминала.

  • Войдите в папку blender-manual, которая была только что добавлена с помощью git clone:

    cd C:\blender-manual
    
  • Установите зависимости:

    make setup
    
  • Если всё прошло хорошо, вы увидите следующее сообщение по завершению операции:

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

Во время настройки могут быть показаны некоторые предупреждения, но не беспокойтесь о них. Однако, если возникнут какие-либо ошибки, они могут вызвать некоторые проблемы.

Примечание

Теперь, каждый раз, если вы захотите убедиться, что ваши зависимости актуальны, вам следует выполнять эту команду.

Совет

make setup автоматически создаёт виртуальную среду с помощью следующих команд:

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

Это позволяет избежать вмешательства в системную установку Python в соответствии с PEP 668

Команды Sphinx доступны тут:

.venv/Scripts/sphinx-build