项目:模板现代化官方推荐化改造进度

模板现代化官方推荐化改造进度

文档信息

• 文档名称：模板现代化官方推荐化改造进度
• 创建日期：2026-05-19
• 最近更新：2026-05-19
• 维护方式：每次改造后同步更新本页
• 当前状态：执行中

改造目标

• 对站点模板体系进行官方推荐化现代改造，形成可维护、可扩展、可测试、可协作的模板工程体系。
• 改造遵循 MediaWiki 官方实践：TemplateData、TemplateStyles、Scribunto（Lua）、/Doc、/sandbox、/testcases、noinclude/includeonly 规范。

分阶段路线（官方推荐化）

阶段 A：模板工程骨架统一（优先）

• 目标：完成主模板 + 文档 + 样式 + 沙盒/测试子页的标准骨架。
• 任务：
  • 主模板仅保留输出逻辑。
  • 文档统一到 `/Doc`。
  • 样式统一到 `/styles.css` 并通过 `` 引入。
  • 核心模板补齐 `/sandbox` 与 `/testcases`。

阶段 B：TemplateData 全量补齐（优先）

• 目标：让 VisualEditor 与 TemplateWizard 自动提供模板参数表单。
• 任务：
  • 为高频模板先补 `<templatedata>`。
  • 参数补充：`required`、`suggested`、类型、示例、别名。

阶段 C：复杂逻辑模块化（中期）

• 目标：把复杂判断与格式化从 wikitext 迁移到 Lua 模块。
• 任务：
  • 保留简单展示模板在 wikitext。
  • 复杂分支改为 `#invoke` 调用。
  • 控制 `#ifexist` 等昂贵解析函数用量。

阶段 D：治理与质量门禁（持续）

• 目标：建立持续巡检与发布规范。
• 任务：
  • 建立模板规范页（命名、参数、分类、文档、样式、兼容性）。
  • 月度巡检：未文档化模板、缺 TemplateData、分类外溢、核心模板改动告警。

当前优先级与执行顺序

1. Flow/LQT 迁移模板组（分类外溢治理 + 文档规范化）
2. 课程导航模板组（抽象复用）
3. 其余主模板的 TemplateData 补齐
4. 阶段 C：Lua 模块化切分

进度看板

阶段	状态	进度	负责人	备注
阶段 A：模板工程骨架统一	进行中	80%	Maintenance script	核心首批 5 模板已完成主模板骨架 + sandbox/testcases
阶段 B：TemplateData 全量补齐	进行中	68%	Maintenance script	核心首批 5 模板已补 TemplateData
阶段 C：复杂逻辑模块化	未开始	0%	Maintenance script	待进入 Lua 模块设计与迁移
阶段 D：治理与质量门禁	进行中	15%	Maintenance script	已完成 Flow/LQT 模板组分类外溢治理首批

里程碑日志

2026-05-19

• 已完成：数据库备份（含校验）
• 已完成：模板命名空间依赖关系、调用热度、语法使用情况巡检
• 已完成：建立本进度文档并写入分阶段改造路线
• 已完成（阶段A首批-第1批）：
  • 更新 `Template:Navbox`、`Template:PageToolsLink`、`Template:SoftwareInfo` 主模板骨架
  • 主模板补充 `项目:模板现代化官方推荐化改造进度/Doc` 挂载
  • 新建 `sandbox` 与 `testcases` 子页：
    • `Template:Navbox/sandbox` 与 `Template:Navbox/testcases`
    • `Template:PageToolsLink/sandbox` 与 `Template:PageToolsLink/testcases`
    • `Template:SoftwareInfo/sandbox` 与 `Template:SoftwareInfo/testcases`
• 已完成（阶段B首批-第1批）：
  • `Template:Navbox/Doc` 增加 TemplateData
  • `Template:PageToolsLink/Doc` 增加 TemplateData
  • `Template:SoftwareInfo/Doc` 增加 TemplateData
• 已完成（阶段A首批-第2批）：
  • 更新 `Template:Working`、`Template:LanguageLinks` 主模板骨架
  • `Template:Working` 调用页分类改为 `