Bản mẫu:ConvertAbbrev

Tài liệu bản mẫu[xem] [sửa] [lịch sử] [làm mới]

This template is used to convert commonly abbreviated things such as countries, states, provinces, and even language codes to and from their abbreviations. A hierarchical tree of subtemplates allows this template to convert virtually anything, which is really good for use in a backdoor template. If you have the word "California", but the template you're trying to use will only recognize "CA", use this to convert it!

How to use the template

Syntax: {{ConvertAbbrev|datatype|specification|value|force=abbr or long}}

This template consists of a "tree" of subtemplates containing databases of abbreviations. Each successive parameter in the code input tells the template which database to query. The datatype parameter is the most broad and tells the template what type of information you are looking for (i.e. Countries, states, or languages). The specification parameter refines the search. For example, if the datatype parameter is "ISO 3166-1", that tells the template to look for a subtype (alpha2, alpha3, or numeric). If the datatype parameter is "ISO 3166-2", the template will look for a specific country (Canada, Mexico, United States, etc.). If the datatype parameter is "ISO 639-1", the template looks for the name of a language (English, Spanish, Zulu, etc.). The value parameter is the actual name or abbreviation the user wishes to convert.

The force parameter overrides the normal nature of the conversion and forces an abbreviation or a long word to be returned. This is useful when a user may input either an abbreviation or a full name, but the template in question can only accept one of them.

If the ISO codes are a little hard to remember, there are also shortcuts:

{{ConvertAbbrev|ISO 3166-1|alpha-2|__country__}} can also be called by
- {{ConvertAbbrev|Countries|alpha-2|__country__}} or
- {{ConvertAbbrev|Countries|__country__}}.
  Note: The default for country abbreviations is alpha-2. For alpha-3 and numeric abbreviations, the user must specify the type in the specification parameter.
{{ConvertAbbrev|ISO 3166-2|CA|__province__}} can also be called by
- {{ConvertAbbrev|Countries|CA|__province__}},
- {{ConvertAbbrev|Countries|Canada|__province__}},
- {{ConvertAbbrev|Canada|__province__}}, or
- {{ConvertAbbrev|CN|__province__}}.
{{ConvertAbbrev|ISO 639-1|__language__}} can also be called by
- {{ConvertAbbrev|Languages|-1|__language__}} or
- {{ConvertAbbrev|Languages|__language__}}.
  Note: The default for language abbreviations is ISO 639-1. For ISO 639-2 abbreviations, the user must specify the type in the specification parameter.
{{ConvertAbbrev|ISO 639-2|__language__}} can also be called by
- {{ConvertAbbrev|Languages|-2|__language__}}.

Supported datasets

ISO 3166-1 – Country abbreviations
- alpha-2 – Two-letter abbreviations
- alpha-3 – Three-letter abbreviations
- numeric – Numeric equations

ISO 3166-2 – State/provincial abbreviations
Note: All ISO 3166-2 codes should not include the 3166-1 country code in the value parameter. (e.g. If you're looking for Paris ["FR-75" in ISO 3166-2:FR], you should only type "75" and not "FR-75".)
ISO 639 – Language codes
- ISO 639-1 – Two letter codes
- ISO 639-2 – Three letter codes

Usage Examples

**From Name to Abbreviation**
Code	Returns
`{{ConvertAbbrev\|ISO 3166-1\|alpha-2\|United Kingdom}}`	GB
`{{ConvertAbbrev\|Countries\|alpha-3\|United States}}`	USA
`{{ConvertAbbrev\|ISO 3166-2\|CA\|Alberta}}`	404 Error: Country not found. The country name or abbreviation you typed may be invalid. It is also possible that the {{ConvertAbbrev}} family simply does not yet support administrative divisions in this country. For a full list of supported ISO 3166-2 countries, click here.
`{{ConvertAbbrev\|Countries\|Mexico\|Federal District}}`	404 Error: Country not found. The country name or abbreviation you typed may be invalid. It is also possible that the {{ConvertAbbrev}} family simply does not yet support administrative divisions in this country. For a full list of supported ISO 3166-2 countries, click here.
`{{ConvertAbbrev\|ISO 639-1\|Russian}}`	ru
`{{ConvertAbbrev\|Languages\|Chinese}}`	zh

**From Abbreviation to Name**
Code	Returns
`{{ConvertAbbrev\|ISO 3166-1\|alpha-2\|GB}}`	United Kingdom
`{{ConvertAbbrev\|Countries\|alpha-3\|USA}}`	United States
`{{ConvertAbbrev\|ISO 3166-2\|CA\|AB}}`	404 Error: Country not found. The country name or abbreviation you typed may be invalid. It is also possible that the {{ConvertAbbrev}} family simply does not yet support administrative divisions in this country. For a full list of supported ISO 3166-2 countries, click here.
`{{ConvertAbbrev\|Countries\|Mexico\|DF}}`	404 Error: Country not found. The country name or abbreviation you typed may be invalid. It is also possible that the {{ConvertAbbrev}} family simply does not yet support administrative divisions in this country. For a full list of supported ISO 3166-2 countries, click here.
`{{ConvertAbbrev\|ISO 639-1\|ru}}`	Russian
`{{ConvertAbbrev\|Languages\|zh}}`	Chinese

Sub-pages

For a list of all the sub-pages of this template, see: Special:PrefixIndex/Template:ConvertAbbrev

Tài liệu bên trên được truyền tải từ Bản mẫu:ConvertAbbrev/doc.
Biên tập viên sửa đổi có thể thử nghiệm trong các trang chỗ thử và trường hợp kiểm thử của bản mẫu này.
Xin hãy bổ sung các thể loại vào trang con /doc. Các trang con của bản mẫu này.