用語集
Standard Generalized Markup Language (SGML)
情報の交換方法の確立を目的とする国際規格(ISO 8879: 1986)です。SGML は、情報の構造の指定をマークアップによって行い、内容とは別に表示や書式を規定します。DocBook マークアップ言語は、この SGML 規格に準拠しています。
Tagged Image File Format (TIFF)
標準のグラフィック・ファイル書式です。ヘルプ・システムのダイアログ・ボックスは TIFF 5.0 イメージをサポートしています。TIFF イメージは、ファイル拡張子 .tif で識別できます。
Xウィンドウ・ダンプ
Xウィンドウ・システムのディスプレイから取り込んだイメージです。ウィンドウ・イメージの取り込みには xwd ユーティリティを使用します。Xウィンドウのダンプ・イメージ・ファイルは、ファイル名拡張子 .xwd で識別できます。
Xピックスマップ
マルチカラー・イメージです。ピックスマップ・イメージ・ファイルは、ファイル名拡張子 .pm で識別できます。
Xビットマップ
ファアグラウンド・カラーとバックグラウンド・カラーから成る2色イメーシです。ビットマップ・イメージ・ファイルは、ファイル名拡張子 .bm で識別できます。
アプリケーション定義リンク
あるアプリケーションの動作を呼び出すために特別に設計されたハイパーリンクです。動作を呼び出すには、ヘルプはアプリケーションで作成したダイアログに表示されなければなりません。(アプリケーション定義のハイパーリンクは、ヘルプ・ビューでは無視されます。)
アプリケーション・ヘルプ
特定のアプリケーション(ソフトウェア)のためのオンライン・ヘルプです。
一般ヘルプ・ダイアログ・ボックス
ヘルプ情報が表示されるウィンドウです。一般ヘルプ・ダイアログ・ボックスには、メニュー・バー、トピック・ツリー(トピックのリストを表示します)、およびヘルプ・トピック表示領域があります。「簡易ヘルプ・ダイアログ・ボックス」も参照してください。
インライン・グラフィック
1行のテキスト内に表示される小さなグラフィック(イラスト)です。
ウィジェット
グラフィカル・ユーザ・インタフェースの基本的な構成ブロックです。Motif ウィジェット・セットは、アプリケーション・ユーザ・インタフェースの構築に適したすべての種類のウィジェットを提供します。
エンティティ
名前の付いているテキスト文字列またはファイルです。ほとんどのエンティティは(<!Entity> 要素を使用して)設計者が名付けますが、あらかじめ定義されているものもあります。「エンティティの宣言」と「エンティティの参照」も参照してください。
エンティテイの参照
前に & (アンパサンド)、後に ; (セミコロン) が付いているエンティティ名を使用して、エンティティ名を記述した場所に、そのエンティティ名を挿入するように、DocBook に指示することです。エンティティとエンティティの宣言も参照してください。
エンティティの宣言
エンティティ名とその値を確立するマークアップです。エンティティとエンティティの参照も参照してください。
エントリ・ポイント
ヘルプを要求すると、直接表示されるヘルプ・ボリュームにあるポイントです。つまり、ユーザが「入力」するトピックの場所またはオンライン・ヘルプを読み始める場所です。IDをもつあらゆるトピックまたはトピック内の場所が、エントリ・ポイントになります。
簡易ヘルプ・ダイアログ・ボックス
ヘルプ・トピック表示領域とひとつ以上のボタンを備えた簡素化したヘルプ・ダイアログ・ボックスです。その他の機能を提供する一般ヘルプ・ダイアログ・ボックスも参照してください。
強調表示
テキスト上で注意を促す要素です(通常はイタリック文字です。)
クローズ・コールバック
ヘルプ・ダイアログ・ボックスを閉じたときに呼び出されるアプリケーション機能です。
警告 (warning)
発生する可能性がある損害や回復不可能なデータ損失をユーザに警告する情報です。注意 (caution)と注 (note)も参照してください。
コンテキスト・ヘルプ
ユーザがアプリケーションで行う作業に関するオンライン情報です。ヘルプ・トピックの選択は、ユーザのコンテキストに基づいて行われるため、[F1]キーを押すと「コンテキスト・ヘルプ」が表示される場合もあります。
索引
ヘルプ・ボリューム中に現われる重要な語句のリストです。索引では語句がアルファベット順になっており、知りたい項目についてのヘルプを検索できます。ユーザが(一般ヘルプ・ダイアログ・ボックスの)[索引]ボタンを選択すると、ヘルプ・システムは索引を表示します。「索引検索ダイアログ・ボックス」を参照してください。
索引検索ダイアログ・ボックス
ヘルプ・ボリュームの索引エントリのリストを表示するダイアログ・ボックスです。現在のボリューム、選択したボリューム、すべてのヘルプ・ボリュームの索引を表示することができます。ユーザが索引で単語や語句または関連するトピックを検索して、その検索文字列を含む項目の一覧を表示させることができます。
索引ボリューム
デスクトップは、システムにインストールされたヘルプをリストする特別な索引ボリュームを表示することにより、ヘルプ・ビュー・プログラムを「ヘルプ・ブラウザ」として使用します。dthelpgen と呼ばれるユーティリティは、このボリュームをユーザのホーム・ディレクトリに作成します。
索引ボリューム選択ダイアログ・ボックス
ユーザのシステムで使用可能なヘルプ・ボリュームの一覧を表示するダイアログ・ボックスです。ユーザが、索引検索ダイアログ・ボックスで[選択]を選択すると、このダイアログは、ユーザが選択できるヘルプ・ボリュームの一覧を表示します。ひとつまたは複数のボリューム名を選択することができ、関連する索引情報が索引検索ダイアログ・ボックスに表示されます。
実行時ヘルプ・ファイル
dtdocbook コマンドで生成されるファイルです。これらのファイルは、ヘルプ・システムを使用するユーザに配布されます。
実行別名
実行リンクが実行するコマンド文字列またはスクリプトへ名前を割り当てるリソースです。
実行ポリシー
ヘルプ・システムが提供するリソースで、実行リンクの動作を制御するときに設定することができます。システム管理者またはユーザが、指定されたアプリケーションに対して、適切なセキュリティ・レベルを確立できるようにします。
実行リンク
シェル・コマンドまたはシェル・スクリプトを実行するハイパーリンクです。DocBook では、OLink 要素がこの機能があります。
自動ヘルプ
特定の条件またはエラーが生じると、システムがヘルプを表示します。「システム起動」ヘルプと呼ばれることもあります。たとえば、エラー・ダイアログは「自動ヘルプ」の形式です。「半自動ヘルプ」と「手動ヘルプ」も参照してくだざい。
手動ヘルプ
どんなヘルプが必要か、どうすればそれが得られるかを、ユーザがわかっていなければ使用できないオンライン・ヘルプです。たとえば[ヘルプ]メニューのコマンドの大半は、いつ何を表示するかをユーザが選択するので、「手動」ヘルプです。自動ヘルプと半自動ヘルプも参照してください。
新規ウィンドウ表示ハイパーリンク
選択されると新しいダイアログ・ボックスに情報を表示するハイパーリンクです。新規ウィンドウ表示リンクは、他のボリュームへのリンクを目的としています。ユーザは、新規ウィンドウが表示されることによって「新しいコンテキスト」だとわかります。
図
ヘルプ情報で表示されるグラフィックまたはイラストです。
スタンドアロン・ヘルプ
アプリケーション・ソフトウェアとは無関係に使用されるヘルプ情報です。たとえば、コンピュータ・プログラミングの基本を説明するオンライン・ヘルプは、特定のアプリケーションに関連付けられてはいません。スタンドアロン・ヘルプ・ボリュームは、dthelpview コマンドを使用して表示することができます。
正規マークアップ
DocBook 2.2.1 文書型定義 (DTD) において規定されるタグのセットおよび適合使用規則です。DTD で設定された規則にしたがうことによって、設計者は SGML (Standard Generalized Markup Language) に準拠したヘルプ・ソース・ファイルを作成することができます。
ダイアログ・キャッシュ
作成されても使用されていないヘルプ・ダイアログのリストです。アプリケーションは、新しいヘルプ・ダイアログを必要とする場合、まずダイアログ・キャッシュに未使用のダイアログがないかどうか検索します。みつかればそれを使用し、みつからない場合は、すべてのダイアログが使用中ということであり、新しいダイアログを作成します。
タグ
要素の開始と終了をマークするテキスト文字列です。開始タグは、< (左三角括弧)、それに続く特別な文字列(文字のみを含みます)、オプションの属性と値、および終了を示す > (右三角括弧) から成ります。
終了タグは、< (左三角括弧)、/ (順スラッシュ)、同じ特別な文字列、および > (右三角括弧) から成ります。
注 (note)
ユーザに注意してほしい重要な情報であることを示します。情報の内容が特に重大な場合は、代わりに注意 (caution) や警告 (warning) が使われます。注意 (caution)と警告 (warning)も参照してください。
注意
データが失われるおそれがあることをユーザに知らせる警告です。注と警告も参照してください。
登録
ヘルプ・ボリュームが、ブラウズや他のボリュームへのリンクに関して、にアクセス可能であることを宣言する過程です。
トピック
特定の主題に関する情報です。通常、これは約1画面分の情報です。オンライン・ヘルプのトピックは、ハイパーリンクによって互いにリンクされています。
トピック階層
ホーム・トピックが(ハイパーリンクによって)だんだん詳細なトピックに分岐していく、ヘルプ・ボリュームの分岐構造です。ホーム・トピックも参照してください。
トピック・ツリー
一般ヘルプ・ダイアログ・ボックスで、ヘルプ情報を表示するために選択できるトピックのリストです。
パーサ
DocBook ソフトウェアの一部であり、(設計者が作成した)ソース・ファイルを読み取り、ヘルプ・システム・ダイアログが読み取れる実行時のヘルプ・ファイルに変換します。設計者がマークアップを不正確に(または不完全に)使用した場合、パーサは障害を検出して「パーサ・エラー」の発生を通知します。
ハイパーリンク
テキスト(単語または語句)のセグメント、あるいはそれに対応する動作を示すグラフィック・イメージです。もっとも典型的なハイパーリンクは、関連するトピックにつながる「ジャンプ」リンクです。ユーザがジャンプ・リンクを選択すると、関連するトピックが表示されます。また、他の動作、つまりシステム・コマンドの実行や特定のアプリケーションの呼び出しなどを起動することもできます。
ハイパーリンク・コールバック
ユーザがハイパーリンクを選択したときに呼び出されるアプリケーションの関数です。ヘルプ・ダイアログで自動的に処理されないタイプのハイパーリンクを処理します。
半自動ヘルプ
ユーザがヘルプを要求すると、システムが現在の状況に応じてどのヘルプ情報を表示するかを決定する形式のオンライン・ヘルプです。「コンテキスト・ヘルプ」([F1]キーを押します)は、半自動ヘルプの一例です。自動ヘルプと手動ヘルプを参照してください。
ヒストリ・ダイアログ・ボックス
ユーザが使用したトピックを順にリスト表示するダイアログ・ボックスです。ヒストリの順序は、ユーザが最初に使用したトピックに戻りやすくするために、逆の順序で表示することもできます。
文書型定義 DTD (Document Type Definition)
構造化(または階層)情報を作成するために使用する一連の要素の記述です。文書型定義は、各要素の構文を規定し、ドキュメントにおける要素の使用方法と使用場所を管理します。
ヘルプ・キー
通常は[F1]ファンクション・キーですが、現在のコンテキストのヘルプを要求するためのキーです。[F1]キーに代わる[ヘルプ]キーが用意されているキーボードもあります。Motif アプリケーションでは、ウィジェットにヘルプ・コールバックを追加すると、ヘルプ・キーが使用可能になります。
ヘルプ・コールバック
ユーザが[F1]キーを押したときに呼び出されるアプリケーションの関数です。
ヘルプの使い方
ヘルプ・ダイアログ・ボックスの使用方法を説明したヘルプ情報です。ヘルプ・ウィンドウを使用しているときは[F1]キーを押すことにより、または一般のヘルプ・ダイアログ・ボックスで[ヘルプ]メニューから[ヘルプの使い方]を選択することにより、この情報を取得できます。
ヘルプ・ファミリ
参照するアプリケーションが関連している一連のヘルプ・ボリュームです。
ヘルプ・ボリューム
主題に関する完全な情報です。また、マークアップ・テキストを含む一連のソース・ファイルまたは DocBook を使用することによって生成される実行時のヘルプ・ファイルのいずれかを指すこともあります。
他のボリュームへのハイパーリンク
他のヘルプ・ボリュームのトピックにジャンプするハイパーリンクです。これは、 Link 要素で入力できます。ここで Linkend 属性がリンクされる要素のIDを指定します。
<link lnkend="some-id"></link>
マニュアル・ページへのリンク
起動されると「マニュアル・ページ」を表示するハイパーリンクです。マニュアル・ページとは、システム・コマンドについてのオンラインの簡潔な説明です。マニュアル・ページ上の情報は、DocBook システムでは提供されません。
要素
本のタイトル、段落、リスト、またはトピックなど、情報の論理部分です。一部の要素のタグは、コンテキストによって仮定されますが、通常、要素の範囲はタグによってマークされます。
例表示
改行がそのまま維持され、コンピュータのフォントで表示されるテキストの本文です。一般には、コンピュータ・ファイルの一部の例です。