~lidaobing/+junk/zhcon

« back to all changes in this revision

Viewing changes to README

  • Committer: LI Daobing
  • Date: 2008-11-04 04:39:18 UTC
  • Revision ID: lidaobing@gmail.com-20081104043918-nfwwvgfb0uied0mt
importĀ 1:0.2.6-5.1

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
INTRODUCTION
 
2
============
 
3
Zhcon is a fast Linux Console Chinese System which supports
 
4
framebuffer device.It can display Chinese, Japanese or Korean
 
5
double byte characters.Supported language encodings include:
 
6
GB2312, GBK, BIG5, JIS and KSC.
 
7
It can also use input methods(table based) from M$ pwin98 and
 
8
UCDOS for M$-DOG.
 
9
 
 
10
LICENSE
 
11
=======
 
12
All the source codes are published under GPL!(see COPYING)
 
13
The input methods used in zhcon are originally written by
 
14
ejoy<ejoy@users.sf.net> and are published under GPL too!
 
15
However currently the words of the ime are converted from M$ windows
 
16
& UCDOS. Future version of zhcon will use its own input table to
 
17
purify its *free* spirit.
 
18
The bpsf font format used in zhcon is proposed by one of its core
 
19
developers Hu Yong<ccpaging@etang.com> based on psf format.See doc/
 
20
bpsf.txt for more detail.
 
21
 
 
22
DOWNLOAD & INSTALL
 
23
==================
 
24
Please visit http://zhcon.gnuchina.org for latest package download information.
 
25
Development info can be found at http://sourceforge.net/projects/zhcon
 
26
 
 
27
See INSTALL for install information.
 
28
Full user manual is located in doc/
 
29
 
 
30
FAQ & BUG REPORT
 
31
================
 
32
There's a online FAQ available at http://zhcon.gnuchina.org
 
33
You should read the FAQ when you encounter problem.
 
34
If you are sure you find a bug in zhcon please report it to 
 
35
zhcon-devel@lists.sourceforge.net
 
36
Please include detail description of the problem you found as well
 
37
as you system info (uname -a) so we can reproduce the bug.
 
38
Send us patches if you can!
 
39
 
 
40
BSD NOTICE!
 
41
===========
 
42
This version includes a beta FreeBSD port and has been tested on 
 
43
FreeBSD 4.8. You should read README.BSD before you start.
 
44
Mouse cut & paste should work fine on FreeBSD platform, but Linux gpm
 
45
support is still in progress, see below.
 
46
 
 
47
GPM MOUSE
 
48
=========
 
49
For guys who want to use zhcon with gpm mouse support, please
 
50
read README.gpm before you start. You can try but we do not promise 
 
51
it will work on your machine.
 
52
 
 
53
QUICK FB SETUP
 
54
==============
 
55
Set console as fb device
 
56
Add line to /etc/lilo.conf as below:
 
57
 
 
58
vga=0x303
 
59
image=/boot/vmlinuz
 
60
    label=FrameBuf
 
61
 
 
62
#lilo -v
 
63
#reboot
 
64
 
 
65
The  following table shows the mode numbers you can input at
 
66
the VGA prompt  or  for use with the LILO program. (actually
 
67
these  numbers  are plus 0x200 to make it easier to refer to
 
68
the table)
 
69
 
 
70
Colours 640x400 640x480 800x600 1024x768 1280x1024 1600x1200
 
71
-------+----------------------------------------------------
 
72
 4 bits|   ?       ?     0x302      ?        ?         ?
 
73
 8 bits| 0x300   0x301   0x303    0x305    0x307     0x31C
 
74
15 bits|   ?     0x310   0x313    0x316    0x319     0x31D
 
75
16 bits|   ?     0x311   0x314    0x317    0x31A     0x31E
 
76
24 bits|   ?     0x312   0x315    0x318    0x31B     0x31F
 
77
32 bits|   ?       ?       ?        ?        ?         ?
 
78
 
 
79
Key:  8 bits = 256 colours,  15 bits = 32, 768 colours,  
 
80
16 bits = 65, 536 colours,   24  bits  = 16.8 million colours, 
 
81
32 bits - same as 24 bits,  but  the extra 8 bits can be used
 
82
for  other  things,  and fits perfectly with a 32 bit PCI/VLB
 
83
/EISA bus.
 
84
 
 
85
Additional  modes are at the discretion of the manufacturer, 
 
86
as the VESA 2.0 document only defines modes up to 0x31F. You
 
87
may  need  to  do  some  fiddling around to find these extra 
 
88
modes.
 
89
 
 
90
KEY SUMMAY
 
91
==========
 
92
CTRL_ALT_H:     pop up online help
 
93
CTRL_SPACE:     open/close input method
 
94
ALT_SPACE:      show/hide input bar(open/close CJK mode)
 
95
CTRL_, :         toggle Full/Half char mode
 
96
CTRL_.:         toggle Chinese symbol
 
97
CTRL_F1:        set encode to GB2312
 
98
CTRL_F2:        set encode to GBK
 
99
CTRL_F3:        set encode to BIG5
 
100
CTRL_F4:        set encode to JIS
 
101
CTRL_F5:        set encode to KSC
 
102
CTRL_F7:        toggle input style
 
103
CTRL_F9:        toggle GB2312/BIG5 auto-detect mode
 
104
CTRL_F10:       menu mode
 
105
CTRL_ALT_1 - CTRL_ALT_9: switch to input method 1 to 9
 
106
CTRL_ALT_0:     English mode
 
107
 
 
108
History mode keys:
 
109
SHIFT_PAGEUP:       scroll up half screen in history
 
110
SHIFT_PAGEDOWN:     scroll down half screen in history
 
111
SHIFT_ARROWUP:      scroll up one line in history
 
112
SHIFT_ARROWDOWN:    scroll down one in history
 
113
 
 
114
THANKS
 
115
======
 
116
When I write this program the following source code help me 
 
117
a lot,  so I must thank their authors here.
 
118
chdrv, jmce   //they show me how a Chinese console works.
 
119
unicon        //language encoding and font support,  great!
 
120
/usr/src/linux/video/fbcon-*.c        //low level framebuffer routine.
 
121
/usr/src/linux/drivers/char/console.c // VT102 implementation. 
 
122
autoconvert  //GB2312/BIG5 auto-detect&convert
 
123
                                ejoy <ejoy@users.sf.net>
 
124
 
 
125
vi:ts=4:expandtab