使用者片語辭典目錄

1. 辭典檔案類型介紹

唯音輸入法的當前使用者片語辭典目錄可以從輸入法選單的「開啟使用者片語辭典目錄」的方式直接存取。您可以在輸入法偏好設定內更改使用者片語辭典目錄。

該資料夾內的的常駐檔案如下：

  • 「由唯音輸入法本體以外的程式」對該資料夾所做出的任何修改，都會使該資料夾的所有被下述表格當中提及的內容被重新載入。
  • 「整理」表明唯音會在載入該當檔案時先整理格式、再讀取內容。
  • 「必需？」表明該檔案一定會存在。不存在的話，輸入法會嘗試建立原廠範本檔案。但凡非必需的檔案，都只會在使用者手動創建的時候才會起作用。
檔案名稱 整理 檔案用途性質 必需？
userdata-cht.txt
userdata-chs.txt		 是 使用者片語 是
usersymbolphrases-chs.txt
usersymbolphrases-cht.txt		 是 使用者繪文字辭典 是
associatedPhrases-chs.txt
associatedPhrases-cht.txt		 是 使用者關聯詞語 是
exclude-phrases-cht.txt
exclude-phrases-chs.txt		 是 語彙濾除表 是
phrases-replacement-cht.txt
phrases-replacement-chs.txt		 是 語彙置換表 是
symbols.dat 否 自訂分層分類符號表 否

上表當中的以 .txt 結尾的檔案在被輸入法讀取時，有這幾個共性：

  • 如果輸入法檢測不到合規的 Pragma Header 檔案頭標記的話，會自動整理其格式：
    • 所有 CR 換行都會被置換成 LF 換行、且去重複。
    • 所有種類的空格（無論全半形）與 Tab 都會被轉成 ASCII 半形空格、且去重複。
    • 在此基礎上，行首與行尾的空格會被剔除，且所有重複行都會被剔除。
    • 檔案被整理之後，會在檔案開頭留下 Pragma Header 檔案頭標記。
  • 該檔案內容的行排序與選字窗內的內容排序成反比（所在行數越高，在選字窗當中越是會被先列出），除非手動指定了特殊的有效權重。
  • 任何一行內，所有以 ASCII 井號「#」開頭的內容都會在資料讀取時被忽視。

上述的很多檔案在輸入法選單內都有專門的編輯入口，但其中有一些檔案的編輯入口需要您在「當前程式正在準備接收文字輸入」的時候「摁著 Option 再點開輸入法選單」才會出現。

同理，如果您摁著 Option 再點這些選單入口的話，往往會同時開啟簡體中文與繁體中文的檔案、供您同時編輯。

A. 使用者片語辭典

⚠️ 該內容的編輯方式在輸入法選單當中的入口為「編輯唯音自訂語彙…」。

使用者自造詞都是塞在這個目錄的。如果您使用了就地加詞功能，則就地新增的詞會在這裡出現。最好是針對 -chs.txt 和 -cht.txt 同時擴充簡體中文與繁體中文的使用者片語辭典內容。當您就地加詞的時候，這兩個檔案都會被寫入，但其中與當前輸入法簡繁體模式不對應的那個檔案被寫入的內容是以繁簡轉換的方式實現的、有時可能需要人工檢查其準確性。

在該檔案內新增語彙的方式有兩種：

  1. 先寫詞，再寫注音，但不寫權重。兩者之間用半形空格隔開，注音讀音之間用 ASCII 減號銜接。 
    我是自訂語彙 ㄨㄛˇ-ㄕˋ-ㄗˋ-ㄉㄧㄥˋ-ㄩˇ-ㄏㄨㄟˋ

    不寫權重的自訂語彙都會被賦以「0」最高權重。寫了大於零的權重的話，則會被強制乘以「-1」。

  2. 與上文相同，但在注音之後空一格再寫權重。權重建議設定在 [-9.5, 0] 這個全閉區間內。過大的話，可能會影響組字引擎正常組字；過小的話，一旦小於等於「-12」，則不會被漸退記憶模組所觀測。 
    我是被降權的語彙 ㄨㄛˇ-ㄕˋ-ㄅㄟˋ-ㄐㄧㄤˋ-ㄑㄩㄢˊ-ㄉㄜ˙-ㄩˇ-ㄏㄨㄟˋ -114.514

    其中，「-114.514」是以野獸常數指定的懲戒權重。被賦以這個權重的詞會被組字引擎在自動爬軌組字時直接無視。唯音輸入法的「就地降頻」功能會在使用者片語辭典內重新加入被標記的詞音配對、且賦以該懲戒權重。

支援漢語拼音寫入

如果您不熟悉注音符號，讀音鍵也可以直接寫帶數字聲調的漢語拼音，載入時會自動轉換成注音。格式與注音寫法相同：詞與讀音用半形空格隔開、各音節的拼音之間用 ASCII 減號銜接、聲調以數字標在音節末尾（1 陰平／2 陽平／3 上聲／4 去聲／5 輕聲）：

我是自訂語彙 wo3-shi4-zi4-ding4-yu3-hui4

上面這一行與注音寫法「我是自訂語彙 ㄨㄛˇ-ㄕˋ-ㄗˋ-ㄉㄧㄥˋ-ㄩˇ-ㄏㄨㄟˋ」等價，載入時會被自動轉換成相同的注音鍵。注意事項：

  • 每個音節必須標記聲調數字（如 wo3），否則轉換後的讀音缺少聲調、無法被組字引擎命中；
  • 音節之間必須用減號銜接——純英數連寫（如 wo3shi4）不會被轉換；
  • 僅支援漢語拼音方案；其他拼音方案（耶魯、華羅、通用等）不在自動轉換的範圍內；
  • 單音節詞建議直接寫注音（如 ㄨㄛˇ），因為純英數的單音節拼音（如 wo3）不會被轉換。

另外，「Option+Shift+符號鍵」的選單內容可在這個檔案內擴充，只需將讀音鍵設為「_punctuation_list」即可。範例：

？ _punctuation_list
！ _punctuation_list
︰ _punctuation_list

B. 使用者繪文字辭典

與使用者片語辭典類似，但會被統一賦以的權重是「-12」。使用者無法指定其權重。

該檔案主要負責存放繪文字、以及包含繪文字的詞組。

每一行的撰寫格式為「先寫詞，再寫注音」，兩者之間用半形空格隔開，注音讀音之間用 ASCII 減號銜接。

⚠︎ ㄐㄧㄥˇ-ㄍㄠˋ

C. 使用者關聯詞語

使用者關聯詞語的格式與 Windows XP 的傳統注音（ㄅ半注音）關聯詞檔案格式一樣，但要求檔案編碼必須只能是 UTF-8 編碼。該格式為「首字 去首字的候選字1 去首字的候選字2 …」，用半形空格隔開：

天 涼好個秋 天向上 上人間 兵 堂

唯音的使用者關聯詞語模組還可給首字指定讀音，但這會使該行資料無法作用於無限聯想輸入，所以不推薦使用。只需將首字改寫為「(讀音,首字)」即可。每行格式如下：

(ㄨㄟˊ,為) 師 人
(ㄨㄟˋ,為) 了 人民服務

D. 語彙濾除表

語彙濾除表僅用來存放詞音配對，格式與使用者繪文字辭典檔案雷同。 所有藉由就地刪詞功能刪除的詞彙，都會在這裡出現詞音配對。這樣一來，出現在該表內的配對內容就不會被交給組字引擎、不會在選字窗內出現。範例格式參考如下：

北七 ㄅㄟˇ-ㄑㄧ

E. 語彙置換表

唯音輸入法的原廠繁體中文語彙庫採當代繁體中文實質上慣用的很多寫法，比如「答覆」「回覆」（都是 response / reply 的意思）。但在某些場合可能會被要求使用「答復」「回復」。這種情況下，語彙置換表就可以派上用場。

語彙置換表用來從資料層面自動置換詞語本身。每一行的撰寫格式為「先寫要置換的對象詞，再寫要置換成的新詞」，兩者之間用半形空格隔開。

歐陽修 歐陽脩

⚠️ 注意：該功能無法就原廠辭典當中的單個記錄詞做內容置換，因為置換對象必須是整個記錄詞。比如說 如果只添入「修 脩」的記錄的話，不會讓「歐陽修」被訂正為「歐陽脩」。

F. 逐字選字模式注音字序表（已移除）

本節所述的自訂途徑已不再存在：唯音現在不再於使用者片語辭典目錄內生成 data-plain-bpmf-*.plist，逐字選字模式的注音候選字排序資料已改由組字引擎內建的原始資料供應，使用者無法再藉由編輯該檔案來調整排序。

G. 自訂分層分類符號表

該檔案（symbols.dat）可有可無。如果使用者自行放置了該檔案的話，則會影響到分層分類符號選單的內容。可能會有人嫌唯音的原廠的分層分類符號選單的內容太多，這時就可以用自訂的方式滿足自己的個人需求。

該檔案的格式採 libChewing 符號表的格式，範例格式如下（取自新酷音輸入法）：

…
※
常用符號=，、。．？！；：‧‥﹐﹒˙·‘'""〝〞‵′〃～＄％＠＆＃＊
左右括號=（）「」〔〕｛｝〈〉『』《》【】﹙﹚﹝﹞﹛﹜
上下括號=︵︶﹁﹂︹︺︷︸︿﹀﹃﹄︽︾︻︼
希臘字母=αβγδεζηθικλμνξοπρστυφχψωΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩ
數學符號=＋－×÷＝≠≒∞±√＜＞﹤﹥≦≧∩∪ˇ⊥∠∟⊿㏒㏑∫∮∵∴╳﹢
特殊圖形=↑↓←→↖↗↙↘㊣◎○●⊕⊙○●△▲☆★◇◆□■▽▼§￥〒￠￡※♀♂
Unicode=♨☀☁☂☃♠♥♣♦♩♪♫♬☺☻
單線框=├─┼┴┬┤┌┐╞═╪╡│▕└┘╭╮╰╯
雙線框=╔╦╗╠═╬╣╓╥╖╒╤╕║╚╩╝╟╫╢╙╨╜╞╪╡╘╧╛
填色方塊=＿ˍ▁▂▃▄▅▆▇█▏▎▍▌▋▊▉◢◣◥◤
線段=﹣﹦≡｜∣∥–︱—︳╴¯￣﹉﹊﹍﹎﹋﹌﹏︴∕﹨╱╲／＼

H. 全形字母直接輸入

出於諸多原因及綜合考量，唯音輸入法預設情況下並未製作該功能。但使用者可以利用使用者片語編輯系統的特性來間接實現該功能。

前提：這需要您在輸入法偏好設定內將「Shift+字母鍵」的行為設定為「直接鍵入內文組字區」。

如果您需要直接 SHIFT 輸入小寫全形字母的話，請確保如下段落插在使用者自訂語彙檔案內：

ａ _letter_A
ｂ _letter_B
ｃ _letter_C
ｄ _letter_D
ｅ _letter_E
ｆ _letter_F
ｇ _letter_G
ｈ _letter_H
ｉ _letter_I
ｊ _letter_J
ｋ _letter_K
ｌ _letter_L
ｍ _letter_M
ｎ _letter_N
ｏ _letter_O
ｐ _letter_P
ｑ _letter_Q
ｒ _letter_R
ｓ _letter_S
ｔ _letter_T
ｕ _letter_U
ｖ _letter_V
ｗ _letter_W
ｘ _letter_X
ｙ _letter_Y
ｚ _letter_Z

如果您需要直接 SHIFT 輸入大寫全形字母的話，請確保如下段落插在使用者自訂語彙檔案內：

Ａ _letter_A
Ｂ _letter_B
Ｃ _letter_C
Ｄ _letter_D
Ｅ _letter_E
Ｆ _letter_F
Ｇ _letter_G
Ｈ _letter_H
Ｉ _letter_I
Ｊ _letter_J
Ｋ _letter_K
Ｌ _letter_L
Ｍ _letter_M
Ｎ _letter_N
Ｏ _letter_O
Ｐ _letter_P
Ｑ _letter_Q
Ｒ _letter_R
Ｓ _letter_S
Ｔ _letter_T
Ｕ _letter_U
Ｖ _letter_V
Ｗ _letter_W
Ｘ _letter_X
Ｙ _letter_Y
Ｚ _letter_Z

以上兩段內容可以同時出現在使用者自訂語彙檔案內，但預設敲出來的只可能是行數最高者。

$ EOF.