HTML コンバータの詳細

このセクションでは、次のトピックについて説明します。

• GUI バージョンの HTML コンバータの実行
  • 変換するフォルダ内のファイルの選択
  • バックアップフォルダの選択
  • ログファイルの生成
  • 変換テンプレートの選択
  • バージョン方式の選択
  • 変換
  • 終了または他のファイルの変換
  • テンプレートの詳細
• コマンド行でのコンバータの実行

GUI バージョンの HTML コンバータの実行

HTML コンバータは、JRE ではなく SDK に格納されています。 コンバータを実行するには、SDK のインストールディレクトリの lib サブディレクトリに移動します。 たとえば、Windows 上の C ドライブに SDK をインストールする場合、cd を使用して以下のディレクトリに移動します。

C:¥sdk1.4¥lib¥

コンバータ (htmlconverter.jar) はこのディレクトリに格納されています。

コンバータタイプを以下のように起動します。

C:¥sdk1.4¥lib¥..¥bin¥java -jar htmlconverter.jar -gui

UNIX または Linux でコンバータを起動するときもこれと同様です。

HTML コンバータのウィンドウが表示されます。

変換するフォルダ内のファイルの選択

「フォルダ内の単一のファイル」を変換する場合、パスを指定してファイル名を含めます。[Browse] ボタンでファイルを選択することもできます。 「フォルダ内のすべてのファイル」を変換する場合、フォルダのパスを入力するか、[Browse] ボタンを押してダイアログからフォルダを選択します。パスを選択したら、[Matching File Names] に任意の数のファイル指示子を指定します。 各指示子はコンマで区切る必要があります。 ワイルドカードとして「*」が使用できます。最後に、一致するファイル名を持つネストしたフォルダ内のファイルすべてを変換する場合、[Include Subfolders] チェックボックスを選択します。

バックアップフォルダの選択

Windows:

デフォルトのバックアップフォルダパスは、ソースパスに「_BAK」を追加したものになります。たとえば、ソースパスが c:/html の場合、バックアップパスは c:/html_BAK になります。バックアップパスを変更するには、[Backup Files to Folder:] という名前のフィールドにパスを入力するか、ダイアログを表示して目的のフォルダを選択します。

Unix (Solaris):

デフォルトのバックアップフォルダパスは、ソースパスに「_BAK」を追加したものになります。たとえば、ソースパスが /home/user1/html の場合、バックアップパスは /home/user1/html_BAK になります。 バックアップパスを変更するには、[Backup Files to Folder:] という名前のフィールドにパスを入力するか、ダイアログを表示して目的のフォルダを選択します。

ログファイルの生成

ログファイルを生成するには、[Advanced Options] 画面 ([Edit]>[Options]) を表示させて、[Generate Log File] を選択します。 テキストフィールドにパスを入力するか、ダイアログを表示してフォルダを選択します。ログファイルには、変換処理に関係した基本的な情報が含まれます。

変換テンプレートの選択

何も選択されていない場合、デフォルトのテンプレートが使用されます。このテンプレートにより生成される変換済み html ファイルは、IE および Netscape で動作します。別のテンプレートを使用する場合、メイン画面のメニューからテンプレートを選択できます。メニューから [Other Template ...] を選択すると、ファイルをテンプレートとして選択することも可能です。ファイルを選択する場合には、そのファイルがテンプレートであることを確認してください。

バージョン方式の選択

注:以下に記述している「指定バージョン」は、コンバータの起動に使用する JRE のバージョンです (例: 1.4.0)。 バージョンの最初の 2 桁の番号は、「ファミリ」を示しています (たとえば、1.4.3_02 は 1.4 ファミリに属しています)。 製品のバージョン番号に関する説明は、「Java Plug-in での OBJECT、EMBED、およびAPPLET タグの使用」というセクションの「バージョン番号に関する注記」を参照してください。

次の 2 つの選択肢があります。

変換

[Convert...] ボタンをクリックして、変換処理を開始します。ダイアログが表示され、処理中のファイル、処理されたファイルの数、検出されたアプレットの数、およびエラーの数が表示されます。

終了または他のファイルの変換

変換が完了すると、処理ダイアログのボタンが [Cancel] から [Done] に変わります。ダイアログを閉じるには、[Done] をクリックします。その後、Java Plug-in HTML コンバータプログラムを終了させることも、別のファイルセットを選択して変換することもできます。

テンプレートの詳細

アプレットの変換は、テンプレートファイルを土台として行われます。テンプレートファイルは、元のアプレットの各部を表すタグを含む、単純なテキストファイルです。
テンプレートファイルのタグを追加、削除、移動することにより、変換後のファイル出力を変更できます。

サポートされるタグ

次に、HTML コンバータに同梱される 4 つのテンプレートを示します。 他のテンプレートを作成した場合は、そのテンプレートを template フォルダに配置することにより使用可能になります。

default.tpl -- コンバータのデフォルトテンプレート。 変換されたページは、Windows 上の IE および Netscape Navigator で、Java Plug-in の呼び出しに使用できます。このテンプレートは、Unix (Solaris) 上の Netscape Navigator でも使用できます。

<!-- HTML CONVERTER -->
<OBJECT classid="clsid:E19F9330-3110-11d4-991C-005004D3B3DB"
$ObjectAttributes$ codebase="$CabFileLocation$">
$ObjectParams$
<PARAM NAME="type" VALUE="$MimeType$">
<PARAM NAME="scriptable" VALUE="false">
$AppletParams$
<COMMENT>
<EMBED type="$MimeType$" $EmbedAttributes$
$EmbedParams$ scriptable=false pluginspage="$NSFileLocation$"><NOEMBED>
</COMMENT>
$AlternateHTML$
</NOEMBED></EMBED>
</OBJECT>

<!--
$ORIGINALAPPLET$
-->

ieonly.tpl -- 変換されたページは、Windows 上の IE で Java Plug-in を呼び出す場合にのみ使用できます。

<!-- HTML CONVERTER -->
<OBJECT classid="clsid:E19F9330-3110-11d4-991C-005004D3B3DB"
$ObjectAttributes$ codebase="$CabFileLocation$">
$ObjectParams$
<PARAM NAME="type" VALUE="$MimeType$">
<PARAM NAME="scriptable" VALUE="false">
$AppletParams$
$AlternateHTML$
</OBJECT>

<!--
$ORIGINALAPPLET$
-->

nsonly.tpl -- 変換されたページは、Windows および Solaris 上の Navigator で、Java Plug-in を呼び出す場合にのみ使用できます。

<!-- HTML CONVERTER -->
<EMBED type="$MimeType$" $EmbedAttributes$
$EmbedParams$ scriptable=false pluginspage="$NSFileLocation$"><NOEMBED>
$AlternateHTML$
</NOEMBED></EMBED>

<!--
$ORIGINALAPPLET$
-->

extend.tpl -- 変換されたページは、任意のプラットフォームの任意のブラウザで使用できます。 ブラウザが Windows 上の IE や Navigator、または Solaris 上の Navigator である場合、Java(TM) Plug-in が呼び出されます。 それ以外の場合、ブラウザのデフォルト JVM が使用されます。

<!-- HTML CONVERTER -->
<SCRIPT LANGUAGE="JavaScript"><!--
var _info = navigator.userAgent; var _ns = false; var _ns6 = false;
var _ie = (_info.indexOf("MSIE") > 0 && _info.indexOf("Win") > 0 &&
_info.indexOf("Windows 3.1") < 0);
//--></SCRIPT>
<COMMENT><SCRIPT LANGUAGE="JavaScript1.1"><!--
var _ns = (navigator.appName.indexOf("Netscape") >= 0 &&
((_info.indexOf("Win") > 0 && _info.indexOf("Win16") < 0 &&
java.lang.System.getProperty("os.version").indexOf("3.5") < 0) ||
_info.indexOf("Sun") > 0));
var _ns6 = ((_ns == true) && (_info.indexOf("Mozilla/5") >= 0));
//--></SCRIPT></COMMENT>

<SCRIPT LANGUAGE="JavaScript"><!--
if (_ie == true) document.writeln('<OBJECT
classid="clsid:E19F9330-3110-11d4-991C-005004D3B3DB" $ObjectAttributes$
codebase="$CabFileLocation$"><NOEMBED><XMP>');
else if (_ns == true && _ns6 == false) document.writeln('<EMBED
type="$MimeType$" $EmbedAttributes$
$EmbedParams$ scriptable=false 
pluginspage="$NSFileLocation$"><NOEMBED><XMP>');
//--></SCRIPT>
<APPLET $AppletAttributes$></XMP>
$ObjectParams$
<PARAM NAME="type" VALUE="$MimeType$">
<PARAM NAME="scriptable" VALUE="false">
$AppletParams$
$AlternateHTML$
</APPLET>
</NOEMBED></EMBED></OBJECT>

<!--
$ORIGINALAPPLET$
-->


コマンド行でのコンバータの実行

形式

java -jar htmlconverter.jar [-options1 value1 [-option2 value2 [...]]] [-simulate] [filespecs]

「java -jar htmlconverter.jar」だけを指定する (filespecs や options を指定しない) 場合、GUI バージョンのコンバータが起動します。それ以外の場合、GUI の表示は抑制されます。

filespecs:
空白で区切られたファイル仕様のリスト。ワイルドカード (*) を含めることができます (例: *.html、file*.html)。

-simulate:
変換を実際に実行せずに、変換のプレビューを表示する場合に設定します。 このオプションは、変換の結果が不明な場合に使用してください。 変換の実行結果に関する詳細な情報が表示されます。