NAME
ucimf - unicode console input method framework
DESCRIPTION
ucimf is an input method framework designed for Linux unicode console.
FEATURE
Support UTF-8
â.br
Support OpenVanilla Modules
â.br
Support PCF, TrueType Font
â.br
Provide OverSpot style compose window
â.br
Provide C/C++ API
â.br
BOOT PARAMETERS
Framebuffer mode is needed.
You can add "vga=XXX" to LILO, GRUB, or other bootloaders to let the
kernel start with proper framebuffer mode automatically.
vga=785 (640x480, 16 ), vga=788 (800x600, 16 ), vga=791 (1024x768,
16 ), vga=794 (1280x1024, 16 )
USAGE
ucimf needs to run under an UTF-8 consle environment, please use locale
-a to see the UTF-8 locales that your system is supported and use
command like export LC_ALL=zh_CN.UTF-8 to set up the locale.
To start ucimf with FbTerm, prefer to install fbterm-ucimf package and
run fbterm -i fbterm_ucimf, or see ucimf_start(1) as an not-recommended
alternate.
When the user is running an FbTerm, key combination Ctrl+Space is the
switch of enable/disable the input method, Ctrl+ShiftLeft to switch to
next input method, and Ctrl+ShiftRight to switch to next input method
framework.
For jfbterm, F12 is the switch of enable/disable the input method, F11
to switch to next input method, and F10 to next input method framework.
If the user wishes to use Ctrl+Space and Ctrl+ShiftLeft under jfbterm,
please use ucimf_keyboard, which maps Ctrl+Space to F12, and
Ctrl+ShiftLeft to F11.
TABLE MANAGEMENT
ucimf use standard *.cin files directly to manage its input method
tables, per-user input method tables is put in
~/.openvanilla/OVIMGeneric/.
Installing or removing a table is simply copy or remove a file in that
directory.
The order of loading table is managed by the name of the table files,
for exaple you can name your tables like this:
01_xxx.cin, 02_xyz.cin, 03_aaa.cin, ...
ucimf will follow this order while loading input method tables.
SHELL ENVIRONMENT
LC_CTYPE - use UTF-8 as to recogize characters. For example:
export LC_CTYPE=zh_CN.UTF-8
OVMODULE_DIR - to customize OpenVanilla modules location at run-time.
For example:
export OVMODULE_DIR=/usr/lib/openvanilla/
SEE ALSO
ucimf_start(1), ucimf_keyboard(1), ucimf.conf(5).
AUTHOR
libucimf was written by Chun-Yu Lee (Mat) <MatLinuxer2@gmail.com> and
Jim Huang <jserv.tw@gmail.com>.
This manual page was written by Aron Xu <happyaron.xu@gmail.com>, for
the Debian project (and may be used by others).
January 29, 2010