Reba inkomoko ya Inyandikorugero:Reflist-talk/doc

{{Documentation subpage}}
<!-- Categories go where indicated at the bottom of this page, please; interwikis go to Wikidata (see also: [[Wikipedia:Wikidata]]). -->
{{Template shortcut|reftalk|tref|rlt}}
{{high-use}}
{{Uses TemplateStyles|Template:Reflist-talk/styles.css}}

This template is a version of {{Tlx|Reflist}} designed for sections of talk pages and other, non-article sections (e.g. blocks of example text with citations in a guideline, a how-to essay, or a template's documentation page).

<code><nowiki>{{Reflist-talk}}</nowiki></code> creates a list of  references <!-- found between one section header and the next (or the end of the page) [I had originally added this text because it was the behavior I saw when editing this page, but then I saw later in the existing documentation that the template is supposed to include all references not claimed by previous templates. I'm commenting this out until I can get some clarification. Geekdiva, July 2017] -->for a talk page discussion within a particular section. The list has the default title: '''References'''. To distinguish it from an article's References section, it appears within a bordered box.
<!-- I based the following on observed behavior. Is it accurate? If so, we can add it to the documentation. Geekdiva, July 2017
Note that the box title created by this template does not function as a [[wikitext]] header, even though it mimics the appearance of the customary [[WP:References section|References section]] header. For example, it does not appear in the table of contents, nor can you create a [[WP:Wikilink|wikilink]] directly to it without first creating an [[WP:Anchor|anchor]] there. You can further distinguish the box title from a References section header by modifying it with the  {{para|title}}  parameter as discussed below.
 -->

This template could also be useful on other types of non-mainspace pages structured with section headers, e.g., for a section in a user's sandbox.

== Usage ==
To create a section-level reference box in a section containing references within <code><nowiki><ref></ref></nowiki></code> tags, add the following [[wikitext]] to the end of a section:
* <code><nowiki>{{Reflist-talk}}</nowiki></code>

When having a discussion with new editors or others who might not know how to work with this template, add the following wikitext to the section's end to create a section-level reference box plus task-oriented instructions in a hidden comment:

* <code><nowiki>{{Reflist-talk}}<!-- Template:Reflist-talk creates a section-level reference list box. Please add comments and references for this section's discussion above this template. When a new discussion begins, the new section will be added below this template. Add a new {{Reflist-talk}} at the end of that section if needed. --></nowiki></code>

This hidden comment has instructions designed to keep the wikitext in the right order.

== 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}}

== 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. <!-- This is obsolete at Reflist and is replaced by an unnamed parameter. What's the behavior here at Reflist-talk? -->
* {{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 §&nbsp;Grouped references]]

<!--See talk page to see why these hidden comments need verification (Geekdiva, 7/17):
It specifically closes all references so that it can be used multiple times on a page— see [[Template:Reflist/doc#Multiple uses]]. The reference list is shown and honors indenting markup to keep it with the discussion.-->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. <!--This keeps the references associated with the appropriate section for clarity and to maintain the integrity of the discussion when archived.-->

== Obsolete parameter ==
This parameter is no longer in use:
<!-- * '''colwidth''': Same as specifying a column-width for the first unnamed parameter. Replaced by width as unnamed first parameter. -->
* '''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><!-- NOTE: This UNCLOSED DIV is intentional, as it's necessary to keep the Template:Documentation wrapping from breaking on this incorrect-behavior example. If it is removed, or balanced with a closing DIV tag, then the documentation will not format correctly when it is transcluded onto the Template:Reflist-talk page. See this documentation's Talk page for more information. -->
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<!--, in which case delete the Limitations section!-->, which would look like the following:
<ref>Correctly boxed example reference</ref>
{{reflist-talk}}

== 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&nbsp;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||
<!-- Categories go below this line, please; interwikis go to Wikidata, thank you! -->
[[Category:Reference list templates]]
[[Category:Documentation assistance templates]]
[[Category:Talk namespace templates]]
}}</includeonly>