Template:Rp: Difference between revisions

From Zoophilia Wiki
Jump to navigationJump to search
meta>Graham87
m Usage: sp
meta>Graham87
transclude doc subpage instead of having documentation here
Line 2: Line 2:




==Usage==
<noinclude>
 
{{Documentation}}
{{tlx|rp|page number(s)}}
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS TO THE /doc SUBPAGE, THANKS -->
 
"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.
 
This template (the name of which stands for "reference pages") is for appending [[WP:HARV|Harvard referencing]]-style page numbers to [[WP:FN|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 <code><nowiki><ref ...></nowiki></code> footnoting system is desired to be used instead of the incredibly tedious and easy-to-break {{tl|ref label}} and {{tl|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 <code><nowiki><ref ...></nowiki></code>'s will result in more than 100 lines generated for the same source by <code><nowiki><references /></nowiki></code>, while 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 mentioning all of the pages cited, in the single line generated by <code><nowiki><references /></nowiki></code> 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 [[WP:FA|Featured Article]] and sometimes even [[WP:GA|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 {{tl|Rp}} instances to the new, improved "Super-<code><nowiki><ref ...></nowiki></code>").
 
===Example===
The example below shows {{tl|Rp}} in use both at a first occurrence (<code><nowiki><ref ...>...</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 ... /></nowiki></code>) occurrence.
 
;Code:
<code><nowiki>An asserted fact.{{Clarifyme}}<ref name="Jackson1999">Jackson, Jennifer. ''The Unlightable Being of Bareness'', Funky Publications, [[New York, NY]], 1999, ISBN 1-2345-6789-0</ref>{{rp|233-7}}<ref name="Smith2000">Smith, Bob. ''Another Source'', Another Publisher, [[Chicago, IL]], 2000, ISBN 0-0986-5432-1. Page 27</ref><ref name="NYT20060120">[http://url.goes.here.int/ "Some Article"]. Jones, Bill. ''New York Times'', "Style" section, page S4, [[20 January]] [[2006]]; online edition retrieved [[17 March]] [[2007]]</ref></nowiki></code><br />
<code>...</code><br />
<code><nowiki>Another asserted fact.<ref name="Jackson1999" />{{rp|27, 422}}</nowiki></code><br />
<code>...</code><br />
<code><nowiki><references /></nowiki></code>
 
;Results:
An asserted fact.<sup title="The text in the vicinity of this tag needs clarification or removal of jargon." class="noprint">&#91;[[Wikipedia:Please clarify|''clarify'']]&#93;</sup><ref name="Jackson1999">Jackson, Jennifer. ''The Unlightable Being of Bareness'', Funky Publications, [[New York, NY]], 1999, ISBN 1-2345-6789-0</ref>{{rp|233-7}}<ref name="Smith2000">Smith, Bob. ''Another Source'', Another Publisher, [[Chicago, IL]], 2000, ISBN 0-0986-5432-1. Page 27</ref><ref name="NYT20060120">[http://url.goes.here.int/ "Some Article"]. Jones, Bill. ''New York Times'', "Style" section, page S4, [[20 January]] [[2006]]; online edition retrieved [[17 March]] [[2007]]</ref><br />
...<br />
Another asserted fact.<ref name="Jackson1999" />{{rp|27, 422}}<br />
...<br />
<references />
 
===Warning===
This template should not be used unless necessary.  In the vast majority of cases, citing page numbers in the <code><nowiki><ref ...>...</ref></nowiki></code> 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 <nowiki><references /></nowiki> line or too many individual ones.  Overuse of this template will make prose harder to read, and is likely to be reverted by other editors.
 
[[Category:Citation templates|{{PAGENAME}}]]
[[Category:Inline templates|{{PAGENAME}}]]
</noinclude>
</noinclude>

Revision as of 06:55, 12 January 2008

:{{{1}}}