View source for Help:List-defined references

{{How to|BTW:LDRHOW|BTW:LDRHTG}}

'''List-defined references''' (LDR) are references that are defined in the reference list markup, as opposed to being defined in the body of the article. This page is a continuation from [[Help:Footnotes]]. This guide assumes you are familiar with the tools explained there, such as the features of {{tag|ref}} tags, and the {{tag|ref|s |params=name=<var>"REFNAME"</var>}} parameter.

==Overview==
LDR uses [[Help:Footnotes#Reference_lists:_the_basics|named references]] where each individual reference has a unique name and is defined within the reference list markup:

<syntaxhighlight lang="wikitext">
<references>
  <ref name="name1">reference</ref>
  <ref name="name2">reference2</ref>
</references>
</syntaxhighlight>

:Or; using {{tl|reflist}}

<syntaxhighlight lang="wikitext">
{{reflist|refs=
  <ref name="name1">reference</ref>
  <ref name="name2">reference2</ref>
}}
</syntaxhighlight>

Alternatively, references can be defined using the 'referencing' wrapper template {{tl|r}} (for brevity the parameter names {{para|name}} and {{para|ref}} can be abbreviated to {{para|n}} and {{para|r}}):
<syntaxhighlight lang="wikitext">
<references>
  {{r|name="name1"|ref=reference}}
  {{r|name="name2"|ref=reference2}}
</references>
</syntaxhighlight>

:Or; with {{tl|reflist}}

<syntaxhighlight lang="wikitext">
{{reflist|refs=
  {{r|name="name1"|ref=reference}}
  {{r|name="name2"|ref=reference2}}
}}
</syntaxhighlight>

Each reference is invoked in the body of the text using {{tag|ref|s|params=name="name1"}} or {{tlx|r|name}}.

{{refname rules}}

==Guidelines==
* '''All list-defined references must be named'''. Any name complying with the technical limitations above may be used; however, they should be consistent so that they can be edited by other users. A well-used practice is author-date, author-title or publication-date.
* Additionally, '''any unused references will generate an error'''. All list-defined references must be used in the body and vice versa, all {{tag|ref|params=name="ABC"}} tags must have defining information.
* List-defined references and references defined in the body of the article may be mixed on a page—this is not a technical limitation of the template. However, this may be confusing to ongoing editors, and should be normalized to a single style.
* Reference lists may be ordered in any manner (e.g. alphabetical by reference name), but the generated list will be in the order in which the references are invoked.

==Examples==

{{markup
|<syntaxhighlight lang="wikitext">The Sun is pretty big.<ref name="Foot01"/> But the Moon<ref name="Foot02"/> is not so big.<ref name="Foot03"/> The Sun is also quite hot.<ref name="Foot04"/>

==Notes==
{{reflist|refs=
<ref name="Foot01">Miller, ''The Sun'', Oxford, 2005, p. 23.</ref>
<ref name="Foot02">Jones, ''The Solar System'', MacMillan, 2005, p 623.</ref>
<ref name="Foot03">Brown, ''The Moon'', 2006, Penguin, p. 46.</ref>
<ref name="Foot04">Smith, ''The Universe'', Random House, 2005, p. 334.</ref>
}}</syntaxhighlight>
|The Sun is pretty big.<ref name="Foot01"/> But the Moon<ref name="Foot02"/> is not so big.<ref name="Foot03"/> The Sun is also quite hot.<ref name="Foot04"/>

{{fake heading|sub=3|Notes}}
{{reflist|refs=
<ref name="Foot01">Miller, ''The Sun'', Oxford, 2005, p. 23.</ref>
<ref name="Foot02">Jones, ''The Solar System'', MacMillan, 2005, p 623.</ref>
<ref name="Foot03">Brown, ''The Moon'', 2006, Penguin, p. 46.</ref>
<ref name="Foot04">Smith, ''The Universe'', Random House, 2005, p. 334.</ref>
}}}}


{{markup|title=List-defined references with explanatory footnotes using a separate reference group.
|<syntaxhighlight lang="wikitext">The Sun is pretty big.<ref name="Foot01"/><ref group="Note" name="Note01"/> But the Moon<ref group="Note" name="Note02"/> is not so big.<ref name="Foot02"/><ref group="Note" name="Note03"/> The Sun is also quite hot.<ref name="Foot03"/>

==Notes==
{{reflist|group=Note|refs=
<ref name="Note01">But Miller points out that the Sun is not as large as some other stars.</ref>
<ref name="Note02">The Moon goes by other names, such as Selena.</ref>
<ref name="Note03">Historically the Moon was not always considered to be large.</ref>
}}

==References==
{{reflist|refs=
<ref name="Foot01">Miller, ''The Sun'', Oxford, 2005, p. 23.</ref>
<ref name="Foot02">Brown, ''The Moon'', 2006, Penguin, p. 46.</ref>
<ref name="Foot03">Smith, ''The Universe'', Random House, 2005, p. 334.</ref>
}}</syntaxhighlight>
|The Sun is pretty big.<ref name="Foot01"/><ref group="Note" name="Note01"/> But the Moon<ref group="Note" name="Note02"/> is not so big.<ref name="Foot02"/><ref group="Note" name="Note03"/> The Sun is also quite hot.<ref name="Foot03"/>

{{fake heading|sub=3|Notes}}
{{reflist|group=Note|refs=
<ref name="Note01">But Miller points out that the Sun is not as large as some other stars.</ref>
<ref name="Note02">The Moon goes by other names, such as Selena.</ref>
<ref name="Note03">Historically the Moon was not always considered to be large.</ref>
}}

{{fake heading|sub=3|References}}
{{reflist|refs=
<ref name="Foot01">Miller, ''The Sun'', Oxford, 2005, p. 23.</ref>
<ref name="Foot02">Brown, ''The Moon'', 2006, Penguin, p. 46.</ref>
<ref name="Foot03">Smith, ''The Universe'', Random House, 2005, p. 334.</ref>
}}}}

==Usage notes==
The use of list-defined references means that while editing, the references and footnotes formatted this way are all inserted in the source section where the template {{tlx|reflist|2=refs= }} is located. This is primarily a change in the source code and does not affect the display of the article to a reader. The primary effects are for editors, as described below.

The LDR method removes any citation details or notes that could disrupt the edit window while editing the body of the text, which is especially useful if they are vertical or otherwise span multiple lines. Additionally, this centralised reference list section can be opened by itself if any of the citation entries need modification, which can be especially helpful if attempting to modify a reference that is used multiple times—avoiding any need to search the entire source for it.

A drawback of the approach is that these references can be harder to insert into the source, because they are separated from the text. The editor must either open the entire document to see the source for both the text and the reference list, or alternatively use a two-step procedure, first entering the identifier {{tag|ref|s|params=name="<var>name</var>"}} in the main text and then opening the reference listing section to enter the source or footnote as {{tag|ref|params=name="<var>name</var>"|content=<var>content</var>}}. Another overhead of this approach is that the list at the end of the article must be organised so that they can be found easily by an editor—most likely arranged alphabetically in the edit window by refname as this is most likely to retain source integrity and usefulness, even if the sections of the text are changed.

While it is often tidier to remove all citations from the source text, an acceptable compromise (especially for small articles) could be to only use LDR for citations used multiple times. This is because they already use the refname code so that they can be in multiple places—a simple move of the reference's source code from its first appearance to the reflist is a minor change. Additionally, these citations are more likely to need reviewing or modification, because they are more important to the article and contain more details, and making them easier to find and modify can be very helpful. Finally, this also maintains source integrity if the first instance of the reference changes, as noted above.

Finally, there are some misconceptions about list-defined footnotes:
#One of these is that the creation of separated footnote lists requires the use of list-defined footnotes. However, using a 'group' name to differentiate various kinds of footnotes, is available regardless of whether list-defined or in-line footnotes are used. For example, in both cases one can designate notes as a group called "Note", and separate them from simple citations by using the in-line label {{tag|ref|s |params=group="Note" name="<var>name</var>"}} (The complete explanation of the use of group names is illustrated in the second example in the [[#Examples|section immediately above]].)
#Another misconception is that there is an "either-or" choice between use of list-defined footnotes and in-line footnotes, and that all citations in an article must follow only one of the styles. In fact, {{tlx|reflist|2=refs= }} is entirely compatible with the use of in-line footnotes in the form {{tag|ref|content=<var>content</var>}} or {{tag|ref|params=name="<var>name</var>"|content=<var>content</var>}}. Although use of both systems in the same article might appear confusing or undesirable, it is a fact that the two systems can be mixed indiscriminately with the template {{tlx|reflist|2=refs= }}.

==See also==
* [[Template:R]] – this template reduces the text needed to define and invoke named refs, <nowiki><ref name="foo"/></nowiki> becomes <nowiki>{{r|foo}}</nowiki>

==References==
{{reflist}}

{{BattleTechWiki referencing}}

[[Category:Footnote templates| ]]