{{NoteTADocumentation subpage}}<includeonly>{{High-risk|G1 = IT4400000+ }}</includeonly>{{notice|G2 = MediaWiki<nowiki />* This page gives technical details for the {{tl|reflist}} template. For a full overview of this template in use, see [[Help:Footnotes]].

{{Documentation subpageTranswiki guide |small=yes |text=See [[Template:Reflist/Transwiki guide|'''this information''']] on copying this template and modifying it for use on another wiki.}}This [[Wikipedia:Citation templates|citation template]] provides formatting and organizational features for [[Help:Footnotes|footnotes]]. It encapsulates the {{tag|references|s}} tag used by the {{Highcite.php}} MediaWiki extension to show the list of references as defined by {{tag|ref|o}} tags. It adds support for sizing the column width, groups and {{ldr}}. ==Parameters==There are no ''required'' parameters; if none are supplied, a single-riskcolumn list will be generated if there are fewer than 10 references in the list. If you have more than 10 references, it will use columns of 30em wide if your device allows this. Optional parameters are:* Unnamed parameter (must be the first one if used): the minimum width for each column of references, typically in [[em (typography)#CSS|540em]]s. Syntax (for example) {{para||30em}} with no space (i.e. not {{para||30 em}}). Note that this replaces '''colwidth'''—see [[#Obsolete parameters|§&nbsp;Obsolete parameters]].* '''refs''': used with {{ldr}}.* '''group''': identifies by name the subset of references to be rendered; the value should correspond to that used inline, e.g.,000+{{tlx|Reflist|2=group=groupname}}renders all references with groupname as the group name ({{tag|ref|o|params=group=groupname}}). There are five pre-defined group names that style the list differently. See [[#Grouped references|§ Grouped references]] below.* '''liststyle''': specifies the style used when the reference list is rendered. The default is a numbered list. When set, it will override the style set by the {{Esotericpara|group}}parameter, without affecting group functionality. See [[#List styles|§ List styles]] below.{{anchor|Multiple uses}} ==Usage=={{markup|title=Using only footnote-style references|<nowiki>Lorem ipsum.<ref>Source name, access date, etc.</ref> Lorem ipsum dolor sit amet.<ref>Source name, access date, etc.</ref>

使用本模板可在條目中顯示註腳（==References=={{tag|refReflist}} ）列表。其涵盖了{{tag</nowiki>|references|s}}的所有功能。Lorem ipsum.<ref>Source name, access date, etc.</ref>Lorem ipsum dolor sit amet.<ref>Source name, access date, etc.</ref>

{{fake heading|sub==参数解说 ==3|References}}{{Reflist}}}}

{{tlcmarkup|1title=ReflistUsing only bibliographical style references (no direct references from the text)|2=欄位數/欄位寬度|3=group=组别|4=refs=列表內容|5=liststyle=|6=list=}}<nowiki>Lorem ipsum. Lorem ipsum dolor sit amet.

; 无名参数1: 按列数分欄（填入自然数）：如{{tlcfake heading|Reflist|2}}將會創造出一個兩欄式的的注釋列表，而{{tlc|Reflistsub=3|3References}} 會產生一個三欄式的列表。視窗大小可变，请慎重定义列数。: 按固定寬度分欄（填入[[em (字体排印学)|em]]等排印单位）：如{{tlc|Reflist|25emRefbegin}} ，瀏覽器會依照這個數值和當前的視窗大小，自動調整欄位數目。: 不填任何内容默认为1。 * reference 1; <code>group</code>: 参见[[#分組註釋|分组注释]]; <code>refs</code>: 将脚注内容集中到一起存放，参见[[#统一存放参考信息集]]; <code>liststyle</code>:; <code>list</code>* reference 2: 手工列出一般参考资料，使用此参数时，模板原本列出{{tag|references|sRefend}} 的功能会无效化。可用{{tl|ReflistH}}/{{tl|ReflistF}} 模板替代。

{{markup|title=== 过时参数 ===Using both footnote-style and bibliography-style references; |<nowiki>Lorem ipsum.<coderef>colwidthSource name, access date, etc.</coderef>: 已合并到无名参数1

==References=={{markup|title=只使用内文注释|<nowiki>一條青龍一氣通<ref>參考1</ref>，二盤連莊二本場<ref>參考2</ref>。Reflist}}

==參考資料=={{Refbegin}}* reference 1* reference 2{{ReflistRefend}}</nowiki>| 一條青龍一氣通Lorem ipsum.<ref> 參考1Source name, access date, etc.</ref> ，二盤連莊二本場Lorem ipsum dolor sit amet.<ref> 參考2Source name, access date, etc.</ref> 。

{{fake heading| 參考資料sub=3|References}}

* <strong>Note 1:</strong> The syntax {{tlx|Reflist|2}} (for example), which specifies two columns of equal width ''regardless of the available display width'', is deprecated (and is disabled for mobile view). When you use 1 the template gives you a single column while 2 will pretend you specified 30em. When using higher column counts, it will pretend you specified 25em.* <strong>Note 2:</strong> Browser support: Internet Explorer 10+, Microsoft Edge, Firefox 2+, Chrome 4+, Safari 3.1+, Opera 11.1+ ===List-defined references==={{see|Help:List-defined references}} A list of references may be defined within {{tl|Reflist}} using the {{para|refs}} parameter, just like including named {{tag|ref|params=name="..."}} elements inside the {markup{tag|titlereferences}} container. ====Example==== 只使用一般注释{{markup|<nowiki> 一條青龍一氣通，二盤連莊二本場。This is reference 1.<ref name="refname1" />This is reference 2.<ref name="refname2" />

== 參考資料References=={{Reflist|listrefs=* 书目a<ref name="refname1">content1</ref>* 书目b<ref name="refname2">content2</ref>

| 一條青龍一氣通，二盤連莊二本場。This is reference 1.<ref name="refname1" group=decimal/>This is reference 2.<ref name="refname2" group=decimal/>

{{fake heading| 參考資料sub=3|References}}{{Reflist|listgroup=decimal|refs=* 书目a<ref name="refname1">content1</ref>* 书目b<ref name="refname2">content2</ref>

===Grouped references==={{markupdetails|titleWP:REFGROUP}} References can be grouped into separate sections (for explanatory notes, table references, and the like) via <code>group=</code>::{{tag|ref|open|params=group=<var>groupname</var>}}where <var>groupname</var> is (for example) <code>notes</code> or <code>sources</code>. The group name need not be enclosed in quotes; this differs from the footnote marker where quotes are required if the group name includes a space. Each group used in the article must have a matching reference list::{{tlx|Reflist|2=group=<var>groupname</var>}} ====Predefined groups==== 内文与一般注释混合使用{{details|H:PREGROUP}} There are predefined group names that automatically set the labels in the footnote markers and the reference list to other styles. Thus, setting <code><nowiki> 一條青龍一氣通{{Reflist|group=lower-alpha}}<ref/nowiki> 參考1</refcode> will set the group to <code> ，二盤連莊二本場lower-alpha</code> and will style the reference list with lower alpha characters. The matching footnote marker can be formed by {{tag|ref|params=group=lower-alpha}}. This is made easier by a series of templates to set the group/label styles for the footnote marker and the reference list:{{#section:Help:Footnotes|pregrouptable}} ===List styles==={{for|technical details|Help:Cite link labels}} As noted in [[#Predefined groups|§ Predefined groups]], there are predefined groups that automatically add list styling. Using the listed templates is more convenient than using {{para|liststyle}}. Reference lists are by default numbered lists. By using the {{para|liststyle}} parameter, you can control how the list is rendered. For example, using {{para|liststyle|upper-roman}} will result in references being labeled with [[Roman numerals]] instead of decimal numbers. The parameter accepts any valid CSS value defined for <code> 參考2list-style-type</refcode> 。as shown below.{{CSS list-style-type values}}

==參考資料==It is possible to use {{Reflistpara|liststyle}}so that the labels for the footnote marker and the reference list marker differ. This should be used with care as it can be confusing to readers. For example:

{{Reflistmarkup|list1=* 书目a* 书目b}}</nowiki>|一條青龍一氣通<ref>參考1</ref>，二盤連莊二本場<refgroup=note> 參考2Reference</ref> 。

{{fake headingReflist|group=note| 參考資料liststyle=lower-alpha}}{{Reflist}}</nowiki>|2=<ref group=note>Reference</ref>

{{Reflist|listgroup=* 书目a* 书目bnote|liststyle=lower-alpha}}

=== 分栏 Supporting CSS==={{tl|Reflist}} uses a CSS rule in [[MediaWiki:Common.css]] to set the font size:* <code>div.reflist { font-size: 90%; }</code>

{{Rellink|不支持Internet Explorer 9、Firefox 1The following class is assigned by the template when column width is set:* <code>.0、Safari 2、Opera 11.0及更低版本，这些浏览器只会显示为单行}}references-column-width</code>

複數欄位是使用 [[The following CSS|CSS3]] 作為基礎，目前使用[[Gecko]]（如[[Mozilla Firefox]]等）与[[Kestrel]]（[[Opera]]9.5及以上版本）作排版引擎的瀏覽器會得到較佳的效果properties are utilized using the {{refTagtl|1={{cite web|url=http://www.stuffandnonsense.co.uk/archives/css3_multi-column_thriller.html|title=CSS3 Multicolumn-Column Thriller|accessdate=2006年11月24日|date=2005年12月30日width}}}}，但由於 CSS 是網頁上的標準之一，因此日後將能適用在更多的瀏覽器{{refTag|1={{cite web|url=httptemplates:* <code>column-width</code> CSS3 standard* <code>-moz-column-width</www.w3.org/TR/css3code> Mozilla CSS extension* <code>-multicol|title=CSS3 module: Multiwebkit-column layout|publisher=[[World Wide Web Consortium|W3C]]|date=2005年12月15日|accessdate=2006年11月24日}}}}。-width</code> Webkit CSS extension

===Customizing the view==={{markup|title=分为2栏see|<nowiki>一條青龍一氣通<ref>參考1</ref>，二盤連莊二本場<ref>參考2</ref>。Help:Reference display customization}}

==參考資料=={{ReflistBy editing your CSS, the personal appearance of the reference list can be customized. From [[Special:Preferences|2}}</nowiki>|一條青龍一氣通<ref>參考1</ref>，二盤連莊二本場<ref>參考2</ref>。Preferences]], select the Appearance tab, then on the selected skin select Custom CSS. After editing and saving, follow the instructions at the top of the page to purge. See [[Wikipedia:Skin#Customisation (advanced users)]] for more help.

<source lang==參考資料=="css">ol.references,div.reflist,div.refbegin {{Reflist|30em font-size: 90%;}}</nowiki>|一條青龍一氣通<ref>參考1</ref>，二盤連莊二本場<ref>參考2</refsource> 。

於2008年6月開始，腳註系統支援了把註釋分成不同組合。這允許組合註釋、參考以及其他。請參閱 {{en}}[[To disable columns, add:en:Wikipedia:Footnotes#Separating reference lists and explanatory notes|Wikipedia:Footnotes#Separating reference lists and explanatory notes]]。

標籤的原始碼为{{tag|ref group&#61;''<source lang="groupnamecss"''|open}}，对应註腳列表的原始碼，>.references-column-width {{tlx|Reflist|group&#61 -moz-column-width: auto !important; -webkit-column-width: auto !important; column-width: auto !important;''"groupname"''}} 。而其中的「groupname」是組合的名稱，如「注」、「参」或「标签」。注意groupname对简繁体敏感。</source>

花<ref groupsource lang=" 注释css"> 注释2.references-column-width { -moz-column-rule: 1px solid #aaa; -webkit-column-rule: 1px solid #aaa; column-rule: 1px solid #aaa;}</refsource> 自槓頭髮，月從海底撈<ref group="参考">参考2</ref>。

==Perennial suggestions= 参考==={{Reflist|group=参考}}</nowiki>|三元兼四喜，滿貫<ref group="注释">注释1</ref>遇全么<ref group="参考">参考1</ref>。'''Collapsing and scrolling'''

{{fake heading|注释和参考资料}}{{fake heading|sub=3|注释}}{{Reflist|group=注释}}{{fake heading|sub=3|参考}}{{Reflist|group=参考}}}}=== 统一存放参考信息集 ===<!-- As of September 2009, references may be defined within {{tl|Reflist}} using {{para|refs}} and invoked within To display the content. There are new error messages associated with this updatereference list in a scrollbox or collapsed per user, documented at see [[Help:Cite errorsReference display customization]]. -->从2014年2月开始，该模板可以通过{{para|refs}}统一存放注脚信息来方便管理。此次更新的相關引用错误问题的提示文件見[[:en:Help:Cite errors]]。

{{markup For discussion on previous attempts to do this with a template, see the discussions for [[Wikipedia:Templates for deletion/Log/2007 June 11#Template:Scrollref| title = 示例Scrollref]] and [[Wikipedia:Templates for discussion/Log/2010 May 26#Template:Refbox|<nowiki>这是参考A<ref name="refname1" />。Refbox]].

There have been suggestions to include section header markup such as <code>== 参考资料References=={{Reflist|refs=<ref name="refname1">内容1</refcode>. This is inadvisable because:<ref * There is no standard section name="refname2">内容2<{{crossref|(see {{section link|WP:Manual of Style/ref>Layout|Notes and references}})}}</nowiki>.|这是参考A<ref name="refname1" group=upper-alpha/>。* When transcluded, the article will have an edit link that will confusingly open the template for editing.

这是参考B<ref name="refname2" group=upperObsolete parameters==These parameters are no longer in use:* '''colwidth''': Same as specifying a column-width for the first unnamed parameter. Replaced by width as unnamed first parameter.* '''close''': Until 2014, the parameter {{para|close|1}} was used to work around a bug involving multiple uses of {{tl|Reflist}} on the same page. When the bug was fixed, this was removed. ''(For multiple uses on talk pages and other non-article pages structured in sections, see {{tl|Reflist-alpha/>。talk}}.)''

Articles using unsupported parameters are tracked in {{fake headingclc| 参考资料}}{{Reflist|group=upper-alpha|refs=<ref name="refname1">内容1</ref><ref name="refname2">内容2</ref>}}Pages using reflist with unknown parameters}}.

== 模板數據Template data=={{templatedataheaderTemplateDataHeader}}

"description": " 在條目中加入一個使用較小字級顯示的註腳列表。This template displays the list of footnotes at the end of an article and provides additional formatting and organizing options. After hitting \"Apply changes\" and turning back to VE read mode, you will not see the references list. After hitting \"Publish page\" and turning back to normal read mode the reference list will reappear with the changes applied, see T53146.", "params": { "colwidth1": { "label": " 欄位的寬度", "description": "瀏覽器會依照這個數值和當前的視窗大小自動調整欄位數目，請依照該頁面中注釋的平均寬度來填寫欄位的寬度數值。填入後參數「1」將被忽略。Columns / Column width", "type": "string/line", "required": false }, "1description": { "label"Two modes supported. First mode (deprecated): integer number of fixed columns into which the reference list is to be rendered. Second mode: "欄位的數目typographic unit of measurement such as 'em', specifying the width for the reference list columns, e.g. '33em'; spaced '33&nbsp;em' will not be recognized", "descriptiondefault": " 欄位的數目，填入2將創造一個兩欄式的的注釋列表，如此類推。1 if < 11 references; otherwise 30em", "typealiases": "number",[ "default": "1colwidth", "required": false ] }, "listliststyle": { "label": " 自定義註釋內容Liststyle", "descriptiontype": " 自定義註釋內容。string", "defaultrequired": "<references />"false, "typedescription": "stringSpecifies the style used when the reference list is enumerated; accepts any valid CSS value defined for list-style-type", "requireddefault": false"decimal" }, "refsgroup": { "label": "Group", "type": "string", "required": false, "description": "Group is an identifier which restricts the references that are shown. Without this parameter, this template only shows references with no group identifier. With a group identifier specified, only references with a matching group identifier are handled. The rest are left alone." }, "grouprefs": { "label": " 註腳組別名稱List of references", "descriptiontype": " 註腳組別的名稱，即在插入參考文獻時「使用此組」輸入的名稱。string", "typerequired": "string/line"false, "requireddescription": false"Provides a space to define named references for use in the article. References defined in this space are not shown unless used somewhere in the article." } }

== 参考文献See also==* {{RefFootphab|T53260}}- Cite: Support multi-column and alternative list-style for {{tag|references|s}} tag (like enwiki {{tl|reflist}})* [[Wikipedia:Citing sources]]&nbsp;– style guide for the citation of sources* [[Wikipedia:Citation templates]]&nbsp;– templates for use with references* {{tl|Refbegin}} and {{tl|Refend}}&nbsp;– format reference lists

'''Variants'''* {{tl|Template reference list}}&nbsp;– version of reflist for use in templates* {{tl|Reflist-talk}}&nbsp;– for use in talk page sections and other non-mainspace pages == 參見References==*{{tlxReflist|group=general|refs=<ref group=general name=fontsize>See [[User:Edokter/fonttest]] for a comparison of font sizes for various browsers; see [//en.wikipedia.org/w/index.php?title=Special%3ASearch&redirs=1&search=fonttest+prefix%3AMediaWiki+talk%3ACommon.css%2F&fulltext=Search&ns0=1 previous discussions] on changing the font size to resolve the IE issue.</ref><ref group=general name=stuffandnonsense>{{cite web |accessdate=November 24, 2006 |ReferencesWithExtradate=December 30, 2005 |title=CSS3 Multi-Column Thriller |url=http://www.stuffandnonsense.co.uk/archives/css3_multi-column_thriller.html}}</ref> *<ref group=general name=w3org1>{{tlxcite web |url=http://www.w3.org/TR/css3-multicol/ |Notelisttitle=CSS3 module: Multi-column layout |publisher=[[World Wide Web Consortium|W3C]] |date=December 15, 2005 |accessdate=November 24, 2006}}</ref>*<ref group=general name=msdn>{{tlxcite web |TRefListurl=http://msdn.microsoft.com/en-us/library/cc351024(VS.85).aspx#multicolumn |title=CSS Compatibility and Internet Explorer: Multi-column Layout |work=Microsoft Developer Network |publisher=Microsoft |accessdate=March 16, 2011}}</ref>}}{{Wikipedia referencing}}*在討論頁顯示參考文獻請用{{tlx|Reflist-talkWikipedia template messages}}{{Wikipedia technical help}}<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox| |*[[WikipediaCategory: 腳注Footnote templates]]*[[WikipediaCategory: 列明來源Reference list templates]]