說明:模板定義與結構規範
模板定義與結構規範
本頁回答「模板工程規範是什麼」，用於統一模板體系的定義、邊界和約束。
適用範圍
- 模板命名空間（NS=10）主模板及其子頁（`/Doc`、`/sandbox`、`/testcases`、`/styles.css`）。
- 模塊命名空間（NS=828）中為模板提供邏輯支持的 Lua 模塊。
- 模板相關分類體系（模板分類、維護分類、隱藏分類）。
規範目標
- 穩定：模板結構、參數、分類行為長期可預期。
- 可維護：改動可測試、可回滾、可追蹤。
- 可協作：編輯器、維護者、審核者使用同一套規則。
- 可擴展：新增模板與模塊能無縫接入現有體系。
核心構成（定義）
1. 結構規範
- 主模板負責展示與輕量路由。
- 文檔統一在 `模板:名稱/Doc`，並由主模板 `Help:模板定義與結構規範/Doc` 掛載。
- 樣式統一在 `模板:名稱/styles.css`，由 `模板樣式的
src屬性不得為空。` 引入。 - 測試鏈路統一為 `模板:名稱/sandbox` 與 `模板:名稱/testcases`。
2. 參數規範
- 模板參數的權威說明位於 `/Doc` 的 `<templatedata>`。
- 參數命名優先語義化、穩定化，減少短期命名漂移。
3. 分類與歸類規範
- 歸類行為遵循：幫助:頁面分類與歸類規範。
- 分類命名與層級遵循：幫助:分類命名與層級規範。
- 模板頁中：
- 僅文檔頁或維護說明使用 `` 分類。
- 僅調用頁需要繼承的分類使用 `