EDD の作成

適切な戦略を選択し、FrameMaker で EDD を作成する方法について説明します。

EDD は、構造化文書です。 EDD の作成や編集には、構造化編集機能を使います。

EDD には、文書の構造に関するルール(Document Type Definition(DTD))と、特定のタイプに属するエレメントの書式を記述するスタイルに関するルールが両方とも格納されます。 アプリケーション開発者は、一般に、既存の DTD ファイルから EDD を作成するか、白紙の状態から EDD を作成します。 詳しくは、『構造化アプリケーション開発者リファレンス』ガイドを参照してください。

以下は、FrameMaker で構造化オーサリングを始めるための基本的な手順です。

必要条件の分析

プロポーザルテンプレートを構築する前に、既存のプロポーザルを分析してそのコンポーネントを特定します。 この分析に基づいて、内容マップを作成します。 作成されたプロポーザルサンプルは、以下のような順序になります。

  1. タイトル

  2. 概要文書:タイトル、1 段落

  3. 企画説明:タイトル、1 つ以上の段落

  4. コスト:タイトル、1 つ以上の段落

  5. スケジュール:タイトル、1 つ以上の段落

Note: この簡単なサンプルでは、正式な内容分析なしで EDD を構築することができました。 ただし、もっと大きなプロジェクトでは、内容分析が重要です。

EDD ストラテジを選択する

EDD は以下のように様々な方法で構築することができます。

プロポーザル EDD を構築する

これで、内容分析に基づいた、プロポーザル EDD を作成することができます。

  1. 構造化 FrameMaker を開いていることを確認します。 非構造化フレームメーカーから構造化フレームメーカーに切り替えるには、 ファイル > 環境設定 > 一般を選択します。製品インターフェイスドロップダウンリストで、「構造化 FrameMaker」を選択します。FrameMaker を閉じて再起動します。

  2. EDD ファイルを作成するには、 構造 > EDD > 新規 EDD を選択します。EDD にデフォルトエレメントが挿入されます。

    Note: EDD それ自体も構造化 FrameMaker 文書です。 他の構造化文書を編集するために使う EDD も、同じガイド付き編集環境を使って作成します。
  3. 構造 > 構造図 を選択し、 構造図 パネルを表示します。

  4. 最上位の <Proposal> エレメントを作成します。 カーソルを 構造図のタグブロックの右側に配置し、「Proposal」 に入力します。入力した文字は、 構造図 と文書ウィンドウの両方に表示されます。

  5. エレメント カタログを開きます。

  6. 構造図構で、(追加情報が必要なことを示す)赤色のボックスの右側をクリックします。 カーソルが新しい場所に配置されたため、 エレメント カタログの内容も変更されます。エレメント カタログで「コンテナ」を選択して、「挿入」をクリックします。<Container> エレメントと子 <GeneralRule> エレメントが挿入されます。汎用ルールは、プロポーザルエレメントの中で可能なエレメントを指定します。 内容分析の際に、タイトル、概要文書、企画説明、コスト、スケジュールなどを特定しました。

  7. <Proposal>Title、ExecSummary、ProjectDescription、Cost、Schedule

    Note: エレメント名にはスペースを含めることはできません。
  8. <ValidHighestLevel> エレメントを <GeneralRule> エレメントの兄弟として挿入します。 これを行うには、 <GeneralRule> エレメントの下をクリックしてカーソルを配置し、 <ValidHighestLevel> エレメントを エレメント カタログ内でをクリックし、「挿入」をクリックします。

<Proposal> エレメントが完了します。各子エレメント( <ExecSummary ><ProjectDescription><Schedule> および <Cost>)の定義を提供する必要があります。

子エレメントの定義

  1. 構造の下部にカーソルを配置します。

  2. エレメント カタログを使用して、エレメントブロックを挿入します。エレメントに <ExecSummary > という名前をつけて、コンテナとし、汎用ルールとして以下を指定します。Title、Para+

  3. 手順 2 を繰り返して、残りのエレメントを定義します。 汎用ルールは、下の表の通りです。

    エレメント

    汎用ルール

    ProjectDescription

    Title、Para+

    コスト

    Title、Para+

    スケジュール

    Title、Para+

    タイトル

    <TEXT>

    (「TEXT」の周りは山形かっこで囲う。)

    Para

    <TEXT>

    (「TEXT」の周りは山形かっこで囲う。)

  4. EDD ファイルを proposal_EDD.fm として保存します。

EDD に書式設定を追加

これで、簡単なプロポーザルに構造を提供する EDD が構築されました。 ただし、内容を入力する際には、書式は適用されません。

以下のセクションでは、書式を提供する方法、および様々なタイトルに正しいテキストを自動的に挿入する方法について説明します。 デフォルトでは、テキストには Body 段落スタイルが使用されます。

Body エレメントの定義を変更

  1. structured_proposal.fm で、 書式 > 段落 > 段落書式 を選択し、BodyHeading 1 段落スタイルの既定の定義を変更します。例えば、フォントを変更したり、Heading1 の上に直線を配置したりします。 また、変更をわかりやすくするために、2 つのタグに固有の色を割り当てることもできます。

  2. proposal_EDD.fm で、 <Para> エレメント定義を変更して、書式設定ルールを含めます。<Para> が常に Body 段落スタイルを使用するように指定するには、 <GeneralRule> エレメントの下をクリックして <TextFormatRules> エレメントを追加し、 <ElementPgfFormatTag> エレメントを追加します。 「Body」と入力します( <ElementPgfFormatTag> エレメントのテキストとして)。

    <Title> エレメントには、より複雑な書式設定ルールが必要です。 <Title> は、概要文書や企画説明のようなセクションのタイトルを自動的に表示する必要があります。各種の見出しに表示するテキストや、 <Title>Heading1 段落スタイルを使用することを指定するコンテキストルールを書く必要があります。

  3. proposal_EDD.fm<Title> エレメント定義を変更し、Heading1 段落スタイルを使用します。同じ <TextFormatRules> エレメントおよび <ElementPgfFormatTag> エレメント追加します( <Para> エレメントを選択したときと同様に)。

    Note: 入力する情報では、段落スタイルと同じように、大文字と小文字やスペースも区別されます。 例えば、「Heading1」は「heading1」や「Heading 1」と同じではありません。

次に、 <Title> エレメントに接頭辞ルールを追加します。 接頭辞ルールは、エレメントの最初に出現する必要のあるテキストを指定します。<Title> の位置に基づいて、表示するテキストを指定します。

接頭辞ルールの追加

  1. TextFormatRules < の後に> コンテナ <の子を挿入するために、> タイトル <エレメントの中にカーソルを配置します>

  2. <PrefixRules> エレメントを挿入します。

  3. <ContextRule> エレメントを挿入します。<If> エレメントおよび <Specification> エレメントが自動的に挿入されます。<Specification> のテキストには「ExecSummary」と入力します。

  4. Specification エレメントの下にカーソルを配置して、Prefix エレメントを挿入します。

  5. Prefix エレメントのテキストには、「Executive Summary」と入力します。

  6. タイトルが必要なその他のエレメント(<ProjectDescription><Schedule> および <Cost>)に対して手順 3~5 を繰り返し、各接頭辞に適切なテキストを挿入します。

結果をテストする

  1. EDD を保存します。

  2. エレメント定義を structured_proposal.fm ファイルに取り込み、結果をテストします。各セクションには、指定されたタイトルテキストが表示されるはずです。

EDD をテストする

EDD をテストするには、EDD を文書に取り込んで、期待する構造を作成できることを確認します。 この段階の文書には書式はありませんが、構造を確認することはできます。

  1. 空で縦長の新規文書を作成するには、 ファイル > 新規/文書を選択し、「」をクリックします。

  2. EDD と新規文書ファイルの両方が開かれていることを確認します。 新規文書から、 ファイル > 取り込み > エレメント定義を選択します。文書から取り込むドロップダウンリストで、 proposal_EDD.fm ファイルを選択し、「取り込み」をクリックします。

    Note: EDD がリストに表示されていない場合には、EDD ファイルが開いていること、保存するのを忘れていないことを確認します。 保存されていない文書は、リストの中で利用できません。

    EDD の構造定義が、空白の文書に取り込まれます。 定義が取り込まれたことを確認するために、カーソルをメインテキストフロー内に配置してから、 エレメント カタログを表示します。<Proposal> エレメントが表示されます。

  3. <Proposal> エレメントを挿入します。 <Title> エレメントは <Proposal> の最初の子として必要になります。これは エレメント カタログで使用できます。

  4. <Title> エレメントを挿入します。 プロポーザル構造が完成するまで、エレメントの挿入を続けます。

    Note: 構造が間違っている場合には、EDD に戻って修正してから、エレメント定義を再度取り込みます。 アドビ システムズ社の Web サイト( www.adobe.com/go/lr_FrameMaker_support_jp)で入手できるオンラインの proposal_edd に対してご自分の EDD をチェックすることもできます。
  5. ファイルを structured_proposal.fm として保存します。