Template:Primary sources/doc: Difference between revisions

Safer nicotine wiki Tobacco Harm Reduction
Jump to navigation Jump to search
When to use: Use italic not bold for emphasis
 
imported>Mignof
When to Use: mention and link to {{Template:Self-published}}
 
(One intermediate revision by one other user not shown)
Line 1: Line 1:
{{Documentation subpage}}
{{Documentation subpage}}
{{Redirect|Template:Primary source|the template that tags inline statements|Template:Primary source inline}}
{{Redirect|Template:Primary source|the template that tags inline statements|Template:Primary source inline}}
{{High-use}}
{{Twinkle standard installation}}
{{Twinkle standard installation}}


{{Tlx|Primary sources|date{{=}}{{CURRENTMONTHNAME}} {{CURRENTYEAR}}}}
Use this template to tag information or analysis that you believe is improperly or unnecessarily supported by a primary source, so that other editors can see whether this use is appropriate or replace it with a citation to a secondary source.


* This template will categorize tagged articles into [[:Category:Articles lacking reliable references]].
== Usage ==
* There is currently no consensus on where on the article to place templates such as this.
 
* {{tlc|Primary sources|date{{=}}{{CURRENTMONTHNAME}} {{CURRENTYEAR}}}} for entire articles
* {{Tlc|Primary sources|section|date{{=}}{{CURRENTMONTHNAME}} {{CURRENTYEAR}}}} for sections
 
[[Help:Substitution|Substitution]] of this template will automatically fill the date parameter.
* {{tlc|subst:Primary sources}}
 
Optional find parameters are available, for modifying the operation of the {{tl|find sources}} links displayed by the template:
* {{tlc|Primary sources|find{{=}}double-quoted search keyword(s)|find2{{=}}unquoted keywords|date{{=}}{{CURRENTMONTHNAME}} {{CURRENTYEAR}}}}
 
This template will categorize tagged articles into [[:Category:Articles lacking reliable references]].
 
There is currently no consensus on where in the article to place templates such as this.


==When to use==
==When to use==
Use this template to "tag" information or analysis that you believe is improperly or unnecessarily supported by a primary source, so that other editors can see whether this use is appropriate or replace it with a citation to a secondary source. There is no need to do so. [[Wikipedia:Identifying and using primary and secondary sources|Primary sources may be used on Wikipedia, but they need to be handled with care.]]


[[Wikipedia:Secondary does not mean independent|''"Primary source" does not mean that the author is too closely affiliated with the subject.'']] As a general rule, primary sources include all scientific journal articles about experiments, as well as news reports and other documents dating from around the time of an event. To tag an article as lacking [[Wikipedia:Independent source|independent reliable sources]], use the template {{tlx|third-party}} instead.
The presence of [[WP:PRIMARY|primary sources]] in an article doesn't mean the article must be tagged.
[[Wikipedia:Identifying and using primary sources|Primary sources may be used on Wikipedia]], but they need to be handled with care.
 
Whether a source is '''[[Wikipedia:Independent sources|independent]]''' is a different concept from whether it is a '''primary source'''. To tag an article as lacking sufficient [[Wikipedia:independent sources|independent sources]], use instead the templates {{tlx|third-party}} or, in the case those sources are published directly by the person/organization itself, {{tlx|self-published}}.


== How to use ==
== Parameters ==
This template also has several optional fields.


If you pass in an unnamed parameter, it specifies which part of the article inappropriately relies solely on primary sources. By default, the entire article needs third-party sources, i.e. it's equivalent to:
There are five parameters, one positional, and four named parameters. All parameters are optional.  


: {{tlc|Primary sources|article}}
* {{para|1}}{{snd}}scope of notification (e.g., 'paragraph', 'section', 'article', etc.) default: 'article'. ''see [[#Details|Details]].''
* {{para|date}}{{snd}}month name and year; e.g. '{{CURRENTMONTHNAME}} {{CURRENTYEAR}}' (no default)
* {{para|talk}}{{snd}}section or fullpage id of discussion
* {{para|find}}{{snd}}search keywords for {{tl|find sources}} param 1 (double-quoted search); default: page title. See details [[#Details|below]].
* {{para|find2}}{{snd}}search keywords for {{tl|find sources}} param 2 (unquoted search). Alias: <code>unquoted</code>. See [[#Details|below]].


To tag a specific section use:
=== Details ===


: {{tlc|Primary sources|section}}
'''Positional parameter 1'''
: Positional parameter {{para|1}} is the 'type' parameter, which may be set to ''paragraph'' or ''section'' or any string value.


If you pass in a {{para|date}} parameter (<var>month year</var>), it sorts the article into subcategories of [[:Category:Articles lacking reliable references]] and out of the parent category. This in turn allows the oldest problems to be identified and dealt with first. If the date parameter is omitted, a [[WP:BOT|bot]] will add it later.
'''Date parameter:'''
: The {{para|date}} parameter is (generally<ref name="date">Because of the nature of the workflow using the current date makes sense, it is simpler to add, especially for the [[WP:bot]]s it means that older dated categories do not have to be constantly created and deleted, and it enables some measure of progress. Moreover it is "good enough" to get the articles into the workflow and the intention is to ensure they are cleaned up eventually. Occasionally however it may be useful to bulk add items, to older categories, for example when the system was initially set up, when merging two schemes or when adding to the current month would swamp it disproportionately.</ref>) used to indicate when the template was added to a page. An example of its usage is {{tlc|Primary sources|date{{=}}{{CURRENTMONTHNAME}} {{CURRENTYEAR}}}}. Adding this parameter sorts the article into monthly subcategories of [[:Category:Articles lacking sources]], rather than adding it to the category itself, allowing the oldest problems to be identified and dealt with first. If the date parameter is omitted, a [[Wikipedia:Bot policy|bot]] will add it later.


You can use {{para|talk}} to specify a section header on the talk page.
'''Find parameters:'''
: There are two 'find' parameters available to control the presentation and operation of the {{tl|find sources}} links optionally displayed by the {{tl|Primary sources}} template. By default, the template displays {{tl|find sources}} with a quoted search query equivalent to the exact article title. Sometimes, especially if the article has a long, [[WP:NDESC|descriptive title]], or if it includes [[WP:PARENDIS|parenthetical disambiguation terms]], this may not give useful results. The find parameters can be used to provide the search keywords of your choice to the {{tl|find sources}} links. Use:
:* {{para|find}} to specify keywords for an exact search (double-quoted query); this corresponds to {{tl|find sources}} positional param <code>|1</code>.
:* {{para|find2}} to specify keywords for an unquoted search; this corresponds to {{tl|find sources}} param <code>|2</code>. The alias {{para|unquoted}} may be used instead. Note that booleans, exclusion terms (preceded by minus sign) and other search operators may be used in unquoted search ({{para|find2}}) if valid for the search domains:
:: {{tlc|Primary sources|find{{=}}John Adams|find2{{=}}president -Quincy}} ⟶ (see [[#Examples|Examples]] below)
:* Param {{para|find}} may take the special value {{pval|none}} in order to suppress display of ''find sources'' links. (Note that specifying {{para|find|none}} and a nonempty value for {{para|find2}} is not a valid combination.)


If you use {{tl|BLP primary sources}} (which is a wrapper for {{tl|Primary sources}} with the <code><nowiki>BLP=yes</nowiki></code> parameter), it indicates that the article is a [[WP:BLP|biography of a living person]], and also sorts the article into subcategories of [[:Category:BLP articles lacking sources]]. This serves to indicate a problem with the [[WP:BLPSPS|policy on self-published sources in biographies of living persons]].
== Wrappers ==


Note that order does not matter with respect to the above optional parameters. Both <code><nowiki>{{Primary sources|section|date=</nowiki>{{CURRENTMONTHNAME}} {{CURRENTYEAR}}}}</code> and <code><nowiki>{{Primary sources|date=</nowiki>{{CURRENTMONTHNAME}} {{CURRENTYEAR}}|section}}</code> will produce the same result.
To tag an individual section instead of the whole article, you can use {{tlx|Primary sources section}} template.
 
If you use template {{tl|BLP primary sources}}, it indicates that the article is a [[WP:BLP|biography of a living person]], and also sorts the article into subcategories of [[:Category:BLP articles lacking sources]]. This serves to indicate a problem with the [[WP:BLPSPS|policy on self-published sources in biographies of living persons]].


==Examples==
==Examples==
:{{tlc|primary sources|2=date={{CURRENTMONTHNAME}} {{CURRENTYEAR}}}}
:{{tlc|primary sources|2=date={{CURRENTMONTHNAME}} {{CURRENTYEAR}}}}
{{primary sources|date={{CURRENTMONTHNAME}} {{CURRENTYEAR}}}}
{{primary sources|date={{CURRENTMONTHNAME}} {{CURRENTYEAR}}}}
Exclusion term in unquoted search:
: {{tlc|Primary sources|find{{=}}John Adams|find2{{=}}president -Quincy}} ⟶ {{Primary sources|find=John Adams|find2=president -Quincy}}


For Biographies of Living Persons:
For Biographies of Living Persons:
Line 54: Line 84:
== See also ==
== See also ==
* Primary source templates:
* Primary source templates:
** {{tl|Primary sources section}}
** {{tl|BLP primary sources}}
** {{tl|Only primary sources}}
** {{tl|Primary source inline}} – inline with text, to object to the inappropriate use of a [[WP:Party and person|primary source]] (regardless of whether the primary source is [[WP:Independent sources|independent of the subject]])
** {{tl|Primary source inline}} – inline with text, to object to the inappropriate use of a [[WP:Party and person|primary source]] (regardless of whether the primary source is [[WP:Independent sources|independent of the subject]])
* Third-party source templates:
* Third-party source templates:
Line 62: Line 95:
* [[Wikipedia:Template messages/Cleanup]]
* [[Wikipedia:Template messages/Cleanup]]
* [[Wikipedia:Template messages/Sources of articles]]
* [[Wikipedia:Template messages/Sources of articles]]
==Notes==
{{reflist}}


==TemplateData==
==TemplateData==
Line 67: Line 103:
<templatedata>
<templatedata>
{
{
"description": "Use this template to _tag_ information or analysis that you believe is improperly or unnecessarily supported by a primary source, so that other editors can see whether this use is appropriate and/or replace it with a citation to a stronger, secondary source. Primary sources may be used on Wikipedia, but they need to be handled with care.",
"description": "Use this template to tag information or analysis that you believe is improperly or unnecessarily supported by a primary source, so that other editors can see whether this use is appropriate and/or replace it with a citation to a stronger, secondary source. Primary sources may be used on Wikipedia, but they need to be handled with care.",
"params": {
"params": {
"1": {
"1": {
"label": "Focus",
"label": "Focus",
"description": "Indicate if the focus is a particular section; not including this parameter implies the entire article",
"description": "Use if the focus is a particular section or paragraph",
"type": "string",
"type": "string",
"default": "article",
"required": false
"required": false
},
},
Line 82: Line 119:
"autovalue": "{{subst:CURRENTMONTHNAME}} {{subst:CURRENTYEAR}}",
"autovalue": "{{subst:CURRENTMONTHNAME}} {{subst:CURRENTYEAR}}",
"suggested": true
"suggested": true
},
"talk": {
"label": "Talk",
"description": "Section name or full page and section of discussion",
"type": "string",
"required": false,
"example": "Discussion section name"
},
"find": {
"label": "Find",
"description": "Search keywords for 'find sources' double-quoted (exact) search. May be one or more words. Leave empty to suppress 'find sources' output.",
"type": "string",
"required": false,
"example": "Austen's early life"
},
"find2": {
"label": "Find2",
"description": "Search keywords for 'find sources' unquoted search.",
"type": "string",
"required": false,
"aliases": ["unquoted"]
}
}
},
},
Line 93: Line 151:
<!-- Categories below this line, please; interwikis at Wikidata -->
<!-- Categories below this line, please; interwikis at Wikidata -->
[[Category:Citation and verifiability maintenance templates]]
[[Category:Citation and verifiability maintenance templates]]
}}</includeonly>
}}</includeonly>

Latest revision as of 17:25, 29 January 2023

Lua error: Internal error: The interpreter exited with status 127. Lua error: Internal error: The interpreter exited with status 127. Lua error: Internal error: The interpreter exited with status 127. Lua error: Internal error: The interpreter exited with status 127.

Use this template to tag information or analysis that you believe is improperly or unnecessarily supported by a primary source, so that other editors can see whether this use is appropriate or replace it with a citation to a secondary source.

Usage

  • {{Primary sources|date=May 2025}} for entire articles
  • {{Primary sources|section|date=May 2025}} for sections

Substitution of this template will automatically fill the date parameter.

  • {{subst:Primary sources}}

Optional find parameters are available, for modifying the operation of the {{find sources}} links displayed by the template:

  • {{Primary sources|find=double-quoted search keyword(s)|find2=unquoted keywords|date=May 2025}}

This template will categorize tagged articles into Category:Articles lacking reliable references.

There is currently no consensus on where in the article to place templates such as this.

When to use

The presence of primary sources in an article doesn't mean the article must be tagged. Primary sources may be used on Wikipedia, but they need to be handled with care.

Whether a source is independent is a different concept from whether it is a primary source. To tag an article as lacking sufficient independent sources, use instead the templates {{third-party}} or, in the case those sources are published directly by the person/organization itself, {{self-published}}.

Parameters

There are five parameters, one positional, and four named parameters. All parameters are optional.

  • |1= – scope of notification (e.g., 'paragraph', 'section', 'article', etc.) default: 'article'. see Details.
  • |date= – month name and year; e.g. 'May 2025' (no default)
  • |talk= – section or fullpage id of discussion
  • |find= – search keywords for {{find sources}} param 1 (double-quoted search); default: page title. See details below.
  • |find2= – search keywords for {{find sources}} param 2 (unquoted search). Alias: unquoted. See below.

Details

Positional parameter 1

Positional parameter |1= is the 'type' parameter, which may be set to paragraph or section or any string value.

Date parameter:

The |date= parameter is (generally[1]) used to indicate when the template was added to a page. An example of its usage is {{Primary sources|date=May 2025}}. Adding this parameter sorts the article into monthly subcategories of Category:Articles lacking sources, rather than adding it to the category itself, allowing the oldest problems to be identified and dealt with first. If the date parameter is omitted, a bot will add it later.

Find parameters:

There are two 'find' parameters available to control the presentation and operation of the {{find sources}} links optionally displayed by the {{Primary sources}} template. By default, the template displays {{find sources}} with a quoted search query equivalent to the exact article title. Sometimes, especially if the article has a long, descriptive title, or if it includes parenthetical disambiguation terms, this may not give useful results. The find parameters can be used to provide the search keywords of your choice to the {{find sources}} links. Use:
  • |find= to specify keywords for an exact search (double-quoted query); this corresponds to {{find sources}} positional param |1.
  • |find2= to specify keywords for an unquoted search; this corresponds to {{find sources}} param |2. The alias |unquoted= may be used instead. Note that booleans, exclusion terms (preceded by minus sign) and other search operators may be used in unquoted search (|find2=) if valid for the search domains:
{{Primary sources|find=John Adams|find2=president -Quincy}} ⟶ (see Examples below)
  • Param |find= may take the special value Lua error: Internal error: The interpreter exited with status 127. in order to suppress display of find sources links. (Note that specifying |find=none and a nonempty value for |find2= is not a valid combination.)

Wrappers

To tag an individual section instead of the whole article, you can use {{Primary sources section}} template.

If you use template {{BLP primary sources}}, it indicates that the article is a biography of a living person, and also sorts the article into subcategories of Category:BLP articles lacking sources. This serves to indicate a problem with the policy on self-published sources in biographies of living persons.

Examples

{{primary sources|date=May 2025}}

Lua error: Internal error: The interpreter exited with status 127.

Exclusion term in unquoted search:

{{Primary sources|find=John Adams|find2=president -Quincy}}Lua error: Internal error: The interpreter exited with status 127.

For Biographies of Living Persons:

{{BLP primary sources|date=May 2025}}

Lua error: Internal error: The interpreter exited with status 127.

Redirects

Aliases include:

Aliases

See also

Notes

  1. ^ Because of the nature of the workflow using the current date makes sense, it is simpler to add, especially for the WP:bots it means that older dated categories do not have to be constantly created and deleted, and it enables some measure of progress. Moreover it is "good enough" to get the articles into the workflow and the intention is to ensure they are cleaned up eventually. Occasionally however it may be useful to bulk add items, to older categories, for example when the system was initially set up, when merging two schemes or when adding to the current month would swamp it disproportionately.

Lua error: Internal error: The interpreter exited with status 127.

TemplateData

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. See a monthly parameter usage report for Template:Primary sources in articles based on its TemplateData.

TemplateData for Primary sources

Lua error: Internal error: The interpreter exited with status 127.

Use this template to tag information or analysis that you believe is improperly or unnecessarily supported by a primary source, so that other editors can see whether this use is appropriate and/or replace it with a citation to a stronger, secondary source. Primary sources may be used on Wikipedia, but they need to be handled with care.

Template parameters

This template prefers inline formatting of parameters.

ParameterDescriptionTypeStatus
Focus1

Use if the focus is a particular section or paragraph

Default
article
Stringoptional
Month and yeardate

Month and year when template was applied; if left blank, this will be filled by a bot

Auto value
{{subst:CURRENTMONTHNAME}} {{subst:CURRENTYEAR}}
Stringsuggested
Talktalk

Section name or full page and section of discussion

Example
Discussion section name
Stringoptional
Findfind

Search keywords for 'find sources' double-quoted (exact) search. May be one or more words. Leave empty to suppress 'find sources' output.

Example
Austen's early life
Stringoptional
Find2find2 unquoted

Search keywords for 'find sources' unquoted search.

Stringoptional

Lua error: Internal error: The interpreter exited with status 127.