Template:Rp/doc: Difference between revisions
| [checked revision] | [checked revision] |
Content deleted Content added
Caleb Cooper (talk | contribs) Created page with "{{Documentation subpage}} {{Hatnote|Template:Rp and Template:Refpages redirect here.}} <!----PLEASE ADD CATEGORIES WHERE INDICATED AT THE BOTTOM OF THIS PAGE---->..." |
Caleb Cooper (talk | contribs) No edit summary |
||
Line 3:
<!----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 unlike {{tl|sfn}}, etc., which are unsupported in the [[Wikipedia:WP:VE|VE]] (at least {{as of|2020|07|lc=y}}), <nowiki>{{rp}}</nowiki> is supported in the [[Wikipedia:WP:VE|VE]].
== Function ==
Line 16:
:Porridge, usually eaten for breakfast, can also serve as a dessert.<ref name="aardvark" />{{rp|56}}
This template is for appending page numbers to [[Wikipedia: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 [[Wikipedia: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><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 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 [[Wikipedia: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 [[Wikipedia:WP:CITEVAR]].
== How to use ==
Line 32:
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 [[Wikipedia: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><ref ...>...</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><references /></nowiki></code> in the "Notes" or "References" section.
# Using a single <code><nowiki><ref ...>...</ref></nowiki></code> and followup <code><nowiki><ref ... /></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><references /></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 [[Wikipedia:WP:FA|Featured Article]] as well as [[Wikipedia: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 [[Wikipedia: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 ...></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.
Line 54:
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=[[Wikipedia:San Francisco]] |year=1999
|isbn=1-2345-6789-0}}</ref>{{rp|233–237}}<ref name="Smith 2000">{{cite book
|author-last=Smith |author-first=Bob |title=Another Source |publisher=Another Publisher
|location=[[Wikipedia:Chicago, IL]] |year=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
| |||