The official Itadaki project is located on SourceForge and on Google Code. I created a fork here so that I could add more information and any fixes that I find. This and other readme files are mostly from the now-offline itadaki.org, accessible through The Wayback Machine.

Itadaki is a Japanese language toolset integrated with OpenOffice, providing tools intended for students and translators of Japanese.

The current release is 1.0 alpha 1.

Note: Following these instructions is strongly recommended to avoid some pitfalls involving Japanese fonts and the setup of Java.

Itadaki is made available under the GNU LGPL, and is free to use, copy, and modify under the terms of that license.

The optional dictionaries provided for use with Itadaki are licensed under various other terms, including the Creative Commons CC-BY-SA 2.5 and the Ipadic license. A full breakdown of the license terms of Itadaki's components can be found in the Code Module Overview

The Dictionary searches one or more standard EDICT format dictionaries (packages of the EDICT general dictionary and ENAMDICT name dictionary are available from the download area on SourceForge). The dictionary can be set to search on selection to allow fast lookups from within OpenOffice documents

The Furigana Wizard automatically applies furigana (reading annotations) to Kanji. For each sentence analysed, the best guess as to the correct readings is automatically presented; alternative or custom readings can be selected interactively.

Development mailing list is here: SourceForge mailing list. However, it seems to be no longer maintained.

An overview of the code modules that comprise Itadaki is available.

Source

• Itadaki requires OpenOffice 2.0 or later (2.1 or later recommended)

Windows: The latest OpenOffice can be downloaded from http://openoffice.org/

Unix: If possible, install the OpenOffice packages provided by your distribution. Generic packages are also available from http://openoffice.org/

Mac OS X: NeoOffice 2.0 (based on OpenOffice 2.0) should be compatible with Itadaki.

**Note**: Itadaki has not been tested on Mac OS X; some features may not work, and additional configuration may be necessary.

• Itadaki requires Sun Java 5.0 or later (6.0 or later recommended)

Windows: A compatible Java is installed automatically when you install OpenOffice. No further installation should be necessary.

Unix: The latest Java can be downloaded from http://java.sun.com/

**Note**: GNU GCJ compatible with Java 1.4.2 **will not work**. You must install Sun Java.

OpenOffice Java Options

OpenOffice Java Settings can be checked from the Tools > Options... menu in an OpenOffice window (see the image to the right). Of the Java installations shown in this example, one of Java 5.0 (1.5.0) or 6.0 (1.6.0) should be selected before Itadaki is installed

**Note**: If Java 1.4.2 is selected, OpenOffice may **cease to work** after Itadaki is installed. Please check that Sun Java 5.0 or greater is selected before continuing

Windows: East Asian language support must be installed to use Itadaki. Instructions on setting up East Asian languages in English Windows XP can be found here.

UNIX: See your distribution's documentation for instructions on setting up Japanese fonts and input.

Windows: By default, when Windows is not set to use a Japanese locale for the desktop, Kanji may be shown in a Chinese font within Itadaki's windows. Chinese renderings of some characters are not suitable for the display of Japanese, and Java must first be set up to prefer Japanese fonts.

1. Locate your Java installation. This is normally installed beneath **C:\Program Files\Java\**; for instance, **C:\Program Files\Java\jre1.5.0_06\**. If you have several versions of Java installed, choose the exact version that OpenOffice is using (see above).
2. Save this modified **fontconfig.properties** in the **\lib\** directory inside the Java installation; for instance, **C:\Program Files\Java\jre1.5.0_06\lib ontconfig.properties**

• Download the Itadaki packages from the download site:

• The packages can be installed within OpenOffice from the Tools > Package Manager... menu (OpenOffice 2.1 or earlier) or the Tools > Extension Manager... menu (OpenOffice 2.2 or greater).

• After installing the Itadaki packages, restart OpenOffice

  Note: Windows installations of OpenOffice include a quickstarter that docks into the system tray. To fully restart OpenOffice, you must exit the quickstarter as well as closing all OpenOffice windows.

Source

Itadaki is comprised of a number of individual code modules. As far as practical, these modules are designed as independent services with as few interdependencies as possible; all the sub modules linked into the main OpenOffice Interface module are intended to be reusable in other contexts.

• Module name: ItadakiDictionary
• Depends on: Seashell, FastTextPane
• License: LGPL

The Dictionary Tool service that provides the dictionary dialog. Integrates with the OpenOffice Interface module through a minimal Java interface, and contains no OpenOffice specific code.

• Module name: ItadakiFurigana
• Depends on: GoSen
• License: LGPL

The Furigana Wizard service, providing both the furigana wizard dialog and the "add to whole document" command. Integrates with the OpenOffice Interface module through a minimal Java interface, and contains no OpenOffice specific code.

• Module name: ItadakiOpenOffice
• Depends on: ItadakiDictionary, ItadakiFurigana
• License: LGPL

The front end integration of the OpenOffice extension. All OpenOffice specific code is contained within this module.

• Module name: FastTextPane
• License: LGPL

A read-only text display widget capable of displaying immense quantities of text almost instantaneously. Used as a replacement for the snail-like built in Java text components.

• Module name: GoSen
• Depends on: JISX0213 (for compilation only)
• License: LGPL

A pure Java morphological analysis library for Japanese based on Sen. GoSen is used by the Furigana Wizard to analyse sentences of Japanese text.

• Module name: JISX0213
• License: LGPL

A Java character set provider for the decoding of EUC-JISX0213 text (encoding is not currently supported). As of version 6, Sun Java does not provide this natively.

• Module name: Seashell
• License: LGPL

Low level dictionary searching and indexing services.

• Module name: ItadakiDataEdict
• Depends on: Seashell
• License: CC-BY-SA 2.5

The EDICT dictionary file for the Dictionary Tool. The module indexes the dictionary using Seashell and creates an OpenOffice extension package from it.

• Module name: ItadakiDataEnamdict
• Depends on: Seashell
• License: CC-BY-SA 2.5

The ENAMDICT dictionary file for the Dictionary Tool. The module indexes the dictionary using Seashell and creates an OpenOffice extension package from it.

• Module name: ItadakiDataIpadic
• Depends on: GoSen
• License: Ipadic license

The Ipadic morphological analysis dictionary for the Furigana Wizard. The module compiles the dictionary using GoSen and creates an OpenOffice extension package from it.

Source

Itadaki's source can be downloaded from GitHub, and can be browsed through the web interface.

Itadaki is best edited using the Eclipse IDE.

Jar files for each individual module can be built by executing the Ant build.xml from within Eclipse, or by invoking

$ ant

within the module's top level directory.

• First, build the supporting modules:

  FastTextPane/ GoSen/ JISX0213/ Seashell/

  Note: A pre-built jar of the JISX0213 module is present in the GoSen source. It can be replaced with a fresh build if desired, but this should not normally be necessary.

• Second, build the application modules:

  ItadakiDictionary/ ItadakiFurigana/

• Third, install the built jar files in the OpenOffice interface module:

  $ cp FastTextPane/fasttextpane-.jar GoSen/gosen-.jar JISX0213/jisx0213-.jar
  Seashell/seashell-.jar ItadakiDictionary/itadaki-dictionary-.jar
  ItadakiFurigana/itadaki-furigana-.jar ItadakiOpenOffice/libs/

• Finally, build the UNO packages for the OpenOffice interface and supporting dictionaries:

  ItadakiOpenOffice/ ItadakiDataEdict/ ItadakiDataEnamdict/ ItadakiDataIpadic/

When first installing Itadaki, following the Installation Instructions is strongly recommended to ensure you have a compatible Java and Asian font setup.

After rebuilding, the Itadaki OpenOffice package can be re-installed from the command line. On a typical UNIX system, the following command can be used:

$ /usr/lib/openoffice.org2.0/program/unopkg add -f ItadakiOpenOffice/itadaki-*.uno.pkg

OpenOffice will require a full restart after installing new packages.

**Note:** On systems where an OpenOffice quickstarter is enabled, the quickstarter may need to be killed to effect a full restart

Itadaki is built on ideas from a great number of other projects. Special thanks are due in particular to:

• JWPce and the venerable JWP for pioneering the concept of a text editor with integrated Japanese tools
• JGloss for the idea of using morphological analysis to apply furigana, and indirectly for several ideas concerning dictionary interfaces in Java
• Sen for the basis of a pure Java morphological analysis library (see GoSen for more information about the fork/upgrade of Sen used within Itadaki)