在 macOS 上安装

本指南包含以下主题：

1. 安装依赖关系

2. 下载代码库

3. 设置编译环境

Note

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

安装依赖关系

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

• PIP

• Git

• Git LFS

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

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

下载代码库

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

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

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

设置编译环境

Tip

建议设置并激活一个虚拟 Python 环境，在该环境中安装依赖项:

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

每当您打开一个新终端来构建文档时，请重复 source .venv/bin/activate 命令以重新激活虚拟环境。

• 打开终端窗口。

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

  cd ~/blender-manual
  

• 文件夹中有一个名为 requirements.txt 的文件，包含了一系列需要安装的依赖关系。要安装这些依赖关系，可以使用 pip 命令:

  pip install -r requirements.txt
  

Note

时不时使用下面的命令确认你的依赖库是不是最新的:

pip install -r requirements.txt --upgrade