JPedal Viewerに追加の言語を追加する

Viewerのテキストコンテンツは、リソースバンドルによって処理および制御されています。このバンドルには、JPedal Viewerのテキストを表示するために使用されるファイルが含まれています。JPedalは現在、英語、フランス語、ドイツ語、日本語、中国語のビルトインサポートを提供しています。独自のリソースバンドルを提供することで、追加の言語のサポートを追加することもできます。

独自のリソースバンドルを追加する方法

別の言語のサポートを追加するには、2つのことを行う必要があります。

jar内のディレクトリにリソースバンドルを作成する。
このディレクトリの名前を使用して、org.jpedal.customBundleフラグを設定する。

以下では、これら両方のステップを詳しく説明します。

jar内のディレクトリにリソースバンドルを作成する

リソースバンドルを作成する際には、サポートしたいすべての言語を格納するディレクトリを作成し、各言語用のファイルを作成する必要があります。

まず、リソースバンドル用のディレクトリを作成する必要があります。これは、jar内のリソースディレクトリで、言語ファイル専用として、他の用途には使用されないものである必要があります。

例えば、プロジェクトのjar内にorg.jpedal.languages.customというディレクトリを作成します。

次に、サポートしたい各言語用のファイルを作成する必要があります。このファイル内には、キーと値のリストがあり、値はViewerに表示されるテキストです。英語の例はこちらで確認できます。これをテンプレートとして、独自の言語ファイルを作成できます。

ファイルが完成したら、リソースディレクトリに追加できますが、ファイル名は特定のパターンに従う必要があります。[BUNDLE_NAME]_[LANG].propertiesの形式で、BUNDLE_NAMEはすべての言語ファイルの接頭辞、LANGはISO 639 Set 1言語コードです。例えば、BUNDLE_NAMEとしてmessagesを使用する場合、英語のファイル名はmessages_en.propertiesとなります。

最後に、JPedalがデフォルトでサポートしている言語を無視して、カスタムバンドルのみを使用したい場合は、独自のデフォルトフォールバック言語ファイルを提供できます。デフォルトフォールバック言語用のファイルを作成した後、言語コードなしで保存すると（例：messages.properties）、システムの言語がバンドル内に見つからない場合にこの言語が使用されます。このデフォルトフォールバックファイルが存在しない場合、カスタムバンドルがその言語をサポートしていない場合、JPedalはデフォルトのリソースバンドルをチェックします。

新しいリソースバンドルを使用する

リソースバンドルを作成したら、JPedalがそのバンドルを使用できるようにするために、1つのJVMフラグを提供するだけです。

org.jpedal.customBundle=[BUNDLE_DIRECTORY].[BUNDLE_NAME]

したがって、上記の例（BUNDLE_DIRECTORYがorg.jpedal.languages.custom、BUNDLE_NAMEがmessages）を使用した場合、値はorg.jpedal.languages.custom.messagesとなります。