HTML 出力

HTML は、特定の種類の表現に最適なオンライン用の形式です。 例えば、HTML では 2 つのコラムのレイアウトを簡単に作成できないため、 HTML 文書の外見は元の FrameMaker 文書と必ずしも同じにはなりません。 FrameMaker 文書の書式アイテムに相当するものが HTML にない場合は、HTML ではなく PDF に変換します。 詳しくは、「 PDF 形式で保存.

HTML にマッピングするテンプレートの使用

HTML 形式で文書を保存した場合に必要となる微調整を最小限に抑えるには、FrameMaker に付属しているテンプレートを使用して文書を作成します。 これらのテンプレートの書式は、対応する HTML の書式に簡単にマッピングされます。

HTML に変換する前と後の章のテンプレートの見本

HTML は、書式設定用の言語ではなく、文書の構造（意味）を表す手段として設計されています。 ただし、文書の意味だけでなくその書式も重要で、 通常の HTML エレメントだけでは対応できない FrameMaker 文書の外観を保つ必要がある場合もあります。

例えば、章の最初の文字に青の 20 pt の書体を使用している文書があるとします。 HTML スタイルシートを使用すると、このように独特な書式設定を保持できます。

HTML カスケーディングスタイルシートは、メインの HTML ファイルと名前は同じですが、拡張子が .css になっています。これは多くの Web ブラウザーで利用、実行できる標準化ファイル形式です。 A.css スタイルシートには、元の文書のフォント、スタイル、サイズ、インデント、間隔および余白を複製できる書式設定が含まれています。

HTML ファイルには、読み込む対象の.css スタイルシートを記述した箇所があります。ブラウザーでスタイルシートが検出されると、その情報を使用して Web ページの書式が設定されます。 ブラウザーがスタイルシートをサポートしていない場合は、各 HTML エレメントに対して定義されている組み込み書式のみが使用されます。

1. 文書を HTML として保存します。 .css ファイルが HTML ファイルと同じフォルダーに自動的に作成されます。

2. HTML スタイルシート（.css ファイル）を Web サーバの HTML ファイルと同じフォルダー内にコピーします。

Uniform Resource Locator（URL）は、インターネットやイントラネット上の文書の場所を示します。 HTML または PDF として 文書を保存するときは、URL にリンクする特殊なマーカーを FrameMaker 文書に埋め込むことができます。

1. URL にリンクするテキストを選択し、文字書式を適用します。 例えば、「詳細はここをクリックしてください。」という行に下線書式を適用します。

2. 書式設定した箇所をクリックし、 挿入 > ハイパーテキスト を選択します。

3. コマンドポップアップメニューで メッセージクライアント を選択し、 シンタックステキストボックスに以下を入力します。

    message URL url_name 

   url_name はリンク先の URL です。 例えば、アドビシステムズ社のホームページにリンクする場合は、次のように入力します。

    message URL http://www.adobe.com 

4. 「新規ハイパーテキストマーカー」をクリックします。HTML、XML または PDF に文書を変換してから、書式設定したテキストをクリックすると、URL で指定された場所が表示されます。

サイズの大きいファイルを、1 つの親文書にリンクされた一連の小さい HTML サブ文書に変換できます。 その場合の親文書は、サブ文書のリンクされた目次として機能することができます。

FrameMaker 文書と Web ページでシミュレートした目次

サブ文書には、自動で順番に名前が付けられます。 例えば、「MyDoc」を HTML 形式で保存すると、親文書は 「MyDoc.html」 となり、1 つ目のサブ文書は 「MyDoc.1.html」 、2 つ目のサブ文書は 「MyDoc.2.html」 となります。ファイル名を変更するとリンクが無効になるため、変更しないでください。

サブ文書の見出しレベルの階層は、Headings 表で設定します。

1. 新規ファイルが見出しから始まるように文書のマッピングを調整します。 これを行うには、 「HTML 設定」 ダイアログ ボックスの新規開始、リンクされた Web ページ オプションを使用します。

   注意： 見出しを選択するときには、その内容が適度な量であるかどうか確認してください （ジャンプ先のページが大き過ぎて何度もスクロールが必要な場合や、ジャンプ先のページが 1 段落のみの場合は、ユーザーの混乱を招きます）。 また、リンク先の見出しの一覧では、最初の見出しの前に何らかの説明を追加するようにします。

2. リンクしたサブ文書から親文書に戻りやすいよう、EndOfSubDoc または StartOfSubDoc システムマクロを定義します。このマクロで定義したテキストまたはグラフィックは、次の例のように、リンクされた各 Web ページの最後または最初に表示されます。

   マクロ名	置換
   EndOfSubDoc	<div> <p><a href="<$parentdoc>">Return to main page</a></p> <p><a href="<$prevsubdoc>">Go to previous page</a></p> <p><a href="<$nextsubdoc>">Go to next page</a></p> </div>

3. HTML 形式でファイルまたはブックを保存します。 親文書には、リンクされた目次が含まれます。

Web ページ上の画像マップは、リンクとして定義した領域が含まれるグラフィックです。画像マップを使用すると、単純なテキストだけの場合より視覚的効果の高い Web ページへのリンクを作成できます。

FrameMaker 文書を HTML または XML に変換すると、メインテキストフローに含まれるグラフィックは、正しく設定されていれば、自動的に画像マップに変換されます。 グラフィックは、次のような場合に画像マップに変換されます。

• アンカー枠内のグラフィックの上にテキスト枠が存在し、テキスト枠内に有効なハイパーテキストマーカーがある場合。

• アンカー枠にあるグラフィックの上に長方形のリンクの行列がある場合。

HTML 形式で文書を保存すると、アンカー枠内にコピーして取り込んだグラフィックファイルは、すべて別の形式で保存されるように指定しない限り、GIF 形式に変換されます。 各グラフィックは、個別のファイルに保存されます。 アンカー枠内のテキストも GIF 形式に変換されます。

参照して取り込んだグラフィックファイルは、コピーが作成されるように指定しない限り、元の場所に残ります。 その場合、形式がチェックされて、必要に応じて変換されます（グラフィックの dpi 解像度は保持されます）。 新しいファイルは、HTML 文書と同じフォルダー内に作成されます。

1. ファイル > ユーティリティ > HTML 設定を選択します。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 変換マクロを使用する」を参照してください。

マップ先: ポップアップメニューで次のいずれかを選択すると、相互参照をマッピングできます。

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

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

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 は、見出しに使用するタグとその階層を示しています。

見出しの相対的な階層を設定する 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 変換マクロ名が表示されています。

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. マッピングを編集するか、新しい行を作成して（Control+Return キー）、新しいマッピングを入力します。

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

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

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

2. 表内のマクロを編集するか、行を作成して（Control+Return キー）、マクロ名で開始する新規マクロを入力します （HTML System Macros テーブルにはマクロを追加できず、置換テキストの編集だけが可能です）。

置換テキストには、テキスト、HTML コードおよび FrameMaker の構成要素を混在させて含めることができます。 FrameMaker では HTML のシンタックスがチェックされないので、必ず有効な HTML コードを入力してください。

HTML 変換マクロで次の構成要素を使用して、特殊なテキストを含めることができます。

構成要素は、山形かっこ（< >）で囲まれ、ドル記号（$）で開始しています。 これらの構成要素は小文字で入力します。

HTML システムマクロは、その他のマクロと異なり、再定義はできますが新規追加はできません。

特に、文書を複数の HTML ファイルに分割するときなどには、HTML システムマクロを使用すると便利です。 例えば、StartOfSubDoc マクロを定義し、すべての新しい Web ページの先頭に会社のロゴを表示したりできます。

以下の表では、最初の Web ページのことを 親 文書と呼んでいます。また、親文書にリンクされた文書のことを サブ文書 と呼んでいます。

HTML 文書のタイトルは、ウィンドウのタイトルバーに表示されます。 そのページにしおりを追加すると、HTML 文書のタイトルはしおりリストにも表示されます。 初期設定では、タイトルに <$defaulttitle> 構成要素が使用され、HTML ファイルの最初の見出しがそのファイルのタイトルとして使用されます。通常、初期設定のタイトルで十分ですが、 HTML リファレンスページのマクロ表を編集して異なるタイトルを指定することもできます。

システムマクロと汎用マクロでは、2 組の置換テキスト（コードの本文に表示するものと見出し部分に挿入するもの）を定義できます。

初期設定のタイトルを変更したり、削除して独自のタイトルを設定したりできます。