| Oracle® WebCenter Content Dynamic Converterテンプレート・エディタ・ガイド 12c (12.2.1) E70052-01 |
|
 前 |
 次 |
この章では、生成済コンテンツの使用について説明します。
内容は次のとおりです。
生成されたコンテンツは、2種類の要素から構成されています。
テキスト要素。これを使用すると、変換時に、テキスト文字列をテンプレートやサーバーから出力に挿入できます。
ナビゲーション要素。特定のドキュメント要素へのリンクを提供します。
テキスト要素は、HTML変換テンプレートで指定されたテキストを出力に直接挿入する方法です。テキスト要素は、ドキュメントの<head>の<meta>タグ内にテキスト要素を配置できない点を除き、カスタム・ドキュメント・プロパティとまったく同様に機能します。
デフォルトで、テキスト要素は定義されていません。変換による出力にテキスト要素を含めるには、必要なテキスト要素を最初にここで定義する必要があります。その後、出力ページ・レイアウトで定義されているページ・レイアウトにテキスト要素を挿入することにより、変換による出力に追加します。
生成済コンテンツ→テキスト要素に移動します。「追加」をクリックします。テキスト要素ページが表示されます。
テキスト要素を削除するには、定義したテキスト要素をリストから選択し、「削除」をクリックします。要素がページ・レイアウトで使用されている場合は、その要素を削除できない場合があります。
「名前」テキスト・ボックスに、ページ・レイアウトを作成または編集する際にこのテキスト要素の参照に使用する名前を入力します。このフィールドは必須です。
「値」テキスト・ボックスに、このテキスト要素をページ・レイアウトで使用する場合に出力に挿入する値を入力します。
出力書式の使用ドロップダウン・ボックスで、出力書式の名前を選択します。これは、参照可能なテキストとして値を出力に含めるときのテキスト要素のフォーマットとして使用されます。出力書式は、「出力テキスト書式」で定義します。
ナビゲーション要素を使用して、HTML出力にナビゲーション・リンクを生成できます。次の各項では、3種類のナビゲーション要素の作成方法について説明します。
ドキュメント・ナビゲーションは、ドキュメントの構造に基づいて、ソース・ドキュメント内の様々なアイテムにリンクする方法です。このタイプのナビゲーションの一般的な使用例としては、アウトライン・レベル1によってマーキングされたドキュメント内のすべての段落(「Heading 1」の段落など)へのリンクの作成があります。この形態のナビゲーションを使用する前に、最初にリンク・マッピング・ルールを追加する必要があります。これは、マッピング・ルール・タブで実行します。
生成済コンテンツ→「ナビゲーション」に移動します。ドロップダウン・ボックスで、ナビゲーション要素 . . . を選択し、次にドキュメント要素ナビゲーション、ページ・ナビゲーションまたはドキュメント・セクション・ナビゲーションのいずれかを選択します。ドキュメント要素を選択し、「追加」をクリックして、そのタイプの要素を追加します。要素ナビゲーション・ページが表示されます。
「名前」フィールドに、ページ・レイアウトがこのナビゲーション要素の参照に使用する名前を入力します。これは必須です。
「リンク・タグ」ドロップダウン・ボックスで、この要素のリンクを閉じるためにアンカーやオプション・タグ(<a>または<option>)を使用するかどうかを指定します。
「親なしのレベルが発生した場合に親レベルを生成します」を選択し、クリーンなアウトライン・レベルを生成します。変換中のドキュメントでのアウトライン・レベルの使用が緻密でない場合、アウトライン・レベルに基づいてナビゲーションを作成すると問題が発生することがあります。緻密でないアウトラインの例としては、アウトライン・レベル1というタグ付きの段落の後に、アウトライン・レベル3というタグ付きの段落があるものの、その間にアウトライン・レベル2の段落が存在しない場合があります。このアウトライン・レベル3の段落は、「親なしのレベル」であると見なされます。
このオプションを設定すると、リンク・セット(後述)の「カスタム属性」タブで指定したこのリンク・セットの前に挿入するようマークアップおよびこのリンク・セットの後に挿入するようマークアップが親なしのレベルの出力に挿入されます。デフォルトでは、このオプションは設定されません。親なしのレベルについて考慮する必要がないナビゲーションの例としては、リンク・セットで「このリンク・セットの前に挿入するようマークアップ」や「このリンク・セットの後に挿入するようマークアップ」を定義する必要がないナビゲーションがあります。
「同じページ上のターゲットへのリンクのみを含めます」を選択し、同一のHTML出力ページ上に表示される複数のターゲットに対して小さなリンク・セットを生成します。たとえば、各HTML出力ページにアウトライン・レベル1の段落が1つ作成されるようドキュメントを分割する場合などです。ユーザーはその後、ページに表示されるすべてのアウトライン・レベル2の段落に移動する1行のリンクをページ最上部に作成する手順の一部として、このオプションを設定できます。
このオプションを設定しない(デフォルト)場合、ドキュメント全体にわたるターゲットに対するリンクが生成されます。
「ラベルの語句の制限」に値を入力し、指定した単語数の後のラベルを切り捨てます。リンクのラベルは、リンク先のドキュメント要素のテキストから取得されます。ターゲット要素の中には、大量のテキストを含むものもあります。このため、リンク・リストのフォーマットで問題が発生することがあります。
このオプションをゼロに設定(デフォルト)すると、ターゲット要素のすべてのテキストがリンク・ラベルとして使用されます。
「リンク・セット」セクションで、ルールが定義可能な定義(outline level 1など)を追加します。リンク・セットを追加した後は、レベルの上/下矢印を使用してその順序を調整できます。ウィンドウに表示されるリンク・セットの順序によって、ナビゲーション階層が確立されます。リンク・セットが上または下に移動すると、それに従ってリンク・セットの名前が変更されます。たとえば、2つのリンク・セット(レベル1およびレベル2)を定義し、2つ目のリンク・セットを選択して上に移動すると、このリンク・セットがレベル1になります。
リンク・セット・セクションには次の4つのタブがあります。
「マッピング・ルール」タブによって、テンプレートの作成者は、アウトライン・レベルまたは(大/小文字を区別した)スタイル名によってナビゲーションのターゲットを定義できます。
「カスタム属性」タブでは、カスタム属性をリンクに適用できます。
「マークアップ」タブでは、リンク・セットをレンダリングするためのタグまたは他のマークアップを定義します。
「フォーマット」タブによって、テンプレートの作成者は、直接に、または外部CSSクラスを通じてリンク・ラベルにスタイルを適用できます。
マッピング・ルール・タブで、ドキュメント・コンテンツにナビゲーション用のマークを付けられます。アウトライン・レベルまたはスタイルのいずれかで一致させ、「値」フィールドに名前を指定します。
「カスタム属性」タブで、出力においてリンク・セットの前後に表示する特定のHTMLタグを入力します。「属性の追加」ボタンをクリックして、新しい名前/値のペアを挿入します。この表のいずれかの行をハイライトし、「属性の削除」ボタンをクリックしてカスタム属性を削除します。
「マークアップ」タブでは、セット内の各リンクの前後またはリンクの間(あるいはその両方)に挿入できるカスタム・マークアップを定義できます。
「書式設定」タブで、次の2つの方法のいずれかを選択して、リンクの書式設定を指定できます。
「外部CSSクラスの使用」を選択する場合は、この外部CSSファイルからのクラス名を入力する必要があります。外部CSSファイルのURLは、出力ページの「外部ユーザー・スタイルシート」オプションの設定により指定します。
「文字の書式設定」を選択すると、使用可能なタイプの文字レベルの書式設定が画面に明確に表示されます。書式設定の各種類に対して次の4つの値の1つを設定できます。
常にオフ - リンクの書式設定時に、属性を強制的に常にオフにします。
常にオン - リンクの書式設定時に、属性を強制的に常にオンにします。
これは、出力のうち、特定の主要なページ(最初のページ、次のページなど)にリンクする方法を提供します。また、外部ページ(http://www.oracle.com/など)にリンクする方法も提供します。
生成済コンテンツ→「ナビゲーション」に移動します。ドロップダウン・ボックスで、ページによるナビゲーションを選択します。「追加」をクリックして、該当のタイプの要素を追加します。「ページ・ナビゲーション」ページが表示されます。
「名前」フィールドに、ページ・レイアウトがこのナビゲーション要素の参照に使用する名前を入力します。これは必須です。
「リンク・タグ」ドロップダウン・ボックスで、この要素のリンクを閉じるためにアンカーやオプション・タグ(<a>または<option>)を使用するかどうかを指定します。
「マークアップ」タブに、このリンク・セットの前、間または後に挿入するカスタムのHTMLタグを入力します。
「書式設定」タブで、次の2つの方法のいずれかを選択して、リンクの書式設定を指定できます。
「外部CSSクラスの使用」を選択する場合は、この外部CSSファイルからのクラス名を入力する必要があります。外部CSSファイルのURLは、出力ページの「外部ユーザー・スタイルシート」オプションの設定により指定します。
「文字の書式設定」を選択すると、使用可能なタイプの文字レベルの書式設定が画面に明確に表示されます。書式設定の各種類に対して次の4つの値の1つを設定できます。
常にオフ - リンクの書式設定時に、属性を強制的に常にオフにします。
常にオン - リンクの書式設定時に、属性を強制的に常にオンにします。
「ページ・リンク」タブでは、ナビゲーション・リンクを指定して、各リンクの順序を決定できます。
これは、スプレッドシートやプレゼンテーションなど、複数セクションから構成されるドキュメントへのナビゲーションを提供します。
生成済コンテンツ→「ナビゲーション」に移動します。ドロップダウン・ボックスで、ドキュメント・セクションによるナビゲーションを選択します。「追加」をクリックして、該当のタイプの要素を追加します。「セクション・ナビゲーション」ページが表示されます。
「名前」フィールドに、ページ・レイアウトがこのナビゲーション要素の参照に使用する名前を入力します。これは必須です。
「リンク・タグ」ドロップダウン・ボックスで、この要素のリンクを閉じるためにアンカーやオプション・タグ(<a>または<option>)を使用するかどうかを指定します。
「カスタム属性」タブで、新しいタグ属性の名前/値のペアを入力します。
「マークアップ」タブでは、セット内の各リンクの前後またはリンクの間(あるいはその両方)に挿入できるカスタム・マークアップを定義できます。
「書式設定」タブで、次の2つの方法のいずれかを選択して、リンクの書式設定を指定できます。
CSSクラスの使用を選択する場合は、この外部CSSファイルからのクラス名を入力する必要があります。外部CSSファイルのURLは、出力ページの「外部ユーザー・スタイルシート」オプションの設定により指定します。
「文字の書式設定」を選択すると、使用可能なタイプの文字レベルの書式設定が画面に明確に表示されます。書式設定の各種類に対して次の4つの値の1つを設定できます。
常にオフ - リンクの書式設定時に、属性を強制的に常にオフにします。
常にオン - リンクの書式設定時に、属性を強制的に常にオンにします。
