HTML Helpの作成方法(基本編)
関連項目へのジャンプを設定する

あるトピックから別のトピックにジャンプさせたい場合、通常のHTMLのハイパーリンクがまず頭に浮かびますが、HTML Helpではそれ以外に、Aリンク(Associative Links)、Kリンク(Keyword Links)、関連トピックリンク(Related Topics Links)の3種類の方法で関連するトピックにジャンプさせることができます。

Aリンク、Kリンク、関連トピックリンクの共通点と相違点

共通点

いずれの方法でも、ボタンをクリックして関連付けられているトピックにジャンプします。ジャンプ先が複数ある場合にはトピック一覧が表示され、ジャンプ先を選択できます。

たとえばトピックにボタンを付けた例ボタンをトピックに付け、このボタンをクリックすると関連付けられているトピック一覧が表示されるように設定できます。

ポップメニューにジャンプ先一覧を表示

相違点

AリンクとKリンクの場合は、ジャンプ先のトピックにAリンク名、Kリンク名(キーワード)を挿入します。複数のトピックに同じAリンク名、キーワードを付けることができます。
ジャンプ元のトピックでAリンク名、キーワードを指定すると、そのAリンク名、キーワードが挿入されているすべてのトピックファイルのタイトルが一覧表示されます。

  • たとえば「gaiyou」というキーワードをsyurui.htm、sakusei.htmという2つのトピックファイルに挿入したとし、それぞれのファイルのタイトルが「HTML Helpの種類」「HTML Helpを作成するには」だったとします。ジャンプ元のトピックのボタンに「gaiyou」と指定すると、ボタンをクリックしたときに、「HTML Helpの種類」「HTML Helpを作成するには」というタイトルが表示されます。
  • Kリンクの場合は、[Index]タブで設定したキーワードもジャンプ先に指定できます。

関連トピックリンクの場合は、ジャンプ先のトピックには何も挿入しません。ジャンプ元のトピックで、ジャンプ先のトピックファイル名またはURLを指定するだけです。
一覧表示されるタイトルには、トピックファイルのタイトル以外の任意の文字を指定できます。

AリンクとKリンクの違いは、キーワードがHTML Helpウインドウの[キーワード]タブに表示されるのに対し、Aリンク名は[キーワード]タブに表示されない点にあります。
Aリンク名はユーザの目に触れませんので、ヘルプ制作者にとって都合のよい略称などを付けることができます。

AリンクとKリンクはコンパイル形式のみ
AリンクとKリンクはコンパイル形式のヘルプの場合のみ有効ですが、関連トピックリンクはWeb形式のヘルプでも使用できます。

(一覧に戻る)

Aリンクを設定する

トピックファイルにAリンク名を挿入する

  1. [File]→[Open]を選択し、Aリンク名を挿入するトピックファイル(*.htm、*.html)を開きます。
    HTML Help Workshopのタイトルバーとツールバーの内容が切り替わります。
  2. HTMLファイルのAリンク名を挿入する位置にカーソルを入れ、[Edit]→[Compiler Information]を選択します。
    [Compiler Information]ダイアログが開きます。
  3. [ALink Names]タブの[Add]ボタンをクリックします。
    [Add ALink name]ダイアログが表示されます。
  4. Aリンク名を入力します。
  • 1つのトピックファイルに対して複数のAリンク名を設定したい場合は、Aリンク名をセミコロン(;)で区切って入力します。
  1. [OK]ボタンをクリックします。
    [Compiler Information]ダイアログに戻ります。
  2. [OK]ボタンをクリックします。
    ダイアログが閉じ、Aリンク名が挿入されます。
  3. [File]→[Save File]を選択し、トピックファイルを上書き保存します。

Aリンクを設定する

  1. [File]→[Open]を選択し、Aリンクを設定するトピックファイル(*.htm、*.html)を開きます。
  2. アイコン(HTML Help ActiveX Control)をクリックします。
    [HHCTRL: Command and ID]ダイアログが表示されます。
  3. コンボボックスで[ALink Search]を選択し、[次へ]ボタンをクリックします。
    [HHCTRL: Display Type]ダイアログが表示されます。
  4. [As a button]を選択し、[次へ]ボタンをクリックします。
    [HHCTRL: Button Options]ダイアログが表示されます。
  5. 次のいずれかを選択します。

    [Display text on the button]:ボタンの上に文字を表示します。
    [Display a bitmap on the button]:ボタンの上にビットマップを表示します。
    [Display an icon on the button]:ボタンの上にアイコンを表示します。
  1. ボタンの上に文字を表示する場合は、[Text]に文字を入力します。
    ボタンの上にビットマップまたはアイコンを表示する場合は、ダイアログの下に表示される[Browse]ボタンをクリックし、ファイル名を選択します。
  2. [次へ]ボタンをクリックします。
    [HHCTRL: ALink Search]ダイアログが表示されます。
  3. [Add]ボタンをクリックします。
    [Add/Edit ALink Name]ダイアログが表示されます。
  4. [ALink name]にAリンク名を入力し、[OK]ボタンをクリックします。
    [HHCTRL: ALink Search]ダイアログに戻ります。
  • [Multiple alink names]にチェックを付けると、[ALink name]にセミコロンで区切って複数のAリンク名を設定することができます。
  1. [次へ]ボタンをクリックします。
    [HHCTRL: Finish]ダイアログが表示されます。
  2. [完了]ボタンをクリックします。
    ダイアログが閉じ、Aリンクが設定されます。
  3. [File]→[Save File]を選択し、トピックファイルを上書き保存します。

(一覧に戻る)

Kリンク(キーワード)を設定する

トピックファイルにKリンク名(キーワード)を挿入する

  1. [File]→[Open]を選択し、キーワードを挿入するトピックファイル(*.htm、*.html)を開きます。
    HTML Help Workshopのタイトルバーとツールバーの内容が切り替わります。
  2. HTMLファイルのキーワードを挿入する位置にカーソルを入れ、[Edit]→[Compiler Information]を選択します。
    [Compiler Information]ダイアログが開きます。
  3. [keywords]タブの[Add]ボタンをクリックします。
    [Add keyword]ダイアログが表示されます。
  4. キーワードを入力し、[OK]ボタンをクリックします。
  • 1つのトピックファイルに対して複数のキーワードを設定したい場合は、Aリンク名をセミコロン(;)で区切って入力します。
  1. [OK]ボタンをクリックします。
    [Compiler Information]ダイアログに戻ります。
  2. [OK]ボタンをクリックします。
    ダイアログが閉じ、キーワードが挿入されます。
  3. [File]→[Save File]を選択し、トピックファイルを上書き保存します。
  • 追加したキーワードは、HTML Help Workshopの[Index]タブには表示されませんが、コンパイル後のHTML Helpの[キーワード]タブには表示されます。

Kリンクを設定する

  1. [File]→[Open]を選択し、Kリンクを設定するトピックファイル(*.htm、*.html)を開きます。
  2. アイコン(HTML Help ActiveX Control)をクリックします。
    [HHCTRL: Command and ID]ダイアログが表示されます。
  3. コンボボックスで[Keyword Search]を選択し、[次へ]ボタンをクリックします。
    [HHCTRL: Display Type]ダイアログが表示されます。
  4. [As a button]を選択し、[次へ]ボタンをクリックします。
    [HHCTRL: Button Options]ダイアログが表示されます。
  5. Aリンクの場合と同様に、ボタンの表示内容を選択し、ボタンに表示される文字またはイメージ/アイコンファイル名を指定します。
  6. [次へ]ボタンをクリックします。
    [HHCTRL: Keyword Search]ダイアログが表示されます。
  7. [Add]ボタンをクリックします。
    [Add/Edit Keyword]ダイアログが表示されます。
  8. [Keyword]にキーワードを入力し、[OK]ボタンをクリックします。
    [HHCTRL: Keyword Search]ダイアログに戻ります。
  • [Multiple keywords]にチェックを付けると、[Keyword]にセミコロンで区切って複数のキーワードを設定することができます。
  1. [次へ]ボタンをクリックします。
    [HHCTRL: Finish]ダイアログが表示されます。
  2. [完了]ボタンをクリックします。
    ダイアログが閉じ、Kリンクが設定されます。
  3. [File]→[Save File]を選択し、トピックファイルを上書き保存します。

キーワードリンクを有効にする

個々のトピックファイルに設定したキーワードは、そのままではHTML Helpに含められません。個々のトピックファイルに設定したキーワードを参照するには、プロジェクトオプションの設定を変更する必要があります。

  1. [Project]タブの アイコン(Change project options)をクリックします。
    [Options]ダイアログが表示されます。
  2. [Files]タブの[Include keywords from HTML files]にチェックを付け、[OK]ボタンをクリックします。
  3. アイコン(Save project, contents, and index files)をクリックし、設定内容をプロジェクトファイルに保存します。

キーワードを[キーワード]タブに表示する

キーワードを[キーワード]タブに表示するには、アイコン(Change project options)の[Compiler]タブの[Create a binary index]にチェックをつけます。

このオプションにチェックをつけると、索引ファイルで指定したキーワードと、各トピックファイルに挿入したキーワードの両方が、次の順に自動的に並べ替えられます。索引ファイルで指定した並び順は無視されますので、ご注意ください。ただし、キーワードの階層は残り、各階層内で並べ替えが行われます。

記号→数字→アルファベット→ひらがな/カタカナ→漢字(シフトJIS漢字コード順)

(一覧に戻る)

META要素でキーワードを設定する

Kリンクの代わりに、HTMLのMETA要素でキーワードを設定することもできます。

  1. キーワードを設定するトピックファイル(*.htm、*.html)をエディタなどで開きます。
  2. <HEAD>〜</HEAD>内に以下のように記述します。
    <META NAME="MS-HKWD" CONTENT="キーワードにする言葉">
  3. [Project]タブの アイコン(Change project options)で[Files]タブの[Include keywords from HTML files]にチェックを付けます。
  4. ヘルプをコンパイルすると、[キーワード]タブにMETA要素で設定したキーワードが表示されます。

(一覧に戻る)

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

  1. [File]→[Open]を選択し、関連トピックリンクを設定するトピックファイル(*.htm、*.html)を開きます。
  2. アイコン(HTML Help ActiveX Control)をクリックします。
    [HHCTRL: Command and ID]ダイアログが表示されます。
  3. コンボボックスで[Related Topics]を選択し、[次へ]ボタンをクリックします。
    [HHCTRL: Display Type]ダイアログが表示されます。
  4. [As a button]を選択し、[次へ]ボタンをクリックします。
    [HHCTRL: Button Options]ダイアログが表示されます。
  5. Aリンクの場合と同様に、ボタンの表示内容を選択し、ボタンに表示される文字またはイメージ/アイコンファイル名を指定します。
  6. [次へ]ボタンをクリックします。
    [HHCTRL: Related Topics]ダイアログが表示されます。
  7. [Add]ボタンをクリックします。
    [Add/Edit Related Topic]ダイアログが表示されます。
  8. [Title]に、ポップメニューやダイアログに表示されるタイトルを入力します。
    ファイルのタイトル以外の任意の文字列を指定できます。
  9. [File/URL]に、トピックファイルのURLまたはパス名を入力します。
  10. [Alternate URL]に、[File/URL]で指定したURL/パス名にアクセスできない場合の代替のURL/パス名を入力します。(代替がない場合は入力しなくても結構です。)
  11. [OK]ボタンをクリックします。
    [HHCTRL: Related Topics]ダイアログに戻ります。
  12. 複数のトピックファイルへのジャンプを設定する場合は、手順7〜11の操作を繰り返します。
  13. [次へ]ボタンをクリックします。
    [HHCTRL: Finish]ダイアログが表示されます。
  14. [完了]ボタンをクリックします。
    ダイアログが閉じ、関連トピックリンクが設定されます。
  15. [File]→[Save File]を選択し、トピックファイルを上書き保存します。

(一覧に戻る)