vietnamese.txt (3504B)
1 *vietnamese.txt* For Vim version 9.2. Last change: 2026 Feb 14 2 3 4 VIM REFERENCE MANUAL by Phạm Bình An 5 6 7 Vietnamese language support in Vim *vietnamese* *Vietnamese* 8 9 1. Introduction |vietnamese-intro| 10 2. Vietnamese keymaps |vietnamese-keymap| 11 3. Localization |vietnamese-l10n| 12 13 ============================================================================== 14 1. Introduction 15 *vietnamese-intro* 16 Vim supports Vietnamese language in the following ways: 17 18 - Built-in |vietnamese-keymap|, which allows you to type Vietnamese characters 19 in |Insert-mode| and |search-commands| using US keyboard layout. 20 - Localization in Vietnamese. See |vietnamese-l10n| 21 22 ============================================================================== 23 2. Vietnamese keymaps 24 *vietnamese-keymap* 25 To switch between languages you can use your system native keyboard switcher, 26 or use one of the Vietnamese keymaps included in the Vim distribution, like 27 below > 28 :set keymap=vietnamese-telex_utf-8 29 < 30 See 'keymap' for more information. 31 32 In the latter case, you can type Vietnamese even if you do not have a 33 Vietnamese input method engine (IME) or you want Vim to be independent from a 34 system-wide keyboard settings (when 'imdisable' is set). You can also |:map| 35 a key to switch between keyboards. 36 37 Vim comes with the following Vietnamese keymaps: 38 - *vietnamese-telex_utf-8* Telex input method, |UTF-8| encoding. 39 - *vietnamese-viqr_utf-8* VIQR input method, |UTF-8| encoding. 40 - *vietnamese-vni_utf-8* VNI input method, |UTF-8| encoding. 41 42 *vietnamese-ime_diff* 43 Since these keymaps were designed to be minimalistic, they do not support all 44 features of the corresponding input methods. The differences are described 45 below: 46 47 - You can only type each character individually, entering the base letter 48 first and then the diacritics later. For example, to type the word `nến` 49 using |vietnamese-vni_utf-8|, you must type `ne61n`, not `nen61` or `ne6n1` 50 - For characters with more than 1 diacritic, you need to type vowel mark 51 before tone mark. For example, to type `ồ` using |vietnamese-telex_utf-8|, you 52 need to type `oof`, not `ofo`. 53 - With |vietnamese-telex_utf-8|, you need to type all uppercase letters to 54 produce uppercase characters with diacritics. For example, `Ừ` must be typed 55 as `UWF`. 56 - With |vietnamese-telex_utf-8|, the escape character `\` from VNI is added, 57 hence the confusing `ooo` input to type `oo` is removed, which could lead to 58 ambiguities. For example, to type the word `Đoòng`, you would type 59 `DDo\ofng`. 60 - Simple Telex (both v1 and v2), including the `w[]{}` style, is not 61 supported. 62 - Removing diacritics using `z` in Telex or `0` in VNI and VIQR is not supported. 63 64 ============================================================================== 65 3. Localization 66 *vietnamese-l10n* 67 Vim |messages| are also available in Vietnamese. If you wish to see messages 68 in Vietnamese, you can run the command |:language| with an argument being the 69 name of the Vietnamese locale. For example, > 70 :language vi_VN 71 < or > 72 :language vi_VN.utf-8 73 < 74 Note that the name of the Vietnamese locale may vary depending on your system. 75 See |mbyte-first| for details. 76 77 |vimtutor| is also available in Vietnamese. To start Vimtutor in Vietnamese, 78 run the following command in terminal: > 79 vimtutor vi 80 < 81 ============================================================================== 82 vim:tw=78:ts=8:noet:ft=help:norl: