====== Presentation ======

x-unikey is the Linux version of unikey. You can find it on http://unikey.sourceforge.net/linux.php

Alternative method to get vietnamese keyboard ScimTelex

====== Installation ======

===== Common to all systems =====

You will need to use a UTF-8 encoded locale. You may choose ''vi_VN.UTF-8'', ''en_US.UTF-8'' or even ''fr_FR.UTF-8'' in my (patched) Debian package. Beware that any other locale setting **will not work**! The most important is to have a ''.UTF-8'' part at the end of your locale (eg: ''LANG=vi_VN.UTF-8'').

From version 0.9.2, many other .UTF-8 locales work with x-unikey too. The default settings for XimLocales in ''.unikeyrc'' is set to contain, among others, DE, RU, BE,.. If your locale is not there, just add it to XimLocales.

===== Ubuntu =====
(by [[users:progfou]])

First install the [[:soft:apt:hanoilug|HanoiLUG APT repository]]. Then run this command and that's it! :-)
  sudo apt-get install x-unikey

You now have x-unikey 1.0.4 automaticaly started with any Xwindow session. It means you should restart your current session to get it working right now.

===== Debian =====
(by [[users:progfou]])

First reconfigure your locales to ensure you will use an ''UTF-8'' encoding:
  dpkg-reconfigure locales

If you changed your default system language for ''vi_VN'', you will need to replace ''LANG=vi_VN'' by ''LANG=vi_VN.UTF-8'' in ''/etc/environment'', then restart your system (for simplicity). This is because ''vi_VN'' is using ''UTF-8'' encoding by default, though it doesn't need to be specified explicitly. But some softwares (like ''gnome-terminal'') seem to need this ''.UTF-8'' part at the end of the locale to detect and switch to Unicode mode.

Then add this line to your ''/etc/apt/sources.list'':
  deb http://tech.vn.refer.org/debian sarge vietnam
Then run these commands and that's it! :-)
  apt-get update && apt-get install x-unikey

At this time, this will give you x-unikey version 0.92, not automaticaly started with an Xwindow session.
If you want it to be started for every Xwindow session of every user, just add this line to the end of your ''/etc/X11/Xsession.d/59unikey'':
  unikey