View source for Template:Ran/doc

{{Documentation subpage}}

Using {{t|Rma}} and {{t|Ran}} allows editors to control the order in which references are listed (alphabetical, divided into groups, etc.), and to manually assign the reference "tags" (e.g. {{ran|S1}} in the examples below).

==Usage==

==={{t|Rma}}===
Creates a "reference, manually anchored", with layout matching the output of the usual <code><nowiki><ref></ref></nowiki></code> machinery. It is typically used in a ''References'' or similar section of an article. Its syntax is borrowed to some extent from {{t|wikicite}}. Example
:<code><nowiki>{{rma |tag=S1 |reference={{cite book |author-last=Smith |author-first=J. |title=The Big Book |date=1999}}}}</nowiki></code>
outputs

{{rma |tag=S1 |reference={{cite book |author-last=Smith |author-first=J. |title=The Big Book |date=1999 |ref=non}}}}

The <code>S1</code> (for example) is the "manual anchor"{{snd}}any string (preferably very short) assigned to the referenced work, and by which it will be referred later (typically using {{t|ran}}). The Smith source can then be referenced from article text using <code><nowiki>{{ran|S1}}</nowiki></code> (see below).

Citation templates such as {{t|cite book}} are not required; the following example uses "free text":
:<code><nowiki>{{rma |tag=J |reference=Jones, B. (May 12, 1868). "Many thanks for the gift". Letter to A. Ames.}}</nowiki></code>
This outputs

{{rma |tag=J |reference=Jones, B. (May 12, 1868). "Many thanks for the gift". Letter to A. Ames.}}

The default width of the tags column is 20px. If some of the tags are bigger than that, the {{para|tw}} parameter can be used to set a larger "tag width";<!--it could be used to set a smaller width too, but there's little point in going into that--> the same {{para|tw}} value should be used with ''all'' invocations of {{tl|rma}} in the article so that all tags line up evenly.<!--an example would be nice-->

==={{t|Ran}}===
Creates a superscript "callout" (visually similar to the usual callouts generated by <code><nowiki><ref></ref></nowiki></code>) to a source which is cited elsewhere in the article using {{t|rma}}. Example:
:<code><nowiki>Smith disagrees.{{ran|S1}}</nowiki></code>
or
:<code><nowiki>Smith disagrees.{{ran|tag=S1}}</nowiki></code>
would appear in the article thus:
:Smith disagrees.{{ran|S1}}
(Click on the superscript {{ran|S1}} to see how the linking operates.)

Like {{t|rp}} (and {{t|r}} for that matter), {{tl|ran}} also accepts a {{para|page}} parameter:
:<code><nowiki>Smith disagrees.{{ran|S1|page=22}}</nowiki></code>
or
:<code><nowiki>Smith disagrees.{{ran|tag=S1|page=22}}</nowiki></code>
would appear as:
:Smith disagrees.{{ran|S1|page=22}}
({{para|page}} has a shorthand alias {{para|p}} parameter. For plural pages {{para|pages}} and {{para|pp}} can be used instead, and for other in-source-locations use {{para|at}} or {{para|loc}}. {{para|style|ama}} and {{para|no-pp|y[es]}} can be used to switch the display format.)

Also like {{t|rp}} and {{t|r}}, {{tl|ran}} supports optional {{para|quote}}/{{para|q}}, {{para|language|code/name}}/{{para|l|code/name}}, {{para|trans-quote}}/{{para|tq}} and {{para|wrap|n[o]/y[es]/f[orced]}} parameters. If the quote page are not the same as the pages specified through one of the pages parameters above, {{para|quote-page}}/{{para|qp}} and {{para|quote-pages}}/{{para|qpp}} can be used to override those values. The parameters {{para|needed}}, {{para|reason}} and {{para|date}} of the {{tl|Page needed}} template are supported as well.

==Back links==
Unlike Wikipedia's <code><nowiki><ref></nowiki></code> tags, {{tl|ran}} does not create a link back from the footnote. If you follow this superscript link,{{ran|J}} you will not see any links back to the superscript "callout". This is useful in places where backlinks are either not possible or not useful. 

For example, a list, glossary, or biography may cite the same source throughout the entire article. Compare the backlinks generated by these named references:
{{collapse top
|title=Repeated usage of a named reference}}
<ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/><ref name="One"/>
{{collapse bottom}}

<references>
<ref name="One">
''[[The Cambridge Dictionary of Philosophy]], (Second Edition)''. Cambridge University Press; 1999. {{ISBN|0-521-63722-8}}
</ref>
</references>

To the usage of the same number of {{tl|ran}} templates:
{{collapse top
|Repeated usage of "ran"}}
{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}{{ran|1}}
{{collapse bottom}}

{{refbegin}}
{{rma  |tag=1 |reference=''[[The Cambridge Dictionary of Philosophy]], (Second Edition)''. Cambridge University Press; 1999. {{ISBN|0-521-63722-8}} }}
{{refend}}

==Error messages==
Editors who have installed [[:User:Ucucha/HarvErrors.js]] (or a similar script) may see errors such as
:{{red|Harv error: There is no link pointing to this citation. The anchor is named CITEREFSmith2006}}
because Citation Style 1 templates like {{tl|cite book}} and {{tl|citation}} generate CITEREF anchors that the script expects to be linked from short citations within the article. There is typically no reason to worry about such messages in References sections; see [[User:Ucucha/HarvErrors]] for more details. Only readers logged in, and with the .js just mentioned installed, will see this message, so this isn't as big a deal as it may seem. This can be suppressed by adding {{para|ref|none}}, as in:
:<code><nowiki>{{rma |tag=L |reference={{citation |ref=none |author-last=Smith |author-first=John |journal=Important things |title=Something important |volume=34 |date=2006}}}}</nowiki></code>

==See also==
* [[WP:CITESHORT|Shortened footnotes]] in [[Wikipedia:Citing sources]], which describes other ways of citing multiple pages of the same source.
* {{tl|sfn}}, a template that implements another way of citing multiple pages of the same source.
* {{tl|rp}}, a template internally used by {{tl|ran}} to provide the superscript link appendices.
* {{tl|r}}, a citation system with similar output than {{tl|rp}} (and {{tl|ran}}), but using MediaWiki's Cite extension internally
* [[WP:CITEBUNDLE|Citation bundling]] in [[Wikipedia:Citing sources]], a way of combining a list of several consecutive footnotes into a single footnote.
* [[Wikipedia:Footnotes]]
* [[Wikipedia:Citing sources]]

<includeonly>{{Sandbox other||
<!-- Categories go below this line, please; interwikis go to Wikidata, thank you! -->
[[Category:Footnote templates]]
[[Category:Inline templates]]

}}</includeonly>