出力生成設定の指定 id181AI0B0E30

AEMガイドには、出力生成プロセスをカスタマイズするための多くの設定オプションが付属しています。 このトピックでは、出力生成プロセスの設定に役立つすべての設定とカスタマイズについて説明します。

DITA マップダッシュボードの「ベースライン」タブを設定します。 id223MD0D0YRM

マップダッシュボードで使用できる「ベースライン」タブを設定および非表示にすることができます。

The ベースラインタブを非表示 このオプションはデフォルトでは有効になっていないので、configMgr から有効にする必要があります。 Web エディターでデフォルトでこのオプションを有効にするには、次の手順を実行します。

設定FrameMaker Publishing Server id1678G0Z0TN6

FrameMaker Publishing Server(FMPS) を使用して、DITA コンテンツの出力を生成できます。 FMPS を設定すると、FMPS でサポートされる複数の形式で出力を生成できます。

FMPS を使用するようにAEMガイドを設定するには、 com.adobe.fmdita.config.ConfigManager バンドルを Web コンソールに追加します。

既存のAEM Site 内でのブレンド公開の設定 id1691I0V0MGR

DITA コンテンツを含むAEMサイトがある場合は、DITA コンテンツをサイト内の事前定義された場所に公開するようにAEM Site の出力を設定できます。 例えば、AEM Site ページの次のスクリーンショットでは、 ditacontent ノードは DITA コンテンツの格納用に予約されています。

{width="300"}

ページに残っているノードは、AEM Site Editor から直接作成します。 DITA コンテンツを事前定義の場所に公開するように公開設定を指定すると、AEM Guides の公開プロセスで、既存の DITA 以外のコンテンツが変更されなくなります。

事前定義されたノードに DITA コンテンツを公開できるようにするには、既存のサイトで次の設定を実行する必要があります。

次の手順を実行して、既存のサイトのテンプレートプロパティを設定します。

次のスクリーンショットは、AEM Guides のデフォルトのテンプレートノードに追加されたプロパティを示しています。

{width="800"}

次回、サイトのテンプレート設定を使用して DITA コンテンツを公開する際に、そのコンテンツが topicContentNode および topicHeadNode プロパティ。

ただし、既存のサイトの場合は、手動で topicContentNode および topicHeadNode ノード。

次の手順を実行して、必要なノードを既存のサイトに追加します。

AEM Site 出力のカスタマイズ id166TG0B30WR

AEMガイドは、次の形式での出力の作成をサポートしています。

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 の出力生成に使用する独自のデザインテンプレートを指定します。

詳しくは、 最初の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 の生成を設定するには、次の手順を実行します。

トピックを作成し、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 出力で有効な特殊文字を設定するには、次の手順に従います。

AEM Site ノード構造の統合を設定

AEM Site 出力を生成すると、トピック内のすべての要素のノードが内部的に作成されます。 何千ものトピックを含む DITA マップの場合、このノード構造が深すぎる可能性があります。 このタイプの深くネストされたノード構造は、大規模なサイトでパフォーマンスの問題を引き起こす可能性があります。 次のスナップショットは、AEM Site 出力用に深くネストされたノード構造を示しています。

{width="300"}

上記のスナップショットでは、各 p 要素とその後続のサブ要素、および同様の構造が、トピックで使用される他のすべての要素に対して作成されます。

AEMガイドを使用すると、AEM Site 出力のノード構造を内部で作成する方法を設定できます。 指定した要素でノード構造を統合できます。つまり、メイン要素と見なされる要素を定義し、その中のすべてのサブ要素をメイン要素と結合できます。 例えば、 p 要素を選択し、その中に現れる任意の要素を p 要素がメインと結合されます p 要素を選択します。 内のサブ要素に対して別のメモは作成されません。 p 要素を選択します。 次のスナップショットは、フラット化されたノード構造を示しています： p 要素：

{width="300"}

AEM Site のノード構造を統合するには、次の手順を実行します。

これで、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 出力を生成する場合 とを削除します。 ​作成​ ​ ​オプションが「既存の出力ページ」設定で選択されている場合、削除するページのバージョンが作成されます。 削除する前にバージョンの作成を停止するようにシステムを設定できます。

削除するページのバージョンの作成を停止するには、次の手順を実行します。

DITA-OT を使用した出力の公開でのメタデータの使用 id191LF0U0TY4

AEMガイドでは、DITA-OT を使用して出力を公開する際にカスタムメタデータを渡す方法を提供します。 管理者およびパブリッシャーは、次のタスクを実行して、公開された出力でカスタムメタデータを設定および使用する必要があります。

必要なメタデータをシステムに追加するには、次の手順に従います。

すべての DITA マップのプロパティページに新しいパラメータが表示されるようになりました。

{width="650"}

次に、DITA マップコンソールでカスタムメタデータを使用できるようにする必要があります。 DITA マップダッシュボードでカスタムメタデータを使用できるようにするには、次の手順を実行します。

現在は、カスタムメタデータが DITA マップコンソールの プロパティ 」ドロップダウンリストから選択できます。

最後に、パブリッシャーは、公開済み出力にカスタムメタデータを含める必要があります。 出力の生成時にカスタムメタデータを処理するには、次の手順を実行します。

選択したプロパティまたはメタデータが公開プロセスに渡され、最終的な出力で使用できるようになります。

AEMコンポーネントを使用した DITA 要素マッピングのカスタマイズ id1679J600HEL

AEMガイドの DITA 要素は、対応するAEMコンポーネントにマッピングされます。 AEMガイドは、公開やレビューなどのワークフローでこのマッピングを使用し、DITA 要素を対応するAEMコンポーネントに変換します。 マッピングは、 elementmapping.xml ファイルに含まれます。このファイルには、CRXDE Lite・モードからアクセスできます。 CRXDE Liteモードで次の URL にアクセスします。

/libs/fmdita/config/elementmapping.xml

定義済みの DITA 要素のマッピングを使用するか、DITA 要素をカスタムAEMコンポーネントにマッピングできます。 カスタムAEMコンポーネントを使用するには、 elementmapping.xml ファイル。

elementmapping.xml 構造

の概要 elementmapping.xml 構造については、以下で説明します。

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 要素スキーマの要素を示します。

追加情報

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>
   <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 マップの「出力」タブでは、指定した日数の経過後、設定で指定した時刻に履歴がパージされます。

次の手順を実行して、出力履歴とログをパージする日時を設定します。

最近生成した出力リストの制限を変更 id1679JH0H0O2

DITA マップの「出力」タブに表示される、生成された出力の最大数を変更できます。 デフォルトでは、最後に生成された 25 個の出力のリストが表示されます。 リストに表示する出力数を変更するには、 出力リストの制限 設定を com.adobe.fmdita.config.ConfigManager バンドル。

出力生成パフォーマンスの最適化 id176LB050VUI

AEMガイドを使用すると、同時に実行する出力生成プロセスの数を制御する、出力生成プロセスのプールサイズを設定できます。 デフォルトでは、プロセスプールサイズは、システムで使用可能な処理コアの数に 1 を加えた数に設定されます。 順次公開する場合は、この値を 1 に変更します。 この場合、最初の公開タスクが実行され、次の公開タスクが公開キューに保存されます。

出力生成処理プールのサイズを変更するには、 生成プールのサイズ 設定を com.adobe.fmdita.publish.manager.PublishThreadManagerImpl バンドル。