Comprehensive Rust 课程内容结构解析Google Android 团队的 Rust 教学仓库是如何组织 src/ 目录的【免费下载链接】comprehensive-rustThis is the Rust course used by the Android team at Google. It provides you the material to quickly teach Rust.项目地址: https://gitcode.com/GitHub_Trending/co/comprehensive-rustComprehensive Rust 是 Google Android 团队开发的一套多日制 Rust 课程其全部课程正文存放于仓库根目录的src/目录中。本文以 src/README.md 为核心结合仓库源码与构建配置详细讲解课程内容在src/与third_party/中的组织方式、所有可翻译内容必须集中在这两个目录这一硬性约束背后的翻译发布机制以及课程结构Course/Session/Segment/Slide 四级模型如何通过 mdbook 目录层级与 frontmatter 元数据被 mdbook-course 预处理器解析并驱动课时统计、大纲生成与多语言发布。读完本文你将能理解该仓库正文即数据、结构即配置的课程工程化思路并掌握自行构建、服务与翻译该课程的关键命令。一、src/README.md说了什么三条核心事实原文档篇幅虽短但浓缩了课程内容管理的三条核心事实src/目录承载全部课程正文。src/下的所有文件共同构成课程内容其中每一章的正文内容由 Markdown 编写结构由 src/SUMMARY.md共 643 行定义。src/可以引用third_party/中的第三方内容。仓库根目录下另有 third_party/ 目录其中存放 mdBook 本身third_party/mdbook/与 CXX 库third_party/cxx/等被课程引用的第三方材料。发布翻译时src/与third_party/会被整体回滚。每次发布某语言翻译版时构建脚本会把这两个目录git restore到该翻译的 POT-Creation-Date 头所记录的历史提交而book.toml、theme/等其他文件则始终使用最新版本。文档特别强调至关重要的是所有可翻译内容都必须生活在这两个目录中。这三条事实共同指向一个设计目标把可翻译的课程正文与不可翻译的工具链配置彻底分离从而让同一套最新构建工具主题、CSS、JavaScript为所有语言版本服务同时保证翻译内容不会因英文正文的持续改动而退化。二、src/目录的实际构成从 SUMMARY 到千余个 Markdown 文件从仓库文件列表可以看到src/是一个庞大的内容树其核心骨架文件包括文件作用src/SUMMARY.mdmdBook 的章节导航文件完整定义课程章节顺序与层级共 643 行src/index.md课程首页介绍课程目标、四个专项专题Android、Chromium、Bare-metal、Concurrency与非目标Non-Goalssrc/running-the-course.md讲师指南入口链接到课程结构、快捷键与翻译说明各专题根文件如 src/android.md、src/bare-metal.md、src/chromium.md、src/concurrency/welcome.md四个专项课程的入口页内容层面src/覆盖了从hello-world、types-and-values、control-flow-basics、borrowing、lifetimes、generics、error-handling、concurrency到unsafe-deep-dive、android、chromium、bare-metal等全部章节每个教学章节几乎都遵循统一的正文 Exercise Solution模式例如 src/borrowing/ 下同时存在exercise.md、exercise.rs与solution.md。课程的四个专项专题specialized topics在 src/index.md 中有明确说明均为在前四天 Rust Fundamentals 基础上的深入方向Android半天使用 Rust 进行 Android 平台开发AOSP涵盖与 C、C、Java 的互操作详见 src/android/interoperability.md 及其下 AIDL、JNI 等子章节Chromium半天在 Chromium 系浏览器中使用 Rust涵盖与 C 的互操作及第三方 crate 引入详见 src/chromium/Bare-metal一整天裸机嵌入式开发覆盖微控制器与应用处理器详见 src/bare-metal/Concurrency一整天经典并发线程 互斥锁与 async/await 并发详见 src/concurrency/welcome-async.md。三、课程结构模型Course / Session / Segment / Slide理解src/的组织方式关键是掌握 mdbook-course 预处理器定义的四级结构模型Course课程一本 mdBook 可以包含多个课程例如 Fundamentals前四天以及 Android、Chromium、Bare-metal、Concurrency 等专项课程Session课时/场次课程的组成单位是一段教学时间块含休息通常每天两场上午场与下午场Segment片段会话的组成单位是一组主题相关的幻灯片片段之间安排休息Slide幻灯片片段的组成单位每张幻灯片由一节或多节 mdBook 章节chapter构成。这一结构不是写在某个独立配置文件里的而是直接从 mdBook 的目录结构推导而来SUMMARY.md 中的每个顶级 section 被视为一个 segment且可以选择性地开启新的 session 或 coursesection 内的第一个章节及其后的二级章节各自成为一张 slide更深层嵌套的章节则归属于其父级 slide。以 mdbook-course README 中的示例为准- Frobnication - Integer Frobnication - Frob Expansion - Structs - Enums - [Exercise](https://link.gitcode.com/i/75cba754df1cbb334b142734541bb57f) - Solution这个 segment 中共有四张幻灯片Frobnication、Integer Frobnication、Frob Expansion 与 Exercise其中后两张幻灯片由多个章节组成。在源码层面这一模型由 mdbook-course/src/course.rs 中的Course、Session、Segment等类型实现summary 的解析与结构推导同样发生在该模块中模块声明见 mdbook-course/src/lib.rs 的pub mod course;。四、Frontmatter 元数据minutes、target_minutes、course、session每个章节正文开头的 YAML frontmatter 是驱动课程结构与计时的核心配置。其字段定义于 mdbook-course/src/frontmatter.rs 中的Frontmatter结构体可选字段共四个--- minutes: NNN target_minutes: NNN course: COURSE NAME session: SESSION NAME ---字段含义约束minutes该章节预计所需教学时间分钟可选target_minutes该 session 的目标总时长分钟可选course标识本 segment 属于哪个课程仅可出现在 segment 的第一个章节session标识本 segment 属于哪个 session仅可出现在 segment 的第一个章节其中minutes与target_minutes用于计时所有章节的minutes会被累加并在 segment 之间自动插入休息时间从而估算出 segment、session 与 course 的总时长target_minutes则作为 session 的目标时长用于与实际估算对照。course与session字段配合 SUMMARY 结构标记这是某个 session 或 course 的第一个 segment。解析实现见 mdbook-course/src/frontmatter.rs 的split_frontmatter函数它借助matter库从章节内容中分离出 frontmatter 与正文再用serde_yaml反序列化若 frontmatter 语法错误会报出包含章节source_path的错误信息。真实示例可对照 src/welcome-day-1.md 的文件头--- minutes: 5 course: Fundamentals session: Day 1 Morning target_minutes: 180 ---这表示该页属于 Fundamentals 课程的 Day 1 Morning 场次预计 5 分钟且该场次目标时长为 180 分钟。五、指令Directives大纲与课表的自动生成课程正文中可以使用四类模板指令由 mdbook-course/src/replacements.rs 中的replace函数在构建时用正则\{\{%([^}]*)}}匹配并替换{{%segment outline}} {{%session outline}} {{%course outline}} {{%course outline COURSENAME}}{{%segment outline}}替换为当前 segment 的 Markdown 大纲{{%session outline}}替换为当前 session 的大纲{{%course outline}}替换为当前 course 的课表{{%course outline COURSENAME}}按名称引用其他课程并输出其课表用于 Running the Course 章节。例如 src/welcome-day-1.md 中的{{%session outline}}会在渲染时被替换为当天 session 的完整教学大纲。replace函数的具体行为可归纳为当指令与当前章节所处的 segment/session/course 上下文匹配时调用 mdbook-course/src/course.rs 中相应类型的outline()/schedule()方法生成 Markdown当{{%course outline COURSENAME}}指定的课程名称找不到时会原样输出not found - {{%course outline ...}}占位文本。六、为什么所有可翻译内容必须住在 src/ 与 third_party/翻译发布机制这是 src/README.md 最强调的一条约束其背后的完整机制记录在 TRANSLATIONS.md 中核心链路如下6.1 翻译技术栈Gettext PO 文件课程使用 GNU Gettext 体系管理翻译。每个语言对应一个.po文件按 ISO 639 语言码命名存放于仓库根目录 po/ 下例如po/zh-CN.po、po/ja.po、po/ko.po等本仓库当前包含 21 个语言文件。.po文件是纯文本翻译数据库包含全部英文原文msgid与对应翻译msgstr一个messages.pot模板文件由mdbook-xgettext输出生成只含英文原文作为新建翻译的初始化模板。官方建议不要手工编辑.po文件而应使用 Poedit 等专用编辑器编辑后运行dprint fmt保证格式统一。6.2 关键构建命令生成 POT 模板直接构建书籍mdbook-xgettext渲染器会自动提取英文原文mdbook build生成的模板位于book/xgettext/messages.pot该自动生成文件不应手工修改。初始化新语言翻译msginit -i book/xgettext/messages.pot -l xx -o po/xx.po也可以直接把messages.pot复制为po/xx.po后手动修正文件头部的msgid 条目。刷新既有翻译英文正文变化后msgmerge --update po/xx.po book/xgettext/messages.pot运行msgmerge时未变化的条目保持原样被删除的条目标记为旧条目被更新的条目标记为 fuzzy模糊。发布翻译时 fuzzy 条目不会被采用必须人工逐条核对并修正。格式化翻译文件dprint fmt po/xx.po构建特定语言的 HTMLMDBOOK_BOOK__LANGUAGExx mdbook build -d book/xx该命令告知mdbook-gettext预处理器使用po/xx.po翻译整本书输出位于book/xx/html/。本地实时预览翻译MDBOOK_BOOK__LANGUAGExx mdbook serve -d book/xx更新po/xx.po后服务会自动重新加载。6.3 发布工作流中的目录回滚TRANSLATIONS.md 的 Publication Workflow 章节详细解释了src/README.md中git restore的来龙去脉main分支每次变更都会触发publish.ymlCI其中build.sh会按 CONTRIBUTING.md 安装依赖用mdbook-pandoc启用 PDF 输出默认禁用以免普通构建需要配置 LaTeX构建所有语言版本含英文英文 HTML 输出到book/html/各语言输出到book/xx/html/将整个book/html/发布到站点。关键一步在 Restoring Translations 小节构建非英文翻译前build.sh会把所有 Markdown 文件回滚到该翻译的 POT-Creation-Date 头所记录的时间点对应的提交执行的就是src/README.md提到的命令$ git restore --source $LAST_COMMIT src/ third_party/其中$LAST_COMMIT是 POT-Creation-Date 头对应时刻的提交。由此产生两个设计结果翻译不会因英文正文的改动而退化翻译始终对应其翻译时点的英文快照翻译不会自动获得英文正文的最新修复需要翻译者主动运行msgmerge拉取新内容。同时由于只回滚src/与third_party/每个翻译版本都使用最新的主题、CSS 与 JavaScript——这正是 src/README.md 强调可翻译内容必须集中在这两个目录的根本原因任何可翻译文本若散落在book.toml、theme/等不被回滚的文件中将导致翻译版本与内容快照不一致。另外build.sh运行后工作区会保持 dirty 状态若要紧接着构建英文版需要手动清理。6.4 翻译质量核对状态报告仓库自动生成两份翻译状态报告分别对应已入库状态与msgmerge 同步到最新源文后的状态也可本地生成以观察自己改动的影响i18n-report translation-report.html po/*.po七、构建与使用从克隆到课堂授课综合 README.md 与 TRANSLATIONS.md完整使用链路如下安装依赖先按 https://rustup.rs/ 安装 Rust再安装 Bazel建议经 Bazelisk 版本管理器克隆仓库后执行cargo xtask install-tools该命令会把 mdbook、mdbook-svgbob、mdbook-i18n-helpers、i18n-report、mdbook-exerciser、mdbook-course、mdbook-linkcheck2 等工具安装到~/.cargo/bin/。本地预览cargo xtask serve内容位于 http://localhost:3000服务翻译版加语言码如cargo xtask serve -l da丹麦语。静态构建cargo xtask build构建翻译版加语言码如cargo xtask build -l daTRANSLATIONS.md 提供进一步说明。测试cargo xtask rust-tests测试书内 Rust 代码片段cargo xtask web-tests运行 tests/ 目录中的 WebDriver 测试。授课使用课程为课堂授课设计更适合有 C/Java 背景的工程师src/running-the-course/ 目录提供课程结构、键盘快捷键与翻译页说明src/welcome-day-1.md 等欢迎页还内置了给讲师的授课提示如鼓励随时提问、控制讨论方向、允许超前于幻灯片讲解等。八、源码级验证结构与计时的实现落点最后把本文涉及的机制与源码位置对应起来便于读者按图索骥frontmatter 解析mdbook-course/src/frontmatter.rs 中的Frontmatter结构体与split_frontmatter()四个字段minutes/target_minutes/course/session均为Option类型即全部可选结构推导与计时mdbook-course/src/course.rs 的Course/Session/Segment类型、outline()/schedule()方法计时信息输出相关代码见 mdbook-course/src/timing_info.rs指令替换mdbook-course/src/replacements.rs 的replace()正则\{\{%([^}]*)}}匹配所有{{%...}}指令Markdown 辅助mdbook-course/src/markdown.rs构建配置book.toml 中注册了gettextafter [links]、svgbob、course三个预处理器以及xgettext、pandoc默认禁用 PDF、html、exerciser、linkcheck2输出器并配置了extra-watch-dirs [po, third_party]让 mdbook 监听翻译与第三方内容变更[output.html.playground]开启了可编辑代码示例与行号mdbook-exerciser 输出器mdbook-exerciser/ 负责把课程中的练习提取打包配合[output.exerciser]的output-directory comprehensive-rust-exercises配置。结语从 src/README.md 这短短一段说明出发可以牵引出一条完整的课程工程化链路src/与third_party/作为唯一可翻译内容区SUMMARY.md定义结构、frontmatter 提供元数据、mdbook-course负责推导 Course/Session/Segment/Slide 模型并生成大纲与课表mdbook-xgettext提取英文原文、Gettext 工具链维护各语言.po文件最终由build.sh以回滚内容 最新主题的方式发布全部语言版本。理解这套机制不仅有助于讲师按需调整课时与大纲也为想要参与翻译贡献或自建类似多语言课程仓库的开发者提供了一套经过 Google 生产环境验证的参考范式。【免费下载链接】comprehensive-rustThis is the Rust course used by the Android team at Google. It provides you the material to quickly teach Rust.项目地址: https://gitcode.com/GitHub_Trending/co/comprehensive-rust创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Comprehensive Rust 课程内容结构解析Google Android 团队的 Rust 教学仓库是如何组织 src/ 目录的【免费下载链接】comprehensive-rustThis is the Rust course used by the Android team at Google. It provides you the material to quickly teach Rust.项目地址: https://gitcode.com/GitHub_Trending/co/comprehensive-rustComprehensive Rust 是 Google Android 团队开发的一套多日制 Rust 课程其全部课程正文存放于仓库根目录的src/目录中。本文以 src/README.md 为核心结合仓库源码与构建配置详细讲解课程内容在src/与third_party/中的组织方式、所有可翻译内容必须集中在这两个目录这一硬性约束背后的翻译发布机制以及课程结构Course/Session/Segment/Slide 四级模型如何通过 mdbook 目录层级与 frontmatter 元数据被 mdbook-course 预处理器解析并驱动课时统计、大纲生成与多语言发布。读完本文你将能理解该仓库正文即数据、结构即配置的课程工程化思路并掌握自行构建、服务与翻译该课程的关键命令。一、src/README.md说了什么三条核心事实原文档篇幅虽短但浓缩了课程内容管理的三条核心事实src/目录承载全部课程正文。src/下的所有文件共同构成课程内容其中每一章的正文内容由 Markdown 编写结构由 src/SUMMARY.md共 643 行定义。src/可以引用third_party/中的第三方内容。仓库根目录下另有 third_party/ 目录其中存放 mdBook 本身third_party/mdbook/与 CXX 库third_party/cxx/等被课程引用的第三方材料。发布翻译时src/与third_party/会被整体回滚。每次发布某语言翻译版时构建脚本会把这两个目录git restore到该翻译的 POT-Creation-Date 头所记录的历史提交而book.toml、theme/等其他文件则始终使用最新版本。文档特别强调至关重要的是所有可翻译内容都必须生活在这两个目录中。这三条事实共同指向一个设计目标把可翻译的课程正文与不可翻译的工具链配置彻底分离从而让同一套最新构建工具主题、CSS、JavaScript为所有语言版本服务同时保证翻译内容不会因英文正文的持续改动而退化。二、src/目录的实际构成从 SUMMARY 到千余个 Markdown 文件从仓库文件列表可以看到src/是一个庞大的内容树其核心骨架文件包括文件作用src/SUMMARY.mdmdBook 的章节导航文件完整定义课程章节顺序与层级共 643 行src/index.md课程首页介绍课程目标、四个专项专题Android、Chromium、Bare-metal、Concurrency与非目标Non-Goalssrc/running-the-course.md讲师指南入口链接到课程结构、快捷键与翻译说明各专题根文件如 src/android.md、src/bare-metal.md、src/chromium.md、src/concurrency/welcome.md四个专项课程的入口页内容层面src/覆盖了从hello-world、types-and-values、control-flow-basics、borrowing、lifetimes、generics、error-handling、concurrency到unsafe-deep-dive、android、chromium、bare-metal等全部章节每个教学章节几乎都遵循统一的正文 Exercise Solution模式例如 src/borrowing/ 下同时存在exercise.md、exercise.rs与solution.md。课程的四个专项专题specialized topics在 src/index.md 中有明确说明均为在前四天 Rust Fundamentals 基础上的深入方向Android半天使用 Rust 进行 Android 平台开发AOSP涵盖与 C、C、Java 的互操作详见 src/android/interoperability.md 及其下 AIDL、JNI 等子章节Chromium半天在 Chromium 系浏览器中使用 Rust涵盖与 C 的互操作及第三方 crate 引入详见 src/chromium/Bare-metal一整天裸机嵌入式开发覆盖微控制器与应用处理器详见 src/bare-metal/Concurrency一整天经典并发线程 互斥锁与 async/await 并发详见 src/concurrency/welcome-async.md。三、课程结构模型Course / Session / Segment / Slide理解src/的组织方式关键是掌握 mdbook-course 预处理器定义的四级结构模型Course课程一本 mdBook 可以包含多个课程例如 Fundamentals前四天以及 Android、Chromium、Bare-metal、Concurrency 等专项课程Session课时/场次课程的组成单位是一段教学时间块含休息通常每天两场上午场与下午场Segment片段会话的组成单位是一组主题相关的幻灯片片段之间安排休息Slide幻灯片片段的组成单位每张幻灯片由一节或多节 mdBook 章节chapter构成。这一结构不是写在某个独立配置文件里的而是直接从 mdBook 的目录结构推导而来SUMMARY.md 中的每个顶级 section 被视为一个 segment且可以选择性地开启新的 session 或 coursesection 内的第一个章节及其后的二级章节各自成为一张 slide更深层嵌套的章节则归属于其父级 slide。以 mdbook-course README 中的示例为准- Frobnication - Integer Frobnication - Frob Expansion - Structs - Enums - [Exercise](https://link.gitcode.com/i/75cba754df1cbb334b142734541bb57f) - Solution这个 segment 中共有四张幻灯片Frobnication、Integer Frobnication、Frob Expansion 与 Exercise其中后两张幻灯片由多个章节组成。在源码层面这一模型由 mdbook-course/src/course.rs 中的Course、Session、Segment等类型实现summary 的解析与结构推导同样发生在该模块中模块声明见 mdbook-course/src/lib.rs 的pub mod course;。四、Frontmatter 元数据minutes、target_minutes、course、session每个章节正文开头的 YAML frontmatter 是驱动课程结构与计时的核心配置。其字段定义于 mdbook-course/src/frontmatter.rs 中的Frontmatter结构体可选字段共四个--- minutes: NNN target_minutes: NNN course: COURSE NAME session: SESSION NAME ---字段含义约束minutes该章节预计所需教学时间分钟可选target_minutes该 session 的目标总时长分钟可选course标识本 segment 属于哪个课程仅可出现在 segment 的第一个章节session标识本 segment 属于哪个 session仅可出现在 segment 的第一个章节其中minutes与target_minutes用于计时所有章节的minutes会被累加并在 segment 之间自动插入休息时间从而估算出 segment、session 与 course 的总时长target_minutes则作为 session 的目标时长用于与实际估算对照。course与session字段配合 SUMMARY 结构标记这是某个 session 或 course 的第一个 segment。解析实现见 mdbook-course/src/frontmatter.rs 的split_frontmatter函数它借助matter库从章节内容中分离出 frontmatter 与正文再用serde_yaml反序列化若 frontmatter 语法错误会报出包含章节source_path的错误信息。真实示例可对照 src/welcome-day-1.md 的文件头--- minutes: 5 course: Fundamentals session: Day 1 Morning target_minutes: 180 ---这表示该页属于 Fundamentals 课程的 Day 1 Morning 场次预计 5 分钟且该场次目标时长为 180 分钟。五、指令Directives大纲与课表的自动生成课程正文中可以使用四类模板指令由 mdbook-course/src/replacements.rs 中的replace函数在构建时用正则\{\{%([^}]*)}}匹配并替换{{%segment outline}} {{%session outline}} {{%course outline}} {{%course outline COURSENAME}}{{%segment outline}}替换为当前 segment 的 Markdown 大纲{{%session outline}}替换为当前 session 的大纲{{%course outline}}替换为当前 course 的课表{{%course outline COURSENAME}}按名称引用其他课程并输出其课表用于 Running the Course 章节。例如 src/welcome-day-1.md 中的{{%session outline}}会在渲染时被替换为当天 session 的完整教学大纲。replace函数的具体行为可归纳为当指令与当前章节所处的 segment/session/course 上下文匹配时调用 mdbook-course/src/course.rs 中相应类型的outline()/schedule()方法生成 Markdown当{{%course outline COURSENAME}}指定的课程名称找不到时会原样输出not found - {{%course outline ...}}占位文本。六、为什么所有可翻译内容必须住在 src/ 与 third_party/翻译发布机制这是 src/README.md 最强调的一条约束其背后的完整机制记录在 TRANSLATIONS.md 中核心链路如下6.1 翻译技术栈Gettext PO 文件课程使用 GNU Gettext 体系管理翻译。每个语言对应一个.po文件按 ISO 639 语言码命名存放于仓库根目录 po/ 下例如po/zh-CN.po、po/ja.po、po/ko.po等本仓库当前包含 21 个语言文件。.po文件是纯文本翻译数据库包含全部英文原文msgid与对应翻译msgstr一个messages.pot模板文件由mdbook-xgettext输出生成只含英文原文作为新建翻译的初始化模板。官方建议不要手工编辑.po文件而应使用 Poedit 等专用编辑器编辑后运行dprint fmt保证格式统一。6.2 关键构建命令生成 POT 模板直接构建书籍mdbook-xgettext渲染器会自动提取英文原文mdbook build生成的模板位于book/xgettext/messages.pot该自动生成文件不应手工修改。初始化新语言翻译msginit -i book/xgettext/messages.pot -l xx -o po/xx.po也可以直接把messages.pot复制为po/xx.po后手动修正文件头部的msgid 条目。刷新既有翻译英文正文变化后msgmerge --update po/xx.po book/xgettext/messages.pot运行msgmerge时未变化的条目保持原样被删除的条目标记为旧条目被更新的条目标记为 fuzzy模糊。发布翻译时 fuzzy 条目不会被采用必须人工逐条核对并修正。格式化翻译文件dprint fmt po/xx.po构建特定语言的 HTMLMDBOOK_BOOK__LANGUAGExx mdbook build -d book/xx该命令告知mdbook-gettext预处理器使用po/xx.po翻译整本书输出位于book/xx/html/。本地实时预览翻译MDBOOK_BOOK__LANGUAGExx mdbook serve -d book/xx更新po/xx.po后服务会自动重新加载。6.3 发布工作流中的目录回滚TRANSLATIONS.md 的 Publication Workflow 章节详细解释了src/README.md中git restore的来龙去脉main分支每次变更都会触发publish.ymlCI其中build.sh会按 CONTRIBUTING.md 安装依赖用mdbook-pandoc启用 PDF 输出默认禁用以免普通构建需要配置 LaTeX构建所有语言版本含英文英文 HTML 输出到book/html/各语言输出到book/xx/html/将整个book/html/发布到站点。关键一步在 Restoring Translations 小节构建非英文翻译前build.sh会把所有 Markdown 文件回滚到该翻译的 POT-Creation-Date 头所记录的时间点对应的提交执行的就是src/README.md提到的命令$ git restore --source $LAST_COMMIT src/ third_party/其中$LAST_COMMIT是 POT-Creation-Date 头对应时刻的提交。由此产生两个设计结果翻译不会因英文正文的改动而退化翻译始终对应其翻译时点的英文快照翻译不会自动获得英文正文的最新修复需要翻译者主动运行msgmerge拉取新内容。同时由于只回滚src/与third_party/每个翻译版本都使用最新的主题、CSS 与 JavaScript——这正是 src/README.md 强调可翻译内容必须集中在这两个目录的根本原因任何可翻译文本若散落在book.toml、theme/等不被回滚的文件中将导致翻译版本与内容快照不一致。另外build.sh运行后工作区会保持 dirty 状态若要紧接着构建英文版需要手动清理。6.4 翻译质量核对状态报告仓库自动生成两份翻译状态报告分别对应已入库状态与msgmerge 同步到最新源文后的状态也可本地生成以观察自己改动的影响i18n-report translation-report.html po/*.po七、构建与使用从克隆到课堂授课综合 README.md 与 TRANSLATIONS.md完整使用链路如下安装依赖先按 https://rustup.rs/ 安装 Rust再安装 Bazel建议经 Bazelisk 版本管理器克隆仓库后执行cargo xtask install-tools该命令会把 mdbook、mdbook-svgbob、mdbook-i18n-helpers、i18n-report、mdbook-exerciser、mdbook-course、mdbook-linkcheck2 等工具安装到~/.cargo/bin/。本地预览cargo xtask serve内容位于 http://localhost:3000服务翻译版加语言码如cargo xtask serve -l da丹麦语。静态构建cargo xtask build构建翻译版加语言码如cargo xtask build -l daTRANSLATIONS.md 提供进一步说明。测试cargo xtask rust-tests测试书内 Rust 代码片段cargo xtask web-tests运行 tests/ 目录中的 WebDriver 测试。授课使用课程为课堂授课设计更适合有 C/Java 背景的工程师src/running-the-course/ 目录提供课程结构、键盘快捷键与翻译页说明src/welcome-day-1.md 等欢迎页还内置了给讲师的授课提示如鼓励随时提问、控制讨论方向、允许超前于幻灯片讲解等。八、源码级验证结构与计时的实现落点最后把本文涉及的机制与源码位置对应起来便于读者按图索骥frontmatter 解析mdbook-course/src/frontmatter.rs 中的Frontmatter结构体与split_frontmatter()四个字段minutes/target_minutes/course/session均为Option类型即全部可选结构推导与计时mdbook-course/src/course.rs 的Course/Session/Segment类型、outline()/schedule()方法计时信息输出相关代码见 mdbook-course/src/timing_info.rs指令替换mdbook-course/src/replacements.rs 的replace()正则\{\{%([^}]*)}}匹配所有{{%...}}指令Markdown 辅助mdbook-course/src/markdown.rs构建配置book.toml 中注册了gettextafter [links]、svgbob、course三个预处理器以及xgettext、pandoc默认禁用 PDF、html、exerciser、linkcheck2输出器并配置了extra-watch-dirs [po, third_party]让 mdbook 监听翻译与第三方内容变更[output.html.playground]开启了可编辑代码示例与行号mdbook-exerciser 输出器mdbook-exerciser/ 负责把课程中的练习提取打包配合[output.exerciser]的output-directory comprehensive-rust-exercises配置。结语从 src/README.md 这短短一段说明出发可以牵引出一条完整的课程工程化链路src/与third_party/作为唯一可翻译内容区SUMMARY.md定义结构、frontmatter 提供元数据、mdbook-course负责推导 Course/Session/Segment/Slide 模型并生成大纲与课表mdbook-xgettext提取英文原文、Gettext 工具链维护各语言.po文件最终由build.sh以回滚内容 最新主题的方式发布全部语言版本。理解这套机制不仅有助于讲师按需调整课时与大纲也为想要参与翻译贡献或自建类似多语言课程仓库的开发者提供了一套经过 Google 生产环境验证的参考范式。【免费下载链接】comprehensive-rustThis is the Rust course used by the Android team at Google. It provides you the material to quickly teach Rust.项目地址: https://gitcode.com/GitHub_Trending/co/comprehensive-rust创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
