View source for Template:Page needed/doc

{{Documentation subpage|[[Template:Page needed]] and [[Template:Pages needed]]}}
{{COinS safe|n}}
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->
{{Tsh|pn|pages?}}
{{High-use|9,349}}
{{redirect|Template:Page number|the template to add a page number in superscript|Template:Rp}}

This template may be added after an [[WP:INCITE|in-line citation]] that is not precise enough to easily verify the article content associated with it; for example, where a book is cited without a page number. 

==Usage==
{{plainlist|1=
*{{Tlc|Page needed|date{{=}}{{CURRENTMONTHNAME}} {{CURRENTYEAR}}}}
*{{Tlc|Page needed|date{{=}}{{CURRENTMONTHNAME}} {{CURRENTYEAR}}|time{{=}}yes}}
}}

Use of this template categorises articles into [[:Category:Wikipedia articles needing page number citations]] or a dated subcategory thereof (see [[#Tracking categories|below]]).

This template is a [[Wikipedia:Avoid self-references|self-reference]] and therefore part of the Wikipedia project rather than the encyclopædic content.

===Placement===

Put the template directly after the associated {{tag|ref|c}} tag.

=== When to use ===

The {{Tlc|Page needed}} template, and its plural version {{Tlx|Pages needed}}, function as in-line requests for the specific citation of a page number, or numbers, in a cited work such as a book or journal.

In the case of [[audiovisual media]], you may use this template with parameter {{para|time|yes}} to generate the appropriate text; see {{slink||Parameters}}. The use of template {{tl|Cite AV media}} without a timestamp (i.e., missing the {{para|time}} parameter) is an indication that use of this template may be appropriate.

=== When not to use ===

Do not use these tags to label citations to named entries in dictionaries or other alphabetically-arranged works with multiple entries per page, as the entry specified is already more specific than a page number.  Do not use these tags to label statements which you suspect to be false; in this case, use a dispute template instead, such as {{tlx|Dubious}}, or move those statements to the talk page and ask for evidence.

== Parameters ==

There are three named parameters, all optional:
* {{para|date}} – date of placement; a bot will add this later if omitted
* {{para|reason}} – to override the default value shown in the tooltip
* {{para|time|yes}}  – this changes the superscript note to 'timestamp needed' instead of 'page needed' (and also changes the default tooltip reason similarly)

=== Details ===

'''<code>reason</code>''' : Although usually the template is self-explanatory, there are times when it is helpful to provide an extra reason or note to explain the request: 
: <code><nowiki>{{Page needed|reason=</nowiki><var>What the problem is</var><nowiki>}}</nowiki></code> 
This is preferable to using an HTML <code>&lt;!-- comment --&gt;</code> after the tag, as it is tidier to keep all of the {{Tlc|page needed}}-related code inside the template. If the explanation would be lengthy, use the article's talk page.

As well as being visible in the source code for editors' benefit, the <code>reason</code> parameter is, if provided, displayed in many browsers as a tooltip when the mouse is hovered over the "page  needed" link in the article. Long-press to view the tooltip on some mobile devices.

'''<code>time</code>''' : Use only for [[audiovisual media]] that lacks a timestamp. Audio files, video or clips, podcasts, films, and so on may benefit from use of {{para|time|yes}} following a citation like {{tl|Cite AV media}}.

==Example==
{{markup|<nowiki>Some text here.<ref name=Smith2009>{{Cite book |last=Smith |first=Jane |date=2009 |title=The Unbearable Beingness of Light |publisher=Fnord Pubs |location=New York}}</ref>{{Page needed|date=</nowiki>{{CURRENTMONTHNAME}} {{CURRENTYEAR}}<nowiki>}}

...

{{Reflist}}</nowiki>
|Some text here.<ref name="Smith 2009">{{Cite book |last=Smith |first=Jane |date=2009 |title=The Unbearable Beingness of Light |publisher=Fnord Pubs |location=New York}}</ref>{{fix |link=Wikipedia:Citing sources |text=page&nbsp;needed}}

...

{{Reflist}}
}}

==Tracking categories==
* {{clc|Pages using page needed template with unknown parameters}}
* {{clc|Wikipedia articles needing page number citations}}

== Template data ==
{{TemplateDataHeader}}
<templatedata>
{
	"description": "The template functions as in-line request for the page number, or numbers, in a cited work such as a book or journal.",
	"params": {
		"date": {
			"label": "Month and year",
			"description": "Provides the month and year; e.g., 'January 2013', but not 'jan13'",
			"type": "string",
			"autovalue": "{{subst:CURRENTMONTHNAME}} {{subst:CURRENTYEAR}}",
			"suggested": true
		},
		"reason ": {
			"label": "Reason",
			"description": "Additional reason(s) for placing the template",
			"type": "string",
			"required": false
		},
		"time": {
			"label": "Time",
			"description": "Set to 'yes' to emit 'timestamp needed' instead of 'page needed' for AV media",
			"type": "string",
			"required": false
		}
	}
}
</templatedata>

==See also==
* {{Tl|Page numbers needed}} – Non-inline version for when the problem is article- or section-wide
* {{Tl|Rp}} – To supply a referenced page number, for a source cited many times, at different pages numbers, in the same article
* {{Tl|R}} – To define and invoke references with referenced page number, for a source cited many times, at different pages numbers, in the same article
* {{Tl|Volume needed}} – Similar to {{Tlf|Page needed}}, for missing journal, newspaper, comic, etc., volume and issue numbers
* {{Tl|Page range too broad}} – For use when page numbers cited span too many pages to be useful for [[WP:V|verifiability]]
* {{Tl|Incomplete citation}} – For when a reference is missing multiple important pieces of information

{{Inline cleanup tags}}

<includeonly>{{Sandbox other||
<!-- CATEGORIES AND INTERWIKIS HERE, THANKS -->
[[Category:Inline citation cleanup templates]]
}}</includeonly>