檢視模板:Reflist/doc 的原始碼 | 香港網絡大典

{{documentation subpage}}
<!-- 在這行之下編輯模板說明文件 -->
這模板封裝了 {{tag|references |single}} 標籤來顯示 {{tag|ref}} 標籤所定義的參考資料列表，並使用了一些格式來顯示。它縮小了字形大小並為欄位和群組功能增設選項。參考資料可以定義在條目內文內或參考資料列表內。

{{tag|ref}} 和 {{tag|references |single}} 標籤是 [[mw:Extension:Cite/Cite.php|Cite.php]] MediaWiki 擴展的一部份。

<!-- 暫時未加入 Refbegin 和 Refend 模板，等加入了才翻譯以下這句。
{{tl|Reflist}} may be used with {{tl|Refbegin}} and {{tl|Refend}} to format different styles of references.
-->

== 用法 ==

;只使用註腳風格的參考資料
<pre>
== 內容 ==
Lorem ipsum.<ref>Source name, access date, etc.</ref>

Lorem ipsum dolor sit amet.<ref>Source name, access date, etc.</ref>

== 參考資料 ==
{{Reflist}}
</pre>
<!-- 暫時未加入 Refbegin 和 Refend 模板，等加入了才翻譯以下段落。
;Using only bibliographical style references
<pre>
== Content ==
Lorem ipsum.

Lorem ipsum dolor sit amet.

== References ==
{{refbegin}}
* reference 1
* reference 2
{{refend}}
</pre>

;Using both footnote-style and bibliography-style references
<pre>
== Content ==
Lorem ipsum.<ref>Source name, access date, etc.</ref>

Lorem ipsum dolor sit amet.<ref>Source name, access date, etc.</ref>

Lorem ipsum.

Lorem ipsum dolor sit amet.

== References ==
{{Reflist}}

{{Refbegin}}
* reference 1
* reference 2
{{Refend}}
</pre>
-->

== 字形大小 ==
The font size should reduce to 90% for most browsers, but may appear to show at 100% for Internet Explorer and possibly other browsers.<ref name=fontsize/> Note that there is no consensus that a small font size should always be used for references; when normal-sized font is more appropriate on an article, use {{tag|references |single}} instead.

== 欄位 ==
Columns are currently supported only by [[Gecko (layout engine)|Gecko]]-based browsers (such as [[Mozilla Firefox]]). See [[#Browser support for columns|below]] for more information.

Using {{tlx|Reflist|2}} will create a two-column reference list, and {{tlx|Reflist|3}} will create a three-column list.  Three-column lists are inaccessible to users with smaller/laptop monitors and should be avoided.

Using {{tlx|Reflist|colwidth{{=}}30em}} will allow the browser to automatically choose the number of columns based on the width of the web browser.  Choose a column width that is appropriate for the average width of the references on the page.

== 多次使用 ==

If {{tl|Reflist}} is used multiple times without a parameter, each instance will include all of the previously defined references. To force the parser to close previous references, each use of {{tl|Reflist}} must be forced as a new instance by the use of any parameter. Even a undefined parameter such as {{tlx|Reflist|close&#61;1}} will force the references to close.

== 分組的參考資料 ==
As of June 2008, the footnotes system supports the separation of references into groups. This allows groups for explanatory notes, table references and the like. See [[Wikipedia:Footnotes#Separating reference lists and explanatory notes]].

The general format for the reference tag would be:

:{{tag|ref group&#61;''"groupname"''|open}}

And for the reflist:
:{{tlx|Reflist|group&#61;''"groupname"''}}

:Where ''groupname'' would be a group identifier such as "note", "nb" or "label".

== 列表內定義的參考資料 ==
到 2010 年 7 月 22 日為止，香港網絡大典架設在的 wikia 所使用的維基軟體版本還未支援在 {{tag|refereces}} 內撰寫參考資料。

{{see|WP:LDR}}
As of September 2009, references may be defined within {{tl|Reflist}} using "refs" and invoked within the content. There are new error messages associated with this update, documented at [[Help:Cite errors]]. As usual, groups can be used. Defined references must be used within the body; unused references will show an error message.

=== 範例 ===

<pre>
This is reference 1.<ref name="refname1" group="groupname"/>
This is reference 2.<ref name="refname2" group="groupname"/>
This is reference 3.<ref name="refname3" group="groupname"/>

{{Reflist|group="groupname"|refs=
<ref name="refname1" group="groupname">content1</ref>
<ref name="refname2" group="groupname">content2</ref>
<ref name="refname3" group="groupname">content3</ref>
}}
</pre>

=== 結果 ===

This is reference 1.<ref name="refname1" group="groupname"/>
This is reference 2.<ref name="refname2" group="groupname"/>
This is reference 3.<ref name="refname3" group="groupname"/>

{{Reflist|group="groupname"|refs=
<ref name="refname1">content1</ref>
<ref name="refname2">content2</ref>
<ref name="refname3">content3</ref>
}}

== 技術細節 ==

==== 瀏覽器對多欄位的支援度 ====
Multiple columns are generated by using [[Cascading Style Sheets|CSS3]], which is still in development; thus only browsers that properly support the multi-column property will show multiple columns.<ref name=stuffandnonsense /><ref name=w3org1/>

* [[Mozilla Firefox]] and other [[Gecko (layout engine)|Gecko]]-based browsers support multiple columns with two caveats:
**may create [[Widows and orphans|widows]]
**may mangle long URLs in the printable version; see [[:Image:Wikipediareflistoverlap.gif]] for an example
* [[Internet Explorer]] through version 8 does not support the column property<ref name=msdn />
* [[Safari (web browser)|Safari]] through 4.03, [[Google Chrome]] and probably other [[WebKit]] based browsers have a bug that breaks links in multiple columns; the column feature has been removed for these browsers until the bug is resolved; see [[Template:Reflist/Safari testcase]] for details and information on enabling WebKit columns per editor.
::This issue has been resolved in Safari 5 and Chrome 5. WebKit support will be returned once the usage reports indication a preponderance of adoption.<ref>{{cite web |title=Wikimedia Visitor Log Analysis Report - Browsers e.a |url=http://stats.wikimedia.org/wikimedia/squids/SquidReportClients.htm |date=June 1, 2010}}</ref>
* [[Opera (web browser)|Opera]] does not support multiple columns.

=== 支援的 CSS ===
{{tl|Reflist}} uses a CSS rule in [[MediaWiki:Common.css]] to set the font size:

* <code>.references-small { font-size: 90%;}</code>

These classes are used directly in the template for the columns:

* <code>.references-column-count</code>
* <code>.references-column-width</code>

These properties are used in the template:

* <code>column-count</code> CSS3 standard
* <code>column-width:auto</code> CSS3 standard
* <code>-moz-column-count</code> Mozilla CSS extension
* <code>-moz-column-width</code> Mozilla CSS extension
* <code>-webkit-column-count</code> Webkit CSS extension (disabled)
* <code>-webkit-column-width</code> Webkit CSS extension (disabled)

=== 自訂外觀 ===
By editing your CSS, the personal appearance of the reference list can be customized. From [[Special:Preferences|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.

;Font size
The font size defaults to 90% of the standard size. To change it, add:

<source lang="css">.references-small { font-size: 90%;}</source>

Change 90% to the desired size.

;Columns
To disable columns, add:

<source lang="css">
.references-column-count, .references-column-width {
    column-count:1 !important;
    column-width:auto !important;
    -moz-column-count:1 !important;
    -moz-column-width:auto !important;
    -webkit-column-count:1 !important;
    -webkit-column-width:auto !important;
}
</source>

Similarly, to force all reference lists to a number of columns, change the number.

=== 拆疊與捲動 ===
There have been a number of requests to add functionality for a collapsible or scrolling reference list. These requests have not been fulfilled to due to issues with readability, accessibility, and printing. The applicable guidelines are at [[MOS:SCROLL]].

The links between the inline cite and the reference list do not work when the reference list is enclosed in a collapsed box.

==模板重定向==
* {{tl|Template:Reflist}} - 現在這模板。
* {{tl|Template:Reference}} - 重定向到現在這模板的模板，因而兩者功能一樣。

== 另見 ==
<!--
* [[Wikipedia:Citing sources]]—style guide for the citation of sources
* [[Wikipedia:Footnotes]]—style guide for footnotes and inline citations
* [[Wikipedia:Citation templates]]—templates for use with references
* {{tl|Template reference list}}—version of reflist for use in templates
* {{tl|Refbegin}} and {{tl|refend}}—format reference lists
* {{tl|Reflist-talk}}—for use on talk pages
-->

==參考==
*[[wikipedia:en:template:reflist|英文維基百科模板:reflist]]
*[[wikipedia:zh:template:reflist|中文維基百科模板:reflist]]

== 參考資料 ==
{{Reflist|refs=

<ref name=fontsize>See [[User:Edokter/fonttest]] for a comparison of font sizes for various browsers; see [http://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 name=stuffandnonsense>{{cite web |accessdate=November 24, 2006 |date=December 30, 2005 |title=CSS3 Multi-Column Thriller |url=http://www.stuffandnonsense.co.uk/archives/css3_multi-column_thriller.html}}</ref>

<ref name=w3org1>{{cite web |url=http://www.w3.org/TR/css3-multicol/ |title=CSS3 module: Multi-column layout |publisher=[[World Wide Web Consortium|W3C]] |date=December 15, 2005 |accessdate=November 24, 2006}}</ref>

<ref name=msdn>{{cite web |url=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=September 15, 2008}}</ref>

}}

<includeonly>
<!-- 在這行之下添加分類 -->
[[Category:引用模板|{{PAGENAME}}]]
[[Category:香港網絡大典維護模板]]
</includeonly>