新闻详情

新闻详情

首页 / 资讯中心 / 详情

Godot 文档本地构建实战:5 步从克隆到 HTML 成品

发布时间:2026/11/16 17:58:39来源:尧图网络
Godot 文档本地构建实战:5 步从克隆到 HTML 成品
Godot 文档本地构建实战5 步从克隆到 HTML 成品【免费下载链接】godot-docsGodot Engine official documentation项目地址: https://gitcode.com/GitHub_Trending/go/godot-docsgodot-docs 是Godot Engine官方文档的源码仓库全站页面用 reStructuredTextreST一种类似 Markdown 的轻量标记语言书写再经 Sphinx 工具链构建成 HTML 文档站。这个仓库本身就是全部内容——没有隐藏的编译产物你看到的文件就是构建出的站点。本文带你走完一遍完整流程认清目录分区、本地构建整站 HTML、看懂关键构建文件最后修一个错别字完成贡献闭环。⚠️ 是不是也遇到过这种情况想给文档修个错别字克隆下来却被上千个.rst文件劝退或者想离线读文档却不知道从哪下手。三句话点破整站结构由 index.rst 里的 toctree 决定构建入口是 Makefile 里的一行命令内容则分散在 6 个顶层目录——读完本文你 30 秒内就能定位到任何一篇文档。读完本文你能做到✅ 说清 6 大目录分区的作用30 秒内找到目标文档✅ 在干净环境里构建出完整的 HTML 文档站含多语言构建机制✅ 看懂 conf.py 关键配置知道 _extensions/ 每个扩展的用途✅ 修正一处文档错别字并通过提交前自查1. 先理清 6 大分区内容到底放在哪顶层目录各管文档站的一块区域官网侧边栏菜单正是 index.rst 里一串 toctree 声明渲染出来的目录负责内容先看哪about/总览介绍、特性列表、FAQ、发布政策about/introduction.rstgetting_started/新手四条路逐步上手、第一个 2D 游戏、第一个 3D 游戏getting_started/step_by_step/tutorials/按主题划分的手把手教程2D、3D、数学、物理、网络、着色器等tutorials/math/engine_details/引擎内幕架构、API、类参考索引、文件格式engine_details/architecture/classes/类参考每个类一个 .rst 文件按字母排序共数百个classes/community/社区资源资源库、资产商店、交流渠道community/asset_library/两条规则记牢文件即页面toctree 即菜单——新增 rst 文件后若忘记挂进 toctree它就永远不会出现在侧边栏图片随章节存放在各自的 img/ 目录用相对路径引用。下一节就把这张地图构建成可浏览的网站。2. 本地构建整套文档5 步走环境要求很低Python 3 makeLinux/macOS 自带Windows 可用仓库根目录的 make.bat。第 1 步克隆仓库# 拉取文档源码 git clone https://gitcode.com/GitHub_Trending/go/godot-docs cd godot-docs第 2 步安装构建依赖# 版本与线上构建锁定一致保证本地产物与官网一致 pip install -r requirements.txtrequirements.txt 里的核心依赖sphinx8.1.3构建引擎、sphinx_rtd_theme3.1.0站点主题、sphinx-tabs代码块选项卡、sphinx-notfound-page自定义 404 页面对应根目录的 404.rst。第 3 步触发构建# -b html 指定 HTML 输出产物落在 _build 目录 make html # Windows 下等价执行make.bat html第 4 步打开产物入口是根目录生成的_build/html/index.html浏览器打开即完整文档站侧边栏、搜索离线可用。第 5 步增量重建构建会在_build/doctrees写中间缓存所以只改一个 rst 再重建会快很多——贡献者日常就是改一个文件 → 重建 → 看对应页面。一句话收束构建链路极短产物只取决于两个输入——RST 源文件和 conf.py线上看到的问题基本都能回溯到这两者之一。3. 构建链路 4 个关键文件老手速查conf.py唯一构建配置三个重点。extensions注册第三方与自研扩展highlight_language gdscript让 GDScript 代码块正确高亮靠_extensions/gdscript.py这个自研语法模块supported_languages声明多语言构建清单含简体中文。另外设置环境变量SPHINX_NO_DESCRIPTIONS可跳过godot_descriptions扩展它负责自动生成页面摘要。Makefile封装常用 sphinx-build 调用。除make html外make gettext值得知道——它用 i18n 标签导出翻译模板是文档翻译团队提取可翻译字符串的入口。_extensions/5 个自研扩展。gdscript.py是 GDScript 语法高亮器bbcode.py支持文档内的 BBCode 标记classref_admonitions.py提供类参考专用提示框godot_descriptions.py自动生成页面描述override_jobs.py仅在 Read the Docs 线上构建时启用。_templates/ 与 _static/前者覆盖页面布局、面包屑、版本选择器三个模板后者放自定义样式与脚本Read the Docs 侧面板和明暗主题切换都出自这里。⚠️ 常见坑往 _extensions/ 加新模块后必须同步在 conf.py 的extensions列表登记否则构建不报错、功能悄悄失效。看懂构建链路后换个读者视角看看成品站里怎么快速导航。4. 作为读者30 秒找到对的页面纯读者不需要懂构建记住查找路径即可首页按画像分流index.rst 给出四块入口磁贴——从没做过游戏指向 about/introduction.rst会做游戏但不懂 Godot指向 getting_started/step_by_step/想学进阶指向 tutorials/。搜索优先官网左上角搜索框是全量索引比手动翻侧边栏快得多。类参考按字母走查 API 直接进 classes/一个类一个文件如class_transform2d.rst。引擎内幕图值得收藏engine_details/architecture/ 里有一组文档中高频引用的架构图。比如下面这张变换关系图讲清 Node2D / Node3D 共用的局部与世界变换体系再如架构章节的节点类型图演示文档图片按相对路径引用、存放于本章 img/ 目录的惯例只想读文档的话到这里已经够用想上手贡献看最后一节。5. 实战修一个错别字并跑通提交前自查贡献的门槛比想象中低最快的一次 PR 就是修错别字用官网搜索定位含错字页面记下对应 rst 路径例如 about/faq.rst 里的笔误就改那个文件。用任意文本编辑器修改。reST 语法易错点强调用单个星号*emphasis*行内代码用双反引号code符号数量写错会在构建时产生警告。提交前自查仓库提供了脚本 _tools/check-rst.sh 与拼写检查词典 _tools/codespell-dict.txt先确认改动文件无拼写和格式问题。本地make html跑一遍确认终端没有新增警告再提交 PR。# 仓库根目录执行对改动文件做提交前快速检查 bash _tools/check-rst.sh⚠️ classes/ 下的 rst 由引擎源码自动派生不要手改手写内容集中在 about/、getting_started/、tutorials/、engine_details/、community/ 五个分区。速查表要做什么 → 去哪改 → 关键点 → 常见坑要做什么去哪改关键点常见坑新增文档页对应顶层目录 index.rst必须挂进 toctree 才出现在侧边栏只加文件、忘记注册 toctree调整构建行为conf.pyextensions、highlight_language、supported_languages自研扩展未登记进extensions而静默失效构建本地站点Makefile 的make html依赖先pip install -r requirements.txt漏装依赖导致扩展缺失报错导出翻译模板Makefile 的make gettext命令自带-t i18n标签无需额外配置与线上多语言构建混为一谈本地默认英文维护类参考classes/每类一个文件、按字母排序内容是自动生成的手改会被覆盖插入图片所在章节的img/目录RST 中相对自身文件引用路径写绝对或相对站点根图片丢失下一步走哪通读 getting_started/step_by_step/感受官方教程的写法从 tutorials/ 挑一处笔误完整跑一遍修改 → 构建 → 自查 → 提交流程深入 engine_details/architecture/理解文档描述的节点架构想对文档站本身做更多定制再回头看 conf.py 和 _extensions/ 这两个文件的细节。文档是 Godot 整个生态里对新人最友好的贡献入口——从修一个错别字开始构建过一次之后这个仓库就不再是谜团了。【免费下载链接】godot-docsGodot Engine official documentation项目地址: https://gitcode.com/GitHub_Trending/go/godot-docs创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
网站建设高端定制企业官网
RELATED

相关资讯

更多精彩内容,欢迎继续阅读

较早相关资讯

最新相关资讯

【外设】之大彩串口显示屏 2026/11/15 4:54:16

【外设】之大彩串口显示屏

大彩串口屏初步使用 1 .官网下载 STM32 屏幕 GUI 设计资料 http://www.gz-dc.com/category/typeid/4112 找到 STM32 Keil 工程,移植相关代码因项目而异进行移植,由于项目简单,本人只对用到的指令接口进行修改。 比如:注意事项&…

阅读更多 →
无法下载Windows系统iso文件 2026/11/15 2:04:12

无法下载Windows系统iso文件

当我遇到这个问题的时候,我打开了一个网站: 登录 然后我打算下载的时候: 突然那个官方的连接就可以下载了:

阅读更多 →
【清华代码熊】DeepSeek V4.1 Flash 后训练详解 2026/11/14 10:11:15

【清华代码熊】DeepSeek V4.1 Flash 后训练详解

📌 上期解析了 DeepSeek V4.1 Flash 模型架构改进,本期解析 DeepSeek V4.1 Flash 预训练/后训练技术: 🌟 预训练:45T 文本 多模态混合语料、直接训练 sparse attention(取消 DeepSeek V4 的 dense 冷启动&…

阅读更多 →
Shuffle-R1: Efficient RL framework for Multimodal Large Language Models via Data-centric Dynamic ... 2026/11/16 6:47:19

Shuffle-R1: Efficient RL framework for Multimodal Large Language Models via Data-centric Dynamic ...

文章主要内容和创新点 主要内容 本文聚焦于多模态大语言模型(MLLM)强化学习(RL)训练中的效率问题,提出了一个名为Shuffle-R1的框架。研究发现,当前RL训练存在两个关键缺陷: 优势值坍缩(Advantage Collapsing):批次中大多数优势值集中在零附近,导致有效梯度信号被淹…

阅读更多 →
PRvL: Quantifying the Capabilities and Risks of Large Language Models for PII Redaction 2026/11/14 16:35:50

PRvL: Quantifying the Capabilities and Risks of Large Language Models for PII Redaction

一、文章主要内容总结 本文聚焦于利用大型语言模型(LLMs)实现个人身份信息(PII)脱敏的研究,旨在解决传统脱敏方法(如基于规则的系统、领域特定命名实体识别(NER)模型)泛化能力差、跨格式/跨语境适应性弱的问题。 研究通过全面评估多种LLM架构(包括密集型LLM(D-LLM…

阅读更多 →
LLaVA-RE: Binary Image-Text Relevancy Evaluation with Multimodal Large Language Model 2026/11/16 17:28:18

LLaVA-RE: Binary Image-Text Relevancy Evaluation with Multimodal Large Language Model

文章主要内容和创新点 主要内容 本文聚焦于二进制图像-文本相关性评估任务(判断图像与文本“相关”或“不相关”),针对该任务中文本格式多样、相关性定义随场景变化等挑战,提出了基于多模态大语言模型(MLLM)的解决方案LLaVA-RE。 模型设计:LLaVA-RE基于LLaVA 1.5架构,…

阅读更多 →

今日资讯

本周资讯

本月资讯

看完文章仍有疑问?

联系尧图顾问,获取一对一建站咨询

立即免费咨询 📞 400-888-8888
📞 ✉