Tagaini Jisho is available on several different platforms, including Windows and Mac OS, as well as being available for several Linux distributions. The correct binaries[1] 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 |||||||
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.
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.
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:
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.
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.
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.
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.
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 tarball[2]. 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.
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=
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
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=
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
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.
A binary file is an executable file that contains information that the machine uses to run the file. tagainijisho.exe is a binary. ↩
A tar ball is a container file, or archive file, which contains multiple files. They are usually compressed with Gzip or Bzip2. ↩
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
. ↩