模板:Note
本模板全部或部分內容原來自中文維基百科頁面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標籤內部,具體用法詳見各模板文檔。這些模板可以以整齊、統一的格式顯示來源信息,在來源較多或條目比較嚴肅時利於使用,不過需要填寫的參數較為複雜,目前並不強制使用或推廣。