## Notice: 
this IME framework is under development, and further implementation will be
merged in the further, although it is already very powerful now:)

1.Requirement:
>=python-2.5 (we need the sqlite3 in it)
If you build python by yourself
please make sure you make the sqlite3 feather available.
If you use gentoo, make sure you emerge python with sqlite USE

>=scim-python-0.1.10 or svn version.
In Gentoo, you only need to use gentoo-china overlay, which contain the
scim-python-9999.ebuild.


2.Install:
You can use XMCreateDB.py to build up a database:

python XMCreateDB.py -n tables/zm.db -s zhengma.txt.bz2

then, copy the XingMa directory to /usr/share/scim-python/engine/ which
already contain the PinYin and EnglishWriter directories.
copy the zhengma.png to /usr/share/scim/icons/

logout your Xsession, stop gdm/kdm/xdm, clear your /tmp/ and then login your
Xsession, it should be work now.

3.Usage
3.1 Basic input:
<Space> : directly commit string to program;
<Shift> : not in inputting, change input mode between XingMa and English;
          during inputting, commit string to preedit string, this is for user define phrase;
<Arrow Left> and <Arrow Right> : move cursor in preedit string;
<Backspace> : remove input chars or remove a char in preedit string;
<Delete> : delete a char in preedit string;
<Control> + <Arrow Left>  : move to the start of a phrase in preedit string;
<Control> + <Arrow Right> : move to the end of a phrase in preedit string;
<Control> + <Backspace>   : remove to the start of a phrase in preedit string;
<Control> + <Delete>      : delete to the end of a phrase in preedit string;
<Arrow Down> : move cursor to the next phrase in lookup table;
<Arrow Up> : move cursor to the before phrase in lookup table;
<Return> : when not press <Shift> (do not commit to preedit string), commit input chars as English words into programe; else clean the preedit string;
<Esc> : reset the IME;
<Num 1> ~ <Num 9> : select phrase in lookup table and commit preedit string to program;
<Control> + ( <Num 1> ~ <Num 9>): select phrase in lookup table and only commit it into preedit string, this is for user define phrases.

4 DIY:
to add your diy IME, you need a source file of your IME, you can learn needed config variables from zhengma.txt.bz2