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言語コードです。例えば、messagesをBUNDLE_NAMEとして使用する場合、英語のファイル名は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になります。