Tekst źródłowy strony Szablon:Rp/doc

{{Documentation subpage}}
<!--  PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->

==Function==
Use this template when you are referring to specific pages within a cited source many times in the same page.  This example sentence shows the formatting produced by &lt;ref>(details of cited source)&lt;/ref>, which would be used to refer to a fact on page 23 of reference [1].<ref name="example">This reference would detail, for example, a full book.</ref>{{rp|23}}  This second sentence is supported by a fact on page 56 of the same reference, which will only appear once in the list of references.<ref name="example" />{{rp|56}}

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

"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. &ndash; 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 page numbers in Harvard referencing style (or AMA style, as an option &ndash; ''see "[[#With parentheses|With parentheses]]", below'') to Cite.php-generated inline reference citations.  It is a solution for the problem of a page with a source that must be cited many, many times, at numerous different pages. It is an alternative to the more common method of using shortened footnotes, that does not require the reader to follow two links to see the source.  

The problem of course is that a work cited 100+ times with page numbers in each appearance, with individual <code><nowiki><ref&nbsp;...></nowiki></code>'s will result in more than 100 lines generated for the same source by <code><nowiki><references&nbsp;/></nowiki></code> (or {{tl|Reflist}}),<sup>&#91;[[#note1|*note]]&#93;</sup> while using a single <code><nowiki><ref&nbsp;...>...</ref></nowiki></code> and followup <code><nowiki><ref&nbsp;...&nbsp;/></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&nbsp;/></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.

====Example====
The example below shows {{tl|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.

;Code:
<code>An asserted fact.<nowiki><</nowiki>ref name="Jackson1999"><nowiki>{{</nowiki>Cite book<br />
|last=Jackson<br />
|first=Jennifer<br />
|title=The Unlightable Being of Bareness<br />
|publisher=Funky Publications|location=San Francisco, CA<br />
|year=1999<br />
|isbn=1-2345-6789-0<br />
}}<nowiki><</nowiki>/ref><nowiki>{{</nowiki>rp|233&ndash;7}}<nowiki><</nowiki>ref name="Smith2000"><nowiki>{{</nowiki>Cite book<br />
|last=Smith<br />
|first=Bob<br />
|title=Another Source<br />
|publisher=Another Publisher<br />
|location=Chicago, IL<br />
|year=2000<br />
|isbn=0-0986-5432-1<br />
|page=27<br />
}}<nowiki><</nowiki>/ref><nowiki><</nowiki>ref name="NYT20060120"><nowiki>{{</nowiki>Cite news<br />
|url= <nowiki>http://url.goes.here.tld/</nowiki> <br />
|title=Some Article<br />
|last=Jones<br />
|first=Bill<br />
|work=New York Times<br />
|page=S4, "Style" section<br />
|publisher=New York Times Company<br />
|location=New York, NY<br />
|date=January 20, 2006<br />
|accessdate=2007-03-17<br />
}}<nowiki></ref></nowiki></code><br />
...<br />
<code><nowiki>Another asserted fact.<ref name="Jackson1999"&nbsp;/>{{rp|27, 422}}</nowiki></code><br />
...<br />
<code><nowiki>{{Reflist}}</nowiki></code>

;Results:
An asserted fact.<ref name="Jackson1999">{{Cite book|last=Jackson|first=Jennifer|title=The Unlightable Being of Bareness|publisher=Funky Publications|location=San Francisco, CA|year=1999|isbn=1-2345-6789-0}}</ref>{{rp|233&ndash;7}}<ref name="Smith2000">{{Cite book|last=Smith|first=Bob|title=Another Source|publisher=Another Publisher|location=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|last=Jones|first=Bill|work=New York Times|page=S4, "Style" section|publisher=New York Times Company|location=New York, NY|date=January 20, 2006|accessdate=2007-03-17}}</ref><br />
...<br />
Another asserted fact.<ref name="Jackson1999" />{{rp|27, 422}}<br />
...<br />
{{Reflist}}

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

;Code:
<code>An asserted fact.<nowiki><</nowiki>ref name="Jackson1999"><nowiki>{{</nowiki>Cite book<br />
|last=Jackson<br />
|first=Jennifer<br />
|title=The Unlightable Being of Bareness<br />
|publisher=Funky Publications|location=San Francisco, CA<br />
|year=1999<br />
|isbn=1-2345-6789-0<br />
}}<nowiki><</nowiki>/ref><nowiki>{{</nowiki>rp|page=148}}</code><br />
...<br />
<code><nowiki>Another asserted fact.<ref name="Jackson1999"&nbsp;/>{{rp|pages=233&ndash;7}}</nowiki></code><br />
...<br />
<code><nowiki>A third asserted fact.<ref name="Jackson1999"&nbsp;/>{{rp|at=dust jacket}}</nowiki></code><br />
...<br />
<code><nowiki>{{Reflist}}</nowiki></code>

;Results:
An asserted fact.<ref group="a" name="Jackson1999">{{Cite book|last=Jackson|first=Jennifer|title=The Unlightable Being of Bareness|publisher=Funky Publications|location=San Francisco, CA|year=1999|isbn=1-2345-6789-0}}</ref>{{rp|page=148}}<br />
...<br />
Another asserted fact.<ref group="a" name="Jackson1999" />{{rp|pages=233&ndash;7}}<br />
...<br />
A third asserted fact.<ref group="a" name="Jackson1999" />{{rp|at=dust jacket}}<br />
...<br />
{{Reflist|group="a"}}

===Warning===
This template should not be used unless necessary.  In the vast majority of cases, citing page numbers in the <code><nowiki><ref&nbsp;...>...</ref></nowiki></code> code is just fine.  This template is only intended for sources that are used many, many times in the same page, to such an extent that normal citation would produce a useless line in <code><nowiki><references&nbsp;/></nowiki></code> 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.
<includeonly>
<!-- CATEGORIES AND INTERWIKIS HERE, THANKS -->
[[Category:Citation templates|{{PAGENAME}}]]
</includeonly>