Wikipedia:AVIM/Tiếng Anh
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'aandxoa'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,
asnormally comes out as á, but if the spell-checking option is enabled and you type inWashington, you will get Washington; if the option is disabled, you will get Wáhington.
Type
| Mark | Example | Key(s) pressed | |||
|---|---|---|---|---|---|
| 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_off0if the input method is enabled, or1if it is disabledAVIM_method- an integer from 0 to 4, depending on the input method selected (auto, Telex, VNI, VIQR, or VIQR*)
AVIM_ckspell1if "dead keys" only place accent marks on words that conform to Vietnamese spelling rules, or0if this feature is disabledAVIM_daucu1if accent marks are placed on the first vowel in a final diphthong (e.g., xóa), or0if 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.
See also
External links
- Hieu's Blog, written by AVIM developer Hiếu Trần Đặng