View source for Template:Rp/doc

{{Hatnote|[[Template:Refpage]] and [[Template:Refpages]] redirect here.}}
{{Documentation subpage}}
{{High-use}}
<!----PLEASE ADD CATEGORIES WHERE INDICATED AT THE BOTTOM OF THIS PAGE---->
<!--{{Notice|This template may soon be obsolete and deprecated: [[m:WMDE Technical Wishes/Book referencing]] would make it unnecessary. This expansion of MediaWiki's built-in {{xtag|ref|s}} syntax is already working at some wikis, but has not yet been implemented at English Wikipedia, {{as of|2020|08|lc=y|post=.}}}}-->
"Rp" stands for "reference page(s)".  This is a relatively uncommon method of citing page numbers, usually used when other methods produce undesirable results. It is used in about one out of every 300 articles at the English Wikipedia.

One of its benefits is that <nowiki>{{rp}}</nowiki> is supported in the VisualEditor ([[Wikipedia:VisualEditor|VE]]), unlike {{tl|sfn}}, etc., which {{as of|2021|01|lc=y}} are unsupported in the VE.

== 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:
: <code><nowiki><ref name="aardvark"></nowiki></code>... details of cited source ...<code><nowiki></ref>{{rp|23}}</nowiki></code>
which would be used to refer to a fact on page 23 of reference [1]:
: Apples should be eaten when they are ripe.<ref name="aardvark">Aardvark, A. A. (1999). ''The Best Moments for Eating''. Green Press.</ref>{{rp|23}} 

This second example sentence shows the formatting produced by:
:<code><nowiki><ref name="aardvark" />{{rp|56}}</nowiki></code>
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.<ref name="aardvark" />{{rp|56}}

This template is for appending page numbers to [[WP:FN|notes]]. It is an alternative that can be used in articles with one or several sources that are cited multiple times, at numerous different pages. It is an alternative to the more common method of using [[WP:CITESHORT|shortened footnotes]]; it does not require the reader to follow two links to see the source.

===Notice===
This template should not be used unless necessary.  In the vast majority of cases, citing page numbers in the {{tag|ref}} code is just fine.  This template is only intended for sources that are used {{em|many}} times in the same article, to such an extent that normal citation would produce a useless line in <code>&lt;references /></code> or too many individual ones. 

Overuse of this template is seen by some editors as making prose harder to read. Used judiciously, however, other editors say that it&nbsp;is less interruptive to the visual flow than complete implementation of the reference citation styles that inspired it, particularly [[Wikipedia:Harvard referencing|full Harvard referencing]] and [[AMA Manual of Style|AMA style]].

If an article has an established citation style that uses an alternative to this template (e.g. Harvard style or another style using {{tlx|sfn}} shortened footnote templates), then {{em|do not}} unilaterally start using this template in the article.  Instead, you should discuss options for citation styles with other editors and try to reach a consensus, per [[WP:CITEVAR]].

== How to use ==

===With colon===
{{tlx|rp|page number(s)}}

The <code>page number(s)</code> can be a single page number (287), several (xii, 287, 292, 418) or a range (287–288) 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 [[WP:FN|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 Wikipedia article.  Cite.php's limitations pose two citation problems in such a case:
# Regular use of <code><nowiki>&lt;ref&nbsp;...>...&lt;/ref></nowiki></code> to provide a separate citation for each fact/statement sourced from a different page or page range (as in [https://en.wikipedia.org/w/index.php?title=Delaware_Basin&oldid=328167809#References this example]) will result in numerous individual lines, each repeating the entire bibliographic citation of a source, generated by <code><nowiki>&lt;references&nbsp;/></nowiki></code> in the "Notes" or "References" section. 
# Using a single <code><nowiki>&lt;ref&nbsp;...>...&lt;/ref></nowiki></code> and followup <code><nowiki>&lt;ref&nbsp;...&nbsp;/></nowiki></code>'s with the same <code>name=</code> and simply listing all of the pages cited, would result in the single, very long <code><nowiki>&lt;references&nbsp;/></nowiki></code> 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.  Doing so is important, because [[WP:FA|Featured Article]] as well as [[WP:GA|Good Article]] reviews generally insist upon specific facts being cited with specific page numbers.

{{tnull|Rp}} is an alternative to the more common method of using [[WP:CITESHORT|shortened footnotes]], that does not require the reader to follow two links to see the source. In cases of numerous citations to the same source, the Cite.php <code><nowiki><ref&nbsp;...></nowiki></code> footnoting system is less tedious to use and more difficult to break with incorrect formatting than the {{tl|ref label}} and {{tl|note label}} system (although, in other situations, those templates are not particularly difficult and may be quite useful). 

{{tnull|Rp}} may end up being a temporary solution to these problems, as Cite.php may be upgraded to resolve these issues, in which case a bot would be able to convert {{tnull|Rp}} to the new code.

====Example====
The example below shows {{tnull|Rp}} in use both at a first occurrence [<code><nowiki><ref&nbsp;...>...</ref></nowiki></code>], with other references and inline superscript templates present so one can see how it looks when used in series, and at a later [<code><nowiki><ref&nbsp;...&nbsp;/></nowiki></code>] occurrence.

{{Aligned table
 |class=wikitable
 |col1style=width:5.0em;background:whitesmoke;vertical-align:middle;text-align:center;font-weight:bold;
 |col2style=padding-left:0.5em;padding-right:0.5em;
<!------------------------------(80 characters)-------------------------------->
 | Code
 | <pre>
An asserted fact.{{Clarifyme|date=August 2014}}<ref name="Jackson 1999">{{cite 
book |author-last=Jackson |author-first=Jennifer |title=The Unlightable Being of Bareness 
|publisher=Funky Publications |location=[[San Francisco]] |date=1999 
|isbn=1-2345-6789-0}}</ref>{{rp|233&ndash;237}}<ref name="Smith 2000">{{cite book 
|author-last=Smith |author-first=Bob |title=Another Source |publisher=Another Publisher 
|location=[[Chicago, IL]] |date=2000 |isbn=0-0986-5432-1 |page=27}}</ref><ref 
name="NYT20060120">{{cite news |url=http://url.goes.here.tld/ |title=Some 
Article |author-last=Jones |author-first=Bill |work=The New York Times |page=S4, "Style" section 
|date=2006-01-20 |access-date=2007-03-17}}</ref>

[...]

Another asserted fact.<ref name="Jackson 1999" />{{rp|27, 422}}
</pre>

 | Result
 |
An asserted fact.{{Clarifyme|date=August 2014}}<ref name="Jackson 1999">{{cite book |author-last=Jackson |author-first=Jennifer |title=The Unlightable Being of Bareness |publisher=Funky Publications |location=[[San Francisco]] |date=1999 |isbn=((1-2345-6789-0)) |no-tracking=yes}}</ref>{{rp|233&ndash;237}}<ref name="Smith 2000">{{cite book |author-last=Smith |author-first=Bob |title=Another Source |publisher=Another Publisher |location=[[Chicago, IL]] |date=2000 |isbn=((0-0986-5432-1)) |no-tracking=yes |page=27}}</ref><ref name="NYT20060120">{{cite news |url=http://url.goes.here.tld/ |title=Some Article |author-last=Jones |author-first=Bill |work=The New York Times |page=S4, "Style" section |date=2006-01-20 |access-date=2007-03-17}}</ref>

[...]

Another asserted fact.<ref name="Jackson 1999" />{{rp|27, 422}}

}}<!--(end Aligned table)-->

;Example page:
*{{sectionlink|Liouville number|Liouville numbers and measure}}

===With parentheses===
AMA style puts superscripted page numbers inside parentheses instead of after a colon.  For editors who prefer this style, this template has parameter {{para|style|ama}}.

{{Aligned table
 |class=wikitable
 |col1style=width:5.0em;background:whitesmoke;vertical-align:middle;text-align:center;font-weight:bold;
 |col2style=padding-left:0.5em;padding-right:0.5em;
<!------------------------------(80 characters)-------------------------------->
 | Code
 | <pre>
An asserted fact.<ref name="Jackson 1999">{{cite book |author-last=Jackson 
|author-first=Jennifer |title=The Unlightable Being of Bareness |publisher=Funky 
Publications |publication-place=[[San Francisco]] |date=1999 |isbn=1-2345-6789-0}}
</ref>{{rp|page=148|style=ama}}

[...]

Another asserted fact.<ref name="Jackson 1999" />{{rp|pages=233&ndash;237|style=ama}}

[...]

A third asserted fact.<ref name="Jackson 1999" />{{rp|at=dust jacket|style=ama}}
</pre>

 | Result
 |
An asserted fact.<ref name="Jackson 1999" /><!--(this ref already defined in previous section)-->{{rp|page=148|style=ama}}

[...]

Another asserted fact.<ref name="Jackson 1999" />{{rp|pages=233&ndash;237|style=ama}}

[...]

A third asserted fact.<ref name="Jackson 1999" />{{rp|at=dust jacket|style=ama}}

}}<!--(end Aligned table)-->

===Missing page numbers===
If a reference needs a page number but it is missing, use <code>{{tlx|rp|needed&#61;y|<nowiki>{{subst:DATE}}</nowiki>}}</code> or <code>{{tlx|rp|needed&#61;y|date&#61;{{CURRENTMONTHNAME}} {{CURRENTYEAR}}}}</code>. This will automatically use the {{tlx|page needed}} template to add the article to [[:Category:Wikipedia articles needing page number citations|the appropriate category]]. For example, <code><nowiki><ref name="Jackson 1999" /></nowiki>{{tlp|rp|needed{{=}}y|date{{=}}November 2012}}</code> results in: <ref name="Jackson 1999" /><!--(this ref already defined in previous section)-->{{fix|link=Wikipedia:Citing sources|text=page&nbsp;needed}}

This is preferable to something like <code>{{tlx|rp|page number?}}</code> or <code>{{tlx|rp|?}}</code>, since the cleanup categorization takes place. It is preferable to simply using {{tlx|page needed}} in articles that make use of {{tlx|rp}}, since it preserves the use of the {{tlx|rp}} syntax.

Do not nest the {{tlx|page needed}} template inside the {{tlx|rp}} template; doing so introduces a stray colon and the displayed results are too small to be legible to many readers. For instance, <code><nowiki><ref name="Jackson 1999" /></nowiki>{{tlp|rp|{{tlp|page needed|date{{=}}November 2012}}}}</code> results in the undesirable: <ref name="Jackson 1999" />{{rp|{{fix|link=Wikipedia:Citing sources|text=page&nbsp;needed}}}}

===With a quote===
The template can use the {{para|quote}} or {{para|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 [[WP:offline source|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 <span style="border-bottom: 1px dashed;" title="dashed underline">dashed underline</span>.

{{Aligned table
 |class=wikitable
 |col1style=width:5.0em;background:whitesmoke;vertical-align:middle;text-align:center;font-weight:bold;
 |col2style=padding-left:0.5em;padding-right:0.5em;
<!------------------------------(80 characters)-------------------------------->
 | Code
 | <pre>
An asserted fact.<ref name="Jackson 1999" />{{rp|27, 422|quote=This is a fact.}}

[...]

Another asserted fact.<ref name="Jackson 1999" />{{rp|pages=233&ndash;237|q=This is also a fact.}}

[...]

A third asserted fact.<ref name="Jackson 1999" />{{rp|at=dust jacket|q=This too is a fact.}}
</pre>

 | Result
 |
An asserted fact.<ref name="Jackson 1999" /><!--(this ref already defined in previous section)-->{{rp|422|quote=This is a fact.}}

[...]

Another asserted fact.<ref name="Jackson 1999" />{{rp|pages=233&ndash;237|q=This is also a fact.}}

[...]

A third asserted fact.<ref name="Jackson 1999" />{{rp|at=dust jacket|q=This too is a fact.}}

}}<!--(end Aligned table)-->

===Spacing===
Where multiple citations occur in series, {{tl|rp}} prevents line breaks between the citations. In this case, {{para|wrap|yes}} can be used to allow a line break. Alternatively, if line breaks should be allowed also inside a long page / location information, {{para|wrap|forced}} can be used instead (however, if this actually results in line breaks also depends on the browser, CSS and the skin selected).

===Hyphens===
Per [[MOS:DASH#In ranges that might otherwise be expressed with to or through|MOS:DASH]], page ranges should normally be declared with an [[ndash]] (<code><nowiki>{{rp|pages=27&amp;ndash;29}}</nowiki></code>→<sup>[ref]</sup>{{rp|pages=27&ndash;29}}) rather than a hyphen. Tools like [[WP:AWB]] will automatically convert hyphens to dashes in such instances. For the plural page parameters {{para|pages}}, {{para|pp}} and {{para|quote-pages}} and aliases, {{tl|rp}} will automatically translate hyphens into ndashes for display purposes. (This does not apply to the singular and other in-source-location parameters {{para|page}}, {{para|p}}, {{para|at}}, {{para|loc}}, {{para|quote-page}} and aliases.) If the hyphen is actually desired for whatever reason, the "[[Help:Citation_Style_1#Accept-this-as-written_markup|accept-this-as-written-markup]]" (which is also supported by {{tl|ran}}, {{tl|r}} and all [[Help:CS1|CS1/CS2]] citation templates) can be used to indicate this (<code><nowiki>{{rp|pages=((27-29)), 41}}</nowiki></code>→<sup>[ref]</sup>{{rp|pages=((27-29)), 41}}).

== TemplateData ==
{{TemplateData header}}
<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 number(s)",
			"description": "Write the page number(s) referred to in this reference. Do not add 'Page', 'p.', 'pp.', etc.; just the number(s).",
			"type": "string",
			"required": true,
			"suggested": true,
			"example": "26–27"
		},
		"page": {
			"aliases": [
				"p"
			],
			"label": "Singular page number",
			"type": "string",
			"suggested": true
		},
		"pages": {
			"aliases": [
				"pp"
			],
			"label": "Plural pages",
			"type": "string",
			"suggested": true
		},
		"at": {
			"aliases": [
				"loc"
			],
			"label": "In-source-location",
			"type": "string",
			"suggested": true
		},
		"quote": {
			"aliases": [
				"q",
				"quotation"
			],
			"label": "Quote (in original language) from source",
			"type": "string"
		},
		"quote-page": {
			"aliases": [
				"qp",
				"quotation-page"
			],
			"label": "Singular quote page",
			"description": "Write the page number referred to in the quote (only if different from page). Do not add 'Page', 'p.', 'pp.', etc.; just the number. (Special token 'page'/'p' refers to page.)",
			"type": "string",
			"suggested": true
		},
		"quote-pages": {
			"aliases": [
				"qpp",
				"quotation-pages"
			],
			"label": "Plural quote pages",
			"description": "Write the page numbers referred to in the quote (only if different from pages). Do not add 'Page', 'p.', 'pp.', etc.; just the numbers. (Special token 'pages'/'pp' refers to pages.)",
			"type": "string",
			"suggested": true
		},
		"language": {
			"aliases": [
				"lang",
				"l",
				"quotation-language",
				"quote-language",
				"quotation-lang",
				"quote-lang"
			],
			"label": "Language of quote",
			"description": "Optional language code for quote, if not English.",
			"type": "content"
		},
		"trans-quote": {
			"aliases": [
				"tq",
				"translation",
				"t",
				"translation-quote",
				"translation-quotation",
				"trans-quotation"
			],
			"label": "English translation of a quote",
			"type": "string"
		},
		"no-pp": {
			"aliases": [
				"nopp"
			],
			"label": "Hide \"pp\" for AMA?",
			"type": "unknown"
		},
		"style": {
			"label": "Display control",
			"type": "content",
			"example": "ama, AMA, Ama"
		},
		"wrap": {
			"label": "Wrapping control",
			"type": "content",
			"example": "no, yes, forced, n, y, f"
		},
		"needed": {
			"label": "Request page number"
		},
		"date": {
			"label": "Page request date",
			"type": "content"
		},
		"reason": {
			"label": "Page request reason",
			"type": "string"
		}
	},
	"format": "inline"
}
</templatedata>

== See also ==
* {{tlx|sfn}}, a more common way of citing multiple pages of the same source (described in detail in the "[[WP:CITESHORT|Shortened footnotes]]" section of [[Wikipedia:Citing sources]])
* {{tlx|p.}} and {{tl|pp.}}, which emit "p." (or "pp."), and non-breaking space, then the page number(s): {{p.|2}} produces <code>p.&amp;nbsp;2</code>; {{pp.|2|4}} gives <code>pp.&nbsp;2–4</code>
* {{tlx|r}}, which allows both the reference name and page number to be specified.  {{tlc|r|aardvark|3=p=56}} expands to <code><nowiki><ref name="aardvark"/>{{Rp|56}}</nowiki></code>.
* {{tlx|ran}}, a wrapper for {{tlx|rp}} to work with references manually anchored through {{tlx|rma}} (to control the names of the superscript link labels according to custom naming schemes or sort orders)
* [[Help:References and page numbers]]
* {{section link|Wikipedia:Citing_sources#Citing_multiple_pages_of_the_same_source}}

== References ==
{{Reflist}}

<includeonly>{{Sandbox other||

<!----CATEGORIES BELOW THIS LINE, PLEASE:---->
[[Category:Footnote templates]]
[[Category:Inline templates]]

}}</includeonly>