Setup

 IN PROGRESS

A simple method to set up SCIM in each release of Ubuntu is detailed at community/SCIM

NOTE : This documentation is aimed at helping users under various locales input CJK(Chinese, Japanese and Korean) with SCIM. And, user experiences here are based on Ubuntu 6.06 - Dapper Drake - version.

Dependent Packages

Language

Default Input Method(s)

Simplified Chinese (zh_CN)

scim-pinyin

Traditional Chinese: Taiwan (zh_TW)

scim-chewing

Traditional Chinese: Hong Kong (zh_HK)

scim-tables-zh

Japanese (ja_JP)

scim-anthy

Korean (ko_KR)

scim-hangul

  • scim/skim is default Input Method for Ubuntu/Kubuntu CJK users.
    • scim and scim-gtk2-immodule are installed by ubuntu-desktop.
    • skim and scim-qtimm are installed by kubuntu-desktop.
    • Defaulted IM engine module(s)(ie, scim-chewing, scim-pinyin, scim-anthy, or scim-hangul) is installed by language-support-??(ie, language-support-zh, language-support-ja, or language-support-ko) for CJK languages.
    • im-switch is installed by language-support-??.
  • Additional installation of scim-related packages (This section is based on Dapper Beta version.)
    • For Chinese input :
    • For Japanese input :
    • For Korean input :
      1. scim-tables-ko is not required to install.
      2. scim-qtimm may need to be installed if users want to input Korean with QT/KDE applications under ubuntu-desktop.
      3. Same way, scim-gtk2-immodule (plus scim) may need to be installed for GTK/Gnome applications under kubuntu-desktop.

SCIM Setup

  • The followings are for GTK/QT_IM_MODULE with scim ((ie, GTK_IM_MODULE=scim), if you prefer to set GT/QT_IM_MODULE with xim, please refer XIM mode below.
  • Dapper's method : This is automatically set for CJK languages if you choose one of them at installation.
    • scim in Dapper is supported by im-switch. /etc/X11/xinit/xinput.d/scim file looks like

         # im-switch configuration file for scim
         # should be installed as /etc/X11/xinit/xinput.d/scim
         # this configuration uses GTK IM module and Qt IM module provided by SCIM
      
         # exported enviroment variables
         XMODIFIERS="@im=SCIM"
         GTK_IM_MODULE="scim"
         QT_IM_MODULE="scim"
         # command and arguments to invoke scim
         XIM_PROGRAM="/usr/bin/scim"
         XIM_ARGS="--daemon"
         # package dependency (note that the format used here is not environment
         # variable, but some format for libapt-pkg-perl and is parsed by grep,
         # so can't be quoted, and no spaces allowed)
         DEPENDS=scim-gtk2-immodule,scim-qtimm 
      , and this setup is called by /etc/X11/Xsession.d/90im-switch .
  • scim-im.org's method : create 75scim file under /etc/X11/Xsession.d/ with following lines (if you have 90im-switch, better to remove it for this setup)

       export XMODIFIERS="@im=SCIM"
       export XIM_PROGRAM="/usr/bin/scim -d"
       export GTK_IM_MODULE=scim
       export QT_IM_MODULE=scim 
  • User own setup (User-B and User-C in below need one of these.)
    • With im-switch installed, type im-switch command in the usage of "im-switch [-z <YOUR_LANG>] -s <INPUT_METHOD>" at the terminal prompt (do not with root) so it looks like, for example, :

         im-switch -z en_US -s scim-hangul 
      which creates ~/.xinput.d/en_US link to /etc/X11/xinit/xinput.d/scim .
    • Without im-switch installed (do one of these upon your situation or preference)

      1. System-wide : same as scim-im.org's method
      2. Of course, you can create a link to /etc/X11/xinit/xinput.d/scim by hand (do not with root) like this

              ln -s /etc/X11/xinit/xinput.d/scim ~/.xinput.d/default 

        or (use your LANG instead)

              ln -s /etc/X11/xinit/xinput.d/scim ~/.xinput.d/en_US 
      3. For gnome desktop, create (or add) the following lines to ~/.gnomerc file

             export XMODIFIERS="@im=SCIM"
             export XIM_PROGRAM="/usr/bin/scim -d"
             export GTK_IM_MODULE=scim
             export QT_IM_MODULE=scim 
      4. For kde desktop
      5. If you want to use skim under Gnome desktop, your ~/.scim/global file should have "/DefaultConfigModule = kconfig" and "/DefaultPanelProgram = /usr/bin/scim-panel-kde" so it looks like:

             /DefaultConfigModule = kconfig
             /DefaultKeyboardLayout = US_Default
             /DefaultPanelProgram = /usr/bin/scim-panel-kde
             /SupportedUnicodeLocales = en_US.UTF-8 
  • After your setup, restart at least your X session. (ctrl-alt-backspace!)

Users

  • User-A : Users use one of CJK locales (zh_CN.UTF-8, zh_TW.UTF-8, ja_JP.UTF-8, ko_KR.UTF-8, zh_HK.UTF-8)
  • User-B : Users use en_US.UTF-8
  • User-C : Users use one of other locales than en_US.UTF-8 and CJK locales

Setup Shortcut

Desktop

User

Setup

Ubuntu

User-A

scim should work out of the box.

User-B

Do one of User own setup above, use of im-switch is recommended.

User-C

Follow User-B's case and check supported locale in ~/.scim/global file in addition.

Kubuntu

User-A

skim should work out of the box.

User-B

Do one of User own setup above, use of im-switch is recommended. And, for skim, check /DefaultConfigModule and /DefaultPanelProgram in ~/.scim/global file in addition.

User-C

Follow User-B's case and check supported locale in ~/.scim/global file in addition.

Input Details

  • Trigger keys : Control+space, Shift+space, Zenkaku_Hankaku(on Japanese keyboard), Hangul(on Korean keyboard)
  • (maybe scim/skim's tray icons here)

  • (maybe scim/skim configuration UI screenshot here)

  • Chinese
  • Japanese
  • Korean
    • For Korean input, there are several different types of keyboard layout (virtual for Input Method) called "beolsik". If you are learning Korean this Ubuntu forum thread may help your understanding of them. how to write Korean?

XIM mode

  • /etc/X11/xinit/xinput.d/scim_xim file has these contents.

     # im-switch configuration file for scim
     # should be installed as /etc/X11/xinit/xinput.d/scim_xim
     # this configuration uses XIM
    
     # exported enviroment variables
     XMODIFIERS="@im=SCIM"
     GTK_IM_MODULE="xim"
     QT_IM_MODULE="xim"
     # command and arguments to invoke scim
     XIM_PROGRAM="/usr/bin/scim"
     XIM_ARGS="--daemon"
     # package dependency (note that the format used here is not environment
     # variable, but some format for libapt-pkg-perl and is parsed by grep,
     # so can't be quoted, and no spaces allowed)
     DEPENDS= 
  • As compared to scim file, GTK_IM_MODULE and QT_IM_MODULE are set to xim, and no DEPENDS which means scim-gtk2-immodule and scim-qtimm not required to install.
  • Ubuntu Dapper sets both IM_MODULE with scim as default so scim/skim with xim is user own setup.
  • To set scim/skim with xim, choose one of ways in SCIM Setup. Be careful with replacing scim with xim and linking to scim_xim instead of scim file.

Troubleshooting

  • Most importantly, upgrade scim/skim and IM engine module you need to up-to-date Dapper's version.
  • To check scim/skim related packages installed,

     dpkg -l scim* | grep ii 

    and

     dpkg -l skim 
  • To check scim/skim running,

     ps -A | grep scim 

    for ubuntu-desktop and

     ps -A | grep skim 
    for kubuntu-desktop
  • To check scim/skim related env vars,

     env | grep IM_MODULE --> QT_IM_MODULE=scim, GTK_IM_MODULE=scim

    and

     env | grep XIM --> XIM_PROGRAM=/usr/bin/scim -d

    and

     env | grep XMOD  --> XMODIFIERS=@im=SCIM
  • To check supported locale for scim,

     cat ~/.scim/global 
    ,

    then take a look at /SupportedUnicodeLocales, if your locale isn't there add it to the line with comma like as

     /SupportedUnicodeLocales = en_US.UTF-8,en_UK.UTF-8 

Comments

* I had some troubles after the upgrade, so I had to remove some packages and reinstall them for Kubuntu to work. Here is the list of packages to install:

  • aptitude install language-pack-ja language-pack-kde-ja kde-i18n-ja scim-anthy scim-tables-ja skim im-switch scim-qtimm skim scim-anthy
  • # and including the dependencies it will install the following:

    im-switch kde-i18n-ja language-pack-ja language-pack-ja-base language-pack-kde-ja language-pack-kde-ja-base language-support-ja mozilla-firefox-locale-ja-jp scim scim-anthy scim-gtk2-immodule scim-modules-table scim-qtimm scim-tables-ja skim thunderbird-locale-ja

InputMethods/SCIM/Setup (last edited 2009-10-29 23:40:42 by 160)