====== 鼠鬚管 ======
= [[it:rime|Rime]] 的 macOS 版((還有一個[[https://github.com/stackia/XIME|stackia/XIME: XIME Input Method Editor - Yet another Rime Frontend for Mac OS X]]，但最後更新是 2014 年了 ∴不用))

===== 安裝 =====
  - [[https://rime.im/download/|下載及安裝 | RIME | 中州韻輸入法引擎]]：macOS 鼠鬚管
    * PKG 法（略） 
    * /^20191021^/ 之前已試過 PKG 安裝法，今天也來嘗試 ''brew cask install squirrel''，因為我之前有裝過 Homebrew
      - 花了一小段時間更新 Homebrew 後順利裝上，似乎需要重新登入系統
      - 重新登入系統回來，發現系統輸入法清單中已有鼠鬚管，不確定是不是 Homebrew 弄的。另外，~/Library 下目前還沒有 Rime 資料夾
      - 有了，第一次切到鼠鬚管後，就會自動出現 Rime 資料夾了。然後預設的輸入方案是朙月拼音。這樣就裝好了。如果只要打拼音或注音的話，應該到此為止<div>
----
</div>
  - /-[[https://github.com/rime/plum|東風破]]裝注音：<code>curl -fsSL https://git.io/rime-install | bash</code>-/
    * 其實這樣一次預裝的是好幾個輸入法
    * 咦，其實我忘記確認剛才用 Homebrew 裝好鼠鬚管後是否就已經有注音了。如果有的話，其實以後也許不用再跑東風破這一步了\\ ↑稍晚證實，較新版的鼠鬚管已不再需要另用東風破裝注音
  - 自行裝入其他輸入方案
    * ++嘸蝦米|{{page>liu#安裝}}++

===== 自訂 =====
參考：
  * /Library/Input Methods/Squirrel.app/Contents/SharedSupport 裡的各檔，有的有註解說明

  - 「中」→「漢」：輸入的是「漢字」，不一定是「中文」！
    * 遇到困難：[[https://github.com/rime/squirrel/issues/368|*.custom.yaml 可以設定 switches 在選單裡的 states，但改不掉 key toggle 的提示文字 · Issue #368 · rime/squirrel]]
  - 「英」→「拉」：輸入的是拉丁字母，不一定是英文！
    * 困難同上
  - [[https://github.com/rime/squirrel/wiki/禁用-Squirrel-英文模式，使用左侧-Shift-切换中英|禁用 Squirrel 英文模式，使用左侧 Shift 切换中英 · rime/squirrel Wiki]]
  - /^20210614^/ 我真正喜歡的面板字型？<div>
去年開始用 Rime 以來我設定的 panel 字型長期是<code yaml>  style/font_face: Operator Mono Bold, Latinghei TC Bold, Latinghei SC Bold</code>用「蘭亭黑」的目的是不要太單調老是用「黑體-繁」，但用完後感覺跟黑體-繁沒有差很多，我也不以為意（因為我平常也極少用蘭亭黑；應該說我的工作上絕大多數仍是在和 MS Word 及標楷體打交道，這實在很可惜）。

結果這一週把這些設定拿到新買的 M1 MBA 裝的鼠鬚管上，面板字型感覺簡直就跟黑體-繁沒兩樣，害我想說該不會 Big Sur 拿掉蘭亭黑了？結果昨晚發現，沒這回事，原來我出了兩個紕漏：
  - 我拼錯了，應該是 ''Lantinghei''，我少了個 ''n''！
  - 還有，蘭亭黑的內建字重有 3，Extralight、Demibold、Heavy，唯獨沒有 //Bold//
↑我真的太瞎了！憑感覺亂寫設定 XD ← 改好以後 M1 MBA 上就出現了比較中黑感的蘭亭黑了（其實真的是我喜歡的嗎？）

而且重點是，我這一年多原來根本沒有用到蘭亭黑，是在開心什麼勁的 <<哈>>

哇，結果回到 MBA 2013（10.11）上，發現其實蘭亭黑的效果我沒有很喜歡，太粗不說，而且沒有黑體-繁的我超愛喇叭口，然後行距又太大 :(

→ 找新的：
  * 源雲明體：不夠粗，可惜；自己加 ''Bold'' 也沒用
  * 黑體-繁中黑（Medium）：就是平常已經在用的了，也是不夠粗。當然，已經用了一年多說怨言也是沒有
  * STZhongsong：還可以，但也許我的行距在鼠鬚管 0.15 中真的被迫變得太高；而且和 Operator Mono 粗細、風格不搭
  * （唔！如果要求正體+殘體的風格要一致的話，我目前所安裝的字型中，選擇似乎就不多了）
  * 顧及臺文：
    * jf open 粉圓 1.1 + Yuanti：殘體字勢必用 Yuanti SC，其實比粉圓體稍大一點，很容易看出破綻
    * /-Cambria-/ __Baskerville Semibold + STZhongsong__：雖然 serif 字型比較細，但有的可以加粗，先湊合著用吧++（→ 6/15 目前面板外觀設定）|<div><code yaml>  style/font_face: Baskerville Semibold, STZhongsong
  style/font_point: 20 #18          # 字號
  style/corner_radius: 5       # 窗口圓角半徑
  style/border_height: 5        # 窗口邊界高度，大於圓角半徑才有效果
  style/border_width: 0         # 窗口邊界寬度，大於圓角半徑才有效果
  style/line_spacing: 3
  style/spacing: 2
  style/hilited_corner_radius: 5 #高亮度區的圓角
  style/base_offset: 1</code></div>++
  * 後來在 MBA M1 上面，Baskerville Semibold + STZhongsong 並不會太細，retina 螢幕顯示效果穠纖合度，相當令人激賞啊！<<大心>>
</div>
  - 0.15.0 導入的 ''color_scheme_dark''，我今天（2021/8/1）看到 PTT Liu 板友提到，才想起來可以用啦！☞ [[https://github.com/rime/squirrel/blob/master/data/squirrel.yaml|官方範例設定方式]]
  - 再一個已知用火：<span imp>[[https://github.com/LEOYoon-Tsaw/Squirrel-Designer|LEOYoon-Tsaw/Squirrel-Designer: Squirrel Theme Simulator]]</span>
    * 可能是鼠鬚管自訂界非常重量級的突破
    * 非常強大也很新（只支援 macOS 11+！）的 scheme 編輯器
    * 而且顧及了字型 fallback
    * 代碼+預覽功能都很強，而且可以妥善地互轉
  - 發現兩招：
    - ''style/border_height''、''style/border_width'' 在 0.15.0 以上終於有用了，而且不再需要大於圓角半徑的樣子，設 ''1'' 也可以，變成細細的一條線，用來設定暗色主題的白框夠了
    - 我可以在 squirrel.custom.yaml 裡加上類似這樣一行：<code yaml>  preset_color_schemes/solarized_rock/border_color: 0xffffff # 20210802 太好了，我可以 override 個別 preset 的設定！</code> ← 可以把這個 preset 的邊框從原本的同色，變成白框，有助於夜間辨識
===== 設定檔 =====
~/Library/Rime

  * 赫然發現，這設定檔資料夾，我們可以：
    * 隨時刪除/改名，讓它重建
    * 兩個以上的資料夾，可以改名回來替換（可能要重新部署）

===== Tip =====
  * 若部署出錯說要看 log 檔：可以用終端機輸入 ''$ open -a "Finder" $TMPDIR''，迅速找到暫存資料夾，再找到 rime.squirrel.INFO

===== 問題 =====
  * FIXED /^20191021^/ 不知道是不是我前兩天搞壞鼠鬚管所致，現在就算重新安裝回來，重新部署時的 GUI 訊息通知也不見了……
    * 結果當天早晨赫然發現重新部署的通知訊息回來了
    * 再稍後發現，原來是 macOS 勿擾模式的影響啊……害我虛驚一整天 <<==>>((☞ https://github.com/rime/squirrel/issues/320#issuecomment-507336961))
  * ''recognizer/patterns/xxxxxxx'' 都沒有效果
  * ''translator/enable_completion'' 也都沒效

===== 重新安裝 =====
可用 ''brew cask reinstall squirrel''
===== 解除安裝 =====
  - 系統移除「鼠鬚管」輸入法
  - 重新登入系統，然後在 /Library/Input Methods 中移除「鼠鬚管.app」
  - 在 ~/Library 中移除設定資料夾 Rime((或若像我有重裝的需求的話，就把該設定資料夾重新命名為「Rime-old」之類))
  - 重新登入系統

(([[https://github.com/rime/home/issues/59|如何卸载？ · Issue #59 · rime/home]]))

===== LEOYoon-Tsaw fork =====
[[https://github.com/LEOYoon-Tsaw/squirrel/releases|Releases · LEOYoon-Tsaw/squirrel]]，到 2022 還有繼續開發功能，有一些比鼠鬚管 mainstream 更前面的功能還沒有被官方 merge
  * ''translucency''：很美的半透明，但不確定是不是需要 Monterey ∵我在 Big Sur 上沒看到效果；LEOYoon-Tsaw 說他是編譯給 11 以上
  * ''inline_candidate''：不錯的效果，我喜歡
  * 其他與候選項相關的效果似乎不顯著……
  * 可設定負值的 border，不過我目前用不到

問題：
  * 似乎會導致 ``⌃` ``、``⌃⇧` `` 選單失效，按了以後鼠鬚管在該程式會當掉，得重新部署 :(
    * 裝官方 0.15.2 降回去，但也沒有用？
    * 只好先用「直接切換到 schema」的熱鍵來切換了
  * 輸入法狀態提示消失

/^20230202^/ 今天裝了官方 0.16.1，也沒有改善，邊界反而又變得怪，然後上面的問題通通都存在，又一樣沒有半透明效果；解除安裝後重裝官方 0.16.1 也一樣 🖕

/^20230203^/ 測試：
  - 備份 Application Support 裡的設定資料夾 → 重新部署 → 比較正常，輸入法狀態恢復顯示了（∴之前有問題是 100% 透明？）
    - 但是，輸入法選單還是會當掉哦，原來是不同的問題啊 orz
  - 用原本的設定資料夾，但把 squirrel.custom.yaml 改名 → 重新部署 → 一樣有問題
    * 單註解掉裡面的 scheme 設定 → 一樣有問題
  - 單把 **__default.custom.yaml__** 改名 → 重新部署 → 正常 ∴問題似是在這個檔裡
    - 把 \t 取代為空格 ❎
    - /^後幾天^/ 不是前面 ''menu''、''ascii_composer'' 的問題
    - ''schema_list'' 裡最後發現是 liur 的問題 😮
  - 但又不是 liur_custome.yaml 任何一個設定的問題
  - __**liur_schema.yaml**__ ← 就是你啦！
    - 發現 ''switches'' 裡的 ''ascii_mode''、''full_shape'' 的 ''states''，我之前有 comment 掉（因為想要自己設定字樣但無效，官方說是 hard-coded，後來就先 comment 掉了），改回不要 comment 後，輸入法狀態恢復顯示了！
  - /^2/9^/ 輸入法選單當掉的問題到底？
    - 重建設定資料夾 ✅
    - 不是 default.custom.yaml
    - 是 squirrel.custom.yaml！
      - 結果就是 LEOYoon-Tsaw fork 的 ''inline_candidate'' 造成的 <<==>>
      - 官版 1.6 只有 merge 了 ''translucency'' ∴看來 ''inline_candidate'' 就先不要管吧
  - ''translucency''：原來要設定半透明的顏色 ☞ [[https://github.com/rime/squirrel/pull/589|Support translucency by LEOYoon-Tsaw · Pull Request #589 · rime/squirrel · GitHub]]
    - 用 Squirrel Designer 可以弄出來～
    - /^2/14^/ 今天終於弄出來了：底色半透明，而且透明度要很高((從現有色彩弄出同樣感覺的半透明色彩 ☞ http://localhost/dw/!imazingrace.ml/generators/transparent-color?s[]=%E9%80%8F%E6%98%8E%E5%BA%A6))，效果才會明顯
===== 參考 =====
  * [[https://blog.typeart.cc/rime-liur/guide/|在Mac下使用鼠鬚管(RIME) + 嘸蝦米，並擁有注音模式、讀音反查、中英混輸、動態造詞 | 只是個打字的]]