模板:Ref
模板文檔 |
本模板全部或部分內容原來自中文維基百科頁面Help:註腳，依 CC BY-SA 3.0 授權引入；原貢獻者可以在這裡看到。 |
註腳是一種標明資料來源、為文章補充註解的方法。註腳一般會在文章內以符號或數字標示出來，然後在文章末端（也就是文章的「腳」的部位），列出所有的補充信息，以及資料來源的詳情。註腳能使編者在保持版面整潔之餘，得以補充細節，且不影響行文的聚焦。
用法
- 開始標籤
<ref>和結束標籤</ref>之間的文字，會集中在使用模板{{reflist}}的地方列出。若沒有{{reflist}}，則所有註腳會被顯示在條目頁面的結尾。 - 您正在閱讀的這個頁面就使用了註腳，會顯示成這樣子：[1]，查閱本頁的原始碼就可以看見使用註腳功能的實例。
<ref>標籤內無法使用模板subst語法，而且也不能嵌套<ref>標籤，所以往往也使用{{refn}}來替代。兩者的使用方式完全相同，僅僅是兩種不同寫法的差異，編者可以自由選擇其中之一。
例子如下：
科學家說，太陽是挺大的<ref>張三（2005年）：《太陽》，第23頁，香港：學術出版社。</ref>。
不過，月亮就沒有那麼大了{{refn|李四：《月亮的大小》，載《科學選輯》第46期，第78頁，北京：科學研究社。}}。
== 注釋 ==
{{reflist}}
顯示效果：
需要注意的是，使用本模板時若注釋內容含有=、|等會被解析為wikitext的符號時，請使用{{=}}、{{!}}等輔助模板替換此類符號，或是改用<ref></ref>標籤。
多處標明同一項註腳
如果想多處標明同一項註腳，請用{{refn|name=Example|...}} 代替<ref>，Example是該註腳的名稱。文章後段如果需要參照同一個註腳，您只需再次輸入帶有Example的註腳就可以了，第二個和以後的註腳裡面寫的東西不僅不會顯示出來，還會導致系統報錯。在末端輸入斜線可產生空標籤：{{refn|name=Example}}。
以下例子使用了同一項註腳三次：
這是多處標明同一項註腳的例子{{refn|name=multiple|請謹記，多次使用同一項註腳，系統只會參照第一次的註腳文字。}}。
這種方法可以表明，同一項注釋作出了多項表述{{refn|name=multiple|這裡寫的字是多餘的，不僅哪裡都不會顯示，還會導致報錯文本出現呦。}}。
不填寫文本參數即可{{refn|name=multiple}}。
== 注釋 ==
{{reflist}}
上述文字碼會顯示成：
這是多處標明同一項註腳的例子[1]。
這種方法可以表明，同一項注釋作出了多項表述[1]。
不填寫文本參數即可[1]。
<ref>標籤；name屬性「multiple」使用不同內容定義了多次
注意：
- name屬性不能是單一的數字。
- name屬性對大小寫和繁簡都敏感。
- 刪除多項註腳的第一項標籤的時候，應當特別留意，以免影響文章後段的一切註腳連結。
參注分組
為了讓注釋和參考文獻的排列更加有條理，推薦將參考和注釋分開來為兩組。繼續使用{{refn|文本}}來表示參考文獻，而使用使用{{note|文本}}來表示注釋（此處相當於{{refn|group=注|文本}}）。例如：
AAA{{refn|參考a}}BBB{{note|注b}}CCC{{refn|參考c}}
----
;參考文獻註腳：
{{reflist}}
;注釋註腳：
{{notelist}}
則會顯示成：
以下為相關模板及其功能的參考：
| 參注分組 | 標註模板 | 對應的列表模板 | 標註效果 | 備註 |
|---|---|---|---|---|
| 參考 | <ref>..</ref>{{Ref}}={{Refn}}={{Refnest}}={{RefTag}} |
{{Reflist}}={{RefFoot}}={{refs}} | [1][2][3] | <ref>標籤本身無法進行嵌套
|
| 註解 | {{Note}}={{NoteTag}} | {{Notelist}}={{NoteFoot}}={{notes}} | [注 1][注 2][注 3] |
也可以自定義分組的數量和名稱。使用{{refn|group=分組名稱|文本}}，group是該註腳的組別，顯示成這樣[分組名稱 1]。而使用{{reflist|group=分組名稱}}便可把該組的註腳顯示。
以下例子使用了兩組註腳：
AAA<ref group="A">參考a</ref>BBB<ref group="B">注b</ref>CCC<ref group="A">參考c</ref>
----
;A組註腳：
<references group="A" />
;B組註腳：
<references group="B" />
則會顯示成：
注意：
- group屬性對大小寫和繁簡都敏感。
- 使用{{note}}或自定義分組時必須同時使用對應的列表模板，否則會報引用錯誤。
註腳文本寫在列表區
如果希望在註腳列表區（通常位於注釋章節）編輯註腳文本，而不是在條目正文的<ref>處書寫，可以使用帶name屬性的<ref>標籤。
即在需要注釋的地方用<ref name="x1" />，同時在參考文獻章節使用
<references> <ref name="x1">foo</ref> <ref name="x2">foo</ref> …… </references>
便實現註腳集中書寫。
每一個<ref>的name值要取一個唯一的名字，除非是需要多處標明同一項註腳。
以下例子使用了兩組註腳：
AAA<ref name="ref1" />BBB<ref name="ref2" />CCC<ref name="ref1" />
----
;註腳：
<references>
<ref name="ref1">foo</ref>
<ref name="ref2">bar</ref>
</references>
則會顯示成：
相關模板
{{註解}}
該模板可以將需要註解的文字高亮化，並在鼠標懸停於文字時顯示註解（PC版）或在右上角顯示註解（移動版）。例如：
[[更新姬]]沒有{{註解|歐派|胸部}}。更新姬沒有歐派(註)胸部。
注意：
- 註解部分僅能使用純文本而不能帶有wikitext或HTML格式。
- 如果註解部分過長，在移動版的顯示效果可能較差。
- 該模板的註解不會在
<references />中列出。
因此，一般來說請優先使用上文的ref形式，尤其是想在注釋中使用格式或注釋部分過長時。
{{refer}}
該模板為特性介於{{註解}}和<ref>標籤之間的註解模板，需配合{{references}}使用。例如：
[[更新姬]]沒有{{refer|歐派|胸部}}。 {{references}}更新姬沒有歐派1。
1. 胸部
模板中還提供了更多可定製內容，用於不能使用原生註腳的情形。
Cite系列模板
源自維基百科的一系列來源注釋模板，包括{{Cite web}}、{{Cite news}}、{{Cite book}}、{{Cite journal}}等，用在ref標籤內部，具體用法詳見各模板文檔。這些模板可以以整齊、統一的格式顯示來源信息，在來源較多或條目比較嚴肅時利於使用，不過需要填寫的參數較為複雜，目前並不強制使用或推廣。