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

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

  1. Установка зависимостей

  2. Скачивание хранилища

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

Примечание

Это руководство очень сильно полагается на использование инструментов командной строки. Оно предполагает, что вы как минимум знакомы с приложением Терминал macOS.

Установка зависимостей

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

При использовании Homebrew, выполните следующие команды в терминале:

python3 -m ensurepip
brew install git git-lfs
git lfs install

Скачивание хранилища

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

cd ~
git clone https://projects.blender.org/blender/blender-manual.git

Сейчас начнётся загрузка репозитория, что может занять несколько минут в зависимости от вашего интернет-соединения.

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

Совет

Рекомендуется настроить и активировать виртуальную среду Python, в которой будут установлены зависимости:

python3 -m venv .venv
source .venv/bin/activate

Повторяйте команду source .venv/bin/activate, чтобы повторно активировать виртуальную среду, всякий раз, когда открываете новый терминал для сборки документации.

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

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

    cd ~/blender-manual

  • Внутри этого каталога лежит файл requirements.txt, который содержит список всех необходимых зависимостей. Для установки этих зависимостей мы используем команду pip:

    pip install -r requirements.txt

Примечание

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

pip install -r requirements.txt --upgrade