HTML マッピングを設定、調整する

1. ファイル > ユーティリティ > HTML 設定を選択します。HTML 設定 ダイアログが表示されます。

   図 1. HTML 設定ダイアログ
   
   

   FrameMaker では、現在のマッピングが HTML 設定 ダイアログボックス内に読み込まれるか、またはマッピングが設定されていない場合は初期設定のマッピングが使用されます。

2. マップドロップダウンリストから、マッピングする書式の種類（「文字書式」、「段落書式」、または「相互参照書式」を選択します。

3. マップ元ドロップダウンリストで FrameMaker 書式を選択しマップ先ドロップダウンリストで HTML エレメントまたはマクロを選択して、マッピングを指定します。

   ヒント: 文書内をクリックすると、調整する書式を選択できます。 クリックした書式の現在のマッピングが、HTML 設定ダイアログボックスに表示されます。

4. 次のいずれかのオプションを選択します。

   • 段落書式をマッピングするときに、変換後のテキストに段落の自動番号を含めるには、「自動番号を含める」をクリックします。（リスト内のアイテムに自動番号を含める必要はありません。）

   • 見出し（自動レベル）にマッピングするときに、この書式が検出されるたびに新しい Web ページを開始するには、「新しい Web ページを開始」をクリックします。

     長い FrameMaker 文書を複数の HTML ファイルに分割し、各 HTML ファイルを 1 つのファイルにリンクする場合に、このオプションを使用します。 指定の書式が検出されるたびに、元のファイル（親ファイル）の見出しを残したまま、その見出し書式で開始して、その書式が次に出現するまでの内容を含むサブ文書にリンクします。 この設定を使用した目次のシミュレーションについては、「目次をシミュレートするリンクを作成する」を参照してください。

   • ビュレットリストまたは番号リストのリストアイテムエレメントにマッピングするときに、アイテムのレベルの深さ（通常、アイテムのインデントの度合い）を指定するには、「リストのインデント」の値を入力します。

5. 「変更」をクリックしてマッピングを適用します。

6. 必要に応じて、手順 2 ～ 5 を繰り返します。

7. マッピングの指定が完了したら、ダイアログボックスを閉じ、HTML 形式で文書を保存します。

HTML リファレンスページ上のマッピングテーブルを編集するには、まず HTML 設定ダイアログボックスを閉じてください。 このダイアログボックスが開いていると、ページ上で表を編集しようとした場合にエラーが表示されます。

HTML では、6 つのレベルの見出しをサポートしています。 FrameMaker の段落スタイルを見出し（自動レベル）にマッピングすると、FrameMaker のすべての段落書式を見出しに変換できます。この特殊なマッピングを使用すると、見出しの相対レベルおよびファイルの最上位レベルのマッピングに基づいて、文書中の見出しが H1、H2 というようにマッピングされます。 この方法の利点は、文書が複数の HTML ファイルに分割されている場合に、各 HTML ファイルには H1 にマッピングされている見出しが必ず存在し、H1 の下に適切な見出しの階層ができることです。

例えば、FrameMaker 文書で「タイトル 1」、「タイトル 2」および「タイトル 3」という書式を使用しているとします。 この文書を HTML に変換するときに、文書を 2 つのファイルに分割して 2 つ目のファイルに「タイトル 2」と「タイトル 3」だけを含めるという場合があります。 自動レベル機能を使用すると、「タイトル 2」が最初のファイルでは H2 にマッピングされますが、2 つ目のファイルでは H1 にマッピングされます。

文書を複数の HTML ファイルに分割するときの自動レベル見出しの機能について詳しくは、 Headings リファレンスページを使用するをご覧ください。

自動レベルの方法を調整して（自動レベル機能の設定を変更して）特定の見出しのレベルにマッピングするには、FrameMaker 文書のリファレンスページにある特殊な表を編集する必要があります。 詳しくは、「HTML Mapping Table を編集する」を参照してください。

FrameMaker では、ビュレットリストは番号のない HTML リストに、番号リストは通し番号付きの HTML リストにそれぞれ自動的にマッピングされます。 このような自動マッピングを変更するには、FrameMaker 文書の HTML リファレンスページにある表を編集する必要があります （「HTML Mapping Table を編集する」を参照）。

HTML 設定ダイアログボックスで「リストのインデント」に値を入力すると、リストのレベルを指定できます。 ブラウザーでは通常、異なるレベルの見出しが、インデントの量を変えて表示されます。

「自動番号を含める」を選択すると、変換後のテキストに FrameMaker の自動番号を含めることができます。 ただし、通常、ブラウザーにはリスト用の独自のビュレット文字や番号が用意されているので、リストの変換時にこのオプションを使用する必要はほとんどありません。

次の表に、段落ベースの HTML エレメントを示します。

次の表に、文字ベースの HTML エレメントを示します。

プリントした文書にある「詳しくは、8 ページの「シンタックス」を参照してください。」などの典型的な相互参照は、ページ番号を使用しない HTML 文書では意味を失ってしまいます。この理由により、相互参照は初期設定で「See Also」という定義済みの相互参照変換マクロにマッピングされます。See Also マクロは、ページ番号ではなく段落テキストを参照するように相互参照を変更します（例：詳しくは、「シンタックス」を参照してください）。元の文書の相互参照テキストは、使用されている書式にかかわらず変換後の文書では HTML リンクになります。

See Also マクロを変更したり、独自のマクロを作成して、相互参照書式をマッピングできます。

相互参照を初めてマッピングする場合、HTML 設定ダイアログボックスのマップ先ドロップダウンリストには、See Also マクロだけが表示されます。他の変換マクロを作成すると、そのマクロもこのメニューに表示されます。 相互参照マクロの作成および編集方法については、「 HTML 変換マクロ」を参照してください。

マップ先ドロップダウンリストで次のいずれかを選択すると、See Also マクロ以外の方法で相互参照をマッピングできます。

• 「元の相互参照書式」を選択すると、相互参照のテキストが変更されずにそのまま残ります。

• 「含めない」を選択すると、相互参照のテキストが削除されます。

FrameMaker の 2 つの特殊なリファレンスページ（Headings ページと HTML ページ）にある表を編集すると、HTML 変換に関する微調整を行うことができます。 ブックを変換する場合は、「BookHeadings」と「BookHTML」がリファレンスページになります （「ブックを HTML ファイルに変換する」を参照）。 リファレンスページに関する一般的な情報については、「リファレンスページ」を参照してください。

リファレンスページの表は、HTML 形式で初めて文書を保存するとき、または、 ファイル > ユーティリティ > HTML 設定を初めて選択するときに自動的に設定されます。Headings リファレンスページには、Headings Table という表だけがあります。 HTML リファレンスページには次の表があります。

• HTML Mapping Table （「HTML Mapping Table を編集する」を参照）。

• オプションダイアログボックスでの設定内容が含まれる HTML Options Table （「グラフィック変換の指定」を参照）。

• System Macros、Cross-Reference Macros および General Macros （「HTML 変換マクロ」を参照）。

• Character Macros （「特殊文字を入力する」を参照）。

表が大きい場合、HTML リファレンスページは必要なページ分だけ続きます。

Headings リファレンスページの Headings Table は、見出しに使用するタグとその階層を示しています。

図 2. 見出しの相対的な階層を設定する Headings Table

この表を使用すると、見出しとその相対レベルのマッピングを変更できます。

見出し書式をわかりやすくするために、文書の本文ページに見出しが表示されるときと同じフォントおよびポイントサイズでテキストが表示されます。

HTML リファレンスページの HTML Mapping Table には、HTML 設定ダイアログボックスで設定したマッピング情報が表示されます （見出しのマッピング情報は、Headings Table だけでなく HTML Mapping Table にも表示されます）。 通常、このテーブルを直接編集する必要はありませんが、次のような場合にはテーブルを編集します。

• 見出しの自動レベルのマッピングを行わずに、H1 や H2 などの見出しレベルに明示的に書式をマッピングする場合 （「見出しの自動レベルマッピング」を参照）。

• 編集 > 検索・置換を使用して、多くのマッピングをすばやく、または一括して変更します。

• ビュレットリストを番号リストに、またはその反対に変更する場合

• HTML 設定ダイアログボックスで使用できない HTML エレメントを使用する場合

• テーブルの「Comments」の列に、マッピングに関する説明を記入する場合

Mapping Table の最初の列に表示されている、FrameMaker のソースアイテムの先頭に付いている英字は、アイテムの種類を示しています。「P」は段落スタイル、「C」は文字スタイル、「X」は相互参照書式を示しています。2 列目には HTML エレメント名または HTML 変換マクロ名が表示されています。

図 3. HTML リファレンスページの HTML Mapping Table

マクロの定義方法については、「HTML 変換マクロ」を参照してください。

1. 表示 > リファレンスページ を選択し、HTML ページを表示します。

2. 表示されたページで Mapping Table を見つけて、マッピングを変更する書式を確認します。

3. 必要に応じて、次の変更を加えます。

   • 「Element」の列に、書式をマッピングする HTML エレメントまたは変換マクロの名前を入力します。正確な HTML エレメント名がわからない場合は、「 リストのマッピング」に記載されている表を参照してください。 自動レベルの見出しにマッピングする場合は、「H*」と入力します。

   • 該当の書式が検出された場合に別の HTML 文書を作成するには、「New Web Page?」の列に「Y」と入力します。 それ以外の場合は、No を表す「N」」と入力します。

   • 変換時に、該当の書式の完全な自動番号テキストが含まれるようにするには、、「Include Auto#」の列に、「Y」または「Yes」と入力します。それ以外の場合は、「N」または「No」と入力します。

   • 「Comments」の列に、マッピングの用途や例外などに関する説明を入力します。この列は、空白でも構いません。

   編集後の行は、次のようになります。

   FrameMaker ソースアイテム	HTML エレメント	新規 Web ページ	自動番号の挿入	コメント
   P:Fnote	「FOOTNOTE」	N	N	一部のブラウザーでは機能しません。

FrameMaker の文字セットは、HTML および Web で使用される文字セットとは異なります。 そのため、HTML への変換時に一部の文字は置換文字にマッピングされます。 一部のマッピングは、エンティティと呼ばれる特殊な HTML コードに基づいて内部的に実行されます （例えば、曲線引用符は、直線引用符のエンティティに変更されます）。 その他の置換については、Character Macros テーブルで指定します。 例えば、em ダッシュが 2 個のハイフンに置換されるよう指定します。 マッピングが存在しない場合、文字は無視されます。

次の表に示す文字には、特殊なマッピングが既に定義されているか、特殊な処理が実行されます。

Character Macros テーブルのエントリを追加または編集すると、文字のマッピングを追加または変更できます。 前の表で示しているように、テキストまたは HTML 文字参照やエンティティ参照（先頭がアンパサンドで最後がセミコロン）に文字をマッピングできます。

1. 表示 > リファレンスページ を選択し、HTML ページの Character Macros テーブルを表示します。

2. マッピングを編集するか、新しい行を作成して（Ctrl + Return キー）、新しいマッピングを入力します。

最初の列での特殊文字の入力方法が不明な場合は、各キーストロークを参照してください。

例えば、ダガー文字、商標記号および ae 合字のマッピングを設定するには、次の行を追加します。