帮助:模板定义与结构规范

模板定义与结构规范

本页回答“模板工程规范是什么”，用于统一模板体系的定义、边界和约束。

适用范围

• 模板命名空间（NS=10）主模板及其子页（`/Doc`、`/sandbox`、`/testcases`、`/styles.css`）。
• 模块命名空间（NS=828）中为模板提供逻辑支持的 Lua 模块。
• 模板相关分类体系（模板分类、维护分类、隐藏分类）。

规范目标

1. 稳定：模板结构、参数、分类行为长期可预期。
2. 可维护：改动可测试、可回滚、可追踪。
3. 可协作：编辑器、维护者、审核者使用同一套规则。
4. 可扩展：新增模板与模块能无缝接入现有体系。

核心构成（定义）

1. 结构规范

• 主模板负责展示与轻量路由。
• 文档统一在 `模板:名称/Doc`，并由主模板 `帮助:模板定义与结构规范/Doc` 挂载。
• 样式统一在 `模板:名称/styles.css`，由 `` 引入。
• 测试链路统一为 `模板:名称/sandbox` 与 `模板:名称/testcases`。

2. 参数规范

• 模板参数的权威说明位于 `/Doc` 的 `<templatedata>`。
• 参数命名优先语义化、稳定化，减少短期命名漂移。

3. 分类与归类规范

• 归类行为遵循：帮助:页面分类与归类规范。
• 分类命名与层级遵循：帮助:分类命名与层级规范。
• 模板页中：
  • 仅文档页或维护说明使用 `` 分类。
  • 仅调用页需要继承的分类使用 `