Template:Reference page/doc: Difference between revisions

From Tardis Wiki, the free Doctor Who reference
(Undid good faith revision 1097093490 by Jason Quinn (talk) to bring in line with recommendation at Help:Footnotes. If the blank is a wrap issue, you can use   as in the "aardvark" example, which should no longer wrap.)
No edit summary
 
(24 intermediate revisions by 13 users not shown)
Line 1: Line 1:
{{Hatnote|[[Template:Refpage]] and [[Template:Refpages]] redirect here.}}
"{{tlx|Rp}}" stands for "reference page(s)".  This is a method of citing page numbers usually used when other methods produce undesirable results.
{{Documentation subpage}}
{{High-use}}
<!----PLEASE ADD CATEGORIES WHERE INDICATED AT THE BOTTOM OF THIS PAGE---->
"Rp" stands for "reference page(s)".  This is a method of citing page numbers usually used when other methods produce undesirable results.


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.
One of its benefits is that {{tlx|Rp}} is supported in the VisualEditor, unlike some other counterparts from Wikipedia, which are unsupported in the VE.


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


This second example sentence shows the formatting produced by:
This second example sentence shows the formatting produced by:
:<code><nowiki><ref name="aardvark"&nbsp;/>{{rp|56}}</nowiki></code>
:<code><nowiki><ref name="aardvark"&nbsp;/>{{rp|p=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:
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}}
:Porridge, usually eaten for breakfast, can also serve as a dessert.<ref name="aardvark" />{{rp|p=56}}
{{Reflist}}


== Intent ==
== Intent ==
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.
This template is for appending page numbers to 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 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:
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/></nowiki></code> (or through the equivalent {{tl|reflist}}) in the "Notes" or "References" section.  
# 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/></nowiki></code> (or through the equivalent {{tlx|reflist}}) 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;.../></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/></nowiki></code> (or {{tl|reflist}}) entry for this source giving no way for readers to tell which facts were sourced from which pages in the work.
# Using a single <code><nowiki>&lt;ref&nbsp;...>...&lt;/ref></nowiki></code> and a followup <code><nowiki>&lt;ref&nbsp;.../></nowiki></code> 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/></nowiki></code> (or {{tlx|reflist}}) 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 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).  
This template works around both of these problems.  


In most cases, citing page numbers in the {{tag|ref}} code is just fine. This template is intended for sources that are used {{em|many}} times in the same article, but with differing page numbers. Even when used to specify individual page numbers in different locations of the article, it is often a good idea to specify the combined list of all page numbers referred to in an article in the core citation as well, as this makes it easier to obtain the source (if [[WP:CS1|CS1]]/[[WP:CS2|CS2]] citation style is used for the core citation, the combined page numbers get also included in the meta-data).
{{tlx|rp}} is an alternative to the method of using [[wikipedia:WP:CITESHORT|shortened footnotes]] that does not require the reader to follow two links to see the source.


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 [[AMA Manual of Style|AMA style]].
In most cases, citing page numbers in the ref <code><nowiki>&lt;ref&nbsp;...>...&lt;/ref></nowiki></code> code is just fine. This template is intended for sources that are used <em>many</em> times in the same article, but with differing page numbers. Even when used to specify individual page numbers in different locations of the article, it is often a good idea to specify the combined list of all page numbers referred to in an article in the core citation as well, as this makes it easier to obtain the source.


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]].
Overuse of this template is can make prose harder to read for some. Used judiciously, however, others find it is less interruptive to the visual flow than complete implementation of the reference citation styles that inspired it, particularly [[wikipedia:Wikipedia:Harvard referencing|full Harvard referencing]] and [[wikipedia:AMA Manual of Style|AMA style]].


== How to use ==
== How to use ==
Line 40: Line 35:
* {{tlx|rp|pages{{=}}''pages''}} or {{tlx|rp|pp{{=}}''pages''}} (for plural ''pages'', including lists and ranges)
* {{tlx|rp|pages{{=}}''pages''}} or {{tlx|rp|pp{{=}}''pages''}} (for plural ''pages'', including lists and ranges)
* {{tlx|rp|at{{=}}''in-source-location''}} (for other ''in-source-location'' info)
* {{tlx|rp|at{{=}}''in-source-location''}} (for other ''in-source-location'' info)
* {{tlx|rp|''page number(s)''}} (not recommended<!-- in particular not for AMA style -->, because without one of the dedicated parameters above the type and [[Grammatical number|numerus]] of the given page information will be ambiguous in some cases and thus the resulting tooltip has to remain somewhat vague)
* {{tlx|rp|''page number(s)''}} (not recommended<!-- in particular not for AMA style -->, because without one of the dedicated parameters above the type and [[wikipedia:Grammatical number|numerus]] of the given page information will be ambiguous in some cases and thus the resulting tooltip has to remain somewhat vague)


The specified page number(s) can be a single page number (287), a list of several pages (xii, 287, 292, 418) or a range of pages (287–288) or any combination thereof. Do not add "Page", "pp.", etc.—just the numbers.
The specified page number(s) can be a single page number (287), a list of several pages (xii, 287, 292, 418) or a range of pages (287–288) or any combination thereof. Do not add "Page", "pp.", etc.—just the numbers.
Line 54: Line 49:
'''Example'''
'''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.
The example below shows {{tlx|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"
|class=wikitable
  ! Code
  |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>
  | <pre>
An asserted fact.{{Clarifyme|date=August 2014}}<ref name="Jackson 1999">{{cite book |last=Jackson |first=Jennifer |date=1999 |title=The Unlightable Being of Bareness |publisher=Funky Publications |location=San Francisco, California, USA |isbn=1-2345-6789-0}}</ref>{{rp|pages=143,233&ndash;237}}<ref name="Smith 2000">{{cite book |last=Smith |first=Bob |date=2000 |title=Another Source |publisher=Another Publisher |location=Chicago, Illinois, USA |isbn=0-0986-5432-1 |page=27}}</ref><ref
An asserted fact.{{facts}}<ref name="Jackson 1999">{{cite book |last=Jackson |first=Jennifer |date=1999 |title=The Unlightable Being of Bareness |publisher=Funky Publications |location=San Francisco, California |isbn=1234567890}}</ref>{{rp|pages=143,233&ndash;237}}<ref>{{cite book |last=Smith |first=Bob |date=2000 |title=Another Source |publisher=Another Publisher |location=Chicago, Illinois |isbn=0098654321 |page=27}}</ref>
name="NYT20060120">{{cite news |last=Jones |first=Bill |date=2006-01-20 |title=Some Article |work=The New York Times |page=S4, "Style" section |url=http://url.goes.here.tld/ |access-date=2007-03-17}}</ref>
 
[...]
[...]


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


[...]
[...]


Another asserted fact.<ref name="Jackson 1999" />{{rp|page=27}} Also important.<ref name="Jackson 1999" />{{rp|at=foldout V}}
Another asserted fact.<ref name="Jackson 1999" />{{rp|page=27}} Also important.<ref name="Jackson 1999" />{{rp|at=foldout V}}
 
{{reflist|refs=<ref name="Jackson 1999">{{cite book |last=Jackson |first=Jennifer |date=1999 |title=The Unlightable Being of Bareness |publisher=Funky Publications |location=San Francisco, California |isbn=1234567890 |no-tracking=yes}}</ref>}}
}}<!--(end Aligned table)-->
|}


;Example page:
;Example page:
*{{sectionlink|Liouville number|Liouville numbers and measure}}
*[[wikipedia:Liouville number#Liouville numbers and measure]]


===Display format===
===Display format===
Line 90: Line 79:


'''Example'''
'''Example'''
 
{| class="wikitable"
{{Aligned table
  ! Code
|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>
  | <pre>
An asserted fact.<ref name="Jackson 1999">{{cite book |last=Jackson |first=Jennifer |date=1999 |title=The Unlightable Being of Bareness |publisher=Funky Publications |location=[[San Francisco]] |isbn=1-2345-6789-0}}</ref>{{rp|page=148|style=ama}}
An asserted fact.<ref name="Jackson 1999" />{{cite book |last=Jackson |first=Jennifer |date=1999 |title=The Unlightable Being of Bareness |publisher=Funky Publications |location=San Francisco, California |isbn=1234567890}}</ref>{{rp|page=148|style=ama}}


[...]
[...]
Line 108: Line 92:
A third asserted fact.<ref name="Jackson 1999" />{{rp|at=dust jacket|style=ama}}
A third asserted fact.<ref name="Jackson 1999" />{{rp|at=dust jacket|style=ama}}
</pre>
</pre>
 
|-
  | Result
  ! Result
  |
  |
An asserted fact.<ref name="Jackson 1999" /><!--(this ref already defined in previous section)-->{{rp|page=148|style=ama}}
An asserted fact.<ref name="Jackson 1999" /><!--(this ref already defined in previous section)-->{{rp|page=148|style=ama}}
Line 120: Line 104:


A third asserted fact.<ref name="Jackson 1999" />{{rp|at=dust jacket|style=ama}}
A third asserted fact.<ref name="Jackson 1999" />{{rp|at=dust jacket|style=ama}}
 
{{reflist|refs=<ref name="Jackson 1999">{{cite book |last=Jackson |first=Jennifer |date=1999 |title=The Unlightable Being of Bareness |publisher=Funky Publications |location=San Francisco, California |isbn=1234567890 |no-tracking=yes}}</ref>}}
}}<!--(end Aligned table)-->
|}


===Missing page numbers===
===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}}
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;{{CURRENTYEAR}}}}</code>. This will automatically use the {{tlx|page needed}} template to add the article to [[:Category:Articles needing page number citations|the appropriate category]]. For example, <code><nowiki><ref name="Jackson 1999" /></nowiki>{{tlx|rp|needed{{=}}y|date{{=}}November 2012}}</code> results in: <ref name="Jackson 1999" /><!--(this ref already defined in previous section)-->


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.
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===
===With a quote===
Line 135: Line 117:
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>.
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"
|class=wikitable
  ! Code
  |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>
  | <pre>
An asserted fact.<ref name="Jackson 1999" />{{rp|422|quote=This is a fact.}}
An asserted fact.<ref name="Jackson 1999" />{{rp|422|quote=This is a fact.}}
Line 152: Line 130:
A third asserted fact.<ref name="Jackson 1999" />{{rp|at=dust jacket|q=This too is a fact.}}
A third asserted fact.<ref name="Jackson 1999" />{{rp|at=dust jacket|q=This too is a fact.}}
</pre>
</pre>
 
|-
  | Result
  ! Result
  |
  |
An asserted fact.<ref name="Jackson 1999" /><!--(this ref already defined in previous section)-->{{rp|422|quote=This is a fact.}}
An asserted fact.<ref name="Jackson 1999" /><!--(this ref already defined in previous section)-->{{rp|422|quote=This is a fact.}}
Line 164: Line 142:


A third asserted fact.<ref name="Jackson 1999" />{{rp|at=dust jacket|q=This too is a fact.}}
A third asserted fact.<ref name="Jackson 1999" />{{rp|at=dust jacket|q=This too is a fact.}}
 
{{reflist|refs=<ref name="Jackson 1999">{{cite book |last=Jackson |first=Jennifer |date=1999 |title=The Unlightable Being of Bareness |publisher=Funky Publications |location=San Francisco, California |isbn=1234567890 |no-tracking=yes}}</ref>}}
}}<!--(end Aligned table)-->
|}
If the in-source-location of the quote is more specific (or different) from the in-source-location specified with the set of {{para|page}}/{{para|pages}}/{{para|at}} parameters for the citation discussed above, you can optionally use the separate set of {{para|quote-page}}/{{para|quote-pages}}/{{para|quote-at}} parameters to specify an in-source-location for the specific quote.
If the in-source-location of the quote is more specific (or different) from the in-source-location specified with the set of {{para|page}}/{{para|pages}}/{{para|at}} parameters for the citation discussed above, you can optionally use the separate set of {{para|quote-page}}/{{para|quote-pages}}/{{para|quote-at}} parameters to specify an in-source-location for the specific quote.
If the quote is not in English, you can optionally use the {{para|language}} parameter (or one of its aliases) to specify the language of the quote. A translation of the quote can be optionally provided through the {{para|translation}} parameter (or one of its aliases).
If it is desirable to have the quotation present in the local tooltip as well as in the full citation, consider switching to use {{tl|r}} with its <code>|annotation=quote&nbsp;|quote=Quotation</code> parameter instead of using {{tl|rp}}.


===Spacing===
===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).
Where multiple citations occur in series, {{tlx|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===
===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}} and {{tl|r}}, the family of {{tl|sfn}}- and {{tl|harv}}-style templates, 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}}).
Per [[wikipedia:MOS:DASH#In ranges that might otherwise be expressed with to or through|wikipedia:MOS:DASH]], page ranges should be declared with an [[wikipedia:ndash|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 [[wikipedia: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 "[[wikipedia:Help:Citation_Style_1#Accept-this-as-written_markup|accept-this-as-written-markup]]" 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 ==
{{TemplateData header}}
<templatedata>
<templatedata>
{
{
Line 261: Line 234:
"type": "string",
"type": "string",
"example": "§3"
"example": "§3"
},
"language": {
"aliases": [
"lang",
"l",
"ql",
"quote-language",
"quotation-language",
"quote-lang",
"quotation-lang"
],
"label": "Language of quote",
"description": "Optional language code or language name for quote, if not English.",
"type": "content",
"example": "de"
},
"translation": {
"aliases": [
"trans",
"t",
"tq",
"translation-quote",
"translation-quotation",
"trans-quotation",
"xlat"
],
"label": "English translation of a quote",
"type": "string"
},
},
"no-pp": {
"no-pp": {
Line 324: Line 269:


== See also ==
== See also ==
* {{tlx|sfn}}, another way of citing multiple pages of the same source (described in detail in the "[[WP:CITESHORT|Shortened footnotes]]" section of [[Wikipedia:Citing sources]])
* {{Tlx|cite book}}, a template for citing books that this template might be used alongside
* {{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>
<noinclude>[[Category:Template documentation]]</noinclude>

Latest revision as of 21:01, 13 August 2024

"{{Rp}}" stands for "reference page(s)". This is a method of citing page numbers usually used when other methods produce undesirable results.

One of its benefits is that {{Rp}} is supported in the VisualEditor, unlike some other counterparts from Wikipedia, which are unsupported in the VE.

Function[[edit source]]

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:

<ref name="aardvark">... details of cited source ...</ref>{{rp|p=23}}

which would be used to refer to a fact on page 23 of reference [1]:

Apples should be eaten when they are ripe.[1]: 23 

This second example sentence shows the formatting produced by:

<ref name="aardvark" />{{rp|p=56}}

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.[1]: 56 
  1. ↑ 1.0 1.1 Aardvark, A. A. (1999). The Best Moments for Eating. Green Press.

Intent[[edit source]]

This template is for appending page numbers to 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 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:

  1. Regular use of <ref ...>...</ref> to provide a separate citation for each fact/statement sourced from a different page or page range (as in this example) will result in numerous individual lines, each repeating the entire bibliographic citation of a source, generated by <references/> (or through the equivalent {{reflist}}) in the "Notes" or "References" section.
  2. Using a single <ref ...>...</ref> and a followup <ref .../> with the same name= and simply listing all of the pages cited would result in the single, very long <references/> (or {{reflist}}) 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.

{{rp}} is an alternative to the method of using shortened footnotes that does not require the reader to follow two links to see the source.

In most cases, citing page numbers in the ref <ref ...>...</ref> code is just fine. This template is intended for sources that are used many times in the same article, but with differing page numbers. Even when used to specify individual page numbers in different locations of the article, it is often a good idea to specify the combined list of all page numbers referred to in an article in the core citation as well, as this makes it easier to obtain the source.

Overuse of this template is can make prose harder to read for some. Used judiciously, however, others find it is less interruptive to the visual flow than complete implementation of the reference citation styles that inspired it, particularly full Harvard referencing and AMA style.

How to use[[edit source]]

Calling syntax[[edit source]]

  • {{rp|page=page}} or {{rp|p=page}} (for a singular page)
  • {{rp|pages=pages}} or {{rp|pp=pages}} (for plural pages, including lists and ranges)
  • {{rp|at=in-source-location}} (for other in-source-location info)
  • {{rp|page number(s)}} (not recommended, because without one of the dedicated parameters above the type and numerus of the given page information will be ambiguous in some cases and thus the resulting tooltip has to remain somewhat vague)

The specified page number(s) can be a single page number (287), a list of several pages (xii, 287, 292, 418) or a range of pages (287–288) or any combination thereof. Do not add "Page", "pp.", etc.—just the numbers.

Other in-source-location information 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.

Choose one of the template parameters above according to the type of page or in-source-location specified.

While typically only one of these three types of parameters is given, it is also possible to combine them to suit more special use cases. If both, singular and plural page parameters are given at the same time, the plural page info is assumed to be the span of the article, whereas the singular page info is considered to be the page within that span supporting the statement. The template will indicate this by framing the singular page in square brackets following the plural page info. If an in-source-location is given in addition to the page info, the template assumes it to further detail the preceding page info rather than representing some kind of stand-alone in-source location info.

Do not attempt to use multiple aliases of a parameter at the same time. Only one will be chosen and the others may be ignored without error message.

Example

The example below shows {{rp}} in use both at a first occurrence [<ref ...>...</ref>], with other references and inline superscript templates present so one can see how it looks when used in series, and at a later [<ref ... />] occurrence.

Code 
An asserted fact.{{facts}}<ref name="Jackson 1999">{{cite book |last=Jackson |first=Jennifer |date=1999 |title=The Unlightable Being of Bareness |publisher=Funky Publications |location=San Francisco, California |isbn=1234567890}}</ref>{{rp|pages=143,233–237}}<ref>{{cite book |last=Smith |first=Bob |date=2000 |title=Another Source |publisher=Another Publisher |location=Chicago, Illinois |isbn=0098654321 |page=27}}</ref>
[...]

Another asserted fact.<ref name="Jackson 1999" />{{rp|page=27}} Also important.<ref name="Jackson 1999" />{{rp|at=foldout V}}
Result

An asserted fact.[additional sources needed][1]: 143, 233–237 [2]

[...]

Another asserted fact.[1]: 27  Also important.[1]: foldout V 

  1. ↑ 1.0 1.1 1.2 Jackson, Jennifer (1999). The Unlightable Being of Bareness. Funky Publications. ISBN 1234567890
  2. ↑ Smith, Bob (2000). Another Source p. 27. Another Publisher. ISBN 0098654321
Example page

Display format[[edit source]]

The default display format for the superscript is a colon prefix (:).

Alternatively, AMA style puts superscripted page numbers inside parentheses instead of after a colon. This style can be selected by adding the template parameter |style=ama. In cases, where the p/pp prefix should not be displayed, it can be suppressed using |no-pp=yes

Example

Code 
An asserted fact.<ref name="Jackson 1999" />{{cite book |last=Jackson |first=Jennifer |date=1999 |title=The Unlightable Being of Bareness |publisher=Funky Publications |location=San Francisco, California |isbn=1234567890}}</ref>{{rp|page=148|style=ama}}

[...]

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

[...]

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

An asserted fact.[1](p148)

[...]

Another asserted fact.[1](pp233–237)

[...]

A third asserted fact.[1](dust jacket)

  1. ↑ 1.0 1.1 1.2 Jackson, Jennifer (1999). The Unlightable Being of Bareness. Funky Publications. ISBN 1234567890

Missing page numbers[[edit source]]

If a reference needs a page number but it is missing, use {{rp|needed=y|{{subst:DATE}}}} or {{rp|needed=y|date=2024}}. This will automatically use the {{page needed}} template to add the article to the appropriate category. For example, <ref name="Jackson 1999" />{{rp|needed=y|date=November 2012}} results in: [1]

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

With a quote[[edit source]]

The template can use the |quote= or |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 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 dashed underline.

Code 
An asserted fact.<ref name="Jackson 1999" />{{rp|422|quote=This is a fact.}}

[...]

Another asserted fact.<ref name="Jackson 1999" />{{rp|pages=233–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.}}
Result

An asserted fact.[1]: 422 

[...]

Another asserted fact.[1]: 233–237 

[...]

A third asserted fact.[1]: dust jacket 

  1. ↑ 1.0 1.1 1.2 1.3 Jackson, Jennifer (1999). The Unlightable Being of Bareness. Funky Publications. ISBN 1234567890

If the in-source-location of the quote is more specific (or different) from the in-source-location specified with the set of |page=/|pages=/|at= parameters for the citation discussed above, you can optionally use the separate set of |quote-page=/|quote-pages=/|quote-at= parameters to specify an in-source-location for the specific quote.

Spacing[[edit source]]

Where multiple citations occur in series, {{rp}} prevents line breaks between the citations. In this case, |wrap=yes can be used to allow a line break. Alternatively, if line breaks should be allowed also inside a long page / location information, |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[[edit source]]

Per wikipedia:MOS:DASH, page ranges should be declared with an ndash ({{rp|pages=27&ndash;29}}→[ref]: 27–29 ) rather than a hyphen. Tools like wikipedia:WP:AWB will automatically convert hyphens to dashes in such instances. For the plural page parameters |pages=, |pp= and |quote-pages= and aliases, {{rp}} will automatically translate hyphens into ndashes for display purposes. (This does not apply to the singular and other in-source-location parameters |page=, |p=, |at=, |loc=, |quote-page= and aliases.) If the hyphen is actually desired for whatever reason, the "accept-this-as-written-markup" can be used to indicate this ({{rp|pages=((27-29, 41))}}→[ref]: 27-29, 41 ).

TemplateData[[edit source]]

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.

Template parameters

This template prefers inline formatting of parameters.

ParameterDescriptionTypeStatus
Page number(s)1

Write the page number(s) referred to in this reference. Do not add 'Page', 'p.', 'pp.', etc.; just the number(s). (This parameter is supported for backward compatibility, but if the numerus is known, use one of the more specific parameters 'page'/'p', 'pages'/'pp', 'location'/'at' instead to eliminate any potential ambiguity and improve the tooltip.)

Example
26–27
Stringdeprecated
Singular page numberpage p

If the page number referred to in this reference is singular, specify the single page number using this parameter. Do not add 'Page', 'p.', etc.; just the number.

Example
26
Stringsuggested
Plural pagespages pp

If there are multiple page numbers referred to in this reference, specify them using this parameter. Do not add 'Pages', 'pp.', etc.; just the numbers.

Example
26–27
Stringsuggested
In-source-locationlocation loc at

Specify the in-source-location referred to in this reference, if it is not a normal page or number of pages.

Example
sheet 3
Stringsuggested
Quote (in original language) from sourcequote q quotation

no description

Stringoptional
Singular quote pagequote-page qp quotation-page

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.)

Example
26
Stringoptional
Plural quote pagesquote-pages qpp quotation-pages

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.)

Example
26–27
Stringoptional
Quote locationquote-location quote-loc quote-at quotation-location

Write the in-source-location referred to in the quote (only if different from pages). Do not add 'Page', 'p.', 'pp.', etc.; (Special token 'pages'/'pp'/'page'/'p' refers to pages.)

Example
§3
Stringoptional
Hide "pp" for AMA?no-pp nopp

no description

Unknownoptional
Display controlstyle

no description

Example
ama, AMA, Ama
Contentoptional
Wrapping controlwrap

no description

Example
no, yes, forced, n, y, f
Contentoptional
Request page numberneeded

no description

Unknownoptional
Page request datedate

no description

Contentoptional
Page request reasonreason

no description

Stringoptional

See also[[edit source]]

  • {{cite book}}, a template for citing books that this template might be used alongside
Retrieved from "https://tardis.wiki/w/index.php?title=Template:Reference_page/doc&oldid=3835490"