NeuroWiki:模板规范

这个页面“NeuroWiki:模板规范”是NeuroWiki的现行的指引

• 指引文本用于描述NeuroWiki现行的具有约束力的操作方法与规范；
• 用户应当遵守该页面所述内容；
• NeuroWiki的站长保留对一切条文的最终解释权。

核心原则

1. 功能性优先：避免创建功能重复的模板
2. 低消耗设计：模板渲染时间＜200ms
3. 语义化命名：模板名要求与实际功能相关联，以英文名为页面，允许创建本地化重定向
4. 强制文档化：所有模板必须附带使用说明

模板分类

分类前缀	用途	示例	权限要求
Info/	页面级信息框	{{Info/过时内容}}	自动确认用户
Nav/	导航模板	{{Nav/直播记录}}
Infobox/	详细信息框模板	{{Infobox/人物}}
System/	系统级模板	{{System/保护通知}}	仅管理员或行政员

命名规范

• 采用「用途_对象」结构：

 - 正确：{{Info/引用}}
 - 错误：{{蓝色引用框}}

• 多语言版本使用前缀：

 - 中文：Template:Nav/直播记录
 - 英文：Template:Nav/Livestream

技术标准

参数设计

• 必填参数使用{{{1}}}格式
• 可选参数采用语义化命名：

 - 正确：{{{color|#36c}}}
 - 错误：{{{2}}}

• 嵌套层级≤3层（通过{{subst:}}优化）

性能限制

指标	阈值	检测工具
解析时间	＜200ms
内存占用	＜2MB	mw:Help:ResourceLoader
调用次数	＜50次/页	mw:Extension:TemplateWarn

文档要求

• 必须包含以下章节：

```mediawiki
== 功能描述 ==
== 参数列表 ==
{| class="wikitable"
! 参数 !! 类型 !! 说明
|-
| {{{1}}} || 必填 || 主内容
|}
== 使用示例 ==
{{Test/示例模板
| 参数1 = 值
}}