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

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

== 文档信息 ==
* 文档名称：模板现代化官方推荐化改造进度
* 创建日期：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、分类外溢、核心模板改动告警。

== 当前优先级与执行顺序 ==
# `Template:Navbox` / `Template:PageToolsLink`（核心依赖最高）
# `Template:SoftwareInfo` / `Template:Working` / `Template:LanguageLinks`
# Flow/LQT 迁移模板组
# 课程导航模板组（抽象复用）

== 进度看板 ==
{| class="wikitable"
! 阶段
! 状态
! 进度
! 负责人
! 备注
|-
| 阶段 A：模板工程骨架统一
| 进行中
| 0%
| Maintenance script
| 待开始落地核心模板骨架统一
|-
| 阶段 B：TemplateData 全量补齐
| 未开始
| 0%
| Maintenance script
| 当前模板 TemplateData 基本空白
|-
| 阶段 C：复杂逻辑模块化
| 未开始
| 0%
| Maintenance script
| 站点模块命名空间尚未形成稳定模块库
|-
| 阶段 D：治理与质量门禁
| 未开始
| 0%
| Maintenance script
| 待建立巡检流程与规范页
|}

== 里程碑日志 ==
=== 2026-05-19 ===
* 已完成：数据库备份（含校验）
* 已完成：模板命名空间依赖关系、调用热度、语法使用情况巡检
* 已完成：建立本进度文档并写入分阶段改造路线
* 下一步：先落地阶段 A + 阶段 B（Navbox / PageToolsLink / SoftwareInfo）

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

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