======================================================================
                             wdic-fpw1.2b
                  FreePWING 版「通信用語の基礎知識」
======================================================================

                         This file is written in Shift-JIS kanji code.
                                Copyright (C) 2000-2001, rei@wdic.org.

■ 概要

  wdic-fpw は、おかの☆まりも氏を中心として編纂されている「通信用語の
  基礎知識」を、笠原基之氏による FreePWING スクリプトを使用して JIS X
  4081 形式の書籍データに変換するための Perl スクリプト群です。このス
  クリプトの実行には、FreePWING 1.3.1 以降と Jcode.pm が必要です。

  変換済みデータだけを入手された方は、このファイルの内容を理解する必要
  はありません。FreePWING 版の概要については、readme.txt または変換済
  みの辞書に含まれるメニューをお読みください。

■ 収録ファイル

1. 変換済み辞書 wdic-fpw1.2b.zip

  wdic-fpw1.2b.zip は、一部の文字を外字で表現したバージョンです
  (GAIJI=2)。変換時間と容量の関係から、外字を使わないバージョンの配布
  は停止しました。どうしても外字を使いたくない、でもスクリプトから生成
  する環境がない、という方がいらっしゃいましたら、ご連絡いただければ改
  めて作成・公開します。

  + wdic/
    - readme.1st            このファイル
    - readme.txt            Readme ファイル (メニューとして収録したもの)
    - catalogs              Catalogs ファイル
    - wdic/data/honmon      本文データ
    - wdic/gaiji/gai16h     外字データ

2. ソース コード (wdic-fpw1.2b-src.tar.gz)

  + wdic-fpw1.2
    - readme.1st            このファイル
    - readme.txt            辞書に収録される Readme ファイル
    - Makefile              GNU make 用 Makefile (EUC)
    - COPYING               GNU General Public License
    + src/
      - wdic-fpw.pl         メイン スクリプト
      - wdic-body.pl        本文の処理
      - wdic-menu.pl        メニューの構築
      - Wdic.pm             元データの操作
      - catalogs.txt        catalogs.txt のソース
      - catalogs-t.txt      catalogs.txt のソース (外字なし)
      - halfchar1.txt       半角外字定義ファイル
      - halfchar2.txt       半角外字定義ファイル
    + gaiji/
      + 1/
        - *.xbm             外字ビットマップ (発音記号)
        - *.bmp             外字ビットマップ (発音記号)
      + 2/
        - *.xbm             外字ビットマップ (一部の 1 バイト文字)
        - *.bmp             外字ビットマップ (一部の 1 バイト文字)

  wdic-fpw は、Free Software Foundation が公表した GNU General
  Public License (GNU 一般公有使用許諾) バージョン 2 以降のいずれかを
  選択し、そのバージョンが定める条項に従って、このプログラムを再頒布ま
  たは変更することができます。頒布にあたっては、市場性及び特定目的適合
  性についての暗黙の保証を含めて、いかなる保証も行いません。

  1.1 以降ではなるべく環境依存しないように留意しているつもりですが、
  Win32 環境以外での動作確認は行っていません。UNIX 環境で試された方が
  いらっしゃいましたら、結果をご報告いただければ幸いです。なお、
  wdic-fpw.pl は「通信用語の基礎知識 2001 年版」(前期/後期) 専用です。
  それ以外のバージョンでの動作は保証できません。

■ 依存ファイルの入手先

  通信用語の基礎知識
  http://www.wdic.org/

  FreePWING
  http://www.sra.co.jp/people/m-kasahr/freepwing/

  Jcode.pm
  http://openlab.ring.gr.jp/Jcode/

■ FreePWING 版の仕様 (収録されているファイル)

1. 辞書ファイル (*.DIC)

  - ソース ディレクトリに存在する辞書ファイルのみが変換対象となります。

  - 見出し語、読み、英語表記が検索語として登録されます。

  - 以下の用語が存在すれば、検索条件キーワードとして登録されます。ただ
    し、FreePWING 辞書の条件検索は、多くの辞書検索ソフトウェアでは正し
    く機能しません。期待どおりに検索できるソフトウェアは、最新の EB ラ
    イブラリを使用したもの (eblook など) と DDwin あたりに限られると思
    います。

      1. 所属するグループ名、辞書名 (拡張子を除いたファイル名部分)
      2. 読みに含まれる各単語 (単語区切りが見つかった場合)
      3. 英語名に含まれる各単語
      4. 関連語 (→◆★)

  - 用語の定義部分は適当に整形されます。一部の 2 バイト (全角) 文字は
    1 バイト (半角) に変換され、日本語/英単語間の空白も調整されます。
    整形ルーチンはそれほど検証していないので、不適切な部分がありました
    らご指摘いただければと思います。

  - 用例、コラムは原文のまま書き込まれます。改行位置も保持されます。

  - 参照語については、参照先の用語が変換対象になっていれば、クロスリ
    ファレンスとして書き込まれます。それ以外の用語や URL、プラグインは、
    通常のテキストとして書き込まれます。

2. ドキュメント類

  - FreePWING 版のドキュメントとして、このパッケージに含まれている
    readme.txt がそのままメニューに収録されます。

  - オリジナルのドキュメントとして、WDIC.MAN もメニューに書き込まれます。
    WDIC.MAN の本文部分は適当に整形されます。また、WDIC.MAN の一部のセ
    クションから著作権エントリが作成されます。

  - QUESTION.TXT が存在すれば、そのままメニューに追加されます。

3. タグ ジャンプ テーブル (*.TAG)

  - タグ ジャンプ テーブル ファイルが存在すると、それらを元にメニュー
    に索引 (グループ別収録語一覧) が作成されます。

■ 開発環境

   Windows NT 4.0 SP6a / Windows 2000 Professional
   ActivePerl 5.6.0 Build 620
   FreePWING 1.3.1
   Jcode 0.64
   EPWUTIL Ver.1.1 (Recompiled for Win32)
   netpbm-1.1-win32
   Cygwin 1.1 (bash、GNU make など)

■ 辞書の生成方法

  1. FreePWING 1.3.1 (以降) が動作可能で、かつ Jcode.pm がインストール
     されていることが前提です。それ以前の FreePWING での動作は確認して
     いません。Windows 環境の方は、UNIX と同等の基本コマンド群が必要に
     なります (FreePWING のインストールができていれば大丈夫でしょう...
     多分)。その他、Perl モジュールが足りないなどと言われた場合は適宜
     インストールしてください。

  2. オリジナルの辞書データを入手し、適当な場所に展開します。既定では、
     ./wdic011 ディレクトリから辞書を読み込むように Makefile が記述さ
     れています。このディレクトリは Makefile 中の WDICDIR で変更可能で
     す。

  3. 必要であれば Makefile を編集し、お使いの環境や好みに合わせて変数
     を定義/変更してください。コマンド ラインから指定してもかまいませ
     ん。

     WDICDIR:
     オリジナルの辞書ファイル群のあるディレクトリ。wdic-fpw は、ここで
     指定されたディレクトリからソース ファイルを探します。

     CHARSET:
     メッセージの出力や catalogs.txt の生成に使われる漢字コードを指定
     します。未定義の場合、環境変数 LANG から自動判定を試みます。判定
     できなければ未定義のままになります。

     NKF:
     catalogs.txt および halfchar.txt を生成するためのコマンドを指定し
     ます。このコマンドを使って src/*.txt (の漢字コード) が変換され、
     目的のファイルにリダイレクトされます。NKF が定義されていない場合、
     ${CHARSET} が euc または jis であれば NKF -{e|j}Sd、それ以外は cat
     コマンドが使われます。Windows 環境では定義する必要はありませんが、
     cat コマンドをインストールしておく必要があります (type コマンドに
     は対応していません)。

     BULLET:
     各エントリの説明文の先頭に追加する文字 (列) を指定します。オリジ
     ナルの辞書では '・' に相当します。デフォルトは '◇' です。デフォ
     ルト値を変更する場合、漢字コードは意識せずに文字そのものを指定し
     てください。

     GAIJI:
     半角外字を使用するかどうかを指定します。オリジナルの辞書の特性を
     尊重するため、既定で外字を使用するようになっています。
     GAIJI=0 に設定した場合、package ターゲットで生成されるパッケージ
     名の最後には '-t' が付加されます (例: wdic-fpw1.2a-t.zip)。

       0: 外字を一切使用しません。いわゆる半角カタカナと '\' は 2 バイ
          ト文字に変換されます。
       1: 発音記号を外字で表現します。
       2: 発音記号と半角カタカナ、および '\' を外字で表現します。既定
          値です。もっとも、2001 年前期版には「半角カタカナ」はほとん
          ど含まれていないようです。

     なお、1.1 で使用していた SORT オプションは廃止されました。エント
     リの並べ替えはスクリプト内部で行われます。

  4. GNU make を使って make します。かなりの時間がかかりますので覚悟し
     てください。と思ったけど OS/2 では約 50 分とのご報告をいただきま
     した。Windows が遅いだけかも...

  wdic-fpw.pl のオプションの詳細は、pod2man などで参照できます。

  オリジナルの辞書ファイルのいずれかが欠けている場合、存在しない辞書は
  無視されます。ただし、readme.txt およびオリジナルの WDIC.MAN は必須
  です。readme.txt はカレント ディレクトリに、WDIC.MAN は元ファイルの
  あるディレクトリ (WDICDIR) に置いてください。

  変換中、対象となる元ファイル群は移動、削除、編集しないようにしてくだ
  さい。特にロックなどはかけていませんが、途中でファイルが変更されると
  変換に失敗するはずです。

  UNIX (FreeBSD?) 版 LHA のバージョンによっては、オリジナルの辞書ファ
  イル名を (デフォルトで、または強制的に) 小文字に変換してしまうものが
  あるようです。wdic-fpw1.2 ではこのようなケースも考慮したつもりですが、
  なにぶん私の環境ではテストできないため、辞書ファイル群の解凍時には元
  のファイル名 (大文字) を保持するオプションを使用することをお勧めしま
  す。万一この仕様が原因で期待どおりに変換されない場合は、*.DIC、*.TAG、
  WDIC.MAN ファイルの名前をすべて大文字に変更してください。

■ 更新履歴

2001-07-26

   * wdic-fpw1.2b 作成。変換元データを 2001 年後期版に変更。
   * src/wdic-fpw.pl: processing-instruction に相当する文字列の扱いを
     修正。
   * src/wdic-body.pl: 見出し語が記号の場合の処理を改善。
   * src/Wdic.pm: 行の連結方法を改善。

2001-01-28

   * wdic-fpw1.2a 公開。Perl 5.6.0 の機能を使用していた点を修正、5.005
     でも動作するようにした。
   * Makefile: CHARSET、NKF の調整。PERLINCFLAGS の追加。
   * src/wdic-fpw.pl: @INC の直接操作を中止。
   * src/wdic-fpw.pl: テキスト整形に関する微調整。発音記号の変換時のバ
     グ取り。

2000-12-02

   * wdic-fpw1.2 公開。コミケ版。2001 年前期版専用のはず。
   * 膨大になりすぎたのでソースを分割。Wdic.pm、wdic-body.pl、
     wdic-menu.pl を追加、ディレクトリ構造を変更。
   * 辞書グループに対応。といっても情報表示と条件検索キーワードの追加
     程度。
   * 用語定義部の整形。文字種の統一とスペースの調整。
   * 発音記号を外字で表現するように拡張。
   * 条件検索キーワードを追加。ただし FreePWING 側に制限あり。
   * メニュー構成の変更と著作権エントリの追加。メニューには収録語一覧
     を追加。
   * 外部ソート コマンドの使用を廃止。
   * その他たくさん山ほどいっぱい。

2000-07-17

   * wdic-fpw1.1b 公開。
   * Makefile: ${GAIJI} の参照を修正。
   * wdic-fpw.pl: 外字を使わない場合にテキストが出力されないバグを修正。

2000-07-17

   * wdic-fpw1.1a 公開。
   * Makefile: catalogs.txt を Makefile で生成するように変更。その他外
     字の採用に伴う変更。
   * wdic-fpw.pl: -h 指定時や初期化失敗時には FreePWING を初期化せずに
     終了するように変更。
   * wdic-fpw.pl: Pod::Usage の使用を中止。
   * wdic-fpw.pl: chomp の使用を中止、正規表現で CR/LF を削除。
   * wdic-fpw.pl: QUESTION.TXT がなくても動作するように変更 (コミケ対
     応)。

2000-06-24

   * wdic-fpw1.1 公開。
   * 2000 年後期版専用として全面的に書き直し。
   * 環境依存部分を極力少なくしたつもり。

2000-03-14

   * 最初のバージョン。かなり Windows 依存。

-- EOF --
