構造化アプリケーションの概要

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

1. タイトル

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

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

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

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

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

• EDD 全体を自分で作成する。

• DTD やスキーマを取り込んで、構造定義を含むEDDを作成する。

• 変換規則表を使って既存のサンプル文書を構造化する。 それから、非構造化テンプレートに一致する基本的なエレメント定義および書式を含む、EDD の最初のドラフトを作成します。

• FrameMaker に付属するサンプルの 1 つである既存の EDD を変更するか、別のソースから提供された EDD を FrameMaker で変更します。

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

1. 構造化 FrameMaker を開いていることを確認します。 非構造化 FrameMaker から構造化 FrameMaker に切り換えるには、ファイル環境設定 > 一般を選択します。 「製品のインターフェイス」ポップアップメニューから、「構造化 FrameMaker」を選択します。 FrameMaker を閉じて再起動します。

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

   注意： EDD それ自体も構造化 FrameMaker 文書です。 他の構造化文書を編集するために使う EDD も、同じガイド付き編集環境を使って作成します。

3. 構造 > 構造図を選択して、構造図ポッドを表示します。

4. トップレベルのプロポーザルエレメントを作成します。 <>構造図の中でタグブロックの右にカーソルを移動して、「Proposal」と入力します。 入力した文字は、構造図とドキュメントウィンドウの両方に表示されます。

5. エレメントカタログを開く

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

7. プロポーザルの一般的なルール。Title、ExecSummary、ProjectDescription、Cost、Schedule

   注意： エレメント名にはスペースを含めることはできません。

8. GeneralRule エレメントの兄弟として、ValidHighestLevel エレメントを挿入します。 <><>そのためには、<GeneralRule> エレメントの下をクリックしてカーソルを配置し、エレメントカタログの中の <ValidHighestLevel> エレメントをクリックし、それから、「挿入」をクリックします。

プロポーザルエレメントが完成しました。 <>今度は、<ExecSummary>、<ProjectDescription>、<Schedule>、<Cost> という各子エレメントの定義を提供する必要があります。

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

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

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

   エレメント	汎用ルール
   ProjectDescription	Title、Para+
   Cost	Title、Para+
   Schedule	Title、Para+
   タイトル	<TEXT> （「TEXT」の周りは山形かっこで囲う。)
   Para	<TEXT> （「TEXT」の周りは山形かっこで囲う。)

4. EDD ファイルを proposal_EDD.fm という名前で保存します。

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

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

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

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

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

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

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

3. プロポーザルエレメントを挿入します。 <>これで、<プロポーザル>の最初の子として必要な<タイトル>エレメントがエレメントカタログに表示されます。

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

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

5. ファイルを structured_proposal.fm という名前で保存します。

1. 構造化 FrameMaker の中で proposal_edd.fm ファイルを開きます。

2. 構造 > DTD > DTD として保存を選択します。ファイル名（proposal.dtd）とファイルを保存する場所を指定してから、「保存」をクリックします。

3. 構造化アプリケーションを使用ダイアログボックスはデフォルトの「<アプリケーションなし>」を選択したままにして、「続行」をクリックします。

4. タイプの選択ダイアログボックスで、「XML」を選択し、「OK」をクリックします。 DTD ファイルが指定した場所に書き込まれます。

また、書式および EDD 情報を含む構造化テンプレートも必要です。

1. structured_proposal.fm ファイルを開きます。

2. ファイルからすべての内容を削除します。 構造化テンプレートは空である必要があります。

3. ファイルを proposal_template.fm という名前で保存します

これで、構造化アプリケーションを設定することができます。

1. 構造 > アプリケーション定義 > アプリケーション定義を編集を選択します。このコマンドは、以下の場所から、アプリケーション定義が保存された structapps.fm ファイルを開きます。

   %appdata%\Adobe\FrameMaker\<version>\

   注意： EDD と同様、アプリケーション定義ファイルはそれ自体も構造化されています。

2. <StructuredSetup> エレメントの子として、<XMLApplication> エレメントを挿入します。

3. アプリケーション名として「Proposal」を入力します。

4. DTD エレメントを挿入し、DTD エレメントのテキストとして以下を指定します。

     $STRUCTDIR/proposal/proposal.dtd

5. Template エレメントを挿入し、Template エレメントのテキストとして以下を指定します。

     $STRUCTDIR/proposal/proposal_template.fm

6. ファイル > 上書き保存を選択して、structapps.fm ファイルを保存します。

7. 構造 > アプリケーション定義 > アプリケーション定義を読み込みを選択して、新しいアプリケーション定義で FrameMaker を更新します。

   注意： アプリケーションが正しくインストールされることを確認するために、構造 > 構造化アプリケーションを設定を選択して、構造化アプリケーションを設定ダイアログボックスを表示します。 アプリケーション定義を正しく設定できていれば、ドロップダウンリストオブジェクト内にプロポーザルが表示されます。

最後に、構造化アプリケーション定義が想定するディレクトリに、アプリケーションファイルをコピーする必要があります。

1. ファイルエクスプローラーを使用して、FrameMaker のインストールフォルダーを検索し、Structure\xml フォルダーに移動します。

2. xml フォルダーの中に、proposal フォルダーを作成します。

3. proposal フォルダーに、proposal.dtd および proposal_template.fm ファイルをコピーします。

既存の標準を利用するか、それとも、独自の構造を作成するかを決めます。

構造化アプリケーションデザイナーの使用

構造化アプリケーションデザイナーでは、グラフィックウィザードを使用して構造化アプリケーションを作成できます。

構造化アプリケーションデザイナーを起動するには、構造 > 構造化アプリケーションデザイナーをクリックします。次のように構造化アプリケーションデザイナーが表示されます。

構造化アプリケーションデザイナー

1. 新しいアプリケーションの基となるベースアプリケーションを選択します。ベースアプリケーションの新しいセットを読み込むには、「アプリケーションを読み込む」をクリックし、関係する構造化アプリケーションファイルを選択します。 選択された構造化アプリケーションファイルから、アプリケーションのリストが自動的に入力されます。

2. 必要に応じて、DTD、読み書きルールファイル、EDD、およびテンプレートファイルを、DOCTYPES の仕様とともに入力します。

3. 新しいアプリケーション名を入力します。

4. デフォルトでは、アプリケーションはアプリケーションディレクトリ内の structapps.fm ファイルに保存されます。 ファイル名を変更するには、「別名で保存」をクリックし、新しいファイル名を選択または入力します。

5. 必要に応じて、詳細設定を設定するには「詳細設定」をクリックし、適切な設定を選択します。

読み書きルールファイルを作成するには、既存の DTD に基づいて、DTD を指定し、読み書きルールセクションから「新規」をクリックします。 読み書きルールファイルメーカーが表示されます。

注意： DTD を指定しなかった場合は、空の読み書きルールファイルが作成されます。 その後で、読み書きルールファイルメーカーを使用してルールを追加できます。

• 既存の読み書きルールファイルを更新するには、ファイルを選択し、「更新」をクリックします。 読み書きルールファイルメーカーで変更を行います。

• 新しい EDD を生成するには、DTD を選択し、EDD セクションから新規をクリックします。 すべてのエレメントが EDD インターフェイスに読み込まれます。 EDD インターフェイスから、各エレメントごとに<「エレメント段落書式タグ」>を選択します。

• 「書式を取り込む」をクリックして、別の EDD から書式設定を取り込みます。

• 「保存」をクリックして変更を保存するか、「リセット」をクリックして最後に保存した状態に戻します。

• EDD を更新するには、EDD を選択し「更新」をクリックします。

• 新しいテンプレートを生成するには、対応する EDD ファイルを選択し、「テンプレート」セクションから「新規」をクリックします。

読み書きルールファイルメーカーの使用

FrameMaker には強力な読み書きルールファイルメーカーが含まれており、ルールを簡単に作成できます。 すべての設定が 1 か所に保存されており、ルールの構文を覚える必要はないため、ルールの生成が簡単に行えます。

読み書きルールファイルメーカーを起動するには、構造 > 読み書きルール > 新規読み書きルールを選択します。「ルールファイルメーカーを起動」オプションを選択し、「OK」をクリックします。

注意： 必要に応じて、ルールを作成するときに使用する DTD を指定できます。

次のようにルールファイルメーカーダイアログが表示されます。

ルールファイルメーカー

ルールファイルメーカーは 2 つの基本的なセクションを持っています。

• 取り込み書き出し設定：これらの設定は、読み取りと書き出しの操作に適用できます。

• 書き出し専用設定：これらの設定は取り込み書き出し設定には含まれておらず、書き出し操作に対してのみ適用できます。

取り込み書き出し設定セクションは、4 つのセクションに分かれています。

1. マークアップエレメント：指定した DTD 内にあるすべてのマークアップの編集ができます。 すべてのエレメントのリストを表示するには、値ポップダウンから「DTD から選択」を選択します。 FrameMaker はエレメントのリストを表示します。 リストから複数のエレメントを選択して「OK」をクリックし、選択したエレメントを読み書きルールファイルメーカーに挿入できます。

2. グローバル設定：すべてのエレメントにグローバルに適用される設定のリストを表示します。

3. エンティティ：DTD 内にあるすべてのエンティティのリストを表示します。

4. 詳細設定：ブックと文字マップの詳細設定が含まれています。

書き出し専用設定セクションは、3 つのセクションに分割されています。

1. FM オブジェクト：存在する FM オブジェクトのタイプをリストします。 さらに、各 FM オブジェクトカテゴリは、そのオブジェクトとしてマッピングされているマークアップをリストします。 例えば、マークアップ M1 を読み取り書き出し設定セクションの表 FM オブジェクトにマッピングした場合、書き出し専用設定セクションの表リストにマークアップ M1 が表示されます。

2. グローバル設定：すべてのエレメントにグローバルに適用される設定のリストを表示します。

3. 詳細設定：SGML、DITA、変数、および文字マップの詳細設定が含まれます。

ルールの保存時に、FrameMaker は、変更されているエレメントとルールのみを保存します（変更されているエレメントは、右のペインで値が太字でマークされています）。 デフォルト動作は保存されません。

エレメントの書式を CSS から DTD に取り込んで、様々な XML アプリケーション間で一貫した書式設定を確保できます。CSS ファイルは、XML 文書で参照するか、手動で取り込むことができます。 複数の CSS ファイルを順に取り込むと、マルチレベルの書式設定を実現できます。

エレメントのスタイルを取り込むとき、 FrameMaker は、CSS のコンテキスト情報（エレメントのプロパティまたは Selector）を維持し、適切な EDD コンテキストに取り込みます。

構造化 FrameMaker を使用して、XML で CSS の環境設定を設定することもできます。 詳しくは、『Developing Structured Applications with AdobeFrameMaker』を参照してください。

1. 構造化 FrameMaker で EDD ファイルを開きます。

2. 構造CSS > スタイルを取り込むを選択します。CSS を読み込みダイアログボックスが表示されます。

3. CSS ファイルを選択して、「開く」をクリックします。

4. EDD ファイルの構造化アプリケーションエレメントでアプリケーション名が定義されていない場合は、構造化アプリケーションを使用ダイアログボックスが表示されます。 EDD ファイルの作成に使用したアプリケーションを選択します。 「続行」をクリックします。

CSS ファイルが EDD ファイルに取り込まれます。

CSS スタイルを取り込んだ後は、エレメントの定義を EDD からテンプレートに取り込み、テンプレートを使用して XML ファイルを開くことができます。

CSS の取り込み処理に代わる方法として、CSS スタイルが既に関連付けられている XML ファイルを、FrameMaker を使用して開くことができます。 XML ファイルを開くと、FrameMaker は DTD ファイルと CSS ファイルを読み込んで一時テンプレートを生成し、それを使用して XML ファイルを開きます。

カスケーディングスタイルシート 2（CSS2）を使用するすべてのエレメントについて文書で利用可能な XML スタイル情報を、EDD ファイルに書き出すことができます。 その後、これらの CSS スタイル定義を、EDD ファイルから新しい XML ファイルに取り込むことができます。 カスケーディングスタイルシートを使用すると、文書の作成者がフォントや間隔設定などのスタイルを構造化 XML ファイルに添付できます。 CSS2 形式は、W3C の標準です。

「CSS2 を生成」コマンドを選択すると、ソース文書と関連付けられている EDD で使用可能な書式情報に基づいて、整形式の構造化文書のスタイルが生成されます。 FrameMaker は、エレメントレベルのみのスタイル情報を書き出します。 例えば、Text エレメント内の特定の単語にスタイルを適用している場合、そのスタイルのインスタンスは書き出されません。

CSS2 の環境設定は、XML アプリケーションで設定できます。例えば、XML への書き出しを行うときに、CSS2 ファイルを自動的に生成するかどうかを指定することができます。 詳しくは、オンラインマニュアル AdobeFrameMakerでの構造化アプリケーションの開発』を参照してください。

1. 構造化 FrameMaker で関連付けられている EDD を使用して、テンプレートまたは文書を開きます。

2. 構造 > CSS2 を生成を選択します。

スキーマファイルを参照する XML 文書を取り込むことや、XML への書き出しの際に文書の検証に使用するために、構造化アプリケーションでスキーマファイルを指定することができます。

1. 特定の XML 文書用には、スキーマに対象の名前空間が含まれているかどうかによって、@noNamespaceSchemaLocation または @schemaLocation のいずれかの属性を使用して、XML 内にスキーマファイルのパスを指定します。

2. スキーマファイルを指定して XML の書き出しに使用するには、structapps.fm ファイルを修正します。 <Schema> エレメントを <XMLApplication> の一部として使用して、書き出し用のスキーマファイルのパスを提供します。

3. 構造化アプリケーションを使用して、XML をフレームで開き、編集します。

4. 構造化アプリケーションを使用して、XML を保存します。 <structapps.fm> ファイルの Schema エレメントがファイルに出力され、そのファイルに対して検証が実行されます。

このワークフローで、DTD が一時ファイルとしてスキーマから XML 文書に自動的に生成されますが、このファイルは修正しないでください。 スキーマからエレメントカタログ（EDD）を生成する

<XmlApplication> エレメントの子エレメントである、新しいエレメント、<Schema> は、スキーマファイルのパスを structapps.fm 構造化アプリケーションファイルで指定します。 インスタンス文書で名前空間が使用される場合、<XmlApplication> のプロパティ、<Namespace> を true に設定する必要があります。

<><>

スキーマ定義から EDD を作成するか、スキーマ定義からエレメントを既存の EDD に取り込むことができます。 FrameMaker では、最初にスキーマ定義が DTD に変換され、その次にエレメントが作成されたり、EDD に取り込まれたりします。

構造 > スキーマメニューの次のコマンドを使用します。

• スキーマを開く： このコマンドにより、特定のスキーマが DTD に変換され、DTD から EDD が作成されます。

各コマンドでは、スキーマファイルを指定できるファイルを選択ダイアログボックスが開かれ、その次に、生成される DTD ファイルの保存場所を指定できる保存ダイアログボックスが開かれます。

1. 構造化 FrameMaker で、構造 > スキーマ > スキーマを開くをクリックします。

2. スキーマファイルを選択します。

3. 出力する DTD のパスを選択します。

4. 生成された DTD を確認し、必要であれば修正を行います。

5. 『Structure Application Developer Reference ガイド』（英語のみ）に記載されている手順で、生成された DTD から EDD を作成します。

6. この EDD を使用して、構造化アプリケーションに含めることができるテンプレートを作成します。

7. 入力 XML で DTD パスとスキーマの場所を提供します。 これにより、FrameMaker でテンプレートが正しく使用できるようになります。 入力および出力 XML の検証は、スキーマに対して引き続き実行されます。

XML 名前空間とは、1 つの XML 文書内で特定のエレメントタイプや属性名を示す名前の集合です。 名前空間の有効範囲は、その名前空間が含まれている文書を超えて拡大します。

1 つの XML 文書には、複数のソフトウェアアプリケーションで使用可能なエレメントや属性が含まれている場合があるので、名前空間を使用して、それぞれのアプリケーションで使用するエレメントや属性を区別することができます。 XML を処理するソフトウェアアプリケーションでは、名前空間を使用して、どのタグや属性を処理するのかを認識します。

XML 名前空間の名前は、名前空間の接頭辞部分とローカル部分をコロンで区切った修飾名として指定します。 接頭辞は、Uniform Resource Identifier（URI）の参照にマップされ、名前空間を選択します。 世界共通で管理されている URI 名前空間と、文書独自の名前空間の組み合わせによって、世界中で一意の識別子を作成します。