{"id":13591350,"url":"https://github.com/whyjz/rime-moetaigi","last_synced_at":"2025-04-13T10:05:03.059Z","repository":{"id":37556219,"uuid":"381368295","full_name":"whyjz/rime-moetaigi","owner":"whyjz","description":"萌台語：基於萌典 API 的 RIME 臺語輸入法，使用注音符號輕鬆輸入台語。","archived":false,"fork":false,"pushed_at":"2022-07-15T06:37:22.000Z","size":9114,"stargazers_count":41,"open_issues_count":4,"forks_count":2,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-03-27T01:23:51.346Z","etag":null,"topics":["bopomofo","ime","moedict","rime","taigi"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"cc0-1.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/whyjz.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-06-29T13:07:19.000Z","updated_at":"2025-03-17T15:57:17.000Z","dependencies_parsed_at":"2022-07-14T08:31:21.928Z","dependency_job_id":null,"html_url":"https://github.com/whyjz/rime-moetaigi","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/whyjz%2Frime-moetaigi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/whyjz%2Frime-moetaigi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/whyjz%2Frime-moetaigi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/whyjz%2Frime-moetaigi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/whyjz","download_url":"https://codeload.github.com/whyjz/rime-moetaigi/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248695438,"owners_count":21146954,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bopomofo","ime","moedict","rime","taigi"],"created_at":"2024-08-01T16:00:56.461Z","updated_at":"2025-04-13T10:05:03.034Z","avatar_url":"https://github.com/whyjz.png","language":"Python","funding_links":[],"categories":["漢語方言"],"sub_categories":[],"readme":"# rime-moetaigi 萌台語: 基於萌典 API 的 RIME 臺語輸入法\n\n萌台語是[中州韻輸入法引擎 (Rime)](https://rime.im/) 的台語輸入法方案，建立在從[萌典 API](https://www.moedict.tw/about.html) 取得的《[臺灣閩南語常用詞辭典](https://twblg.dict.edu.tw/)》兩萬多筆詞條與其發音，讓您使用注音符號（[臺語方音符號](https://zh.wikipedia.org/wiki/%E8%87%BA%E7%81%A3%E6%96%B9%E9%9F%B3%E7%AC%A6%E8%99%9F)）輕鬆輸入台語。\n\n![你嘛來試看覓！](doc/images/moetaigi-try.gif)\n\n## 特點\n\n1. **相容**　台語的 44 個注音符號與 9 個聲調符號被妥善的安置在鍵盤上，以最大化符合中文注音輸入法使用者的習慣與記憶。幾乎不需要學習新的鍵盤配置，只要你使用注音與大千式鍵盤，就可以運用相同的鍵位來拚打出台語注音！[這裡是詳細的鍵盤配置。](#鍵盤配置)\n2. **精確**　台語詞彙的注音拚寫法與對應漢字以《臺灣閩南語常用詞辭典》的[用字原則](https://twblg.dict.edu.tw/holodict_new/compile1_3_9_2.jsp)為基準。可精確的輸入注音與聲調來打字、選字。因此，我保證在《萌典》查到的台語條目可以準確無誤地用此輸入法打出來！\n\n![骨力](doc/images/moetaigi_eg1.gif)\n\n3. **快速**　使用多種來源的字、詞頻表（見[資料來源](#鳴謝與資料來源)）對台語用字進行排序，並且支援簡拼（不打聲調或只打聲符）輸入，幫助使用者在輸入最少拼音符號、最少選字的情況下打出台語文。此外，內建 AI 更會記錄使用者的常用字，打越多直接選到正確字的機會就越高。\n\n![莫佇遐假鬼假怪](doc/images/moetaigi_eg2.gif)\n\n4. **詳盡**　與《萌典》同步，透過 API 收錄《[臺灣閩南語常用詞辭典]》本文的兩萬多筆台語字詞。未來更計畫收錄同辭典附錄中的補充字詞。\n5. **學習**　「我想要『ㄎㄨㄟˋ』腳」、「『ㄙㄨㄧˋ』啦！」、「『鏡頭』、『縣長』的台語是？」... 不管你是只會念某個台語詞但不知道對應的漢字怎麼寫，還是不知道某個詞彙的台語怎麼念，抑或只是想確定某字的聲調，使用萌台語的簡拚、中文反查，以及注音顯示功能，都可以幫助你快速找到答案。一邊輸入台語，一邊精進你的台語文能力。\n\n![這隻豬予伊飼甲肥朒朒](doc/images/moetaigi_eg3.gif)\n\n6. **標點**　利用 Rime 輸入法方案的特點，打台文的同時可快速輸入常用的全形標點符號。[對應鍵位請參考這裡。](#輸入全形標點符號)\n7. **開源**　開放原始碼並使用 CC0 公眾領域授權，任何人都可以不受限制地使用或改進此作品，歡迎各路英雄一同精進本專案、改善程式碼、補充台語字典...！\n\n## 安裝 \n\n### Windows\n\n1. 安裝 [Rime](https://rime.im/) 的 Windows 發行版「**小狼豪**」\n2. 下載 [rime-moetaigi](https://github.com/whyjz/rime-moetaigi/archive/refs/heads/main.zip)\n3. 解壓縮後找到 `rime-moetaigi/GenYoGothic-L.ttc` 這個檔案，這是**源樣黑體 L**的字型檔。需要安裝此檔案到作業系統內，所有注音與臺文漢字才能正常顯示。字型的授權請見[這裡的說明。](#授權條款)\n4. 在同一個資料夾內找到 `moetaigi-tsuim.schema.yaml`、`moetaigi.dict.yaml`、`moetaigi.extended.dict.yaml`、`moetaigi.unspaced.dict.yaml`、`moetaigi.unspaced.schema.yaml`，以及`tsuim.yaml` 六個檔案，複製到 `%APPDATA%\\Rime` 資料夾或是用戶自訂的文件夾位置底下。\n5. 切換至新安裝的 Rime 輸入法，打開控制選單，**重新佈署** Rime 以後，進入**輸入法設定**啟用「萌台語-注音」(如下圖)。*(您不需要啟用「萌台語-無空格辭典」；這個辭典只要能在輸入法設定中搜尋到，就可以被「萌台語-注音」利用。)*\n\n![啟用「萌台語-注音」](doc/images/rime-moetaigi-install.png)\n\n5. 按下 \u003ccode\u003ectrl + `\u003c/code\u003e 後選擇「萌台語-注音」，就可以開始打台語文了！\n\n### Ubuntu\n\n1. 安裝 [Rime](https://rime.im/) 的 ibus 模組，又稱為「**中州韻**」：\n```sh\n$ sudo apt install ibus-rime\n```\n2. 下載 [rime-moetaigi](https://github.com/whyjz/rime-moetaigi/archive/refs/heads/main.zip)\n3. 解壓縮後找到 `rime-moetaigi/GenYoGothic-L.ttc` 這個檔案，這是**源樣黑體 L**的字型檔。需要安裝此檔案到作業系統內，所有注音與臺文漢字才能正常顯示。字型的授權請見[這裡的說明。](#授權條款) 你可以安裝 Ubuntu 的 font-manager 後以 GUI 簡單安裝：\n```sh\n$ sudo apt install font-manager\n```\n或是使用純指令列的方法安裝字形，詳細作法可參考[此網頁。](https://linuxconfig.org/how-to-install-fonts-on-ubuntu-20-04-focal-fossa-linux)\n\n4. 進入 `ibus-setup`：\n```sh\n$ ibus-setup\n```\n在 General - Fontand Style 欄位中，勾選 \"Use custom font\"，選擇剛剛安裝的源樣黑體 L，在字型列表中的名稱是 `GenYoGothic TW L`。\n\n5. 在第二步驟中被解壓縮的 `rime-moetaigi` 資料夾內找到 `moetaigi-tsuim.schema.yaml`、`moetaigi.dict.yaml`、`moetaigi.extended.dict.yaml`、`moetaigi.unspaced.dict.yaml`、`moetaigi.unspaced.schema.yaml`，以及`tsuim.yaml` 六個檔案，複製到 `~/.config/ibus/rime` 資料夾或是用戶自訂的文件夾位置底下。\n6. 使用文字編輯器開啟 `~/.config/ibus/rime/default.yaml` （如果找不到檔案的話，就去 `/usr/share/rime-data` 資料夾中把同名的檔案複製過來，再開啟複製的檔案），在 `schema_list` 群組中加入兩行後存檔：\n```\n  - schema: moetaigi.unspaced\n  - schema: moetaigi-tsuim\n```\n7. 切換至新安裝的 Rime 輸入法，在右上視窗打開控制選單，**佈署** Rime 以後，就可以使用 \u003ccode\u003ectrl + `\u003c/code\u003e 切換至「萌台語-注音」。*(您不需要啟用「萌台語-無空格辭典」；這個辭典只要能在輸入法設定中搜尋到，就可以被「萌台語-注音」利用。)*\n\n\n### 其他作業系統\n\n安裝方式大同小異。注意在 iOS 上 Rime 的發行版稱為鼠鬚管。另外需注意的一點是不同作業系統的[用戶文件夾位置](https://github.com/rime/home/wiki/UserData)也不一樣，需要先確認後再行安裝。\n\n## 簡易功能鍵、輸入鍵位指引\n\n- \u003ccode\u003ectrl + `\u003c/code\u003e: 切換至萌台語-注音輸入法或 Rime 提供的其他輸入法\n- `shift`: 切換漢字 / 英數輸入\n- `空白鍵` : 候選字視窗存在時，會把選中的字放進佇列。如果只有佇列存在，則會把所有在佇列中的字送上螢幕。\n- `Enter`: 把所有字 (在佇列中的字與在候選字視窗內選中的字) 送上螢幕\n- \u003ccode\u003ectrl + 數字鍵\u003c/code\u003e: 依照編號選擇候選字視窗內的字放進佇列\n- \u003ccode\u003e`\u003c/code\u003e: 進入《**中文反查**》模式，用中文注音輸入漢字或查詢對應的台語發音。（如果欲查詢的字沒有台語發音的話，會顯示出本字的漢語拼音。）\n- `'`: 進入《**注音顯示**》模式，打字的時候待選詞組的注音會顯示在詞組的右邊。\n- 在輸入注音後按下 `'`: 強制分開不同字的注音，例如打「匏仔」簡拼時可以輸入 `ㄅ'ㄚ`，以防輸入法搜尋到 `ㄅㄚ` 的結果。\n\n### 鍵盤配置\n\n注音符號的鍵盤配置請參考下圖。注意深綠色的注音需搭配 `shift` 輸入；例如 `shift + d` 可以輸入「ㄫ」。符號代表的發音請參考臺語注音符號的[維基說明](https://zh.wikipedia.org/wiki/%E8%87%BA%E7%81%A3%E6%96%B9%E9%9F%B3%E7%AC%A6%E8%99%9F)。\n\n![鍵盤配置](doc/images/Keyboard_layout_Tsuim.png)  \u003c!-- 要更新 --\u003e\n*萌台語-注音輸入法的注音配置。**淺綠色底的按鍵**：與大千式注音鍵盤相同或發音相似的注音。**紅色底的按鍵**：與大千式注音鍵盤不同的注音。**黃色底的按鍵**：聲調符號。 修改自 [Sakurambo](https://commons.wikimedia.org/wiki/File:Keyboard_layout_Zhuyin.svg) 的作品。本作品以 [CC BY-SA 4.0 授權](https://creativecommons.org/licenses/by-sa/4.0/deed.zh_TW)發布。*\n\n### 輸入全形標點符號：\n\n| 輸入 | 呈現 | \n| ---- | ---- |\n| `.` | ，|\n| `\u003e` | 。 |\n| `\"` | 、 |\n| `\\` | ； |\n| `=` | ： |\n| `[` | 「或〈 |\n| `]` | 」或〉 |\n| `[[` | 『或《 |\n| `]]` | 』或》 |\n| `{` | （ |\n| `}` | ） |\n| `?` | ？ |\n| \u003ccode\u003e\u0026#124;\u003c/code\u003e | ！ |\n| `+++` | … |\n| `_` | ─ (連接號或半破折號)|\n| `+` | ‧ (音界號，又稱間隔號) |\n| `~` | ～ |\n\n## 《萌台語》完整說明文檔\n\n這裡可以查閱《萌台語》的安裝、部署、輸入台文，以及使用上的各式細節。（之後補上）\n\n## 鳴謝與資料來源\n\n感謝以下專案與資料來源，以及背後的作者與貢獻者們，讓本輸入法得以奠基與實現：\n\n1. [Rime 中州韻輸入法引擎](https://rime.im/) ([佛振](https://github.com/lotem))\n2. [《臺灣閩南語常用詞辭典》](http://twblg.dict.edu.tw/)\n3. [萌典](https://www.moedict.tw/)與[萌典 API](https://github.com/g0v/moedict-webkit) ([唐鳳](https://github.com/audreyt))\n4. 本輸入法使用如下的台語字詞頻率統計資料：\n   - 楊允言等 (2005)，[台語文語料庫蒐集及語料庫為本台語書面語音節詞頻統計](http://ip194097.ntcu.edu.tw/giankiu/keoe/KKH/guliau-supin/guliau-supin.asp)，國科會計畫編號 `NSC 93-2213-E-122-001`，存取日期 2021/09/26。\n   - 夢生 (Yuh-ru/Dyertung, 2018)，[部育部臺灣閩南語常用詞辭典語詞字頻表](https://blog.xuite.net/hn88196555/twblog/563937744)，發表於隨意窩 xuite.net，存取日期 2021/09/26。\n5. 輸入法使用字型：[源樣黑體](https://github.com/ButTaiwan/genyog-font) ([柯志杰 (But Ko)](https://github.com/ButTaiwan))\n6. 感謝以下 Rime 的官方/客製化輸入法 schema 為本專案的開發提供了範本與靈感：\n   - [『注音 洋蔥』](https://deltazone.pixnet.net/blog/post/264319309-%E9%BC%A0%E9%AC%9A%E7%AE%A1%E6%B3%A8%E9%9F%B3%E6%96%B9%E6%A1%88---%E7%AC%A6%E5%90%88%E4%B8%80%E8%88%AC%E6%B3%A8%E9%9F%B3%E4%BD%BF%E7%94%A8%E8%80%85%E7%BF%92%E6%85%A3%E8%A8%AD)(L'Étranger Onion)\n   - [『Rime 注音輸入方案』](https://github.com/rime/rime-bopomofo)(佛振)\n   - [『意傳台文輸入法』](https://github.com/i3thuan5/rime-taigi)(ÌTHUÂNKHOKI 意傳科技)\n   - [『RIME 台語輸入方案』](https://github.com/glll4678/rime-taigi)(莊銘彥)\n   - [『Rime 粵語拼音方案』中關於詞彙反查的討論](https://github.com/rime/rime-cantonese/pull/80) ([Ayaka Mikazuki](https://github.com/ayaka14732))\n\n\u003c!-- 昆蟲 https://www.facebook.com/morethandee/photos/a.369345609816495/1097476730336709/?type=3 --\u003e\n\n## 授權條款\n\n![CC0](http://i.creativecommons.org/p/zero/1.0/88x31.png)\n\n在本作品中，**除了源樣黑體 L 的字型檔、從不同來源取得的原始資料，以及少數以其他授權發佈的圖片外**，作者鄭懷傑 (Whyjay Zheng) 已在法律許可的範圍內，拋棄該著作依著作權法所享有之權利，包括所有相關與鄰接的法律權利，並宣告將該著作貢獻至公眾領域。你可以複製、修改、發布或展示此作品，亦可進行商業利用，完全不需要經過許可。更多資訊可參閱 [LICENSE](LICENSE) 檔或[這裡](https://creativecommons.org/publicdomain/zero/1.0/deed.zh_TW)。\n\n以下是仍保有著作權並提供不同程度使用許可的部分：\n\n- 源樣黑體 L 是改造過後 Adobe 開發的「思源黑體」字型，由[柯志杰 (But Ko)](https://github.com/ButTaiwan) 所開發，[專案網址可由此進](https://github.com/ButTaiwan/genyog-font)。萌台語輸入法基於 [SIL Open Font License 1.1](SIL_Open_Font_License_1.1.txt) 的授權協議，以相同的授權條款再散佈此字型。\n- 《臺灣閩南語常用詞辭典》的詞目資料 `rime-moetaigi/dict_prep/source_data/詞目總檔.csv` 使用 [CC BY-ND 3.0 臺灣授權](http://twblg.dict.edu.tw/holodict_new/compile1_6_1.jsp) 再發布。\n- 《台語文語料庫蒐集及語料庫為本台語書面語音節詞頻統計》網站擷取之詞頻資料 `rime-moetaigi/dict_prep/source_data/詞頻表1*`，資料作者保留所有權利。\n- 夢生《部育部臺灣閩南語常用詞辭典語詞字頻表》部落格擷取之詞頻資料 `rime-moetaigi/dict_prep/source_data/詞頻表2*`，資料作者保留所有權利。\n\n\n對於以其他授權發佈的圖片，您可以在圖片說明文字中找到授權條款。\n\n## 如何參與開發\n\n萌台語歡迎各路英雄一同參與開發！文檔錯字、補充說明，乃至程式碼改進、擴增新功能... 不管您想到的是什麼，您可以：\n\n1. 開 Issue 提出您的問題與建議，或是未來開發的想法\n2. 隨時送一個 PR 過來，一起完善萌台語輸入法！\n\n[您可以參考這裡獲得本專案的更多細節。](#萌台語完整說明文檔)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwhyjz%2Frime-moetaigi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwhyjz%2Frime-moetaigi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwhyjz%2Frime-moetaigi/lists"}