Template:ISO 3166 conversion template doc
[view] [] []
Usage
Usage
This template is part of a series that resolves the country and subdivision names to ISO 3166-1 and ISO 3166-2 codes, and vice versa.
Sub-pages
ISO 3166
ISO 3166 defines names, two and three letter codes and code numbers for all countries and six character codes (the two letter country code followed by a dash and a two or three character subdivision code) for all top level subdivisions.
Templates
ISO 3166-1
ISO 3166-1 alpha-2: {{ISO 3166 code}} (Eg: CA)
ISO 3166-1 alpha-3: {{ISO 3166 code-3}} (Eg: CAN)
ISO 3166-1 numeric: {{ISO 3166 numeric}} (Eg: 124)
ISO 3166-2
ISO 3166-2: {{ISO 3166 code}} (Eg: CA-ON)
ISO 3166-2 name: {{ISO 3166 name}} (Eg: Canada)
Using the family of templates
We wish to convert between various identifiers that may loosely be defined as user input and ISO 3166 entities, there may be more than one way to do each conversion. For our examples we use Pakistan as the country and Balochistan (Pakistan) as the subdivision.
The ISO-3166 identifiers for Pakistan are:
- Name: Pakistan
- Alpha-2 code:PK
- Alpha-3 code:PAK
- Numeric code:586
The ISO-3166 identifiers for Balochistan (Pakistan) is:
- Subdivision code:PK-BK
Now Pakistan also has a number of synonyms: for example Pakistán and پاکستان.
Similarly Baluchistan is known, for example as Balochistan (on Wikipedia) and Bagh Sanjari .
- To get the Alpha-2 code we can use
{{ISO 3166 code}}with any of the country identifiers ,or use the identifier as a part of the template name (faster).
{{ISO 3166 code|Pakistan}}PK{{ISO 3166 code|PK}}PK{{ISO 3166 code|PAK}}PK{{ISO 3166 code|586}}PK{{ISO 3166 code|Pakistán}}PK{{ISO 3166 code|پاکستان}}PK
- The Alpha-3 code is obtained similarly (but not currently using the template name method except for conversion from known good Alpha-2).
{{ISO 3166 code-3|Pakistan}}PAK{{ISO 3166 code-3|PK}}PAK{{ISO 3166 code-3|PAK}}PAK{{ISO 3166 code-3|586}}PAK{{ISO 3166 code-3|Pakistán}}PAK{{ISO 3166 code-3|پاکستان}}PAK
- Finding the name is obtained similarly (but not currently using the template name method except for conversion from known good Alpha-2).
{{ISO 3166 name|Pakistan}}Pakistan{{ISO 3166 name|PK}}Pakistan{{ISO 3166 name|PAK}}Pakistan{{ISO 3166 name|586}}Pakistan{{ISO 3166 name|Pakistán}}Pakistan{{ISO 3166 name|پاکستان}}Pakistan
- Finding the numeric code of a country.
{{ISO 3166 numeric|Pakistan}}586{{ISO 3166 numeric|PK}}586{{ISO 3166 numeric|PAK}}586{{ISO 3166 numeric|586}}586{{ISO 3166 numeric|Pakistán}}586
- The subdivision code can be obtained in the following ways
{{ISO 3166 code|Pakistan|Baluchistan}}PK-BA{{ISO 3166 code|Pakistan|Balochistan}}PK-BA{{ISO 3166 code|Pakistan|Bagh Sanjari}}PK-BA{{ISO 3166 code|Pakistán|Baluchistan}}PK-BA{{ISO 3166 code|Paquistán|Balochistan}}PK-BA{{ISO 3166 code|PK|Baluchistan}}PK-BA
Cases where the non-ISO3166 name might be returned
- Taiwan - ISO name is...
- Venezuela - ISO name is...
- Bolivia - ISO name is....
- ...
- Cases where the name is comma mangled - "Congo, The People's Democratic Republic of"
- Macedonia - ISO name is Macedonia, the former Yugoslav Republic of
Enhancing the system
- Adding country synonyms: these should redirect to the canonical template: the redirect should be categorised the same as the target, and sort-keyed as per the notes in the categories.
- Adding region synonyms: these can be a simple cut-and paste, but be sure to update any documentation variables.