Template:Ran/doc

From the AARoads Wiki: Read about the road before you go
Jump to navigation Jump to search

Using {{Rma}} and {{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. [S1] in the examples below).

Usage

{{Rma}}

Creates a "reference, manually anchored", with layout matching the output of the usual <ref></ref> machinery. It is typically used in a References or similar section of an article. Its syntax is borrowed to some extent from {{wikicite}}. Example

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

outputs

S1.
Smith, J. (1999). The Big Book.

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

Citation templates such as {{cite book}} are not required; the following example uses "free text":

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

This outputs

J.
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 |tw= parameter can be used to set a larger "tag width"; the same |tw= value should be used with all invocations of {{rma}} in the article so that all tags line up evenly.

{{Ran}}

Creates a superscript "callout" (visually similar to the usual callouts generated by <ref></ref>) to a source which is cited elsewhere in the article using {{rma}}. Example:

Smith disagrees.{{ran|S1}}

or

Smith disagrees.{{ran|tag=S1}}

would appear in the article thus:

Smith disagrees.[S1]

(Click on the superscript [S1] to see how the linking operates.)

Like {{rp}} (and {{r}} for that matter), {{ran}} also accepts a |page= parameter:

Smith disagrees.{{ran|S1|page=22}}

or

Smith disagrees.{{ran|tag=S1|page=22}}

would appear as:

Smith disagrees.[S1]:

(|page= has a shorthand alias |p= parameter. For plural pages |pages= and |pp= can be used instead, and for other in-source-locations use |at= or |loc=. |style=ama and |no-pp=y[es] can be used to switch the display format.)

Also like {{rp}} and {{r}}, {{ran}} supports optional |quote=/|q=, |language=code/name/|l=code/name, |trans-quote=/|tq= and |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, |quote-page=/|qp= and |quote-pages=/|qpp= can be used to override those values. The parameters |needed=, |reason= and |date= of the {{Page needed}} template are supported as well.

Back links

Unlike Wikipedia's <ref> tags, {{ran}} does not create a link back from the footnote. If you follow this superscript link,[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:

Repeated usage of a named reference

[1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1]

  1. ^ a b c d e f g h i j k l m n o p q r s t u v w x y z aa ab ac ad ae af ag ah ai aj ak al am an ao ap aq ar as at au av aw ax ay az ba bb bc bd be bf bg bh bi bj bk bl bm bn bo bp bq br bs bt bu bv bw bx by bz ca cb cc cd ce cf cg ch ci cj ck cl cm cn co cp cq cr cs ct cu cv The Cambridge Dictionary of Philosophy, (Second Edition). Cambridge University Press; 1999. ISBN 0-521-63722-8

To the usage of the same number of {{ran}} templates:

Repeated usage of "ran"

[1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1][1]

1.
The Cambridge Dictionary of Philosophy, (Second Edition). Cambridge University Press; 1999. ISBN 0-521-63722-8

Error messages

Editors who have installed User:Ucucha/HarvErrors.js (or a similar script) may see errors such as

Harv error: There is no link pointing to this citation. The anchor is named CITEREFSmith2006

because Citation Style 1 templates like {{cite book}} and {{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 |ref=none, as in:

{{rma |tag=L |reference={{citation |ref=none |author-last=Smith |author-first=John |journal=Important things |title=Something important |volume=34 |date=2006}}}}

See also