Bản mẫu:Engvar/doc

Sở thích cá nhân
Mẫu: dùng WP:Engvar trong bản mẫu
Home country (Quê gốc)	Australia
Favourite things (Thứ yêu thích)
Colour (Màu)	Blue
Association Football team (Đội tuyển bóng đá)	FC Kuusysi
	Trong 'bài viết' mẫu này có thiết lập tham số bản mẫu: \|engvar=Australian

Sở thích cá nhân
Mẫu: dùng WP:Engvar trong bản mẫu
Home country (Quê gốc)	Alaska
Favorite things (Thứ yêu thích)
Color (Màu)	Blue
Soccer team (Đội tuyển bóng đá)	FC Kuusysi
	Trong 'bài viết' mẫu này có thiết lập tham số bản mẫu: \|engvar=en-US

Sở thích cá nhân
Mẫu: dùng WP:Engvar trong bản mẫu
Home country (Quê gốc)	Wales
Favourite things (Thứ yêu thích)
Colour (Màu)	Blue
Football team (Đội tuyển bóng đá)	FC Kuusysi
	Trong 'bài viết' mẫu này có thiết lập tham số bản mẫu: \|engvar=(unspecified)

Đây là một trang con tài liệu dành cho Bản mẫu:Engvar.
Nó gồm có các thông tin hướng dẫn sử dụng, thể loại và các nội dung khác không thuộc về phần trang bản mẫu gốc.

Bản mẫu này được sử dụng ở rất nhiều trang, vì thế những thay đổi đến nó sẽ hiện ra rõ ràng. Vui lòng thử nghiệm các thay đổi ở trang con /sandbox, /testcases của bản mẫu, hoặc ở không gian người dùng của bạn. Cân nhắc thảo luận các thay đổi tại trang thảo luận trước khi áp dụng sửa đổi.

Bản mẫu này sử dụng Lua:

module:Engvar

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 Bản mẫu:Engvar/doc Bản mẫu:Engvar/doc

Articles specify the English variety parameter for relevant templates like {{example|engvar=en-US}}. They do not use {{engvar}}.
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

{{infobox| title = Sở thích cá nhân| above = Mẫu: dùng [[WP:ENGVAR|WP:Engvar]] trong bản mẫu| abovestyle = background:#ddd; font-weight:normal; font-size:smaller;| headerstyle = background:lemonchiffon| label1 = Home country {{small|(Quê gốc)}}| data1 = {{{home country|}}}| header2 = {{engvar|defaultWord=Favourite |defaultLang=en-GB | engvar={{{engvar|auto}}} |en-US=Favorite }} things {{small|(Thứ yêu thích)}}| label3 = {{engvar|defaultWord=Colour |defaultLang=en-GB | engvar={{{engvar|auto}}} |en-US=Color }} {{small|(Màu)}}| data3 = {{{color|}}}| label4 = {{engvar|defaultWord=Football |defaultLang=en-GB | engvar={{{engvar|auto}}} |en-US=Soccer |en-AU=Association Football}} team {{small|(Đội tuyển bóng đá)}}| data4 = {{{team|}}}| below = Trong 'bài viết' mẫu này có thiết lập tham số bản mẫu: {{para|1=engvar|2={{{engvar|(unspecified)}}}}}| belowstyle = background:#ddd;}}

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 Bản mẫu:Engvar/doc Bản mẫu:Engvar/doc

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 Bản mẫu:Engvar/doc Bản mẫu:Engvar/doc

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 Bản mẫu:Engvar/doc Bản mẫu:Engvar/doc

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 Bản mẫu:Engvar/doc Bản mẫu:Engvar/doc

Đây là tài liệu Dữ liệu bản mẫu cho bản mẫu này được sử dụng bởi Trình soạn thảo trực quan và các công cụ khác; xem báo cáo sử dụng tham số hàng tháng cho bản mẫu này.

Dữ liệu bản mẫu cho Engvar

Không có miêu tả.

Tham số bản mẫu
Tham số		Miêu tả	Kiểu	Trạng thái
Default spelling	`defaultword`	The default word, usually the word in the English variety most often used Ví dụ colour	Chuỗi dài	khuyên dùng
Default English variety	`defaultLang`	Adding this helps document your {{engvar}} setting Giá trị đề nghị `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` Ví dụ en-US	Chuỗi dài	khuyên dùng
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. Giá trị đề nghị `{{{engvar\|auto}}}` `{{{engvar\|}}}` `auto`	Chuỗi dài	bắt buộc
Suppress maintenance category	`engvarCat`	không có miêu tả Giá trị đề nghị `{{{engvarCat\|yes}}}` `no` Mặc định yes	Chuỗi dài	khuyên dùng
Fallback	`fallback`	Whether Commonwealth English languages should fallback to en-GB if not specified Mặc định false unless engvar=auto	Luận lý	tùy chọn
Maintenance category sort key	`engvarCatSort`	không có miêu tả Mặc định {{pagename}}	Chuỗi dài	tùy chọn
American English spelling	`en-US`	không có miêu tả Ví dụ color	Chuỗi dài	tùy chọn
Australian English spelling	`en-AU`	không có miêu tả	Chuỗi dài	tùy chọn
British English spelling	`en-GB`	không có miêu tả	Chuỗi dài	tùy chọn
Canadian English spelling	`en-CA`	không có miêu tả	Chuỗi dài	tùy chọn
Hiberno-English (Irish-English) spelling	`en-EI`	không có miêu tả	Chuỗi dài	tùy chọn
Hong Kong English spelling	`en-HK`	không có miêu tả	Chuỗi dài	tùy chọn
Indian English spelling	`en-IN`	không có miêu tả	Chuỗi dài	tùy chọn
Jamaican English spelling	`en-JM`	không có miêu tả	Chuỗi dài	tùy chọn
Malawian English spelling	`en-MW`	không có miêu tả	Chuỗi dài	tùy chọn
New Zealand English spelling	`en-NZ`	không có miêu tả	Chuỗi dài	tùy chọn
Nigerian English spelling	`en-NG`	không có miêu tả	Chuỗi dài	tùy chọn
Pakistani English spelling	`en-PK`	không có miêu tả	Chuỗi dài	tùy chọn
Philippine English spelling	`en-PH`	không có miêu tả	Chuỗi dài	tùy chọn
Scottish English spelling	`en-SCO`	không có miêu tả	Chuỗi dài	tùy chọn
Singapore English spelling	`en-SG`	không có miêu tả	Chuỗi dài	tùy chọn
South African English spelling	`en-ZA`	không có miêu tả	Chuỗi dài	tùy chọn
Trinidadian English spelling	`en-TT`	không có miêu tả	Chuỗi dài	tùy chọn
British (Oxford) English spelling	`en-OED`	không có miêu tả	Chuỗi dài	tùy chọn
IUPAC spelling	`en-IUPAC`	không có miêu tả	Chuỗi dài	tùy chọn