Godot引擎离线文档制作指南

Godot引擎离线文档制作指南

引用

CSDN

1.

https://blog.csdn.net/qq_31342903/article/details/141300784

本文将详细介绍如何制作Godot引擎的离线文档。通过下载官方文档源码和语言包，配置Python环境，最终构建出完整的离线文档。

1. 下载官方文档源码

访问Godot官方文档源码仓库：https://github.com/godotengine/godot-docs/tree/master

选择合适的分支，下载zip文件。解压后将获得文件夹godot-docs-4.3。

2. 下载语言包

访问Godot文档语言包仓库：https://github.com/godotengine/godot-docs-l10n

找到合适的分支，下载zip包。解压后将获得文件夹godot-docs-l10n-4.x。

3. 将第一步的文件复制到第二步的docs文件夹下

注意，需要将第一步中下载的顶级文件夹去掉，只保留其内部内容，然后复制到第二步解压得到的docs文件夹中。

4. 修改配置文件

打开配置文件，将其中的language = os.getenv("READTHEDOCS_LANGUAGE", "en")修改为language = os.getenv("READTHEDOCS_LANGUAGE", "zh_CN")，保存文件。

5. 配置Python环境

在命令行中创建虚拟环境：

py -m venv godot-docs-venv

激活虚拟环境：

godot-docs-venv\Scripts\activate.bat

更新预安装的软件包：

py -m pip install --upgrade pip setuptools

切换到docs文件夹下，然后运行：

pip3 install -r requirements.txt

最后一步构建文档：

make html

这一步需要大约一个小时的编译时间。等待编译成功后，在docs文件夹中会出现一个_build文件夹，其中的html文件夹就是编译好的Godot离线文档。整个文档大约为1.5GB。

本文来自CSDN