Uim/Installation

From Wikibooks, the open-content textbooks collection

Uim comes packaged with most *nix distributions, but may also be compiled directly from source.

During installation, you may also want to install some input methods as well. See the Introduction page for a list of currently implemented conversion engines.

Contents 1 From source 1.1 Software requirements 1.1.1 Optional software 1.1.2 Conversion engines 1.2 Retrieve the source code 1.3 Extract and configure 1.4 Post-installation

[edit] From source

For instructions about installing uim using a package management system that comes with most operating system distributions (such as Debian, Ubuntu, Fedora Core, Gentoo and the BSDs), please refer to your package manager documentation for now. There are also some links in the Resources section.

[edit] Software requirements

• iconv
• curses — Needed to build uim-fep.

[edit] Optional software

• GTK+ >= 2.4 — Needed to build GTK+ tools and the GTK+ immodule.
• gnome-panel — Needed to build GNOME applet indicator.
• Qt >= 3.3.2 — Needed to build Qt tools. You also need to apply the immodule-qt patch to build the Qt immodule.
• m17nlib >= 1.3.1 — Needed to use uim-m17nlib bridge.

[edit] Conversion engines

• Anthy — Japanese Anthy module.
• Canna — Japanese Canna module.
• mana — Japanese mana module.
• PRIME — Japanese PRIME module.

[edit] Retrieve the source code

You can download the source code from the source directory. It includes the core library, various conversion engines, GTK+ bridge, Qt bridge, XIM bridge, FEP bridge, Emacs bridge, tools for configuration, and other tools.

[edit] Extract and configure

Begin by extracting the source from tar ball:

 # tar xvjf uim-x.x.x.tar.bz2

Then, move to the extracted directory and run configure.

 # cd uim-x.x.x
 # ./configure

The following configuration options are disabled by default but can be added to the make command.

--enable-debug	Build uim with debug information
--enable-dict	Enable Japanese dictionary tool
--with-canna	Use Canna
--with-qt	Build Qt tools
--with-qt-immodule	Build Qt immodule. If you have Qt 3, you need the the qt-immodule patch.

The full set of configuration options, run

 # ./configure --help

Finally, you make and install the package:

 # make [configuration options]
 # su
 # make install

By default, uim is installed under /usr/local/, but it may not be in the system search path. If not, you need to add the line /usr/local/lib to /etc/ld.conf and then run ldconfig.

[edit] Post-installation

To use the GTK+ immodule, you may need to generate the immodule file. Run:

 # gtk-query-immodules-2.0 > /etc/gtk-2.0/gtk.immodules

or

 $ gtk-query-immodules-2.0 im-uim.so > ~/.immodules