查看“︁项目:模板现代化官方推荐化改造进度”︁的源代码

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

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

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

== 分阶段路线（官方推荐化） ==
=== 阶段 A：模板工程骨架统一（优先） ===
* 目标：完成主模板 + 文档 + 样式 + 沙盒/测试子页的标准骨架。
* 任务：
** 主模板仅保留输出逻辑。
** 文档统一到 `/Doc`。
** 样式统一到 `/styles.css` 并通过 `<templatestyles />` 引入。
** 核心模板补齐 `/sandbox` 与 `/testcases`。

=== 阶段 B：TemplateData 全量补齐（优先） ===
* 目标：让 VisualEditor 与 TemplateWizard 自动提供模板参数表单。
* 任务：
** 为高频模板先补 `<templatedata>`。
** 参数补充：`required`、`suggested`、类型、示例、别名。

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

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

== 当前优先级与执行顺序 ==
# Flow/LQT 迁移模板组（分类外溢治理 + 文档规范化）
# 课程导航模板组（抽象复用）
# 其余主模板的 TemplateData 补齐
# 阶段 C：Lua 模块化切分

== 进度看板 ==
{| class="wikitable"
! 阶段
! 状态
! 进度
! 负责人
! 备注
|-
| 阶段 A：模板工程骨架统一
| 进行中
| 97%
| Maintenance script
| 主模板骨架统一完成；sandbox/testcases 覆盖 15/27（55.6%）
|-
| 阶段 B：TemplateData 全量补齐
| 已完成
| 100%
| Maintenance script
| 主模板 27/27 已具备 Doc + TemplateData
|-
| 阶段 C：复杂逻辑模块化
| 准备中
| 28%
| Maintenance script
| 已落地 Module:Navbox + Module:SoftwareInfo 原型
|-
| 阶段 D：治理与质量门禁
| 进行中
| 40%
| 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` 调用页分类改为 `<includeonly>`（避免模板页自身误入“正在编辑的页面”）
** 新建 `sandbox` 与 `testcases` 子页：
*** `Template:Working/sandbox` 与 `Template:Working/testcases`
*** `Template:LanguageLinks/sandbox` 与 `Template:LanguageLinks/testcases`
* 已完成（阶段B首批-第2批）：
** `Template:Working/Doc` 增加 TemplateData
** `Template:LanguageLinks/Doc` 增加 TemplateData
* 已完成（阶段D首批）：
** Flow/LQT 模板组 8 个模板完成分类外溢治理（分类收敛到 `<noinclude>`）
** 已校验上述模板调用区不再外溢 `[[Category:...]]`
* 已完成（阶段A/B第3批：课程导航模板组）：
** 已规范化主模板并挂载 `/Doc`：`数据结构与算法`、`数据结构与算法(基础概念)`、`线性表`、`栈与队列`、`串、数组和广义表`、`认识 Linux`
** 上述模板主题分类改为 `<includeonly>`（避免模板页本身被主题分类污染）
** 已新建 `/Doc` 并补齐 TemplateData：共 6 页
* 已完成（阶段A/B第4批：站点导航模板组）：
** 已规范化主模板并挂载 `/Doc`：`Windows版本体系`、`KMS`、`站点帮助文档`、`知识掌握模型`
** `Windows版本体系`、`KMS`、`站点帮助文档` 主题分类改为 `<includeonly>`
** 已新建 `/Doc` 并补齐 TemplateData：共 4 页
* 已完成（阶段A/B第5批：剩余主模板补齐）：
** 已规范化主模板并挂载 `/Doc`：`2025jzci毕设(论文)`、`西宁 FIRST 随想`、`Welcome`
** `2025jzci毕设(论文)`、`西宁 FIRST 随想` 主题分类改为 `<includeonly>`
** 已新建 `/Doc` 并补齐 TemplateData：共 3 页
* 已完成（阶段A/B第6批：系统模板组）：
** 已挂载 `/Doc`：`Extension DPL`、`Flow提及` 及 7 个 LQT/Flow 迁移模板
** 已新建 `/Doc` 并补齐 TemplateData：共 9 页
* 已完成（阶段D第2批：收尾巡检）：
** 新建巡检报告：[[项目:模板现代化收尾巡检报告/2026-05-19]]
** 巡检结论：主模板 `27/27` 已具备 `Doc + TemplateData`
** 待补 `sandbox + testcases`：22 个模板（已按调用热度排序）
* 已完成（阶段C准备）：
** 新建迁移清单：[[项目:模板现代化阶段C Lua模块化清单]]
** 形成 P0/P1/P2 候选与迁移顺序（Navbox → SoftwareInfo → PageToolsLink → LanguageLinks）
* 已完成（阶段A第7批：高热模板测试链路补齐）：
** 已新增 `sandbox + testcases`：`站点帮助文档`、`Windows版本体系`、`数据结构与算法`、`2025jzci毕设(论文)`、`认识 Linux`
** 当前 `sandbox + testcases` 覆盖率：10/27（37.0%）
* 已完成（阶段C原型）：
** 新建 `模块:Navbox`
** `模板:Navbox/sandbox` 已切换到 `#invoke:Navbox|toolLinks`
** 已用 `maintenance parse` 验证 sandbox 渲染正常
* 已完成（阶段A第8批：测试链路补齐第二批）：
** 已新增 `sandbox + testcases`：`KMS`、`西宁 FIRST 随想`、`Welcome`、`数据结构与算法(基础概念)`、`知识掌握模型`
** 当前 `sandbox + testcases` 覆盖率：15/27（55.6%）
* 已完成（阶段C原型第2批）：
** 新建 `模块:SoftwareInfo`
** `模板:SoftwareInfo/sandbox` 已切换到 `#invoke:SoftwareInfo|renderSandbox`
** 已用 `maintenance parse` 验证 sandbox 渲染正常
* 已更新：[[项目:模板现代化收尾巡检报告/2026-05-19]]（同步最新覆盖率，待补测试链路 12 个）
* 下一步：补第三批 `sandbox + testcases`（`线性表`、`栈与队列`、`串、数组和广义表`）并启动 `Module:PageToolsLink` 原型

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

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