Windows上安装

本指南包含以下主题:

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

  2. Installing Git and Downloading the Repository

  3. 设置编译环境

安装Python

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

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

    ../../_images/about_contribute_install_windows_installer.png

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

    其余所有设置维持默认。

Installing Git and Downloading the Repository

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

  1. 下载并安装Windows版的 Git

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

    cd ~
    git lfs install
    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:

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

设置编译环境

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

  • Enter the blender-manual folder which was just added by git clone:

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

    pip install -r requirements.txt
    
  • 如果一切顺利,完成后会显示以下信息:

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

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

Note

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

pip install -r requirements.txt --upgrade