Template:Rp/doc

Usage
"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 of course also be used for non-numeric pages, for example "f. 29", "A7", "back cover", etc., and can also be used for non-paginated sources, e.g. "0:35:12" for a video source.

This template (the name of which stands for "reference pages") is for appending Harvard referencing-style page numbers to Cite.php-generated inline reference citations. It is presently the only solution for the problem of an article with a source that must be cited many, many times, at numerous different pages, yet the Cite.php  footnoting system is desired to be used instead of the incredibly tedious and easy-to-break ref label and note label system (tedious and fragile in this context; the templates are not terribly difficult to use and are quite useful in other situations).

The problem of course is that a work cited 100+ times with page numbers in each appearance, with individual 's will result in more than 100 lines generated for the same source by   (or Reflist), while using a single   and followup  's with the same   and simply mentioning all of the pages cited, in the single line generated by   could result in at least 100 pages being specifically cited in a single reference citation footnote, rendering it basically unreadable and certainly useless. Given that Featured Article and sometimes even Good Article review generally insist upon specific facts being cited with specific page numbers, Cite.php's limitations are in fact a severe problem for editors. Even more importantly, either of the two results above is a severe problem for encyclopedia readers.

This template solves this problem (perhaps temporarily, as Cite.php may be upgraded at some future date to account for this problem, in which case a bot can be created to convert Rp instances to the new, improved "Super- ").

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.


 * Code:

...

...

An asserted fact.&#91;clarify&#93;
 * Results:

...

Another asserted fact.

...

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 the appropriate category. 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, or the results are too small to be legible for many readers, and with a stray colon:   results in:

Warning
This template should not be used unless necessary. In the vast majority of cases, citing page numbers in the  code is just fine. This template is only intended for sources that are used many, many times in the same article, to such an extent that normal citation would produce a useless line in  or too many individual ones. Overuse of this template will make prose harder to read, and is likely to be reverted by other editors. Used judiciously, however, it is much less interruptive to the visual flow than full Harvard referencing and some other reference citation styles.