fcitx5-mcbopomofo: 小麥注音輸入法 fcitx5 模組

本專案是小麥注音的 Linux 版本，功能與小麥注音 macOS 版同步：

• 提供自動選字注音
• 提供傳統注音（打一字選一字「ㄅ半」注音）
• 用戶自訂詞功能：可在組字區加詞，亦可直接修改用戶詞庫檔案及刪詞設定檔
• 記憶使用者最近選字
• 支援標準、倚天、許氏鍵盤、倚天 26 鍵等常見注音鍵盤排列
• 便捷輸入各種中文標點符號
• 支援微軟新注音式「游標後」跟漢音式「游標前」選字

與 macOS 版的主要差別如下：

• 使用 fcitx5 內建選字窗
• 繁簡轉換使用 fcitx5 內建 chttrans 模組

此外，在專案組織上：

• 目前直接使用 McBopomofo macOS 版產生的資料檔
• 語言模型及選字引擎程式碼目前從 macOS 版拷貝過來

安裝方式

以下說明如何在 Ubuntu 22.04 LTS 上面編譯安裝。

請先安裝 fcitx5, CMake, 以及以下開發用模組：

sudo apt install \
    pkg-config fcitx5 libfcitx5core-dev libfcitx5config-dev libfcitx5utils-dev fcitx5-modules-dev \
    cmake extra-cmake-modules gettext libfmt-dev libicu-dev libjson-c-dev

然後在本專案的 git 目錄下執行以下指令：

mkdir -p build
cd build
cmake ../ -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_BUILD_TYPE=Release
make
sudo make install

# 初次安裝後，執行以下指令，小麥注音 icon 就會出現在 fcitx5 選單中
sudo update-icon-caches /usr/share/icons/*

在其他 Linux Distro 或 FreeBSD 上安裝

• 我們利用 wiki 收集在其他 Linux distro 或 FreeBSD 上安裝的方式，歡迎提供內容與指正。

C++ 語法風格

clang-format

本專案的程式碼大致採用 Google C++ style。我們已經設定好 .clang-format 檔案，請在發送 PR 前使用 clang-format 重整風格即可。

find src/ -name *.cpp -o -name *.h | xargs clang-format -i

本專案跟 Google C++ style 不同的地方如下：

• 我們不使用 snake_case 變數名稱。變數或參數一律使用 lowerCamelCase 風格。
• 成員函數不使用 Foo::PascalCaseMethod()。成員函數一律使用 Foo::lowerCamelCaseMethod() 風格。

cpplint

我們也推薦使用 cpplint 檢查 C++ 常見問題。

cpplint --filter=-build/c++11,-build/include_alpha,-build/include_order,-build/include_subdir,-readability/nolint,-runtime/references,-whitespace --recursive src/

clang-tidy

編譯時開啟 -DENABLE_CLANG_TIDY=On cmake flag 以啟用 clang-tidy 檢查 (需要 clang 14+)。

cmake ../ -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_BUILD_TYPE=Release -DENABLE_CLANG_TIDY=On

社群公約

歡迎小麥注音 Linux 用戶回報問題與指教，也歡迎大家參與小麥注音開發。

我們採用了 GitHub 的通用社群公約。公約的中文版請參考這裡的翻譯。我們以上述公約，作為維護小麥注音社群的準則。