diff --git a/doc/vietnamese.jax b/doc/vietnamese.jax new file mode 100644 index 000000000..a187920c2 --- /dev/null +++ b/doc/vietnamese.jax @@ -0,0 +1,80 @@ +*vietnamese.txt* For Vim バージョン 9.1. Last change: 2024 Dec 04 + + + VIMリファレンスマニュアル by Phạm Bình An + + +Vim でのベトナム語サポート *vietnamese* *Vietnamese* + +1. はじめに |vietnamese-intro| +2. ベトナム語キーマップ |vietnamese-keymap| +3. ローカライゼーション |vietnamese-l10n| + +=============================================================================== +1. はじめに + *vietnamese-intro* +Vim は、以下の方法でベトナム語をサポートしている: + +- 組み込みの |vietnamese-keymap| により、US キーボードレイアウトを使用して + |Insert-mode| および |search-commands| でベトナム語の文字を入力できる。 +- ベトナム語へのローカライズ。|vietnamese-l10n| を参照。 + +=============================================================================== +2. ベトナム語のキーマップ + *vietnamese-keymap* +言語を切り替えるには、システムネイティブのキーボードスイッチャーを使用するか、 +以下のように Vim ディストリビューションに含まれるベトナム語キーマップのいずれ +かを使用する > + :set keymap=vietnamese-telex_utf-8 +< +詳細については |'keymap'| を参照。 + +後者の場合、ベトナム語入力メソッドエンジン (IME) がない場合でも、または Vim を +システム全体のキーボード設定から独立させたい場合 (|'imdisable'| が設定されてい +る場合) でも、ベトナム語を入力できる。また、キーを |:map| してキーボードを切り +替えることもできる。 + +Vim には次のベトナム語キーマップが付属している: +- *vietnamese-telex_utf-8* Telex インプットメソッド、|UTF-8| エンコード。 +- *vietnamese-viqr_utf-8* VIQR インプットメソッド、|UTF-8| エンコード。 +- *vietnamese-vni_utf-8* VNI インプットメソッド、|UTF-8| エンコード。 + + *vietnamese-ime_diff* +これらのキーマップは最小限に抑えるように設計されているため、対応するインプット +メソッドのすべての機能をサポートしているわけではない。違いは以下のとおり: + +- 各文字は個別に入力することしかできず、最初に基本文字を入力し、その後に分音記 + 号を入力する。例えば、|vietnamese-vni_utf-8| を使用して `nến` という単語を入 + 力するには、`nen61` や `ne6n1` ではなく、`ne61n` と入力する必要がある +- 発音区別符号が 1 つ以上ある文字の場合、声調記号の前に母音記号を入力する必要 + がある。例えば、|vietnamese-telex_utf-8| を使用して `ồ` と入力するには、 + `ofo` ではなく `oof` と入力する必要がある。 +- |vietnamese-telex_utf-8| では、発音区別記号付きの大文字を生成するには、すべ + て大文字を入力する必要がある。例えば、`Ừ` は `UWF` と入力する必要がある。 +- |vietnamese-telex_utf-8| を使用すると、VNI からのエスケープ文字 `\` が追加さ + れるため、曖昧さを引き起こす可能性のある `ooo` の入力が削除される。例えば、 + 単語 `Đoòng` を入力するには、`DDo\ofng` と入力する。 +- `w[]{}` スタイルを含む Simple Telex (v1 と v2 の両方) はサポートされていな + い。 +- Telex の `z` または VNI と VIQR の `0` を使用して分音記号を削除することはサ + ポートされていない。 + +=============================================================================== +3. ローカライゼーション + *vietnamese-l10n* +Vim の |messages| はベトナム語でも使用できる。メッセージをベトナム語で表示した +い場合は、ベトナム語ロケールの名前を引数として |:language| コマンドを実行する。 +例えば、 > + :language vi_VN +< または > + :language vi_VN.utf-8 +< +Note ベトナム語ロケールの名前はシステムによって異なる場合があることに注意。詳 +細については |mbyte-first| を参照。 + +|vimtutor| はベトナム語でも使用可能である。ベトナム語で Vimtutor を起動するに +は、端末で次のコマンドを実行する: > + vimtutor vi +< +=============================================================================== +vim:tw=78:ts=8:noet:ft=help:norl: diff --git a/en/vietnamese.txt b/en/vietnamese.txt new file mode 100644 index 000000000..ff4f4641c --- /dev/null +++ b/en/vietnamese.txt @@ -0,0 +1,82 @@ +*vietnamese.txt* For Vim version 9.1. Last change: 2024 Dec 04 + + + VIM REFERENCE MANUAL by Phạm Bình An + + +Vietnamese language support in Vim *vietnamese* *Vietnamese* + +1. Introduction |vietnamese-intro| +2. Vietnamese keymaps |vietnamese-keymap| +3. Localization |vietnamese-l10n| + +=============================================================================== +1. Introduction + *vietnamese-intro* +Vim supports Vietnamese language in the following ways: + +- Built-in |vietnamese-keymap|, which allows you to type Vietnamese characters + in |Insert-mode| and |search-commands| using US keyboard layout. +- Localization in Vietnamese. See |vietnamese-l10n| + +=============================================================================== +2. Vietnamese keymaps + *vietnamese-keymap* +To switch between languages you can use your system native keyboard switcher, +or use one of the Vietnamese keymaps included in the Vim distribution, like +below > + :set keymap=vietnamese-telex_utf-8 +< +See |'keymap'| for more information. + +In the latter case, you can type Vietnamese even if you do not have a +Vietnamese input method engine (IME) or you want Vim to be independent from a +system-wide keyboard settings (when |'imdisable'| is set). You can also |:map| +a key to switch between keyboards. + +Vim comes with the following Vietnamese keymaps: +- *vietnamese-telex_utf-8* Telex input method, |UTF-8| encoding. +- *vietnamese-viqr_utf-8* VIQR input method, |UTF-8| encoding. +- *vietnamese-vni_utf-8* VNI input method, |UTF-8| encoding. + + *vietnamese-ime_diff* +Since these keymaps were designed to be minimalistic, they do not support all +features of the corresponding input methods. The differences are described +below: + +- You can only type each character individually, entering the base letter first + and then the diacritics later. For example, to type the word `nến` using + |vietnamese-vni_utf-8|, you must type `ne61n`, not `nen61` or `ne6n1` +- For characters with more than 1 diacritic, you need to type vowel mark before + tone mark. For example, to type `ồ` using |vietnamese-telex_utf-8|, you need + to type `oof`, not `ofo`. +- With |vietnamese-telex_utf-8|, you need to type all uppercase letters to + produce uppercase characters with diacritics. For example, `Ừ` must be typed + as `UWF`. +- With |vietnamese-telex_utf-8|, the escape character `\` from VNI is added, + hence the confusing `ooo` input to type `oo` is removed, which could lead to + ambiguities. For example, to type the word `Đoòng`, you would type + `DDo\ofng`. +- Simple Telex (both v1 and v2), including the `w[]{}` style, is not + supported. +- Removing diacritics using `z` in Telex or `0` in VNI and VIQR is not supported. + +=============================================================================== +3. Localization + *vietnamese-l10n* +Vim |messages| are also available in Vietnamese. If you wish to see messages +in Vietnamese, you can run the command |:language| with an argument being the +name of the Vietnamese locale. For example, > + :language vi_VN +< or > + :language vi_VN.utf-8 +< +Note that the name of the Vietnamese locale may vary depending on your system. +See |mbyte-first| for details. + +|vimtutor| is also available in Vietnamese. To start Vimtutor in Vietnamese, +run the following command in terminal: > + vimtutor vi +< +=============================================================================== +vim:tw=78:ts=8:noet:ft=help:norl: