aboutsummaryrefslogtreecommitdiff
path: root/docs/getting-started/input-method.md
blob: a94ca975625ab8d82e5dd769156da7dbf7ac8cd3 (plain)
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
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
# 输入法

## 输入法框架

Linux下的输入法框架主要有以下两种选择:

 - Fcitx (包名`fcitx5`): 轻量,启动快,建议KDE、Sway、Hyprland等用户使用  
 - IBus (包名`ibus`): 自定义功能有限,但与GNOME深度集成,建议GNOME用户使用

您可以通过您的包管理器安装这两种输入法框架之一。

!!! warning "已知问题"
    由于Wayland显示协议的原因,部分输入法在Electron应用中可能会出现无法输入的状况。我们建议您目前先继续该教程。但是若出现该问题,您可以尝试以下解决方案:
    
    - 方案一:在终端中编辑`/etc/environment`(可输入`sudo nano /etc/environment`),添加如下行:

    ```
    # 如果是IBus输入法请将fcitx替换为ibus
    GTK_IM_MODULE=fcitx
    QT_IM_MODULE=fcitx
    XMODIFIERS=@im=fcitx
    SDL_IM_MODULE=fcitx
    ```

    - 方案二:编辑`~/.config/electron-flags.conf`(可在终端中输入`nano ~/.config/electron-flags.conf`),添加如下行:

    ```
    --enable-features=WaylandWindowDecorations
    --ozone-platform-hint=auto
    --enable-wayland-ime
    ```

    或者,您可以参考这篇[知乎教程](https://zhuanlan.zhihu.com/p/690062589)。

### Fcitx

安装后,请打开Fcitx5配置,点击右侧加号、箭头来添加Rime或调整输入法顺序。若没有出现,请您重启系统。

若您是KDE用户,请打开KDE设置,打开系统设置-键盘-虚拟键盘,并选中“Fcitx5”。并在语言和时间-输入法选择“中州韵”。

若您是GNOME用户,您需要额外安装`gnome-tweaks`,在“优化-开机启动程序”中添加“Fcitx5”,或者安装`fcitx5-autostart`来使Fcitx5自启动。我们同时建议您安装这个[GNOME扩展](https://extensions.gnome.org/extension/261/kimpanel/)。

若您是其他桌面环境用户,您也可以通过设置XDG自动启动或编辑配置文件的方式来使得Fcitx5开机自启。

- Hyprland: `exec-once = fcitx5 --replace -d`
- Niri: 在配置文件中添加`spawn-at-startup "fcitx5" "-d"`


### IBus

IBus会自动与GNOME集成,所以GNOME用户无须进行额外操作。

若您是KDE用户,请打开KDE设置,搜索虚拟键盘,并选中“IBus”。

## 设置默认框架

在Debian系发行版中,安装输入法后可能需要安装并用终端运行`im-config`来选择默认输入法框架。在Fedora中,您可能需要使用`imsettings`来设置。

## 中文输入法框架

对于中文输入法框架,由于IBus默认的拼音输入差强人意,并且其他输入框架也大多字库不全或过时。因此,我们推荐您使用中州韵 (Rime),其能够安装多种词库,并且有强大的输入引擎。

### 安装Rime

若您使用Fcitx,您需要安装:

```bash
fcitx5-chinese-addons fcitx5-rime
```

若您使用IBus,您需要安装:

```bash
ibus-rime
```

安装ibus-rime后,若您是GNOME桌面用户,请打开GNOME设置-键盘-输入源,添加`中文(Rime)`。若没有看到,请重启系统。

!!! warning "已知问题"
    `ibus-rime`在GNOME上经常出现输入法卡住无法调出或无法退出英文模式的状况。若出现,请打开状态栏中输入法的下拉菜单,并重新点击`中文(Rime)`。

### 安装Rime配方

在Rime中,不同的输入方案被称为配方。Rime的配方十分丰富,并且还支持粤语等方言输入配方。

对于简体中文的输入,我们推荐您使用[雾凇拼音](https://github.com/iDvel/rime-ice)。

您可以手动添加Rime配方,也可以通过其提供的Plum工具来添加。在安装配方后,请通过状态栏或在输入框中按“Ctrl+`”或F4来切换输入方案。

对于Arch用户来说,您只需要安装`rime-ice-git`包(AUR/ArchLinuxCN)即可。

#### 使用Plum

以下我们会示范使用Plum安装雾凇拼音。

!!! warning "网络问题"
    Plum会从Github拉取对应配方仓库,所以该方法对网络环境有要求。

以下脚本来自雾凇拼音README.md。

```bash
# 需要安装 git 及 bash
# Windows 下 bash 命令被系统 WSL 占用,进入 git bash 环境再执行以下命令

# 1. 安装 plum
cd ~
git clone https://github.com/rime/plum.git plum

# 2. 安装雾凇拼音到默认客户端(Weasel,Squirrel,iBus-rime),更新词库只要执行这一步,3、4 步不需要。
# 如使用其他客户端请手动指定 rime_dir 变量为对应的用户目录。
# e.g. rime_dir="$HOME/.config/fcitx5/rime" bash rime-install iDvel/rime-ice
cd ~/plum
bash rime-install iDvel/rime-ice

# 3. 双拼用户额外执行,全拼用户跳过。替换「double_pinyin_flypy」为你使用的方案
bash rime-install iDvel/rime-ice:others/recipes/config:schema=double_pinyin_flypy

# 4. 如需万象语法模型,额外执行。替换「rime_ice」为你使用的方案
bash rime-install iDvel/rime-ice:others/recipes/grammar:schema=rime_ice

# 5. 重新部署

# 方案名称
# rime_ice(雾凇拼音、全拼)
# double_pinyin(自然码双拼)
# double_pinyin_flypy(小鹤双拼)
# double_pinyin_mspy(微软双拼)
# double_pinyin_sogou(搜狗双拼)
# double_pinyin_abc(智能 ABC 双拼)
# double_pinyin_jiajia(拼音加加双拼)
# double_pinyin_ziguang(紫光双拼)
```

#### 手动安装

手动安装适合无法访问Github的用户。

首先,您需要通过[加速链接](https://mirror.nju.edu.cn/github-release/iDvel/rime-ice/LatestRelease/full.zip)或[官方链接](https://github.com/iDvel/rime-ice/releases/latest/download/full.zip)下载雾凇拼音的最新构建。

之后,请您进入您的用户目录(IBus位于`~/.config/ibus/rime`,Fcitx5位于`~/.local/share/fcitx5/rime`),删除目录中所有内容,并将压缩包中的文件复制进去。

之后,您需要重新部署Rime(位于状态栏中),或者更简单,注销系统再重新登录。

???+ note "如何进行关闭注音、更改候选词数等设置?"
    Rime不提供GUI界面修改配置,因而所有配置均需要在配置文件中进行更改。

    对于候选词数,请找到用户目录下`default.yaml`中如下配置进行更改:

    ```yaml
    # 菜单
    menu:
    page_size: 5  # 候选词个数
    ```
    雾凇拼音的默认设置下,所有候选词都会被全拼注音。如果你的用户目录里有`rime_ice.schema.yaml`这个文件,打开,将`spelling_hints`和`always_show_comments`两行注释,像下面这样。

    ```yaml
    # 主翻译器,拼音
    translator:
    dictionary: rime_ice           # 挂载词库 rime_ice.dict.yaml
    #  spelling_hints: 8              # corrector.lua :为了让错音错字提示的 Lua 同时适配全拼双拼,将拼音显示在 comment 中
    #  always_show_comments: true     # corrector.lua :Rime 默认在 preedit 等于 comment 时取消显示 comment,这里强制一直显示,供 corrector.lua 做判断用。
    initial_quality: 1.2           # 拼音的权重应该比英文大
    ```

    (来自[每一个选项都被全拼注音,如何关闭?](https://github.com/orgs/rime/discussions/1366))


    每次修改完配置文件,请重新部署Rime(位于状态栏中),或者更简单,注销系统再重新登录。

    更多配置项,您可以参考[Dvel的这篇博客](https://dvel.me/posts/rime-ice/)。