共通デスクトップ環境 プログラマーズ・ガイド (ヘルプ・システム編)

マスタ・ヘルプタグ・ファイルの作成

  1. build サブディレクトリに、名前が volume.htg のような形式になるテキスト・ファイルを作成します。この例では、ファイルは voiceact.htg です。

  2. .htg ファイルで、Commands ファイルと Metainfo ファイルの名前とエンティティ名とを関連付けるエンティティを定義します。また、Commands ファイルと Metainfo ファイルで (直接的にまたは間接的に) 使用されているエンティティも定義します。最後に、それぞれのエンティティ名で Commands ファイルと Metainfo ファイルを参照します。

この例では、voiceact.htg ファイルの内容は次のようになります。<!--...--> 内のテキストはコメントですので、無視されます。

<!-- Declare an entity for each of the source text files. -->
<!entity MetaInformation     FILE   "Metainfo">
<!entity Commands            FILE   "Commands">

<!-- Define an entity that names the product and includes
        the trademark symbol (&tm;). -->

<!entity product  "VoAc&tm; Voice-Activated Remote Control">

<!-- Include the text files. -->

&MetaInformation;
&Commands;