在 macOS 上安装

本指南包含以下主题：

  1. 安装依赖关系

  2. 下载代码库

  3. 设置编译环境

Note

本指南十分依赖命令行工具，所以假设你对 masOS 终端应用有所熟悉。

安装依赖关系

安装下面的包，或者确保你的系统已经安装好。

使用 Homebrew 时，在终端运行以下命令:

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

下载代码库

使用下面的命令检出 Blender 手册代码库:

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

代码库下载需要几分钟时间，这取决于你的网络连接。

设置编译环境

  • 打开终端窗口。

  • 进入刚刚由 git clone 添加的 blender-manual 文件夹:

    cd ~/blender-manual

  • 安装依赖项:

    make setup

Note

您需要不时地重新运行此命令，以确保依赖关系是最新的。

Tip

make setup 使用以下命令自动创建虚拟环境:

python3 -m venv .venv
.venv/bin/pip install -r requirements.txt

这避免了干扰系统 Python 安装，遵循 PEP 668

The Sphinx command is available at:

.venv/bin/sphinx-build