SCIM (智能通用输入法平台) 使用手册

scim 命令的参数有:

例如, 命令scim -l可能会输出如下所示的结果:

Smart Common Input Method 0.99.2
 
 
Available FrontEnd module:
    socket
    x11
 
Available Config module:
    gconf
    simple
    socket
    dummy
 
Available IMEngine module:
    pinyin
    rawcode
    socket
    table
        

显示系统中有两个前端模块可用(socket 和 x11), 四个配置模块可用(gconf, simple, socket 和 dummy), 四个输入法服务模块可用(pinyin, rawcode, socket 和 table).

又例如, 如果想让 SCIM 只调入拼音输入法模块(pinyin, 包含在 scim-chinese 包里面), 并以后台方式运行, 可以用如下命令启动 SCIM:

$ scim -e pinyin -d
        

如果不想调入拼音输入法模块, 可以用如下命令启动 SCIM:

$ scim -ne pinyin -d
        

在终端中使用以下命令启动 scim:

$ export XMODIFIERS="@im=SCIM"
$ scim -d
        

如果不出意外, 在这个终端中运行的应用程序都可以使用 SCIM 了. SCIM 缺省的开关键是 ctrl-space.

如果想在进入图形界面后就直接可以在应用程序中使用 SCIM, 就需要将 SCIM 的启动命令加到图形界面的启动脚本中去.

但不同发行版的启动脚本不尽相同, 以下仅以常见的几种发行版来举例说明:

SCIM 目前提供了以下三个配置模块:

另外, 还有一个虚拟的 dummy 配置模块, 如果使用该配置模块, 则所有的配置参数将会使用 程序缺省的值. 所有更新的参数将不被保存. 该配置模块仅在某些特殊场合使用, 如嵌入式 系统. 以减少内存和磁盘占用.

SCIM 提供了一个简单的命令行配置工具 scim-config-agent, 可以用来修改配置参数. 该命令具有如下命令行参数:

命令执行成功后返回 0, 否则将在标准错误输出打印出错误信息, 并返回 -1.

例如, 要用简单配置模块 (simple) 得到配置项 /FrontEnd/X11/OnTheSpot 的值, 可以用如下命令:

$ scim-config-agent -c simple -t bool -g /FrontEnd/X11/OnTheSpot
        

又如, 要用简单配置模块设置该项的值为 false, 可以用如下命令:

$ scim-config-agent -c simple -t bool -s /FrontEnd/X11/OnTheSpot=false
        

对于布尔 (bool) 型选项, 合法的值为 true 或 false. 对于字符串列表 (string-list) 和整型数列表 (int-list), 列表项之间要用逗号隔开.

使用命令 scim-setup 来启动 SCIM 的图形设置界面. scim-setup 的开始界面如下图所示:

图形 1. scim-setup 的初始界面

在进行设置前, 首先要选择正在使用的配置模块 (上图中的 "当前配置模块"). 除非在启动 SCIM 的时候特别指定了其它配置模块, 一般情况下缺省使用的配置模块即为 simple 模块.

设置窗口的左侧是设置模块的选择栏, 分为"面板", "输入法引擎", "前端" 等多个子类. 其中,

"通用码表" 引擎设置模块用于设置类似于 "五笔字型" 等码表输入法的参数. 所有基于码表的输入法都是通过 "通用码表" 输入法模块来提供服务的, 他们共享基本的配置参数.

"GTK" 面板设置模块用于设置 SCIM 目前缺省包含的基于 gtk+-2.x 图形库的面板程序. 该面板程序为 "X 窗口 (XIM)" 前端模块 (X11 FrontEnd) 和 SCIM 的 GTK+-2.x 本地输入法模块 (gtk2-immodule) 提供界面显示服务. 输入法的大部分图形界面, 包括输入条, 工具条, 帮助窗口, 系统托盘图标等都是由这个程序显示的.

"X 窗口" 前端设置模块用于设置基于 XIM 输入法协议的 X11 前端模块.

以下即为 "GTK" 面板设置模块和 "X 窗口" 前端设置模块的界面.

图形 2. "GTK" 面板设置模块的界面

图形 3. "X 窗口 (XIM)" 前端设置模块的界面

点击"输入法引擎"类的根条目, 会显示如下界面. 通过该界面, 可以禁止或激活特定的输入法引擎.

图形 4. 输入法引擎配置界面

点击每个输入法引擎条目左边的小方框, 就可以禁止或激活该输入法. 修改结果将在按"应用"键, 或"退出"键的时候保存.

在设置过程中如果发现错误, 可以按 "还原" 键重新调入原始配置. 设置完成后按 "应用" 或者 "确定" 键保存设置. 必须重新启动 SCIM, 新设置才能生效. 最简单的办法就是重新启动整个 X 窗口环境.

Socket FrontEnd (套接字前端) 的用途就是通过一个本地或者网络套接字(socket) 对外提供输入法服务. Socket IMEngine (套接字输入法引擎模块) 和 Socket Config (套接字配置模块) 是 Socket FrontEnd 的客户, 它们通过 Socket FrontEnd 建立的套接字来获取输入法或者配置读写等服务.

为了方便理解, 请看下图. 该图显示了一个典型的 SCIM 分布式输入法系统.

图形 5. 分布式输入法系统示意图

如图所示, 第一方框内表示一个正在运行的 SCIM Socket 前端系统. 该系统通过一个 Socket 前端将 IMEngine 1 到 IMEngine N 多个输入法模块提供的服务利用一个 Socket (蓝色圆圈表示) 提供给外部使用者(本机或者远程).

第二方框内表示一个正在运行的 SCIM X11 前端系统. 该系统挂接在一个运行中的 X11 Server 上, 为所有使用 XIM 输入法协议的 X 窗口应用程序提供输入法服务. 其使用的所有输入法模块均为 Socket IMEngine 模块. 这些模块本身不做任何事情, 它们仅仅起到在第一个系统的 Socket 前端 和第二个系统的 X11 前端之间转发数据的作用. 也就是说, 所有来自于 X 窗口应用程序的请求都被转发到第一个系统的 Socket 前端, 再由其后端的 IMEngine 1 到 IMEngine N 等各个真正的输入法模块来处理. 处理完成的数据再经过相同的途径转发回应用程序.

第三个方框内表示一个正在运行的 GTK2 应用程序 (例如 gedit). 该程序使用 SCIM 提供的本地输入法模块 (im-scim) 来实现键盘输入. 和上面 X 窗口系统的类似, 该程序所得到的输入法服务都是由一系列 Socket IMEngine 模块转发自第一个系统的 Socket 前端的.

Socket Config 配置模块的原理和 Socket IMEngine 类似. 它将所有读写配置的请求都转发给运行在本机或者远程机器上的一个 Socket 前端, 再由该 Socket 前端调用一个实际的配置模块 (如 simple 模块) 来完成请求.

图中三个程序(系统) 可以运行在同一台计算机上, 也可以运行在通过网络连接在一起的不同计算机上. 如果需要在网络中使用这种功能, 就要将 Socket 前端 的套接字地址设置为网络地址, 并将客户机上 Socket IMEngine 和 Socket Config 模块使用的套接字指向该网络地址. 下一节中将详细介绍设置方法.

从 scim 0.99.0 开始, 网络模块已经被包括在 SCIM 的主包里面了, 不再需要安装额外的包.

使用如下命令启动上图第一个方框所示的 SCIM 系统:

$ scim -f socket -ne socket -c simple -d
        

该命令启动一个运行 Socket 前端的 SCIM 进程, 使用 Simple 配置模块, 并且不调入 Socket IMEngine 输入法模块.

使用如下命令启动上图第二个方框所示的 SCIM 系统:

$ scim -f x11 -e socket -c socket -d
        

该命令启动一个运行 X11 前端的 SCIM 进程, 使用 Socket 配置模块, 并且仅调入 Socket IMEngine 输入法模块.

以上两个命令均使用缺省的套接字地址来启动 SCIM. 要想以特定的套接字地址启动 SCIM, 可以设置环境变量:

或者直接设置 SCIM_SOCKET_ADDRESS, 该环境变量被所有网络模块所使用.

套接字地址的格式为 前缀:地址 的形式, 其中前缀可以是 inet 或者 local, 分别代表网络地址和本地 UNIX 套接字地址. 对于网络套接字, 地址的格式为 地址:端口, 例如: inet:192.168.1.1:12345. 对于本地地址, 地址是套接字文件的路径名, 例如: local:/tmp/scim-frontend-socket.

例如要启动一个运行 Socket 前端的 SCIM, 并对局域网内的其它机器提供输入法服务, 可以使用如下命令 (假设本机对外地址为 192.168.1.1):

$ SCIM_SOCKET_ADDRESS=inet:192.168.1.1:12345 scim -f socket -ne socket -c simple -d
        

在另外一台计算机上启动一个运行 X11 前端的 SCIM, 并使用上台计算机提供的输入法服务, 可以使用如下命令:

$ SCIM_SOCKET_ADDRESS=inet:192.168.1.1:12345 scim -f x11 -e socket -c socket -d
        

从 scim 0.99.0 开始, 如果直接使用命令 scim 来启动 SCIM, 则 SCIM 会首先尝试启动一个独立的 socket 前端进程来提供输入法服务, 然后再启动实际的 x11 前端进程, 通过前一个 socket 前端进程来向 X11 窗口系统提供输入法服务. 因此原来的两个命令:

$ scim -f socket -ne socket -c simple -d
$ scim -f x11 -e socket -c socket -d
        

就可以直接简化为:

$ scim -d
        

从 0.99.0 开始 gtk2 immodule 已经包含在 SCIM 主包里面, 无须另外安装. 如果您通过源代码安装, 请务必使用以下命令, 将 SCIM 的 gtk2 输入法模块注册到 gtk2 配置文件中:

$ gtk-query-immodules-2.0 > /etc/gtk-2.0/gtk.immodules
        

您必须以 root 身份运行该命令, 而且具体文件的路径在不同操作系统中可能不同.

SCIM 的 GTK2 本地输入法模块缺省仅使用 SCIM 的 Socket IMEngine 输入法模块, 通过一个正在运行的 SCIM Socket 前端取得输入法服务. 因此, 首先必须启动一个运行 Socket 前端的 SCIM:

$ scim -f socket -ns socket -c simple -d
        

然后运行 GTK2 应用程序, 比如 gedit. 在编辑区上点击鼠标右键会弹出一个菜单. 进入"输入法"子菜单, 选择"SCIM Input Method" 即可.

如果希望 GTK2 应用程序缺省就使用 SCIM 提供的本地输入法模块, 可以设置环境变量 GTK_IM_MODULE=scim.

如果需要指定 gtkimmodule 要连接到的 Socket 前端的地址, 可以设置环境变量 SCIM_SOCKET_ADDRESS.

从 scim 0.99.0 开始, gtkimmodule 会自动启动 socket 前端后台进程, 因此上面所说的启动 Socket 前端的命令不是必需的.