帮助:模板改造与发布规范 - 版本历史

Maintenance script：帮助命名空间规范化：移除一级标题并修正渲染安全写法

2026-05-21T03:19:05Z

帮助命名空间规范化：移除一级标题并修正渲染安全写法

←上一版本		2026年5月21日 (四) 11:19的版本
第1行：		第1行：
	= 模板改造与发布规范 =
	本页规定模板改造、测试、发布和回滚的标准流程。		本页规定模板改造、测试、发布和回滚的标准流程。

第8行：		第7行：

	== 改造中 ==		== 改造中 ==
	# 在 `sandbox` 实现改动。		# 在 <code>sandbox</code> 实现改动。
	# 同步更新 `/Doc`（参数、示例、注意事项）。		# 同步更新 <code>/Doc</code>（参数、示例、注意事项）。
	# 在 `testcases` 补充典型用例。		# 在 <code>testcases</code> 补充典型用例。
	# 涉及样式改动时同步更新 `styles.css`。		# 涉及样式改动时同步更新 <code>styles.css</code>。

	== 发布前检查 ==		== 发布前检查 ==

Maintenance script：统一帮助命名空间内容风格与结构

2026-05-21T03:10:43Z

统一帮助命名空间内容风格与结构

@@ 第1行： / 第1行： @@
 = 模板改造与发布规范 =
-本页回答“模板工程规范怎么用”，用于指导模板改造、发布与巡检。
+本页规定模板改造、测试、发布和回滚的标准流程。
-== 使用前检查（立项） ==
+== 改造前 ==
-# 明确模板类型：导航模板、信息框模板、维护模板或系统模板。
+# 明确模板类型与使用范围。
-# 明确分类策略：哪些分类属于模板页自身，哪些分类应作用于调用页。
+# 明确分类行为（模板自身分类 / 调用页分类）。
-# 对照两条基线：[[帮助:页面分类与归类规范]]、[[帮助:分类命名与层级规范]]。
+# 对照相关规范：[[帮助:模板定义与结构规范]]、[[帮助:页面分类与归类规范]]。
-# 将样式迁移到 `模板:名称/styles.css` 并使用 `<templatestyles />`。
+# 涉及样式改动时同步更新 `styles.css`。
 {{Template:站点帮助文档}}

Maintenance script：重命名为规范风格标题：模板改造与发布规范

2026-05-20T05:00:09Z

重命名为规范风格标题：模板改造与发布规范

新页面

= 模板改造与发布规范 =
本页回答“模板工程规范怎么用”，用于指导模板改造、发布与巡检。

== 使用前检查（立项） ==
# 明确模板类型：导航模板、信息框模板、维护模板或系统模板。
# 明确分类策略：哪些分类属于模板页自身，哪些分类应作用于调用页。
# 对照两条基线：[[帮助:页面分类与归类规范]]、[[帮助:分类命名与层级规范]]。

== 执行流程（标准） ==
=== 1. 结构落地 ===
# 补齐 `模板:名称/Doc` 并在主模板挂载 `{{/Doc}}`。
# 补齐 `模板:名称/sandbox` 与 `模板:名称/testcases`。
# 将样式迁移到 `模板:名称/styles.css` 并使用 `<templatestyles />`。

=== 2. 参数落地 ===
# 在 `/Doc` 写入 `<templatedata>`（参数名、类型、必填、示例）。
# 参数命名保持稳定，新增别名必须在文档显式说明。

=== 3. 分类落地（重点） ===
# 模板页自身分类放 `<noinclude>`。
# 需要作用于调用页的分类放 `<includeonly>`。
# 禁止在主模板裸放 `[[Category:...]]`。
# 维护类分类按需纳入隐藏分类体系（在分类页使用 `__HIDDENCAT__`）。

=== 4. 模块化落地（按需） ===
# 复杂逻辑迁入 Lua 模块（`Module:`），模板仅负责 `#invoke` 路由。
# 改造期间优先在 `/sandbox` 验证，再切主模板。

=== 5. 发布与收口 ===
# 发布前：跑 testcases 与关键调用页 parse 检查。
# 发布后：执行链接/分类收口，确认无分类外溢和无解析错误。

<syntaxhighlight lang="bash">
php maintenance/run.php refreshLinks
php maintenance/run.php recountCategories --mode all
</syntaxhighlight>

== 快速核对清单（可复用） ==
* `Doc` 是否存在并挂载。
* `TemplateData` 是否存在且参数完整。
* `sandbox` 与 `testcases` 是否存在。
* 分类语句是否仅在 `<noinclude>` / `<includeonly>` 合法位置。
* 是否引入高成本解析函数；如有，是否有用途说明与替代评估。
* 关键调用页是否通过渲染回归。

== 常见错误与修正 ==
* 错误：模板页裸放分类导致调用页被误分类。
* 修正：按归属移动到 `<noinclude>` 或 `<includeonly>`。

* 错误：新增分类名称与既有分类同义但不同写法。
* 修正：按分类命名规范复用既有分类并补层级关系。

* 错误：只改主模板不补测试链路。
* 修正：先补 `sandbox/testcases`，再做主模板切换。

== 相关页面 ==
* 概念定义（是什么）：[[帮助:模板定义与结构规范]]
* 分类归类规则：[[帮助:页面分类与归类规范]]
* 分类命名层级规则：[[帮助:分类命名与层级规范]]
{{Template:站点帮助文档}}

[[Category:分类维护]]

帮助:模板改造与发布规范 - 版本历史

Maintenance script：​帮助命名空间规范化：移除一级标题并修正渲染安全写法

Maintenance script：​统一帮助命名空间内容风格与结构

Maintenance script：​重命名为规范风格标题：模板改造与发布规范

Maintenance script：帮助命名空间规范化：移除一级标题并修正渲染安全写法

Maintenance script：统一帮助命名空间内容风格与结构

Maintenance script：重命名为规范风格标题：模板改造与发布规范