README.md

IBus-Unikey IME

A future clone of ibus-unikey aims to fix for the present.

ibus-unikey is an IBus IME. It uses a modified version of Unikey-engine for progressing key event.

Installing

Ubuntu / Debian

sudo apt-get install ibus-unikey

After the installation completes, follow those instructions to activate ibus-unikey.

Compiling on GNU/Linux

Dependencies

ibus-unikey currently needs following libraries and binaries:

• GNU gcc, g++ compiler or Clang
• GNU autotools with autoconf >= 2.69, autopoint >= 0.19.7, libtool >= 2.4
• IBus development library >= 1.5.4
• Gtk development library with libgtk2.0-dev >= 2.24.0

On Ubuntu 16.04 you can easily install them like this:

sudo apt-get update
sudo apt-get install build-essential autoconf autopoint autotools-dev
sudo apt-get install libibus-1.0-dev libgtk2.0-dev libgtk-3-dev

After installing required libraries and binaries, you are ready to build and install this software from source.

Build and install

From a release tarball

Download a tarball and extract it, change current directory to extracted directory and use:

mkdir build && cd build
./configure --prefix=/usr --libexec=/usr/lib/ibus
make -j4
sudo make install

Latest version from GitHub

Clone this repository and change the directory to the cloned folder and issue the commands:

mkdir build && cd build
../autogen.sh --prefix=/usr --libexec=/usr/lib/ibus
make -j4          # to build with 4 threads
sudo make install # to install

Debian package build for maintainer

Note: Only for upstream version from GitHub

mkdir build && cd build
../autogen.sh --prefix=/usr --libexec=/usr/lib/ibus
make dist

Change the name of release tarball from ibus-unikey-VERSION.tar.gz to ibus-unikey_VERSION.orig.tar.gz, issue these commands:

tar xf ibus-unikey_VERSION.orig.tar.gz
cd ibus-unikey
cp -a ../../debian .
debuild -us -uc # build both source and binary package

To build only the binary package without signing the .changes file (or the non-existent .dsc file):

debuild -i -us -uc -b

Change the -b to -S to build only a source package.

Read more about debuild

Acknowledgements

• Copyright

Files: ukengine/*
Copyright: 2000-2005 Pham Kim Long <unikey@gmail.com>
License: GPL-3.0+

2009 - 2012 Lê Quốc Tuấn <mr.lequoctuan AT gmail DOT com>
       2016 Bong Nguyen <vanbong AT gmail DOT com>
       2018 Lzu Tao <1stpangu AT gmail DOT com>

License

Licensed under GNU GPLv3.

TODO

Read more in TODO at GitHub's Projects.

Useful links

• An awesome overview of @huytd
• Overview of Imput Method for CJK (and Vietnamese)
• BongNV ibus project
• BongNV own introduction
• And few alternative engines with unikey-based:
  • https://devhub.io/repos/wilonth-BoGoEngine
  • https://devhub.io/repos/haqduong-ibus-bogo
• Some intial step with vala
• An hard to find custom ibus input-method-engine guide