31 HTML変換テンプレート

この章では、HTML (グラフィカル・ユーザー・インタフェース)テンプレートおよびDynamic Converterのテンプレート・エディタの使用方法について説明します。

この章の構成は、次のとおりです。

31.1 テンプレートについて

テンプレートは書式設定指示のセットであり、ソース・ドキュメントに関連付けることができます。ドキュメントをContent Serverにチェックインしたら、デフォルトの変換テンプレートに関連付けるか、カスタマイズされた新しいテンプレートを作成できます。

使用可能なテンプレート・オプションは次のとおりです。

HTML変換テンプレート: 最も新しいテンプレート・タイプで、クロス・プラットフォーム・エディタで構成できます。
クラシックHTML変換テンプレート: 以前は、GUIテンプレートと呼ばれていました。GUIテンプレートからHTML変換テンプレートに直接移行する方法はありません。「クラシックHTML変換テンプレート」を選択した場合は、「クラシックHTML変換レイアウト」も選択します。
スクリプト・テンプレート: デフォルト設定で実行され、テキスト・エディタで編集できます。

ドキュメントに関連付けるテンプレート・タイプを選択し、テンプレートに名前を付けたら、テンプレートを編集できます。HTML変換エディタと呼ばれるテンプレート編集ユーティリティがあり、HTML変換テンプレートを編集するために使用できます。このユーティリティを使用して、HTMLフォーマットに変換されるネイティブ・ドキュメントの外観をカスタマイズできます。このテンプレート・エディタは、作成するWebページのルック・アンド・フィールを制御するために使用します。クラシックHTML変換テンプレート・エディタはWebCenter Content 12cでは使用できません。以前のバージョンで作成されたテンプレートは引き続き使用できますが、12cでは作成や編集はできません。

ソース・ドキュメントをWebページに変換するには、変換を実行するデフォルト設定を使用します。または、HTMLテンプレートを作成してドキュメントに関連付けてから、HTML変換エディタを使用してテンプレートを編集できます。

次の項ではHTML変換エディタのタスクについて説明します。

31.1.1 新しいHTML変換テンプレートの作成

新しいHTML変換テンプレートを作成するには、「Dynamic Converterの新しいHTML変換テンプレート・フォーム」を使用します。このページにアクセスするには、「Dynamic Converterの管理」ページの「新規テンプレートの作成」をクリックします。

図31-1 新しいHTML変換テンプレート・フォーム

「図31-1 新しいHTML変換テンプレート・フォーム」の説明

注意:

コンテンツをコンテンツ・サーバーにチェックインする方法の詳細は、『Oracle Fusion Middleware Oracle WebCenter Contentの使用』を参照してください。

新しいHTML変換テンプレートを作成するには:

「Dynamic Converterの管理」ページを開きます。
「新規テンプレートの作成」をクリックします。
そのテンプレートに必要なその他すべてのメタデータを指定します。
フォームの入力の完了後、「チェックイン」をクリックし、HTML変換テンプレート・ファイルをコンテンツ・サーバーにチェックインします。

新しいHTML変換テンプレートをContent Serverにチェックインしたら、テンプレート・エディタを使用して編集できます(「既存のHTML変換テンプレートの編集」を参照)。

31.1.2 既存のHTML変換テンプレートの編集

HTML変換テンプレート・エディタは、Windows XP以降のシステムでInternet Explorerを使用する必要があります。既存の(すなわち、コンテンツ・サーバーにチェックイン済の) HTML変換テンプレートを編集する手順は次のとおりです。

「Dynamic Converterの管理」ページを開きます。
既存テンプレートの編集をクリックします。
「テンプレートの編集」ページで、コンテンツ・サーバーにあるHTML変換テンプレートのリストからテンプレートを選択します。
既知のHTML変換テンプレートが使用可能なテンプレートのリストに含まれていない場合は、Content Serverにチェックインしたときに、正しいHTML変換テンプレート・タイプに割り当てられなかったものと考えられます(「テンプレートのチェックイン」を参照)。その場合は、チェックインされているテンプレートのコンテンツ情報ページを開いて、テンプレート・タイプを更新する必要があります。

「テンプレートの編集」ボタンは、既存のテンプレートの名前を指定するまで、使用可能になりません。
「テンプレートの編集」ボタンをクリックします。HTML変換テンプレート・エディタがマシンにダウンロードされます。Firefoxなどの一部のブラウザでは、dc_hcmapedit.jnlpファイルの処理方法を確認するプロンプトが表示される場合があります。このファイルは、Java (TM) Web Start Launcher (デフォルト)を使用して開きます。
テンプレート・エディタが起動します。以前にエディタを実行したことがない場合は、まずインストールして、いくつかのプロンプトを確認する必要があります。

これで、テンプレート・エディタでHTML変換テンプレートを編集できます。

「テンプレートの選択ルール」ページから既存のHTML変換テンプレートを編集することもできます。

注意:

テンプレート・エディタには、独自の詳細なヘルプ・システムが付属しています。ヘルプは、アプリケーションのユーザー・インタフェースから呼び出すことができます。

31.2 HTML変換テンプレート・エディタの使用

この項では、HTML変換テンプレート・エディタについて説明します。詳細は、『Oracle WebCenter Content Dynamic Converterテンプレート・エディタ・ガイド』を参照してください。

HTML変換エディタを使用すると、出力のコンテンツおよび構造に影響を与える様々なオプションを設定できます。HTML Conversion EditorはJavaベースであるため、JREがインストールされている任意のブラウザ・インスタンスで実行できます。

この項の内容は、次のとおりです。

31.2.1 様々なファイル・タイプのフォーマット

HTML変換エディタの左側のナビゲーション・ペインの上部にあるアイテムを使用して、様々なファイル・タイプのカスタム書式を設定できます。各ファイル・タイプでは、デフォルト・レイアウトまたは出力ページ・レイアウトで作成されたレイアウトのどちらかが使用されます。エクスポートされるファイルでは、ルート変換と同じテンプレートが使用されます。

次に示すファイル・タイプでは、フォーマットのオプションが少しずつ異なります。

テキスト/語句の処理: 箇条書き、脚注と文末脚注、文字スタイルと埋込みグラフィックの処理、およびページ区切り設定に関するオプションを設定できます。
スプレッドシート: セクションの書式とラベルの設定、グリッド線の表示、および埋込みグラフィックのサイズ設定を実行できます。
プレゼンテーション: セクションの書式とラベルおよびスライドのサイズを設定できます。
イメージ: セクションの書式とラベルおよびイメージのサイズを設定できます。
アーカイブ: ファイル名(アーカイブ内のファイルとフォルダの名前が出力される)または解凍ファイル(エクスポートされたファイルへのリンクとしてファイル名が出力される)のどちらかを表示できます。エクスポートされたファイルでは、ルート変換と同じテンプレートが使用されます。
データベース: セクションの書式とラベルおよびページ当たりのレコード数を設定できます。

31.2.2 ドキュメント・プロパティの追加

このアイテムを使用して、定義済プロパティおよびカスタム・プロパティを追加できます。追加したプロパティに、デフォルト値、メタタグ名および出力書式を割り当てることができます。

デフォルトで、ドキュメント・プロパティは何も定義されていません。変換による出力にドキュメント・プロパティを含めるには、ここで最初にドキュメント・プロパティを定義する必要があります。これらのプロパティは、出力ページ・レイアウト・アイテムで定義されているページ・レイアウトに挿入することによって、変換からの出力に追加する必要があります。最も一般的な定義済プロパティは次のとおりです。

プライマリ作成者
タイトル
件名
キーワード
コンテンツ

他にも同数程度の事前定義済プロパティがあります。

カスタム・プロパティの場合、説明的な名前を作成し、デフォルト値、メタタグ名および出力書式を割り当てることができます。

31.2.3 テキスト要素の追加

テキスト要素を使用すると、出力に文字列を挿入できます。各テキスト要素は、テキストの書式設定に使用する出力書式をオプションとする名前と値のペアとして定義されます。

出力書式を指定しない場合、テキストは、マークアップなしで、そのまま出力に挿入されます。

31.2.4 ナビゲーション要素の追加

ナビゲーション要素を使用して、出力にナビゲーション・リンクを生成できます。ナビゲーション要素には、次の3つの種類があります。

ドキュメント・ナビゲーション: ドキュメントの構造に基づいて、ソース・ドキュメント内の様々なアイテムにリンクできます。このタイプのナビゲーションの一般的な使用例としては、アウトライン・レベル1によってマーキングされたドキュメント内のすべての段落(「Heading 1」の段落など)へのリンクの作成があります。この形態のナビゲーションを使用する前に、最初にリンク・マッピング・ルールを追加する必要があります。リンク・マッピング・ルールは、入力ドキュメントのどの部分がリンクの作成に使用されるかを決定します。
ページ・ナビゲーション: 出力の特定の重要ページ(最初のページや次のページなど)へのリンクを実現します。また、外部ページにもリンクできます。
セクション・ナビゲーション: スプレッドシートやプレゼンテーションなど、複数セクションから構成されるドキュメントへのナビゲーションを実現します。

これらのいずれかを追加すると、エディタの左側に展開レベルが表示されます。リンク、リンク・セット・マークアップおよび書式設定に関する情報を指定したり、リンク・マッピング・ルールを作成したりできます。ソース・ドキュメントの段落のアウトライン・レベルまたはスタイル名に合わせたナビゲーションが生成されるように、リンク・マッピング・ルールを使用して段落のアウトライン・レベルまたはスタイル名に一致させることができます。ルールを定義した後、「リンク・マッピング・ルール」ページに戻り、ルールの順序を決定します。マッピング・ルールは、一致する最初のルールが適用されるルールとなる順序で並べられています。

31.2.5 HTML設定の構成

次の6つの主要カテゴリを構成できます。

HTML設定: HTML DOCTYPEおよび言語文字列を設定できます。
CSSオプション: カスケーディング・スタイルシート(CSS)による書式設定を使用するかどうか、および使用する場合はCSSプレゼンテーションの方法を、指定できます。CSSはデフォルトで、各出力ファイルのHTMLに埋め込まれています。別のファイルにCSSスタイルを出力することもできます。外部のスタイルシート・オプションでは、変換で参照されるユーザー生成のスタイルを含むスタイルシートを指定できます。
文字セット: 出力ファイルで使用する文字セットを指定できます。多数の文字セットからの文字を含むソース・ドキュメントは、このオプションがUnicodeまたはUTF-8に設定されている場合のみ、最良の状態で表示されます。出力文字セットに文字が見つからない(マッピングできない)場合に使用する文字を選択することもできます。
グラフィック出力: テクノロジにより生成されるグラフィックの形式を、GIF、JPG、PNGまたはなしのいずれかで指定できます。このセクションのその他のオプションでは、グラフィック出力の質とサイズを指定できます。
リンク・オプション: ソース・ドキュメント・リンクを開くフレームまたはウィンドウをブラウザで選択する方法を指定できます。この値は、テクノロジが生成するリンクのターゲット属性に使用されます。このターゲット値は、ソース・ドキュメントに存在するそのようなすべてのリンクに適用されます。
出力書式設定: このオプションを選択すると、生成されるHTMLが一層読みやすく、魅力的な外観になるように、出力に新しい空白行が記述されます。このオプションを設定すると、生成されるマークアップをテキスト・エディタで読みやすくなりますが、ブラウザでのドキュメントのレンダリングには影響しません。また、ソース・ドキュメントのスタイル名やマップ方法に関する情報を追加でき、ユーザーがカーソルを特定の段落または一連のテキストの上に移動すると、それらにマップされている書式を確認できます。

31.2.6 出力マークアップ・アイテムの追加

マークアップ・アイテムは、ページ・レイアウトの一部として出力HTMLに直接挿入されるHTMLフラグメントです(「出力ページ・レイアウトの追加」を参照)。各マークアップ・アイテムは、名前と値のペアです。名前は、ページ・レイアウトの編集用画面に表示されるものです。値は、ページ・レイアウトにマークアップ・アイテムが表示される場合は常に出力HTMLに挿入されるHTMLのブロックです。

「追加」ボタンをクリックし、このマークアップ部分を参照するための「名前」を指定します。このHTMLを「マークアップ」テキスト・ボックスに入力します。

31.2.7 出力テキスト書式の追加

出力テキスト・フォーマットでは、出力ドキュメント・テキストのテキストおよび書式設定の属性を定義します。これにより、多数のソース・ドキュメント作成者が様々な書式設定スタイルを使用していても、出力の外観を標準化できます。テキスト書式は、ワープロ・ファイルからのテキストにのみ適用されます。変換により生成されたグラフィックの部分として表示されるテキストの書式設定を変更する場合、テキスト書式は使用できません。また、スプレッドシート内のテキストにも適用されません。

「追加」をクリックして「マークアップ」タブを表示し、この書式を参照するための「名前」を指定します。
「タグ名」に、このフォーマットを使用して段落の周りに配置するHTMLの段落レベルのタグを入力します。正しいか正しくないかに関係なく、ここにはいかなるタグ名も入力できることに注意してください。前後の山カッコ(<、>)ではなく、タグ名のみを入力する必要があります。デフォルトは段落タグ(p)です。
「カスタム属性」に、前述の「タグ名」オプションで指定した名前のタグに適用する属性を入力します。新しい属性の名前と値を設定するには、「カスタム属性」表でそれらをクリックします。
カスタム・マークアップを使用すると、この形式を使用して各段落の前後に挿入されるHTMLまたは通常のテキスト(あるいはその両方)を入力できます。
「マークアップ」タブのその他の書式設定オプションには、変換で出力されたHTMLを参照しやすくするために、HTMLの段落の前に新しい行を挿入するオプションも含まれています(出力ページ画面でHTMLソースを読みやすく書式設定オプションが設定されている場合にのみ記述されます)。また、段落にこの形式が適用されるたびに新しい出力ページを作成するオプションや、この形式が最初に出現した場合に新しいページを開始するかどうか(出力の始めに空もしくはほとんど空のページができないようにするため)のオプションもあります。
「フォーマット」タブでは、段落の書式設定を指定する方法を選択できます。「外部CSSクラスの使用:」オプションを選択すると、テキスト・フィールドが有効になるので、そこに外部CSSファイルのクラスの名前を入力する必要があります。外部CSSファイルのURLは、出力ページの外部ユーザー・スタイルシート・オプション・セットを使用して指定します。
外部スタイルシートを指定しない場合は、元のソース・ドキュメントの書式設定に従うか別の書式設定オプションを強制することで、ドキュメントを書式設定することを選択できます。様々なオプションの文字、段落および枠線の書式設定を、次の4つの値のいずれか1つに設定できます。
- 常にオフ - テキストの書式設定時に、属性を常にオフにします。
- 常にオン - テキストの書式設定時に、属性を常にオンにします。
- 継承(デフォルト) - ソース・ドキュメントから属性の状態を取得します。つまり、ソース・ドキュメントでテキストが太字でレンダリングされる場合は、太字のテキストが作成されます。
- 指定しない - 書式設定を指定しません。

31.2.8 書式マッピング・ルールの追加

テキスト書式を定義した後、出力テキストに出力テキスト書式をマップするルールを定義する必要があります。

フォーマット・マッピング・ルールを選択して、フォーマット・マッピング・ルールの追加をクリックします。
「フォーマット」ボックスで、定義済のテキスト形式の1つを選択します。
「次が一致:」ボックスで、ルールでチェックする段落書式設定オプションを次の中から1つ選択できます。
- アウトライン・レベル - ソース・ドキュメントで指定されているアウトライン・レベルに一致します。一般的に、アプリケーションに事前に定義されているヘッダーのスタイルには、スタイル定義の一部として対応するアウトライン・レベルが適用されています。
- スタイル名 - 段落または文字のスタイル名に一致します。
- 脚注 - いずれかの脚注に一致します。
- 文末脚注 - いずれかの文末脚注に一致します。
- ヘッダー - ドキュメントのいずれかのヘッダー・テキストに一致します。
- フッター - ドキュメントのいずれかのフッター・テキストに一致します。
前述の「次が一致:」が「アウトライン・レベル」に設定されている場合、「段落のアウトライン・レベル:」で一致する必要があるアウトライン・レベルを定義します。このオプションは、この他すべての一致ルールに対して設定することはできず、無視されます。
前述の「次が一致:」がスタイル名に設定されている場合、一致する必要があるソース・ドキュメントの段落または文字のスタイル名を定義します。スタイル名で一致させる場合、デフォルト値が提供されないため、ここでスタイル名を指定する必要があります。名前は、ソース・ドキュメントのスタイル名に正確に一致する必要があります。スタイル名の一致では、大/小文字が区別されます。このオプションは、この他すべての一致ルールに対して設定することはできず、無視されます。
ルールの定義を完了した後、「書式マッピング・ルール」ページに戻り、「上に移動」または「下に移動」をクリックしてルールのチェック順序を変更できます。マッピング・ルールの順序は、一致する最初のルールが適用される唯一のルールとなるように変更する必要があります。

31.2.9 出力ページ・レイアウトの追加

出力ページ・レイアウト・セクションでは、一連の出力ファイルのコンテンツを定義できます。ページ・レイアウトは、出力の様々な部分をどのように配置するかを決定するために使用します。

「追加」をクリックして、新しい出力ページ・レイアウトを追加します。次のページで、このレイアウトの参照に使用する名前を入力します(必須)。これが終了したら、エディタの左側をクリックします。入力した名前がツリー・ビューに表示されます。これをクリックして、その下のレベルを展開します。
ページ・レイアウトに指定されているドキュメント・コンテンツへのマークアップやリンクが含まれる単一のファイルを生成する場合は、ナビゲーション・レイアウトを含めるの前にあるボックスをクリックします。これにより、ユーザーが目次ページを作成できるようになります。ナビゲーション・レイアウトの下に、ナビゲーション要素を定義する必要があります。
出力ページ・レイアウトの名前の下の最初のアイテムは、「<title>ソース」です。ここで、HTMLの<title>タグに使用する値の取得場所を選択できます。「セクション名」、「テキスト要素」、「プロパティ:」または「出力テキスト書式」を選択します(最後の3つは事前定義済である必要があります)。「<title>ソース」ページに戻り、選択した順序を変更します。
「ナビゲーション・レイアウト」は、実際のドキュメント・コンテンツへのリンクのみが含まれる別ファイルの作成をトリガーします。これを生成するには、生成されたコンテンツの下に、ドキュメント・ナビゲーション、ページ・ナビゲーション、またはセクション・ナビゲーション要素のいずれかを事前に定義しておく必要があります(「ナビゲーション要素の追加」を参照)。「ナビゲーション・レイアウト」の下で開いたレベルではさらに、ナビゲーション・ページの「見出し」または「本文」、あるいはその両方に配置するマークアップ・アイテムを選択できます。
「ページ・レイアウト」セクションでは、ページ区切りオプションを設定できます。「ページ・レイアウト」の6つのオプションを使用して、出力ドキュメントの配置方法を定義できます。6つのオプションは次のとおりです。
- 見出し - 各出力ファイルのHTMLの<head>に配置されるアイテム。
- ページの先頭 - 各出力ページの一番上に配置されるアイテム。たとえば、出力の最初のページ、前のページおよび次のページへのリンクです。
- コンテンツの前 - ドキュメント・コンテンツの前に出力されるアイテム。
- セクションの前 - 複数セクションのドキュメントの各セクションの前に挿入されるアイテム。ワード・プロセッシング・ドキュメントには適用できないことに注意してください。
- コンテンツの後 - ドキュメント・コンテンツの後に出力されるアイテム。
- ページの最後 - 各出力ページの一番上に配置されるアイテム。たとえば、著作権表示などがあります。
これらの6つのオプションで表示するアイテムを選択した後、それぞれの最上位レベルをクリックして表示順序を設定します。

31.2.10 コンテンツのプレビュー

HTML変換エディタには、コンテンツをプレビューするためのオプションが2つ用意されています。どちらも、インタフェース上端の「ツール」メニューにあります。

XML構造の表示: このオプションをクリックすると、選択したテンプレート・オプションのテキストベースのXMLバージョンを表示する「XML構造ビューア」が表示されます。
プレビュー・ドキュメントの設定: このオプションをクリックし、ソース・ドキュメントのコンテンツIDを入力して「変換のプレビュー」をクリックします。ブラウザが開いて、現在のテンプレート設定が変換された出力に与える影響が表示されます。

31.2.11 テンプレートの保存

テンプレート・エディタを終了しようとすると、テンプレートを保存するXMLファイルの名前と場所の入力を要求するプロンプトが表示されます。