Tech, emailconfirmed, Administrators (Semantic MediaWiki), Curators (Semantic MediaWiki), Administrators
12,460
edits
(→With a quote: CE) |
Bongolium500 (talk | contribs) No edit summary |
||
(39 intermediate revisions by 16 users not shown) | |||
Line 1: | Line 1: | ||
{{ | "{{tlx|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 | 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" />{{rp|56}}</nowiki></code> | :<code><nowiki><ref name="aardvark" />{{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 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: | |||
# 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> (or through the equivalent {{tlx|reflist}}) in the "Notes" or "References" section. | |||
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. | # Using a single <code><nowiki><ref ...>...</ref></nowiki></code> and a followup <code><nowiki><ref .../></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><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. | ||
# 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 | |||
# Using a single <code><nowiki><ref ...>...</ref></nowiki></code> and followup <code><nowiki><ref ... | |||
This template works around both of these problems. | |||
{{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. | |||
In most cases, citing page numbers in the ref <code><nowiki><ref ...>...</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. | |||
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 41: | 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 55: | Line 49: | ||
'''Example''' | '''Example''' | ||
The example below shows {{ | The example below shows {{tlx|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. | ||
{ | {| class="wikitable" | ||
! Code | |||
| <pre> | | <pre> | ||
An asserted fact.{{ | 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> | ||
book | | |||
|publisher=Funky Publications | | |||
|isbn= | |||
| | |||
|location= | |||
[...] | [...] | ||
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 | |||
| | | | ||
An asserted fact.{{ | An asserted fact.{{facts}}<ref name="Jackson 1999" />{{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 |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>}} | |||
}}< | |} | ||
;Example page: | ;Example page: | ||
* | *[[wikipedia:Liouville number#Liouville numbers and measure]] | ||
===Display format=== | ===Display format=== | ||
Line 98: | Line 79: | ||
'''Example''' | '''Example''' | ||
{| class="wikitable" | |||
! Code | |||
| <pre> | | <pre> | ||
An asserted fact.<ref name="Jackson 1999">{{cite book | | 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}} | ||
| | |||
Publications | | |||
</ref>{{rp|page=148|style=ama}} | |||
[...] | [...] | ||
Line 119: | 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 | |||
| | | | ||
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 131: | 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>}} | |||
}}< | |} | ||
===Missing page numbers=== | ===Missing page numbers=== | ||
If a reference needs a page number but it is missing, use <code>{{tlx|rp|needed=y|<nowiki>{{subst:DATE}}</nowiki>}}</code> or <code>{{tlx|rp|needed=y|date= | If a reference needs a page number but it is missing, use <code>{{tlx|rp|needed=y|<nowiki>{{subst:DATE}}</nowiki>}}</code> or <code>{{tlx|rp|needed=y|date={{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. | ||
===With a quote=== | ===With a quote=== | ||
Line 146: | 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>. | ||
{ | {| class="wikitable" | ||
! 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 163: | 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 | |||
| | | | ||
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 175: | 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>}} | |||
}}< | |} | ||
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. | ||
===Spacing=== | ===Spacing=== | ||
Where multiple citations occur in series, {{ | 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 | 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&ndash;29}}</nowiki></code>→<sup>[ref]</sup>{{rp|pages=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 {{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> | <templatedata> | ||
{ | { | ||
Line 272: | Line 234: | ||
"type": "string", | "type": "string", | ||
"example": "§3" | "example": "§3" | ||
}, | }, | ||
"no-pp": { | "no-pp": { | ||
Line 335: | Line 269: | ||
== See also == | == See also == | ||
* {{ | * {{Tlx|cite book}}, a template for citing books that this template might be used alongside | ||
<noinclude>[[Category:Template documentation]]</noinclude> |
edits