模板:Reflist/doc

使用本模板可在條目中顯示註腳（<ref>...</ref>）列表。其涵蓋了<references />的所有功能。

此頁面是Template:Reflist的模板文件。 此頁面可能包含了模板的使用說明、分類和其他內容。

此模板文件被引用於約997,000個頁面，佔全部頁面的13%。 為了避免造成大規模的影響，所有對此模板文件的編輯應先於沙盒、測試樣例或您的沙盒上測試。 測試後無誤的版本可以一次性地加入此模板文件中，但是修改前請務必於討論頁發起討論。 模板引用數量會自動更新。

本模板含有複雜而精密的擴充語法。 編輯本模板前，建議您先熟悉解析器函數與本模板的設計思路、運作原理等。若您的編輯引發了意外的問題，請儘快復原編輯，因為本模板可能被大量頁面使用。 您所作的編輯可先在模板沙盒或您的個人頁面中進行測試。

參數解說

{{Reflist|欄位數/欄位寬度|group=組別|refs=列表內容|liststyle=|list=}}

本模板所有參數均為可選

無名參數1

按固定寬度分欄（填入em等排印單位）：如{{Reflist|25em}}，瀏覽器會依照這個數值和當前的視窗大小，自動調整欄位數目。

按列數分欄（填入自然數；此機制不建議使用）：如{{Reflist|2}}將會創造出一個兩欄式的的註釋列表，而{{Reflist|3}}會產生一個三欄式的列表。視窗大小可變，請慎重定義列數。

不填任何內容預設為1。

group

參見分組註釋

refs

將註腳內容集中到一起存放，參見#統一存放參考資訊集

liststyle

list

手工列出一般參考資料，使用此參數時，模板原本列出<references />的功能會無效化。可用{{ReflistH}}/{{ReflistF}}模板替代。

過時參數

colwidth

已合併到無名參數1

用法

只使用內文註釋

原始碼	效果
一條青龍一氣通<ref>參考1</ref>，二盤連莊二本場<ref>參考2</ref>。 ==參考資料== {{Reflist}}	一條青龍一氣通[1]，二盤連莊二本場[2]。 參考資料 參考1 參考2

只使用一般註釋

原始碼	效果
一條青龍一氣通，二盤連莊二本場。 ==參考資料== {{Reflist|list= * 书目a * 书目b }}	一條青龍一氣通，二盤連莊二本場。 參考資料 書目a 書目b

內文與一般註釋混合使用

原始碼	效果
一條青龍一氣通<ref>參考1</ref>，二盤連莊二本場<ref>參考2</ref>。 ==參考資料== {{Reflist}} {{Reflist|list= * 书目a * 书目b }}	一條青龍一氣通[1]，二盤連莊二本場[2]。 參考資料 參考1 參考2 書目a 書目b

分欄

不支持Internet Explorer 9、Firefox 1.0、Safari 2、Opera 11.0及更低版本，這些瀏覽器只會顯示為單行

複數欄位是使用 CSS3 作為基礎，目前使用Gecko（如Mozilla Firefox等）與Kestrel（Opera (瀏覽器)9.5及以上版本）作排版引擎的瀏覽器會得到較佳的效果^[I]，但由於 CSS 是網頁上的標準之一，因此日後將能適用在更多的瀏覽器^[II]。

按寬度分欄（例如{{Reflist|30em}}）會讓瀏覽器在給定最小寬度的前提下（如寬度至少為30 em），顯示儘可能多的欄目。寬度單位支持em, ex, in, cm, mm, pt, pc, px，但是通常使用em。數字和單位之間不能有空格。不支持使用百分比。

根據參考內容的寬度選擇合適的寬度：

• 30em：當有大量參考文獻且參考條目有一頁寬時適用。例如：張伯苓的版本71040939#參考文獻
• 20em：當有寬度較短的哈佛參考文獻格式（如{{Template:Sfn}}）時適用。例如：南方十字 (無字小說)的版本71611463#註腳.

分為2欄

原始碼	效果
一條青龍一氣通<ref>參考1</ref>，二盤連莊二本場<ref>參考2</ref>。 ==參考資料== {{Reflist|2}}	一條青龍一氣通[1]，二盤連莊二本場[2]。 參考資料 參考1 參考2

按30em寬度分欄

原始碼	效果
一條青龍一氣通<ref>參考1</ref>，二盤連莊二本場<ref>參考2</ref>。 ==參考資料== {{Reflist|30em}}	一條青龍一氣通[1]，二盤連莊二本場[2]。 參考資料 參考1 參考2

分組註釋

於2008年6月開始，腳註系統支援了把註釋分成不同組合。這允許組合註釋、參考以及其他。請參閱 （英文）Wikipedia:Footnotes#Separating reference lists and explanatory notes。

標籤的原始碼為<ref group="groupname">，對應註腳列表的原始碼，{{Reflist|group="groupname"}}。而其中的「groupname」是組合的名稱，如「注」、「參」或「標籤」。注意groupname對簡繁體敏感。

部分分組會顯示特殊效果，如<ref group="upper-alpha">...</ref>的生成的註腳為^[A]，<ref group="lower-alpha">...</ref>生成的為^[a]。

按「註釋」和「參考」分組

原始碼	效果
三元兼四喜，滿貫<ref group="注释">注释1</ref>遇全么<ref group="参考">参考1</ref>。 花<ref group="注释">注释2</ref>自槓頭髮，月從海底撈<ref group="参考">参考2</ref>。 ==注释和参考资料== ===注释=== {{Reflist|group=注释}} ===参考=== {{Reflist|group=参考}}	三元兼四喜，滿貫[註釋 1]遇全麼[參考 1]。 花[註釋 2]自槓頭髮，月從海底撈[參考 2]。 註釋和參考資料 註釋 註釋1 註釋2 參考 參考1 參考2

統一存放參考資訊集

從2014年2月開始，該模板可以透過|refs=統一存放註腳資訊來方便管理。此次更新的相關引用錯誤問題的提示檔案見en:Help:Cite errors。

範例

原始碼	效果
这是参考A<ref name="refname1" />。 这是参考B<ref name="refname2" />。 ==参考资料== {{Reflist|refs= <ref name="refname1">内容1</ref> <ref name="refname2">内容2</ref> }}	這是參考A[A]。 這是參考B[B]。 參考資料 內容1 內容2

模板數據

以下是該模板的模板資料，適用於視覺化編輯器等工具。

Reflist模板資料

模板參數

參數		描述	類型	狀態
欄位的寬度	colwidth	瀏覽器會依照這個數值和當前的視窗大小自動調整欄位數目，請依照該頁面中註釋的平均寬度來填寫欄位的寬度數值。填入後參數「1」將被忽略。	行	非必填
欄位的數目	1	欄位的數目，填入2將創造一個兩欄式的的註釋列表，如此類推。 預設 1	數值	非必填
自訂註釋內容	list	自訂註釋內容。 預設 <references />	字串	非必填
refs	refs	沒有描述	字串	非必填
註腳組別名稱	group	註腳組別的名稱，即在插入參考文獻時「使用此組」輸入的名稱。	行	非必填

在條目中加入一個使用較小字級顯示的註腳列表。

參考文獻

1. CSS3 Multi-Column Thriller. 2005年12月30日 [2006年11月24日].
2. CSS3 module: Multi-column layout. W3C. 2005年12月15日 [2006年11月24日].

參見

• {{ReferencesWithExtra}}
• {{Notelist}}
• {{Template reference list}}
• 在討論頁顯示參考文獻請用{{Reflist-talk}}
• Help:註腳
• Wikipedia:列明來源

重新導向

• {{註腳}}