按鍵配置

預設配置為什麼是「終端安全」

因為終端機不是每一個組合鍵都收得到。

爾雅內建的預設配置叫 Erya Terminal Safe。它刻意避開三類在很多環境裡按不動的組合：

代價是十六個進階動作預設沒有綁鍵：八個常用語／巨集（見 2.4.8）、四個矩形搬動與一個矩形填滿（見 2.2.6）、兩個段落重排相關（見 3.1.8），以及「顯示游標位置」（狀態列已經有了）。功能都在，只是要自己指定按鍵，完整清單見 4.4.6。

內附的十二套配置

在 keymap/ 目錄裡，全部都是可以直接選用的 TOML。

預設與 Classic 差最多的幾個鍵

在系統設定裡換一套

最簡單的做法，不必碰任何檔案。

1. 按 F2 開啟系統設定。
2. ↑ ↓ 切到「按鍵配置」那一列（選中的那一列會反白，前面有 ▶）。
3. ← → 換配置。清單是從 keymap/ 目錄讀出來的。
4. Enter 套用。訊息列說「已套用設定：Erya Classic／正體中文」，而且立刻對所有頁籤生效。
5. Esc 取消，什麼都不改。

按鍵配置編輯器

在爾雅裡面改按鍵，改完另存成自己的 TOML。

• 輸入的按鍵無法解析、或跟別的動作衝突時，訊息列會說「無法更新按鍵配置：…」，並且維持原狀。
• 另存時會問檔名，成功後說「已另存按鍵配置：…」。
• 另存新檔不會覆寫既有檔案。檔名已存在時會失敗，不會默默蓋掉別人的配置。

設定檔長什麼樣

一個 name 加一個 [bindings] 區段。

先產生一份含全部動作名稱的起點：

erya --print-default-keymap > keymap.toml

• 一個動作可以綁多個按鍵：寫成陣列。
• 空陣列 [] 代表停用這個動作。
• 沒列出來的動作沿用預設值。所以只想改兩個鍵的話，檔案裡就只要寫那兩行。
• name 是顯示在系統設定與第一列標題上的名稱。
• 動作名稱的完整清單見 4.4，或直接看 --print-default-keymap 的輸出。

按鍵名稱怎麼寫

修飾鍵用 + 串起來，大小寫都可以。

寫法例："Ctrl+S"、"Alt+Shift+Right"、"F12"、"ctrl+shift+f"（大小寫不分）。

設定檔放哪裡才會被讀到

三種指定方式，由高到低。

1. --keymap <檔案>——這一次執行用這一份，優先度最高。
2. ERYA_KEYMAP 環境變數——沒給 --keymap 時用它。
3. 平台的預設路徑——上面兩個都沒有時，自動去這裡找：

衝突與回退

設定檔有問題時，爾雅照跑，但用預設值。

1. 兩個動作綁到同一個按鍵——直接判定為衝突。因為爾雅無法決定該執行哪一個。
2. 按鍵名稱拼錯、TOML 語法有問題——解析失敗。
3. 把單獨的 F1 綁給某個動作——保留鍵，不接受。

以上任何一種情況，爾雅都會回退到完整的預設配置（不是「只忽略有問題的那一行」），並在啟動時的訊息列說明原因。程式不會因此開不起來。

常見錯誤

改按鍵最常見的七個狀況。