文档完成与质量报告

本页记录 AERMOD 中文文档从初始在线参考版到完整中文在线版的建设结果，并说明当前自动质量控制范围。页面地址保持不变，以兼容早期链接。

内容完成状态

内容状态在线组织方式
前置部分已完成声明、前言、目录概览、图目录和表目录
第 1 章　引言已完成1.1—1.2及全部三级小节
第 2 章　入门教程已完成8个页面，含图2-1—图2-8和完整模型输出示例
第 3 章　关键字参考已完成CO、SO、RE、ME、EV、OU六条路径，保留原手册编号
第 4 章　参考文献已完成原文1—48条完整参考文献
附录 A已完成9个页面、表A-1—A-12及六条路径交叉导航
附录 B已完成B.1—B.3.3错误消息说明
附录 C已完成C.1—C.11文件格式与原始记录示例
附录 D已完成31项版本变更逐项目录
附录 E已完成20个字母分组、73个术语

目录与查阅结构

  • 用户指南侧栏采用“章—节—小节”三级结构；
  • 第 3 章保留原手册 3.2.1—3.7.4 编号，并将长章节按主题拆页；
  • 附录 A 的快速语法表与第 3 章详细说明双向链接；
  • 附录 C 按输出文件类型拆分，便于直接定位字段与格式；
  • 附录 D、E 分别提供逐项修订和逐术语导航；
  • 首页提供入门教程、关键字索引和附录三个主要入口。

自动检查体系

GitHub Actions 在每次 Pull Request 和主分支构建时执行以下检查。

源文档完整性

  • 必需页面是否存在；
  • 各完整译文页面是否低于安全内容量阈值；
  • 关键标题、关键字、表格、示例和稳定锚点是否缺失；
  • Markdown代码围栏是否闭合；
  • 是否出现常见未完成标记。

结构一致性

  • 第 2 章22个编号小节和图2-1—图2-8；
  • 第 3 章六条功能路径的全部真实编号；
  • 第 4 章48条参考文献及编号连续性；
  • 附录A—E各自的表格、条目、术语和侧栏结构；
  • 正文中的“第 x.x 节”引用是否存在对应标题。

术语一致性

重点保护以下统一译法：

  • Input Control File：输入控制文件；
  • Source Group：污染源组；
  • Receptor：受体；
  • Meteorological Profile：气象廓线；
  • Building Downwash：建筑物下洗。

构建后检查

VuePress生成最终HTML后，工作流继续检查：

  • 站内链接目标是否存在；
  • 页面内和跨页面锚点是否有效；
  • 首页、侧栏、章节页和附录页能否正常生成；
  • GitHub Pages构件能否成功上传。

当前维护重点

完整译文导入阶段已经结束。当前维护重点为：

  1. 根据EPA后续版本更新文档；
  2. 修正用户反馈的翻译或技术表述问题；
  3. 改善移动端、长表格和长代码块的阅读体验；
  4. 扩展关键字搜索、示例控制文件和版本差异说明；
  5. 持续提高自动检查覆盖范围。