出力生成設定の指定 id181AI0B0E30
AEMガイドには、出力生成プロセスをカスタマイズするための多くの設定オプションが付属しています。 このトピックでは、出力生成プロセスの設定に役立つすべての設定とカスタマイズについて説明します。
DITA マップダッシュボードの「ベースライン」タブを設定します。 id223MD0D0YRM
マップダッシュボードで使用できる「ベースライン」タブを設定および非表示にすることができます。
The ベースラインタブを非表示 このオプションはデフォルトでは有効になっていないので、configMgr から有効にする必要があります。 Web エディターでデフォルトでこのオプションを有効にするには、次の手順を実行します。
-
Adobe Experience Manager Web コンソール設定ページを開きます。
設定ページにアクセスするデフォルトの URL は次のとおりです。
code language-http http://<server name>:<port>/system/console/configMgr
-
を検索して、 com.adobe.fmdita.config.ConfigManager バンドル。
-
を選択します。 ベースラインタブを非表示 オプション。
-
「保存」をクリックします。
note note NOTE この設定はデフォルトで無効になっており、マップダッシュボードで「ベースライン」タブを使用できます。
設定FrameMaker Publishing Server id1678G0Z0TN6
FrameMaker Publishing Server(FMPS) を使用して、DITA コンテンツの出力を生成できます。 FMPS を設定すると、FMPS でサポートされる複数の形式で出力を生成できます。
FMPS を使用するようにAEMガイドを設定するには、 com.adobe.fmdita.config.ConfigManager
バンドルを Web コンソールに追加します。
- FMPS 2019 以前:IP アドレスまたはドメイン名
- FMPS 2020:
http://<fmps_ip>:<port>
(http://192.168.1.101:7000)- FMPS 2019 以前:
http://<fmps_ip>:<port>/fmserver/v1/
- FMPS 2020:2020 年
- FMPS 2019 以前:2019 または 2017
デフォルト値:300 秒\(5 分\)
http://<server-name>:<port>/
。既存のAEM Site 内でのブレンド公開の設定 id1691I0V0MGR
DITA コンテンツを含むAEMサイトがある場合は、DITA コンテンツをサイト内の事前定義された場所に公開するようにAEM Site の出力を設定できます。 例えば、AEM Site ページの次のスクリーンショットでは、 ditacontent
ノードは DITA コンテンツの格納用に予約されています。
{width="300"}
ページに残っているノードは、AEM Site Editor から直接作成します。 DITA コンテンツを事前定義の場所に公開するように公開設定を指定すると、AEM Guides の公開プロセスで、既存の DITA 以外のコンテンツが変更されなくなります。
事前定義されたノードに DITA コンテンツを公開できるようにするには、既存のサイトで次の設定を実行する必要があります。
-
サイトのテンプレートプロパティを設定する
-
サイトにノードを追加して DITA コンテンツを公開します
次の手順を実行して、既存のサイトのテンプレートプロパティを設定します。
-
AEMにログインし、CRXDE Liteモードを開きます。
-
サイトのテンプレート設定ノードに移動します。 例えば、AEMガイドでは、次のノードにデフォルトのテンプレート設定が格納されます。
/libs/fmdita/config/templates/default
note note NOTE デフォルトの設定ファイルを libs
ノード。 オーバーレイを作成するには、libs
ノードをapps
ノードに追加し、apps
ノードのみ。 -
以下のプロパティを追加します。
table 0-row-3 1-row-3 2-row-3 プロパティ名 タイプ 値 topicContentNode
文字列 DITA コンテンツを公開するノード名を指定します。 例えば、AEMガイドが DITA コンテンツを公開するデフォルトのノードは次のようになります。 jcr:content/contentnode
topicHeadNode
文字列 DITA コンテンツのメタデータ情報を格納するノード名を指定します。 例えば、AEMガイドにメタデータ情報が格納されるデフォルトのノードは次のようになります。 jcr:content/headnode
次のスクリーンショットは、AEM Guides のデフォルトのテンプレートノードに追加されたプロパティを示しています。
{width="800"}
次回、サイトのテンプレート設定を使用して DITA コンテンツを公開する際に、そのコンテンツが topicContentNode
および topicHeadNode
プロパティ。
ただし、既存のサイトの場合は、手動で topicContentNode
および topicHeadNode
ノード。
次の手順を実行して、必要なノードを既存のサイトに追加します。
-
AEMにログインし、CRXDE Liteモードを開きます。
-
場所
jcr:content
をサイトノード内に追加します。 -
追加
topicContentNode
およびtopicHeadNode
サイトのテンプレート設定で指定したのと同じ名前のノード。
AEM Site 出力のカスタマイズ id166TG0B30WR
AEMガイドは、次の形式での出力の作成をサポートしています。
-
AEM Site
-
PDF
-
HTML5
-
EPUB
-
DITA-OT によるカスタム出力
AEM Site の出力に対して、出力タスクごとに異なるデザインテンプレートを割り当てることができます。 これらのデザインテンプレートは、異なるレイアウトで DITA コンテンツをレンダリングできます。 例えば、内部オーディエンスと外部オーディエンスに異なるデザインテンプレートを指定できます。
また、AEMガイド付きのカスタマイズ DITA Open Toolkit (DITA-OT) プラグインを使用することもできます。 これらのカスタム DITA-OT プラグインをアップロードして、特定の方法でPDF出力を生成できます。
出力を生成するためのデザインテンプレートのカスタマイズ customize_xml-add-on
AEMガイドでは、事前に定義された一連のデザインテンプレートを使用して、AEM Site 出力を生成します。 AEMガイドのデザインテンプレートをカスタマイズして、企業のブランディングに合った出力を生成できます。 デザインテンプレートは、各種スタイル(CSS)、スクリプト\(サーバー側とクライアント側の両方\)、リソース\(画像、ロゴ、その他のアセット\)、および JCR ノードの集まりで、これらすべてのリソースを結び付けます。 デザインテンプレートは、JCR ノードの数個だけを含む単一のサーバーサイドスクリプトと同じくらい簡単なものでも、スタイル、リソース、JCR ノードの複雑な組み合わせでも構いません。 デザインテンプレートは、AEM Site 出力を生成する際にAEM Guides の公開サブシステムで使用され、生成された出力の構造、ルックアンドフィールを制御します。
デザインテンプレートリソースをサーバー上のどこに配置するかに制限はありませんが、通常は、関数に従って論理的に整理されます。 例えば、デフォルトのテンプレートには、すべての JavaScript ファイルと CSS ファイルが格納されています。 /etc/designs/fmdita/clientlibs/siteoutput/default
フォルダー。 これらのファイルが配置されている場所は、JCR ノードのコレクションで相互にリンクされます。 これらの JCR ノードとファイルが共に、デザインテンプレート全体を構成します。
AEMガイドに付属しているデフォルトのデザインテンプレートを使用すると、ランディング、トピック、検索ページのコンポーネントをカスタマイズできます。 デフォルトのデザインと対応する参照テンプレートのコピーを作成し、必要な出力を生成するために、様々なコンポーネントを指定できます。
次の手順を実行して、AEM Site の出力生成に使用する独自のデザインテンプレートを指定します。
-
AEMにログインし、CRXDE Liteモードを開きます。
-
デフォルトのデザインテンプレートノードに移動します。 デフォルトのデザインテンプレートノードの場所は次のとおりです。
/libs/fmdita/config/templates/
{width="300"}
note note NOTE デフォルトのデザインテンプレートのコピーを libs
フォルダーをapps
フォルダーを作成し、apps
フォルダー。 また、デフォルトのテンプレートノードから参照されるテンプレートを変更する必要があります。 参照されるテンプレートは、の下に配置されます。/libs/fmdita/templates/default/cqtemplates
ノード。 参照先のテンプレートのコピーをapps
フォルダーに保存しておく必要があります。 -
次をクリック: デフォルト コンポーネント テンプレート ノードを使用して、そのプロパティにアクセスします。
次の表に、AEM Guides のデザインテンプレートのプロパティについて説明します。
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 11-row-2 12-row-2 13-row-2 プロパティ 説明 landingPageTemplate
、searchPageTemplate
、topicPageTemplate
、shadowPageTemplate
次を指定します。 cq:Template
ノードを使用して、これらの対応するページ(landing、search および topic)を検索できます。 デフォルトでは、cq:Template
ノードを次の場所に配置します。/libs/fmdita/templates/default/cqtemplates
ノード。 このノードは、ランディングページ、検索ページ、トピックページの構造とプロパティを定義します。
TheshadowPageTemplate
を使用して、まとまったコンテンツを最適化します。 このプロパティの値を次の値に設定する必要があります。fmdita/templates/default/cqtemplates/shadowpage
注意 次の項目の値を指定する必要があります:topicPageTemplate
. ThelandingPageTemplate
およびsearchPageTemplate
はオプションのプロパティです。 検索およびランディングページを生成しない場合は、これらのプロパティを指定しないでください。title
デザインテンプレートのわかりやすい名前。 topicContentNode
トピックページ内の DITA コンテンツを含むノードの場所。 パスはトピックページに対する相対パスです。 topicHeadNode
DITA コンテンツから派生した head 値(または metadata)を含むノードの場所。 パスはトピックページに対する相対パスです。 tocNode
目次を含むノードの場所。 パスは、ランディングページまたは宛先パスを基準とした相対パスです。 basePathProp
公開済みサイトのルートのパスを保存するためのプロパティ名。 indexPathProp
公開済みサイトのランディングページ/インデックスページのパスを保存するためのプロパティ名です。 pdfPathProp
トピックPDFの生成が有効な場合に、トピックパスを保存するためのプロパティPDF。 pdfTypeProp
PDF生成のタイプを保存するためのプロパティ名。 現在、このプロパティには常に「トピック」が含まれています。 searchPathProp
テンプレートに検索ページが含まれる場合に、検索ページのパスを保存するためのプロパティ名。 siteTitleProp
公開するサイトのタイトルを保存するためのプロパティ名。 このタイトルは、通常、パブリッシュされるマップのタイトルと同じです。 sourcePathProp
現在のページのソース DITA トピックのパスを保存するプロパティ名です。 tocPathProp
公開済みサイトの TOC ルートのパスを保存するためのプロパティ名です。
詳しくは、 最初のAdobe Experience Manager 6.3 Web サイトの作成 および 基本 AEM上で独自の web サイトを開発する
ドキュメントタイトルを使用してAEMサイト出力を生成
AEM Site 出力を生成する際、URL の生成方法は、コンテンツの検出性に重要な役割を果たします。 UUID ベースのファイル名を使用している場合、ファイルの UUID に基づいて URL を生成しても、検索でわかりにくくなります。 管理者または発行者は、AEM Site 出力の URL を生成する方法を制御できます。 AEMガイドでは、AEMサイト出力の URL を生成する際に、UUID ベースのファイル名ではなく、ファイルのタイトルを使用して設定できます。 UUID ベースのファイルシステムの場合、デフォルトでは、このオプションはオンになっています。 これは、UUID ベースのファイルシステム用にAEM Site 出力を生成する場合、ファイルの UUID ではなく、ファイルのタイトルが URL の生成に使用されることを意味しています。
AEM Site 出力を生成する際、URL の生成方法は、コンテンツの検出性に重要な役割を果たします。 非 UUID ベースのファイルシステムの場合、AEM Site の出力は、ファイルのタイトルではなくファイル名を使用して生成されます。 管理者または発行者は、AEM Site 出力の URL を生成する方法を制御できます。 AEMガイドでは、ファイル名ではなくファイルのタイトルを使用してAEM Site 出力の URL を生成する設定を提供します。 デフォルトでは、このオプションはオフになっています。 これは、AEM Site 出力を生成する際に、ファイル名が URL の生成に使用され、ファイルのタイトルは生成されないことを意味しています。 このオプションを有効にすると、ファイルのタイトルに基づいて URL を生成することを選択できます。
AEM Site の出力で URL の生成を設定するには、次の手順を実行します。
-
Adobe Experience Manager Web コンソール設定ページを開きます。
設定ページにアクセスするデフォルトの URL は次のとおりです。
code language-http http://<server name>:<port>/system/console/configMgr
-
を検索して、 com.adobe.fmdita.config.ConfigManager バンドル。
-
を選択します。 AEMサイトのページ名にタイトルを使用 オプション。
note note NOTE ファイル名を使用して出力を生成する場合は、このオプションの選択を解除します。 -
「保存」をクリックします。
トピックを作成し、AEM Site 出力を公開するためのファイル名のサニタイズルールを設定する id2164D0KD0XA
管理者は、ファイル名で使用できる有効な特殊文字のリストを定義でき、最終的にAEM Site 出力の URL を形成します。 以前のリリースでは、ユーザーは、次のような特殊文字を含むファイル名を定義できました。 @
, $
, >
など。 これらの特殊文字を使用すると、AEM Site ページの生成時に URL がエンコードされていました。
3.8 リリースより、ファイル名で許可される特殊文字のリストを定義する設定が追加されました。 デフォルトでは、有効なファイル名設定に「a-z A-Z 0-9 - _
". つまり、ファイルを作成する際に、ファイルのタイトルに任意の特殊文字を含めることができますが、内部的にはハイフン(-
) をファイル名に含めます。 例えば、ファイルのタイトルを Introduction 1 またはIntroduction@1と指定できます。これらの場合、対応するファイル名は Introduction-1 となります。
有効な文字のリストを定義する場合は、「*/:[\]|#%{}?&<>"/+
"および" a space
は常にハイフン(-
) です。
ファイル名およびAEM Site 出力で有効な特殊文字を設定するには、次の手順に従います。
-
Adobe Experience Manager Web コンソール設定ページを開きます。
設定ページにアクセスするデフォルトの URL は次のとおりです。
code language-http http://<server name>:<port>/system/console/configMgr
-
を検索して、 com.adobe.fmdita.common.SanitizeNodeNameImpl バンドル。
-
Adobe Analytics の AEM Sitesに公開するための禁止文字セット プロパティを指定する場合、プロパティが
'<>`@$
. このリストに特殊文字を追加できますが、これらの特殊文字が必要です。note note NOTE また、 小文字を使用 ファイル名では 区切り文字 無効な文字を処理するには、 最大文字数 ファイル名で許可されています。 -
「保存」をクリックします。
-
を検索して、 com.adobe.fmdita.config.ConfigManager バンドル。
-
Adobe Analytics の 有効な文字の正規表現 プロパティを指定する場合、プロパティが
[-a-zA-Z0-9_]
. このリストにはさらに文字を追加できますが、このリストにはこれらの基本的な文字が含まれ、リストはハイフン(-
) です。note note NOTE このプロパティは、新しいファイルの作成に使用される有効な文字のリストを定義します。 -
「保存」をクリックします。
AEM Site ノード構造の統合を設定
AEM Site 出力を生成すると、トピック内のすべての要素のノードが内部的に作成されます。 何千ものトピックを含む DITA マップの場合、このノード構造が深すぎる可能性があります。 このタイプの深くネストされたノード構造は、大規模なサイトでパフォーマンスの問題を引き起こす可能性があります。 次のスナップショットは、AEM Site 出力用に深くネストされたノード構造を示しています。
{width="300"}
上記のスナップショットでは、各 p
要素とその後続のサブ要素、および同様の構造が、トピックで使用される他のすべての要素に対して作成されます。
AEMガイドを使用すると、AEM Site 出力のノード構造を内部で作成する方法を設定できます。 指定した要素でノード構造を統合できます。つまり、メイン要素と見なされる要素を定義し、その中のすべてのサブ要素をメイン要素と結合できます。 例えば、 p
要素を選択し、その中に現れる任意の要素を p
要素がメインと結合されます p
要素を選択します。 内のサブ要素に対して別のメモは作成されません。 p
要素を選択します。 次のスナップショットは、フラット化されたノード構造を示しています: p
要素:
{width="300"}
AEM Site のノード構造を統合するには、次の手順を実行します。
-
ノード構造を統合する要素を指定します。
-
のオーバーレイ
libs
ノードをapps
ノードに移動し、 elementmapping.xml ファイルを開きます。 -
次を追加:
<flatten>true</flatten>
プロパティを含めます。 例えば、p
要素を選択し、「flatten」属性をp
要素を次に示します。code language-xml <ditaelement> <name>p</name> <class>- topic/p</class> <componentpath>fmdita/components/dita/wrapper</componentpath> <type>COMPOSITE</type> <target>para</target> <flatten>true</flatten> <wrapelement>div</wrapelement> </ditaelement>
note note NOTE デフォルトでは、flatten ノードのプロパティは p
要素を選択します。
-
-
configMgr で、サイトノードのフラット化設定を有効にします。
-
Adobe Experience Manager Web コンソール設定ページを開きます。
設定ページにアクセスするデフォルトの URL は次のとおりです。
code language-http http://<server name>:<port>/system/console/configMgr
-
を検索して、 com.adobe.dxml.flattening.FlatteningConfigurationService バンドル。
-
を選択します。 プロパティ flattening.enabled オプション。
-
「保存」をクリックします。
-
これで、AEM Site の出力を生成する際に、 p
要素がフラット化され、 p
要素自体。 新しい統合プロパティは、 p
要素を使用します。
{width="650"}
AEM Site のメモ構造のフラット化を防ぐ
AEM Site の出力で統合するノードを指定する場合と同様に、この設定から除外する要素を指定することもできます。 例えば、 body
要素が必要ですが、次の要素は不要です。 table
内の要素 body
を統合する場合、「次を除外する」プロパティを table
要素の定義。
を除外するには、以下を実行します。 table
要素をフラット化から、 table
要素の定義:
<preventancestorflattening>true|false</preventancestorflattening>
AEM Site 出力で削除されたページのバージョン管理を設定します
を使用してAEM Site 出力を生成する場合 とを削除します。 作成 オプションが「既存の出力ページ」設定で選択されている場合、削除するページのバージョンが作成されます。 削除する前にバージョンの作成を停止するようにシステムを設定できます。
削除するページのバージョンの作成を停止するには、次の手順を実行します。
-
Adobe Experience Manager Web コンソール設定ページを開きます。
設定ページにアクセスするデフォルトの URL は次のとおりです。
code language-http http://<server name>:<port>/system/console/configMgr
-
を検索して、 com.adobe.fmdita.config.ConfigManager バンドル。
-
選択 削除されたページのバージョンを作成しない オプション。
note note NOTE このオプションを選択すると、ユーザーはバージョンを作成せずに、任意のページを直接削除できます。 このオプションが選択されていない場合、ページが削除される前にバージョンが作成されます。 -
「保存」をクリックします。
DITA-OT を使用した出力の公開でのメタデータの使用 id191LF0U0TY4
AEMガイドでは、DITA-OT を使用して出力を公開する際にカスタムメタデータを渡す方法を提供します。 管理者およびパブリッシャーは、次のタスクを実行して、公開された出力でカスタムメタデータを設定および使用する必要があります。
-
管理者は、必要なメタデータをシステムに追加して、DITA マップのプロパティページで使用できるようにします。
-
管理者は、DITA マップコンソールに表示されるように、カスタムメタデータをメタデータリストに追加します。
-
パブリッシャーとして、DITA マップを使用してカスタムメタデータを設定および追加し、必要な出力を生成します。
必要なメタデータをシステムに追加するには、次の手順に従います。
-
管理者としてAdobe Experience Managerにログインします。
-
上部の「 Adobe Experience Manager 」リンクをクリックし、「 」を選択します。 ツール.
-
選択 Assets を選択します。
-
をクリックします。 メタデータスキーマ タイル。
メタデータスキーマFormsページが表示されます。
-
を選択します。 デフォルト フォームをリストから削除します。
note note NOTE DITA マップのプロパティページに表示されるプロパティは、このフォームから取得されます。 -
クリック 編集.
-
公開した出力で使用するカスタムメタデータを追加します。 例えば、次の手順を使用してオーディエンスメタデータを追加します。
-
次から: フォームを作成 コンポーネントリスト、ドラッグ&ドロップ 1 行のテキスト コンポーネントをフォームに貼り付けます。
-
新しいフィールドを選択して、 設定 」と入力します。
-
Adobe Analytics の フィールドラベル、メタデータ名として「オーディエンス」を入力します。
-
Adobe Analytics の プロパティにマッピング を設定する際に、と指定します。/jcr:content/metadata/<name of="" the="" metadata="">. この例では、をに設定します。/jcr:content/metadata/audience.
これらの手順を使用して、必要なすべてのメタデータパラメーターを追加します。
-
-
「保存」をクリックします。
すべての DITA マップのプロパティページに新しいパラメータが表示されるようになりました。
{width="650"}
次に、DITA マップコンソールでカスタムメタデータを使用できるようにする必要があります。 DITA マップダッシュボードでカスタムメタデータを使用できるようにするには、次の手順を実行します。
-
AEMにログインし、CRXDE Liteモードを開きます。
-
次の場所にある metadataList ファイルにアクセスします。
/libs/fmdita/config/metadataList
note note NOTE metadataList ファイルには、 プロパティ マップダッシュボードの DITA マップのドロップダウンリスト。 デフォルトでは、このファイルには docstate、dc:language、dc:description、dc:title の 4 つのプロパティがリストされています。 -
メタデータスキーマFormsページに追加したカスタムメタデータを追加します。 この例では、デフォルトリストの末尾にオーディエンスパラメーターを追加します。
-
「すべて保存」をクリックします。
現在は、カスタムメタデータが DITA マップコンソールの プロパティ 」ドロップダウンリストから選択できます。
最後に、パブリッシャーは、公開済み出力にカスタムメタデータを含める必要があります。 出力の生成時にカスタムメタデータを処理するには、次の手順を実行します。
-
Assets UI で、公開する DITA マップに移動します。
-
DITA マップファイルを選択し、そのプロパティページを開きます。
-
プロパティページで、カスタムメタデータの値を指定します。 この例では、オーディエンスパラメーターに External という値を指定しています。
{width="650"}
-
「保存して閉じる」をクリックします。
-
DITA マップファイルをクリックして、DITA マップコンソールを開きます。
-
Adobe Analytics の 出力プリセット 「 」タブで、出力の生成に使用する出力プリセットを選択します。
-
クリック 編集.
-
次から: プロパティ ドロップダウンリストから、公開プロセスに渡すプロパティを選択します。
{width="650"}
選択したプロパティまたはメタデータが公開プロセスに渡され、最終的な出力で使用できるようになります。
AEMコンポーネントを使用した DITA 要素マッピングのカスタマイズ id1679J600HEL
AEMガイドの DITA 要素は、対応するAEMコンポーネントにマッピングされます。 AEMガイドは、公開やレビューなどのワークフローでこのマッピングを使用し、DITA 要素を対応するAEMコンポーネントに変換します。 マッピングは、 elementmapping.xml
ファイルに含まれます。このファイルには、CRXDE Lite・モードからアクセスできます。 CRXDE Liteモードで次の URL にアクセスします。
/libs/fmdita/config/elementmapping.xml
libs
ノード。 オーバーレイを作成するには、 libs
ノードを apps
ノードに追加し、 apps
ノードのみ。定義済みの DITA 要素のマッピングを使用するか、DITA 要素をカスタムAEMコンポーネントにマッピングできます。 カスタムAEMコンポーネントを使用するには、 elementmapping.xml
ファイル。
elementmapping.xml 構造
の概要 elementmapping.xml
構造については、以下で説明します。
-
各 DITA 要素は、最初に、要素名に基づいて、対応するコンポーネントマッピングを検索します。 次に例を示します。
code language-xml <ditaelement> <name>**substeps**</name> <class>- topic/ol task/substeps</class> <componentpath>dita/components/ditaolist</componentpath> <type>COMPOSITE</type> <target>para</target> </ditaelement>
上記の例では、すべて
substeps
DITA 要素は、dita/components/ditaolist
コンポーネント。 -
DITA 要素が名前に基づいて一致を見つけられない場合、
class
が完了しました。 次に例を示します。code language-xml <ditaelement> <name>topic</name> <class>**- topic/topic**</class> <componentpath>fmdita/components/dita/topic</componentpath> <type>COMPOSITE</type> <target>para</target> <attributemap> <attribute from="id" to="id" /> </attributemap> </ditaelement>
上記の例で、
task
要素を選択し、task
要素が上記のコンポーネントにマッピングされるのは、task
は、topic
コンポーネント。 -
要素に対応するコンポーネントマッピングがある場合、その子要素のさらなる処理は
type
. 次に例を示します。code language-xml <ditaelement> <name>title</name> <class>- topic/title</class> <componentpath>foundation/components/title</componentpath> <type>**STANDALONE**</type> <target>para</target> <textprop>jcr:title</textprop> </ditaelement>
type
は次の値を取ります。-
COMPOSITE:要素からコンポーネントへ 子要素のマッピングは継続されます 同様に。
-
STANDALONE:現在の要素の子要素は次のとおりです。 これ以上マッピングされません.
上記の例で、
<title>
要素に子要素があり、他のコンポーネントにマッピングされません。 のコンポーネント<title>
要素は、内のすべての子要素をレンダリングします。<title>
要素を選択します。 -
-
1 つの DITA 要素にマッピングされた複数のコンポーネントがある場合は、その要素に最も一致するコンポーネントが選択されます。 最適一致コンポーネントを選択するには、DITA 要素のドメインおよび構造の特殊化を考慮します。
ドメイン特殊化を持つ DITA 要素が存在し、ドメインの特殊化に対してコンポーネントがマッピングされている場合、そのコンポーネントの優先度が高くなります。
同様に、構造特殊化を持つ DITA 要素が存在し、コンポーネントが構造特殊化にマッピングされている場合は、そのコンポーネントの優先度が高くなります。
-
以下を使用できます。
<attributemap>
(要素マッピング)を使用して、属性値を対応するノードプロパティにマッピングします。 -
textprop
を使用して、DITA 要素のテキストコンテンツをノードプロパティにシリアル化できます。 また、要素タグで複数回使用して、公開済み階層の複数の場所でテキストコンテンツをシリアル化できます。 また、ターゲットプロパティの場所と名前をカスタマイズすることもできます。 次に例を示します。code language-xml <ditaelement> <name>title</name> <class>- topic/title</class> <componentpath>foundation/components/title</componentpath> <type>STANDALONE</type> <target>para</target> <textprop>**jcr:title**</textprop> </ditaelement>
上記の要素マッピングは、
<title>
要素は、jcr:title
を出力ノードに設定します。 -
xmlprop
は、特定の要素の XML 全体をノードプロパティにシリアル化するために使用できます。 その後、コンポーネントはこのノードプロパティを読み取り、カスタムレンダリングを実行できます。 次に例を示します。code language-xml <ditaelement> <name>svg-container</name> <class>+ topic/foreign svg-d/svg-container</class> <componentpath>fmdita/components/dita/svg</componentpath> <type>STANDALONE</type> <target>para</target> <xmlprop>**data**</xmlprop> </ditaelement>
上記の要素のマッピングは、要素の XML マークアップ全体を指定します
<svg-container>
はという名前のプロパティの値として保存されますdata
を出力ノードに設定します。 -
出力生成プロセスでパスの解決を処理するための特別な属性マッピングがあります。 次に例を示します。
code language-xml <attributemap> <attribute from="href" to="fileReference" ispath="true" rel="source" /> <attribute from="height" to="height" /> <attribute from="width" to="width" /> </attributemap>
上記の
attributemap
、href
属性が DITA 要素内の次の名前のノードプロパティにマッピングされます:fileReference
. 今後ispath
がtrue
出力生成プロセスは、このパスを解決し、次にfileReference
ノードプロパティ。この解決方法は、
rel
属性のマッピングに含まれる属性。-
次の場合
rel=source
、の値href
は、現在処理中の DITA ソースファイルに関して解決されます。 の値href
が解決され、fileReference
プロパティ。 -
次の場合
rel=target
、の値href
は、ルート公開の場所を基準に解決されます。 の値href
が解決され、fileReference
プロパティ。
パス属性で前処理や解決をおこなわない場合は、
ispath
属性。 値はそのままコピーされ、コンポーネントは必要な解像度を実行できます。 -
DITA 要素スキーマ
次に、DITA 要素のスキーマの例を示します。 elementmapping.xml
ファイル:
<ditaelement>
<name>element_name</name>
<class>element_class</class>
<componentpath>fmdita/components/dita/component_name</componentpath>
<type>COMPOSITE|STANDALONE</type>
<attributeprop>propname_a</attributeprop>
<textprop>propname_t</textprop>
<xmlprop>propname_x</xmlprop>
<xpath>xpath expression string</xpath>
<target>head|para</target>
<wrapelement>div</wrapelement>
<wrapclass>class_name</wrapclass>
<attributemap>
<attribute from="attrname" to="propname" ispath="true|false" rel="source|target" />
</attributemap>
<skip>true|false</skip>
</ditaelement>
次の表に、DITA 要素スキーマの要素を示します。
<ditaelement>
<class>
例えば、DITA トピックの class 属性は次のようになります。
topic/topic
<componentpath>
<type>
- 複合:子要素も処理します
- スタンドアロン:子要素の処理をスキップします
<attributeprop>
<note type="Caution">
要素と、この要素にマッピングされるコンポーネントには、 <attributeprop>attr_t</ attributeprop>
に値がセットされた場合、ノードの属性と値は attr_t
対応するAEMノードのプロパティ( attr_t->type="caution"
) です。<textprop>propname_t</textprop>
getTextContent()
次で定義されたプロパティに出力 propname_t.
注意: これは最適化されたプロパティです。<xmlprop>propname_x </xmlprop>
propname_x.
注意: これは最適化されたプロパティです。<xpath>
<target>
可能な値:
- head:head ノードの下
- テキスト:段落ノードの下
<wrapelement>
<wrapclass>
wrapclass.
<attributemap>
<attribute>
ノード。追加情報
-
デフォルトの要素マッピングを上書きする予定がある場合は、デフォルトで変更を加えないことをお勧めします。
elementmapping.xml
ファイル。 新しいマッピング XML ファイルを作成し、作成する別の場所(できれば作成するカスタムアプリフォルダー内)にファイルを配置する必要があります。 -
Adobe Analytics の
elementmapping.xml
ファイル内には、fmdita/components/dita/wrapper コンポーネントを参照するマッピングエントリが多数あります。 ラッパーは、サイトノードのプロパティを使用して比較的シンプルな DITA 構成をレンダリングし、関連するHTMLを生成する汎用コンポーネントです。 使用するのはwrapelement
プロパティを使用して、含まれるタグを生成し、子レンダリングを対応するコンポーネントに委任します。 これは、コンテナコンポーネントのみが必要な場合に便利です。 のような特定のコンテナタグをレンダリングする新しいコンポーネントを作成する代わりに、div
またはp
を使用する場合、Wrapper コンポーネントをwrapelement
およびwrapclass
プロパティを使用して同じ効果を得ることができます。 -
String JCR プロパティに大量のテキストを保存することはお勧めしません。 出力生成で最適化されたプロパティタイプの計算を使用すると、大きなテキストコンテンツが文字列タイプとして保存されなくなります。 代わりに、特定のしきい値を超えるコンテンツを保存する必要がある場合、プロパティのタイプはバイナリに変更されます。 デフォルトでは、このしきい値は 512 バイトに設定されていますが、Configuration Manager で変更できます(com.adobe.fmdita.config.ConfigManager) バイナリしきい値として保存 設定。
-
要素マッピングの一部の\(すべてではなく)を上書きする場合は、
elementmapping.xml
ファイル。 新しい XML マッピングファイルを作成し、上書きする要素のみを定義する必要があります。 -
カスタムの場所に XML ファイルを作成した後、
Override Element Mapping
設定をcom.adobe.fmdita.config.ConfigManager
バンドル。
DITA マップコンソールのカスタマイズ id188HC08M0CZ
AEMガイドを使用すると、DITA マップコンソールの機能を柔軟に拡張できます。 例えば、AEMガイドで使用可能なレポートとは異なる一連のレポートがある場合、そのようなレポートをマップコンソールに追加できます。 マップコンソールをカスタマイズするには、必要な機能を実行するコードを含むAEMクライアントライブラリ(または ClientLib)を作成する必要があります。
AEMガイドでは、 apps.fmdita.dashboard-extn
マップコンソールをカスタマイズするためのカテゴリ。 マップコンソールが読み込まれるたびに、 apps.fmdita.dashboard-extn
カテゴリが実行され、読み込まれます。
出力生成時に画像レンディションを処理 id177BF0G0VY4
AEMには、アセットを処理するためのデフォルトのワークフローとメディアハンドルのセットが付属しています。 AEMには、最も一般的な MIME タイプのアセット処理を処理するための事前定義済みのワークフローがあります。 通常、AEMは、アップロードするすべての画像に対して、同じレンディションをバイナリ形式で複数作成します。 これらのレンディションは、サイズ、解像度、透かしの追加、その他の変更された特性を持つレンディションです。 AEMでのアセットの処理方法について詳しくは、 メディアハンドラーとワークフローを使用したアセットの処理 (AEMドキュメント )。
AEMガイドを使用すると、ドキュメントの出力を生成する際に使用する画像レンディションを設定できます。 例えば、デフォルトの画像レンディションの 1 つを選択するか、作成して同じレンディションを使用してドキュメントを公開することができます。 ドキュメントを公開するための画像レンディションマッピングは、 /libs/fmdita/config/ **renditionmap.xml**
ファイル。 のスニペット renditionmap.xml
ファイルの内容は次のとおりです。
renditionmap.xml
ファイルを apps
すべてのカスタマイズ用のフォルダー。<renditionmap>
<mapelement>
<mimetype>image/png</mimetype>
<rendition output="AEMSITE">cq5dam.web.1280.1280.jpeg</rendition>
<rendition output="PDF">original</rendition>
<rendition output="HTML5">cq5dam.web.1280.1280.jpeg</rendition>
<rendition output="EPUB">cq5dam.web.1280.1280.jpeg</rendition>
<rendition output="CUSTOM">cq5dam.web.1280.1280.jpeg</rendition>
</mapelement>
...
</renditionmap>
The mimetype
element は、ファイル形式の MIME タイプを指定します。 The rendition output
element 出力形式のタイプとレンディション名を指定します( 例: cq5dam.web.1280.1280.jpeg
) 指定した出力の公開に使用する必要がある。 サポートされるすべての出力形式 (AEMSITE、PDF、HTML5、EPUB、カスタム ) で使用する画像レンディションを指定できます。
指定したレンディションが存在しない場合、AEM Guides の公開プロセスはまず、指定された画像の Web レンディションを探します。 Web レンディションが見つからない場合は、画像の元のレンディションが使用されます。
出力履歴の自動パージ期間の設定 id19AAI070V8Q
出力を生成すると、出力ログと共に出力が作成されます。 大きな DITA マップの場合、これらのログはリポジトリ内の大量のスペースを取る場合があります。 デフォルトでは、ログはリポジトリ内の次の場所に保存されます。
/var/dxml/metadata/outputHistory/
ある期間、すべてのログファイルの総サイズが GB になる可能性がありました。 AEMガイドでは、これらのログファイルをリポジトリに保持する期間を設定できます。 指定した期間が過ぎると、出力生成履歴と共にログがリポジトリから削除されます。
履歴のパージ機能を設定すると、リポジトリ内のすべての DITA マップの出力生成に影響します。 DITA マップの「出力」タブでは、指定した日数の経過後、設定で指定した時刻に履歴がパージされます。
次の手順を実行して、出力履歴とログをパージする日時を設定します。
-
Adobe Experience Manager Web コンソール設定ページを開きます。
設定ページにアクセスするデフォルトの URL は次のとおりです。
code language-http http://<server name>:<port>/system/console/configMgr
-
を検索して、 com.adobe.fmdita.config.ConfigManager バンドル。
-
Adobe Analytics の 出力履歴のパージ期間 プロパティを使用して、出力ログと共に出力履歴がパージされるまでの日数を指定します。 デフォルトでは、5 日に設定されています。 この機能を無効にする場合は、このプロパティを 0 に設定します。
-
Adobe Analytics の 出力履歴のパージ時間 プロパティを使用して、パージプロセスが開始される時間を指定します。 デフォルトでは、0:00 \(または 12:00 midnight\)に設定されています。 この時点で毎日、パージプロセスは、 出力履歴のパージ期間 プロパティ。
note note NOTE デフォルトでは、パージ機能は、5 日より古い出力で、午前 0 時ごとに実行されます。 -
「保存」をクリックします。
最近生成した出力リストの制限を変更 id1679JH0H0O2
DITA マップの「出力」タブに表示される、生成された出力の最大数を変更できます。 デフォルトでは、最後に生成された 25 個の出力のリストが表示されます。 リストに表示する出力数を変更するには、 出力リストの制限 設定を com.adobe.fmdita.config.ConfigManager
バンドル。
出力生成パフォーマンスの最適化 id176LB050VUI
AEMガイドを使用すると、同時に実行する出力生成プロセスの数を制御する、出力生成プロセスのプールサイズを設定できます。 デフォルトでは、プロセスプールサイズは、システムで使用可能な処理コアの数に 1 を加えた数に設定されます。 順次公開する場合は、この値を 1 に変更します。 この場合、最初の公開タスクが実行され、次の公開タスクが公開キューに保存されます。
出力生成処理プールのサイズを変更するには、 生成プールのサイズ 設定を com.adobe.fmdita.publish.manager.PublishThreadManagerImpl
バンドル。