squirrel.yaml 配置指南

鼠鬚管介面定製指南¶

此處列出所有可用之選項，以便使用鼠鬚管的各位自定義喜歡的樣式。示例請參攷自帶squirrel.yaml，定製時請使用squirrel.custom.yaml文件patch
一般用戶請不要直接修改squirrel.yaml，否則可能丢失修改的內容，切記
squirrel.custom.yaml的使用方式非常靈活，在此提供一些參攷：LEO Yoon-Tsaw的squirrel.custom.yaml

keyboard_layout: last/default或具體鍵板布局名 last即最近一次使用的鍵板布局 default即 US (ABC) 布局具體鍵板名如com.apple.keylayout.USExtended或其簡寫USExtended
app_options
ascii_mode: 初始爲西文模式
no_inline: 不使用行內編輯
inline: 強制使用行內編輯
vim_mode: 退出 VIM 插入模式自動切換輸入法狀態
chord_duration: 如0.1，單位爲秒
show_notifications_when: always/never，是否顯示切換方案或開關狀態時的通知
style
color_scheme: 配色名，須存在于preset_color_schemes之中
color_scheme_dark: （可選）黑暗模式下的配色名，須存在于preset_color_schemes之中，未指定則始終使用color_scheme所指定的配色
candidate_format: 以[label]指代序號，[candidate]指代候選詞，[comment]指代注釋，可另加任意其它字符，也可多次重復出現例如[label]. [candidate] [comment]
candidate_list_layout: stack/linear，候選詞堆疊或平鋪顯示
text_orientation: horizontal/vertical，文字橫排或縱排

stack linear

horizontal 智能ABC 流行輸入法

vertical Rime獨有 Rime獨有
inline_preedit: true/false 是否行內編輯

inline_candidate: true/false 是否行內顯示第一候選

	inline_candidate: true	false
inline_preedit: true	第一候選及未成字編碼皆行內顯示，候選框沒有編輯區	輸入碼行內顯示，候選框沒有編輯區
false	第一候選行內顯示，候選框有編輯區	行內顯示空白佔位符，候選框有編輯區

memorize_size: true/false 一次輸入過程中，候選框觸及屏幕邊緣時是否粘住不再縮回，避免來回跳動
mutual_exclusive: true/false 候選區各背景色是否各自獨立，帶透明度的情況下互不浸染
translucency: true/false 是否添加毛玻璃背景（需配合透明背景色才得看到）
corner_radius: 非負數，候選外框圓角大小
hilited_corner_radius: 非負數，高亮區圓角大小（包括高亮候選詞和高亮編輯區）
border_height: 可正可負，邊緣高度，爲負時可收窄圓角造成的避讓留白
border_width: 可正可負，邊緣寬度，爲負時可收窄圓角造成的避讓留白
line_spacing: 可正可負，文字行間距
spacing: 可正可負，候選框內編輯區與候選區之間的間距
base_offset: 可正可負，文字基線高度調節
shadow_size: 非負數，非零則爲高亮候選詞增添陰影
surrounding_extra_expansion: 可正可負，若設置了candidate_back_color，調節非高亮候選詞背景相對於高亮背景的大小。正則更大，負更更小
font_face: 字體，可設多個，以,間隔不同字體，以-加註粗細。鼠鬚管：如何查找合用字體之名
font_point: 字號
label_font_face: （可選）序號專用字體，如未設置則使用font_face
label_font_point: （可選）序號專用字號，如未設置則使用font_point
comment_font_face: （可選）註釋專用字體，如未設置則使用font_face
comment_font_point: （可選）註釋專用字號，如未設置則使用font_point
preset_color_schemes: 配色方案列於此項下
name: 名稱，無實際效果，僅供展示
author: 作者，無實際效果，僅供展示
color_space: display_p3/srgb 色值所用色域
back_color: 候選框背景色
border_color: 候選框邊框色（邊框粗細爲border_height、border_width中小者，小于零則不顯示）
preedit_back_color: 編輯區背景色
text_color: 編輯區（非高亮）編碼色
hilited_back_color: 編輯區高亮背景色
hilited_text_color: 編輯區高亮編碼色
candidate_back_color: 候選詞背景色
candidate_text_color: 候選詞色
label_color: 候選序號色
comment_text_color: 候選註釋色
hilited_candidate_back_color: 高亮候選詞背景色
hilited_candidate_text_color: 高亮候選詞色
hilited_candidate_label_color: 高亮候選序號色
hilited_comment_text_color: 高亮候選註釋色
style中除color_scheme、color_scheme_dark外其餘諸項亦可於此覆蓋

	stack	linear
horizontal	智能ABC	流行輸入法
vertical	Rime獨有	Rime獨有