1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
|
Metadata-Version: 2.4
Name: ssfconv
Version: 1.2.2
Summary: Sogou input method skin file (.ssf file) converter
Author: nihui, VOID001, fkxxyz, RadND
License: GPL-3.0-or-later
Project-URL: Repository, https://codeberg.org/radnd/ssfconv.git
Project-URL: Issues, https://codeberg.org/radnd/ssfconv/issues
Keywords: ssf,fcitx,fcitx5,Fcitx5 Classic User interface
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: Natural Language :: Chinese (Simplified)
Classifier: Topic :: Adaptive Technologies
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pycryptodomex
Requires-Dist: pillow
Requires-Dist: numpy
Dynamic: license-file
# 简介
一个将皮肤从搜狗格式转换为 fcitx/fcitx5 格式的脚本，如果您在寻找“原生”的fcitx5皮肤，可以看[这里](https://github.com/topics/fcitx5-theme)
新开了仓库，因为作者的账号很久没有活动过，我所做的改动也很大：
1. 制成 python 包，用户不需要自己装依赖了
2. 重构，减少重复，将原先的脚本拆分为解包和转换两部分
3. 注册命令行程序、调整命令行参数、中文本地化
4. 由于使用了match case语法，python版本要求上升到3.10，如果想用旧版本python运行，请自行把相关代码改回长串 if elif
程序的目的没有变，所以原作者的[参考图像](https://www.fkxxyz.com/d/ssfconv)依然适用
# 安装
## 手动
clone或下载release
```shell
python -m venv venv_name
source venv_name/bin/activate
# source venv_name/bin/activate.fish
pip install .
```
## pip
[ ] 下次一定上传到 pypi
```shell
pip install ssfconv
```
# 使用
本包提供的命令行程序加 `-h` 参数就可以查看帮助
## 获取皮肤
可以从[搜狗的皮肤站](https://pinyin.sogou.com/skins/)或bilibili搜索输入法皮肤获取自己喜欢的皮肤，得到ssf格式的文件，例如 【雨欣】蒲公英的思念.ssf
## 解包 ssf 皮肤
```shell
ssfconv unpack 【雨欣】蒲公英的思念.ssf
```
得到的文件夹可供 `ssfconv` 使用
## 转换为 fcitx4 皮肤
```shell
ssfconv convert -t fcitx 【雨欣】蒲公英的思念
```
复制到用户皮肤目录
```shell
mkdir -p ~/.config/fcitx/skin/
cp -r 【雨欣】蒲公英的思念 ~/.config/fcitx/skin/
```
右键输入法托盘图表，选中皮肤，这款皮肤是不是出现在列表里了呢，尽情享用吧。
## 转换为 fcitx5 主题
```shell
ssfconv convert 【雨欣】蒲公英的思念
```
复制到用户主题目录
```shell
mkdir -p ~/.local/share/fcitx5/themes/
cp -r 【雨欣】蒲公英的思念 ~/.local/share/fcitx5/themes/
```
打开 fcitx5 的配置，附加组件标签，经典用户界面，点配置，在主题的下拉列表里，选择这款皮肤。
或者你也可以直接修改配置文件 ~/.config/fcitx5/conf/classicui.conf，将 Theme 的值改成这个皮肤的名称即可。
查看该皮肤在配置文件中的名称：
```shell
grep Name ~/.local/share/fcitx5/themes/【雨欣】蒲公英的思念/theme.conf
```
# 微调
转换得到的皮肤配置或多或少会有点瑕疵，其实调整它们并不困难，快去试试吧
# 致谢
前两位作者的仓库分别在
- https://github.com/fkxxyz/ssfconv
- https://github.com/VOID001/ssf2fcitx
前两位作者的账号都不活动，也许已经对系统美化不感兴趣了。不管怎样，我把他们写在了 `pyproject.toml` 中，在此对他们表示感谢。( •ᴗ• )
还要感谢 [`那些时光.ssf`](https://pinyin.sogou.com/d/skins/download.php?skin_id=344544) 的作者 szwjerry ，为了用上这个皮肤，我才接触到这个工具。
# 贡献征集
## 方格示意
需要一个调试工具，能依据转换后的皮肤配置文件在图片上划线，用以表明这个皮肤是怎样被拉伸的
考虑到这和转换的过程无关，更像是一个独立的程序
## 更多整理
转换部分的主函数仍然非常长，需要拆分，有部分固定的配置可以抽离出来以模板文件的形式存在
## IBus
```
GNOME桌面和非GNOME桌面的IBus采用了两个不同的前端。非GNOME桌面的IBus是项目自己本身基于GTK写的一个很简陋的前端，其使用GTK主题，根据我之前的研究，要实现搜狗那样的皮肤效果应该不太可能。GNOME在他们的GJS代码库里给IBus重写了一个前端，他们的前端可定制性更强，主要是使用CSS文件指定样式
@HollowMan6
```
仅靠转换程序做不到在 IBus 上实现搜狗这种美观的皮肤效果，看样子最有希望的办法是通过 GNOME Shell 扩展修改输入法前端，先行提供背景图片等素材的显示和拉伸/压缩的能力
readme有点长，其他不重要的内容看 [Wiki 页面](https://github.com/RadND/ssfconv/wiki)
|
