# Tagaini Jisho Install Guide

# Installation

Tagaini Jisho is available on several different platforms, including Windows and Mac OS, as well as being available for several Linux distributions. The correct binaries1 can be downloaded from the downloads page at tagaini.net.

Tagaini Jisho has several dependencies, other applications and libraries that it depends on. Depending on your system, this may or may not be relevant. On Windows, for instance, you need to have Japanese fonts and IME software in order to use Tagaini, whilst the other dependencies are provided in with the windows binaries.

These dependencies are:

Fonts
  Fonts to display Japanese characters.
  これを読んだら日本語のフォントはもうインストールしました。
  If you can not read the above then you need to install fonts.
An IM
  An Input Method. It is an application that allows the user to type characters that do not appear on the keyboard. You will likely need one to input Japanese characters.
Qt
  Qt is an application toolkit that was used to write Tagaini.
CMake
  Cmake is a cross platform build system, which allows an alternative to automake’s configure scripts. It sets up the source code to be built according to the system it is run on. CMake is required for versions after 0.2.4.

## | || Platform ||||||| Dependency| |Windows| |Mac OS| |Linux Binary| |Source|

Japanese Fonts || yes || yes || yes || yes | An IM || yes || yes || yes || yes | Qt || no || no || yes || yes | CMake || no || no || no || yes |

[Platform Dependencies - version 0.2.5+]

In the tables above, dependencies marked as `yes` are required to be installed separately on the system to run Tagaini. If the dependency is marked as `no` then it is either included in the installer for that platform, or not necessary.

## Windows

Once you have downloaded the Windows Installer, all you have to do is run it. A dialogue box will come up and ask you to accept the license and where you would like it installed, by default `C:\Program Files\Tagaini Jisho`. It will place a shortcut in a folder in the applications menu, which you can run to launch Tagaini.

Fonts: If you are running Vista it is recommended that you install the Meiryo font for best visibility.

IME: To be able to input Japanese characters under Windows XP, You have to install the IME. To do so, Insert your Windows disk into your DVD-Rom drive. Go to the control panel and find `regional and language options`. In the language tab, under `text services and input languages` there is a button labelled `details`. Clicking it brings up another dialogue which allows you to add different input languages. Add Japanese. The keyboard should say Microsoft IME.

If the above instructions didn’t work for you, or if you would like to read a how-to on the Windows IME, one can be found here or here.

### Linux Japanese Support

There are several different IM’s to chose from, and each distribution of Linux will have its own documentation on getting Japanese Language support to work.

In a nutshell, the steps will read something like:

- Get UTF-8 support / Set the locale.
- Install Japanese fonts.
- Install IM X with support for Y and Z.

There are multiple ways, varying by distribution and applications, to do these things. We have provided some simple and general advice, as well as links to some distribution specific how-tos.

#### Locale

The locale is the first thing you will have to look at. You will have to change the locale to a UTF-8 locale (ie en_GB.UTF-*.) Some distributions provide packages with locales in them, possibly called language packs, whilst others expect you to use localegen or to set them up yourself.

If the information is not one of our how-to links, then you will have to search through your distributions documentation.

#### Fonts

Depending on your distribution you may find Japanese fonts in different packages in your package manager. Here we have a few different Japanese fonts listed, they may not be available in your package manager under these names, though they may be available under slightly different names.

- ttf-kochi-gothic
- ttf-kochi-mincho
- aquafont
- aquapfont
- jisx0213-fonts
- kochi-substitute
- mikachan-font
- monafont
- mplus
- sazanami
- shinonome
- vlgothic
- font-sony-misc
- mplus
- ipafonts
- umeplus
- togoshi

There are several IM’s for Linux. Two you are likely to hear of are `uim`, the universal input method, and `scim`, the simple common input method. Uim supports `xim`, the X input method, which is an older IM that makes uim good for backwards compatibility, as well as terminal input with `uim-fep`, whilst scim interfaces with GTK. Scim has a bridging module that allows compatibility with Qt, which you will need for Tagaini. Scim will interface with `mlTerm`, a multi lingual terminal emulator, and a few other terms, but not with `xterm` or other non GTK/qt terms.

#### How tos and other links:

- http://www.jw-stumpel.nl/input.html
- http://en.wikipedia.org/wiki/List_of_input_methods_for_UNIX_platforms

##### ubuntu

- https://wiki.ubuntu.com/InputMethods/SCIM/Setup
- https://help.ubuntu.com/community/SCIM

##### Debian

- http://dspnet.fr.eu.org/~lonewolf/LinuxJapan/Howto_English_Japanese.html

##### Mandriva

- http://symbolik.wordpress.com/2007/05/21/japanese-input-support-on-mandriva-2007-linux/

##### archLinux

- http://wiki.archlinux.org/index.php/Input_Japanese_using_UIM_%28English%29
- http://wiki.archlinux.org/index.php/Scim

##### Gentoo

- http://forums.gentoo.org/viewtopic-p-1852138.html
- http://zibundemo.blogspot.com/2008/10/japanese-ims-support-in-gentoo.html

## Compiling from Source

As this is an Open Source project, the source code is freely available. It can be found at the bottom of the download page in a tarball2. You can also clone the git repository at gitorius.

Tagaini Jisho 0.2.5 only has two dependencies, `Qt` 3 and `CMake`. It uses several other third party libraries, but provides custom versions of them in the source tarball.

### From the source tarball, version 0.2.6

The tarball comes with extra dependencies, so all you should not have to get them. First, the makefiles must be generated:

    tagaini-jisho $ cmake

You can also specify which language should be preferred for the dictionaries by passing the -DDICT_LANG= option to CMake. By default, all supported languages are included and English is mandatory as a fallback, but if you want to limit your build to English and French, you can invoke CMake this way:

    tagaini-jisho $ cmake -DDICT_LANG=fr .

From here, you may compile the release version of Tagaini:

    tagaini-jisho $ make

To install the program, you can run:

    tagaini-jisho $ make install

### Compiling from GIT sources.

If you have cloned the git repository then you are going to compile the latest, not nessasarly stable, build. As it is moving towards 0.2.7 it may have features that are yet undocumented.

The git repository does not hold any of the custom 3rd party libraries or the dictionaries. This script is provided to download all the 3rd party libraries It does not handle Qt. When it has finished, the makefiles need to be generated.

    tagaini-jisho $ cmake .

You can also specify which language should be preferred for the dictionaries by passing the -DDICT_LANG= option to CMake. If you want to build your dictionaries in French, you can invoke CMake this way:

    tagaini-jisho $ cmake -DDICT_LANG=fr .

Once that has finnished, Tagaini is ready to be built.

    tagaini-jisho $ make

From here, it can either be run with:

    tagaini-jisho $ ./src/gui/tagainijisho

or installed with:

    tagaini-jisho $ make install

## Upgrading

Tagaini Jisho is a work in progress and is constantly being updated. To upgrade Tagaini, there is no special upgrade procedure. Simply installing the new version over the top of the old one should work.

User data is kept separately in your home or user directory, so it will not be overwritten. When you run it for the first time after upgrading, it may convert your old data into a new format, display a message to this effect, and ask to be restarted.

Note: This information may be subject to change due to differences between releases.

1. A binary file is an executable file that contains information that the machine uses to run the file. tagainijisho.exe is a binary. ↩︎

2. A tar ball is a container file, or archive file, which contains multiple files. They are usually compressed with Gzip or Bzip2. ↩︎

3. The gentoo Qt maintainers split Qt into 14 separate packages. This is done so that one does not have to compile the entire monolithic library. Tagaini only requires `x11-libs/qt-core`, `x11-libs/qt-gui`, `x11-libs/qt-test` and `x11-libs/qt-sql`. ↩︎