在 linux 上安装

本指南包含以下主题：

  1. 安装依赖关系

  2. 下载代码库

  3. 设置编译环境

安装依赖关系

下面列出了几种流行 Linux 发行版的安装命令。

对应的系统，使用对应的命令：

Debian/Ubuntu:

sudo apt-get install python3 python3-pip git git-lfs
git lfs install --skip-repo

Redhat/Fedora:

sudo dnf install python python-pip git git-lfs
git lfs install --skip-repo

Arch Linux:

sudo pacman -S python python-pip git git-lfs
git lfs install --skip-repo

下载代码库

使用下面的命令检出 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