模板:Ref

模板文檔  

這個文檔嵌入自Help:註腳。

註腳是一種標明資料來源、為文章補充註解的方法。註腳一般會在文章內以符號或數字標示出來，然後在文章末端（也就是文章的「腳」的部位），列出所有的補充信息，以及資料來源的詳情。註腳能使編者在保持版面整潔之餘，得以補充細節，且不影響行文的聚焦。

用法

• 開始標籤<ref>和結束標籤</ref>之間的文字，會集中在使用模板{{reflist}}的地方列出。若沒有{{reflist}}，則所有註腳會被顯示在條目頁面的結尾。
• 您正在閱讀的這個頁面就使用了註腳，會顯示成這樣子：，查閱本頁的原始碼就可以看見使用註腳功能的實例。

• <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}}

上述文字碼會顯示成：

這是多處標明同一項註腳的例子。

這種方法可以表明，同一項註釋作出了多項表述。

不填寫文本參數即可。

註釋

注意：

• name屬性不能是單一的數字。
• name屬性對大小寫和繁簡都敏感。
• 刪除多項註腳的第一項標籤的時候，應當特別留意，以免影響文章後段的一切註腳連結。

參注分組

為了讓註釋和參考文獻的排列更加有條理，推薦將參考和註釋分開來為兩組。繼續使用{{refn|文本}}來表示參考文獻，而使用使用{{note|文本}}來表示註釋（此處相當於{{refn|group=注|文本}}）。例如：

AAA{{refn|參考a}}BBB{{note|注b}}CCC{{refn|參考c}}
----
;參考文獻註腳：
{{reflist}}
;註釋註腳：
{{notelist}}

則會顯示成：

AAABBBCCC

---

參考文獻註腳：

註釋註腳：

以下為相關模板及其功能的參考：

參注分組	標註模板	對應的列表模板	標註效果	備註
參考	<ref>..</ref> {{Ref}}={{Refn}}={{Refnest}}={{RefTag}}	{{Reflist}}={{RefFoot}}={{refs}}		<ref>標籤本身無法進行嵌套
註解	{{Note}}={{NoteTag}}	{{Notelist}}={{NoteFoot}}={{notes}}

也可以自定義分組的數量和名稱。使用{{refn|group=分組名稱|文本}}，group是該註腳的組別，顯示成這樣。而使用{{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" />

則會顯示成：

AAABBBCCC

---

A組註腳：

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>

則會顯示成：

AAABBBCCC

---

註腳：

相關模板

{{註解}}

該模板可以將需要註解的文字高亮化，並在鼠標懸停於文字時顯示註解（PC版）或在右上角顯示註解（流動版）。例如：

[[更新姬]]沒有{{註解|歐派|胸部}}。

更新姬沒有歐派^(註)胸部。

注意：

• 註解部分僅能使用純文本而不能帶有wikitext或HTML格式。
• 如果註解部分過長，在流動版的顯示效果可能較差。
• 該模板的註解不會在<references />中列出。

因此，一般來說請優先使用上文的ref形式，尤其是想在註釋中使用格式或註釋部分過長時。

{{refer}}

該模板為特性介於{{註解}}和<ref>標籤之間的註解模板，需配合{{references}}使用。例如：

[[更新姬]]沒有{{refer|歐派|胸部}}。
{{references}}

更新姬沒有歐派¹。

1. 胸部

模板中還提供了更多可定製內容，用於不能使用原生註腳的情形。

Cite系列模板

源自維基百科的一系列來源註釋模板，包括{{Cite web}}、{{Cite news}}、{{Cite book}}、{{Cite journal}}等，用在ref標籤內部，具體用法詳見各模板文檔。這些模板可以以整齊、統一的格式顯示來源信息，在來源較多或條目比較嚴肅時利於使用，不過需要填寫的參數較為複雜，目前並不強制使用或推廣。