Documentation Index
Fetch the complete documentation index at: https://mintlify.com/khaphanspace/gonhanh.org/llms.txt
Use this file to discover all available pages before exploring further.
Overview
Gõ Nhanh supports two popular Vietnamese input methods:Telex
Modern, letter-based method using
s, f, r, x, j, w, zVNI
Number-based method using
1, 2, 3, 4, 5, 6, 7, 8, 9, 0Telex Input Method
Overview
Telex uses letter keys that don’t exist in Vietnamese (f, j, w, z) to add diacritics.
Examples
- Basic Typing
- Words
- Flexible Order
Undo Mechanism
Type the same key twice to undo:Issue #312: When a vowel already has a modifier (horn/circumflex/breve), typing the same vowel again adds it raw, not as a modifier.Example:
chưa + a → chưaa (NOT chưâ)Implementation
Telex is implemented incore/src/input/telex.rs:
VNI Input Method
Overview
VNI uses number keys (0-9) to add diacritics.Examples
- Basic Typing
- Words
- Undo
Implementation
VNI is implemented incore/src/input/vni.rs:
Tone Placement Rules
Gõ Nhanh follows official Vietnamese tone placement rules (Quy tắc đặt dấu thanh).Rule 1: Single Vowel
Tone mark goes directly on the vowel:Rule 2: Two Vowels
Check the pattern in this table:| Pattern | Tone Position | Example |
|---|---|---|
| ai, ay | First | mái, máy |
| ao, au | First | sáo, sáu |
| âu, ây | First | cấu, cây |
| eo, êu | First | kéo, kêu |
| ia, iê | Second | kía, tiếng |
| iu | First | tíu |
| oa, oă | Second | hoá, xoắn |
| oe | Second | khoé |
| oi, ôi | First | tói, tôi |
| ơi | First | cơi |
| ua | First/Second | múa / quá |
| uê, uy | Second | tuế, thuý |
| ui, uô | First | túi, cuốn |
| ưa, ươ | First | mứa, được |
| ưi, ưu | First | gửi, lưu |
| yê | Second | yếu |
Special case for “ua”:
- After
q: tone on a (quá, quả) - Without
q(open syllable): tone on u (múa, cúa) - With final consonant: tone on a (muán, quán)
Rule 3: Three Vowels
Tone mark goes on the middle vowel (with modifier if present):| Pattern | Tone Position | Example |
|---|---|---|
| iêu | ê | tiêu, kiều |
| yêu | ê | yêu |
| oai | a | ngoài, loại |
| oay | a | xoáy |
| oeo | e | khoẻo |
| uây | â | khuấy |
| uôi | ô | cuối, tuổi |
| ươi | ơ | mười, tươi |
| ươu | ơ | rượu, hươu |
| uyê | ê | quyền, chuyện |
Old vs New Style
There are two schools of tone placement for some patterns:| Pattern | Old Style | New Style | Note |
|---|---|---|---|
| oa | hòa | hoà | Old: tone on o |
| oe | hòe | hoè | New: tone on a/e |
| uy | thùy | thuỳ | (per Bộ GD&ĐT 2018) |
Validation
Gõ Nhanh validates Vietnamese syllables using a whitelist approach:Valid Patterns
29 Valid Diphthongs (Nguyên âm đôi)
29 Valid Diphthongs (Nguyên âm đôi)
10 Valid Triphthongs (Nguyên âm ba)
10 Valid Triphthongs (Nguyên âm ba)
Invalid Patterns (Blocked)
Invalid Patterns (Blocked)
Auto-Capitalization
Gõ Nhanh automatically capitalizes the first letter after:- Period (
.) - Exclamation mark (
!) - Question mark (
?) - Enter key
FAQ
Can I switch between Telex and VNI?
Can I switch between Telex and VNI?
Yes! Go to Settings → General → Input Method and select your preferred method. The change takes effect immediately.
Why does 'text' become 'têt'?
Why does 'text' become 'têt'?
In Telex,
e + e → ê and x → ngã. Use Auto-Restore by pressing Space, or press ESC to restore manually.Which method is more popular?
Which method is more popular?
Telex is more popular among younger users and programmers. VNI is preferred by those who learned it first or need to avoid conflicts with code editing.
Can I customize the key mappings?
Can I customize the key mappings?
No, key mappings are fixed to follow standard Telex and VNI conventions. This ensures compatibility with other Vietnamese IMEs.
Technical Reference
For complete Vietnamese language rules, see:- Vietnamese Language System - Complete reference
- Validation Algorithm - Technical details
Related Features
Auto-Restore
Automatic English word restoration
Shortcuts
Text expansion shortcuts