NAME
yyt - A psuedo tty program which automatically converts among Chinese
encodings.
SYNOPSIS
yyt [-h|--help]
yyt [-V|--version]
yyt [-f encoding|--from=encoding] [-t encoding|--to=encoding]
[command...]
Where [command...] is the command you want to run using yyt. If not
given, the default is set to the environment variable SHELL. If SHELL
is not set, /bin/sh will be used.
DESCRIPTION
yyt is a psuedo tty program that will translate Chinese encodings
automatically on a console. Supported encodings are
BIG5/GB2312/HZ/UTF-7/UTF-8/UCS.
yyt is similar to hztty(1) except that yyt will make things automatic
all the way.
Yi Yan Tang use Saka’s libhz to detect and convert Chinese encodings.
libhz is include in autoconvert and can be found at
http://www.debian.org/~ygh/.
OPTIONS
yyt supports following Chinese encodings for both input and output:
GB2312, BIG5, HZ, UTF-7, UTF-8, UCS
yyt supports following command line options:
-f encoding or --from=encoding
This option sets the encoding of the incoming text. The valid
values of encoding are specified above.
-t encoding or --to=encoding
This option sets the encoding of the local terminal. The valid
values of encoding are specified above.
-h or --help
This option prints out the usage of yyt.
-V or --version
Gives the current version of ytt.
NOTE: If the --from encoding is not set, yyt will guess the encoding of
the incoming text. You can safely type the command:
% yyt
to start the program. Then you can use the command-mode described below
to control how yyt acts.
USAGE
There are some on the fly commands which can be used to control the
behavior of yyt once it is started. User can use these commands to
switch encoding, disable auto-encoding-detection or turn off encoding
conversion all together.
To active the yyt command mode, press the combination key
ctrl-y
(for switch-on-YYT-command-mode). Then follow a single key command.
Once the command is entered, the command mode is switched off.
The possible commands in the command mode are:
g For switch incoming encoding to GB2312 encoding.
b For switch incoming encoding to BIG5 encoding.
h For switch incoming encoding to HZ encoding.
u For switch incoming encoding to UCS encoding.
7 For switch incoming encoding to UTF-7 encoding.
8 For switch incoming encoding to UTF-8 encoding.
r For reset encoding state to the initial mode.
d For turn off all the encoding conversions.
a For set the incoming encoding to auto-detect mode.
y For input a ctrl-y keycode to the terminal so that ctrl-y can
still be typed in.
Note: If the incoming encoding is explicitly set either through command
line options or on line command, the user input is also converted from
the terminal encoding to the incoming encoding.
ENVIRONMENT
LC_CTYPE
If set, the incoming encoding will be set to the encoding of
LC_CTYPE. LC_CTYPE will be Overriden by the --to command line
option.
SHELL
If set and there are no command line option given for
[command...], the SHELL will be executed on the start of the
program.
DIAGNOSTICS
Please see BUGS section.
BUGS
yyt tries to segment a stream of text into Hanzi parts and English
parts. That way, we can have a better guessing on the Chinese
encodings for every small part of Chinese. However, Hanzi segmentation
does not always work correctly, especially when using curses/slang
based programs. Redraw screen (normally ctrl-l) sometime correct it.
This problem is expected. Suggestions on better segmentation algrithm
are always welcomed.
Turn off auto-detection by specify a fromcode by (ctr-y key ) will give
better conversion result.
AUTHOR
hashao <hashao@chinese.com>
SEE ALSO
libhz(3), pyhz(7), hztty(1)
yiyantang homepage at http://yiyantang.on.openave.net/
autoconvert homepage at http://www.debian.org/~ygh/