<!-- $XConsortium: preface.sgm /main/12 1996/09/08 19:41:20 rws $ -->
<!-- (c) Copyright 1995 Digital Equipment Corporation. -->
<!-- (c) Copyright 1995 Hewlett-Packard Company. -->
<!-- (c) Copyright 1995 International Business Machines Corp. -->
<!-- (c) Copyright 1995 Sun Microsystems, Inc. -->
<!-- (c) Copyright 1995 Novell, Inc. -->
<!-- (c) Copyright 1995 FUJITSU LIMITED. -->
<!-- (c) Copyright 1995 Hitachi. -->
<preface id="HRDC.Pref.div.1">
<title>はじめに</title>
<para>このマニュアルでは、共通デスクトップ環境アプリケーション・ソフトウェアのオンライン・ヘルプの開発方法について説明します。ヘルプ・トピックの作成方法や、オンライン・ヘルプを Motif&trade;アプリケーションに統合する方法についても説明します。
</para>
<sect1 id="HRDC.Pref.div.2">
<title>対象読者</title>
<para>このマニュアルの対象読者は、次のとおりです。
</para>
<itemizedlist remap="Bullet1"><listitem><para>オンライン・ヘルプ情報を設計、作成、検証する設計者
</para>
</listitem><listitem><para>完全なヘルプ機能を備えたソフトウェア・アプリケーションの作成を目的としている開発者
</para>
</listitem></itemizedlist>
</sect1>
<sect1 id="HRDC.Pref.div.3">
<title>このマニュアルの構成</title>
<para>このマニュアルは４部から構成されています。第１部「概要」では、アプリケーション・ヘルプの設計段階で必要な設計者と開発者の協力と役割について述べます。第２部「設計者が行う作業」では、オンライン・ヘルプを構成し記述する設計者に必要な情報を提供します。第３部「プログラマが行う作業」では、ヘルプ・システムのアプリケーション・プログラマのツールキットを説明します。第４部「国際化対応」では、多言語環境でオンライン・ヘルプを使用する場合に、設計者とプログラマの両方に必要な情報を提供します。
</para>
<para>このマニュアルは、次の章から構成されています。</para>
<para>第１部「概要」</para>
<para><!--Original XRef content: 'Chapter&numsp;1, &ldquo;Introducing the
Help System'--><xref role="ChapNumAndTitleLead-in" linkend="HRDC.Intro.mkr.1"><emphasis
role="Lead-in"></emphasis>は、オンライン・ヘルプの作成にあたり、設計者と開発者の協力的な役割について説明します。
</para>
<para>第２部「設計者が行う作業」</para>
<para><literal><!--Literal closed to allow XRef:--></literal> <!--Original
XRef content: 'Chapter&numsp;2, &ldquo;Organizing and Writing a Help Volume'--><xref
role="ChapNumAndTitleLead-in" linkend="HRDC.OrgH.mkr.1"><emphasis role="Lead-in">
</emphasis>は、ヘルプ・ボリュームの構成に必要な要素を説明します。
</para>
<para><!--Original XRef content: 'Chapter&numsp;3, &ldquo;Writing a Help
Topic'--><xref role="ChapNumAndTitleLead-in" linkend="HRDC.WrTop.mkr.1"><emphasis
role="Lead-in"></emphasis>は、ヘルプ・システム・マークアップ言語を概説し、さまざまなタイプの情報をフォーマットするのに使用する要素の例を示します。グラフィックを入れる方法とハイパーリンクの作成についても説明します。
</para>
<para><!--Original XRef content: 'Chapter&numsp;4, &ldquo;Processing and
Displaying a Help Volume'--><xref role="ChapNumAndTitleLead-in" linkend="HRDC.CrHV.mkr.1"><emphasis
role="Lead-in"></emphasis>は、ひとつまたは複数のマークアップ・ファイルを処理して、オンライン表示を行うための実行時のファイルを生成する方法を説明します。
</para>
<para><citetitle>共通デスクトップ環境 DocBook 文書型定義ガイド</citetitle><?Pub Caret>は、アルファベット順にDocBookマークアップ言語の要素を列挙し、それらの使用方法について説明しています。
</para>
<para><!--Original XRef content: 'Chapter&numsp;6, &ldquo;Summary of Special
Character Entities'--><xref role="ChapNumAndTitleLead-in" linkend="HRDC.ChEnt.mkr.1"><emphasis
role="Lead-in"></emphasis>は、特殊文字をヘルプ・トピックのテキストに入力するのに使用する文字と、それに対応するエンティティ名のリストを示します。
</para>
<para><!--Original XRef content: 'Chapter&numsp;7, &ldquo;Command Summary'--><xref
role="ChapNumAndTitleLead-in" linkend="HRDC.CmdS.mkr.1"><emphasis role="Lead-in">
</emphasis>端末エミュレータ・ウィンドウにコマンドを入力して、ヘルプ・ボリュームを処理および表示する方法を要約します。
</para>
<para><!--Original XRef content: 'Chapter&numsp;8, &ldquo;Reading the DocBook
Document Type Definition'--><xref role="ChapNumAndTitleLead-in" linkend="HRDC.Sgml.mkr.1"><emphasis
role="Lead-in"></emphasis>は、DocBook DTD (文書型定義)の概要と、それを利用して完全に SGML (Standard Generalized Markup Language) に準拠するヘルプ・ファイルを作成する方法を説明します。
</para>
<para>第３部「プログラマが行う作業」</para>
<para><!--Original XRef content: 'Chapter&numsp;9, &ldquo;Creating and Managing
Help Dialog Boxes'--><xref role="ChapNumAndTitleLead-in" linkend="HRDC.CrDia.mkr.1"><emphasis
role="Lead-in"></emphasis>は、ヘルプ・ダイアログ・ウィジェットの概要と使い方を説明します。
</para>
<para><!--Original XRef content: 'Chapter&numsp;10, &ldquo;Responding to
Help Requests'--><xref role="ChapNumAndTitleLead-in" linkend="HRDC.HReq.mkr.1"><emphasis
role="Lead-in"></emphasis>, explains how an application provides entry points
to access different types of help.</para>
<para><!--Original XRef content: 'Chapter&numsp;11, &ldquo;Handling Events
in Help Dialogs'--><xref role="ChapNumAndTitleLead-in" linkend="HRDC.DiaEv.mkr.1"><emphasis
role="Lead-in"></emphasis>は、コールバック構造を使用して、ハイパーリンク・イベントを処理する方法を示します。
</para>
<para><!--Original XRef content: 'Chapter&numsp;12, &ldquo;Providing Help
on Help'--><xref role="ChapNumAndTitleLead-in" linkend="HRDC.H4Hlp.mkr.1"><emphasis
role="Lead-in"></emphasis>は、ユーザにヘルプ・システムの使い方を示すヘルプ・モジュールの作成方法を説明します。
</para>
<para><literal><!--Literal closed to allow XRef:--></literal> <!--Original
XRef content: 'Chapter&numsp;13, &ldquo;Preparing an Installation Package'--><xref
role="ChapNumAndTitleLead-in" linkend="HRDC.Inst.mkr.1"><emphasis role="Lead-in">
</emphasis>は、アプリケーションでオンライン・ヘルプを提供するために、インストール・パッケージに含まれているものについて説明します。
</para>
<para>第４部「国際化対応」</para>
<para><!--Original XRef content: 'Chapter&numsp;14, &ldquo;Native Language
Support'--><xref role="ChapNumAndTitleLead-in" linkend="HRDC.Lang.mkr.1"><emphasis
role="Lead-in"></emphasis>は、ヘルプ・システムで使用する言語依存ファイルを示します。
</para>
<para><emphasis role="Lead-in">用語集</emphasis>は、このマニュアルに出てくる語句とその定義のリストです。
</para>
</sect1>
<sect1 id="HRDC.Pref.div.4">
<title>関連文書</title>
<para>関連する「共通デスクトップ環境」の文書を、以下に示します。
</para>
<itemizedlist remap="Bullet1"><listitem><para><citetitle>共通デスクトップ環境 上級ユーザおよびシステム管理者ガイド
</citetitle></para>
</listitem><listitem><para><citetitle>共通デスクトップ環境 国際化対応プログラマーズ・ガイド
</citetitle></para>
</listitem><listitem><para><citetitle>CDE/Motif スタイル・ガイドおよび認証チェックリスト
</citetitle></para>
</listitem><listitem><para><citetitle>共通デスクトップ環境 ユーザーズ・ガイド</citetitle></para>
</listitem><listitem><para><citetitle>共通デスクトップ環境 DocBook 文書型定義ガイド</citetitle></para>
</listitem></itemizedlist>
<para>SGML (Standard Generalized Markup Language) の技術的な説明については、次の文書を参照してください。
</para>
<itemizedlist remap="Bullet1"><listitem><para><citetitle>The SGML Handbook</citetitle> by Charles F. Goldfarb, Oxford University Press (ISBN 0-19-853737-9).
</para>
</listitem></itemizedlist>
</sect1>
<sect1 id="HRDC.Pref.div.5">
<title>表記上の規則</title>
<para>次の表に、このマニュアルで使用する表記上の規則を示します。
</para>
<table id="HRDC.Pref.tbl.1" frame="Topbot">
<title>表記上の規則</title>
<tgroup cols="3" colsep="0" rowsep="0">
<colspec colwidth="1.21in">
<colspec colwidth="1.77in">
<colspec colwidth="3.04in">
<thead>
<row><entry align="left" valign="bottom"><para><literal>文字または記号</literal></para></entry><entry align="left" valign="bottom"><para><literal>意味</literal></para></entry><entry align="left" valign="bottom"><para><literal>使用例</literal></para></entry></row></thead>
<tbody>
<row>
<entry align="left" valign="top"><para><filename>AaBbCc123</filename></para></entry>
<entry align="left" valign="top"><para>コマンド、ファイル、ディレクトリの名前、画面の出力表示
</para></entry>
<entry align="left" valign="top"><para><filename>.login</filename>ファイルを編集します。
</para><para><command>ls -a</command>を使用してすべてのファイルをリストします。
</para><para><command>system%</command> <filename moreinfo="RefEntry">You have mail.</filename></para></entry>
</row>
<row>
<entry align="left" valign="top"><para><emphasis>AaBbCc123</emphasis></para></entry>
<entry align="left" valign="top"><para>変数を示します。</para><para>実際に使用する特定の名前または値で置き換えます。
</para></entry>
<entry align="left" valign="top"><para>ファイルを削除するには、<command>rm</command> <userinput> </userinput><symbol role="Variable">filename</symbol>を入力します。</para></entry>
</row>
<row>
<entry align="left" valign="top"><para><emphasis>AaBbCc123</emphasis></para></entry>
<entry align="left" valign="top"><para>文書名、新規の語句または用語、および強調すべき語句を示します。
</para></entry>
<entry align="left" valign="top"><para><emphasis>共通デスクトップ環境 ユーザーズ・ガイド
</emphasis><userinput></userinput>を参照してください。
これらは、<symbol role="Variable">class</symbol>オプションと呼ばれます。
これを行うには、<emphasis>rootでなければなりません</emphasis>。
</para></entry>
</row></tbody></tgroup></table>
</sect1>
</preface>
<!--fickle 1.14 mif-to-docbook 1.7 01/02/96 16:48:20-->
<?Pub *0000014819>
