2026年5月19日 (二) 13:22的版本

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

文档信息

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

改造目标

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

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

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

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

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

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

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

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

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

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

当前优先级与执行顺序

`Template:Navbox` / `Template:PageToolsLink`（核心依赖最高）
`Template:SoftwareInfo` / `Template:Working` / `Template:LanguageLinks`
Flow/LQT 迁移模板组
课程导航模板组（抽象复用）

进度看板

阶段	状态	进度	负责人	备注
阶段 A：模板工程骨架统一	进行中	40%	Maintenance script	已落地 Navbox / PageToolsLink / SoftwareInfo 的骨架改造与测试子页
阶段 B：TemplateData 全量补齐	进行中	25%	Maintenance script	已补齐 Navbox / PageToolsLink / SoftwareInfo 的 TemplateData
阶段 C：复杂逻辑模块化	未开始	0%	Maintenance script	待进入 Lua 模块设计与迁移
阶段 D：治理与质量门禁	未开始	0%	Maintenance script	待建立巡检流程与规范页

里程碑日志

2026-05-19

已完成：数据库备份（含校验）
已完成：模板命名空间依赖关系、调用热度、语法使用情况巡检
已完成：建立本进度文档并写入分阶段改造路线
已完成（阶段A首批）：
- 更新 `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首批）：
- `Template:Navbox/Doc` 增加 TemplateData
- `Template:PageToolsLink/Doc` 增加 TemplateData
- `Template:SoftwareInfo/Doc` 增加 TemplateData
下一步：继续处理 `Template:Working` 与 `Template:LanguageLinks` 的 A+B 改造

风险与注意事项

分类语句未正确放置在 `` 可能造成调用页分类外溢。
`#ifexist` 属昂贵解析函数，需控制调用规模。
高影响核心模板更新前必须先在 `/sandbox` 与 `/testcases` 验证。

同步约定

每次完成可验证改造项后，更新：
- 进度看板（状态与百分比）
- 里程碑日志（日期、动作、结果）
- 风险与阻塞（如有）

@@ 第4行： / 第4行： @@
 * 文档名称：模板现代化官方推荐化改造进度
 * 创建日期：2026-05-19
+* 最近更新：2026-05-19
 * 维护方式：每次改造后同步更新本页
-* 当前状态：启动中
+* 当前状态：执行中
 == 改造目标 ==
@@ 第55行： / 第56行： @@
 | 阶段 A：模板工程骨架统一
 | 进行中
-| 0%
+| 40%
 | Maintenance script
+| 已落地 Navbox / PageToolsLink / SoftwareInfo 的骨架改造与测试子页
-| 待开始落地核心模板骨架统一
 |-
 | 阶段 B：TemplateData 全量补齐
+| 进行中
-| 未开始
-| 0%
+| 25%
 | Maintenance script
+| 已补齐 Navbox / PageToolsLink / SoftwareInfo 的 TemplateData
-| 当前模板 TemplateData 基本空白
 |-
 | 阶段 C：复杂逻辑模块化
@@ 第69行： / 第70行： @@
 | 0%
 | Maintenance script
+| 待进入 Lua 模块设计与迁移
-| 站点模块命名空间尚未形成稳定模块库
 |-
 | 阶段 D：治理与质量门禁
@@ 第83行： / 第84行： @@
 * 已完成：模板命名空间依赖关系、调用热度、语法使用情况巡检
 * 已完成：建立本进度文档并写入分阶段改造路线
+* 已完成（阶段A首批）：
-* 下一步：先落地阶段 A + 阶段 B（Navbox / PageToolsLink / SoftwareInfo）
+** 更新 `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首批）：
+** `Template:Navbox/Doc` 增加 TemplateData
+** `Template:PageToolsLink/Doc` 增加 TemplateData
+** `Template:SoftwareInfo/Doc` 增加 TemplateData
+* 下一步：继续处理 `Template:Working` 与 `Template:LanguageLinks` 的 A+B 改造
 == 风险与注意事项 ==