ibus-bamboo

IBus Bamboo - Bộ gõ tiếng Việt cho Linux/BSD

Lưu ý :

Dự án đã bị đình trệ trong 1 thời gian khá dài và có thể sẽ không được duy trì trong tương lai. Các bạn có thể sử dụng fcitx5-unikey là giải pháp thay thế khác (gần như tính năng đã hoàn thành và hỗ trợ Wayland tốt hơn). Nếu bạn muốn cứu sống ibus-bamboo hoặc thảo luận về tương lai của dự án tại đây https://github.com/BambooEngine/ibus-bamboo/issues/590

Mục lục

• Sơ lược tính năng
• Hướng dẫn cài đặt
  • Dành cho Ubuntu, Mint và các distro tương tự
  • Dành cho Arch Linux và các distro tương tự
  • NixOS
  • Void Linux
  • Cài đặt từ OpenBuildService
  • Cài đặt từ mã nguồn
• Hướng dẫn sử dụng
• Báo lỗi
• Giấy phép

Sơ lược tính năng

• Hỗ trợ tất cả các bảng mã phổ biến:
  • Unicode, TCVN (ABC)
  • VIQR, VNI, VPS, VISCII, BK HCM1, BK HCM2,…
  • Unicode UTF-8, Unicode NCR - for Web editors.
• Các kiểu gõ thông dụng:
  • Telex, Telex W, Telex 2, Telex + VNI + VIQR
  • VNI, VIQR, Microsoft layout
• Nhiều tính năng hữu ích, dễ dàng tùy chỉnh:
  • Kiểm tra chính tả (sử dụng từ điển/luật ghép vần)
  • Dấu thanh chuẩn và dấu thanh kiểu mới
  • Bỏ dấu tự do, Gõ tắt,...
  • 2666 emojis từ emojiOne
• Sử dụng phím tắt Shift+~ để loại trừ ứng dụng không dùng bộ gõ, chuyển qua lại giữa các chế độ gõ: * Pre-edit (default) * Surrounding text, IBus ForwardKeyEvent,...

Hướng dẫn cài đặt

Ubuntu và các distro tương tự

sudo add-apt-repository ppa:bamboo-engine/ibus-bamboo
sudo apt-get update
sudo apt-get install ibus ibus-bamboo --install-recommends
ibus restart
# Đặt ibus-bamboo làm bộ gõ mặc định
env DCONF_PROFILE=ibus dconf write /desktop/ibus/general/preload-engines "['BambooUs', 'Bamboo']" && gsettings set org.gnome.desktop.input-sources sources "[('xkb', 'us'), ('ibus', 'Bamboo')]"

Arch Linux và các distro tương tự

ibus-bamboo hiện đã có mặt trên AUR. Đừng quên để lại 1 vote cho các maintainer để 1 ngày không xa nó được vào kho repo chính thức của Arch nhé!

NixOS

Nixpkgs

ibus-bamboo đã có mặt trên repo chính của Nixpkgs. Để cài đặt hãy chắc chắn rằng code sau đã có trong file cấu hình NixOS của bạn.

{
 i18n.inputMethod = {
  enabled = "ibus";
  ibus.engines = with pkgs.ibus-engines; [
    bamboo
  ];
 };
}

Ibus-bamboo flake

Nếu bạn không thích sử dụng package từ Nixpkgs, bạn có thể sử dụng bản mới nhất flake từ repo ibus-bamboo. Lưu ý rằng phương pháp này chỉ hoạt động với flake.

Đầu tiên hãy chắc chắn rằng bạn đã thêm repo path vào trong nixos flake của bạn.

Code ví dụ ở flake.nix:

{
  inputs = {
    nixpkgs = {
      url = "github:nixos/nixpkgs/nixos-24.05";
    };

    ibus-bamboo = {
      url = "github:BambooEngine/ibus-bamboo";
    };
  };

  outputs = {
    self,
    nixpkgs,
    ibus-bamboo
  }@inputs:
  let
    inherit (self) outputs;

    system = "x86_64-linux";
  in
  {
    nixosConfigurations = {
      nixos = nixpkgs.lib.nixosSystem {
        specialArgs = { inherit inputs outputs system; };

        # Some nixos config
      };
    };
  }
}

Tiếp theo bạn hãy tạo biến và thêm nó vào ibus.engines

Code ví dụ ở input-method.nix:

{ inputs, system, ... }:

let
  bamboo = inputs.ibus-bamboo.packages."${system}".default;
in
{
  i18n.inputMethod = {
    enabled = "ibus";
    ibus.engines = [
      bamboo
    ];
  };
}

Bước cuối cùng là cập nhập lại flake và chuyển đổi hệ thống sang cấu hình mới là xong.

Void Linux

ibus-bamboo đã có mặt trên repo chính của Void Linux. Các bạn có thể cài đặt trực tiếp.

sudo xbps-install -S ibus-bamboo

Cài đặt từ OpenBuildService

Hướng dẫn sử dụng

Điểm khác biệt giữa ibus-bamboo và các bộ gõ khác là ibus-bamboo cung cấp nhiều chế độ gõ khác nhau (1 chế độ gõ có gạch chân và 5 chế độ gõ không gạch chân; tránh nhầm lẫn chế độ gõ với kiểu gõ, các kiểu gõ bao gồm telex, vni, ...).

Để chuyển đổi giữa các chế độ gõ, chỉ cần nhấn vào một khung nhập liệu (một cái hộp để nhập văn bản) nào đó, sau đó nhấn tổ hợp Shift+~, một bảng với những chế độ gõ hiện có sẽ xuất hiện, bạn chỉ cần nhấn phím số tương ứng để lựa chọn.

Một số lưu ý:

• Một ứng dụng có thể hoạt động tốt với chế độ gõ này trong khi không hoạt động tốt với chế độ gõ khác.
• Các chế độ gõ được lưu riêng biệt cho mỗi phần mềm (firefox có thể đang dùng chế độ 3, trong khi libreoffice thì lại dùng chế độ 2).
• Bạn có thể dùng chế độ Thêm vào danh sách loại trừ để không gõ tiếng Việt trong một chương trình nào đó.
• Để gõ ký tự ~ hãy nhấn tổ hợp Shift+~ 2 lần.
• Hỗ trợ Wayland trong IBus hiện chưa tốt lắm. Để có trải nghiệm gõ phím tốt hơn, hãy sử dụng Xorg.

Báo lỗi

Trước khi báo lỗi vui lòng đọc những vấn đề thường gặp và tìm vấn đề của mình ở trong đó.

Nếu trang phía trên không giải quyết vấn đề của bạn, vui lòng báo lỗi tại đây

Đóng góp cho dự án

Nếu bạn muốn hiểu thêm về dự án có thể xem thêm ở file này. HACKING.md

Đừng ngần ngại nếu bạn có 1 Pull Request hữu dụng. Hãy gửi lại nếu bạn muốn đóng góp cho dự án.

Giấy phép

ibus-bamboo là phần mềm tự do nguồn mở, được phát hành dưới các quy định ghi trong Giấy phép Công cộng GNU (GNU General Public License v3.0).