適切な戦略を選択し、FrameMaker で EDD を作成する方法について説明します。
EDD は、構造化文書です。 EDD の作成や編集には、構造化編集機能を使います。
EDD には、文書の構造に関するルール(Document Type Definition(DTD))と、特定のタイプに属するエレメントの書式を記述するスタイルに関するルールが両方とも格納されます。 アプリケーション開発者は、一般に、既存の DTD ファイルから EDD を作成するか、白紙の状態から EDD を作成します。 詳しくは、『構造化アプリケーション開発者リファレンス』ガイドを参照してください。
以下は、FrameMaker で構造化オーサリングを始めるための基本的な手順です。
プロポーザルテンプレートを構築する前に、既存のプロポーザルを分析してそのコンポーネントを特定します。 この分析に基づいて、内容マップを作成します。 作成されたプロポーザルサンプルは、以下のような順序になります。
タイトル
概要文書:タイトル、1 段落
企画説明:タイトル、1 つ以上の段落
コスト:タイトル、1 つ以上の段落
スケジュール:タイトル、1 つ以上の段落
EDD は以下のように様々な方法で構築することができます。
EDD 全体を自分で作成する。
DTD やスキーマを取り込んで、構造定義を含むEDDを作成する。
変換規則表を使って既存のサンプル文書を構造化する。 それから、非構造化テンプレートに一致する基本的なエレメント定義および書式を含む、EDD の最初のドラフトを作成します。
FrameMaker に付属するサンプルの 1 つである既存の EDD を変更するか、別のソースから提供された EDD を FrameMaker で変更します。
これで、内容分析に基づいた、プロポーザル EDD を作成することができます。
構造化 FrameMaker を開いていることを確認します。 非構造化フレームメーカーから構造化フレームメーカーに切り替えるには、 製品インターフェイスドロップダウンリストで、「構造化 FrameMaker」を選択します。FrameMaker を閉じて再起動します。
を選択します。EDD ファイルを作成するには、
を選択します。EDD にデフォルトエレメントが挿入されます。構造図 パネルを表示します。
を選択し、最上位の <Proposal>
エレメントを作成します。 カーソルを 構造図のタグブロックの右側に配置し、「Proposal」 に入力します。入力した文字は、 構造図 と文書ウィンドウの両方に表示されます。
エレメント カタログを開きます。
構造図構で、(追加情報が必要なことを示す)赤色のボックスの右側をクリックします。 カーソルが新しい場所に配置されたため、 エレメント カタログの内容も変更されます。エレメント カタログで「コンテナ」を選択して、「挿入」をクリックします。<Container>
エレメントと子 <GeneralRule>
エレメントが挿入されます。汎用ルールは、プロポーザルエレメントの中で可能なエレメントを指定します。 内容分析の際に、タイトル、概要文書、企画説明、コスト、スケジュールなどを特定しました。
<Proposal>
:Title、ExecSummary、ProjectDescription、Cost、Schedule
<ValidHighestLevel>
エレメントを <GeneralRule>
エレメントの兄弟として挿入します。 これを行うには、 <GeneralRule>
エレメントの下をクリックしてカーソルを配置し、 <ValidHighestLevel>
エレメントを エレメント カタログ内でをクリックし、「挿入」をクリックします。
<Proposal>
エレメントが完了します。各子エレメント( <ExecSummary >
、 <ProjectDescription>
、 <Schedule>
および <Cost>
)の定義を提供する必要があります。
構造の下部にカーソルを配置します。
エレメント カタログを使用して、エレメントブロックを挿入します。エレメントに <ExecSummary >
という名前をつけて、コンテナとし、汎用ルールとして以下を指定します。Title、Para+
手順 2 を繰り返して、残りのエレメントを定義します。 汎用ルールは、下の表の通りです。
エレメント |
汎用ルール |
---|---|
ProjectDescription |
Title、Para+ |
コスト |
Title、Para+ |
スケジュール |
Title、Para+ |
タイトル |
<TEXT> (「TEXT」の周りは山形かっこで囲う。) |
Para |
<TEXT> (「TEXT」の周りは山形かっこで囲う。) |
EDD ファイルを proposal_EDD.fm として保存します。
これで、簡単なプロポーザルに構造を提供する EDD が構築されました。 ただし、内容を入力する際には、書式は適用されません。
以下のセクションでは、書式を提供する方法、および様々なタイトルに正しいテキストを自動的に挿入する方法について説明します。 デフォルトでは、テキストには Body 段落スタイルが使用されます。
structured_proposal.fm で、 を選択し、Body と Heading 1 段落スタイルの既定の定義を変更します。例えば、フォントを変更したり、Heading1 の上に直線を配置したりします。 また、変更をわかりやすくするために、2 つのタグに固有の色を割り当てることもできます。
proposal_EDD.fm で、 <Para>
エレメント定義を変更して、書式設定ルールを含めます。<Para>
が常に Body 段落スタイルを使用するように指定するには、 <GeneralRule>
エレメントの下をクリックして <TextFormatRules>
エレメントを追加し、 <ElementPgfFormatTag>
エレメントを追加します。 「Body」と入力します( <ElementPgfFormatTag>
エレメントのテキストとして)。
<Title>
エレメントには、より複雑な書式設定ルールが必要です。 <Title>
は、概要文書や企画説明のようなセクションのタイトルを自動的に表示する必要があります。各種の見出しに表示するテキストや、 <Title>
が Heading1 段落スタイルを使用することを指定するコンテキストルールを書く必要があります。
proposal_EDD.fm で <Title>
エレメント定義を変更し、Heading1 段落スタイルを使用します。同じ <TextFormatRules>
エレメントおよび <ElementPgfFormatTag>
エレメント追加します( <Para>
エレメントを選択したときと同様に)。
次に、 <Title>
エレメントに接頭辞ルールを追加します。 接頭辞ルールは、エレメントの最初に出現する必要のあるテキストを指定します。<Title>
の位置に基づいて、表示するテキストを指定します。
TextFormatRules < の後に>
コンテナ <の子を挿入するために、>
タイトル <エレメントの中にカーソルを配置します>
。
<PrefixRules>
エレメントを挿入します。
<ContextRule>
エレメントを挿入します。<If>
エレメントおよび <Specification>
エレメントが自動的に挿入されます。<Specification>
のテキストには「ExecSummary」と入力します。
Specification エレメントの下にカーソルを配置して、Prefix エレメントを挿入します。
Prefix エレメントのテキストには、「Executive Summary」と入力します。
タイトルが必要なその他のエレメント(<ProjectDescription>
、 <Schedule>
および <Cost>
)に対して手順 3~5 を繰り返し、各接頭辞に適切なテキストを挿入します。
EDD を保存します。
エレメント定義を structured_proposal.fm ファイルに取り込み、結果をテストします。各セクションには、指定されたタイトルテキストが表示されるはずです。
EDD をテストするには、EDD を文書に取り込んで、期待する構造を作成できることを確認します。 この段階の文書には書式はありませんが、構造を確認することはできます。
空で縦長の新規文書を作成するには、 縦」をクリックします。
を選択し、「EDD と新規文書ファイルの両方が開かれていることを確認します。 新規文書から、 文書から取り込むドロップダウンリストで、 proposal_EDD.fm ファイルを選択し、「取り込み」をクリックします。
を選択します。EDD の構造定義が、空白の文書に取り込まれます。 定義が取り込まれたことを確認するために、カーソルをメインテキストフロー内に配置してから、 エレメント カタログを表示します。<Proposal>
エレメントが表示されます。
<Proposal>
エレメントを挿入します。 <Title>
エレメントは <Proposal>
の最初の子として必要になります。これは エレメント カタログで使用できます。
<Title>
エレメントを挿入します。 プロポーザル構造が完成するまで、エレメントの挿入を続けます。
ファイルを structured_proposal.fm として保存します。