openbsd-ports/inputmethods/fcitx/pkg
op 325dd37784 pkg/README fixes for inputmethods/fcitx, from Yifei Zhan
* typo in fcitx-configtool-qt package name
* add a note about x11/kitty
* point users to the Fcitx' wiki page (suggested by sthen@)
2022-06-21 10:35:49 +00:00
..
DESCR re-add the fcitx5 ports under fcitx-XX pkgpath and pkgnames, the less 2022-05-13 15:37:46 +00:00
PLIST re-add the fcitx5 ports under fcitx-XX pkgpath and pkgnames, the less 2022-05-13 15:37:46 +00:00
README pkg/README fixes for inputmethods/fcitx, from Yifei Zhan 2022-06-21 10:35:49 +00:00

README

+-----------------------------------------------------------------------
| Running ${PKGSTEM} on OpenBSD
+-----------------------------------------------------------------------

The "fcitx" package provides a framework for multilingual typing.
You will also need to install packages providing support for your
chosen languages and graphical environments (e.g. Qt, GTK+).

A basic installation of fcitx would be:

	# pkg_add fcitx fcitx-configtool-qt fcitx-gtk fcitx-qt
	# pkg_add $YOUR_PREFERRED_INPUT_METHOD

then configure fcitx to start with your DE/WM and setup your IM
engine. For Chinese/Japanese/Korean users, remember to install a font
with CJK support. To install noto-cjk:

	# pkg_add noto-cjk

|=============================================================|
| Language/Method    | Language engine package to install     |
|=============================================================|
| M17N               | fcitx-m17n                             |
| Vietnamese Telex   | fcitx-unikey                           |
| Korean             | fcitx-hangul                           |
| Japanese           | fcitx-skk / fcitx-kkc / fcitx-anthy    |
| Symbols (e.g. IPA) | fcitx-table-other                      |
| Other tables [1]   | fcitx-table-other                      |
|=============================================================|

[1]: https://github.com/fcitx/fcitx5-table-other/tree/master/tables

Chinese Method
==============

For PinYin / CangJie / ShuangPin / WuBi / ErBi / ZiRanMa, install
fcitx-chinese-addons.

For ZhengMa / Boshiamy / Quick and other WuBi / CangJie tables,
install fcitx-table-extra.

For ZhuYin, install fcitx-chewing.

Starting fcitx
===============

You need to start fcitx with your desktop environment/window manager
for it to be useful. If your desktop environment supports XDG Autostart,
fcitx should start automatically. Otherwise, add the following lines
to ~/.xsession *BEFORE INVOKING YOUR DE/WM* and then login again:

export XMODIFIERS=@im=fcitx
export GTK_IM_MODULE=fcitx
export QT_IM_MODULE=fcitx
${TRUEPREFIX}/bin/fcitx5 &

To use fcitx with kitty terminal, also add the following line:

export GLFW_IM_MODULE=ibus

Setting up input engines
========================

To setup an input engine, run fcitx5-configtool after starting fcitx5,
then select and add your preferred input method from the Avaliable
Input Method panel. You might need to uncheck 'Only Show Current
Language' to find your preferred input method.

For more information, please refer to Fcitx's wiki page:
https://www.fcitx-im.org/wiki/Setup_Fcitx_5

Troubleshooting
===============

Fcitx includes fcitx5-diagnose, a tool to help you troubleshoot.
If you need to send a bug report, remember to attach a copy of its
output, with sensitive information removed.

Migrating from fcitx4
=====================

Pinyin and table input method engines were previously included in fcitx4.
These are now packaged separately as "fcitx-chinese-addons", install
it to use those methods.