View source for Template:Globalize/doc

{{documentation subpage}}
<!-- Please place categories where indicated at the bottom of this page and interwikis at Wikidata (see [[Wikipedia:Wikidata]]) -->
{{High-use}}
{{Twinkle standard installation}}
{{Selfref|This template is a [[WP:Self reference]]}}
{{Template notes
|This maintenance templates is intended to attract editors with different viewpoints to edit articles that need additional insight.
|This tag should only be applied to articles where global [[Perspective (cognitive)|perspectives]] are reasonably believed to exist (e.g., that people in China have a different view about an idea or situation than people in Germany or South Africa). 
|If additional reliable sources for a worldwide view cannot be found after a reasonable search, this tag may be removed.
|This tag should not be used as a [[badge of shame]] or to complain about [[WP:ENGVAR|how to spell words]], which measurement units to use, and similar questions of article presentation.
|Please explain your concerns on the article's talk page and '''link to the section title of the discussion you initiate'''.  Otherwise, other editors may remove this tag without further notice.
}}

==Usage==
Paste this at the top of the affected article or section:

{{Tlx|Globalize|date{{=}}{{CURRENTMONTHNAME}} {{CURRENTYEAR}}}}

This code provides the correct date, assumes that your concerns affect the entire article, and assumes that you will promptly explain your concerns on that article's talk page in a new section titled "Globalize."  

For instructions on modifying this simplest version of the template code, see the following:

;Article or section?
:The default word '''article''' is replaceable so you can specify whether the whole article or just a '''section''' doesn't represent a worldwide view. One or the other must be given if you also wish to specify any countries to which the article currently leans without using a named parameter (which are: 2name=, 3name=, 4name=) to specify the country.  Specifying the whole article or just one section is accomplished simply by adding those words as parameters: {{Tlx|Globalize|article|date{{=}}{{CURRENTMONTHNAME}} {{CURRENTYEAR}}}} or {{Tlx|Globalize|section|date{{=}}{{CURRENTMONTHNAME}} {{CURRENTYEAR}}}}.

;Date
:The maintenance date tagging parameter 'date=' should be given with a properly formatted ISO date as is common to most maintenance tags. This parameter is used in time-keyed autocategories, if you do not supply the current date, then a [[WP:BOT|bot]] will add it later.

;Link to the correct section of the talk page
:As a means of maximizing the likelihood that your concerns will be addressed, you should consider to initiate a talk section detailing your concerns when hanging any maintenance tag. Without such explanations, it may be difficult for editors to understand what concerned you and to figure out whether subsequent changes have addressed your concerns.

:Specify the full link prefix through section title. (Capture this off the url after saving your newly inaugurated complaint section works best—you literally can't go wrong and introduce a typo since it's cut and paste.)
:This is achieved by adding <code>|discuss=Talk:Article_Name#This_is_section_title</code>.

:If you do not explain your concerns on the article's talk page, you may expect this tag to be promptly and justifiably removed as "unexplained" by the first editor who happens to not understand why you added this tag.

;Which regions are over-represented?
:Country or region names given as a positional parameter are assumed to be links as can be seen in the code snippet: <code><nowiki>{{{2name|[[{{{2}}}]]}}}</nowiki></code> The 2name, 3name parameters also affect categorizations, so can be used to display one name and link those to a variant.

:Up to three geographical areas covered can also be selected, <code><nowiki>{{Globalize|article or section|area 1|area 2|area 3}}</nowiki></code>. For each region, the template will automatically add the page to an appropriate cleanup category, named <kbd><nowiki>category:{{{country}}}-centric</nowiki></kbd>. If the name of the country differs from the category (for instance, ''the United Kingdom'', but ''UK-centric'') then you can use the <kbd>2name</kbd>, <kbd>3name</kbd> and <kbd>4name</kbd> attributes to modify the displayed name. 

;Categorization
:This template will also categorize tagged articles into [[:Category:Articles with limited geographic scope]].  To disable all auto-categorisation (such as when used multiple times on the same page tagging various sections), define either '''inhibit=''' or '''nocat=''' to any value (e.g., <code>|nocat=my cat</code> or <code>|inhibit=1</code>. 

;Technical note
:The first, second, third... positional parameters are equivalent in wikimarkup language to the named parameters 1=, 2=, 3=, ... so far as article links are concerned.  However, the two parameters differ in their effects in selecting named autocategories as is covered below. (The best trick ... try either, or both, for many country related names have slight name differences from their category names and therefore you must test (check) for both redlinked article and category names)

;simple form:
<syntaxhighlight lang="wikitext">
{{Globalize
|{{subst:DATE}}
|discuss=Talk:Article_Name#"This_is_section_title"
| 1= article or section <!-- (defaults to article) -->
| 2= <!-- 1st country or region or  --> 
  | 2name=
}}
</syntaxhighlight>
----
;full commented form:

<syntaxhighlight lang="wikitext">
{{Globalize
|date=
|discuss=|discussion=|talk= <!-- (just one of) Defines link paths to article's talk page SECTION link by title.
-- Define as "Talk:Article_Name#This_is_section_title" ) -->
| 1= article or section <!-- (defaults to article) -->
 <!-- 
  (just one of each pair in: {{{2}}}, {{{3}}}, {{{4}}} or 2name, 3name, 4name)
  These are the countries or regions on which the article is currently overly focused,
  in other words, 'those places the article is biased toward in the complaint
 -->
|  <!-- ({{{2}}}) --> 2= <!-- 1st country or region --> or | 2name=
|  <!-- ({{{3}}}) --> 3= <!-- 2nd country or region --> or | 3name
|  <!-- ({{{4}}}) --> 4= <!-- 3rd country or region --> or | 4name
 <!-- 
(optional category control parameters) -->
| nocat= true or inhibit=true  <!-- define either or both to inhibit auto-categorization into cleanup categories. -->
}}
</syntaxhighlight>

===Location===
As with all [[Wikipedia:Maintenance templates|maintenance templates]], this template should be placed below any [[WP:DAB|disambiguation links]] and above [[WP:INFOBOX|infoboxes]], images, and the text of the [[WP:LEAD|lead]] to increase [[WP:ACCESS|accessibility for users of screen readers]].

== TemplateData ==
{{TemplateData header}}
<templatedata>
{
	"description": "Use this cleanup template to indicate that an article is written primarily from the perspective of a particular region of the world.",
	"format": "inline",
	"params": {
		"1": {
			"label": "Scope",
			"description": "Custom text to describe the area of the article needing attention. Defaults to \"article\" if blank, and is usually customized to \"section\". Consider using the {{Globalize section}} template for identical function.",
			"type": "line",
			"autovalue": "section",
			"example": "section",
			"suggestedvalues": [
				"section"
			],
			"default": "article"
		},
		"2": {
			"label": "Region",
			"description": "Country or region that the article primarily deals with",
			"type": "line",
			"example": "US, the Western world",
			"suggested": true
		},
		"3": {
			"label": "Second region",
			"description": "Second country or region that the article primarily deals with",
			"example": "UK, Anglophone",
			"type": "line"
		},
		"4": {
			"label": "Third region",
			"description": "Third country or region that the article primarily deals with",
			"example": "Europe, Canada",
			"type": "line"
		},
		"date": {
			"label": "Month and year",
			"description": "The month and year that the template was placed (in full). \"{{subst:CURRENTMONTHNAME}} {{subst:CURRENTYEAR}}\" inserts the current month and year automatically.",
			"type": "line",
			"autovalue": "{{subst:CURRENTMONTHNAME}} {{subst:CURRENTYEAR}}",
			"example": "January 2013",
			"suggested": true
		},
		"2name": {
			"label": "First region name override",
			"description": "Enter text here to override the automatic conversion of some region names (US, UK) with the text entered.",
			"type": "line",
			"example": "the US, the UK"
		},
		"3name": {
			"label": "Second region name override",
			"description": "Enter text here to override the automatic conversion of some region names (US, UK) with the text entered.",
			"example": "Britain, the West",
			"type": "line"
		},
		"4name": {
			"label": "Third region name override",
			"description": "Enter text here to override the automatic conversion of some region names (US, UK) with the text entered.",
			"example": "the EU, the Anglosphere",
			"type": "line"
		},
		"talk": {
			"aliases": [
				"discuss",
				"discussion"
			],
			"label": "Talk page section",
			"description": "Section name on the talk page for further discussion",
			"type": "line"
		},
		"small": {
			"label": "Make template small",
			"description": "Enter \"left\" here to make the template box small and aligned to the left.",
			"type": "line",
			"autovalue": "left",
			"example": "left"
		},
		"reason": {
			"label": "Reason"
		}
	},
	"paramOrder": [
		"date",
		"2",
		"3",
		"4",
		"2name",
		"3name",
		"4name",
		"talk",
		"small",
		"1",
		"reason"
	]
}
</templatedata>

== See also ==
* {{Tl|Globalize-inline}} inline version of this template
* {{Tl|Geographical imbalance}} for coverage within a specific region
* {{Tl|Over coverage}}
* {{Tl|Where}} for unclear geographical scope
* [[Wikipedia:Template messages/Cleanup]]

{{Wikipedia templates}}

<includeonly>{{Sandbox other||
<!-- Categories go below this line, please; interwikis go to Wikidata, thank you! -->
[[Category:Internationalisation maintenance templates]]

}}</includeonly>