YYT(1)

👑 YYT(1) — the Yi Yan Tang user manual, bestie edition 💖

okay so. welcome to the yyt manual, which is a real program, and which is literally a pseudo tty program that automatically converts among Chinese encodings. yes. that's the whole vibe. it's giving multilingual excellence and I am obsessed 🦋

---

✨ NAME ✨

yyt — a pseudo 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 you don't give one, the default is set to the environment variable SHELL. And if SHELL is not set? Then /bin/sh gets used. so it's never gonna leave you hanging, periodt 💅

---

🎀 DESCRIPTION 🎀

so yyt is a pseudo tty program that will translate Chinese encodings automatically on a console. no cap. the supported encodings are BIG5/GB2312/HZ/UTF-7/UTF-8/UCS. slay.

yyt is similar to hztty(1) except that yyt will make things automatic all the way. like, the whole way. main character energy fr fr ✨

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, --from=encoding — This option sets the encoding of the incoming text. The valid values of encoding are specified above. 💜
• -t encoding, --to=encoding — This option sets the encoding of the local terminal. The valid values of encoding are specified above. 🌈
• -h, --help — This option prints out the usage of yyt. 🎀
• -V, --version — Gives the current version of ytt. (yes it says ytt in the original, and yes we are keeping it, character for character, no notes 😭)

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. iykyk 🌸

---

🦋 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. so many choices bestie 💅

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. one and done, iconic behavior ✨

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. (the self-referential queen 💀)

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 Overridden by the --to command line option. (yes, "Overridden" with a capital O, we keep the facts exactly as they are 🎀)
• 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. (short, sweet, straight to the point — honestly? respect 😭)

---

🍓 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)

---

and that's the whole page, bestie!! this one is YiYanTang, dated June 2001, and it lives at section YYT(1) of the manual. go forth and convert those encodings automatically, you absolute icon 👑✨💖