From MattWiki
Jump to: navigation, search


Provides a simple wrapper for up to nine consecutive <ref name=RefName/> citation tags that minimizes visual impact on the text which, along with the simpler syntax, increases code readability and ease of editing.

Comparison to <ref>

Note how much shorter the coding is when using {{r}}.

Using <ref> For example, fact<ref name=RefName/><ref name=Bam/><ref name=Bar/> and fact.<ref name=Bas/><ref name=Bay/><ref name=Baz/>
Displays as: For example, fact[1][2][3] and fact.[4][5][6]
Using {{r}} For example, fact{{r|RefName|Bam|Bar}} and fact.{{r|Bas|Bay|Baz}}
Displays as: For example, fact[1][2][3] and fact.[4][5][6]

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 format.


Usage Display Notes
{{r|RefName}} Text.[1] Adds a citation marker equivalent to <ref name=RefName/>.
Text.[1]:100 Adds a citation marker with a location identifier within the source.
All forms—|p=, |pp=, |page=, and |pages=—are equivalent.
Only use where there are multiple references to one source, each to a different location within the source.
If the article cites only one location in a given source, reduce clutter in the article text by integrating the location into the main citation, instead of using |p= or its aliases.
{{r|RefName|pp=3, 6}}
{{r|RefName|pages=Front jacket flap}}
Text.[1]:3, 6
Text.[1]:Front jacket flap
{{r|RefName|Bam|Bar}} Text.[1][2][3] Up to nine references may be bundled in a single use of {{r}}.
This example is the equivalent of <ref name=RefName/><ref name=Bam/><ref name=Bar/>.
Text.[1]:100[2]:10–14[3][4]:§C Combines page references in a single call of {{r}} by utilizing numbered |p= parameters.
Note that not all references have location identifiers, use care in ensuring the corresponding |p= parameter number is listed for the correct reference.
The name parameters may also be numbered to ensure accuracy, as shown in the last two examples.
Note too that you may group all the name parameters and page parameters, or list them sequentially.
Text.[Notes 1]
Text.[Notes 1][Notes 2]
Text.[Notes 1]:13
The |group=, |grp=, and |g= parameters are equivalent and echo <ref group=Notes name=NtName/>.
If present, the parameter applies to all references in the template.
Location identifiers may also be used as detailed above.

The ref names must be defined; this is normally done in a References section (as demonstrated below). The separate Notes section is also illustrated.

<ref name=RefName>Reference text.</ref>
<ref name=Bam>Bam reference text.</ref>
<ref name=Bar>Bar reference text.</ref>
<ref name=Bas>Bas reference text.</ref>
<ref name=Bay>Bay reference text.</ref>
<ref name=Baz>Baz reference text.</ref>

<ref name=NtName>Note text.</ref>
<ref name=NtCam>Cam note text.</ref>

Resulting in:

  1. 1.0 1.1 1.2 1.3 1.4 1.5 1.6 1.7 1.8 1.9 Reference text.
  2. 2.0 2.1 2.2 2.3 Bam reference text.
  3. 3.0 3.1 3.2 3.3 Bar reference text.
  4. 4.0 4.1 4.2 Bas reference text.
  5. 5.0 5.1 Bay reference text.
  6. 6.0 6.1 Baz reference text.
  1. 1.0 1.1 1.2 Note text.
  2. Cam note text.

See also