Windows上安装

本指南包含以下主题：

  1. 安装Python (用于 转换 原始文件为HTML)

  2. 安装Git并下载代码库

  3. 设置编译环境

安装Python

  1. 下载适用于 Windows 的 Python installation package，本指南使用版本为 3.9.x 。

  2. 使用安装向导安装Python。记得勾选 Add Python to PATH 选项：

    ../../_images/about_contribute_install_windows_installer.png

    该选项必须勾选，这样才能使用脚本编译手册。

    其余所有设置维持默认。

安装Git并下载代码库

In this guide, we will use the official Git client, though any Git client will do.

  1. 下载并安装Windows版的 Git。

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

    1. cd ~
    2. git lfs install
    3. git clone https://projects.blender.org/blender/blender-manual.git

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

Note

This process can be completed using a graphical Git client, in that case you will just use the repository address in the URL field provided by your client:

  1. https://projects.blender.org/blender/blender-manual.git

设置编译环境

Tip

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

  1. python3 -m venv .venv
  2. .venv/Scripts/activate

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

  • 打开命令行提示符。（使用管理员启动）

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

    1. cd C:\blender-manual

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

    1. pip install -r requirements.txt

  • 如果一切顺利，完成后会显示以下信息：

    1. Successfully installed Jinja2 MarkupSafe Pygments Sphinx docutils sphinx-rtd-theme Cleaning up...

在安装过程中，可能会显示一些警告，但不要担心。但是如果发生任何错误，则可能会造成一些问题。

Note

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

  1. pip install -r requirements.txt --upgrade