Wikipedia:AVIM/Tiếng Anh

WP:GTV/A

While visiting the Vietnamese Wikipedia, you might have noticed that every page has an additional set of options on its left side. The Gõ tiếng Việt panel below the search above the Toolbox is for customizing AVIM, a combination Vietnamese input method editor, written in JavaScript and released under an MIT-style license. These input methods allow users to type correctly accented Vietnamese text using a standard, English-layout keyboard.

AVIM has been in use at the Vietnamese Wikipedia since 2005. JavaScript-based input methods are typical of Vietnamese-language websites, since most operating systems come with poor support for the language. The Vietnamese Wiktionary, Vietnamese Wikibooks, Vietnamese Wikisource, Vietnamese Wikiquote, and Vietnamese Wikivoyage also feature AVIM. Other Wikimedia wikis have similar keyboarding features, thanks to the Narayam extension.

How to use it

Configure

The panel you see on each page allows you to choose which input method to type with:

Automatic (tự động), a combination of the Telex and VNI input methods
Telex
VNI
VIQR
VIQR*, a variant of VIQR that uses * instead of +.

Each input method has its advantages and disadvantages, so AVIM lets each user use the one he or she prefers. There are two additional options:

Bỏ dấu kiểu cũ allows you to choose the style of Vietnamese orthography you want to write with. The "old" style places accents above the first vowel in words that end in diphthongs, so both xo'a and xoa' come out as xóa. If this option is unchecked, both come out as xoá.
Đúng chính tả works kind of like a spell checker. Say a word does not conform to Vietnamese spelling rules – which typically means it's a foreign word or name. If you have chosen the Telex input method, as normally comes out as á, but if the spell-checking option is enabled and you type in Washington, you will get Washington; if the option is disabled, you will get Wáhington.

Type

Mark	Example	Key(s) pressed
Mark	Example	Telex	VNI	VIQR	VIQR*
Tone marks
Acute (sắc)	á	s	1	'	'
Grave (huyền)	à	f	2	`	`
Hook (hỏi)	ả	r	3	?	?
Tilde (ngã)	ã	x	4	~	~
Dot below (nặng)	ạ	j	5	.	.
Other diacritical marks
Circumflex (mũ)	â	(double vowel)	6	^	^
Horn (móc)	ơ	w	7	+	*
Breve (trăng)	ă	w	8	(	(
Stroke (gạch ngang)	đ	dd	9	dd	dd
(Remove a diacritic)		z	0	-	-

A diacritic can be added anywhere in the word following its vowel, and the horn is duplicated as necessary for "ươ". For instance, using VIQR, đường can be written ddu+o+`ng, duong+`d, or even dduong+`'`'`.

Privacy

Aside from the four cookies used by any standard MediaWiki installation – viwiki_session, viwikiUserID, viwikiUserName, and viwikiUserToken – the Vietnamese Wikipedia uses four additional cookies to store your preferences for AVIM. The settings can be modified under the search box of any page here and contain no personally-identifiable information. In fact, these cookies are used only by the AVIM gadget and are never sent to the server in any form. The four cookies contain the following information:

AVIM_on_off: 0 if the input method is enabled, or 1 if it is disabled
AVIM_method: an integer from 0 to 4, depending on the input method selected (auto, Telex, VNI, VIQR, or VIQR*)
AVIM_ckspell: 1 if "dead keys" only place accent marks on words that conform to Vietnamese spelling rules, or 0 if this feature is disabled
AVIM_daucu: 1 if accent marks are placed on the first vowel in a final diphthong (e.g., xóa), or 0 if they are placed on the second vowel (e.g., xoá)

You can delete these cookies at any time; doing so will revert AVIM to its default settings.

Uninstall

To keep Wikipedia from loading AVIM, simply disable the "AVIM" and "Hộp Gõ tiếng Việt" gadgets in your Preferences. You can also delete the cookies listed above.

External links

Hieu's Blog, written by AVIM developer Hiếu Trần Đặng