HTML Help WorkshopはMicrosoft HTML Help作成ツールであり、Microsoftが無償で提供している。

• HTML Help Workshopとは
• Compiled HTML Help作成の流れ
• プロジェクトを作成する
• トピックを作成する
• 目次を作成する
• 索引を作成する
• コンパイルする
• HTML Help ActiveXコントロールを使う
• Aリンクを設定する
• キーワード検索リンクを設定する
• 関連トピックリンクを設定する

HTML Help Workshopとは

HTML Help WorkshopはMicrosoft HTML Help作成ツールであり、Microsoftが無償で提供している。

Microsoft Developer Network から最新版をダウンロードすることができる。

プロジェクトを作成する

1. [File] メニューから [New] を選択するか、ツールバーの (New) をクリックする。
2. [New] ダイアログが表示される

   

3. [Project] を選択し、[OK] ボタンをクリックする。
4. [New Project] ダイアログが表示される。

   

5. [次へ] ボタンをクリックする。

   

6. [Browse] ボタンをクリックする。
7. [ファイルを開く]コモンダイアログボックスが表示される。
8. 作成するプロジェクトファイルの名前と場所を指定すて、[開く] ボタンをクリックする。

トピックを作成する

トピックファイルを作成する

トピックファイル(*.htm)はHTMLファイルである。テキストエディタやHTMLエディタで作成してもよいが、ここではHTML Help Workshopで作成する方法を説明する。

1. [File] ニューから[New]を選択するか、ツールバーの(New)ボタンをクリックする。
2. [New]ダイアログが表示される

   

3. [Specify what to create]リストの中から[HTML File]を選択して、[OK]ボタンをクリックする。
4. [HTML Title]ダイアログが表示される。
5. HTMLのタイトルを入力し、[OK]ボタンをクリックする。

トピックファイルを作成しただけではプロジェクトに追加されないので、プロジェクトにトピックファイルを追加する必要がある。

プロジェクトにトピックファイルを追加する

1. ツールバーの (Add/Remove topic files) をクリックする。
2. [Topic Files] ダイアログが表示される。

   

3. [Add] ボタンをクリックする。
4. [ファイルを開く]コモンダイアログボックスが表示される。
5. プロジェクトに追加するトピックファイル（*.htm, *.html）を選択して、[開く] ボタンをクリックする。
6. [OK] ボタンをクリックする。

目次を作成する

目次ファイルを作成してプロジェクトに関連付ける

1. HTML Help Workshopの [Contents] タブをクリックする。
2. 目次ファイル (*.hhc) をまだプロジェクトに関連付けていない場合は、[Table of Contents Not Specified] ダイアログが表示される。
3. [Create a new contents file] を選択し、[OK] ボタンをクリックする。
4. [名前を付けて保存] ダイアログが表示される。
5. Table of Contents File (*.hhc) の名前と場所を指定して、[保存] ボタンをクリックする。

目次に見出しを挿入する

1. HTML Help Workshopの[Contents]タブをクリックする。
2. (Insert a heading)ボタンをクリックする。
3. [Table of Contents Entry]ダイアログが表示される。
   
4. [Entry title]に見出しのタイトルを入力する。
5. [OK]ボタンをクリックする。

目次にページを挿入する

1. HTML Help Workshopの[Contents]タブをクリックする。
2. [Contents]タブでページを挿入する位置の上にある見出しまたはページをクリックして選択する。
3. (Insert a page)ボタンをクリックする。
4. 手順2でリストの1番上にある見出しまたはページを選択した場合は、[HTML Help Author Message]メッセージボックスが表示される。選択した見出しまたはページの上に挿入する場合は[はい]、下に挿入する場合は[いいえ]ボタンをクリックする。
   
5. [Table of Contents Entry]ダイアログが表示される。
   
6. [Entry title]にページのタイトルを入力する。
7. [Add]ボタンをクリックする。
8. [Path or URL]ダイアログが表示される。
9. [HTML titles]リストから、挿入するHTMLのタイトルをクリックして選択する。
10. [Path or URL]ダイアログの[OK]ボタンをクリックする。
11. [Table of Contents Entry]ダイアログの[OK]ボタンをクリックする。

ウィンドウ定義に目次を設定する

1. HTML Help Workshopの[Project]タブをクリックする。
2. (Add/Modify window definitions)ボタンをクリックする。
3. [Window Types]ダイアログが表示される。
   
4. [Files]タブをクリックする。
5. [TOC]から目次ファイル(*.hhc)を選択する。
6. [OK]ボタンをクリックする。

索引を作成する

HTML Helpの[キーワード]タブに表示されるキーワードを作成する手順を示す。

索引ファイルを作成してプロジェクトに関連付ける

1. HTML Help Workshopの[Index]タブをクリックする。
2. 索引ファイル(*.hhk)をまだプロジェクトに関連付けていない場合は、[Index Not Specified]ダイアログが表示される。

   

3. [Create a new index file] を選択し、[OK] ボタンをクリックする。
4. [名前を付けて保存] ダイアログが表示される。
5. 索引ファイル(*.hhk)の名前と場所を指定して、[保存] ボタンをクリックする。

索引にキーワードを挿入する

1. HTML Help Workshopの[Index]タブをクリックする。
2. (Insert a keyword)ボタンをクリックする。
3. [Index Entry]ダイアログが表示される。
   
4. [Keyword]にキーワードの文字を入力する。
5. [Add]ボタンをクリックする。
6. [Path or URL]ダイアログが表示される。
7. [HTML titles]リストに、プロジェクトに追加されているトピックのタイトルが一覧表示される。キーワードに対応させるトピックのタイトルを選択し、[OK]ボタンをクリックする。
8. [Path or URL]ダイアログの[OK]ボタンをクリックする。
9. [Index Entry]ダイアログの[OK]ボタンをクリックする。

ウィンドウ定義に索引を設定する

1. HTML Help Workshopの[Project]タブをクリックする。
2. (Add/Modify window definitions)ボタンをクリックする。
3. [Window Types]ダイアログが表示される。
   
4. [Files]タブをクリックする。
5. [Index]リストからから索引ファイル(*.hhk)を選択する。
6. [OK]ボタンをクリックする。

コンパイルする

1. HTML Help Workshopの[File]メニューから[Compile]を選択するか、(Compile HTML file)ボタンをクリックする。
2. [Create a compiled file]ダイアログが表示される。

   

3. [Project file]リストボックスからプロジェクトファイルを選択するか、[Browse]ボタンをクリックしてプロジェクトファイル(*.hhp)を開く。
4. [Compile]ボタンをクリックする。

HTML Help ActiveXコントロールを使用する

あるトピックから別のトピックへジャンプさせる場合、HTML HelpではHTMLのA要素を使用する。Windows Helpでは別のトピックへジャンプする際、複数の候補からジャンプ先トピックを選択する機能があった。HTMLのA要素ではこのようなことは行えないため、Windows Helpの機能を持ったHTML Help ActiveXコントロールが提供されている。

HTMLのOBJECT要素からHTML Help ActiveXコントロールの機能を呼び出すことにより、Windows Helpの機能をHTML Helpでも利用できる。

Aリンクを設定する

ジャンプ先のトピックにAリンク名を挿入する

1. HTML Help Workshopの[File]メニューから[Open]を選択するか、(Open)ボタンをクリックする。
2. [ファイルを開く]コモンダイアログボックスが表示される。
3. トピックファイル(*.htm、*.html)を選択して、[開く]ボタンをクリックする。
4. トピックウィンドウが表示される
5. トピックウィンドウでOBJECT要素を挿入したい位置にカーソルを移動する。

   ※OBJECT要素はHEAD要素の子孫でもよいし、BODY要素の子孫でもよい。つまり、 <HEAD> タグと </HEAD> タグの間に挿入してもよいし、 <BODY> タグと </BODY> タグの間でもよい。

6. [Edit]メニューから[Compiler Information]を選択する。
7. [Compiler Information]ダイアログボックスが表示される。
   
8. [ALink Names]タブをクリックする。
   
9. [Add]ボタンをクリックする。
10. [Add ALink name]ダイアログボックスが表示される。
    
11. テキストボックスにAリンク名を入力して、[OK]ボタンをクリックする。
12. [OK]ボタンをクリックして、[Compiler Information]ダイアログボックスを閉じる。
13. [File]メニューから[Save File]を選択する。

ジャンプ元のトピックにAリンクを挿入する

1. HTML Help Workshopの[File]メニューから[Open]を選択するか、(Open)ボタンをクリックする。
2. [ファイルを開く]コモンダイアログボックスが表示される。
3. トピックファイル(*.htm、*.html)を選択して、[開く]ボタンをクリックする。
4. トピックウィンドウが表示される
5. トピックウィンドウでOBJECT要素を挿入したい位置にカーソルを移動する。

   ※OBJECT要素はHEAD要素の子孫でもよいし、BODY要素の子孫でもよい。つまり、 <HEAD> タグと </HEAD> タグの間に挿入してもよいし、 <BODY> タグと </BODY> タグの間でもよい。

6. (HTML Help ActiveX Control)ボタンをクリックする。
7. [HHCTRL: HTML Help ActiveX Control Commands]ダイアログが表示される。
   
8. [Specify the command]リストボックスから[ALink Search]を選択して、[次へ]ボタンをクリックする。
9. [Specify how you want the command to appear to the user]から[As a buton]を選択して、[次へ]ボタンをクリックする。

   

10. [HHCTRL: ALink Search]ダイアログボックスが表示される。

    

11. [Add]ボタンをクリックする。
12. [Add/Edit ALink Name]ダイアログボックスが表示される。

    

13. [ALink name]テキストボックスにジャンプ先のAリンク名を入力する。
14. [OK]ボタンをクリックして、[Add/Edit ALink Name]ダイアログボックスを閉じる。
15. [次へ]ボタンをクリックする。
16. [完了]ボタンをクリックする。
17. [File]メニューから[Save File]を選択する。

キーワード検索リンクを設定する

1. HTML Help Workshopの[File]メニューから[Open]を選択する。
2. [ファイルを開く]コモンダイアログボックスが表示される。
3. トピックファイル(*htm、*.html)を選択して、[開く]ボタンをクリックする。
4. HTMLソースを表示するウィンドウが表示される。
5. HTMLコードを挿入したい位置にカーソルを移動する。
6. (HTML Help ActiveX Control)ボタンをクリックする。
7. [HHCTRL: HTML Help ActiveX Control Commands]ダイアログが表示される。
   
8. [Specify the command]リストボックスから[Keyword Search]を選択して、[次へ]ボタンをクリックする。
9. [Specify how you want the command to appear to the user]から[As a buton]を選択して、[次へ]ボタンをクリックする。

   

10. ボタンにテキストを表示するかビットマップを表示するかを選択する。テキストを表示する場合は、[Text]テキストボックスに文字を入力する。[次へ]ボタンをクリックする。

    

11. [Add]ボタンをクリックする。

    

12. [Add/Edit keyword]ダイアログが表示される。

    

13. [Keyword]テキストボックスにキーワードを入力して、[OK]ボタンをクリックする。
14. [次へ]ボタンをクリックする。
15. [完了]ボタンをクリックする。
16. [File]メニューから[Save File]を選択する。

関連トピックリンクを設定する

1. HTML Help Workshopの[File]メニューから[Open]を選択する。
2. [ファイルを開く]コモンダイアログボックスが表示される。
3. トピックファイル(*htm、*.html)を選択して、[開く]ボタンをクリックする。
4. (HTML Help ActiveX Control)ボタンをクリックする。
5. [HHCTRL: HTML Help ActiveX Control Commands]ダイアログが表示される。
   
6. [Specify the command]リストボックスから[Related Topics]を選択して、[次へ]ボタンをクリックする。
7. [Specify how you want the command to appear to the user]から[As a buton]を選択して、[次へ]ボタンをクリックする。

   

8. ボタンにテキストを表示するかビットマップを表示するかを選択する。テキストを表示する場合は[Text]に文字を入力する。[次へ]ボタンをクリックする。

   

9. [Add]ボタンをクリックする。

   

10. [Title]にタイトルを入力する。[File/URL]にトピックファイルのパス名またはURLを入力する。代替のURLがあれば、[Alternate URL]にURLを入力する。[OK]ボタンをクリックする。

    

11. 複数のトピックファイルへのジャンプを設定する場合は、手順10〜11の操作を繰り返す。
12. [次へ]ボタンをクリックする。
13. [完了]ボタンをクリックする。