# F.11\. dict_xsyn `dict_xsyn`（擴展的同義詞詞典）是一個全文本搜索的擴展字典模板的例子。 這個字典類型用它們的同義詞組替代單詞，并且因此使得使用任意它的同義詞搜索這個單詞成為可能。 ## F.11.1\. 配置 `dict_xsyn`字典接受下列的選項： * `matchorig`控制字典是否接受原始單詞。缺省是`true`。 * `matchsynonyms`控制字典是否接受同義詞。缺省是`false`。 * `keeporig`控制原始單詞是否包含在字典的輸出里。缺省是`true`。 * `keepsynonyms`控制同義詞是否包含在字典的輸出里。缺省是`true`。 * `rules`是包含同義詞列表的文件的基名。這個文件必須存儲在`$SHAREDIR/tsearch_data/` （這里的`$SHAREDIR`意思是PostgreSQL安裝的共享數據目錄）里。 它的名字必須以`.rules`（不包含在`rules`參數中）結束。 rules文件有下列的格式： * 每行代表著一個單詞的同義詞組，單詞在每行的開頭給出。同義詞用空格分開： * 符號井號(`#`)是一個注釋分隔符。它可能在一行中的任意位置出現。該行在它后面的部分將被跳過。 查看`xsyn_sample.rules`（安裝在`$SHAREDIR/tsearch_data/`里）獲取一個實例。 ## F.11.2\. 用法 安裝`dict_xsyn`擴展創建基于它的一個文本搜索模板`xsyn_template` 和一個字典`xsyn`，帶有缺省的參數。你可以修改這些參數，如 ``` mydb# ALTER TEXT SEARCH DICTIONARY xsyn (RULES='my_rules', KEEPORIG=false); ALTER TEXT SEARCH DICTIONARY ``` 或創建新的基于該模板的字典。 要測試該字典，你可以嘗試 ``` mydb=# SELECT ts_lexize('xsyn', 'word'); ts_lexize ----------------------- {syn1,syn2,syn3} mydb# ALTER TEXT SEARCH DICTIONARY xsyn (RULES='my_rules', KEEPORIG=true); ALTER TEXT SEARCH DICTIONARY mydb=# SELECT ts_lexize('xsyn', 'word'); ts_lexize ----------------------- {word,syn1,syn2,syn3} mydb# ALTER TEXT SEARCH DICTIONARY xsyn (RULES='my_rules', KEEPORIG=false, MATCHSYNONYMS=true); ALTER TEXT SEARCH DICTIONARY mydb=# SELECT ts_lexize('xsyn', 'syn1'); ts_lexize ----------------------- {syn1,syn2,syn3} mydb# ALTER TEXT SEARCH DICTIONARY xsyn (RULES='my_rules', KEEPORIG=true, MATCHORIG=false, KEEPSYNONYMS=false); ALTER TEXT SEARCH DICTIONARY mydb=# SELECT ts_lexize('xsyn', 'syn1'); ts_lexize ----------------------- {word} ``` 實際的使用情況包括包含它在一個文本搜索配置（在[Chapter 12](#calibre_link-426)里描述）里。 可能看起來像這樣： ``` ALTER TEXT SEARCH CONFIGURATION english ALTER MAPPING FOR word, asciiword WITH xsyn, english_stem; ```