imported>Uanfala: add a more general description of what the template does (vs. a particular use case): see e.g. previous discussions: Template_talk:Reflist-talk/Archive_1#reflist_and_talk and Template_talk:Reflist-talk/Archive_1#At_end_of_the_section?; condense the introduction and remove details that are not necessary for understanding the template; move list of redirects to the end

2023-03-12T20:00:39Z

add a more general description of what the template does (vs. a particular use case): see e.g. previous discussions: Template_talk:Reflist-talk/Archive_1#reflist_and_talk and Template_talk:Reflist-talk/Archive_1#At_end_of_the_section?; condense the introduction and remove details that are not necessary for understanding the template; move list of redirects to the end

New page

{{Documentation subpage}}

{{Template shortcut|reftalk|tref|rlt}}
{{high-use}}
{{Uses TemplateStyles|Template:Reflist-talk/styles.css}}

This template is a version of {{Tlx|Reflist}} designed for use outside of articles, for example on talk pages. Like, {{Tlx|Reflist}}, it creates a list of all references that have been defined with {{tag|ref}} tags on the page above the template (but below any other instances of a reflist template). The list is displayed inside a bordered box and with a title ("References" by default) that is not formatted as as a section heading.

It is most useful when the list of references needs to appear close to the text where the references are used, for example at the end of a section or right after a quoted passage.

If using it at the end of a section, consider adding a hidden comment to help editors keep the wikitext in the correct place:
* <code><nowiki>{{Reflist-talk}}</nowiki></code>

== Optional parameters ==
There are no ''required'' parameters. When using all parameters, the basic syntax is: <br />
<code><nowiki>{{Reflist-talk|colwidth=|title=|group=|refs=}}</nowiki></code>
* {{para|title}} specifies the box title, which defaults to '''References''' if this parameter is omitted. The box title will be blank if this parameter is included without an argument (that is, without any text after the equal sign).

The template recognizes these features of {{Tlx|Reflist}}:
* {{Para|colwidth}}: state in [[Em (typography)|ems]], a typographic unit of measurement. 
* {{Para|refs}}: used with {{ldr}}.
* {{Para|group}}: identifies by name the subset of references to be rendered; the value should correspond to that used inline, e.g., {{tlx|Reflist-talk|group{{=}}groupname}} renders all references with groupname as the group name ({{tag|ref|o|params=group=groupname}}). There are five predefined group names that style the list differently. See [[Reflist#Grouped references|Reflist § Grouped references]]

The template should be placed after the discussion that includes the references, as it will include all references before the template that haven't been claimed by a previous template. 

== Obsolete parameter ==
This parameter is no longer in use:

* '''close''': Until 2014, the parameter {{para|close|1}} was used to work around a bug. When the bug was fixed, this was removed.

== Limitations ==
=== Do not indent this template ===
This template does not work correctly if indented with colons as is usual with talk page discussions.

Indenting also is unnecessary, because indentation is irrelevant to it: the reference box contains ''all'' the references from ''all'' posts in the section from ''all'' editors. Plus, it is set apart from other text through its own style, including a light, boxed outline. See [[Template_talk:Reflist/Archive_33#Limitations|this discussion]] for further details about this limitation.

=== Incorrectly boxed example ===
<div>
If you add <code>:</code> before it, the references do not appear inside the box as expected, but rather you get an indented empty dashed box, ''followed by'' the references, which are not indented:<ref>Incorrectly boxed example reference</ref>
:{{reflist-talk}}

=== Correctly boxed example ===
If this is fixed, the above example would display ''inside'' a correctly-indented box, which would look like the following:
<ref>Correctly boxed example reference</ref>
{{reflist-talk}}

== Redirects ==
Redirect list is from '''[https://en.wikipedia.org/w/index.php?title=Special:WhatLinksHere/Template:Reflist-talk&hidelinks=1&hidetrans=1 here].'''
{{tl|Inlineref}}
{{tl|Ref-talk}}
{{tl|Reflist-quote}}
{{tl|Reflist-talk}}
{{tl|Reflisttalk}}
{{tl|Reftalk}}
{{tl|REftalk}}
{{tl|Section references}}
{{tl|Talk-reflist}}
{{tl|Talk-refs}}
{{tl|Talk page-reflist}}
{{tl|Talk page ref}}
{{tl|Talk page reference}}
{{tl|Talk page reflist}}
{{tl|Talk ref}}
{{tl|Talk reference}}
{{tl|Talk references}}
{{tl|Talk reflist}}
{{tl|Talk refs}}
{{tl|Talkref}}
{{tl|Tref}}
{{tl|TREF}}

== Redirect from deleted template ==
{{Tlx|Section references}} now redirects here to {{Tlx|Reflist-talk}}. However, previously it was a different template that was deleted, with the existence of this template as part of the justification. See [[Wikipedia:Templates for discussion/Log/2015 March 2#Template:Section references]] for details.

== TemplateData ==
{{TemplateDataHeader}}
<templatedata>
{
"params": {
"style": {
"label": "Extra CSS",
"description": "Additional CSS to apply",
"type": "unknown"
},
"title": {
"label": "Section title",
"description": "The title to display before the references",
"type": "string",
"default": "References"
},
"colwidth": {
"aliases": [
"1"
],
"label": "Columns / Column width",
"description": "Passed to {{reflist}}. Two modes supported. First mode (deprecated): integer number of fixed columns into which the reference list is to be rendered. Second mode: typographic unit of measurement such as 'em', specifying the width for the reference list columns, e.g. '33em'; spaced '33 em' will not be recognized",
"type": "string",
"default": "1 if < 11 references; otherwise 30em"
},
"refs": {
"label": "List of references",
"description": "Passed to {{reflist}}. Provides a space to define named references for use in the article. References defined in this space are not shown unless used somewhere in the article.",
"type": "string"
},
"group": {
"label": "Group",
"description": "Passed to {{reflist}}. Group is an identifier which restricts the references that are shown. Without this parameter, this template only shows references with no group identifier. With a group identifier specified, only references with a matching group identifier are handled. The rest are left alone.",
"type": "string"
}
},
"description": "This template creates a list of references for a talk page discussion within a particular section.",
"paramOrder": [
"title",
"colwidth",
"group",
"refs",
"style"
]
}
</templatedata>

== See also ==
* {{tl|Dummy reference}}
* {{tl|Fake heading}}
* {{tl|Notelist-talk}}
* {{tl|Sources-talk}}, a collapsed version of the above
* [[Help:Automatically generated reference list]]
* [[Wikipedia:Citing sources/Further considerations]]—a how-to article with some additional considerations for citing sources

{{Wikipedia referencing}}
{{Wikipedia help pages}}
{{Inline talk templates}}
<includeonly>{{Sandbox other||

[[Category:Reference list templates]]
[[Category:Documentation assistance templates]]
[[Category:Talk namespace templates]]
}}</includeonly>

Template:Reflist-talk/doc - Revision history