這個頁面「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 = 值
}}