蓬萊韻

說明書 › 設定目錄

自己改設定檔

給習慣改 YAML 的人。蓬萊設定做得到的事不用來這裡;這一頁講檔案在哪、怎麼寫、蓬萊多了哪些設定。

使用者資料夾

所有個人的東西都在 ~/Library/Rime。在 Finder 按 ⇧⌘G,輸入這個路徑就能打開。

檔案放什麼
penglai_zhuyin.custom.yaml蓬萊注音這個方案的個人設定:讀音、學習、漏打聲母、聯想……
default.custom.yaml不分方案的設定:方案清單、每頁候選數、方案選單的快捷鍵。
sable.custom.yaml貂毫前端的設定:選字窗的樣式、配色、字級。
custom_phrase.txt自訂短語。
penglai_hidden.txt藏起來的詞,一行一個。
penglai_zhuyin.userdb學習紀錄(資料夾)。不要手動改。
penglai_predict.db自己的聯想資料(選用,沒有就用貂毫附的)。

方案檔 penglai_zhuyin.schema.yaml 和詞典 penglai_zhuyin.dict.yaml 不要直接改,個人的設定一律寫在 .custom.yaml。

custom 檔怎麼寫

.custom.yaml 只寫「跟預設不一樣的地方」,全部放在 patch: 底下。鍵用斜線寫出完整路徑,加上引號:

patch:
  "translator/revert_learning_seconds": 30   # 撤銷學習的時限改成 30 秒
  "switches/@3/reset": 2                     # 讀音預設用兼收並蓄

幾個規則:

  • 值是清單時,寫出來就是整份換掉,不是加在後面。要加在清單後面,鍵的最後寫 /+(例如 "engine/filters/+")。
  • 清單裡的第幾項用 @ 加數字,從 0 算起:switches/@3 是方案 switches 清單的第四項(讀音)。
  • 縮排用空白,不要用 Tab。

存檔之後要重新部署才會生效:輸入法選單的「重新部署」,或蓬萊設定「變更紀錄」頁的「重新部署」。

蓬萊設定也是改這幾個檔,而且只改那一個值所在的那一行,你手寫的其他內容不會被動到。兩邊可以混著用。

貂毫的外觀

選字窗的樣式寫在 sable.custom.yaml,鍵的名稱跟鼠鬚管的 squirrel.yaml 一樣,只是檔名換成貂毫的。例如字級:

patch:
  "style/font_point": 18

從鼠鬚管換過來的人,可以把 squirrel.custom.yaml 的內容抄到 sable.custom.yaml。

蓬萊多了哪些設定

下面這些只有蓬萊的引擎會讀,官方的 librime 會忽略。都寫在 penglai_zhuyin.custom.yaml,括號裡是預設值。

鍵作用
translator/max_user_phrase_syllables(10)整句可以用的學習紀錄最長幾個字。Rime 原本寫死 5。
translator/revert_learning_seconds(15)送出後幾秒內按 ⌫ 撤銷學習。Rime 原本寫死 3。
translator/forget_last_code("77")打這組鍵忘掉上一筆。空字串=關掉。
translator/forget_last_history(10)連續忘掉最多往前幾筆。
translator/dictionary_exclude_file(penglai_hidden.txt)藏起來的詞記在哪個檔。空字串=關掉,刪除候選照 Rime 原本的做法(只刪學習紀錄)。
switches/@3/reset(0)讀音:0 蓬萊音、1 中州音、2 兼收並蓄。
switches/@4/reset(0)聯想:0 關、1 開。
predictor/max_candidates(0)聯想每次最多列幾個,0=資料裡有幾個列幾個。
predictor/max_iterations(0)選了聯想之後最多再接著聯想幾次,0=不限。
predictor/max_context_chars(16)聯想時往前看幾個已送出的字。

另外兩個是 Rime 1.17 起才有、蓬萊改了預設值的:

鍵作用
translator/max_sentences(5)整句候選列幾種。Rime 預設 1。
translator/sentence_cutoff_threshold(100)整句候選的截斷門檻,100 等於不截斷。

關掉筆畫查字

蓬萊設定「輸入」頁的「筆畫查字」就是改這一行:

patch:
  "recognizer/patterns/reverse_lookup": ""

官方文件

Rime 本身的設定項目很多,這裡沒列的可以查 Rime 的定製指南和設定項目說明。官方文件寫 squirrel.custom.yaml 的地方,在貂毫要換成 sable.custom.yaml。