帮助:模板定义与结构规范：修订间差异

以互动方式浏览历史

删除的内容添加的内容

可视化wikitext

行内

2026年5月21日 (四) 11:19的最新版本

本页用于统一模板工程的定义、结构和约束。

适用范围

模板:名称
模板:名称/Doc
模板:名称/sandbox
模板:名称/testcases
模板:名称/styles.css

结构规范

主模板负责展示与轻量分发。
文档统一放在 /Doc 并由主模板挂载。
样式统一放在 /styles.css，通过 <templatestyles /> 引入。
发布前必须有 sandbox 与 testcases。

参数规范

参数命名稳定、语义明确。
复杂参数在文档页给出示例。
新增别名需在文档页明确说明。

分类规范

模板自身分类进入 <noinclude>。
调用页分类进入 <includeonly>。

@@ 第1行： / 第1行： @@
-= 模板定义与结构规范 =
+本页用于统一模板工程的定义、结构和约束。
-本页回答“模板工程规范是什么”，用于统一模板体系的定义、边界和约束。
 == 适用范围 ==
+* <code>模板:名称</code>
-* 模板命名空间（NS=10）主模板及其子页（`/Doc`、`/sandbox`、`/testcases`、`/styles.css`）。
+* <code>模板:名称/Doc</code>
-* 模块命名空间（NS=828）中为模板提供逻辑支持的 Lua 模块。
+* <code>模板:名称/sandbox</code>
-* 模板相关分类体系（模板分类、维护分类、隐藏分类）。
+* <code>模板:名称/testcases</code>
+* <code>模板:名称/styles.css</code>
-== 规范目标 ==
+== 结构规范 ==
+* 主模板负责展示与轻量分发。
-# 稳定：模板结构、参数、分类行为长期可预期。
+* 文档统一放在 <code>/Doc</code> 并由主模板挂载。
-# 可维护：改动可测试、可回滚、可追踪。
+* 样式统一放在 <code>/styles.css</code>，通过 <nowiki><templatestyles /></nowiki> 引入。
-# 可协作：编辑器、维护者、审核者使用同一套规则。
+* 发布前必须有 <code>sandbox</code> 与 <code>testcases</code>。
-# 可扩展：新增模板与模块能无缝接入现有体系。
+== 参数规范 ==
-== 核心构成（定义） ==
+* 参数命名稳定、语义明确。
-=== 1. 结构规范 ===
+* 复杂参数在文档页给出示例。
-* 主模板负责展示与轻量路由。
+* 新增别名需在文档页明确说明。
-* 文档统一在 `模板:名称/Doc`，并由主模板 `{{/Doc}}` 挂载。
-* 样式统一在 `模板:名称/styles.css`，由 `<templatestyles />` 引入。
-* 测试链路统一为 `模板:名称/sandbox` 与 `模板:名称/testcases`。
-=== 2. 参数规范 ===
+== 分类规范 ==
+* 模板自身分类进入 <nowiki><noinclude></nowiki>。
-* 模板参数的权威说明位于 `/Doc` 的 `<templatedata>`。
+* 调用页分类进入 <nowiki><includeonly></nowiki>。
-* 参数命名优先语义化、稳定化，减少短期命名漂移。
-=== 3. 分类与归类规范 ===
-* 归类行为遵循：[[帮助:页面分类与归类规范]]。
-* 分类命名与层级遵循：[[帮助:分类命名与层级规范]]。
-* 模板页中：
-** 仅文档页或维护说明使用 `<noinclude>` 分类。
-** 仅调用页需要继承的分类使用 `<includeonly>`。
-** 禁止裸放 `[[Category:...]]` 导致分类外溢。
-=== 4. 模块化规范 ===
-* 复杂判断、格式化、参数归一化进入 Lua 模块。
-* 模板通过 `#invoke` 调用模块，并保持兼容性策略。
-* 高成本解析函数（如 `#ifexist`）受控使用并记录用途。
-== 与分类规范的对应关系 ==
-# 命名一致性：模板相关分类命名优先稳定、可复用，避免近义并行建类。
-# 层级一致性：模板分类需纳入分类树，不创建孤立维护分类。
-# 隐藏分类一致性：维护类分类如需隐藏，由分类页 `__HIDDENCAT__` 控制。
-== 非目标（边界） ==
-* 本页不展开“执行步骤与操作命令”。
-* 本页不替代具体模板业务文档。
-== 相关页面 ==
-* 操作手册（怎么用）：[[帮助:模板改造与发布规范]]
-* 分类归类规则：[[帮助:页面分类与归类规范]]
-* 分类命名层级规则：[[帮助:分类命名与层级规范]]
 {{Template:站点帮助文档}}
+[[Category:帮助文档]]
-[[Category:分类维护]]

阅读	移动优化
编辑	维基化 · 快速指南 · 编辑页面 · 图片指南 · 编辑摘要 · 编辑冲突
高级编辑	站点分类 · 站点模板 · 模板编写指南 · 模板样式 · 解析函数
协作	历史与回退 · 保护页面
个人定制	定制消息 · Gadget
管理	学习指南 · 怎样的页面才会被计算为"文章页" · MediaWiki安装指南 · 扩展语法与格式示例