Template:Refbegin/doc: Difference between revisions

From Zoophilia Wiki
Jump to navigationJump to search
← Older edit
VisualWikitext
meta>RobSchop
m typo letter-inversion
Ookami (talk | contribs)
1,664 edits
m 145 revisions imported
 
(77 intermediate revisions by 42 users not shown)
Line 1: Line 1:
{{documentation subpage}}
{{documentation subpage}}
{{Ombox |type=notice |text= Columns are not supported by some older browsers, most notably Internet Explorer 9 and below and Opera 11.0 and below. See [[Template:Reflist#Browser support for columns|this page]] for more information.}}
{{Uses TemplateStyles|Template:Refbegin/styles.css}}


{{Notice|1='''If hanging indentations ({{para|indent}}) is used, you may see malformed lists where list items are preceded by an asterisk (*).''' To fix this, replace all instances of the asterisk in your reference list with the indent (''':''') character. }}
'''{{tl|refbegin}}''' and its complementary closing template '''{{tl|refend}}''' are used to apply any of several optional styles or presentational choices for [[bibliography|bibliographies]] or reference lists—that is, lists of fully-specified references, sources, and/or works cited, sorted alphabetically by author or contributor) that appear in Wikipedia articles.


'''{{tl|refbegin}}''' and its complementary closing template '''{{tl|refend}}''' are used to apply any of several optional styles or presentational choices for [[bibliography|bibliographies]] or reference lists—that is, lists of fully-specified references / sources / works cited, alpha-sorted by author/contributor) that appear in wikipedia articles.
These bibliographies or reference lists frequently appear in dedicated sections within an article, variously titled <code>==References==</code>, <code>==Works cited==</code>, <code>==Bibliography==</code>, <code>==Further reading==</code>, <code>==Published works==</code>, and so on.


These bibliographies or reference lists frequently appear in dedicated sections within an article, variously titled <tt>==&nbsp;References&nbsp;==</tt>, <tt>==&nbsp;Works cited&nbsp;==</tt>, <tt>==&nbsp;Bibliography&nbsp;==</tt>, <tt>==&nbsp;Further reading&nbsp;==</tt>, <tt>==&nbsp;Published works&nbsp;==</tt>, and so on.
Wikipedia [[WP:CITE|referencing or citation systems]] that use bibliography-style reference lists include: [[WP:CITESHORT|'shortened' footnotes]], [[WP:PAREN|parenthetical referencing]], and [[WP:GENREF|'general' referencing]]. The [[Wikipedia:Citing sources#Footnote system|'full' footnote]] and [[WP:ECITE|embedded citations]] referencing systems do not use those lists, although articles using these latter two systems may also contain "Further reading" or other sections containing bibliography-style listings, that {{tl|refbegin}} formatting could be applied to.
 
Wikipedia [[WP:CITE|referencing or citation systems]] that use bibliography-style reference lists include: [[WP:CITESHORT|'shortened' footnotes]], [[WP:PAREN|parenthetical referencing]], and [[Wikipedia:Citing_sources#General_reference|'general' referencing]]. The [[Wikipedia:Citing_sources#Footnote_system|'full' footnote]] and [[WP:ECITE|embedded citations]] referencing systems do not use those lists, although articles using these latter two systems may also contain "Further reading" or other sections containing bibliography-style listings, that {{tl|refbegin}} formatting could be applied to.


The formatting options provided by this template are:
The formatting options provided by this template are:
Line 14: Line 14:
!Option!!How to get it||Notes
!Option!!How to get it||Notes
|-
|-
||'''font size reduction'''||<tt><nowiki>{{refbegin}}</nowiki></tt>||no parameters needed, default will reduce to 90% of standard browser text size
|'''default display'''||<code><nowiki>{{refbegin}}</nowiki></code>||no parameters needed, default fontsize is 90% of standard fontsize
|-
|-
||'''display list in multiple columns'''||<tt><nowiki>{{refbegin|n}}</nowiki></tt>||where '''''n''''' determines the number of columns based on the browser's screen width
|'''display list in multiple columns'''||<code><nowiki>{{refbegin|n}}</nowiki></code>||where '''''n''''' determines the number of columns, or width of columns based on the browser's screen width
|-
|-
||'''apply hanging indent'''||<tt><nowiki>{{refbegin|indent=yes}}</nowiki></tt>||will apply hanging indent if an individual reference wraps over more than one line in the browser's display window
|'''apply hanging indent'''||<code><nowiki>{{refbegin|indent=yes}}</nowiki></code>||will apply hanging indent if an individual reference wraps over more than one line in the browser's display window
|-
|-
|}
|}
Each use of {{tl|refbegin}} whether with or without parameters, needs an accompanying {{tl|refend}} closing template to 'turn off' the formatting; refend does not need any parameters.
Each use of {{tl|refbegin}}, with or without parameters, needs an accompanying {{tl|refend}} closing template to 'turn off' the formatting; refend does not need any parameters.
 
Font size reduction is applied by default. Either one, the other, or both of multi-columns and hanging indent may be applied as well (though see specifics and caveats on browser differences in relevant sections, below).


Font size reduction is always applied. Either one, the other, or both of multi-columns and hanging indent may be applied as well (though see specifics and caveats on browser differences in relevant sections, below).
==Usage==
This template is used only for references—it should not be used to create lists of text which are smaller, in columns, or which have other style data associated with them.


== Usage ==
With all (optional) parameters shown:
With all (optional) parameters shown:
<pre>
<pre>
==References==
==References==
{{ refbegin |n |colwidth= |indent= |indentsize= }}  
{{refbegin |n |indent= }}
* list of bibliography/references entries..
*list of bibliography/references entries..
...
...
{{refend}}
{{refend}}
</pre>
</pre>
Line 43: Line 44:
==References==
==References==
{{refbegin}}
{{refbegin}}
*1st entry in the bibliography/references list..  
*1st entry in the bibliography/references list..
*2nd entry in the bibliography/references list..  
*2nd entry in the bibliography/references list..
...
...
*last entry in the bibliography/references list..  
*last entry in the bibliography/references list..
 
{{refend}}
{{refend}}
</pre>
</pre>


The formatting provided by {{tl|refbegin}} is "turned on" at the location where the template is placed, and is applied to ''all'' text after and below it, until it is "turned off" by a closing {{tl|refend}} template (or <tt><nowiki></div></nowiki></tt> tag). Failing to provide a closing {{tl|refend}} may produce unwanted effects in other sections that may appear below the 'References', 'Bibliography' etc section, such as 'External links' sections that are usually placed at or near the article's end.
The formatting provided by {{tl|refbegin}} is "turned on" at the location where the template is placed, and is applied to ''all'' text after and below it, until it is "turned off" by a closing {{tl|refend}} template (or <code><nowiki></div></nowiki></code> tag). Failing to provide a closing {{tl|refend}} may produce unwanted effects in other sections that may appear below the 'References', 'Bibliography' etc. section, such as 'External links' sections that are usually placed at or near the article's end.


===Option 1: Text size (default behaviour)===
===Option 1: Default behaviour===
The default usage (without parameters) applies a style that reduces the text size of the bibliographies/reference list entries. This can be useful to make a long bibliography/list of references display more compactly, and it also mimics the formatting style applied to [[WP:FN|footnotes]] by the {{tl|reflist}} template.  
The default usage (without parameters) applies a style that reduces the text size of the bibliographies/reference list entries. This can be useful to make a long bibliography/list of references display more compactly, and it also mimics the formatting style applied to [[WP:FN|footnotes]] by the {{tl|reflist}} template.


The {{tl|reflist}} formats footnotes—any text in the article body that is placed between {{tag|ref}} tags—that are auto-generated by the [[Wikipedia:Cite.php|cite.php]] extension, called by {{tl|reflist}}. In the case of articles using the [[WP:CITESHORT|'shortened' footnotes]] referencing system, these footnotes will typically contain an abbreviated citation such as <tt><nowiki><ref>Smith 2002, p.123</ref></nowiki></tt> that corresponds with an entry in the bibliography/references list section (other text such as discursive notes may appear as well).  
The {{tl|reflist}} formats footnotes—any text in the article body that is placed between {{tag|ref}} tags—that are auto-generated by the [[Wikipedia:Cite.php|cite.php]] extension, called by {{tl|reflist}}. In the case of articles using the [[WP:CITESHORT|'shortened' footnotes]] referencing system, these footnotes will typically contain an abbreviated citation such as <code><nowiki><ref>Smith 2002, p.123</ref></nowiki></code> that corresponds with an entry in the bibliography/references list section (other text such as discursive notes may appear as well).


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:
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 and Refbegin use each one CSS entry in [[MediaWiki:Common.css]] to set the font size:
 
<pre>
* <code>.references-small { font-size: 90%;}</code>
div.reflist,
div.refbegin {
    font-size: 90%;
}
</pre>


Editors may over-ride this setting by placing entries in their personal CSS.
If the 'full' footnotes referencing system is used (i.e. there is no separate bibliography/references list, all cites/references are defined in {{tag|ref}} tags), then use {{tl|reflist}} alone:
 
If the 'full' footnotes referencing system is used (ie there is no separate bibliography/references list, all cites/references are defined in {{tag|ref}} tags), then use {{tl|reflist}} alone:
<pre>
<pre>
== References ==
==References==
{{reflist}}
{{reflist}}
</pre>
</pre>


If there is a bibliography/references list but no footnoted citations (eg in general references or parenthetical referencing systems) then use {{tl|refbegin}} and {{tl|refend}} like so:
If there is a bibliography/references list but no footnoted citations (e.g. in general references or parenthetical referencing systems) then use {{tl|refbegin}} and {{tl|refend}} like so:


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


If there are footnoted citations and a separate bibliography/references list (ie, the [[WP:CITESHORT]] system), then place {{tl|reflist}} to generate the footnotes in one section (immediately above the bibliography/references list), and use {{tl|refbegin}} in the latter section:
If there are footnoted citations and a separate bibliography/references list (i.e., the [[WP:CITESHORT]] system), then place {{tl|reflist}} to generate the footnotes in one section (immediately above the bibliography/references list), and use {{tl|refbegin}} in the latter section:


<pre>
<pre>
== Notes ==
==Notes==
{{reflist}} <!--this will auto-generate the numbered list of footnotes/cites -->  
{{reflist}} <!--this will auto-generate the numbered list of footnotes/cites -->


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


===Option 2: Multiple columns ===
===Option 2: Multiple columns===
If an integer ''n'' is supplied as the first parameter, the template will display the bibliography/references list in a number of columns dependent of the screen width. This may be useful for compact display for a lengthy list, and matches also the optional capability of {{tl|reflist}} to display output in multiple columns.
If an integer ''n'' is supplied as the first parameter, the template will display the bibliography/references list in n columns. This may be useful for compact display for a lengthy list, and matches also the optional capability of {{tl|reflist}} to display output in multiple columns. Thus, <nowiki>{{refbegin|2}}</nowiki> will display the list in two columns. If no integer parameter is specified, the default is a single column. Note, it will rarely be useful or practical to display bibliography/references list entries in more than two columns.
 
The value of ''n'' determines the width of the columns in the folliowing way:
* ''2'' will produce columns with a minimum width of 30em.
* ''3'' will produce columns with a minimum width of 25em.
* ''4'' will produce columns with a minimum width of 20em.


Thus, <nowiki>{{refbegin|2}}</nowiki> may display the list in two or three columns. If no integer parameter is specified, the default is a single column.
If a value with a unit is supplied as the first parameter, i.e. <code>30em</code>, the template will display the bibliography/references list in columns with a minimum width of that value, allowing the browser to determine the optimal number of columns. Using <nowiki>{{refbegin|30em}}</nowiki> for instance is useful for short citations.


'''Note''': You can force a number of fixed columns by using the {{para|colcount}} parameter. However, it will rarely be useful or practical to display bibliography/references list entries in more than two columns.
{{pre2|<nowiki>
 
==References==
<pre>
== References ==
{{refbegin|2}}
{{refbegin|2}}
* {{cite journal |author=Southworth, Jane |coauthors=and Catherine Tucker |year=2001 |month=August |title=The Influence of Accessibility, Local Institutions, and Socioeconomic Factors on Forest Cover Change in the Mountains of Western Honduras |url=http://www.bioone.org/doi/pdf/10.1659/0276-4741(2001)021%5B0276:TIOALI%5D2.0.CO%3B2 |format=PDF reproduction, BioOne online |journal=Mountain Research and Development |location=Boulder, CO |publisher=International Mountain Society and United Nations University |volume=21 |issue=3 |ppages=276–283 |doi=10.1659/0276-4741(2001)021[0276:TIOALI]2.0.CO;2
*{{cite journal |author= Southworth, Jane |author2= Catherine Tucker |date= August 2001 |title= The Influence of Accessibility, Local Institutions, and Socioeconomic Factors on Forest Cover Change in the Mountains of Western Honduras |url= http://www.bioone.org/doi/pdf/10.1659/0276-4741(2001)021%5B0276:TIOALI%5D2.0.CO%3B2 |format= PDF reproduction, BioOne online |journal= Mountain Research and Development |location= Boulder, CO |publisher= International Mountain Society and United Nations University |volume= 21 |issue= 3 |pages= 276–283 |doi= 10.1659/0276-4741(2001)021[0276:TIOALI]2.0.CO;2
  |issn=0276-4741 |oclc=107067006}}
  |issn= 0276-4741 |oclc= 107067006}}
* {{cite journal |author=Tucker, Catherine M. |coauthors=Darla K. Munroe, Harini Nagendra, and Jane Southworth |year=2005 |month=June|title=Comparative Spatial Analyses of Forest Conservation and Change in Honduras and Guatemala |url=http://www.clas.ufl.edu/lueci/southworth/pubs-as-pdf/cs-3-1_10_jtuckeretal.pdf |format=PDF online open access article distributed under Creative Commons |journal=Conservation and Society |location=New Delhi and London |publisher=SAGE Publications |volume=3 |issue=1 |pages=174–200 |issn=0972-4923|oclc=210806013}}
*{{cite journal |author= Tucker, Catherine M. |author2= Darla K. Munroe |author3=Harini Nagendra |author4=Jane Southworth |date= June 2005 |title= Comparative Spatial Analyses of Forest Conservation and Change in Honduras and Guatemala |url= http://www.clas.ufl.edu/lueci/southworth/pubs-as-pdf/cs-3-1_10_jtuckeretal.pdf |format= PDF online open access article distributed under Creative Commons |journal= Conservation and Society |location= New Delhi and London |publisher= SAGE Publications |volume= 3 |issue= 1 |pages= 174–200 |issn= 0972-4923|oclc= 210806013}}
{{refend}}
{{refend}}</nowiki>}}
</pre>


;References
'''References'''
{{refbegin|2}}
{{refbegin|2}}
* {{cite journal |author=Southworth, Jane |coauthors=and Catherine Tucker |year=2001 |month=August |title=The Influence of Accessibility, Local Institutions, and Socioeconomic Factors on Forest Cover Change in the Mountains of Western Honduras |url=http://www.bioone.org/doi/pdf/10.1659/0276-4741(2001)021%5B0276:TIOALI%5D2.0.CO%3B2 |format=PDF reproduction, BioOne online |journal=Mountain Research and Development |location=Boulder, CO |publisher=International Mountain Society and United Nations University |volume=21 |issue=3 |ppages=276–283 |doi=10.1659/0276-4741(2001)021[0276:TIOALI]2.0.CO;2
*{{cite journal |author= Southworth, Jane |author2= Catherine Tucker |date = August 2001 |title= The Influence of Accessibility, Local Institutions, and Socioeconomic Factors on Forest Cover Change in the Mountains of Western Honduras |url= http://www.bioone.org/doi/pdf/10.1659/0276-4741(2001)021%5B0276:TIOALI%5D2.0.CO%3B2 |format= PDF reproduction, BioOne online |journal= Mountain Research and Development |location= Boulder, CO |publisher= International Mountain Society and United Nations University |volume= 21 |issue= 3 |pages= 276–283 |doi= 10.1659/0276-4741(2001)021[0276:TIOALI]2.0.CO;2
  |issn=0276-4741 |oclc=107067006}}
  |issn= 0276-4741 |oclc= 107067006}}
* {{cite journal |author=Tucker, Catherine M. |coauthors=Darla K. Munroe, Harini Nagendra, and Jane Southworth |year=2005 |month=June|title=Comparative Spatial Analyses of Forest Conservation and Change in Honduras and Guatemala |url=http://www.clas.ufl.edu/lueci/southworth/pubs-as-pdf/cs-3-1_10_jtuckeretal.pdf |format=PDF online open access article distributed under Creative Commons |journal=Conservation and Society |location=New Delhi and London |publisher=SAGE Publications |volume=3 |issue=1 |pages=174–200 |issn=0972-4923|oclc=210806013}}
*{{cite journal |author= Tucker, Catherine M. |author2= Darla K. Munroe |author3=Harini Nagendra |author4=Jane Southworth |date= June 2005 |title= Comparative Spatial Analyses of Forest Conservation and Change in Honduras and Guatemala |url= http://www.clas.ufl.edu/lueci/southworth/pubs-as-pdf/cs-3-1_10_jtuckeretal.pdf |format= PDF online open access article distributed under Creative Commons |journal= Conservation and Society |location= New Delhi and London |publisher= SAGE Publications |volume= 3 |issue= 1 |pages= 174–200 |issn= 0972-4923|oclc= 210806013}}
{{refend}}
{{refend}}


Columns may also be set by specifying the width with {{para|colwidth}}:
{{pre2|<nowiki>
<pre>
==References==
== References ==
{{refbegin|30em}}
{{refbegin|colwidth=20em}}
*{{cite journal |author= Southworth, Jane |author2= Catherine Tucker |date= August 2001|title= The Influence of Accessibility, Local Institutions, and Socioeconomic Factors on Forest Cover Change in the Mountains of Western Honduras |url= http://www.bioone.org/doi/pdf/10.1659/0276-4741(2001)021%5B0276:TIOALI%5D2.0.CO%3B2 |format= PDF reproduction, BioOne online |journal= Mountain Research and Development |location= Boulder, CO |publisher= International Mountain Society and United Nations University |volume= 21 |issue= 3 |pages= 276–283 |doi= 10.1659/0276-4741(2001)021[0276:TIOALI]2.0.CO;2
* {{cite journal |author=Southworth, Jane |coauthors=and Catherine Tucker |year=2001 |month=August |title=The Influence of Accessibility, Local Institutions, and Socioeconomic Factors on Forest Cover Change in the Mountains of Western Honduras |url=http://www.bioone.org/doi/pdf/10.1659/0276-4741(2001)021%5B0276:TIOALI%5D2.0.CO%3B2 |format=PDF reproduction, BioOne online |journal=Mountain Research and Development |location=Boulder, CO |publisher=International Mountain Society and United Nations University |volume=21 |issue=3 |ppages=276–283 |doi=10.1659/0276-4741(2001)021[0276:TIOALI]2.0.CO;2
  |issn= 0276-4741 |oclc= 107067006}}
  |issn=0276-4741 |oclc=107067006}}
*{{cite journal |author= Tucker, Catherine M. |author2= Darla K. Munroe |author3=Harini Nagendra |author4=Jane Southworth |date= June 2005 |title= Comparative Spatial Analyses of Forest Conservation and Change in Honduras and Guatemala |url= http://www.clas.ufl.edu/lueci/southworth/pubs-as-pdf/cs-3-1_10_jtuckeretal.pdf |format= PDF online open access article distributed under Creative Commons |journal= Conservation and Society |location= New Delhi and London |publisher= SAGE Publications |volume= 3 |issue= 1 |pages= 174–200 |issn= 0972-4923|oclc= 210806013}}
* {{cite journal |author=Tucker, Catherine M. |coauthors=Darla K. Munroe, Harini Nagendra, and Jane Southworth |year=2005 |month=June|title=Comparative Spatial Analyses of Forest Conservation and Change in Honduras and Guatemala |url=http://www.clas.ufl.edu/lueci/southworth/pubs-as-pdf/cs-3-1_10_jtuckeretal.pdf |format=PDF online open access article distributed under Creative Commons |journal=Conservation and Society |location=New Delhi and London |publisher=SAGE Publications |volume=3 |issue=1 |pages=174–200 |issn=0972-4923|oclc=210806013}}
{{refend}}</nowiki>}}
{{refend}}
</pre>


;References
'''References'''
{{refbegin|colwidth=20em}}
{{refbegin|30em}}
* {{cite journal |author=Southworth, Jane |coauthors=and Catherine Tucker |year=2001 |month=August |title=The Influence of Accessibility, Local Institutions, and Socioeconomic Factors on Forest Cover Change in the Mountains of Western Honduras |url=http://www.bioone.org/doi/pdf/10.1659/0276-4741(2001)021%5B0276:TIOALI%5D2.0.CO%3B2 |format=PDF reproduction, BioOne online |journal=Mountain Research and Development |location=Boulder, CO |publisher=International Mountain Society and United Nations University |volume=21 |issue=3 |ppages=276–283 |doi=10.1659/0276-4741(2001)021[0276:TIOALI]2.0.CO;2
*{{cite journal |author= Southworth, Jane |author2= Catherine Tucker |date= August 2001 |title= The Influence of Accessibility, Local Institutions, and Socioeconomic Factors on Forest Cover Change in the Mountains of Western Honduras |url= http://www.bioone.org/doi/pdf/10.1659/0276-4741(2001)021%5B0276:TIOALI%5D2.0.CO%3B2 |format= PDF reproduction, BioOne online |journal= Mountain Research and Development |location= Boulder, CO |publisher= International Mountain Society and United Nations University |volume= 21 |issue= 3 |pages= 276–283 |doi= 10.1659/0276-4741(2001)021[0276:TIOALI]2.0.CO;2
  |issn=0276-4741 |oclc=107067006}}
  |issn= 0276-4741 |oclc= 107067006}}
* {{cite journal |author=Tucker, Catherine M. |coauthors=Darla K. Munroe, Harini Nagendra, and Jane Southworth |year=2005 |month=June|title=Comparative Spatial Analyses of Forest Conservation and Change in Honduras and Guatemala |url=http://www.clas.ufl.edu/lueci/southworth/pubs-as-pdf/cs-3-1_10_jtuckeretal.pdf |format=PDF online open access article distributed under Creative Commons |journal=Conservation and Society |location=New Delhi and London |publisher=SAGE Publications |volume=3 |issue=1 |pages=174–200 |issn=0972-4923|oclc=210806013}}
*{{cite journal |author= Tucker, Catherine M. |author2= Darla K. Munroe |author3=Harini Nagendra |author4=Jane Southworth |date= June 2005 |title= Comparative Spatial Analyses of Forest Conservation and Change in Honduras and Guatemala |url= http://www.clas.ufl.edu/lueci/southworth/pubs-as-pdf/cs-3-1_10_jtuckeretal.pdf |format= PDF online open access article distributed under Creative Commons |journal= Conservation and Society |location= New Delhi and London |publisher= SAGE Publications |volume= 3 |issue= 1 |pages= 174–200 |issn= 0972-4923|oclc= 210806013}}
{{refend}}
{{refend}}


==== Browser support ====
===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.
{{CSS3 multiple column layout}}
* [[Mozilla Firefox]] and other [[Gecko (layout engine)|Gecko]]-based browsers and [[Safari (web browser)|Safari]], [[Google Chrome]] and other [[WebKit]] support multiple columns, but may create [[Widows and orphans|widows]]
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. See [[Template:Reflist#Browser support for columns|here]] for more information.
* [[Internet Explorer]] through version 9 beta does not support columns
* [[Opera (web browser)|Opera]] through version 10.63 does not support columns


=== Option 3: Hanging indentation ===
===Option 3: Hanging indentation===
A [[hanging indentation]] may be applied to bibliographies/reference lists by using the {{para|indent}} parameter. This option can be useful in long bibliographies/reference lists and in particular when individual entries in the list are long, ie they wrap over more than one line in the browser display window. Applying a hanging indent to the list makes it much easier to distinguish the keywords (ie normally the authors' names) in the bibliography and makes the stand out from preceding and succeeding lines of text. Hanging indents in bibliographies also form part of several widely used citation style implementations, such as APA, MLA, and Chicago.
A [[hanging indentation]] may be applied to bibliographies/reference lists by using the {{para|indent}} parameter. This option can be useful in long bibliographies/reference lists and in particular when individual entries in the list are long, i.e. they wrap over more than one line in the browser display window. Applying a hanging indent to the list makes it much easier to distinguish the keywords (i.e. normally the authors' names) in the bibliography and makes them stand out from preceding and succeeding lines of text. Hanging indents in bibliographies also form part of several widely used citation style implementations, such as APA, MLA, and Chicago.


In order for indents to display properly, do not use bullet markers ('''*'''); you must use indent markers (''':''') instead.
To use, set <code><nowiki>{{refbegin|indent=yes}}</nowiki></code>.


To use, set <tt><nowiki>{{refbegin|indent=yes}}</nowiki></tt>.
'''Examples'''
 
;Examples


'''''a)''' Using {{tl|refbegin}} with the hanging indent option ''|indent=yes'' applied:''
'''''a)''' Using {{tl|refbegin}} with the hanging indent option ''|indent=yes'' applied:''


<pre>
<pre style="overflow:auto;">
==References==
==References==
{{refbegin|indent=yes}}
{{refbegin|indent=yes}}
: {{cite book |author=Dakin, Karen|year=1994|chapter=El náhuatl en el yutoazteca sureño: algunas isoglosas gramaticales y fonológicas|title=Investigaciones lingüísticas en Mesoamérica |series=Estudios sobre Lenguas Americanas, no. 1|editor=Carolyn MacKay and Verónica Vázquez (eds.)|publisher=Universidad Nacional Autónoma de México, Instituto de Investigaciones Filológicas, Seminario de Lenguas Indígenas|location=México D.F.|pages=3–86 |isbn=968-36-4055-9 |oclc=34716589}} {{es icon}}
* {{cite book |author= Dakin, Karen|year= 1994|chapter= El náhuatl en el yutoazteca sureño: algunas isoglosas gramaticales y fonológicas|title= Investigaciones lingüísticas en Mesoamérica |series= Estudios sobre Lenguas Americanas, no. 1|editor1=Carolyn MacKay |editor2=Verónica Vázquez |publisher= Universidad Nacional Autónoma de México, Instituto de Investigaciones Filológicas, Seminario de Lenguas Indígenas|location= México D.F.|pages= 3–86 |isbn= 968-36-4055-9 |oclc= 34716589 |language=es}}
: {{cite conference |author=Flores Farfán, José Antonio |year=2002|title=The Use of Multimedia and the Arts in Language Revitalization, Maintenance, and Development: The Case of the Balsas Nahuas of Guerrero, Mexico |url=http://jan.ucc.nau.edu/~jar/ILAC/ILAC_24.pdf |format=[[Portable Document Format|PDF]] |conference=Proceedings of the Annual Conference on Stabilizing Indigenous Languages (7th, Toronto, Ontario, Canada, May 11–14, 2000) |booktitle=Indigenous Languages across the Community |editor=Barbara Jane Burnaby and John Allan Reyhner (eds.) |location=Flagstaff, AZ |publisher=Center for Excellence in Education, Northern Arizona University |pages=225–236 |isbn=0-9670554-2-3 |oclc=95062129}}
* {{cite conference |author1=Flores Farfán |author2=José Antonio |year= 2002|title= The Use of Multimedia and the Arts in Language Revitalization, Maintenance, and Development: The Case of the Balsas Nahuas of Guerrero, Mexico |url= http://jan.ucc.nau.edu/~jar/ILAC/ILAC_24.pdf |format= [[Portable Document Format|PDF]] |conference= Proceedings of the Annual Conference on Stabilizing Indigenous Languages (7th, Toronto, Ontario, Canada, May 11–14, 2000) |booktitle= Indigenous Languages across the Community |editor1=Barbara Jane Burnaby |editor2=John Allan Reyhner |location= Flagstaff, AZ |publisher= Center for Excellence in Education, Northern Arizona University |pages= 225–236 |isbn= 0-9670554-2-3 |oclc= 95062129}}
: {{cite book |author=Rincón, Antonio del |year=1885 |origyear=1595 |title=Arte mexicana compuesta por el padre Antonio Del Rincón de la compañia de Jesus: Dirigido al illustrissimo y reverendissimo s. Don Diego Romano obispo de Tlaxcallan, y del consejo de su magestad, &c. En Mexico en casa de Pedro, Balli. 1595 |url=http://storage.lib.uchicago.edu/pres/2005/pres2005-033.pdf |edition=Reprinted 1885 under the care of Dr. Antonio Peñafiel |format=[[Portable Document Format|PDF]] facsimile, University of Chicago Library digital collections|location=México D.F. |publisher=Oficina tip. de la Secretaría de fomento |oclc=162761360 }} {{es icon}}
* {{cite book |author= Rincón, Antonio del |year= 1885 |origyear= 1595 |title= Arte mexicana compuesta por el padre Antonio Del Rincón de la compañia de Jesus: Dirigido al illustrissimo y reverendissimo s. Don Diego Romano obispo de Tlaxcallan, y del consejo de su magestad, &c. En Mexico en casa de Pedro, Balli. 1595 |url= http://storage.lib.uchicago.edu/pres/2005/pres2005-033.pdf |edition= Reprinted 1885 under the care of Dr. Antonio Peñafiel |format= [[Portable Document Format|PDF]] facsimile, University of Chicago Library digital collections|location= México D.F. |publisher= Oficina tip. de la Secretaría de fomento |oclc= 162761360 |language=es}}
: {{cite book |author=Voegelin, Charles F.|coauthors=Florence M. Voegelin and Kenneth L. Hale |year=1962 |title=Typological and Comparative Grammar of Uto-Aztecan I: Phonology |format=Supplement to International Journal of American linguistics, vol. 28, no. 1 |series=Indiana University publications in anthropology and linguistics, Memoir 17 |location=Baltimore MD |publisher=Waverly Press |oclc=55576894}}
* {{cite book |author= Voegelin, Charles F.|author2= Florence M. Voegelin |author3=Kenneth L. Hale |year= 1962 |title= Typological and Comparative Grammar of Uto-Aztecan I: Phonology |type= Supplement to International Journal of American linguistics, vol. 28, no. 1 |series= Indiana University publications in anthropology and linguistics, Memoir 17 |location= Baltimore MD |publisher= Waverly Press |oclc= 55576894}}
{{refend}}
{{refend}}
</pre>
</pre>


;References
'''References'''
{{refbegin|indent=yes}}
{{refbegin|indent=yes}}
: {{cite book |author=Dakin, Karen|year=1994|chapter=El náhuatl en el yutoazteca sureño: algunas isoglosas gramaticales y fonológicas|title=Investigaciones lingüísticas en Mesoamérica |series=Estudios sobre Lenguas Americanas, no. 1|editor=Carolyn MacKay and Verónica Vázquez (eds.)|publisher=Universidad Nacional Autónoma de México, Instituto de Investigaciones Filológicas, Seminario de Lenguas Indígenas|location=México D.F.|pages=3–86 |isbn=968-36-4055-9 |oclc=34716589}} {{es icon}}
* {{cite book |author= Dakin, Karen|year= 1994|chapter= El náhuatl en el yutoazteca sureño: algunas isoglosas gramaticales y fonológicas|title= Investigaciones lingüísticas en Mesoamérica |series= Estudios sobre Lenguas Americanas, no. 1|editor1=Carolyn MacKay |editor2=Verónica Vázquez |publisher= Universidad Nacional Autónoma de México, Instituto de Investigaciones Filológicas, Seminario de Lenguas Indígenas|location= México D.F.|pages= 3–86 |isbn= 968-36-4055-9 |oclc= 34716589 |language=es}}
: {{cite conference |author=Flores Farfán, José Antonio |year=2002|title=The Use of Multimedia and the Arts in Language Revitalization, Maintenance, and Development: The Case of the Balsas Nahuas of Guerrero, Mexico |url=http://jan.ucc.nau.edu/~jar/ILAC/ILAC_24.pdf |format=[[Portable Document Format|PDF]] |conference=Proceedings of the Annual Conference on Stabilizing Indigenous Languages (7th, Toronto, Ontario, Canada, May 11–14, 2000) |booktitle=Indigenous Languages across the Community |editor=Barbara Jane Burnaby and John Allan Reyhner (eds.) |location=Flagstaff, AZ |publisher=Center for Excellence in Education, Northern Arizona University |pages=225–236 |isbn=0-9670554-2-3 |oclc=95062129}}
* {{cite conference |author1=Flores Farfán |author2=José Antonio |year= 2002|title= The Use of Multimedia and the Arts in Language Revitalization, Maintenance, and Development: The Case of the Balsas Nahuas of Guerrero, Mexico |url= http://jan.ucc.nau.edu/~jar/ILAC/ILAC_24.pdf |format= [[Portable Document Format|PDF]] |conference= Proceedings of the Annual Conference on Stabilizing Indigenous Languages (7th, Toronto, Ontario, Canada, May 11–14, 2000) |booktitle= Indigenous Languages across the Community |editor1=Barbara Jane Burnaby |editor2=John Allan Reyhner |location= Flagstaff, AZ |publisher= Center for Excellence in Education, Northern Arizona University |pages= 225–236 |isbn= 0-9670554-2-3 |oclc= 95062129}}
: {{cite book |author=Rincón, Antonio del |year=1885 |origyear=1595 |title=Arte mexicana compuesta por el padre Antonio Del Rincón de la compañia de Jesus: Dirigido al illustrissimo y reverendissimo s. Don Diego Romano obispo de Tlaxcallan, y del consejo de su magestad, &c. En Mexico en casa de Pedro, Balli. 1595 |url=http://storage.lib.uchicago.edu/pres/2005/pres2005-033.pdf |edition=Reprinted 1885 under the care of Dr. Antonio Peñafiel |format=[[Portable Document Format|PDF]] facsimile, University of Chicago Library digital collections|location=México D.F. |publisher=Oficina tip. de la Secretaría de fomento |oclc=162761360 }} {{es icon}}
* {{cite book |author= Rincón, Antonio del |year= 1885 |origyear= 1595 |title= Arte mexicana compuesta por el padre Antonio Del Rincón de la compañia de Jesus: Dirigido al illustrissimo y reverendissimo s. Don Diego Romano obispo de Tlaxcallan, y del consejo de su magestad, &c. En Mexico en casa de Pedro, Balli. 1595 |url= http://storage.lib.uchicago.edu/pres/2005/pres2005-033.pdf |edition= Reprinted 1885 under the care of Dr. Antonio Peñafiel |format= [[Portable Document Format|PDF]] facsimile, University of Chicago Library digital collections|location= México D.F. |publisher= Oficina tip. de la Secretaría de fomento |oclc= 162761360 |language=es}}
: {{cite book |author=Voegelin, Charles F.|coauthors=Florence M. Voegelin and Kenneth L. Hale |year=1962 |title=Typological and Comparative Grammar of Uto-Aztecan I: Phonology |format=Supplement to International Journal of American linguistics, vol. 28, no. 1 |series=Indiana University publications in anthropology and linguistics, Memoir 17 |location=Baltimore MD |publisher=Waverly Press |oclc=55576894}}
* {{cite book |author= Voegelin, Charles F.|author2= Florence M. Voegelin |author3=Kenneth L. Hale |year= 1962 |title= Typological and Comparative Grammar of Uto-Aztecan I: Phonology |type= Supplement to International Journal of American linguistics, vol. 28, no. 1 |series= Indiana University publications in anthropology and linguistics, Memoir 17 |location= Baltimore MD |publisher= Waverly Press |oclc= 55576894}}
{{refend}}
{{refend}}


'''''b)''' Using indent in combination with multi-column (in this case, n=2) display <nowiki>{{refbegin|2|indent=yes}}</nowiki> (note that mutlicolumn only works in some browsers):''
'''''b)''' Using indent in combination with multi-column (in this case, n = 2) display <nowiki>{{refbegin|2|indent=yes}}</nowiki> (note that multi-column only works in some browsers):''


<pre>
<pre style="overflow:auto;">
==References==
==References==
{{refbegin|2|indent=yes}}
{{refbegin|2|indent=yes}}
: {{cite book |author=Dakin, Karen|year=1994|chapter=El náhuatl en el yutoazteca sureño: algunas isoglosas gramaticales y fonológicas|title=Investigaciones lingüísticas en Mesoamérica |series=Estudios sobre Lenguas Americanas, no. 1|editor=Carolyn MacKay and Verónica Vázquez (eds.)|publisher=Universidad Nacional Autónoma de México, Instituto de Investigaciones Filológicas, Seminario de Lenguas Indígenas|location=México D.F.|pages=3–86 |isbn=968-36-4055-9 |oclc=34716589}} {{es icon}}
* {{cite book |author= Dakin, Karen|year= 1994|chapter= El náhuatl en el yutoazteca sureño: algunas isoglosas gramaticales y fonológicas|title= Investigaciones lingüísticas en Mesoamérica |series= Estudios sobre Lenguas Americanas, no. 1|editor1=Carolyn MacKay |editor2=Verónica Vázquez |publisher= Universidad Nacional Autónoma de México, Instituto de Investigaciones Filológicas, Seminario de Lenguas Indígenas|location= México D.F.|pages= 3–86 |isbn= 968-36-4055-9 |oclc= 34716589 |language=es}}
: {{cite conference |author=Flores Farfán, José Antonio |year=2002|title=The Use of Multimedia and the Arts in Language Revitalization, Maintenance, and Development: The Case of the Balsas Nahuas of Guerrero, Mexico |url=http://jan.ucc.nau.edu/~jar/ILAC/ILAC_24.pdf |format=[[Portable Document Format|PDF]] |conference=Proceedings of the Annual Conference on Stabilizing Indigenous Languages (7th, Toronto, Ontario, Canada, May 11–14, 2000) |booktitle=Indigenous Languages across the Community |editor=Barbara Jane Burnaby and John Allan Reyhner (eds.) |location=Flagstaff, AZ |publisher=Center for Excellence in Education, Northern Arizona University |pages=225–236 |isbn=0-9670554-2-3 |oclc=95062129}}
* {{cite conference |author1=Flores Farfán |author2=José Antonio |year= 2002|title= The Use of Multimedia and the Arts in Language Revitalization, Maintenance, and Development: The Case of the Balsas Nahuas of Guerrero, Mexico |url= http://jan.ucc.nau.edu/~jar/ILAC/ILAC_24.pdf |format= [[Portable Document Format|PDF]] |conference= Proceedings of the Annual Conference on Stabilizing Indigenous Languages (7th, Toronto, Ontario, Canada, May 11–14, 2000) |booktitle= Indigenous Languages across the Community |editor1=Barbara Jane Burnaby |editor2=John Allan Reyhner |location= Flagstaff, AZ |publisher= Center for Excellence in Education, Northern Arizona University |pages= 225–236 |isbn= 0-9670554-2-3 |oclc= 95062129}}
: {{cite book |author=Rincón, Antonio del |year=1885 |origyear=1595 |title=Arte mexicana compuesta por el padre Antonio Del Rincón de la compañia de Jesus: Dirigido al illustrissimo y reverendissimo s. Don Diego Romano obispo de Tlaxcallan, y del consejo de su magestad, &c. En Mexico en casa de Pedro, Balli. 1595 |url=http://storage.lib.uchicago.edu/pres/2005/pres2005-033.pdf |edition=Reprinted 1885 under the care of Dr. Antonio Peñafiel |format=[[Portable Document Format|PDF]] facsimile, University of Chicago Library digital collections|location=México D.F. |publisher=Oficina tip. de la Secretaría de fomento |oclc=162761360 }} {{es icon}}
* {{cite book |author= Rincón, Antonio del |year= 1885 |origyear= 1595 |title= Arte mexicana compuesta por el padre Antonio Del Rincón de la compañia de Jesus: Dirigido al illustrissimo y reverendissimo s. Don Diego Romano obispo de Tlaxcallan, y del consejo de su magestad, &c. En Mexico en casa de Pedro, Balli. 1595 |url= http://storage.lib.uchicago.edu/pres/2005/pres2005-033.pdf |edition= Reprinted 1885 under the care of Dr. Antonio Peñafiel |format= [[Portable Document Format|PDF]] facsimile, University of Chicago Library digital collections|location= México D.F. |publisher= Oficina tip. de la Secretaría de fomento |oclc= 162761360 |language=es}}
: {{cite book |author=Voegelin, Charles F.|coauthors=Florence M. Voegelin and Kenneth L. Hale |year=1962 |title=Typological and Comparative Grammar of Uto-Aztecan I: Phonology |format=Supplement to International Journal of American linguistics, vol. 28, no. 1 |series=Indiana University publications in anthropology and linguistics, Memoir 17 |location=Baltimore MD |publisher=Waverly Press |oclc=55576894}}
* {{cite book |author= Voegelin, Charles F.|author2= Florence M. Voegelin |author3=Kenneth L. Hale |year= 1962 |title= Typological and Comparative Grammar of Uto-Aztecan I: Phonology |format= Supplement to International Journal of American linguistics, vol. 28, no. 1 |series= Indiana University publications in anthropology and linguistics, Memoir 17 |location= Baltimore MD |publisher= Waverly Press |oclc= 55576894}}
{{refend}}
{{refend}}
</pre>
</pre>


;References
'''References'''
{{refbegin|2|indent=yes}}
{{refbegin|2|indent=yes}}
: {{cite book |author=Dakin, Karen|year=1994|chapter=El náhuatl en el yutoazteca sureño: algunas isoglosas gramaticales y fonológicas|title=Investigaciones lingüísticas en Mesoamérica |series=Estudios sobre Lenguas Americanas, no. 1|editor=Carolyn MacKay and Verónica Vázquez (eds.)|publisher=Universidad Nacional Autónoma de México, Instituto de Investigaciones Filológicas, Seminario de Lenguas Indígenas|location=México D.F.|pages=3–86 |isbn=968-36-4055-9 |oclc=34716589}} {{es icon}}
* {{cite book |author= Dakin, Karen|year= 1994|chapter= El náhuatl en el yutoazteca sureño: algunas isoglosas gramaticales y fonológicas|title= Investigaciones lingüísticas en Mesoamérica |series= Estudios sobre Lenguas Americanas, no. 1|editor1=Carolyn MacKay |editor2=Verónica Vázquez |publisher= Universidad Nacional Autónoma de México, Instituto de Investigaciones Filológicas, Seminario de Lenguas Indígenas|location= México D.F.|pages= 3–86 |isbn= 968-36-4055-9 |oclc= 34716589 |language=es}}
: {{cite conference |author=Flores Farfán, José Antonio |year=2002|title=The Use of Multimedia and the Arts in Language Revitalization, Maintenance, and Development: The Case of the Balsas Nahuas of Guerrero, Mexico |url=http://jan.ucc.nau.edu/~jar/ILAC/ILAC_24.pdf |format=[[Portable Document Format|PDF]] |conference=Proceedings of the Annual Conference on Stabilizing Indigenous Languages (7th, Toronto, Ontario, Canada, May 11–14, 2000) |booktitle=Indigenous Languages across the Community |editor=Barbara Jane Burnaby and John Allan Reyhner (eds.) |location=Flagstaff, AZ |publisher=Center for Excellence in Education, Northern Arizona University |pages=225–236 |isbn=0-9670554-2-3 |oclc=95062129}}
* {{cite conference |author1=Flores Farfán |author2=José Antonio |year= 2002|title= The Use of Multimedia and the Arts in Language Revitalization, Maintenance, and Development: The Case of the Balsas Nahuas of Guerrero, Mexico |url= http://jan.ucc.nau.edu/~jar/ILAC/ILAC_24.pdf |format= [[Portable Document Format|PDF]] |conference= Proceedings of the Annual Conference on Stabilizing Indigenous Languages (7th, Toronto, Ontario, Canada, May 11–14, 2000) |booktitle= Indigenous Languages across the Community |editor1=Barbara Jane Burnaby |editor2=John Allan Reyhner |location= Flagstaff, AZ |publisher= Center for Excellence in Education, Northern Arizona University |pages= 225–236 |isbn= 0-9670554-2-3 |oclc= 95062129}}
: {{cite book |author=Rincón, Antonio del |year=1885 |origyear=1595 |title=Arte mexicana compuesta por el padre Antonio Del Rincón de la compañia de Jesus: Dirigido al illustrissimo y reverendissimo s. Don Diego Romano obispo de Tlaxcallan, y del consejo de su magestad, &c. En Mexico en casa de Pedro, Balli. 1595 |url=http://storage.lib.uchicago.edu/pres/2005/pres2005-033.pdf |edition=Reprinted 1885 under the care of Dr. Antonio Peñafiel |format=[[Portable Document Format|PDF]] facsimile, University of Chicago Library digital collections|location=México D.F. |publisher=Oficina tip. de la Secretaría de fomento |oclc=162761360 }} {{es icon}}
* {{cite book |author= Rincón, Antonio del |year= 1885 |origyear= 1595 |title= Arte mexicana compuesta por el padre Antonio Del Rincón de la compañia de Jesus: Dirigido al illustrissimo y reverendissimo s. Don Diego Romano obispo de Tlaxcallan, y del consejo de su magestad, &c. En Mexico en casa de Pedro, Balli. 1595 |url= http://storage.lib.uchicago.edu/pres/2005/pres2005-033.pdf |edition= Reprinted 1885 under the care of Dr. Antonio Peñafiel |format= [[Portable Document Format|PDF]] facsimile, University of Chicago Library digital collections|location= México D.F. |publisher= Oficina tip. de la Secretaría de fomento |oclc= 162761360 |language=es}}
: {{cite book |author=Voegelin, Charles F.|coauthors=Florence M. Voegelin and Kenneth L. Hale |year=1962 |title=Typological and Comparative Grammar of Uto-Aztecan I: Phonology |format=Supplement to International Journal of American linguistics, vol. 28, no. 1 |series=Indiana University publications in anthropology and linguistics, Memoir 17 |location=Baltimore MD |publisher=Waverly Press |oclc=55576894}}
* {{cite book |author= Voegelin, Charles F.|author2= Florence M. Voegelin |author3=Kenneth L. Hale |year= 1962 |title= Typological and Comparative Grammar of Uto-Aztecan I: Phonology |type= Supplement to International Journal of American linguistics, vol. 28, no. 1 |series= Indiana University publications in anthropology and linguistics, Memoir 17 |location= Baltimore MD |publisher= Waverly Press |oclc= 55576894}}
{{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>
 
;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}}
{{refend}}
-->


== See also ==
==Template data==
;Reference and citation guidelines
{{Refbegin/TemplateData}}
* [[Wikipedia:Citing sources]]
* [[Wikipedia:Footnotes]]
; Citation formatting and presentation templates
* [[WP:CITET]] - Description of various templates to format individual citation references
;Other reference and citation formatting templates
* {{tl|reflist}} - Auto-generated listing of footnotes and inline citations


<includeonly>
==See also==
[[Category:Citation templates|{{PAGENAME}}]]
*[[Wikipedia:Citing sources]] – Citation guideline
[[Category:Wikipedia formatting and function templates|{{PAGENAME}}]]
*[[Wikipedia:Footnotes]] – Reference guideline
*[[WP:CITET]] – Description of various templates to format individual citation references
*{{tl|reflist}} – Auto-generated listing of footnotes and inline citations


[[cy:Nodyn:Dechcyf]]
<includeonly>{{Sandbox other||
[[da:Skabelon:Refbegin]]
[[Category:Reference list templates]]
[[es:Plantilla:Refcomienza]]
[[Category:Text-specific formatting and function templates|{{PAGENAME}}]]
[[ja:Template:Refbegin]]
}}</includeonly>
[[no:Mal:Refbegin]]
[[ru:Шаблон:Refbegin]]
[[uk:Шаблон:Refbegin]]
[[pl:Szablon:Bibliografia start]]
[[pt:Predefinição:Refbegin]]
</includeonly>

Latest revision as of 04:59, 3 September 2020

Lua error in Module:TNT at line 167: Missing Commons dataset I18n/Module:TNT.tab.

{{refbegin}} and its complementary closing template {{refend}} are used to apply any of several optional styles or presentational choices for bibliographies or reference lists—that is, lists of fully-specified references, sources, and/or works cited, sorted alphabetically by author or contributor) that appear in Wikipedia articles.

These bibliographies or reference lists frequently appear in dedicated sections within an article, variously titled ==References==, ==Works cited==, ==Bibliography==, ==Further reading==, ==Published works==, and so on.

Wikipedia referencing or citation systems that use bibliography-style reference lists include: 'shortened' footnotes, parenthetical referencing, and 'general' referencing. The 'full' footnote and embedded citations referencing systems do not use those lists, although articles using these latter two systems may also contain "Further reading" or other sections containing bibliography-style listings, that {{refbegin}} formatting could be applied to.

The formatting options provided by this template are:

refbegin template options/parameters
Option How to get it Notes
default display {{refbegin}} no parameters needed, default fontsize is 90% of standard fontsize
display list in multiple columns {{refbegin|n}} where n determines the number of columns, or width of columns based on the browser's screen width
apply hanging indent {{refbegin|indent=yes}} will apply hanging indent if an individual reference wraps over more than one line in the browser's display window

Each use of {{refbegin}}, with or without parameters, needs an accompanying {{refend}} closing template to 'turn off' the formatting; refend does not need any parameters.

Font size reduction is applied by default. Either one, the other, or both of multi-columns and hanging indent may be applied as well (though see specifics and caveats on browser differences in relevant sections, below).

Usage

This template is used only for references—it should not be used to create lists of text which are smaller, in columns, or which have other style data associated with them.

With all (optional) parameters shown: 

==References==
{{refbegin |n |indent= }}
*list of bibliography/references entries..
...
{{refend}}

Placement

The {{refbegin}} is placed immediately below the header of the bibliography/references section its formatting will be applied to. The closing {{refend}} template is placed within the same section, at the end of the bibliography/references list content.

When used, each occurrence of {{refbegin}} should always be paired with a corresponding closing {{refend}} template: 

==References==
{{refbegin}}
*1st entry in the bibliography/references list..
*2nd entry in the bibliography/references list..
...
*last entry in the bibliography/references list..
{{refend}}

The formatting provided by {{refbegin}} is "turned on" at the location where the template is placed, and is applied to all text after and below it, until it is "turned off" by a closing {{refend}} template (or </div> tag). Failing to provide a closing {{refend}} may produce unwanted effects in other sections that may appear below the 'References', 'Bibliography' etc. section, such as 'External links' sections that are usually placed at or near the article's end.

Option 1: Default behaviour

The default usage (without parameters) applies a style that reduces the text size of the bibliographies/reference list entries. This can be useful to make a long bibliography/list of references display more compactly, and it also mimics the formatting style applied to footnotes by the {{reflist}} template.

The {{reflist}} formats footnotes—any text in the article body that is placed between <ref>...</ref> tags—that are auto-generated by the cite.php extension, called by {{reflist}}. In the case of articles using the 'shortened' footnotes referencing system, these footnotes will typically contain an abbreviated citation such as <ref>Smith 2002, p.123</ref> that corresponds with an entry in the bibliography/references list section (other text such as discursive notes may appear as well).

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 and Refbegin use each one CSS entry in MediaWiki:Common.css to set the font size: 

div.reflist,
div.refbegin {
    font-size: 90%;
}

If the 'full' footnotes referencing system is used (i.e. there is no separate bibliography/references list, all cites/references are defined in <ref>...</ref> tags), then use {{reflist}} alone: 

==References==
{{reflist}}

If there is a bibliography/references list but no footnoted citations (e.g. in general references or parenthetical referencing systems) then use {{refbegin}} and {{refend}} like so: 

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

If there are footnoted citations and a separate bibliography/references list (i.e., the WP:CITESHORT system), then place {{reflist}} to generate the footnotes in one section (immediately above the bibliography/references list), and use {{refbegin}} in the latter section: 

==Notes==
{{reflist}} <!--this will auto-generate the numbered list of footnotes/cites -->

==References==
{{refbegin}}
*bibliography entry / reference 1
*bibliography entry / reference 2
*etc
{{refend}}

Option 2: Multiple columns

If an integer n is supplied as the first parameter, the template will display the bibliography/references list in n columns. This may be useful for compact display for a lengthy list, and matches also the optional capability of {{reflist}} to display output in multiple columns. Thus, {{refbegin|2}} will display the list in two columns. If no integer parameter is specified, the default is a single column. Note, it will rarely be useful or practical to display bibliography/references list entries in more than two columns.

If a value with a unit is supplied as the first parameter, i.e. 30em, the template will display the bibliography/references list in columns with a minimum width of that value, allowing the browser to determine the optimal number of columns. Using {{refbegin|30em}} for instance is useful for short citations. 

==References==
{{refbegin|2}}
*{{cite journal |author= Southworth, Jane |author2= Catherine Tucker |date= August 2001 |title= The Influence of Accessibility, Local Institutions, and Socioeconomic Factors on Forest Cover Change in the Mountains of Western Honduras |url= http://www.bioone.org/doi/pdf/10.1659/0276-4741(2001)021%5B0276:TIOALI%5D2.0.CO%3B2 |format= PDF reproduction, BioOne online |journal= Mountain Research and Development |location= Boulder, CO |publisher= International Mountain Society and United Nations University |volume= 21 |issue= 3 |pages= 276–283 |doi= 10.1659/0276-4741(2001)021[0276:TIOALI]2.0.CO;2
 |issn= 0276-4741 |oclc= 107067006}}
*{{cite journal |author= Tucker, Catherine M. |author2= Darla K. Munroe |author3=Harini Nagendra |author4=Jane Southworth |date= June 2005 |title= Comparative Spatial Analyses of Forest Conservation and Change in Honduras and Guatemala |url= http://www.clas.ufl.edu/lueci/southworth/pubs-as-pdf/cs-3-1_10_jtuckeretal.pdf |format= PDF online open access article distributed under Creative Commons |journal= Conservation and Society |location= New Delhi and London |publisher= SAGE Publications |volume= 3 |issue= 1 |pages= 174–200 |issn= 0972-4923|oclc= 210806013}}
{{refend}}

References

  • Southworth, Jane; Catherine Tucker (August 2001). "The Influence of Accessibility, Local Institutions, and Socioeconomic Factors on Forest Cover Change in the Mountains of Western Honduras" (PDF reproduction, BioOne online). Mountain Research and Development. Boulder, CO: International Mountain Society and United Nations University. 21 (3): 276–283. doi:10.1659/0276-4741(2001)021[0276:TIOALI]2.0.CO;2. ISSN 0276-4741. OCLC 107067006.
  • Tucker, Catherine M.; Darla K. Munroe; Harini Nagendra; Jane Southworth (June 2005). "Comparative Spatial Analyses of Forest Conservation and Change in Honduras and Guatemala" (PDF online open access article distributed under Creative Commons). Conservation and Society. New Delhi and London: SAGE Publications. 3 (1): 174–200. ISSN 0972-4923. OCLC 210806013.
==References==
{{refbegin|30em}}
*{{cite journal |author= Southworth, Jane |author2= Catherine Tucker |date= August 2001|title= The Influence of Accessibility, Local Institutions, and Socioeconomic Factors on Forest Cover Change in the Mountains of Western Honduras |url= http://www.bioone.org/doi/pdf/10.1659/0276-4741(2001)021%5B0276:TIOALI%5D2.0.CO%3B2 |format= PDF reproduction, BioOne online |journal= Mountain Research and Development |location= Boulder, CO |publisher= International Mountain Society and United Nations University |volume= 21 |issue= 3 |pages= 276–283 |doi= 10.1659/0276-4741(2001)021[0276:TIOALI]2.0.CO;2
 |issn= 0276-4741 |oclc= 107067006}}
*{{cite journal |author= Tucker, Catherine M. |author2= Darla K. Munroe |author3=Harini Nagendra |author4=Jane Southworth |date= June 2005 |title= Comparative Spatial Analyses of Forest Conservation and Change in Honduras and Guatemala |url= http://www.clas.ufl.edu/lueci/southworth/pubs-as-pdf/cs-3-1_10_jtuckeretal.pdf |format= PDF online open access article distributed under Creative Commons |journal= Conservation and Society |location= New Delhi and London |publisher= SAGE Publications |volume= 3 |issue= 1 |pages= 174–200 |issn= 0972-4923|oclc= 210806013}}
{{refend}}

References

Browser support

CSS3 multiple-column layout browser support
Property Internet
Explorer		 Firefox Safari Chrome Opera
column-width
column-count 		≥ 10
(2012)		 ≥ 1.5
(2005)		 ≥ 3
(2007)		 ≥ 1
(2008)		 ≥ 11.1
(2011)
columns ≥ 10
(2012)		 ≥ 9
(2011)		 ≥ 3
(2007)		 ≥ 1
(2008)		 ≥ 11.1
(2011)
break-before
break-after
break-inside 		≥ 10
(2012)		 ≥ 65
(2019)		 ≥ 10
(2016)		 ≥ 65
(2016)		 ≥ 15
(2013)

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. See here for more information.

Option 3: Hanging indentation

A hanging indentation may be applied to bibliographies/reference lists by using the |indent= parameter. This option can be useful in long bibliographies/reference lists and in particular when individual entries in the list are long, i.e. they wrap over more than one line in the browser display window. Applying a hanging indent to the list makes it much easier to distinguish the keywords (i.e. normally the authors' names) in the bibliography and makes them stand out from preceding and succeeding lines of text. Hanging indents in bibliographies also form part of several widely used citation style implementations, such as APA, MLA, and Chicago.

To use, set {{refbegin|indent=yes}}.

Examples

a) Using {{refbegin}} with the hanging indent option |indent=yes applied: 

==References==
{{refbegin|indent=yes}}
* {{cite book |author= Dakin, Karen|year= 1994|chapter= El náhuatl en el yutoazteca sureño: algunas isoglosas gramaticales y fonológicas|title= Investigaciones lingüísticas en Mesoamérica |series= Estudios sobre Lenguas Americanas, no. 1|editor1=Carolyn MacKay |editor2=Verónica Vázquez |publisher= Universidad Nacional Autónoma de México, Instituto de Investigaciones Filológicas, Seminario de Lenguas Indígenas|location= México D.F.|pages= 3–86 |isbn= 968-36-4055-9 |oclc= 34716589 |language=es}}
* {{cite conference |author1=Flores Farfán |author2=José Antonio |year= 2002|title= The Use of Multimedia and the Arts in Language Revitalization, Maintenance, and Development: The Case of the Balsas Nahuas of Guerrero, Mexico |url= http://jan.ucc.nau.edu/~jar/ILAC/ILAC_24.pdf |format= [[Portable Document Format|PDF]] |conference= Proceedings of the Annual Conference on Stabilizing Indigenous Languages (7th, Toronto, Ontario, Canada, May 11–14, 2000) |booktitle= Indigenous Languages across the Community |editor1=Barbara Jane Burnaby |editor2=John Allan Reyhner |location= Flagstaff, AZ |publisher= Center for Excellence in Education, Northern Arizona University |pages= 225–236 |isbn= 0-9670554-2-3 |oclc= 95062129}}
* {{cite book |author= Rincón, Antonio del |year= 1885 |origyear= 1595 |title= Arte mexicana compuesta por el padre Antonio Del Rincón de la compañia de Jesus: Dirigido al illustrissimo y reverendissimo s. Don Diego Romano obispo de Tlaxcallan, y del consejo de su magestad, &c. En Mexico en casa de Pedro, Balli. 1595 |url= http://storage.lib.uchicago.edu/pres/2005/pres2005-033.pdf |edition= Reprinted 1885 under the care of Dr. Antonio Peñafiel |format= [[Portable Document Format|PDF]] facsimile, University of Chicago Library digital collections|location= México D.F. |publisher= Oficina tip. de la Secretaría de fomento |oclc= 162761360 |language=es}}
* {{cite book |author= Voegelin, Charles F.|author2= Florence M. Voegelin |author3=Kenneth L. Hale |year= 1962 |title= Typological and Comparative Grammar of Uto-Aztecan I: Phonology |type= Supplement to International Journal of American linguistics, vol. 28, no. 1 |series= Indiana University publications in anthropology and linguistics, Memoir 17 |location= Baltimore MD |publisher= Waverly Press |oclc= 55576894}}
{{refend}}

References

b) Using indent in combination with multi-column (in this case, n = 2) display {{refbegin|2|indent=yes}} (note that multi-column only works in some browsers): 

==References==
{{refbegin|2|indent=yes}}
* {{cite book |author= Dakin, Karen|year= 1994|chapter= El náhuatl en el yutoazteca sureño: algunas isoglosas gramaticales y fonológicas|title= Investigaciones lingüísticas en Mesoamérica |series= Estudios sobre Lenguas Americanas, no. 1|editor1=Carolyn MacKay |editor2=Verónica Vázquez |publisher= Universidad Nacional Autónoma de México, Instituto de Investigaciones Filológicas, Seminario de Lenguas Indígenas|location= México D.F.|pages= 3–86 |isbn= 968-36-4055-9 |oclc= 34716589 |language=es}}
* {{cite conference |author1=Flores Farfán |author2=José Antonio |year= 2002|title= The Use of Multimedia and the Arts in Language Revitalization, Maintenance, and Development: The Case of the Balsas Nahuas of Guerrero, Mexico |url= http://jan.ucc.nau.edu/~jar/ILAC/ILAC_24.pdf |format= [[Portable Document Format|PDF]] |conference= Proceedings of the Annual Conference on Stabilizing Indigenous Languages (7th, Toronto, Ontario, Canada, May 11–14, 2000) |booktitle= Indigenous Languages across the Community |editor1=Barbara Jane Burnaby |editor2=John Allan Reyhner |location= Flagstaff, AZ |publisher= Center for Excellence in Education, Northern Arizona University |pages= 225–236 |isbn= 0-9670554-2-3 |oclc= 95062129}}
* {{cite book |author= Rincón, Antonio del |year= 1885 |origyear= 1595 |title= Arte mexicana compuesta por el padre Antonio Del Rincón de la compañia de Jesus: Dirigido al illustrissimo y reverendissimo s. Don Diego Romano obispo de Tlaxcallan, y del consejo de su magestad, &c. En Mexico en casa de Pedro, Balli. 1595 |url= http://storage.lib.uchicago.edu/pres/2005/pres2005-033.pdf |edition= Reprinted 1885 under the care of Dr. Antonio Peñafiel |format= [[Portable Document Format|PDF]] facsimile, University of Chicago Library digital collections|location= México D.F. |publisher= Oficina tip. de la Secretaría de fomento |oclc= 162761360 |language=es}}
* {{cite book |author= Voegelin, Charles F.|author2= Florence M. Voegelin |author3=Kenneth L. Hale |year= 1962 |title= Typological and Comparative Grammar of Uto-Aztecan I: Phonology |format= Supplement to International Journal of American linguistics, vol. 28, no. 1 |series= Indiana University publications in anthropology and linguistics, Memoir 17 |location= Baltimore MD |publisher= Waverly Press |oclc= 55576894}}
{{refend}}

References

Template data

This is the TemplateData for this template, used by TemplateWizard, VisualEditor and other tools.
TemplateData for Refbegin

This template is used to start formatting for a reference list or bibliography.

Template parameters

This template prefers inline formatting of parameters.

ParameterDescriptionTypeStatus
Column width/Columns1

First mode: typographic unit of measurement such as 'em', specifying the width for the reference list columns, e.g. '33em'; spaced '33 em' will not be recognized. Second mode (deprecated): integer number of fixed columns into which the reference list is to be rendered.

Default
1
Example
30em
Stringsuggested
colwidthcolwidth Column width

Width of columns eg '25em' the default is '30em'.

Default
30em
Stringoptional
Hanging indentationindent

Set to "yes" to use hanging indent if an individual reference wraps over more than one line in the browser's display window.

Stringoptional
indentsizeindentsize

Amount of indent in em units. Default is '3.2'

Numberdeprecated

See also


Retrieved from "https://zoophilia.wiki/index.php?title=Template:Refbegin/doc&oldid=74714"