Mercurial > freewnn
diff cWnn/manual/chap5 @ 0:bbc77ca4def5
initial import
| author | Yoshiki Yazawa <yaz@cc.rim.or.jp> |
|---|---|
| date | Thu, 13 Dec 2007 04:30:14 +0900 |
| parents | |
| children |
line wrap: on
line diff
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/cWnn/manual/chap5 Thu Dec 13 04:30:14 2007 +0900 @@ -0,0 +1,1600 @@ + ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ + ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ + ┃ Ｃｈａｐｔｅｒ ５ ＥＮＶＩＲＯＮＭＥＮＴ ＳＥＴＵＰ ┃ + ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛ + ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛ + + +┏━━━━━━━━┓ +┃ 5.1 OVERVIEW ┃ +┗━━━━━━━━┛ + + All the user input environments and operation environments in cWnn are defined in +the system environment files. The system supports various input methods. Through the +environment setup, users are able to set their own environments. +The setup of an environment includes the following : + + 1. cserverrc ─ The initialization file for the server. + 2. uumrc ─ The initialization file for the front-end processor "cuum". + 3. wnnenvrc ─ The environment setup file for forward conversions. + 4. wnnenvrc_R ─ The environment setup file for reverse conversions. + 5. uumkey ─ The keyboard definition file for the front-end processor. + 6. cvt_key_tbl ─ The conversion file for keyboard input code + + + We will now explain how an environment may be set, and how its parameter values +may be updated manually. + + + + + + + + + + + + + + + + + + + + + + + + - 5-1 - +┏━━━━━━━━━━━━━━━━━━━┓ +┃ 5.2 ENVIRONMENT OPERATION FUNCTIONS ┃ +┗━━━━━━━━━━━━━━━━━━━┛ + + The cserver manages several resources such as dictionaries and grammar files. +Besides, it creates individual environments for every user (client). A user may have +more than one environment. In each input mode, the environment defines its own +dictionaries, the corresponding usage frequency files and the grammar files. + + When a user starts up cuum (front-end processor), cserver will set the specified +dictionaries for the user while creating the environment. After setup, the user is able +to obtain the usage status of the dictionaries in his environment from the system at any +time. + + The followings are the operation functions available in every environment. The +user may update his environment by using these functions. For example, he may need to +add another dictionary, or need to change the values for certain conversion parameter. + + +1. Environment Operation +━━━━━━━━━━━━ +When function key PF6 (OR 前面キ- together with 呼出し key) is pressed, the following +menu will be displayed. Move the cursor to the particular option and press the return +key. The corresponding function will then be carried out. + + ┌────────────────────────────────┐ + │ 0.词典追加 1.词典一览 2.登录 3.检索 4.参数变更 5.频度保存 ....│ + └────────────────────────────────┘ + + 0.词典追加 (Add dictionary) : To add a dictionary to the current environment + 1.词典一览 (View dictionary) : To view all the dictionaries in the current + environment, as well as their current states. + 2.登录 (Word/Character add) : To add a word into a dynamic dictionary. + 3.检索 (Word/Character search) : To check if a word/character exists in the + dictionary under the current environment. If it + exists, the system will show the information of + the word/character. + 4.参数变更 (Parameter update) : To enquire or change the parameters for the + Pinyin-Hanzi conversion under the current + environment. Different environments will have + different parameters. (Refer to (4). below) + 5.频度保存 : Save all the usage frequency files under the + (Save usage frequency) current environment. + 6.词典情报 : To inquire the information of the dictionaries + (Dictionary information) under the current environment. For example the + dictionary name, type and priority etc. + 7.文法变更 (Grammar change) : To change the grammar file used in the environment. + 8.结束 (Exit) : To exit the environment operation function. + + - 5-2 - +NOTE: + - PF6 is the default keyboard definition in cWnn, it may be redefined. + - Another way to activate this menu is by pressing the <前面キ-> together + with the <呼出し> key. + - These keys follow the keyboard layout given in Section 3.4. + + +2. How to Use the Environment Operations +━━━━━━━━━━━━━━━━━━━━ +We will now explain how to use each of the above environment operations. Every +instruction will be given in steps. + +NOTE: + - Press the return key after each step. + - To quit, press 前面キ- together with the ↓arrow key. + + +(0).词典追加 (Add dictionary) + This enables user to add a dictionary after the front-end processor has been + started. + (a). First, select the option 0.词典追加, after which, enter the dictionary + name. If the name of the dictionary is in ASCII, simply change the input + mode to "半角". + (b). A message "新的词典 >" will be displayed. Enter the dictionary name. + (c). Another message "频度文件名 >" is displayed. This is the usage frequency + file that is automatically created. If you do not want the given default + name, you may change it. + (d). A message "请指定词典的优先度的数字。> 5 " will be displayed next. "5" is + the default priority value given to the dictionary. You may also change + this value. + (e). The next message displayed is "使用词典更新模式吗? (Y or Newline / N)". + This is to determine whether the dictionary may or may not be updated. + (f). If the dictionary to be added can be updated, answer with a "Y" to the + above question and the dictionary will be created. Follows this is a + message: "字典文件 "dict_name" 没有。创建?(Y/N)". You may now answer + the questions respectively. + (g). If you have answered with a "N" to the message in (e), and the specified + dictionary does not exist, a message will be displayed: + "文件不存在。 (怎么办)". + + + + + + + + + + + - 5-3 - +(1).词典一览 (View dictionary) + This enables user to browse through the current dictionaries that are being + used. + (a). First, select the option 1.词典一览, after which, use the up and down + arrow keys to view the dictionaries. + + NOTE: You may delete the usage of a dictionary by using ^D, or remove + the dictionary temporary by using ^U. + For example, to delete a dictionary "level_2.dic". + - select option 1.词典一览, and the dictionary information will be + given as "sys/level_2.dic(usr/aty/level_2.h) 使用中 1/4". + - You may press ^D to remove it. This dictionary will be removed. + However, when the user terminate "cuum" and re-start again, the + dictionary will be restored. + - If you need to reuse the dictionary without terminating "cuum", + you may use ^U to remove the dictionary temporarily. In this + case, a message "字典「sys/level_2.dic」的使用中止。(Y/N)" will + be displayed. Answer "Y". + To restore the dictionary, select 1.词典一览 again, and you will + see the information of the dictionary as: + "sys/level_2.dic(usr/aty/level_2.h) 中断中 2/4". Now, press ^U + again to restore, and a message will be displayed: + "字典「sys/level_2.dic」重新使用。(Y/N)". Answer "Y". + + + + + + + + + + + + + + + + + + + + + + + + + + + - 5-4 - +(2).登录 (Word/Character add) + This enables user to register a word into a dictionary. This dictionary must + be dynamic (can be updated). + (a). First, select the option 2.登录. + (b). A message "登录开始:" will be displayed. Enter the word that you want to + register. + (c). Bring the cursor to the beginning of the word. Press the return key. + (d). A message "登录结束:" will be displayed. Bring the cursor to the end of + the word, press the return key. + (e). Another message "读法:" will be displayed. You may now enter the + pronunciation of the word. It may be input using different input modes. + For example, if you want it to be in Pinyin, change the input mode to 全拼, + and input the Pinyin. If you want it to be in ASCII, simply change the + mode to 半角. + (f). You will now see a list of grammatical attributes (词性) which may describe + the word. They include: 名词, 动词, 形容词, 数词, .... etc. Choose the + most appropriate attirbute. + (g). Another list of attirbutes is displayed, such as 普通名词, 抽象名, 时间名, + 处所名 ..etc. Again, choose the most appropriate one. + (h). Following this is another list. Choose the most appropriate attribute. + (i). You will now see a list of dictionary. You may choose to register the + word in any dictionary. These are the dictionaries that may be updated. + (j). A message "注释:" is displayed. You may enter any comments if you wish. + (k). If the pronunciation entered is empty, a message "读音的长度是0。(怎么办)" + is displayed. You may re-enter the pronunciation of the word. + + NOTE: + - Another way to activate 登录 is to press 前面キ- together with the + 消去 key. + +(3). 检索 (Word/Character search) + This enables user to check whether a word is registered in the dictionary. If + this word exists, all the information of this word will be shown. + (a). First, select the option 3.检索. + (b). A message "读取:" is displayed. Enter the pronunciation of the word. + It may be input via Pinyin, ASCII etc by using the different input modes. + (c). The information of the word is shown. For example, the word 好. + 好 (sys/level_1.dic:1195) 0 ( 305) 普通形容 1/23 + + "sys/level_1.dic" ─ the dictionary name + "1195" ─ the serial number of this word in the dictionary + "0" ─ the user usage frequency value + "305" ─ the system usage frequency value + "普通形容" ─ the grammatical attribute + "1/23" ─ there are 23 words that have the same + pronunciation as what has been input. This is + the first candidate. + + + - 5-5 - + NOTE: + Another way to view the information of a word or character is to use + the ^V command. For example, + - input a character 好 using Pinyin. + - press ^V now, and the information of this character will be shown. + + +(4). 参数变更 (Parameter Update) + This allows user to change the values of the parameters. In Section 4.4, the + default parameter values are given. These values may be updated by using the + function provided. + (a). Select the option 4.参数变更, a menu will be displayed as shown: + ┌────────────────────────────────┐ + │ 0.解析词组个数[n] 1.词组中词的最大个数[n] 2.频度权值[n] . . . │ + └────────────────────────────────┘ + These are the assessment parameters for multi-phrase conversion mentioned + in Section 4.4. The number in the square bracket indicates the current + parameter value. To change the value, simply move the cursor to the + parameter and press return, then enter the new parameter value. + + (b). To change the value of the parameter, move the cursor to the parameter by + using the arrow keys, and press the return key. + (c). The current value will be given. You may now enter the new value. + + As mentioned, input at the input line is not only restricted to Pinyin. Other + characters are also allowed. For example, numbers, alphabets, symbols and + parentheses. These characters will undergo conversion together with the Pinyin + input. Just like Pinyin, these characters have parameters which can be defined + externally. The parameters are classified into the following categories. + + * Usage frequency for numerals + This includes 0,1,2,3,4,5,6,7,8,9. Besides, the system has the + facility to change the numbers into other format. For example, + "1234567" can be changed to 1,234,567, 一百二十三万四千五百六十七 + and １２３４５６７ etc. + * Usage frequency for alphabets + * Usage frequency for punctuations + * Usage frequency for open parentheses + * Usage frequency for close parentheses + + The default values for these parameters are given in Section 4.4. + + +(5). 频度保存 (Save usage frequency) + This allows user to save all the user usage frequency under the current + environment. + (a). Select the option 5.频度保存. + (b). A message "现在、字典的频度和用户字典正在保存。" will be displayed to + indicate that the frequency is saved. + - 5-6 - +(6). 词典情报 (Dictionary information) + This allows user to view the information of the current dictionaries. + (a). Select the option 6.词典情报. Information about the dictionary will + be shown. For example, + 5 拼音 sys/basic.dic usr/aty/basic.h 10004 7 No Yes 使用中 1/8 + + "5" ─ the dictionary number + "拼音" ─ the dictionary type + " " ─ the comments (omitted here) + "sys/basic.dic" ─ the dictionary filename + "usr/aty/basic.h" ─ the usage frequency file name + "10004" ─ the number of tuples (词条) in the dictionary + "7" ─ the dictionary priority + "No" ─ to indicate whether the dictionary is dynamic + "Yes" ─ to indicate whether the usage frequency may be + updated + "使用中" ─ to show if the dictionary is used currently + " " ─ the password during registration (omitted) + " " ─ the password during usage frequency update (omitted) + "1/8" ─ the current total number of dictionaries + (b). Use the arrow keys to view. + + +(7). 文法变更 (Grammar change) + This enables user to change the grammar file used in the environment. + (a). First, select the option 7.文法变更, after which, enter the grammar file + name. If the name of the file is in ASCII, simply change the input mode + to "半角". + (b). A message "文法文件名 >" will be displayed. Enter the grammar file name. + If the file does not exist, a message "文件不存在。 (怎么办)" will be + displayed. + + +(8). 文字消除 (Word/Character delete) + This enables user to delete a word or character from the dictionary. However + word/character can only be deleted from dynamic dictionaries. + (a). First, select the option 3.检索, after which, search for the character + as in (3). For example the character 好. + (b). After the word is found, press ^D to delete the word permanently, or + press ^U to delete it temporarily. + (c). If ^D is used, a message "「好」消除。(Y/N)" is displayed. Enter "Y" to + confirm or "N" to cancel. + If the word is found in a static dictionary, it cannot be deleted, hence + a message "只读的词典的条目不能消除。(怎么办)" will be displayed. + (d). If ^U is used, a message "「好」的使用中止。(Y/N)" is displayed. Enter + "Y" to confirm or "N" to cancel. + To re-use the character, repeat (a) and press ^U again. Now a message + "「好」重新使用。(Y/N)" is displayed. Confirm as before. + + - 5-7 - +┏━━━━━━━━━━━━━━━━━━━━━━━━━━┓ +┃ 5.3 INITIALIZATION FILE FOR SERVER - cserverrc ┃ +┗━━━━━━━━━━━━━━━━━━━━━━━━━━┛ + + * Description + cserverrc - The cserver initialization file + + * Default Path + /usr/local/lib/wnn/zh_CN/cserverrc + + * Function + During the startup of cserver (ie. during execution of "cserver" command), the file + "cserverrc" is read. According to the definitions in "cserverrc", the corresponding + initializations are made. + + * Content + In "cserverrc", several settings are made. They include the followings: + + 1. Files that are read during the startup of cserver + There are three categories of file, including the dictionaries, grammar file, + and the usage frequency files. Refer to Chapter 8. + + - Format + readfile <cwnn_file> + <cwnn_file> is the name of the file which is read in during cserver startup, + and this file is maintained until the termination of cserver. + + 2. Maximum client allowed + - Format + max_client <n> + <n> is the maximum number of front-end processors (client) that are allowed + to be connected at any one time. Default value of <n> is 32. + + 3. Maximum environment + - Format + max_sticky_env <n> + <n> is the maximum number of permanent environments allowed. A permanent + environment remains in the server even after the termination of the front- + end processor. This helps in reducing the startup time of each front-end + processor. Default value of <n> is 10. + + 4. Path of dictionaries that are maintained by the server. + - Format + jserver_dir <path> + <path> defines the path of the system dictionaries maintained by the server. + Usage frequency files and dictionaries of the user are also maintained here. + If <path> is not given, the default path "/usr/local/lib/wnn/zh_CN/" will + be taken. + + - 5-8 - + 5. The default parameters values for Pinyin-Hanzi conversions. + - Format + def_param <parameter 0> <parameter 1> <parameter 2> + <parameter 3> <parameter 4> <parameter 5> + <parameter 6> <parameter 7> <parameter 8> + <parameter 9> <parameter 10> <parameter 11> + <parameter 12> <parameter 13> <parameter 14> + <parameter 15> <parameter 16> + + <parameter x> are values of parameters. All parameter values are integers. + During conversion, server will perform the conversion evaluation based on + these parameter values. Refer to Section 4.4 for detailed explanations for + each parameter. + + <parameter 0> : number of phrase "n" to be assessed + <parameter 1> : number of words "m" in phrase + <parameter 2> : usage frequency weight + <parameter 3> : word length weight + <parameter 4> : tone correctness weight + <parameter 5> : last used weight + <parameter 6> : dictionary priority weight + <parameter 7> : average word assessment value weight + <parameter 8> : phrase length weight + <parameter 9> : number of words in phrase weight + <parameter 10> : weight of numerals + <parameter 11> : weight of alphabets + <parameter 12> : weight of symbols + <parameter 13> : weight of open parentheses + <parameter 14> : weight of close parentheses + <parameter 15> : maximum number of candidates allowed during conversion + <parameter 16> : not used + + The following are the default values : + 1 5 2 750 10 80 10 5 1000 50 0 -200 0 0 0 16 0 + + 6. Definition of Xuni (quasi) grammatical category (虚拟词性) for alphabets + - Format + set_giji_ascii <char> <char> ... + All words and characters have their own grammatical attributes (词性). + Alphabets, numerals and some defined characters can be classified as Xuni + (虚拟) type in the Pinyin-Hanzi conversion and Hanzi-Pinyin conversion. + + <char> can be represented in hexadecimal, decimal, octal as well as + enclosed between single quotation marks. + + + + + + - 5-9 - + * Example + jserver_dir /usr/local/lib/wnn/zh_CN/dic + readfile sys/basic.dic + readfile sys/level_1.dic + readfile sys/level_2.dic + ;readfile sys/computer.dic + readfile sys/WuBi.dic + readfile sys/QianMa.dic + + readfile sys/full.con + + max_client 32 + max_sticky_env 10 + + def_param 1 5 2 750 10 80 10 5 1000 50 0 -200 0 0 0 16 0 + ; N M 频 长 四 刚 优 值 组 个 数 英 记 开 闭 最 备 + + ; N: 解析词组个数 变换规模参数 + ; M: 词组中词的最大个数 + + ; 频: 频度权值 词评价参数 + ; 长: 词长度权值 + ; 四: 四声正确度权值 + ; 刚: 刚才用过权值 + ; 优: 字典优先级权值 + + ; 值: 词评价均值权值 词组评价参数 + ; 组: 词组长权值 + ; 个: 词组中词个数权值 + + ; 数: 数字的频度 其他参数 + ; 英: 英文字母的频度 + ; 记: 记号的频度 + ; 开: 开括弧的频度 + ; 闭: 闭括弧的频度 + ; 最: 最大候补个数 + ; 备: 备用 + + + * Note + A semicolon ";" at the beginning of the line means that the whole statement + is treated as comment. + + + + + + + + - 5-10 - +┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ +┃ 5.4 INITIALIZATION FILE FOR FRONT-END PROCESSOR - uumrc ┃ +┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛ + + * Description + uumrc - The front-end processor (cuum) initialization file + + * Default Paths + /usr/local/lib/wnn/zh_CN/uumrc + + * Function + This is the initialization file for the startup of the front-end processor. + It is read in during the execution of "cuum" command. The initialization + includes: + - Specify the path for each of the environment setup files, the keyboard + definition file etc. + - Specify the initial state of the front-end processor after startup. + - Specify the different conversion parameters. + + * Content + In "uumrc", several settings are made. They include the followings: + + 1. include + - Format + include <path> + This is to read in all other initialization files defined in <path>. + This will be used only when additional user definitions are needed. + + + + + + + + + + + + + + + + + + + + + + + - 5-11 - + 2. setenv + - Format + setenv <env_type> <path> [sticky] + setenv <env_type> <host> <path> [sticky] + This is to set the forward conversion environment, based on the contents in + the environment definition files indicated by <path>. + <host> is the machines hostname. If <host> is given, the server will be + that of the specified hostname, and the environment will be created by + this server. + + [sticky] is a flag that implies a permanent environment. If [sticky] is + specified, every time a front-end processor is connected to the cserver, it + will increase by one. The environment created will remain in the cserver + even though the front-end processor has terminated. This environment will + be used during the next startup of front-end processor, hence improving the + speed of startup time. The [ ] means that it may be omitted. If [sticky] + is not specified, the environment created will be deleted from the cserver + after the front-end processor has exited. + + <env_type> indicates the environment type. This includes Pinyin/Zhuyin + input and the encoded input environment. + Pinyin/Zhuyin input environment is represented by "PZ". The encoded input + environment corresponds to first alphabet of the respective input method + name. For example, Wubi input environment is represented by "W" and Qianma + input environment is "Q". + + - Default Path + /usr/local/lib/wnn/zh_CN/ + + 3. setenv_R + - Format + setenv_R <env_type> <path> [sticky] + setenv_R <env_type> <host> <path> [sticky] + Similar to "2. setenv" above. The only difference is that "setenv_R" + is meant for reverse conversion. + For example, Pinyin-Hanzi conversion is a forward conversion, while the + reverse conversion is Hanzi-Pinyin conversion. The reverse conversion of + Bianma-Hanzi conversion is Hanzi-Bianma conversion. + + - Default Path + /usr/local/lib/wnn/zh_CN/ + + + + + + + + + - 5-12 - + 4. setuumkey + - Format + setuumkey <path> + To specify the path for keyboard definition file of the front-end processor. + <path> is the path of the keyboard definition file "uumkey". For details + on uumkey, refer to Section 5.7 + + - Default Path + /usr/local/lib/wnn/zh_CN/uumkey + + + 5. setrkfile + - Format + setrkfile <path> + To specify the input mode definition files. + <path> is the directory of the input mode definition files. All input + modes under this directory will be read. Input mode includes Pinyin + input mode, Zhuyin input mode, Wubi input mode etc. + + - Default Path + /usr/local/lib/wnn/zh_CN/rk/mode ─ combination of Pinyin/Zhuyin + input environment + /usr/local/lib/wnn/zh_CN/rk_p/mode ─ Pinyin centred input environment + /usr/local/lib/wnn/zh_CN/rk_z/mode ─ Zhuyin centred input environment + + 6. setconvkey + - Format + setconvkey [<tty>] <path> + To specify a keyboard to cWnn's default keyboard definition. + The terminal name [<tty>] must correspond to that defined in the environment + variable TERM, else the definitions will be invalid. + The wildcard character "*" may be used in the terminal name. + <path> is the path of this keyboard definition file, which shows the different + key bind between terminals. + + - Default Path + /usr/local/lib/wnn/zh_CN/cvt_key_tbl/ + + 7. setdicpath + - Format + setdicpath <path> + To specify the path of the dictionary added dynamically to the system. By + having set this path, any dictionary added during the environment operation + function "Dictionary Add" will be added to this directory. + + + + + + - 5-13 - + 8. setfrepath + - Format + setfreqpath <path> + To specify the path of the usage frequency files when a dictionary is added + dynamically to the system. By having set this path, any dictionary added + during the environment operation function "Dictionary Add" will have its + usage frequency files added in this directory. + + 9. setgrammarpath + - Format + setgrammarpath <path> + To specify the path of the grammar files when a dictionary is added + dynamically to the system. By having set this path, any dictionary added + during the environment operation function "Dictionary Add" will have its + grammar files added in this directory. + + 10. not_send_ascii_char + When the input line is empty, and the input is ASCII characters, these + ASCII characters will NOT be sent to the cursor position, but will be sent + to the conversion buffer. (Default) + + 11. send_ascii_char + When the input line is empty, and the input is ASCII characters, these + ASCII characters will be sent directly to the cursor position, bypassing + the conversion buffer. + + 12. waking_up_in_convert_mode + To set the conversion mode to ON after the startup of the front-end + processor. + + 13. waking_up_no_convert_mode + To set the conversion mode to OFF after the startup of the front-end + processor. (Default) + + 14. setmaxchg <number> + Indicates the maximum number of characters allowed for conversion at one + time. Default value for <number> is 80. + + 15. setmaxbunsetsu <number> + Indicates the maximum number of words allowed for conversion at one time. + The maximum value is 400 and default value of <number> is 80. + + 16. setmaxichirankosu <number> + Indicates the number of candidates to be displayed at one time. This will + depend on the width of the screen. Default <number> value is 36. + + + + + - 5-14 - + 17. setmaxhistory <number> + Indicates the maximum number of entries for the conversion history. + Default <number> value is 10. + + 18. simple_delete + Once the user input string is mapped to its corresponding standard + Pinyin, the standard Pinyin will be deleted as a single unit instead of + character by character. + + 19. flow_control_on + To set the flow control of tty to ON. (Default) + + 20. flow_control_off + To set the flow control of tty to OFF. + + 21. convkey_not_always_on + When the input mode is set to OFF, all related conversion function keys + are invalid. (Default) + + 22. convkey_always_on + When the input mode is set to ON, all related conversion function keys + are still valid. + + 23. remove_cs + To remove cs from termcap. + + 24. not_remove_cs + Do not remove cs from termcap. + + 25. touroku_comment + During the addition of a new word, comments are allowed to be input. + + 26. touroku_no_comment + During the addition of a new word, comments are not allowed to be input. + + + * During path setting, the following abbreviations can be used : + (1) ~ The value of environment variable HOME. + (2) ~usrname The home directory of the user registered in the password + file. + (3) @HOME The value of environment variable HOME. + (4) @LIBDIR The path "/usr/local/lib/wnn/zh_CN". + (5) @USR The current value of environment variable LOGNAME. + + + + + + + - 5-15 - + * Example + setenv PZ /usr/local/lib/wnn/@LANG/wnnenvrc + setenv_R PZ /usr/local/lib/wnn/@LANG/wnnenvrc_R + + setenv W /usr/local/lib/wnn/@LANG/wnnenvrc_Wu + setenv_R W /usr/local/lib/wnn/@LANG/wnnenvrc_WuR + setenv Q /usr/local/lib/wnn/@LANG/wnnenvrc_Qi + setenv_R Q /usr/local/lib/wnn/@LANG/wnnenvrc_QiR + + setuumkey /usr/local/lib/wnn/@LANG/uumkey + setrkfile /usr/local/lib/wnn/@LANG/rk + + setconvkey /usr/local/lib/wnn/cvt_key_tbl + setconvkey ST* /usr/local/lib/wnn/cvt_key_tbl.ST + setconvkey gmw* /usr/local/lib/wnn/cvt_key_tbl.gmw + setconvkey kterm* /usr/local/lib/wnn/cvt_key_tbl.kt + setconvkey PIC* /usr/local/lib/wnn/cvt_key_tbl.ST + setconvkey om* /usr/local/lib/wnn/cvt_key_tbl.ST + + setmaxhistory 20 + + waking_up_no_henkan_mode + flow_control_on + touroku_comment + not_send_ascii_char + simple_delete + + + * Note + - A semicolon ";" at the beginning of the line means that the whole statement + is treated as comment. + - During the startup of the front-end processor, files such as dictionaries, + grammar files and usage frequency files that are specified in "uumrc" will + be read in by the server if they have not been read in during cserver + startup. + - During the front-end processor startup, if the usage frequency files do not + exist, the server will create a new frequency file. + + + + + + + + + + + + + - 5-16 - +┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ +┃ 5.5 INITIALIZATION FILE FOR FORWARD CONVERSION ENVIRONMENT - wnnenvrc ┃ +┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛ + + * Description + wnnenvrc - The initialization file for forward conversion environment + + * Default Path + (1) The corresponding file defined in uumrc + (2) /usr/local/lib/wnn/zh_CN/wnnenvrc + + * Function + Defines the forward conversion environment for the user. This file is specified + in "uumrc". If the file is re-specified, the latest version is valid. + + * Content + The settings in "wnnenvrc" include the followings: + + 1. include + - Format + include <wnnenvrc_filename> + To read in other wnnenvrc files. + + + + + + + + + + + + + + + + + + + + + + + + + + + + - 5-17 - + 2. setdic + - Format + setdic <p1> <p2> <p3> <p4> <p5> <p6> <p7> <p8> + To set a dictionary in the current environment. + "setdic" command can be used to specify several dictionaries in the same + environment. + <p1> ─ Specify the dictionary filename. + <p2> ─ Specify the usage frequency filename of the specified dictionary. + * <p2> may be represented by "-" as default. + By default, the usage frequency filename of the specified + dictionary will be used. + * When specifying the usage frequency file <p2>, <p2> must + correspond to the usage frequency filename of <p1>. + <p3> ─ Specify the access priority of the dictionary. + * It is represented in decimal + <p4> ─ Specify whether the dictionary is static or dynamic. + * 1: dictionary is read only + * 0: dictionary can be updated + <p5> ─ Specify whether the usage frequency file is static or dynamic. + * 1: usage frequency file is read only + * 0: usage frequency file can be updated + <p6> ─ Specify the password filename of the specified dictionary. + * <p6> may be represented by "-" as default. + <p7> ─ Specify the password filename of the usage frequency file. + * <p7> may be represented by "-" as default. + <p8> ─ Specify whether it is a forward of reverse dictionary + * 1: Forward + * 0: Reverse + + - Example + setdic basic.dic - 5 0 0 - - 0 + + 3. setgrammar + - Format + setgrammar <file_name> + Specify the grammar file. + + + + + + + + + + + + + + - 5-18 - + 4. setparam + - Format + setparam <c0> <c1> <c2> <c3> <c4> <c5> <c6> <c7> <c8> + <c9> <c10> <c11> <c12> <c13> <c14> <c15> <c16> + + To set the parameter values for Pinyin-Hanzi conversion. The paramters + are explained in Section 5.3. If these are not set, the system will + follow the parameter values set via "def_param" during cserver startup. + The parameters should be integers. During conversion, the server uses + these parameter values to determine the conversion result. + + 5. confirm + When the usage frequency files, or the user dictionaries set via "setdic" + do not exist, the system confirms with the user on whether he wants to + create his new individual files. + + 6. confirm1 + When the usage frequency files, or the user dictionaries set via "setdic" + do not exist, the system confirm only ONCE with the user on whether he + wants to create ALL the new files at one time. + + 7. create_without_confirm + When the usage frequency files of the dictionary, or the user dictionaries + set via "setdic" do not exist, new files will be created automatically. + + 8. no_create + When the usage frequency files of the dictionary, or the user dictionaries + set via "setdic" do not exist, new files will NOT be created automatically. + In this case, the startup of the front-end processor "cuum" will fail. + + * Example + confirm1 + setdic sys/level_1.dic usr/@USR/level_1.h 4 1 0 - - 0 + setdic sys/level_2.dic usr/@USR/level_2.h 1 1 0 - - 0 + setdic sys/basic.dic usr/@USR/basic.h 7 1 0 - - 0 + setdic sys/basic.dic usr/@USR/basic.h 7 1 0 - - 0 + setdic usr/@USR/ud - 5 0 0 - - 0 + + setfuzokugo sys/full.con + + setparam 1 5 2 750 10 80 10 5 1000 50 0 -200 0 0 0 16 0 + ; N M 频 长 四 刚 优 值 组 个 数 英 记 开 闭 最 备 + + + + + + + + - 5-19 - + * Note + - The environment setup files for Wubi(五笔) and Qianma(钱码) have the same + format as Pinyin(拼音). + Environment setup file for Wubi is "wnnenvrc_Wu", and that for Qianma is + "wnnenvrc_Qi". + + - During path specification, the following abbreviations may be used. + (1) ~ The current value of environment variable HOME. + (2) ~username The home directory of the username registered in the password + file. + (3) @HOME The value of environment variable HOME. + (4) @LIBDIR The default path "/usr/local/lib/wnn/zh_CN/" of cWnn's + environment file. + (5) @USR The current value of environment variable LOGNAME. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - 5-20 - +┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ +┃ 5.6 INITIALIZATION FILE FOR REVERSE CONVERSION ENVIRONMENT - wnnenvrc_R ┃ +┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛ + + * Description + wnnenvrc_R - The initialization file for reverse conversion environment. + + * Default Path + (1) The corresponding file defined in uumrc + (2) /usr/local/lib/wnn/zh_CN/wnnenvrc_R + + * Function + Defines the reverse conversion environment for the user. This file is specified + in "uumrc". If the file is re-specified, the latest version is valid. + + * Content + The settings in "wnnenvrc_R" is similar to "wnnenvrc". For details, refer to + Section 5.5. + + * Example + confirm1 + setdic sys/level_1.dic usr/@USR/level_1.h 4 1 0 - - 1 + setdic sys/level_2.dic usr/@USR/level_2.h 1 1 0 - - 1 + setdic sys/basic.dic usr/@USR/basic.h 7 1 0 - - 1 + ;setdic sys/computer.dic usr/@USR/computer.h 4 1 0 - - 1 + + setdic usr/@USR/ud - 5 0 0 - - 1 + + setfuzokugo sys/full.conR + + setparam 1 5 2 750 10 80 10 5 1000 50 0 -200 0 0 0 16 0 + ; N M 频 长 四 刚 优 值 组 个 数 英 记 开 闭 最 备 + + + * Note + - The value of the 8th parameter is "1". This implies that the dictionary is used + for reverse conversion. + + - The environment setup files for Wubi(五笔) and Qianma(钱码) have the same format + as Pinyin(拼音). + Environment setup file for Wubi is "wnnenvrc_WuR", and that for Qianman is + "wnnenvrc_QiR". + + + + + + + + - 5-21 - +┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ +┃ 5.7 KEYBOARD DEFINITION FILE FOR FRONT-END PROCESSOR - uumkey ┃ +┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛ + + * Description + uumkey - The keyboard definition file for the front-end processor + + * Default Path + /usr/local/lib/wnn/zh_CN/uumkey + + * Function + In Chinese input, commands for conversion, selection and other user operations + are implemented via the keyboard input. + "uumkey" is the keyboard definition file. The relation between the code of an + input key and its command is defined in the "uumkey" file. User can define + the function of a particular key according to his needs. + + * Content + The settings in "uumkey" include the followings: + + 1. include + - Format + include <uumkey filename> + To read in other keyboard definition files. + + 2. <command> + - Format + <command> <key> [ <key> ....] + This is to define the function of each key. + + Several <command> are allowed in "uumkey", refer to "Command List" below. + <key> can be represented in decimal, hexadecimal, octal or character + enclosed between single quotes. + + There are 11 states for the front-end processor. Refer to "State Table". + A function key can serve different functions in different states. Hence a + function key may be used in different states for different purposes. + + 3. unset + - Format + unset <command> + To remove all the function key definitions which correspond to <command>. + + + + + + + + - 5-22 - + * State Table + ┌───────┬───────────────────────────────┐ + │ State Number │ Description │ + ├───────┼───────────────────────────────┤ + │ 0 │ This is the state after conversion. The state when correction│ + │ │ on the conversion result is being carried out. │ + │ 1 │ This is the state before conversion, ie. the input state. │ + │ 2 │ This is the state when manual segmentation is performed on │ + │ │ the words and phrases after conversion. │ + │ 3 │ This is the initial state when the input buffer is empty. │ + │ 4 │ This is the state of cursor movement during the selection of │ + │ │ candidates for a Chinese character. │ + │ │ (including the state during selection of phrase candidates, │ + │ │ process of operations, and the state of grammatical │ + │ │ attribute and dictionary selection during addition.) │ + │ 5 │ This is the state when the range of a word is specified │ + │ │ during the process of word add. │ + │ 6 │ This is the state of Pinyin input during the process of word │ + │ │ or dictionary add. │ + │ 7 │ This is the state during word search/delete or dictionary │ + │ │ search/delete. │ + │ 8 │ This is the state during word search or information retrieval│ + │ │ of a word. │ + │ 9 │ This is the state during dictionary search. │ + │ A │ This is the inspect mode. │ + └───────┴───────────────────────────────┘ + + + + + + + + + + + + + + + + + + + + + + + + - 5-23 - + * Command List + ┌─────────────────┬───────────────────┐ + │ henkan_on │ sainyuuryoku │ + │ quote_keyin │ sainyuuryoku_e │ + │ send_string │ │ + │ kakutei │ redraw_line │ + │ │ redraw_line_e │ + │ forward_char │ │ + │ backward_char │ previous_history │ + │ │ previous_history_e │ + │ goto_top_of_line │ │ + │ goto_end_of_line │ next_history │ + │ │ next_history_e │ + │ delete_char_at_cursor │ │ + │ kaijo │ touroku_mark_set │ + │ henkan │ touroku_return │ + │ │ quit │ + │ tan_henkan │ │ + │ tan_henkan_dai │ touroku_jump_forward │ + │ │ touroku_jump_backward │ + │ nobi_henkan │ │ + │ nobi_henkan_dai │ change_to_insert_mode │ + │ │ │ + │ jikouho │ quote │ + │ jikouho_dai │ quote_e │ + │ │ │ + │ zenkouho │ forward_select │ + │ zenkouho_dai │ backward_select │ + │ │ │ + │ select_jikouho │ next_select │ + │ select_jikouho_dai │ previous_select │ + │ │ │ + │ kana_henkan │ linestart_select │ + │ kill │ lineend_select │ + │ │ │ + │ yank │ select_select │ + │ yank_e │ │ + │ │ send_ascii_char │ + │ bunsetu_nobasi │ not_send_ascii_char │ + │ bunsetu_chijime │ pop_send_ascii_char │ + │ │ toggle_send_ascii_char │ + │ jisho_utility │ quote_send_ascii_char │ + │ jisho_utility_e │ │ + │ │ reconnect_jserver │ + │ touroku │ inspect │ + │ touroku_e │ │ + │ │ del_entry │ + │ sakujo_kouho │ use_entry │ + └─────────────────┴───────────────────┘ + - 5-24 - + The following shows the states in which some of the commands can be used, and + their respective functions: + + - henkan_on 0123456789 + To toggle the conversion state to ON or OFF. + + - quote_keyin 0123456789 + To quote the next input character so that function keys used for toggling + the conversion state can also be used as input. This function is used for + special cases when the input of "henkan_on " function key code is needed. + + - send_string 012 + To confirm the user input characters without passing through the conversion + buffer. + + - kakutei 012 + (Confirm) To send the input character string to the cursor position. + + - forward_char 01256 + 156: To move the cursor one character position to the right + 0 : To move the cursor one word to the right + 2 : To remain character at the cursor position as ASCII, and perform multi- + phrase conversion on the character after the cursor, and followed by + moving the cursor one word to the right. + + - backward_char 01256 + 1 : To move the cursor one character position to the left. + If after a conversion, we re-convert certain portion of the converted + result (eg. from middle till end of string) back to user input, leaving + the front portion of the string untouched, then multi-phrase conversion + will be performed when we move the cursor to the left. This will only + be valid when the cursor is at the leftmost position of the unconverted + portion. After this multi-phrase conversion, the cursor will move one + word to the left. + 56 : To move the cursor one character to the left. + 0 : To move the cursor one word to the left. + 2 : The highlighted portion will remain as ASCII, the portion beyond the + highlighted part will undergo multi-phrase conversion, and the cursor + will move one word to the left. + + - goto_top_of_line 01256 + 1256: To move the cursor to the first character of the line. + 0 : To move the cursor to the first word of the line. + + - goto_end_of_line 01256 + 1256: To move the cursor to the last character of the line. + 0 : To move the cursor to the last word of the line. + + + - 5-25 - + - delete_char_at_cursor 156 + To delete the character at the current position of the cursor. + + - kaijo 02 + To change the converted character string after the current cursor position + back to the state before conversion. + + - henkan 1 + To perform multi-phrase conversion. + + - tan_henkan 1 + To treat a word as a single unit and perform word conversion. + + - tan_henkan_dai 1 + To treat a phrase as a single unit and perform a single phrase conversion. + + - nobi_henkan 2 + During word elongation, the highlighted portion will be treated as a word + and undergo word conversion, while the remaining portion will undergo + multi-phrase conversion. + + - nobi_henkan_dai 2 + During compulsory word segmentation, the portion at the cursor will be + treated as a phrase and undergo a single phrase conversion, while the + portion after the cursor will undergo a multi-phrase conversion. + + - jikouho 0 + To extract the next word candidate. + + - jikouho_dai 0 + To extract the next phrase candidate. + + - zenkouho 0 + To extract the previous word candidate. + + - zenkouho_dai 0 + To extract the previous phrase candidate. + + - select_jikouho 0 + To extract the next group of word candidates. + + - select_jikouho_dai 0 + To extract the next group of phrase cnadidates. + + - kana_henkan 1 + To perform Hanzi-Pinyin (or Hanzi-Bianma) conversion, ie. reverse conversion. + + + + - 5-26 - + - kill 156 + To delete the characters from the current cursor position to the end, and + store them in the "kill" buffer. + + - yank 156 + + - yank_e 1356 + To insert the content from the "kill" buffer into the current cursor + position. + + - bunsetu_nobasi 02 + To increase the length of a word by one character. + + - bunsetu_chijime 02 + To decrease the length of a word by one character. + + - jisho_utility 012 + + - jisho_utility_e 0123 + To enter the state of dictionary operation. + + - touroku 012 + + - touroku_e 0123 + To enter the state of word add process. + + - sainyuuryoku 1 + + - sainyuuryoku_e 13 + To re-input the previously input character strings. + + - redraw_line 012456789 + + - redraw_line 0123456789 + To re-display the input line. + + - previous_history 1 + + - previous_history_e 13 + To extract the previous character string stored in the "history" buffer. + + - next_history 1 + + - next_history_e 13 + To extract the next character string stored in the "history" buffer. + + + + + - 5-27 - + - touroku_mark_set 5 + To specify the beginning and ending position of the input string during a + word add process. When the beginning and ending position are the same, + (ie. word length is 0), return to the initial state. + + - touroku_return 6 + To indicate the end of the Pinyin (or radical) input string during a word + add process. + + - quit 4567 + When in a state other than the conversion state or input state (eg. viewing + of candidates for a Chinese character, word add etc, state number 4,5,6,7), + exit this state. + + - touroku_jump_forward 5 + During the word add process, move the cursor to the front by one word. + + - touroku_jump_backward 5 + During the word add process, move the cursor to the rear by one word. + + - change_to_insert_mode 0 + To change the converted input string back to edit mode, and thereafter, + the converted Hanzi will not change back to its Pinyin (or radical) form. + + - quote 1 + + - quote_e 13 + To quote the next input character (except "henkan_on") and omit passing it + to the input automaton conversion. Instead, pass it directly to the input + line. + + - forward_select 4789 + 4 : During the state of candidate selection, the highlighted portion will + move to the right. + 789 : During dictionary search, if a line is not selected, it will scroll + forward. + + - backward_select 4789 + 4 : During the state of candidate selection, the highlighted portion will + move to the left. + 789 : During dictionary search, if a line is not selected, it will scroll + backward. + + + + + + + + - 5-28 - + - next_select 4789 + 4 : During the state of candidate selection, move to the next screen. + 789 : During dictionary search, move to the next line. + + - previous_select 4789 + 4 : During the state of candidate selection, move to the previous screen. + 789 : During dictionary search, move to the previous line. + + - linestart_select 4789 + 4 : During the state of candidate selection, move to the top of the screen. + 789 : During dictionary search, if a line is not selected, move to the + first screen. + + - lineend_select 4789 + 4 : During the state of candidate selection, move to the end of the screen. + 789 : During dictionary search, if a line is not selected, move to the + last screen. + + - select_select 4789 + 4 : During the state of candidate selection, select one candidate and exit + from this state. + 789 : During dictionary search, select a candidate and exit from this state. + + - send_ascii_char 0123456789 + After this command, if the input buffer is empty, the ASCII character input + will NOT be sent to the buffer. + + - not_send_ascii_char 0123456789 + After this command, if the input buffer is empty, the ASCII character input + will be sent to the buffer. + + - pop_send_ascii_char 0123456789 + After this command, if the input buffer is empty, the operation of the ASCII + character input will be changed back to its previous state. + + - toggle_send_ascii_char 0123456789 + After this command, if the input buffer is empty, the operation of the ASCII + character input will be reversed (ie. if the current operation is + "send_ascii_char", it will be set to "not_send_ascii_char" and vice versa). + + - quote_send_ascii_char + During the "send_ascii_char" state, if the buffer is empty, the next ASCII + character will enter the buffer. However, subsequent characters will not + enter the buffer even if it is empty. + + - reconnect_jserver 012456789 + To reconnect with the cserver + + + - 5-29 - + - inspect 0 + To check the dictionary. + + - sakujo_kouho 0 + To delete a candidate. + + - del_entry 89 + To delete dictionary as well as the words in the dictionary. + + - use_entry 89 + To temporary stop and subsequently re-use the dictionary and the words + in the dictionary. + + + * Example + ;Commands Codes + forward_char ^F 0x90 + backward_char ^B 0x91 + goto_top_of_line ^A 0x9 + goto_end_of_line ^E 0x9B + + + * Note + - Lines that begin with ";" are treated as comments. + - When the conversion state is OFF, the front-end processor will be temporarily. + disconnected. At the same time, the input automaton also stops functioning. + Hence, not all codes can be entered from the keyboard. (A key code refers to + a code between 0 and 255.) + To input a code that cannot be entered directly via the keyboard, you may use + the key code conversion (Refer to Section 5.8) or input automaton (Refer to + Chapter 7). + + + + + + + + + + + + + + + + + + + - 5-30 - +┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ +┃ 5.8 CONVERSION FILE FOR KEYBOARD INPUT CODE - cvt_key_tbl ┃ +┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛ + + * Description + cvt_key_tbl - The conversion file for the keyboard input code. + It shows the different key bind between terminals. + + * Default Path + /usr/local/lib/wnn/cvt_key_tbl + + * Function + Definitions that convert the character sequences defined in terminfo/ + termcap into single character codes. + + * Content + The terminfo or termcap entries and the input codes are specified here. + - Format + <terminfo_entry> <code> (for Unios-U) + <termcap_entry> <code> (for Unios-B, Mach) + + For terminfo entries and termcap entries, refer to Unix manuals for the + respective informations. + + + + + + + + + + + + + + + + + + + + + + + + + + + - 5-31 - + - Code expression + (1) Except for space, \ and ^ , all characters will be represented as + they are. Example: A, 1. + + (2) ^<character> + <character> can be @, A(a), B(b), C(c), D(d), E(e), F(f), ...Z(z), + [, \ ,], ^, _ + + ^@ is Ctrl + space (0x00) + ^A is Ctrl + A (0x01) + : + : + ^_ is Ctrl + _ (0x1f) + + (3) \<octal number>, \o<octal number>, \d<decimal number>, + \x<hexadecimal number> character codes can be represented directly. + Example: \x81 + + (4) \n, \t, \b, \r, \f, \e, \E represent NEWLINE, TAB, BACKSPACE, CR, + FORMFEED, ESC, ESC respectively. + + (5) \<character> + <character> can be any character except 0,1,2,3,4,5,6,7, o,d,x,n, + t,b,r,f,e,E + \\ means \ itself. + + * Example + kl \x81 + ku \x82 + kr \x83 + kd \x84 + + + * Note + Input codes in this conversion file will be evaluated when they are being + processed in the followings: + (a) input mode control table (2A_CTRL) of input automaton + (b) uumkey + + * Reference + uumkey(5.7) + + + + + + + + + - 5-32 -