Format of tsi.src (libtabe-0.2)

詞庫檔 tsi.src 格式說明 (for libtabe-0.2 and above)

libtabe 的詞庫檔原始碼是放在:

	libtabe/tsi-src/tsi.src

而在完成編譯與安裝之後，其二進位的詞庫資料檔是放在

	$(prefix)/share/tabe/tsiyin/

目錄下，檔名為 tsi.db 與 yin.db 就是。現階段如果要增加新詞時，必須修改 tsi.src 並重新編譯與安裝它。底下我們說明該檔的格式，至於編譯方式與安裝方式請參考這裡。

tsi.db 中每一行描述一個詞，每行三個欄位，如下:

一了百了 6	ㄧˋ　ㄌㄧㄠˇ　ㄅㄞˇ　ㄌㄧㄠˇ
一人份 12	ㄧ　ㄖㄣˊ　ㄈㄣˋ　ㄧˋ　ㄖㄣˊ　ㄈㄣˋ
先見之明 17	ㄒㄧㄢ ㄐㄧㄢ4 ㄓ ㄇㄧㄥ2
一針見血 43	[ㄧ4,ㄧ] ㄓㄣ ㄐㄧㄢ4 ㄒㄧㄝ3

第一個欄位就是詞本身，第二個欄位是數字，代表這個詞的詞頻，第三個欄位是這個詞的完整注音碼。其中每個欄位間可以是任意的半形空白鍵或 tab 鍵隔開。注意到其中第一個與第二個詞條: 「一了百了」與「一人份」的第三欄位的注音格式是與 libtabe-0.1 版的格式相同的，也就是說，這一版所能接受的格式是可以往前相容的，同時它也可以接受新的格式，茲簡述如下:

每個字注音的音調可以有兩種表示方式: 用數字表示或用 Big5 的符號。以上例而言是用數字來表示。各表示法如下:

一聲: 不需要附加任何符號，直接附加一個空白鍵即可。
二聲: 若用數字表示法為 "2"，若用 Big5 符號則為 "ˊ"。
三聲: 若用數字表示法為 "3"，若用 Big5 符號則為 "ˇ"。
四聲: 若用數字表示法為 "4"，若用 Big5 符號則為 "ˋ"。
輕聲: 若用數字表示法為 "5"，若用 Big5 符號則為 "˙"。

因此，上述的 "見" 字，其注音部分可以寫成 "ㄐㄧㄢ4"，也可以寫成 "ㄐㄧㄢˋ"。至於要用那一種表示法，則視您的方便而定。

每個字的注音中間請用一個半形或全形 (0xA140) 的空白鍵隔開。以上面的例子而言: ㄒㄧㄢ與ㄐㄧㄢ4 中間就是半形或全型的空白，ㄐㄧㄢ4 與ㄓ之間也是，ㄓ與ㄇㄧㄥ2 之間也是，其餘類推。

如果一個詞中某些字有幾個讀音時，您可以妨照上例第二個詞的格式。在上例中， "一針見血" 可以讀成:

	ㄧ4 ㄓㄣ ㄐㄧㄢ4 ㄒㄧㄝ3

也可以讀成:

	ㄧ ㄓㄣ ㄐㄧㄢ4 ㄒㄧㄝ3

這時，可以有多種讀音的字就可以用一對中括號括起來，而各讀音之間就以逗號相連，即

	[ㄧ4,ㄧ] ㄓㄣ ㄐㄧㄢ4 ㄒㄧㄝ3

請注意 [ㄧ4,ㄧ] 與ㄓㄣ之間仍然是以半形或全形空白相連，除此之外，由於在這兩種讀音中，前者是字典上的標準讀音，故在中括號內應將字典的標準讀音擺在前面。

對於有多種讀音的詞，除了可以用上述的中括號表示法以外，還可以用以下的表示法:

	ㄧ4 ㄓㄣ ㄐㄧㄢ4 ㄒㄧㄝ3 ㄧ ㄓㄣ ㄐㄧㄢ4 ㄒㄧㄝ3

在此一表示法中，我們將這個詞所有完整讀音都寫出來，而且二讀音之間也是以半形或全形空白鍵相連 (也就是說，上例中間的ㄒㄧㄝ3 與ㄧ之間是一個半形或全形空白)。至於要用那一種表示法，則視您的方便而定。

因此，如果您要加入一個新詞時，只要按照此格式加入即可。至於第二欄位的詞頻部分，您可以直接填入 0 即可。而第三欄位的注音部分，您可填可不填，如果不填的話，則在編譯時程式會試圖找出所有字的可能破音字組合，來補上第三欄位。然而，我們建議您最好還是填一下第三欄位，原因是如果不填的話，由程式自動補上可能會造成一些奇怪或根本不可能存在的讀音出現，而佔用系統資源。