include("site.inc");
$template = new Page;
$template->initCommon();
$template->displayHeader();
?>
IIIMF FAQ for Fedora Core Project
Indexes
- General FAQ
- Running IIIMF FAQ
- Troubleshooting IIIMF FAQ
- Bug submission FAQ
General FAQ
Q: Which languages have been enabled for IIIMF?
Currently CJK (Simplified Chinese, Traditional Chinese, Japanese and Korean) and Indic (Hindi, Tamil, Bengali, Gujarati, Punjabi) are being IIIMF enabled in Fedora Core by default.
Q: Which LEs (language engines) are included in Fedora Core?
- iiimf-le-canna - Japanese
- iiimf-le-hangul - Korean
- iiimf-le-xcin - Traditional Chinese
- iiimf-le-chinput - Simplified Chinese
- iiimf-le-unit - Indic, European, Unicode
- iiimf-le-sun-thai - Thai
Q: What locales should have language engines if I have installed all of above?
- iiimf-le-canna - ja_JP.UTF-8
- iiimf-le-hangul - ko_KR.UTF-8
- iiimf-le-xcin - zh_TW.UTF-8
- iiimf-le-chinput - zh_CN.UTF-8
- iiimf-le-unit - bn_IN.UTF-8, gu_IN.UTF-8, pa_IN.UTF-8, ta_IN.UTF-8, hi_IN.UTF-8
Q: What can I use to switch to different language engines?
For example, if you are running your desktop in Japanese environment (ja_JP.UTF-8), by default you should have iiimf-le-canna enabled. If you like to use iiimf-le-xcin in your Japanese environment, you can use GIMLET applet located on your top panel to switch between different installed LE.
Q: What are hotkeys?
Hotkeys are key combinations for requesting actions or functions from IIIMF server. The following list is going to illustrate what IIIMF functions can be activated by using hotkeys.
Function name | Description | Default hotkey |
Input Trigger key |
It can be used to (de)activate the input method. |
ctrl+space (Configurable) |
LE Hot Switch |
It can be used to switch between different Language Engines from a menu. By switching different language engines from hotkeys, you can input multilingual texts quickly. |
ctrl+shift+space (Not configurable at the moment) |
Cycle LE Hot Switch |
It can be used to switch between different Language Engines without selecting from a menu. It tends to be a quicker way for experienced users. The order are same as the order in LE Hot Switch Menu. |
ctrl+< (selecting previous LE), ctrl+> (selecting next LE) |
Running IIIMF FAQ
Q: What's the list of default hotkeys in IIIMF?
For more details, see a section What is hotkeys? in General FAQ.
iiimf-le-unit:
- F6: Switch to different layout within the language
- F5: Switch to different languages within UNIT LE
Q: Can I manually enable IIIMF for other locales or all locales so that I can use [insert your favorite language engine name]?
Yes. To enable IIIMF regardless locale in your current user environment. Please do:
$ mkdir ~/.xinput.d
$ ln -s /etc/X11/xinit/xinput.d/iiimf ~/.xinput.d/default
To enable IIIMF in your current user environment on specific locale (i.e. en_US). Please do:
$ mkdir ~/.xinput.d
$ ln -s /etc/X11/xinit/xinput.d/iiimf ~/.xinput.d/en_US
Then restart X.
Q: I do not have GIMLET (gnome-im-switcher) enabled on my desktop. What should I do?
- Right click on your panel
- Press "add to panel"
- Select "InputMethod Switcher"
- Press "Add"
Q: How can I configure the hotkey?
This is supported from IIIMF version 12.2 or later. Unfortunately there aren't any GUI configuration tool available at the moment. There is an command line utility called iiimf-le-tools to enable users to add, remove or modify hotkey on user-based configuration file for individual preference or system-wide configuration file.
Usage of iiimf-le-tools
- SYNOPSIS
- iiimf-le-tools [options]
- DESCRIPTION
- This program is used to determine the order of loading for specific language when there are two or more language engines by setting a priority for language engine. It is also used to add, remove or modify the hotkey for specific languages.
- OPTIONS
-
- -v
- display more information
- -g
- read/write the configuration for the system-wide.
- --default
- register MODULE as default for LANG. this option has to be used with --install too.
- --lang LANG
- specify LANG for the action. when you use --install or --remove option, the available language will be given from LE, otherwise.
- --add-hotkey KEY
- add KEY as the hotkey for LANG.
- --remove-hotkey KEY
- remove KEY from the registered hotkey for LANG.
- --clear-hotkey
- clean up all of the hotkeys for LANG.
- --install MODULE
- install MODULE to the configuration file for LANG.
- --remove MODULE
- remove MODULE from the configuration file for LANG.
- --list
- shows the available LEs
- MODIFIERS
- Available modifier keys are Shift, Control, Meta, Alt and AltGr.
- EXAMPLES
-
- How can I use shift+space rather than ctrl+space for Japanese and disable ctrl+space?
- iiimf-le-tools --lang ja --remove-hotkey '<Control>space' --add-hotkey '<Shift>space'
- How can I reset the customized hotkey for Korean and revert to the default hotkey settings?
- iiimf-le-tools --lang ko --clear-hotkey
Troubleshooting IIIMF FAQ
Q: OK! It is still not working in GNOME. What can I check?
- Check if you have installed iiimf-server, iiimf-x, iiimf-libs, iiimf-gtk, iiimf-gnome-im-switcher, and one of the language engine above
- Check if you have started IIIM service: i.e. service iiim status. If not please start the service in root: service iiim start
- Check manually if the server is working by running LANG=ja_JP.UTF-8 GTK_IM_MODULE=iiim gedit (if you have installed iiimf-le-canna. Please check the previous question for locale reference to language engine)
- If it is working, that's mean you do not have the environment variable or correct locale. Please check what locale are you in by running locale in command line, or check if you have ~/.xinput.d setup correctly.
Q: OK! It is still not working in KDE. What can I check?
- Check if you have installed iiimf-server, iiimf-x, iiimf-libs, iiimf-gtk, iiimf-gnome-im-switcher, and one of the language engine above
- Check if you have started IIIM service: i.e. service iiim status. If not please start the service in root: service iiim start
- Check if you have started XIM/IIIMF bridge server: i.e. ps auxwww | grep httx. If not please run LANG=ja_JP.UTF-8 httx (if you have installed iiimf-le-canna. Please check the previous question for locale reference to language engine)
- Run another terminal emulator, and check manually if the server is working by running LANG=ja_JP.UTF-8 XMODIFIERS=@im=htt kedit (if you have installed iiimf-le-canna. Please check the previous question for locale reference to language engine)
- If it is working, that's mean you do not have the environment variable or correct locale. Please check what locale are you in by running locale in command line, or check if you have ~/.xinput.d setup correctly.
Q: I cannot see my any languages in "Add or Remove" dialog in GIMLET applet. What should I do?
GIMLET applet can only fetch the language list when you have already ran a application. For example, please run gedit and then try again.
Q: I have changed the hotkey but it doesn't work at all.
If you changed the hotkey as a per-user configuration (i.g. without -g option), it maybe caused by your SELinux being set to enforcing mode, due to the fact of lacking SELinux policy. The only way to get this working is to change the SELinux mode to Permissive with setenforce command. Another option is to configure the hotkey through -g option as system-wide configuration.
Q: I have changed the hotkey but it doesn't work on applications such as KDE.
Unfortunately iiimx (the XIM-IIIMF bridge utility) does not support the hotkey protocol at the moment. You need to change the X resource for iiimx separately. For instance, if you prefer Shift+space instead of Ctrl+space, you need to have the following content in ~/.Xresources or run xrdb -merge:
*conversionOnKeys: space
Bug submission FAQ
Q: Which component should I post against?
- iiimf-le-xcin please post against iiimf-le-xcin component.
- iiimf-le-chinput please post against iiimf-le-chinput component.
- For all other iiimf-* packages, please post against iiimf component.
$template->displayFooter('$Date: 2005/05/25 05:57:33 $');
?>