注、注意、警告を追加するには

<note>、<caution>、<warning> の各要素は、次のように指定します。

   <note>
   Body of note here.
   <¥note> 

   <caution>
   Body of caution here.
   <¥caution> 

   <warning> 
   Body of warning here.
   <¥warning> 

注、注意、警告の各要素にアイコンを関連付けるには、そのアイコンを格納するグラフィック・ファイルが識別するファイル・エンティティを定義します。定義済みのエンティティ名を使用してください。

• <!ENTITY NoteElementDefaultIconFile FILE "filename ">

• <!ENTITY CautionElementDefaultIconFile FILE "filename">

• <!ENTITY WarningElementDefaultIconFile FILE "filename">

注、注意、警告にアイコンを付けたくない場合は、該当するエンティティを宣言しないでください。(すべてのエンティティ宣言は、ヘルプ・ボリュームの最初にあるその他のマークアップのどれよりも前に来なければならないことを忘れないでください。) そのようなエンティティの参照を指定する場合は、グラフィック・ファイルがヘルプタグ検索パス (helptag.opt) 上にあることを確認してください。

ヘルプ・システムが注、注意、警告の要素に使用するデフォルト・アイコン名は、次のエンティティで指定されます。

• <!ENTITY NoteElementDefaultIconFile FILE "noteicon.pm">

• <!ENTITY CautionElementDefaultIconFile FILE "cauticon.pm">

• <!ENTITY WarningElementDefaultIconFile FILE "warnicon.pm">

これらのデフォルト・アイコンは /usr/dt/dthelp/dthelptag/icons ディレクトリにあります。

注、注意、警告の独自のアイコン・イメージを作成する場合は、イメージが割り当てられた領域に入るように小さくしておいてください。また、グラフィック・イメージは、helptag.opt ファイルに指定されたヘルプタグ検索パス上に存在しなければなりません。

例

次の注、警告、注意のマークアップの出力は図 3-1 のとおりです。

<note>
Before installing your application, complete the options checklist 
to determine the amount of disk space required.
 <¥note>

<warning>
This product is highly acidic and can cause skin irritation. Wearing 
protective gloves is mandatory when applying this product.
 <¥warning>

<caution>
     Do not place your fingers near the parrot cage!
 <¥caution>

図 3-1 注、警告、注意のヘルプ・アイコン

関連項目

• 「実行時のヘルプ・ボリュームを作成するには」では、helptag.opt ファイルの使い方を説明しています。

• 「エンティティの使い方」