Template:Reflist/doc

2009-09-06T19:38:08Z

216.171.189.244: css3 multicol is a property, not a selector

{{documentation subpage}}


==Usage==
Use this template to create a reference list in small font for an article. Note that there is no consensus that small font size should always be used for all references; when normal-sized font is more appropriate on an article, use <code><nowiki><references /></nowiki></code> instead.

If used with no parameters, it will produce a reference list with a single column.

===Font size===
The font size should reduce to 90% for most browsers, but may appear to show at 100% for Internet Explorer and possibly other browsers. Reflist uses one CSS entry in [[MediaWiki:Common.css]] to set the font size:

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

Editors may over-ride this settings by placing entries in their personal CSS.

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

Using <code>{{tlx|Reflist|colwidth{{=}}30em}}</code> 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.

====Browser support====
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>{{cite web|accessdate=2006-11-24|date=[[2005-12-30]]|title=CSS3 Multi-Column Thriller|url=http://www.stuffandnonsense.co.uk/archives/css3_multi-column_thriller.html}}</ref><ref>{{cite web|url=http://www.w3.org/TR/css3-multicol/|title=CSS3 module: Multi-column layout|publisher=[[World Wide Web Consortium|W3C]]|date=[[2005-12-15]]|accessdate=2006-11-24}}</ref>

* [[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]] does not currently support the column selector; version 8 is not scheduled to support it.<ref>{{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=2008-09-15}}</ref>
* [[Safari (web browser)|Safari]] through 3.2.2 and 4 beta, [[Google Chrome]] and possibly 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.
* [[Opera (web browser)|Opera]] does not support multiple columns.

==== Disabling multiple columns for your account ====
If you cannot abide multiple columns, you may add the following to your personal CSS file (after [[Special:UserLogin/signup|creating an account]] if you have not already done so) to force single-column display while logged in to your account:
<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>
This will normally have to be added to your [[Special:MyPage/monobook.css|monobook.css]]; if you are using a different skin, look in the "Personal CSS" column of the table [[Wikipedia:Skin#Customisation (advanced users)|here]] to find the right file.

===Three options for usage===
====Option 1 (footnote-style references) — Example:====
<pre>
==Content==
Lorem ipsum.<ref>Source name, access date, etc.</ref>

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

==References==
{{Reflist}}
</pre>

====Option 2 (bibliographical style) — Example:====
<pre>
==Content==
Lorem ipsum.

Lorem ipsum dolor sit amet.

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

====Option 3 (both footnote-style and bibiography-style references) — Example:====
<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>

==Groups extension==
The <nowiki><ref></nowiki> tag now supports named groups so that separate lists may be created— see [[Wikipedia:Footnotes#Separating reference lists and explanatory notes]].

The general format for the reference tag would be:

<pre><ref group=name></pre>

And for the reflist:
<pre>{{Reflist|group=name}}</pre>

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

For example, to create a separate format notes list, the references would be formatted as:

<pre><ref group=note></pre>

To create the formatted list:

<pre>
==Name==
{{Reflist|group=note}}</pre>

While any number of groups can be created and listed, they should be kept to a minimum.

==Caveats==

This template (or <code><nowiki><references/></nowiki></code> by any means, for that matter) should not be used multiple times in the same page with the same value for the <code><nowiki>group</nowiki></code> parameter. But if this is for some reason required, at least one parameter must be passed to every invocation of the template for correct output. For example, use <code><nowiki>{{Reflist|dummy=1}}</nowiki></code> instead of simply <code><nowiki>{{Reflist}}</nowiki></code>.

==See also==
* [[Wikipedia:Citing sources]]; style guide for the citation of sources, and layout options
* [[Wikipedia:Footnotes]]; style guide for footnotes and inline citations
* Template for adding an HTML comment that explains references
** {{tl|Footnotes}}
; Templates for formatting individual reference citations
* [[Wikipedia:Citation templates]]
; Templates for formatting lists of references and bibliographies
* {{tl|Refbegin}} — {{tl|Refend}}; apply any of several optional formatting styles/tweaks to bibliography / reference lists
** {{tl|Colbegin}} Template creates 2 columns.
*{{tl|Reflist-talk}}; reflist for Talk pages.

==References==
{{Reflist}}

<includeonly>

[[Category:Citation templates|{{PAGENAME}}]]


[[ar:قالب:ثبت المراجع]]
[[be-x-old:Шаблён:Зноскі]]
[[ca:Plantilla:Referències]]
[[eo:Ŝablono:Referencoj]]
[[es:Plantilla:Listaref]]
[[fr:Modèle:Références]]
[[hi:Template:टिप्पणीसूची]]
[[hr:Predložak:Izvori]]
[[hsb:Předłoha:Referency]]
[[hu:Reflist]]
[[ia:Patrono:Reflist]]
[[ja:Template:Reflist]]
[[ka:თარგი:სქოლიოს სია]]
[[ko:틀:주석]]
[[lv:Veidne:Reflist]]
[[ml:ഫലകം:Reflist]]
[[ms:Templat:Reflist]]
[[no:Mal:Reflist]]
[[pl:Szablon:Przypisy]]
[[pt:Predefinição:Reflist]]
[[ro:Format:Listănote]]
[[ru:Шаблон:Примечания]]
[[sr:Шаблон:Напомене]]
[[fi:Malline:Viitteet]]
[[th:แม่แบบ:รายการอ้างอิง]]
[[zh:Template:Reflist]]
</includeonly>

The Official Website for Mark Eitzel & American Music Club - User contributions [en]

Template:Reflist/doc