Difference between revisions of "Template:Essay-like/doc"

From blackwiki
Jump to navigation Jump to search
imported>Arcadina
imported>SMcCandlish
(→‎See also: update)
 
(21 intermediate revisions by 17 users not shown)
Line 1: Line 1:
 
{{Documentation subpage}}
 
{{Documentation subpage}}
<!-- EDIT TEMPLATE DOCUMENTATION BELOW THIS LINE -->
+
<!-- Please place categories where indicated at the bottom of this page and interwikis at Wikidata (see [[WP:Wikidata]]) -->
 
{{Twinkle standard installation}}
 
{{Twinkle standard installation}}
This template should be used when the article appears to have been written with personal comments on the subject of the article, or having some connection with the subject. It is used when the article is not necessarily representing a blatant opinion or opinion piece, but is still overly judgemental in tone.
+
==When to use==
 +
Use this tag to identify '''personal essays'''. Personal essays describe the author's own emotional [[feeling]]s about a topic. Although Wikipedia is supposed to compile human knowledge, it is [[WP:What Wikipedia is not#PUBLISHER|not a vehicle to publish users' personal opinions]].
  
=== Usage ===
+
This template should be used when the article contains the editor's own personal, emotional comments on the subject. Use it when the article does not necessarily represent a blatant opinion or opinion piece, but is still overly [[wikt:judgementalist|judgementalist]] in tone.
  
Place at the top of the article and/or sections to alert editors.
+
===When not to use===
 +
Do not use this template to tag fact-oriented pages that sound like they might have been written as research papers for school (called "essays" in some parts of the world). Instead, if those pages need a different writing style or tone, use {{tl|Research paper}}, or general templates like {{tl|Tone}} or {{tl|Copy edit}}.
  
;articles
+
If the article is biased, but without expressing the editor's emotions or value-based judgments, use tags like {{tl|unbalanced}} or {{tl|POV}}.
* For articles needing major clean-up, place {{tlx|Essay-like|article}} at the top of the main page to alert readers.
 
* For articles needing minor clean-up, place {{tlx|Essay-like|article}} at the top of the talk page to alert editors.
 
  
;sections
+
===How to use===
* To mark specific sections instead of the whole article, place {{tlx|Essay-like|section}} at the top of the section.
+
Place this:
  
;remarks
+
<code>{{Template link with parameters|Essay-like|date{{=}}{{CURRENTMONTHNAME}} {{CURRENTYEAR}}}}</code>
* To replace the text "a personal reflection or essay", you may use {{tlx|Essay-like|article/section|yourtext}} or {{tlx|essay-like|2&#61;yourtext}}
 
* You may use the optional date parameter, e.g. <code><nowiki>{{Essay-like|</nowiki>date={{CURRENTMONTHNAME}} {{CURRENTYEAR}}<nowiki>}}</nowiki></code>. This helps with the categorization of articles requiring attention.
 
::*Articles tagged with this template without this parameter will be given the parameter by a [[WP:BOT|bot]].
 
* The simplest way to add this template to an article is to copy and paste<code> <nowiki>{{essay-like|</nowiki>date={{CURRENTMONTHNAME}} {{CURRENTYEAR}}<nowiki>}}</nowiki></code> at the top of the article or talk page.
 
* Add a new item to the talk page explaining the problem so editors will know what to address, and when to remove this tag.
 
* This template adds articles to [[:Category:Wikipedia articles needing style editing]]
 
  
=== Notes ===
+
at the top of the article to alert editors to the inappropriate presence of editors' personal reflections throughout the article.
  
*This template will add tagged articles to [[:Category:Wikipedia articles needing style editing]].
+
;Sections
*This [[Wikipedia:Template|template]] is a [[Wikipedia:Avoid self-references|self-reference]].
+
*To mark specific sections instead of the whole article, place {{tlx|Essay-like|section}} at the top of the section.
* Please do not [[Wikipedia:Subst|subst:]] this template.
 
  
=== Redirects ===
+
;Options
 +
*To replace the text "a personal reflection or essay", you may use {{tlx|Essay-like|article or section|yourtext}} or {{tlx|Essay-like|2&#61;yourtext}}
 +
*Articles tagged without the optional date parameter will be given the parameter by a [[WP:Bots|bot]].
 +
*Add a new item to the talk page explaining the problem so editors will know what to address, and when to remove this tag.
  
* {{Tl|essay-entry}}
+
===Notes===
* {{T1|essay like}}
+
*This template will add tagged articles to dated subcategories of [[:Category:Wikipedia articles with style issues by month]] and to [[:Category:All articles with style issues]].
 +
*This [[WP:Templates|template]] is a [[WP:Manual of Style/Self-references to avoid|self-reference]].
 +
*Please do not [[WP:Substitution|subst:]] this template.
  
=== See also ===
+
===See also===
  
 +
* [[Template:Editorializing]] – inline version of this template, for flagging particular statements
 +
* [[Template:Essay]] – identifies internal [[Wikipedia:Essays]]
 
* [[Wikipedia:Cleanup process]]
 
* [[Wikipedia:Cleanup process]]
 
* [[Wikipedia:Template messages/Cleanup]]
 
* [[Wikipedia:Template messages/Cleanup]]
 +
* [[Template:Manual]]
  
<includeonly>
+
==TemplateData==
 +
{{TemplateData header}}
 +
<templatedata>
 +
{
 +
    "params": {
 +
        "1": {
 +
            "label": "Type (typically section)",
 +
            "description": "This parameter allows an editor to replace the default word \"article\" with another word, usually the word \"section\"",
 +
            "type": "string",
 +
            "default": "article"
 +
        },
 +
        "2": {
 +
            "label": "Replaced text",
 +
            "description": "To replace the template text \"a personal reflection or opinion essay\" with a custom description",
 +
            "type": "content",
 +
            "autovalue": ""
 +
        },
 +
        "date": {
 +
            "description": "Month and year of tagging; e.g., 'January 2013', but not 'jan13'",
 +
            "autovalue": "{{subst:CURRENTMONTHNAME}} {{subst:CURRENTYEAR}}",
 +
            "suggested": true,
 +
            "label": "Month and year",
 +
            "type": "string"
 +
        }
 +
    },
 +
    "description": "Use this cleanup template to identify personal essays",
 +
    "format": "inline"
 +
}
 +
</templatedata>
  
[[Category:Cleanup templates|{{PAGENAME}}]]
+
<includeonly>{{sandbox other||
[[ar:قالب:مجلة]]
+
<!-- Categories below this line, please; interwikis at Wikidata -->
[[ja:Template:修正]]
+
[[Category:Cleanup templates]]
[[sl:Predloga:Podoben-eseju]]
+
[[Category:Wikipedia section templates]]
[[vi:Tiêu bản:Bài quảng cáo]]</includeonly>
+
}}</includeonly>

Latest revision as of 00:53, 7 December 2020

When to use

Use this tag to identify personal essays. Personal essays describe the author's own emotional feelings about a topic. Although Wikipedia is supposed to compile human knowledge, it is not a vehicle to publish users' personal opinions.

This template should be used when the article contains the editor's own personal, emotional comments on the subject. Use it when the article does not necessarily represent a blatant opinion or opinion piece, but is still overly judgementalist in tone.

When not to use

Do not use this template to tag fact-oriented pages that sound like they might have been written as research papers for school (called "essays" in some parts of the world). Instead, if those pages need a different writing style or tone, use {{Research paper}}, or general templates like {{Tone}} or {{Copy edit}}.

If the article is biased, but without expressing the editor's emotions or value-based judgments, use tags like {{unbalanced}} or {{POV}}.

How to use

Place this:

{{Essay-like|date=November 2025}}

at the top of the article to alert editors to the inappropriate presence of editors' personal reflections throughout the article.

Sections
  • To mark specific sections instead of the whole article, place {{Essay-like|section}} at the top of the section.
Options
  • To replace the text "a personal reflection or essay", you may use {{Essay-like|article or section|yourtext}} or {{Essay-like|2=yourtext}}
  • Articles tagged without the optional date parameter will be given the parameter by a bot.
  • Add a new item to the talk page explaining the problem so editors will know what to address, and when to remove this tag.

Notes

See also

TemplateData

This is the TemplateData documentation for this template used by VisualEditor and other tools; see the monthly parameter usage report for this template.

TemplateData for Essay-like

Use this cleanup template to identify personal essays

Template parameters

This template prefers inline formatting of parameters.

ParameterDescriptionTypeStatus
Type (typically section)1

This parameter allows an editor to replace the default word "article" with another word, usually the word "section"

Default
article
Stringoptional
Replaced text2

To replace the template text "a personal reflection or opinion essay" with a custom description

Auto value
Contentoptional
Month and yeardate

Month and year of tagging; e.g., 'January 2013', but not 'jan13'

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