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

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

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

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

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

Примечание

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

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

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

When using Homebrew, run the following commands in the terminal:

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

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

Simply check out the Blender Manual’s repository using:

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

The repository will now be downloaded which may take a few minutes depending on your internet connection.

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

Совет

It is recommended to setup and activate a virtual Python environment where dependencies will be installed:

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

Repeat the source .venv/bin/activate command to re-activate the virtual environment, whenever you open a new terminal to build the documentation.

  • Open a Terminal window.

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

    cd ~/blender-manual

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

    pip install -r requirements.txt

Примечание

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

pip install -r requirements.txt --upgrade