Template:Refbegin/doc: Difference between revisions

From Zoophilia Wiki
Jump to navigationJump to search
meta>RockMFR
→‎See also: rm redlinks
meta>Gadget850
document features added since 1 August 2009
Line 2: Line 2:


== Usage ==
== Usage ==
{{tl|Refbegin}} and {{tl|refend}} are use to format reference lists in a manner similar to {{tl|reflist}}. 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:


I have suggested this template as an option for usage in the second and third of three options for citing notes on a wikipedia article. The original discussion can be found [[Template talk:Reflist/Archive 2007#Instances of ref-small|here]]. Below is a copy of the 3 suggested options...
* <code>.references-small { font-size: 90%;}</code>


'''Option 1 (only specific references) - see [[The Rule]]'''
Editors may over-ride this settings by placing entries in their personal CSS.


If the only references are those defined in {{tag|ref}} tags, then use {{tl|reflist}} alone:
<pre>
<pre>
== References ==
== References ==
{{reflist}}
{{reflist}}
</pre>
</pre>


'''Option 2 (only general references) - see [[National Publications]]'''
If no references use {{tag|ref}} tags, then use {{tl|refbegin}} and {{tl|refend}}:


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


If there are both types of references, then use both methods:
<pre>
== References ==
{{reflist}}
{{refbegin}}
{{refbegin}}
* general reference 1
* general reference 1
Line 24: Line 35:
</pre>
</pre>


'''Option 3 (both specific and general references) - see [[Elephant]]'''
== Columns ==
 
To match {{tl|reflist}}, the number of columns can be given as the first parameterof <nowiki>{{refbegin}}</nowiki>, such as <nowiki>{{refbegin|2}}</nowiki> (defaults to 1).


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


{{reflist}}
Columns may also be set by specifying the width with {{para|colwidth}}:
<pre>
== References ==
{{refbegin|colwidth=20em}}
* general reference 1
* general reference 2
{{refend}}
</pre>


{{refbegin}}
;References
{{refbegin|colwidth=20em}}
* general reference 1
* general reference 1
* general reference 2
* general reference 2
{{refend}}
=== 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.
* [[Mozilla Firefox]] and other [[Gecko (layout engine)|Gecko]]-based browsers support multiple columns, but may create [[Widows and orphans|widows]]
* [[Internet Explorer]] through version 8 does not currently support the column selector
* [[Safari (web browser)|Safari]], [[Google Chrome]] and probably other [[WebKit]] based browsers have a bug that breaks links in multiple columns; WebKit support is removed in {{tl|reflist}} for this reason, but is enabled in {{tl|refbegin}} as such links will usually not be used in bibliographies
* [[Opera (web browser)|Opera]] does not support multiple columns
== Hanging indentation ==
A [[hanging indentation]] may be applied to bibliographies with {{para|indent}}
<pre>
== References ==
{{refbegin|indent=yes}}
Baker, William, and John C. Ross, comps.  ''Harold Pinter: A Bibliographical History''.  London: The [[British Library]] and New Castle, DE: Oak Knoll P, 2005.  ISBN 1584561564 (10).  ISBN 9781584561569 (13).  Print.  "Oak Knoll Press Bestsellers", {{PDFlink|''[http://www.oakknoll.com/resources/pdfcatalogues/Cat2007Spring_web.pdf Spring&nbsp;– Summer 2007 Catalogue]''|9.25&nbsp;MB}}.  Oak Knoll Press, 2007.  [[World Wide Web|Web]].  2 Oct. 2007.  (Page 37 of 40 pages.)
{{refend}}
{{refend}}
</pre>
</pre>


== Arguments ==
;References
{{refbegin|indent=yes}}
Baker, William, and John C. Ross, comps.  ''Harold Pinter: A Bibliographical History''.  London: The [[British Library]] and New Castle, DE: Oak Knoll P, 2005.  ISBN 1584561564 (10).  ISBN 9781584561569 (13).  Print.  "Oak Knoll Press Bestsellers", {{PDFlink|''[http://www.oakknoll.com/resources/pdfcatalogues/Cat2007Spring_web.pdf Spring&nbsp;– Summer 2007 Catalogue]''|9.25&nbsp;MB}}.  Oak Knoll Press, 2007.  [[World Wide Web|Web]].  2 Oct. 2007.  (Page 37 of 40 pages.)
{{refend}}
 
<!---Comment out for now as this does not seem to work
The indent defaults to 3.5 em, and can be specified with  {{para|indentsize}}
<pre>
== References ==
{{refbegin|indent=yes|indentsize=5em}}
Baker, William, and John C. Ross, comps.  ''Harold Pinter: A Bibliographical History''.  London: The [[British Library]] and New Castle, DE: Oak Knoll P, 2005.  ISBN 1584561564 (10).  ISBN 9781584561569 (13).  Print.  "Oak Knoll Press Bestsellers", {{PDFlink|''[http://www.oakknoll.com/resources/pdfcatalogues/Cat2007Spring_web.pdf Spring&nbsp;– Summer 2007 Catalogue]''|9.25&nbsp;MB}}.  Oak Knoll Press, 2007.  [[World Wide Web|Web]].  2 Oct. 2007.  (Page 37 of 40 pages.)
{{refend}}
</pre>


As in {{tl|reflist}}, the number of columns can be given as the first argument of <nowiki>{{refbegin}}</nowiki>, such as <nowiki>{{refbegin|2}}</nowiki> (defaults to 1).
;References
{{refbegin|indent=yes|indentsize=5em}}
Baker, William, and John C. Ross, comps.  ''Harold Pinter: A Bibliographical History''.  London: The [[British Library]] and New Castle, DE: Oak Knoll P, 2005.  ISBN 1584561564 (10).  ISBN 9781584561569 (13).  Print.  "Oak Knoll Press Bestsellers", {{PDFlink|''[http://www.oakknoll.com/resources/pdfcatalogues/Cat2007Spring_web.pdf Spring&nbsp;– Summer 2007 Catalogue]''|9.25&nbsp;MB}}.  Oak Knoll Press, 2007.  [[World Wide Web|Web]].  2 Oct. 2007.  (Page 37 of 40 pages.)
{{refend}}
-->


== See also ==
== See also ==
* {{tl|Refbegin}} &ndash;required closing tag template, if {refend} is used
* {{tl|Colbegin}}
* {{tl|Colbegin}}


Line 50: Line 112:
* [[Wikipedia:Footnotes]]
* [[Wikipedia:Footnotes]]
; Citation formatting and presentation templates
; Citation formatting and presentation templates
* [[WP:CITET]] &ndash;description of various templates to format individual citation references
* [[WP:CITET]]&nbsp;–description of various templates to format individual citation references
;Other reference and citation formatting templates
;Other reference and citation formatting templates
* Auto-generated listing of footnotes and inline citations
* Auto-generated listing of footnotes and inline citations

Revision as of 22:49, 7 September 2009

Usage

{{Refbegin}} and {{refend}} are use to format reference lists in a manner similar to {{reflist}}. 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:

  • .references-small { font-size: 90%;}

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


If the only references are those defined in <ref>...</ref> tags, then use {{reflist}} alone:

== References ==
{{reflist}}

If no references use <ref>...</ref> tags, then use {{refbegin}} and {{refend}}:

== References ==
{{refbegin}}
* general reference 1
* general reference 2
{{refend}}

If there are both types of references, then use both methods:

== References ==
{{reflist}}
{{refbegin}}
* general reference 1
* general reference 2
{{refend}}

Columns

To match {{reflist}}, the number of columns can be given as the first parameterof {{refbegin}}, such as {{refbegin|2}} (defaults to 1).

== References ==
{{refbegin|2}}
* general reference 1
* general reference 2
{{refend}}
References
  • general reference 1
  • general reference 2

Columns may also be set by specifying the width with |colwidth=:

== References ==
{{refbegin|colwidth=20em}}
* general reference 1
* general reference 2
{{refend}}
References
  • general reference 1
  • general reference 2

Browser support

Multiple columns are generated by using CSS3, which is still in development; thus only browsers that properly support the multi-column property will show multiple columns.

  • Mozilla Firefox and other Gecko-based browsers support multiple columns, but may create widows
  • Internet Explorer through version 8 does not currently support the column selector
  • Safari, Google Chrome and probably other WebKit based browsers have a bug that breaks links in multiple columns; WebKit support is removed in {{reflist}} for this reason, but is enabled in {{refbegin}} as such links will usually not be used in bibliographies
  • Opera does not support multiple columns

Hanging indentation

A hanging indentation may be applied to bibliographies with |indent=

== References ==
{{refbegin|indent=yes}}
Baker, William, and John C. Ross, comps.  ''Harold Pinter: A Bibliographical History''.  London: The [[British Library]] and New Castle, DE: Oak Knoll P, 2005.  ISBN 1584561564 (10).  ISBN 9781584561569 (13).  Print.  "Oak Knoll Press Bestsellers", {{PDFlink|''[http://www.oakknoll.com/resources/pdfcatalogues/Cat2007Spring_web.pdf Spring – Summer 2007 Catalogue]''|9.25 MB}}.  Oak Knoll Press, 2007.  [[World Wide Web|Web]].  2 Oct. 2007.  (Page 37 of 40 pages.)
{{refend}}
References

Baker, William, and John C. Ross, comps. Harold Pinter: A Bibliographical History. London: The British Library and New Castle, DE: Oak Knoll P, 2005. ISBN 1584561564 (10). ISBN 9781584561569 (13). Print. "Oak Knoll Press Bestsellers", Template:PDFlink. Oak Knoll Press, 2007. Web. 2 Oct. 2007. (Page 37 of 40 pages.)


See also

Reference and citation guidelines
Citation formatting and presentation templates
  • WP:CITET –description of various templates to format individual citation references
Other reference and citation formatting templates
  • Auto-generated listing of footnotes and inline citations
  • Reference list formatting