Cèṭa'an:Engvar/doc

This template is used inside other templates. It allows templates to show national varieties of English, when |engvar= is passed by each article.

For example, one template can display "football" for |engvar=en-UK articles, and "soccer" for |engvar=en-US articles.

Usage

1. Articles specify the English variety parameter for relevant templates like {{example|engvar=en-US}}. They do not use {{engvar}}.
2. Templates use {{engvar}}. It should not forget to pass-through |engvar={{{engvar|}}}

...
| label3 = {{engvar |defaultWord=Colour |defaultLang=en-UK |en-US=Color |engvar={{{engvar|auto}}} }}
|  data3 = {{{color|}}}
| label4 = {{engvar |defaultWord=Football |defaultLang=en-UK |en-US=Soccer |engvar={{{engvar|auto}}} }} team
|  data4 = {{{team|}}}
...

The |defaultWord= be shown by default. But if an article asks for an English variety that has a corresponding parameter specified in the template, the value will be shown.

In the example, the template specified a British English word as default whenever no |engvar= is specified by the article. The word can be changed in an American English article by that article specifying |engvar=en-US. The fallback 'auto' value means it will try to determine the language based on templates like {{Use British English}} or {{Use American English}} being present on the page if no engvar is specified.

Note: {{engvar}} is unrelated to parameter names like |color= vs. |colour=. See programming option |data3={{{color|{{{colour|}}} }}}

Example

Consider an example template, a fictive {{infobox personal likes}}. The demo is encoded in {{Engvar/doc/infobox demo}}.

Template code

[[:Cèṭa'an:Engvar/doc/infobox demo]]

Three articles

{{Engvar/doc/infobox demo
| home country = Wales
| color = Blue
| team  = [[FC Kuusysi]]
<!-- |engvar= not set; expect defaults -->
}}

{{Engvar/doc/infobox demo
| home country = Alaska
| color = Blue
| team  = [[FC Kuusysi]]
| engvar= en-US
}}

{{Engvar/doc/infobox demo
| home country = Australia
| color = Blue
| team  = [[FC Kuusysi]]
| engvar= Australian
}}

A live example

Currently, {{infobox element}} has five {{engvar}} words. Phosphorus shows |engvar=en-UK despite the |engvar=en-US default.

Parameter list

Template

{{engvar
| defaultWord =
| defaultLang =
| engvar = <!-- Pass-through the editor's choice, set to 'auto' to automatically detect -->
| en-XX = <!-- add country code for XX, and the nation language word -->
| en-YY = <!-- add more varieties as might be needed -->
| engvarCat =  <!-- '=no' will suppress message category in article page -->
| fallback = <!-- set to 'true' to allow commonwealth languages to fallback to 'en-GB'. False by default unless engvar='auto'. -->
}}

Article

{{example
| engvar =
| engvarCat =
}}

List of English varieties

In the template, use the exact ISO-code as the parameter name like |en-GB=vapour. Write |en-US=soccer not |American English=soccer. Needed varieties have articles using the template and words differing from the default.

English variety	ISO-code
American English	en-US
Australian English	en-AU
British English	en-GB
Canadian English	en-CA
Hiberno-English (Irish-English)	en-EI
Hong Kong English	en-HK
Indian English	en-IN
Jamaican English	en-JM
Malawian English	en-MW
New Zealand English	en-NZ
Nigerian English	en-NG
Pakistani English	en-PK
Philippine English	en-PH
Scottish English	en-SCO
Singapore English	en-SG
South African English	en-ZA
Trinidadian English	en-TT
British English Oxford spelling British (Oxford) English Oxford English Dictionary (OED)	en-OED
IUPAC spelling	en-IUPAC

There is backwards compatibility for leeway in articles. |engvar=en-US, |engvar=United States, |engvar=US can all show the |en-US=football variety.

Maintenance category

Articles with an invalid |engvar= will be placed in the hidden maintenance category Category:Articles using an unknown Template:Engvar option. Articles listed may need editing.

An article's requested |engvar= may be unspecified in the template. For example, if an article uses {{example|engvar=South African English}} but the template has no |en-ZA=, then the template will return |defaultWord=default color name. The category will not be used.

When this categorization is not desired for a whole template, set |engvarCat=no in the template

Otherwise pass-through this setting from the article: |engvarCat={{{engvarCat|yes}}}. This allows the editor to switch categorization off per article.

Articles are sorted by |engvarCatSort= or {{pagename}} by default. Note that other templates will fill this category. Set this parameter like |engvarCatSort=Personal prefs in a template to group its listings under "P".

Template data

Ariya dokumenna TemplateData ka'angghuy template nèka èghuna'aghi bi' VisualEditor tor alat laènna; see a monthly parameter usage report for this template in articles.

TemplateData untuk Engvar

Tidak ada keterangan.

Parameter templat

Parameter		Keterangan	Jenis	Status
Default spelling	defaultword	The default word, usually the word in the English variety most often used Contoh colour	Kata	disarankan
Default English variety	defaultLang	Adding this helps document your {{engvar}} setting Nilai yang disarankan en-US en-AU en-GB en-CA en-EI en-HK en-IN en-JM en-MW en-NZ en-NG en-PK en-PH en-SCO en-SG en-ZA en-TT en-OED en-IUPAC Contoh en-US	Kata	disarankan
English variety	engvar	English variety to use. Set to 'auto' to try to detect variety based on templates such as {{Use British English}} or {{EngvarB}} being present on the page. Nilai yang disarankan {{{engvar|auto}}} {{{engvar|}}} auto	Kata	wajib diisi
Suppress maintenance category	engvarCat	tidak ada keterangan Nilai yang disarankan {{{engvarCat|yes}}} no Baku yes	Kata	disarankan
Fallback	fallback	Whether Commonwealth English languages should fallback to en-GB if not specified Baku false unless engvar=auto	Boolean	opsional
Maintenance category sort key	engvarCatSort	tidak ada keterangan Baku {{pagename}}	Kata	opsional
American English spelling	en-US	tidak ada keterangan Contoh color	Kata	opsional
Australian English spelling	en-AU	tidak ada keterangan	Kata	opsional
British English spelling	en-GB	tidak ada keterangan	Kata	opsional
Canadian English spelling	en-CA	tidak ada keterangan	Kata	opsional
Hiberno-English (Irish-English) spelling	en-EI	tidak ada keterangan	Kata	opsional
Hong Kong English spelling	en-HK	tidak ada keterangan	Kata	opsional
Indian English spelling	en-IN	tidak ada keterangan	Kata	opsional
Jamaican English spelling	en-JM	tidak ada keterangan	Kata	opsional
Malawian English spelling	en-MW	tidak ada keterangan	Kata	opsional
New Zealand English spelling	en-NZ	tidak ada keterangan	Kata	opsional
Nigerian English spelling	en-NG	tidak ada keterangan	Kata	opsional
Pakistani English spelling	en-PK	tidak ada keterangan	Kata	opsional
Philippine English spelling	en-PH	tidak ada keterangan	Kata	opsional
Scottish English spelling	en-SCO	tidak ada keterangan	Kata	opsional
Singapore English spelling	en-SG	tidak ada keterangan	Kata	opsional
South African English spelling	en-ZA	tidak ada keterangan	Kata	opsional
Trinidadian English spelling	en-TT	tidak ada keterangan	Kata	opsional
British (Oxford) English spelling	en-OED	tidak ada keterangan	Kata	opsional
IUPAC spelling	en-IUPAC	tidak ada keterangan	Kata	opsional

See also

• HELP:ENGVAR
• Category:Articles using an unknown Template:Engvar option
• ISO 3166-1 alpha-2 -- The 2-letter country code
• - debugging