Subject: CCTeach software release!

From: Xiaokun Zhu <[email-masked]>
Date: Thu, 26 Aug 1993 18:11:36 BST

Hi, netters

I wrote three short programs (cctch, it2dic, wb2cz) known as
Chinese Character Teacher. I have unloaded the package to
ifcss.org /incoming (CCTeacher.readme, CCTeacher0.9.tar.Z,
CCTeacher09.zip) and grumpy.ssc.gov (143.202.140.25)

"cctch" can help new users learn Chinese Character input method.
It suppots Both GB and Big5 (ETen and HongKong) standard. GB interal
code, QuWei code and Big5 (ETen and HongKong)
interal code are integrated into "cctch", others CC input method
also are supported by external dictionary file.
The program "it2dic" will help users convert text input
table of Chinese Character into external dictionary format.
The program "wb2cz" will help users encode Chinese Character
Phrase with Wu Bi input method.

There are two work modes and four display modes in "cctch". The first
is mapping a kind of CC input method to another. The second is
supporting wildcode match in a CC input method. If you know a kind of
CC input method, for example PinYin, You may use the first mode to
learn some new input method, for example WuBi. If you do not know any
CC input method, but you like to learn, you may use the second mode.
"cctch" selects automaticly GB or ETen Big5 display mode according
to its dictionary, but user can also override to set display mode to
HZ or HongKong Big5.

This release is beta version (0.9), but it is stable enough.
I have included four popular input dictionary  "wubi.dic",
"tonepy.dic" based GB. and "cj.dic", "etzy.dic" based ETen Big5.
For any other input method, if you got its original text input table,
for example "*.tit" files from cxterm packages, you can use
program "it2dic" to convert it to dictionary format.

"cctch" need some Chinese Character enviroment to support CC display,
for example, cxterm in X-window, ZWDOS or KC in PC, etc.

1. FILE LIST:
        CCTeach.doc --- this file
        CCTeach09.zip --- Wu Bi tools of PC version 0.9
                it2dic.exe --- convert CC input table into dictionary format
                cctch.exe --- CC input method Teacher
                cz2wb.exe --- encode CC phrase with Wu Bi input method
                README --- this file
                wubi.dic --- Wu Bi input method dictionary
                tonepy.dic --- Tone PiYin input method dictionary
                cj.dic --- CJ input table
                etzy.dic --- ETZY input method dictionary
                wubi.it --- Wu Bi input method table
                1000.gb --- test file GB format
                1.cz --- test file of Ci Zu
                1.b5 --- test file of ETen big5
                1.hb5 --- test file of HongKong Big5
        CCTeach0.9.tar.Z --- Wu Bi tools of unix version 0.9
                Makefile
                it2dic.c --- convert CC input table into dictionary format
                cctch.c --- CC input method Teacher
                cz2wb.c --- encode CC phrase with Wu Bi input method
                README --- this file
                wubi.it --- Wu Bi input table
                tonepy.it --- Tone PiYin input table
                cj.it --- CJ input table
                etzy.it --- ETZY input table
                1000.gb --- test file GB format
                1.cz --- test file of Ci Zu
                1.b5 --- test file of ETen Big5
                1.hb5 --- test file of HongKong Big5

2. Install:

  For PC user, pkunzip file wbtools09.zip. everything is OK!

  For unix user,
      zcat wbtools0.9.tar.Z | tar xvf
      cd CCTeach0.9
      make
if you have cxterm software package,
      cp *.dic $(HZINPUTDIR)

3. File Format:

   cz2wb : receive Chinese Character phrase, but ignore CC word.
           character '#' or '*' starts comments.
   it2cit: receive CC word only. The format is
                    key CCstring
           the same as *.tit fo cxterm packages. The comments line
           is the same as cz2wb. The dictionary of it2cit output is
             HEAD[3] ARRAY[MODE][KEY_LEN] ARRAY_A[7693][KEY_LEN]
           for GB MODE is 6768 and no ARRAY_A, for BIG5 MODE is 5401.
   cctch : output format is
                  in_key CC out_key
           if no multi-match, or
                  in_key CC out_key [CC out_key] ...
           If in_key or out_key is internal code, the corresponding key
           will be omitted.

4. Usage:

      cz2wb < 1.cz > 1.tit
in file 1.tit you get 9 lines Wu Bi Ci Zu encode table.

      it2dit -kkey_len -wsymbol [-m[g,b,h]] < infile.it > infile.dic
where option -k defines input key length limited in [4,8]; option -w defnes
wildcode (defaults is ?); and -m[g,b,h] g for GB, b for ETen Big5, h for HongKon
 g
(defaults is GB). for example,
      it2dit -k4 -wz < wubi.it > wubi.dic
      it2dit -k5 -mb < cj.it > cj.dic

      cctch -i[g,q,b,in.dic] -o[q,g,b,out.dic] [-h] [< infile] [> outfile]
where option -i is for CC input encoding method, its includes four selections:
g for GB internal code, q for Qu Wei code, b for ETen Big 5 internal code, and
in.dic for external dictionary. Option -o is for output encoding method, its
also includes four selections. Option -h is for displaying HZ instead of GB.
for example,
      cctch -ii -oq < 1000.gb
      cctch -ii -owubi.dic < 1000.gb > 1000.wb
      cctch -ii -otonepy.py < 1000.py
      cctch -itonepy.dic -owubi.dic
      cctch -iwubi.dic -ow
      cctch -ib -ocj.dic < 1.b5 > 1.cj
      cctch -ib -oetzy.dic < 1.b5
      cctch -ib -ocj.dic -h < 1.hb5
      cctch -icj.dic -ob < 1.cj
      cctch -icj.dic -ow
      cctch -icj.dic -ow -h

5. CCTeach is distributed under a GNU COPYING "copyleft" license.

6. ACKNOWLEDGE

   "wubi.it" comes from "wubicizu.gb" which is writen by Yu Huang
   ([email-masked]).

   "tonepy.it" comes from "TONEPY.tit" which is part of cxterm package,
   The authors are:
      Yongguang Zhang                   Man-Chi Pong
    ([email-masked])              ([email-masked])

   "cj.it" comes from CJ.tit and "etzy.it" from "ETZY.tit". Both of
   them are the part of "NCTU-CSIE*.tit", which are modified by
   Wei-Chung Hwang ([email-masked]) from cxterm packages.

   "1000.gb" is inputed by XiaoYu Li ([email-masked]).

   Many thanks to them.

Enjoy!

---
xiaokun Zhu ([email-masked])