Mercurial > freewnn
view cWnn/manual/chap5 @ 10:fc3022f61fc7
tiny clean up
| author | Yoshiki Yazawa <yaz@cc.rim.or.jp> |
|---|---|
| date | Fri, 21 Dec 2007 17:23:36 +0900 |
| parents | bbc77ca4def5 |
| children |
line wrap: on
line source
┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ ┃ Ｃｈａｐｔｅｒ ５ ＥＮＶＩＲＯＮＭＥＮＴ ＳＥＴＵＰ ┃ ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛ ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛ ┏━━━━━━━━┓ ┃ 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 -