Template:Asia topic/doc
This is a documentation subpage for Template:Asia topic. It may contain usage information, categories and other content that is not part of the original template page. |
This template is used on approximately 10,000 pages and changes may be widely noticed. Test changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Consider discussing changes on the talk page before implementing them. |
General documentation on continent-topic templates[edit source]
The continent/region-topic templates allow quick creation of a navigational template for groups of articles about a common topic in different countries of a continent/region. It uses Template:Navbox to create the navigation box.
The lists of countries included in the "Continent topic" templates are broadly those found in the "Countries of" templates. Discussions on which countries to include are best conducted on the talk pages of these latter templates.
For example, Oceania generally includes Australia and the nations of the Pacific and islands in the Pacific Ocean that have closer ties to Asia or the Americas are usually grouped accordingly.
Usage[edit source]
1st parameter (prefix)[edit source]
The most basic usage of template is with a single unnamed parameter in the format {{Continent/region topic |Topic [of/in]}}
, replacing Continent/region with the name of a continent or region and Topic with the name of a topic followed by "of" or "in". For example, {{Africa topic |Geography of}}
generates a navigation box titled "Geography of Africa" with a list of country names linked to articles such as Geography of Angola, etc.
- Code
{{Africa topic |Geography of}}
- Result
The named parameter prefix can be used in place of the unnamed 1st parameter.
- Code
{{Asia topic |prefix=Geography of}}
- Result
2nd parameter (suffix)[edit source]
The template accepts a second unnamed parameter for text to be placed after the country name. There is no space between the country name and the suffix, to allow for links to articles such as List of Spain-related topics.
- Code
{{Europe topic |List of |-related topics}}
- Result
An underscore can be used to place a space between the country name and the text:
- Code
{{North America topic |List of basic |_topics}}
- Result
Note that in the above example the links work but the underscore is displayed in the title. This can be fixed by specifying a title (see next section) or by using the named parameter suffix which always places a space between the country name and text.
- Code
{{South America topic |prefix=List of basic |suffix=topics}}
- Result
Changing the title[edit source]
The title parameter is used to specify text which appears in the title bar at the top of the navigation box. This is optional because the use of prefix, suffix or both will automatically generate a title, as shown in the previous examples. This title is not automatically wiki-linked, so add brackets as needed.
The following shows a navigation box with links to articles such as Flag of Australia, but replaces the default title "Flag of Oceania" with the specified title "Flags of Oceania".
- Code
{{Oceania topic |Flag of |title=[[Flags of Oceania]]}}
- Result
Displaying template in show mode[edit source]
These navigation boxes are set to autocollapse
when there is more than one on a page. To force it into collapsed or expanded mode use the state parameter. If set to collapsed
, the navbox will always start out in a collapsed state. If set to blank or anything other than autocollapse
or collapsed
, the navbox will always start out in an expanded state.
- Code
{{Africa topic |prefix=Geography of |state=expand}}
- Result
Disabling dependencies and other territories[edit source]
Not all dependencies or similar territories have their own articles on particular topics. To disable the inclusion of such territories in a template (that would otherwise appear as red links), include the parameter "countries_only=yes".
- Code
{{Europe topic |prefix=Islam in |state=expanded |countries_only=yes}}
- Result
Creating a new template[edit source]
Although these templates can be used in an article, they can also be used to create a new template. The name parameter is mandatory when creating a new template, because it allows the "V T E" links to work properly. The following example shows code that could be used to create Template:Flags of Europe.
{{Europe topic
| name = Flags of Europe
| state = {{{state|{{{1|}}}}}}
| title = [[Flags of Europe]]
| prefix = Flag of
}}<noinclude>
[[Category:Europe templates]]
</noinclude>
The template can then be added to articles using {{Flags of Europe}}
or {{Flags of Europe |state=expand}}
.
When to use the templates[edit source]
- Before implementing these templates in a topic, check for red links. If there are several red links, consider whether a separate article in the topic for each country is warranted.
- Some topics may use a different navigational scheme. In general, don't use this template if there are already navigational templates in several of the articles of a topic.
Examples of appropriate articles for these templates are {{Africa topic |Culture of}} or {{North America topic |List of airports in}}, both of which have a number of blue links, and where the majority of red links could have a reasonable article written about them.
Examples of inappropriate articles for these templates are {{North America topic |Maya in}}, where articles could only be written for a small number of nations and {{Oceania topic |Music of}}, where articles already have templates which use a different navigational scheme.
Redirects[edit source]
When there are a small number of links for which an article is not appropriate, consider making a redirect to the broader article in which the topic is included. For example, Hinduism in Cambodia redirects to Hinduism in Southeast Asia and Geography of Christmas Island redirects to Christmas Island#Geography.
Notes[edit source]
Navigational templates are usually placed at the end of an article.
Additional documentation for Template:Asia topic[edit source]
Removing the article "the"[edit source]
By default all links for the entries for the Philippines, the Maldives, etc. include the article "the". In some cases this is not wanted. To remove the leading article, set the parameter |article=
to anything except "yes".
Code
{{Asia topic|suffix=national football team|title=National football teams of Asia|article=no|state=expanded}}
Result
Note that {{ Asia topic}} , together with {{ Europe topic}} , is the only continent-topic template to have an "article" parameter. In most other templates "the" is automatically included if there is no suffix and cannot be manually added or suppressed.
Adding or suppressing "(country)" for Georgia[edit source]
In the link for Georgia, the disambiguator "(country)" is included unless a suffix is defined using either |suffix=
or the second unnamed parameter. The |template=
parameter overrides this behavior; set it to "yes" to explicitly include the disambiguator, or to anything else to suppress it.
The previously mentioned default behavior is different from that in {{ Europe topic}}
- in that template "(country)" is always included by default, regardless of whether a suffix is defined.
Altering the link used for a specific entity[edit source]
To change the link used for a single state or dependency, the following entity-specific parameters are available. Most parameters are named after each entity's ISO 3166-1 alpha-2 code; some states with limited recognition are not included in that standard and have parameters consisting of nonofficial two-letter codes preceded by the letter "X" (ISO 3166-1 alpha-3 user-assigned codes).
Sovereign states
|AF=
Afghanistan|AM=
Armenia|AZ=
Azerbaijan|BH=
Bahrain|BD=
Bangladesh|BT=
Bhutan|BN=
Brunei|MM=
Burma (Myanmar)|KH=
Cambodia|CN=
China|CY=
Cyprus|TL=
East Timor (Timor-Leste)|EG=
Egypt|GE=
Georgia|IN=
India|ID=
Indonesia|IR=
Iran|IQ=
Iraq|IL=
Israel|JP=
Japan|JO=
Jordan|KZ=
Kazakhstan|KP=
North Korea|KR=
South Korea|KW=
Kuwait|KG=
Kyrgyzstan|LA=
Laos|LB=
Lebanon|MY=
Malaysia|MV=
Maldives|MN=
Mongolia|NP=
Nepal|OM=
Oman|PK=
Pakistan|PH=
Philippines|QA=
Qatar|RU=
Russia|SA=
Saudi Arabia|SG=
Singapore|LK=
Sri Lanka|SY=
Syria|TJ=
Tajikistan|TH=
Thailand|TR=
Turkey|TM=
Turkmenistan|AE=
United Arab Emirates|UZ=
Uzbekistan|VN=
Vietnam|YE=
Yemen
States with limited recognition
|XAB=
Abkhazia|XNK=
Nagorno-Karabakh|XNC=
Northern Cyprus|PS=
Palestine (UN observer state)|XSO=
South Ossetia|TW=
Taiwan
Dependencies and other territories
|IO=
British Indian Ocean Territory|CX=
Christmas Island|CC=
Cocos (Keeling) Islands|HK=
Hong Kong|MO=
Macau
If a parameter is specified, but left blank, the respective entity will be omitted from the list. If set to anything else, it changes the link for the entity to the specified title. This can be used to correct an otherwise red link, or to bypass a redirect link per WP:BRINT.
To omit all dependencies if not applicable for the topic in question, set the parameter |countries_only=
to any non-null value.
List of wrapper templates using Template:Asia topic[edit source]
- {{
- {{
- {{
- {{
- {{
- {{
- {{
- {{
- {{
- {{
- {{
- {{
- {{
- {{
- {{
- {{
- {{
- {{
- {{
- {{
International organization membership in Asia}}
- {{
- {{
Languages of Asia (category)}}
- {{
- {{
List of football stadiums in Asia}}
- {{
- {{
- {{
- {{
- {{
- {{
- {{
- {{
- {{
- {{
- {{
Sport deaths in Asia (category)}}
- {{
- {{
- {{
- {{
- {{
- {{
See also[edit source]