Template:Rp/doc

"Rp" stands for "reference page(s)". This is a method of citing page numbers.

Function
Use this template when you are referring to specific pages within a source which is cited many times in the same article. The following example sentence shows the formatting produced by:
 * ... details of cited source ...

which would be used to refer to a fact on page 23 of reference [1]:
 * Apples should be eaten when they are ripe.

This second example sentence shows the formatting produced by:

which would be used as citation for a statement supported by a fact on page 56 of the same reference [1], which will appear only once in the list of references:
 * Porridge, usually eaten for breakfast, can also serve as a dessert.

Use with at



 * A third asserted fact.

This template is for appending page numbers to Help:footnotes. It is an alternative that can be used in articles with one or several sources that must be cited a large number of times, at numerous different pages. It is a method of using Help:shortened footnotes; it does not require the reader to follow two links to see the source.

Translations
The use of "at" may need translations.

With colon
The page number(s) can be a single page number (287), several (xii, 287, 292, 418) or a range (287–88) or any combination thereof. Do not add "Page", "pp.", etc.—just the numbers. It can also be used for non-numeric pages, for example: "f. 29", "A7", and "back cover", etc., and can also be used for non-paginated sources, e.g., "0: 35:12" for a video source.

This template is for appending page numbers to inline reference citations generated by Cite.php. It is a solution for the problem of a source that is cited many times, at numerous different pinpoint page numbers, in the same article. Cite.php's limitations pose two citation problems in such a case:
 * 1) Regular use of   to provide a separate citation for each fact/statement sourced from a different page or page range (as in this example) will result in numerous individual lines, each repeating the entire bibliographic citation of a source, generated by   in the "Notes" or "References" section.
 * 2) Using a single   and followup  's with the same   and simply listing all of the pages cited, would result in the single, very long   entry for this source giving no way for readers to tell which facts were sourced from which pages in the work.

This template works around both of these problems.

Example
The example below shows Rp in use both at a first occurrence [ ], with other references and inline superscript templates present so one can see how it looks when used in series, and at a later [ ] occurrence.

With parentheses
AMA style puts superscripted page numbers inside parenthesis instead of after a colon. For editors who prefer this style, this template has parameters page, pages, and at.

Missing page numbers
If a reference needs a page number but it is missing, use  or. This will automatically use the template to add the article to Category:All articles needing page number citations. For example,  results in:

This is preferable to something like  or , since the cleanup categorization takes place. It is preferable to simply using in articles that make use of, since it preserves the use of the  syntax.

Do not nest the template inside the  template; doing so introduces a stray colon and the displayed results are too small to be legible to many readers. For instance,  results in the undesirable:

With a quote
The template can use the quote or q parameter to show a quote from the source when the mouse hovers over the location identifier. Use of these parameters provides some context for the reference, especially if the reference is to an offline source. This is especially important when using the off-line source to support a fact that might be controversial or is likely to be challenged.

Quotation marks are automatically inserted around the quote, and location identifiers with a quote will display with a dashed underline.

A note on spacing
Where multiple citations occur in series, prevents line breaks between the citations. The zero-width non-joiner (U+200C, code  or  ) can be used to allow a line break, although this is discouraged.

Hyphens
Per MOS:DASH, page ranges should normally be declared with an ndash ( →[ref]) rather than a hyphen. Tools like AWB will automatically convert hyphens to dashes in such instances. If the hyphen is desired for whatever reason, use hyphen ( →[ref]) rather than the  of your keyboard.

TemplateData
{	"description": "This template is used to refer to specific page numbers when citing a source multiple times within the same article. It should be placed immediately after a reference.", "params": { "1": {			"label": "Page numbers", "description": "Write the page number(s) referred to in this reference.", "type": "string", "required": true, "suggested": true },		"needed": { "label": "Request page number" },		"date": { "label": "Page request date" },		"page": { "label": "AMA page number" },		"nopp": { "label": "Hide \"pp\" for AMA?", "type": "unknown" },		"pages": { "label": "AMA pages" },		"at": { "label": "AMA custom text" },		"quote": { "aliases": [ "q" ],			"label": "Quote from source", "type": "string" }	},	"format": "inline" }