Kigezo:Reftalk/doc
This is a documentation subpage for Kigezo:Reftalk. It contains usage information, categories and other content that is not part of the original kigezo page. |
This template is used on 25912 pages, and changes to it will be widely noticed. Please test any changes in the template's /sandbox or /testcases subpages, or in a user subpage, and consider discussing changes at the talk page before implementing them. |
This template is a version of {{Reflist}}
designed for sections of talk pages and other, non-article sections.
{{Reflist-talk}}
creates a list of references 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.
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
haririTo create a section-level reference box in a section containing references within <ref></ref>
tags, add the following wikitext to the end of a section:
{{Reflist-talk}}
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:
{{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. -->
This hidden comment has instructions designed to keep the wikitext in the right order.
Optional parameters
haririThere are no required parameters. When using all parameters, the basic syntax is:
{{Reflist-talk|1=colwidth=|title=|group=|refs=}}
|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 {{Reflist}}
:
|colwidth=
: state in ems, a typographic unit of measurement.|refs=
: used with Kigezo:Ldr.|group=
: identifies by name the subset of references to be rendered; the value should correspond to that used inline, e.g.,{{Reflist-talk|group=groupname}}
renders all references with groupname as the group name (<ref group=groupname>
). There are five predefined group names that style the list differently. See 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
haririThis parameter is no longer in use:
- close: Until 2014, the parameter
|close=1
was used to work around a bug. When the bug was fixed, this was removed.
Limitations
haririDo not indent this template
haririThis 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.
Incorrectly boxed example
haririIf you add :
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:[1]
Correctly boxed example
haririIf this is fixed, the above example would display inside a correctly-indented box, which would look like the following except correctly indented: [2] Kigezo:Reflist-talk
Redirect from deleted template
hariri{{Section references}}
now redirects here to {{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.
See also
hariri- {{Dummy ref}}
- {{Fake heading}}
- {{Notelist-talk}}
- {{Sources-talk}}
- Help:Automatically generated reference list
- Wikipedia:Citing sources/Further considerations—a how-to article with some additional considerations for citing sources
Kigezo:Wikipedia referencing Kigezo:Wikipedia help pages Kigezo:Inline talk templates