Category Archives: fcitx development
One year in Fcitx 5
Fcitx 5 first release is in 2020/11/2, and as of today, we have reached the 13th release of Fcitx 5. What happened to Fcitx 5 within this whole year of development? 1. Best Wayland support on Linux As of today, … Continue reading
Why surrounding text is the worst feature in the Linux input method world
This is mainly a complain about how mess this feature is and why no one could reliably use it. To give people some background, surrounding text is about the feature that an application can notify the input method what are … Continue reading
How to use a missing keyboard layout in Fcitx 5
When Fcitx read the layout information, it read from xkeyboard-config, mostly like to be /usr/share/X11/xkb/rules/evdev.xml on your system. But unfortunately, there might be missing data in this file and you should report the bug to bugs.freedesktop.org for missing data. But … Continue reading
Fcitx 5 开发（三）如何调试输入法，先有鸡还是先有蛋
调试输入法，和写别的程序其实没有本质的区别，常见的办法也就是 GDB 和输出日志。但它特别的地方主要在于，你用来调试输入的程序也是输入法的客户端之一，在调试输入法的时候，如果不进行一些特别的操作，将会导致你调试用的终端 Freeze（把按键发送给了输入法，却因为程序 GDB 暂停无法获得响应导致 Freeze），也就是标题所说的先有鸡还是先有蛋的问题。 当然，要解决这个问题其实也简单，就是让你的终端不用输入法就行了。这里有几个点需要注意，常见桌面环境的终端一般是单实例，你即使启动一个新的窗口也是同一个进程，并不是重新启动一个进程。所以一般我个人会选择使用另外的终端程序。这是从终端程序禁止输入法方面来说。反过来，也可以通过命令行参数禁用 Fcitx 的前端。来阻止 Fcitx 和对应类型的程序进行通信。 先说说怎么启动一个无法使用输入法的终端。如果是 XIM 的终端，例如 xterm，alacritty，就直接用 XMODIFIERS=@im=none xterm 这样的方式启动，启动之后，在终端里面直接启动新的 fcitx 的话，就需要注意要在终端里面重新恢复 XMODIFIERS 的值为一般的值。因为根据 XMODIFIERS 的处理机制，Fcitx 会根据它启动时的 XMODIFIERS 设置对应的值。如果不进行设置的话，当前的这个终端自然也反而会可以和 Fcitx 通信了。如果是 Gtk 程序，可以设置 GTK_IM_MODULE=gtk-im-context-simple ，如果是 Qt 5程序，可以设置为 QT_IM_MODULE=compose 。 如果想要从 Fcitx … Continue reading
Fcitx 5 开发（二）一个按键事件的后半生
当按键被 Fcitx 的前端接收到之后，首先它需要找到对应的输入上下文，然后创建对应的按键事件结构： https://github.com/fcitx/fcitx5/blob/c492be884540b55ee590d0e3312c4889c8bf4300/src/lib/fcitx/event.h#L242 首先对于一个按键来说，我们先要区分和按键相关的好几个不同的值的含义：Code，State，Symbol。Code 表达的是这个按键对应的物理按键，例如键盘上的 A，不论你在什么情况下按 A（Caps Lock / Shift），产生的 Code 是一样的。State，表示了按键发生时键盘的状态，包括了锁定键的状态，比如 Num Lock 和 Caps Lock，还有各种修饰键（Modifier）的状态是否被按下。当然，对于 32 个 Bit 来说，键盘并没有那么多的按键，因此有一些位在 Fcitx 中也被挪作他用，例如 https://github.com/fcitx/fcitx5/blob/c492be884540b55ee590d0e3312c4889c8bf4300/src/lib/fcitx-utils/keysym.h#L51 这个就是新加入的按键是否是重复键的。 Symbol 则是表达了经过键盘布局转换之后得到的符号，一般来说，输入法的逻辑是直接和 Symbol 打交道的，而不关心从 Code 到 Symbol 之间的转换。Fcitx 的 Symbol 对应的数值是采用和 X11 Symbol 一样的值来简化判断，这样在大部分情况下都不需要重新进行映射。 … Continue reading
