71 lines
1.5 KiB
Markdown
71 lines
1.5 KiB
Markdown
# strans
|
|
|
|
An input method daemon for CJK text entry on X11.
|
|
|
|
Inspired by 9front's ktrans. Threads communicate via CSP channels.
|
|
|
|
## Dependencies
|
|
|
|
- plan9port
|
|
- gtk+-3.0 (optional, for GTK IM module)
|
|
|
|
## Build
|
|
|
|
make
|
|
cd xim && make # XIM adapter
|
|
cd gtk && make docker && make install # GTK IM module
|
|
|
|
## Run
|
|
|
|
./strans map font &
|
|
|
|
For XIM apps:
|
|
|
|
./xim/strans-xim &
|
|
XMODIFIERS=@im=strans xterm
|
|
|
|
For GTK apps:
|
|
|
|
GTK_IM_MODULE=strans gedit
|
|
|
|
## Usage
|
|
|
|
Switch input modes with Ctrl + key:
|
|
|
|
N Hiragana
|
|
K Katakana
|
|
S Hangul
|
|
T English
|
|
V Vietnamese (Telex)
|
|
E Emoji
|
|
|
|
Type romanized input. Select candidates with 1-9 or arrow keys.
|
|
Tab or Enter to commit.
|
|
|
|
## Architecture
|
|
|
|
Four threads communicate via CSP channels:
|
|
|
|
- [imthread](strans.c#L271): keystroke processing, transliteration
|
|
- [dictthread](dict.c#L38): dictionary lookup
|
|
- [drawthread](win.c#L133): preedit window rendering
|
|
- [srvthread](srv.c#L42): IPC via unix socket
|
|
|
|
Adapters (strans-xim, im-strans.so) bridge X11/GTK events.
|
|
|
|
## Files
|
|
|
|
strans.c input method engine
|
|
dict.c dictionary queries
|
|
win.c xcb window management
|
|
font.c truetype rendering (stb_truetype)
|
|
map/ transliteration tables
|
|
font/ bundled CJK fonts
|
|
|
|
## References
|
|
|
|
- https://git.9front.org/plan9front/plan9front/HEAD/info.html
|
|
- https://np.mkv.li/kor/9front-ktrans-%ED%95%9C%EA%B8%80-%EB%98%91%EB%B0%94%EB%A1%9C-%EB%A7%8C%EB%93%A4%EA%B8%B0/
|
|
- https://en.wikipedia.org/wiki/Telex_(input_method)
|
|
- https://gist.github.com/hieuthi/0f5adb7d3f79e7fb67e0e499004bf558
|