项目:模板现代化官方推荐化改造进度：修订间差异
来自陋室
更多操作
删除的内容 添加的内容
Maintenance script（留言 | 贡献） 更新模板现代化进度：完成A9与PageToolsLink原型 |
Maintenance script（留言 | 贡献） 更新模板现代化进度：阶段A全量完成并进入阶段C切换评估 |
||
| 第55行： | 第55行： | ||
|- |
|- |
||
| 阶段 A：模板工程骨架统一 |
| 阶段 A：模板工程骨架统一 |
||
| 已完成 |
|||
| 进行中 |
|||
| |
| 100% |
||
| Maintenance script |
| Maintenance script |
||
| 主模板 27/27 已具备 sandbox + testcases |
|||
| 主模板骨架统一完成；sandbox/testcases 覆盖 18/27（66.7%） |
|||
|- |
|- |
||
| 阶段 B：TemplateData 全量补齐 |
| 阶段 B：TemplateData 全量补齐 |
||
| 第67行： | 第67行： | ||
|- |
|- |
||
| 阶段 C：复杂逻辑模块化 |
| 阶段 C：复杂逻辑模块化 |
||
| |
| 进行中 |
||
| |
| 55% |
||
| Maintenance script |
| Maintenance script |
||
| 已落地三大核心模块原型，待评估切主模板窗口 |
|||
| 已落地 Module:Navbox + Module:SoftwareInfo + Module:PageToolsLink 原型 |
|||
|- |
|- |
||
| 阶段 D：治理与质量门禁 |
| 阶段 D：治理与质量门禁 |
||
| 进行中 |
| 进行中 |
||
| |
| 60% |
||
| Maintenance script |
| Maintenance script |
||
| 已完成分类外溢治理 + 收尾巡检报告 |
| 已完成分类外溢治理 + 收尾巡检终版报告 |
||
|} |
|} |
||
| 第152行： | 第152行： | ||
** 已用 `maintenance parse` 验证 sandbox 渲染正常 |
** 已用 `maintenance parse` 验证 sandbox 渲染正常 |
||
* 已更新：[[项目:模板现代化收尾巡检报告/2026-05-19]]（同步第三批覆盖率） |
* 已更新：[[项目:模板现代化收尾巡检报告/2026-05-19]]（同步第三批覆盖率） |
||
* 已完成（阶段A第10批：系统模板测试链路收尾）： |
|||
* 下一步：补齐剩余 9 个模板的 `sandbox + testcases`（优先系统模板组），并评估三大模块原型切主模板窗口 |
|||
** 已新增 `sandbox + testcases`：`Extension DPL`、`Flow提及` 及 7 个 LQT/Flow 模板 |
|||
** 当前 `sandbox + testcases` 覆盖率：27/27（100.0%） |
|||
* 已更新：[[项目:模板现代化收尾巡检报告/2026-05-19]]（终版） |
|||
** 巡检结论：阶段 A 与阶段 B 均已完成 |
|||
* 下一步：阶段 C 切主模板评估与灰度切换（`PageToolsLink` → `Navbox` → `SoftwareInfo`） |
|||
== 风险与注意事项 == |
== 风险与注意事项 == |
||
2026年5月19日 (二) 23:15的版本
模板现代化官方推荐化改造进度
文档信息
- 文档名称：模板现代化官方推荐化改造进度
- 创建日期：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、分类外溢、核心模板改动告警。
当前优先级与执行顺序
- Flow/LQT 迁移模板组（分类外溢治理 + 文档规范化）
- 课程导航模板组（抽象复用）
- 其余主模板的 TemplateData 补齐
- 阶段 C：Lua 模块化切分
进度看板
| 阶段 | 状态 | 进度 | 负责人 | 备注 |
|---|---|---|---|---|
| 阶段 A：模板工程骨架统一 | 已完成 | 100% | Maintenance script | 主模板 27/27 已具备 sandbox + testcases |
| 阶段 B：TemplateData 全量补齐 | 已完成 | 100% | Maintenance script | 主模板 27/27 已具备 Doc + TemplateData |
| 阶段 C：复杂逻辑模块化 | 进行中 | 55% | Maintenance script | 已落地三大核心模块原型，待评估切主模板窗口 |
| 阶段 D：治理与质量门禁 | 进行中 | 60% | Maintenance script | 已完成分类外溢治理 + 收尾巡检终版报告 |
里程碑日志
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` 调用页分类改为 `