11 テキスト検索インデクサの使用方法

この章では、テキスト検索インデクサについて説明します。また、テキスト検索インデクサを使用して索引ファイルを生成する方法について説明します。

この項の構成は、次のとおりです。

11.1 テキスト検索インデクサについて

Oracle Help for Javaには、Javaベースのテキスト検索インデクサが付属しています。インデクサは、Oracle Helpでのテキスト検索に使用される.idxファイルを生成します。テキスト検索インデクサには、日本語コンテンツ用と非日本語コンテンツ用の2つのバージョンがあります。

テキスト検索インデクサには、Java5 Standard Edition以上が必要です。JIT (Just In Time Compiler)をオンのままにしておくと、パフォーマンスが大幅に向上します。また、Java仮想マシンのヒープ・サイズを最大にしてください。

インデクサを実行する手順は、次のとおりです。

コマンド・プロンプトからインデクサを実行します。インデクサでは、次のコマンドライン引数をサポートしています。

[-l=locale] [-e=charset] dirnameindexfilename

引数	説明
`-l=locale`	オプション(推奨)の`locale`パラメータは、二文字形式のISO 639言語コードおよびISO 3166国コードを使用して指定します。形式は`language_COUNTRY`または`language_COUNTRY_VARIANT`です。`locale`の指定がない場合は、システムのデフォルト・ロケールが使用されます。
`-e=charset`	オプション(推奨)のcharsetパラメータには、索引を作成しているHTMLファイルの、Javaでサポートされるキャラクタ・セット・エンコーディング名を指定します。エンコーディングを指定しないと、現在のシステムのデフォルト・ロケールのデフォルトのキャラクタ・セット・エンコーディングが使用されます。指定する場合は、Javaでサポートされるキャラクタ・セット・エンコーディング名を値に指定する必要があります。Java SEの詳細は、`http://download.oracle.com/javase/1.5.0/docs/guide/intl/encoding.doc.html`を参照してください。
`dirname`	索引を作成するHTMLファイルが含まれるベース・ディレクトリ。インデクサでは、このディレクトリおよびそのサブディレクトリ(存在する場合)の下にあるすべてのファイルの索引が作成されます。
`indexfilename`	生成する索引ファイルの名前。

たとえば、java -mx64m oracle.help.tools.index.Indexer -l=en_US -e=8859_1 D:\MyHTMLFiles myIndex.idxのように指定します。

前述のコマンドでは、ロケールの言語を英語、国をアメリカ、エンコーディングを8859_1に設定し、D:\MyHTMLFilesディレクトリの索引を作成して、myIndex.idxファイルを作成します。

インデクサを実行する手順は、次のとおりです。

コマンド・プロンプトからインデクサを実行します。インデクサでは、次のコマンドライン引数をサポートしています。

[-e=charset] dirnameindexfilename

ここで、

引数	説明
`-e=charset`	オプション(推奨)のcharsetパラメータには、索引を作成しているHTMLファイルの、Javaでサポートされるキャラクタ・セット・エンコーディング名を指定します。エンコーディングを指定しないと、現在のシステムのデフォルト・ロケールのデフォルトのキャラクタ・セット・エンコーディングが使用されます。指定する場合は、Javaでサポートされるキャラクタ・セット・エンコーディング名を値に指定する必要があります。Java SEの詳細は、`http://download.oracle.com/javase/1.5.0/docs/guide/intl/encoding.doc.html`を参照してください。
`dirname`	索引を作成するHTMLファイルが含まれるベース・ディレクトリ。インデクサでは、このディレクトリおよびそのサブディレクトリ(存在する場合)の下にあるすべてのファイルの索引が作成されます。
`indexfilename`	生成する索引ファイルの名前。

たとえば、java -mx64m oracle.help.tools.index.JapaneseIndexer -e=MS932 D:\MyHTMLFiles myIndex.idxのように指定します。

前述のコマンドでは、JapaneseIndexerを実行し、エンコーディングをMS932に設定し、D:\MyHTMLFilesディレクトリの索引を作成して、myIndex.idxファイルを作成します。