Xử lý sự cố và giới hạn

Những lỗi thường gặp, cách bật bộ gõ bằng dòng lệnh và các giới hạn đã biết.

Nội dung

Xử lý sự cố
Bật bộ gõ bằng dòng lệnh
Giới hạn

Xử lý sự cố

Triệu chứng	Cách xử lý
Thỉnh thoảng đảo hoặc mất chữ ở một ứng dụng	Tăng `pause_ms` lên 40–60. Nếu vẫn lỗi, đặt ứng dụng đó sang `preedit`.
Gõ `as` ra `aá` trong Files hoặc ứng dụng GTK4	Cài bản 0.1.1 trở lên: GTK4 tự dùng chế độ `surrounding`.
Terminal trong VS Code, Cursor, Orca (xterm.js) hay ra chữ lạ như `đưực`	xterm.js xử lý phím BackSpace và chữ commit không đồng bộ khi gõ nhanh. Nếu chấp nhận gạch chân, đặt app đó sang `preedit` (trang Ứng dụng, ví dụ `code`, `cursor`, `orca`). Đổi lại có thể thấy gạch chân ở chữ đang gõ, nên mặc định không đặt sẵn.
Gõ lệnh trong terminal bị đổi chữ (`off` thành `of`)	Tắt tiếng Việt cho terminal (trang Ứng dụng trong cửa sổ cài đặt).
`www` thành `ww` ở thanh địa chỉ	Hành vi hoàn tác phím lặp như Unikey. Gõ `wwww`, hoặc dán URL.
Settings hiện `gtv-telex` thay vì tên	Đóng và mở lại Settings sau `ibus restart`, hoặc đăng xuất rồi đăng nhập.
Menu ứng dụng vẫn hiện tên cũ “GTV Preferences”	GNOME Shell còn cache. Nhấn Alt+F2, gõ `r`, Enter (X11), hoặc đăng nhập lại.
Không thấy bộ gõ trong danh sách	`ibus write-cache && ibus restart`, rồi `ibus list-engine \| grep gtv`. Vẫn không thấy thì đăng xuất rồi đăng nhập.
Có engine nhưng chưa nằm trong Input Sources	Chạy `/usr/lib/ibus-gtv/gtv-activate`, hoặc làm tay theo mục bên dưới.
Rớt chữ thỉnh thoảng ở thanh địa chỉ Chrome	Đặt `address_bar_mode = "preedit"` (không rớt chữ nhưng Chrome gạch chân chữ đang gõ), hoặc tăng `pause_ms`.
Cần xem log	`touch ~/.config/gtv/debug` bật log chi tiết vào `~/.config/gtv/engine.log` ngay, không cần restart IBus (có hiệu lực ở lần focus kế tiếp). `rm ~/.config/gtv/debug` để tắt. Log ghi cả nội dung phím đã gõ, đừng gõ mật khẩu khi bật.

Bật bộ gõ bằng dòng lệnh

Trình cài đặt thường tự làm các bước này. Nếu cần làm tay, chạy trong phiên đồ họa của bạn (không cần sudo):

ibus write-cache && ibus restart          # nạp lại danh sách engine
ibus list-engine | grep gtv               # phải thấy gtv-telex và gtv-vni

# Thêm vào Input Sources (giữ các bộ gõ đang có), rồi chọn nó
gsettings get org.gnome.desktop.input-sources sources
gsettings set org.gnome.desktop.input-sources sources "[('xkb', 'us'), ('ibus', 'gtv-telex')]"
gsettings set org.gnome.desktop.input-sources current 1

Giá trị sources phải gồm cả những bộ gõ mà gsettings get vừa in ra. current là vị trí, tính từ 0, của gtv-telex trong danh sách đó.

Giới hạn

Chỉ thử trên Ubuntu 24.04, X11, IBus 1.5.29, GNOME 46. Wayland không nhận diện được ứng dụng nên luôn dùng chế độ mặc định (backspace). Chưa test.
Chưa thử: Firefox (snap), Qt/KDE, JetBrains, Warp, Lark, Postman, Cursor. Nếu một ứng dụng lỗi, xem bảng ở trên.
select và forward-keys chỉ để thử nghiệm.
Từ tiếng Anh trùng với âm tiết Việt hợp lệ (is ra í, or ra ỏ) vẫn bị biến đổi, như Unikey và bộ gõ macOS. Chuyển input source hoặc gõ đôi phím dấu để hoàn tác.
Chưa có phím tắt bật/tắt tiếng Việt riêng cho từng ứng dụng lúc đang gõ. Dùng danh sách trong cài đặt hoặc đổi input source.
Chưa có Esc-to-revert và phím tắt bao dấu bằng ngoặc.

Gặp lỗi khác? Mở issue trên GitHub kèm tên ứng dụng và phiên bản.