*FreePWING program to convert Oxford Advanced Learner's Compass.

written by Kazuhiro Ito <kzhr@d1.dion.ne.jp>

**これは何?
Oxford Advanced Learner's Dictionary, 7th Edition (以下OALD7)に
付属しているOxford Advanced Learner's Compass (以下OALC)のCD-ROMに
含まれる本文テキストをFreePWING (*1)を利用してJIS X 4081形式に
変換するツールです。

(*1) http://www.sra.co.jp/people/m-kasahr/freepwing/

**インストール
下記のソフトウェアが必要です。

*FreePWING
もちろん。
画像・音声の収録には1.5以降が必要です。

*Perl
Encodeモジュールのfrom_to関数で、'utf-8'と'euc-jp'との変換が行える状態に
してください。
perl 5.8以降では標準の状態で利用可能になっているはずです。
また、Compress::Raw::Zlibモジュール (*2) も必要です。

(*2) http://search.cpan.org/dist/Compress-Raw-Zlib/

このツール自体のインストールは任意のディレクトリに展開するだけです。

**使い方
*変換準備
**データの準備
変換ツールを展開したディレクトリ内の要求される位置に、OALCのCD-ROM上の
データをコピーします。 CD-ROM上のデータが存在するディレクトリと、
要求される位置は下表に示してあります。
必要なファイルはCONTENT.tdaとCONTENT.tda.tdzのふたつになります。
ただし、音声・画像については同じディレクトリにあるfiles.datとNAME.tdaも
必要です。
OALD7, OALD7CG, OALD7WFディレクトリ内にあるMakefileを書き換えて
本文データの位置を指定してもかまいません。

辞書                  本文データが存在するディレクトリ
OALD7                 data/entry/files.skn
Cultural Guide        data/guide/entry/files.skn
Wordfinder            data/wordfinder/files.skn
音声 (US)             data/pronus/files.skn		 
音声 (UK)             data/pronuk/files.skn 		 
画像 (OALD7)          data/image_fullsize/files.skn 	 
画像 (Cultural Guide) data/guide_image_fullsize/files.skn

辞書           要求される本文データの位置
OALD7                 OALD7/SRC
Cultural Guide        OALD7CG/SRC
Wordfinder            OALD7WF/SRC
音声 (US)             OALD7/SRC/us
音声 (UK)             OALD7/SRC/uk
画像 (OALD7)          OALD7/SRC/images
画像 (Cultural Guide) OALD7CG/SRC/images

**設定
FreePWING 1.5以降を使用しない、画像・音声の収録を行わない、
画像・音声の形式を変換して収録する等の場合は、
OALD7/oald7-fpw.conf, OALD7CG/oald7cg-fpw.conf,
OALD7WF/oald7wf-fpw.conf を編集して下さい。
詳細はファイル内のコメントを参照してください。

*変換
$ fpwmake 

で辞書(HONMON ファイル)を

$ fpwmake catalogs

で CATALOGS ファイルを

$ fpwmake package

で辞書をパッケージしたzipファイルを生成します。
また、

$ fpwmake gaiji-table

で、gaiji-tablesディレクトリ下に Lookup 用の補助パッケージと EBWin /
EBPocket 用の外字定義ファイルを生成します。
これらのファイルはパッケージ化した際にパッケージに同梱されますが、
パッケージが zip ファイルの場合はファイル名が大文字になってしまいます。

**ライセンス
プログラムのライセンスはGPL v2 に従います。
同梱のCOPYINGファイルを参照して下さい。
本ツール及び作成された書籍は正当な権利の範囲内で利用してください。

**制限等
***画像表示に関する制限
JPEG形式で収録した場合はJPEG画像の表示に対応したビューアが必要です。
 また、サイズを変更しない場合は幅720ピクセルという結構大きめの画像が
多いため、環境によっては見づらいかもしれません。

***音声再生に関する制限
元のデータがMP3であり、無圧縮のPCMに変換すると容量もしくは音質面での
制限が厳しいため、デフォルトではMP3にRIFF-WAVEのヘッダを
つけて収録しています。
この場合、一部のソフトウェアでしか再生できないと思われます。
Meadow、NTEmacs、EBWinでは再生できることを確認していますが、
EBPocketでは再生できない筈です。

***相互参照に関する制限
書籍間の相互参照はできません。
また、相互参照は元のXMLのソースに参照先が明記されているもののみ
対応しています。
これは、OALC付属のブラウザで直接参照先に飛ぶものや、
ポップアップウィンドウが表示された際に表示する項目が選べないものが
相当すると思います。

***JIS X 4081の書籍に収録できない文字について
収録できる他の文字に変えるか、外字として含まれてます。
