Chuyển tới nội dung chính

Cấu hình Fcitx5 nâng cao trên Linux

Mở mục khớp với vấn đề bạn gặp sau khi cài. Nếu đang cài lần đầu, hãy bắt đầu từ bước thiết lập Fcitx5 trên máy.

Kiểm tra theo trường hợp​

Đăng nhập lại rồi nhưng máy chưa nhận thiết lập

Thử khởi động lại máy một lần. Dịch vụ đọc tệp environment.d đôi khi vẫn chạy sau khi bạn đăng xuất nên chưa đọc lại tệp.

Nếu fcitx5-diagnose vẫn báo thiếu biến sau khi khởi động lại, hãy kiểm tra máy đọc thiết lập ở đâu.

  • GNOME qua GDM hoặc Plasma từ 5.22. Có thể dùng ~/.config/environment.d/fcitx5.conf khi phiên làm việc đọc thiết lập từ dịch vụ systemd của tài khoản.
  • Máy dùng Bash để đăng nhập. Bash tìm lần lượt ~/.bash_profile, ~/.bash_login rồi ~/.profile và chỉ đọc tệp đầu tiên có trên máy. Thêm các dòng có export vào đúng tệp đó. Ví dụ, Fedora và Arch thường có sẵn ~/.bash_profile, còn Ubuntu thường chỉ có ~/.profile. Nếu chưa có tệp nào, tạo ~/.bash_profile.
  • Thiết lập cho nhiều tài khoản. Quản trị viên có thể dùng /etc/profile nếu phiên đăng nhập được cấu hình để đọc tệp này.

Mỗi biến chỉ cần đặt ở một nơi. Nếu dùng shell khác Bash, xem shell đó đọc tệp nào khi đăng nhập và dùng cú pháp của nó. Tài liệu Fcitx5 về biến môi trường

Chỉ một ứng dụng Qt không gõ được trên Wayland

Nếu Funput gõ được trong trình soạn thảo nhưng ứng dụng Qt gặp lỗi, chọn theo giao diện đang dùng.

QT_IM_MODULES=wayland;fcitx

Tên biến mới có chữ S ở cuối. Nếu bạn đặt biến trong tệp Bash thay vì environment.d, nhớ thêm dấu ngoặc kép vì dấu ; có nghĩa riêng trong Bash: export QT_IM_MODULES="wayland;fcitx". Giữ QT_IM_MODULE=fcitx nếu ứng dụng Qt 5 hoặc Qt 6 cũ hơn vẫn cần. Đăng xuất rồi đăng nhập lại để thử. Tài liệu Fcitx5 cho Qt trên Wayland

Muốn dùng công cụ thiết lập sẵn trên X11

Nếu bước kiểm tra trả về x11, chọn công cụ theo bản phân phối.

  • Debian, Ubuntu và các bản dựa trên Debian. Chạy im-config -n fcitx5. Nếu muốn chọn trong một cửa sổ, chạy im-config rồi chọn fcitx5.
  • Fedora. Chạy sudo dnf install fcitx5-autostart.
  • Arch, openSUSE hoặc bản khác. Mở phần cấu hình X11.

Máy dùng Wayland? Mở bộ chọn cấu hình Fcitx5.

Cửa sổ gợi ý nhấp nháy trên KDE Wayland

Kiểm tra xem GTK_IM_MODULE hoặc QT_IM_MODULE có đang được đặt cho cả phiên không.

  1. Nếu từng đặt bằng im-config, mở lại công cụ đó và chọn thiết lập mặc định của giao diện. Nếu từng thêm bằng tay, bỏ các dòng đặt hai biến này trong tệp bạn đã sửa.
  2. Áp dụng lại cấu hình Fcitx5 cho KDE Wayland.

Nếu chỉ một ứng dụng chạy qua XWayland cần QT_IM_MODULE, đặt cho riêng ứng dụng đó. Ví dụ, nếu lệnh mở WPS Writer là wps:

env QT_IM_MODULE=fcitx wps
Cần nạp lại Fcitx5 trên KDE Wayland

Nếu đã chọn Fcitx5 trong System Settings → Virtual Keyboard, hãy lưu công việc, đăng xuất rồi đăng nhập lại. KDE cấp kết nối bộ gõ khi bạn đăng nhập. Dùng fcitx5 -r hoặc chọn Restart ở khay hệ thống có thể làm mất kết nối này đến lần đăng nhập sau.

Xem máy đã nạp những thiết lập nào

Mở Terminal sau khi đăng nhập lại và chạy:

fcitx5-diagnose

Kết quả cho biết Fcitx5 đang đọc các biến nào và đã nạp bộ gõ nào. Nếu Funput đã được chọn nhưng bạn vẫn chưa gõ được, xem trang xử lý sự cố.