第１章　HTMLヘルプを作ろう

また、HTMLヘルプはアプリケーションのヘルプとしてだけではなく、それ自体で いろいろ便利な使い方もできます。

左の図は、このHPのHTMLファイルから作ったもっとも原始的な HTMLヘルプです。このヘルプは３つの部分より構成されています。 ツールバーと、左のナビゲーションペイン、右のトピックペインです。

左の図ではナビゲーションペインに「目次」「キーワード」タブしかありませんが 「検索」と「お気に入り」タブがつくこともあります。

作り方は簡単です。まず、前準備ですが

１．HTMLヘルプワークショップを手に入れ、インストールする
２．ヘルプにしたい内容をHTML文書にしておく

２．についてはここでは特に解説はしません。HTMLについて解説したサイトや参考書を 参照してください。タグがわからない人はフロントページなどのアプリケーションを利用すれば すぐに作ることができます。ちなみに筆者は全部メモ帳で作っています。

HTML(含DHTML等)でできることはほとんどHTMLヘルプで実現できます。ただクッキーの 発行はできないみたいです。

１．HTMLヘルプワークショップを起動する
２．メニューの「File」「New」で「Project」を選択します。
３．New Projectウィザードが出ますので、Convert WinHelp projectに
　　チェックを付けずに「次へ」をクリックします。
４．プロジェクトファイルの名前を付けます。
　　(Browseを押してディレクトリを指定します。)
５．次も何もチェックを付けずに「次へ」ボタンを押します。
６．「完了」ボタンを押します。

ここまでの段階で、ワークショップの「Project」タブが 左の図のようになっていれば成功です。 ここでは、test.hhpというプロジェクトファイルを作成しました。

次に「Contents」タグをクリックします。

１．「Table of Contents Not Specified」というダイアログボックスが
　　出てきますので、「Create a new contents file」にチェックを付けます。
２．コンテンツファイルの名前を付けます。(hhpと同じ名前にしておくと便利です)

「Project」タブを押してContents file=***.hhcという記述が増えていることを 確認してください。

次に「Project」タブの左についているボタンを見てください。

上から順に
Change project options

Add/Remove topic files
Add/Modify window definitions
HtmlHelp API Informations

View HTML source

Save project, contents, and index files
Save all files and conpile

の順番で並んでいます。

１．Add/Remove topic filesボタンを押します。
２．「Topic Files」ダイアログが出てきますので、「Add」ボタンを押します。
３．ヘルプに加えるHTMLファイルを選択します。

次に「Contents」タブをクリックします。

ここのタブの上から２番目のボタン(フォルダのアイコン、Insert a heading)を押します。

１．Insert a headingボタンを押すと「Table of Contents Entry」ダイアログが
　　出てくるのでEntry tytleに名前を付けます。
２．このボタンを押したときにHTMLを表示しないのであればすぐにOKボタンを押します。

このエントリーより下位にさらにエントリーを作りたい場合はもう一度Insert a headingボタン を押します。すると、このエントリーを一番最初に置くかという質問が出てくるので 「はい」または「いいえ」で答えます。ここでは、「猫でもわかるプログラミング」エントリーの 下に「C言語編」というエントリーを作りたいので「いいえ」と答えます。

再度「Table of Contents Entry」ダイアログが出てくるのでエントリータイトルを入力します。 ここでは、HTMLファイルを表示したいのでAddボタンを押して、HTMLファイルを選択します。

さて、この状態では「猫でもわかるプログラミング」「C言語編」が同レベルのエントリーとなっていますので 「C言語編」を選択しておいて「Move Selection Right」ボタン(右矢印)を押します。

今の段階で左の図のようになっていれば成功です。

あとは、このエントリー(C言語編)にInsert a pageボタン(上から３番目)を押してページを 加えていきます。この時出てくるダイアログはTable of Contents Entryですので同様に作業を 進めます。

ここまでの作業で左の図のようになっていれば成功です。

次に「Index」タブをクリックしてください。すると Index Not Specifiedダイアログが出てくるので、Create a new index fileにチェックを付けて OKボタンを押してください。インデックスファイルの名前を付けます。 ここもhhpやhhcと同じ名前にしておくと混乱を防ぐことができます。

次に、Indexタブの所ではキーワードを指定することになりますが、現在の所 まだ何も指定しないでおきます。

次にProjectタブに戻って一番下のボタン(Save all files and compile)を押してみましょう。

とりあえず、最初の図のようなHTMLヘルプができているはずです。

テストランするには ツールバーのView compiled file(メガネ)のボタンを押します。

今回はとりあえずもっと原始的なHTMLヘルプを作ってみました。hhp, hhc, hhkファイルは テキストファイルなのでメモ帳などで中身がどうなっているか確かめてみてください。