在 macOS 上安装¶
本指南包含以下主题:
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
Install dependencies:
make setup
Note
Every now and then you need to re-run this command, to make sure dependencies are up to date.
Tip
make setup
automatically creates a virtual environment using these commands:
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt
This avoids interfering with the system Python installation, following PEP 668
The Sphinx command is available at:
.venv/bin/sphinx-build