続けてHTML Help2.x形式のヘルプを生成する手順を見ていきましょう。
HTML Help2.x形式のヘルプの生成手順
HTML Help2.x形式のヘルプ(HxS)は、次の要素から成り立っています。
HTML Help 2.x形式関連のファイル一覧
| ファイルの種類 | 拡張子 | 説明 |
|---|---|---|
| プロジェクトファイル | HxC | コンパイルに必要なヘルプ全体の情報 |
| 目次ファイル | HxT | ヘルプの目次情報 |
| 属性ファイル | HxA | カスタムフィルターを作る場合の情報 |
| インクルードファイル | HxF | コンパイル時にインクルードする場合の情報 |
| 索引ファイル | HxK | キーワード情報 |
| トピックファイル | htm | ヘルプの1ページに該当するHTML |
HTML Help 2.xも同様に必要なファイル一式を揃えてからコンパイルを行います。
|
HTML Help2.xのヘルプファイルを作成する手順 |
(1) XslTransform.exeで、クラスの型情報から、中間的な目次情報(Toc.xml)を生成
(2) XslTransform.exeで、Toc.xmlからHTML Help2.xのプロジェクトファイル(HxC)と目次(HxT)を生成
(3) hxcomp.exeで、HTML Help2.x形式のヘルプ(HxS)を生成
hxcomp.exeによるヘルプのコンパイル
以前、紹介したようにXslTransformは、XMLファイルをXSLTにて変換/生成できます。ここではXslTransformで、HTML Help2.x形式のヘルプに必要な目次(*.HxT)やプロジェクトファイル(HxC)を生成しています。
索引ファイル(HxK)はコピーによって準備します。これらの手順によって、必要なファイルが揃ったところでhxcomp.exeでコンパイル行い、HTML Help2.x形式のヘルプファイル(*.HxS)を生成します。
hxcomp.exeの実行例
hxcomp.exe -p output\SampleLib.HxC
ヘルプのコンパイルは、プロジェクトファイル名を指定して実行するだけです。hxcomp.exeで指定できるパラメータは次の通りです。
hxcomp.exeで指定できるパラメータ
| パラメータ | 説明 |
|---|---|
| -p | プロジェクトファイル(*.HxC)名 |
| -l | ANSI/DBCSのログファイル名 |
| -n | ユニコードのログファイル |
| -r | プロジェクトのルート |
| -o | 出力ファイル名 |
| -i | インフォメーションメッセージを表示しない |
| -e | エラーメッセージを表示しない |
| -w | 警告メッセージを表示しない |
| -q | サイレンスモー |
| -u | コンパイルしないファイル名 |
| -d | コンパイルしないディレクトリ名 |
これで、HTML Help2.x形式のファイル(*.HxS)が生成されます。
