小小输入法入门指南

◆版权声明

软件作者 dgod <[email protected]>
对本软件的重新发布必须包含本声明
论坛 http://yong.dgod.net/
软件希望能对用户有用，但软件及作者不对用户的使用任何后果不负任何责任
帮助文件yong.chm 制作者是网友春意盎然，在此感谢
永码，拼音码表 作者就是本人
五笔 名称：五笔86极爽词库6.0标准版
作者：窝子([email protected])
码表输入法的其他码表 来自网络

◆小小的安装

系统需求
windows xp及以上版本。
linux gtk-2.12 及以上。

Windows下
解压yong-win-20090101.7z

注： 用户文件在安装目录下的.yong目录里面，特别的，如果安装在%ProgramFiles%目录下（.yong目录将无效 ），用户文件在%appdata%/yong目录下。

小知识：%appdata%是系统变量 ，表示 C:\Documents and Settings\当前用户名\Application Data

Linux下

注：在linux下，用户文件位置在~/.yong目录下。

如果是redhat系列的，则建议下载rpm包
安装使用命令
rpm -ivh --nodeps yong-2.3.0-1.noarch.rpm
由于一个rpm包中包含了32位和64位所有的程序，所以很大可能你系统的依赖会不满足，需要用--nodeps参数忽略依赖，但一般不会影响你安装后的正常使用。

如果是其他的版本，下载7z包

先把7z包解压到你要的安装目录（7z解压工具在Linux下是p7zip）
然后根据你所使用的发行版配置环境变量，主要有
XMODIFIERS="@im=yong"
GTK_IM_MODULE=xim
QT_IM_MODULE=xim
把输入法设为自启动，启动命令是
yong -d

另外，安装目录下有个yong-tool.sh的工具，使用该工具可以简单的进行设置
现在支持的有
redhat，fedora，centos，debian，ubuntu，suse
使用方法
安装：
进安装目录，执行命令
sudo ./yong-tool.sh --install
如果需要安装64位程序
sudo ./yong-tool.sh --install64
卸载：
sudo ./yong-tool.sh --uninstall
选择作为默认输入法
./yong-tool.sh --select

运气好的话，注销重新进入系统就能用了

更新输入法：
解压覆盖原有的安装，重新允许yong-tool.sh --install

如果是在ibus框架下使用，那么你需要先安装ibus然后再安装yong，之后按ibus的方法调出yong即可。
　

更新输入法：
解压覆盖原有的安装，重新允许yong-tool.sh --install

mandriva linux下输入法的使用（来自linuxsir的神游九州，本论坛的gods）。

su root
urpmi yong-1.1.0-21.pre5.i386.rpm
kwrite /etc/sysconfig/i18n

把其它输入法的名字改为yong就行了。

BWT：如果是用scim，最好先用draklocale把默认输入法改为fcitx，然後删了scim就不容易出问题。

关于gtk3的说明：
gtk3使用了xi2作为输入，而目前xi2，gtk3，xim并没有做出整合，这时候会导致小小输入法工作不正常，两个解决方法
1 在系统环境变量中加入GDK_CORE_DEVICE_EVENTS=1
2 使用ibus作为输入法框架，然后在上面使用小小输入法
3 等待以后版本gtk3

请大家报linux上安装和使用的bug的时候，至少提供一下信息
./yong-tool --sysinfo
输入法菜单->工具->系统信息

gtk im module

仅限有经验的用户尝试
使用时记得加上环境变量GTK_IM_MODULE=yong

小小输入法和vim配合使用（linux）

仅适用于linux图形界面的终端中使用，不适用于windows，fbterm。

vimrc中加入以下内容，其中yong-vim替换为你安装之后的命令所在位置

let g:input_toggle = 0

function! Yong2en()
let g:input_toggle = system("yong-vim 1 -w")
endfunction

function! Yong2zh()
if g:input_toggle != 0
let g:input_toggle = system("yong-vim 0")
let g:input_toggle = 0
endif
endfunction

autocmd InsertLeave * call Yong2en()
autocmd InsertEnter * call Yong2zh()

◆小小内置输入法的安装

内置主要用于解决QQ中的光标跟随和有些程序中外挂无法上屏的问题。

windows版本使用内置输入法的方法：

⒈ 如果是安装版本，安装的时候选择内置输入法，就已经为你设置好了。
⒉ 如果是解压的7z绿色版本，请遵循如下步骤：
① 进入tsf目录，运行install.bat或者install64.bat（根据你的操作系统），如果是vista或win7，安装的时候可能要关闭UAC功能或者右键以管理员身份运行也可以，使用的时候可以不关
② 注销或者重启系统
③ 修改配置，把打开/关闭输入法的快捷键从CTRL_SPACE设置成其他的键，或者直接NONE禁用
④ 使用的时候，需要启动yong.exe，这是和其他普通的内置输入法不一样的地方，其他的已经一致了

◆TSF模块注册帮助

以下说明仅对想重定义注册信息的人有用，否则使用输入法提供的安装文件即可。

⒈文件说明：
tsf-reg.exe 是32位注册程序，yong.dll是32位内置模块
tsf-reg64.exe是64位注册程序，yong.dll是64位内置模块

对64位系统来说，需要同时注册32位和64位模块。

⒉参数说明
-n 你的输入法名字
-i 执行安装
-u 执行卸载
-c 复制文件到system32目录下
-d 删除system32目录下的输入法
-l 指定安装输入法的语言
-ll 允许安装的输入法语言列表

⒊已知问题
使用了-c参数，会引发Win8的一个bug，64位系统中执行32位METRO程序时无法正确加载32位tsf模块

◆裁减

对一个用户来说，他可能用不到输入法自带的那么多功能，这时候就可以裁减，下面说明一下各个文件的用途。

README.txt 自述文件，自用可删除，如果要重新发布，必须保留。

yong.exe 主程序。

yong-config.exe  设置程序，可以删除。
libl.dll 基础库。
libgbk.so 内码输入法（不用内码的可删）。
libmb.so 码表输入法。

libcloud.so 云输入法（不用云输入法的可删）。

            可选：搜狗：arg=sogou QQ：arg=qq 百度：arg=baidu 谷歌：arg=google

yong.ini 配置文件。
keyboard.ini 软键盘配置文件（不用软键盘的可删)。

skin 皮肤目录（可以把里面的子文件夹删掉，只保留默认皮肤）。
mb 码表目录（可以把里面你不用的输入法删掉）。
imm 基于ime的内置输入法(只用外挂的可删)。

entry 可通过设置界面安装的输入法列表（可删除）。

bihua.bin 笔画数据（不用自带的笔画输入法的可删除）。
class.txt 里面说明了哪些程序里面用剪贴板输出，可删除。
normal.txt 里面的字设定为常用字，可删除，如果不存在，常用字取gb2312里的汉字。

yong.nsi  安装文件制作，安装nsis之后可用，可删除。

w64 小小输入法的64位版本，不用的可删除（不需要这个，也能在64位系统上正常使用）

.yong 输入法自动生成的目录，用于保存经过用户的设置，码表，皮肤文件的目录。

◆添加输入法

以五笔为例：
首先在配置文件yong.ini中添加一段：
[wbx]
#选择码表输入法作为输入法引擎。
engine=libmb.so
#把码表的路径作为参数。
arg=mb/wbx.txt
#设置一些有别于主配置文件中的设置。
overlay=mb/wbx.ini
然后在[IM]段把五笔加到输入法列表中。
#把五笔设置为第二个输入法
[IM]->1=wbx
在配置文件中[IM]段，各个输入法是按0，1，2，3，4，5……的顺序下来的，中间不能有空的数字，default是每次启动时候的默认输入法 。

◆小小云输入法详细说明

1 添加云
配置文件中添加云输入方案
[IM]->?=cloud
?是你使用的序号，和其他的输入法一样，名字这里取成cloud（可以自定义）
[cloud]
name=云 /////可以取自己喜欢的名字
engine=libcloud.so /////云功能
arg=sogou /////使用sogou云，如果想用qq，那么你设置上qq（arg=qq），可选sogou,qq,baidu
2 使用双拼
[cloud]->sp=zrm /////设置自然码双拼，如果是其他方案，那么请自定义双拼
双拼的自定义：
建立xxxx.sp文件，内容如下，这里xxxx是指你的双拼方案，用英文字母，在相关配置文件的设置中使用
内容为每行一个全拼和双拼的对应，如果双拼和自然码一致的，可以不设置

文件采用gb18030编码，考虑到这个文件中不太可能出现非常用汉字，那么用gb2312或者gbk编码都没有问题
文件建议放在.yong或者yong（这里指安装目录）下

微软双拼
ding d;
bing b;
ding d;
jing j;
ling l;
ming m;
ning n;
ping p;
qing q;
ting t;
xing x;
ying y;
a oa
ai ol
an oj
ang oh
ao ok
e oe
en of
er or
nv ny
ou ob

3 本地码表的使用
[cloud]->pinyin=mb/pinyin.txt /////使用这个本地码表，注意，只有单字有效

4 其他功能的设置
[cloud]->assist=mb/yong.txt 2 /////设置永码为间接辅助码，这里和拼音的间接辅助码的设置是一样的
其他如笔画输入，临时英文输入等功能和其他基于码表的输入法是一致的

5 针对QQ云的增强
qq云本身提供了一些sogou云不支持的功能，这里暂时不公开。

6 代理设置
现在只支持不需要用户名密码的http代理，设置如下
[cloud]->proxy=http://120.136.16.13:8081

7 自定义短语
[cloud]->user=mb/zrm.txt
只能在26键范围内，不能超过7码，格式是永码的码表格式，只支持gb18030

通过设置程序添加输入法，支持zip格式

码表输入法作者可以在小小输入法的entry目录里建立要添加输入法方案，一般包含有：配置文件和码表文件等,然后用设置程序就可以方便地添加和删除输入法了。

以添加五笔输入法方案为例

首先建立wubi.ini文件，内容如下：

[wubi]
name=五笔
engine=libmb.so
arg=mb/wbx.txt
overlay=mb/wbx.ini

◆小小输入法zip封装说明

这里讨论的只是在一个zip中封装一个输入法，比如五笔的所有相关内容。

仅支持非压缩，非64位，非加密版本。
文件名不要使用汉字。
支持纯文本文件，但最后一行必须是空行。
图片格式仅支持png图片。
zip中不应该存在子目录，所有文件都应该放在根目录下。
存在一个entry.ini（格式为：UTF-8）文件，这个文件中的内容就是yong.ini中针对单个输入法的那一段配置，如：
[wbx]
engine=libmb.so
arg=wbx.zip/wbx.txt
overlay=wbx.zip/wbx.ini

yong-config --install=wbx.zip这样的命令就可以用来安装这个输入法到yong.ini配置文件中，卸载的时候执行yong-config --uninstall=wbx即可。

允许为每个输入法单独加图标[xxxx]->icon，这个图标如果存放在zip包中则只能为png而不能是ico

◆linux中小小输入法的打包建议

linux中小小输入法的打包建议

本说明仅针对想对小小输入法进行打包的人，其他用户不用关心，正常使用即可。

正常的一个linux下的输入法打包之后会包括好几部分
1 主程序
2 开发库
3 输入法引擎
4 单个输入法

在小小输入法中则只有几部分
1 主程序（输入引擎可以单独打包，不过考虑到个头不大，而且主要只有一个，所以没有必要）
2 码表（及相关配置文件）
3 皮肤

皮肤是可以单独打包的。
现在的做法，是主程序和码表都打包到一块的，这个确实也是小小输入法本身的限制造成的，不过以后也可以换种方式。
如果对码表单独打包，建议的包格式如下，以拼音为例，它包括一个pinyin文件夹，安装到yong主程序所在目录
--pinyin
entry.ini
pinyin.png
pinyin.txt
pypre.bin
sp.ini
pinyin.ini
ms.sp
...
entry.ini内容为配置文件中的那针对输入法的配置内容
[pinyin]
name=拼音
engine=libmb.so
arg=pinyin/pinyin.txt
overlay=pinyin/pinyin.ini

这样用户安装完成比如说yong-pinyin这个包之后，执行命令
yong-config --install=pinyin
就可以在配置文件中添加拼音输入法了
这个功能本应该在设置程序的界面中完成的，现在没做

下面是关于和ibus的集成说明
1 托盘图标
默认的ibus和小小都会生成一个托盘图标，这样显得重复和没必要，可以设置其中一个不显示

2 默认的小小输入法安装之后只在ibus设置中显示一个输入法，其中配置文件会是这个样子的
<?xml version="1.0" encoding="utf-8"?>
<!-- filename: yong.xml -->
<component>
<name>org.freedesktop.IBus.Yong</name>
<description>Yong Component</description>
<exec>/usr/bin/yong --ibus</exec>
<version>1.6.0</version>
<author>dgod</author>
<homepage>http://yong.dgod.net</homepage>
<textdomain>yong</textdomain>
<engines>
<engine>
<name>yong</name>
<language>zh_CN</language>
<author>dgod</author>
<icon>/usr/share/yong/skin/tray1.png</icon>
<layout>us</layout>
<longname>Yong</longname>
<description>Yong Input Method</description>
<locale name="zh_CN">
<longname>Yong</longname>
<description>Yong输入法</description>
</locale>
</engine>
</engines>
</component>

如果想把所有的小小输入法的每个输入法单独列在ibus中，那么可以使用如下这个配置文件
<?xml version="1.0" encoding="utf-8"?>
<!-- filename: yong.xml -->
<component>
<name>org.freedesktop.IBus.Yong</name>
<description>Yong Component</description>
<exec>/usr/bin/yong --ibus --ibus-menu</exec>
<version>1.6.0</version>
<author>dgod</author>
<homepage>http://yong.dgod.net</homepage>
<textdomain>yong</textdomain>
<observed-paths>
<path>~/.yong/yong.ini</path>
</observed-paths>
<engines exec="/usr/bin/yong --ibus-menu --xml"/>
</component>

关于云输入法
现在打包一般是把百度，搜狗等分成几个输入法，现在来说设置程序有所改进，在设置中能选择了，所以现在建议只使用一个云输入法，具体选择那个服务，让用户自己在设置中选择比较好

◆预编辑模式

工作在内置输入法模式下才能起作用
1. 启用配置文件中[IM]->onspot=1才能启用
2. 设置[IM]->preedit
    0 提示第一候选项
    1 提示编码
设置完成之后需要重启输入法。