Difference between revisions of "Template:Globalize/doc"

From blackwiki
Jump to navigation Jump to search
imported>Király-Seth
imported>Geekdiva
m (Added Template:Wikipedia template messages. NOTE: Many paragraphs need a lot more work to be clear. I clarified a little here and there.)
Line 5: Line 5:
  
 
{{Template_notes
 
{{Template_notes
|This family of maintenance templates (most of which are country or region specific—see list towards bottom [[#Current list of sub-pages|here]]) is intended to attract editors with different viewpoints to edit articles that need additional insight.
+
|This family of maintenance templates (most of which are country or region specific, as you can see in [[#Current list of sub-pages|§ Current list of sub-pages]]) 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).  
 
|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.
 
|If additional reliable sources for a worldwide view cannot be found after a reasonable search, this tag may be removed.
Line 17: Line 17:
 
<code><nowiki>{{</nowiki>Globalize |date={{CURRENTMONTHNAME}} {{CURRENTYEAR}} |discuss=Talk:<nowiki>{{</nowiki>subst:PAGENAME}}#Globalize }}</code>
 
<code><nowiki>{{</nowiki>Globalize |date={{CURRENTMONTHNAME}} {{CURRENTYEAR}} |discuss=Talk:<nowiki>{{</nowiki>subst:PAGENAME}}#Globalize }}</code>
  
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."  Instructions on modifying this simple code are below.
+
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?
 
;Article or section?
Line 78: Line 80:
  
 
===Location===
 
===Location===
As with all 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]].
+
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]].
  
 
===Current list of sub-pages===
 
===Current list of sub-pages===
Line 112: Line 114:
 
*Full usage notes follow including easy ways to define the date properly and link the talk page section.
 
*Full usage notes follow including easy ways to define the date properly and link the talk page section.
  
*Instructions for country or regional names apply only to the base generic {{Tl2|Globalize}} template and do not function for the above semi-customized templates: (''They've been properly defined for you already within these'')
+
*Instructions for country or regional names apply only when using the basic, generic {{Tl2|Globalize}} template. They are not functional for the templates in the list above, because they're not needed—the country or region is already defined in those sub-page templates.
  
 
===See also===
 
===See also===
Line 120: Line 122:
 
* {{Tl|Historical information needed}} for lack of historical coverage
 
* {{Tl|Historical information needed}} for lack of historical coverage
 
* [[Wikipedia:Template messages/Cleanup]]
 
* [[Wikipedia:Template messages/Cleanup]]
 +
 +
{{Wikipedia template messages}}
  
 
<includeonly>
 
<includeonly>

Revision as of 00:40, 18 October 2015

Template:Template notes

Usage

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

{{Globalize |date=December 2025 |discuss=Talk:{{subst:PAGENAME}}#Globalize }}

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: {{Globalize|article}} or {{Globalize|section}}.

Please set the 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, and if you do not supply the current date, then a bot has to add it later, which results in extra server load. The simplest and easiest way is to include: "| {{subst:DATE}}" within the template body.

Link to the correct section of the talk page

As a courtesy to other editors and as a means of respecting their time, and also as a means of maximizing the likelihood that your concerns will be addressed, you should 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 |discuss=Talk:Article_Name#This_is_section_title.

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 countries are over-represented?

Country names given as a positional parameter are assumed to be links as can be seen in the code snippet: {{{2name|[[{{{2}}}]]}}} 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, {{Globalize|article or section|area 1|area 2|area 3}}. For each region, the template will automatically add the page to an appropriate cleanup category, named category:{{{country}}}-specific. If the name of the country differs from the category (for instance, the United Kingdom, but UK-specific) then you can use the 2name, 3name and 4name 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., |nocat=my cat or |inhibit=1.

Technical note
The first, second, third... positional parameters are equivalent in wikimarkup language as the (special, a special case by definition and design) 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
{{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=
}}

full commented form
{{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: <code><nowiki>{{{2}}}, {{{3}}}, {{{4}}} or 2name, 3name, 4name</code>)
  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
 -->
|  <!-- (<code>{{{2}}}</code>) --> 2= <!-- 1st country or region --> or | 2name=
|  <!-- (<code>{{{3}}}</code>) --> 3= <!-- 2nd country or region --> or | 3name
|  <!-- (<code>{{{4}}}</code>) --> 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. -->
}}
</nowiki>

Location

As with all maintenance templates, this template should be placed below any disambiguation links and above infoboxes, images, and the text of the lead to increase accessibility for users of screen readers.

Current list of sub-pages

These are special-case templates of the generic {{Globalize}} template
(which are preferred and should be used if and when they apply) as each is customized by message and/or clean-up task force maintenance auto-categories for the applicable regions or countries or groups of countries in which viewpoint bias abuses frequently occur.
  • Using one of these is simple for only the template name (Slash included), and the date= and talk= (discussion) parameters need specified—the same as when using the generic or any other maintenance template.
  • Full usage notes follow including easy ways to define the date properly and link the talk page section.
  • Instructions for country or regional names apply only when using the basic, generic {{Globalize}} template. They are not functional for the templates in the list above, because they're not needed—the country or region is already defined in those sub-page templates.

See also