模板:Hatnote
.svg){kind=link}
| 警告 | 此模板被引用於約189,000個頁面，佔全部頁面的4%。 為了避免造成大規模的影響，所有對此模板的編輯應先於沙盒、測試樣例或您的沙盒上測試。 測試後無誤的版本可以一次性地加入此模板中，但是修改前請務必於討論頁發起討論。 模板引用數量會自動更新。 |
| File:Lua-Logo.svg | 此模板使用Lua語言： |
此模板生成格式化的維基百科頂注文本。
{{Hatnote|示例顶注文本。}}→
從廣義上講，頂注應回答讀者（可能是預先產生的）疑問：我是否在正確的頁面上？
功能[編輯]
本模板主要用於在頁面中添加格式規範的頂注。通常（但非絕對）表現為條目頁面頂部的消歧義連結。
本模板也作為其他專用消歧義連結模板的「元模板」使用；完整列表參見Category:頂注模板。
本模板不會自動生成任何連結。如需添加連結或其他格式，必須使用常規的維基百科標記語法顯式實現。
用法[編輯]
- 基本語法：
{{hatnote|文本}}
- 完整參數：
{{hatnote|文本|extraclasses=额外CSS类|selfref=yes|category=no}}
參數說明[編輯]
本模板接受以下參數：
1– 頂注文本內容（必需參數）extraclasses– 需額外添加的CSS類名。例如{{see also}}模板會添加"|extraclasses=boilerplate seealso"類。selfref– 設為yes、y、true或1時，添加CSS類「selfref」，用於標記維基百科站內的自我提及。詳見Template:Self reference說明。category– 設為no、n、false或0時，禁用錯誤跟蹤分類（Category:有錯誤的頂注模板）。此參數僅在最左側參數（即頂注文本）被省略時生效。
範例[編輯]
{{hatnote|示例顶注文本}}→
錯誤處理[編輯]
若未提供頂注文本，模板將輸出以下提示資訊：
- 錯誤：text參數缺失（幫助）。
出現此提示通常由以下四種情況導致：
- 未提供任何參數。
- 提供了參數但未包含頂注文本。
- 頂注文本中包含未轉義的等號（=）。等號在模板參數中具有特殊含義，不能直接用於匿名參數。例如
{{hatnote|2+2=4}}會觸發錯誤。解決方案是使用1=顯式聲明參數名：{{hatnote|1=2+2=4}}。 - 嘗試通過
{{#invoke:hatnote|hatnote|文本}}直接調用Module:Hatnote模組。出於性能考慮，已禁止此種調用方式。請直接使用{{hatnote|文本}}。
觸發此錯誤的頁面會被收錄至Category:有錯誤的頂注模板分類中。
技術實現[編輯]
本模板生成的HTML結構如下：
<div role="note" class="hatnote navigation-not-searchable">頂注文本</div>
底層實現基於Module:Hatnote模組。
模板資料[編輯]
模板資料
|
|---|
|
<templatedata> { "description": "用於建立標準維基百科頂注的模板。頂注是置於條目頂部的簡短說明，用於對密切相關術語進行消歧義，或概括主題範圍、解釋其邊界。", "params": { "1": { "label": "文本", "description": "此字段應包含將在頂注中顯示的文本內容。", "type": "string", "required": true }, "extraclasses": { "type": "line", "label": "額外CSS類", "description": "要添加到包裹頂注文本的標籤上的額外CSS類。"
}, "selfref": { "type": "line", "label": "自我提及", "description": "若頂注文本是對維基百科站內的自我提及，請設為「yes」。（例如：「關於維基百科沙盒，請見WP:SAND」。）" }, "category": { "label": "錯誤分類", "description": "設為「no」、「n」、「false」或「0」可禁用錯誤跟蹤分類（Category:有錯誤的頂注模板）。此設置僅在頂注文本被省略時生效。" } } } </templatedata> |
