出力生成設定の指定 id181AI0B0E30

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

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

マップダッシュボードで使用可能な「ベースライン」タブを設定したり非表示にしたりできます。

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

FrameMaker Publishing Serverの設定 id1678G0Z0TN6

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

FMPS を使用するようにAEM Guidesを設定するには、web コンソールで com.adobe.fmdita.config.ConfigManager バンドルの次のプロパティを更新します。

既存のAEM サイト内で混合型公開を設定する id1691I0V0MGR

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

{width="300"}

ページ内の残りのノードは、AEM サイトエディターから直接作成されます。 DITA コンテンツを事前定義済みの場所に公開するように公開設定を指定すると、既存の非 DITA コンテンツがAEM Guides公開プロセスで変更されることはありません。

定義済みノードに DITA コンテンツを発行できるようにするには、既存のサイトで次の設定を実行する必要があります。

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

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

{width="800"}

次にサイトのテンプレート設定を使用して DITA コンテンツを公開すると、そのコンテンツは topicContentNode および topicHeadNode プロパティで指定したノードに公開されます。

ただし、既存のサイトの場合は、topicContentNode ノードと topicHeadNode ノードを手動で追加する必要があります。

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

AEM サイト出力のカスタマイズ id166TG0B30WR

AEM Guidesでは、次の形式での出力の作成がサポートされています。

AEM Site 出力の場合、異なる出力タスクに異なるデザインテンプレートを割り当てることができます。 これらのデザインテンプレートは、異なるレイアウトで DITA コンテンツをレンダリングできます。 例えば、内部オーディエンスと外部オーディエンスに対して異なるデザインテンプレートを指定できます。

カスタマイズした DITA Open Toolkit \（DITA-OT\） プラグインをAEM Guidesで使用することもできます。 これらのカスタム DITA-OT プラグインをアップロードすると、特定の方法でPDF出力を生成できます。

出力を生成するためのデザインテンプレートのカスタマイズ customize_xml-add-on

AEM Guidesでは、事前定義済みの一連のデザインテンプレートを使用して、AEM Site 出力を生成します。 AEM Guidesのデザインテンプレートをカスタマイズして、企業のブランディングに合った出力を生成できます。 デザインテンプレートは、様々なスタイル \（CSS\）、スクリプト \（サーバー側とクライアント側の両方\）、リソース \（画像、ロゴ、その他のアセット\）、およびこれらすべてのリソースを結び付ける JCR ノードのコレクションです。 デザインテンプレートは、単一のサーバーサイドスクリプトと複数の JCR ノードのみで構成するか、スタイル、リソース、JCR ノードの複雑な組み合わせで構成することができます。 デザインテンプレートは、AEM サイト出力を生成する際にAEM Guides パブリッシングサブシステムで使用され、生成された出力の構造、ルックアンドフィールを制御します。

デザイン テンプレート リソースをサーバ上のどこに配置するかについては制限はありませんが、通常は機能に応じて論理的に編成されます。 例えば、デフォルトのテンプレートでは、すべてのJavaScriptと CSS ファイルがフォルダーに保存 /etc/designs/fmdita/clientlibs/siteoutput/default れています。 これらのファイルが配置されている場所では、それらのファイルは JCR ノードのコレクションによってリンクされます。 これらの JCR ノードとファイルによって、デザインテンプレート全体が構成されます。

AEM Guidesに付属しているデフォルトのデザインテンプレートを使用すると、ランディング、トピックおよび検索ページのコンポーネントをカスタマイズできます。 デフォルトのデザインと対応する参照テンプレートのコピーを作成し、異なるコンポーネントを指定して目的の出力を生成できます。

次の手順を実行して、AEM Site 出力生成に使用する独自のデザインテンプレートを指定します。

詳しくは、 最初のAdobe Experience Manager 6.3 の Web サイトの作成および 基本のAEMでの独自の Web サイトの開発を参照してください。

AEM サイト出力の生成にドキュメントタイトルを使用

AEM Site 出力を生成する場合、URL の生成方法は、コンテンツの検出性に重要な役割を果たします。 UUID ベースのファイル名を使用している場合、ファイルの UUID に基づいて URL を生成しても、検索しづらくなります。 管理者または公開者は、AEM サイト出力の URL の生成方法を制御できます。 AEM Guidesでは、UUID ベースのファイル名ではなくファイルのタイトルを使用して、AEM サイト出力の URL を生成できる設定を提供します。 デフォルトでは、UUID ベースのファイルシステムの場合、このオプションはオンになっています。 つまり、UUID ベースのファイルシステムに対してAEM サイト出力を生成する場合、ファイルのタイトルは、ファイルの UUID ではなく、URL の生成に使用されます。

AEM Site 出力を生成する場合、URL の生成方法は、コンテンツの検出性に重要な役割を果たします。 非 UUID ベースのファイルシステムの場合、AEM サイト出力は、ファイルのタイトルではなくファイル名を使用して生成されます。 管理者または公開者は、AEM サイト出力の URL の生成方法を制御できます。 AEM Guidesでは、AEM サイト出力の URL をファイル名ではなくファイルのタイトルを使用して生成するよう設定できます。 デフォルトでは、このオプションはオフになっています。 つまり、AEM サイト出力を生成する際に、ファイルのタイトルではなく、ファイル名を使用して URL が生成されます。 このオプションを有効にすると、ファイルのタイトルに基づいて URL を生成できます。

AEM Site 出力に URL の生成を設定するには、次の手順を実行します。

トピックを作成し、AEM サイト出力を公開するためのファイル名のサニタイズルールを設定する id2164D0KD0XA

管理者は、ファイル名に使用できる有効な特殊文字のリストを定義できます。これらの特殊文字は、最終的にAEM サイト出力の URL を形成します。 以前のリリースでは、@、$、> などの特殊文字を含むファイル名を定義できていました。 これらの特殊文字により、AEM サイトページの生成時に URL がエンコードされていました。

3.8 リリース以降、ファイル名で使用できる特殊文字のリストを定義する設定が追加されました。 デフォルトでは、有効なファイル名設定には「a-z A-Z 0-9 - _」が含まれます。 つまり、ファイルを作成する際に、ファイルのタイトルに任意の特殊文字を含めることができますが、内部的には、ファイル名ではハイフン\（-\）に置き換えられます。 例えば、ファイルのタイトルを Introduction 1 またはIntroduction@1にすることができ、これらの場合に生成される対応するファイル名は Introduction-1 になります。

有効な文字のリストを定義する場合、これらの文字「*/:[\]|#%{}?&<>"/+」と a space は常にハイフン \（-\）に置き換えられることに注意してください。

ファイル名およびAEM サイト出力に有効な特殊文字を設定するには、次の手順を実行します。

AEM Site のノード構造のフラット化の設定

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

{width="300"}

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

AEM Guidesでは、AEM サイト出力のノード構造が内部でどのように作成されるかを設定できます。 指定した要素のノード構造を統合できます。つまり、メイン要素と見なされる要素を定義し、その中のすべてのサブ要素をメイン要素と結合できます。 例えば、p 要素を統合する場合、p 要素内に表示される要素は、メインの p 要素と結合されます。 p 要素内のサブ要素に対しては、別のメモは作成されません。 次のスナップショットは、要素でフラット化されたノード構造 p 示しています。

{width="300"}

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

これで、AEM Site 出力を生成すると、p 要素内のノードが統合され、p 要素自体に保存されます。 CRXDE の p 要素の新しいフラット化プロパティを参照してください。

{width="650"}

AEM サイトノート構造のフラット化の防止

AEM Site 出力で統合するノードを指定するのと同様に、この設定から除外する要素を指定することもできます。 例えば、body の要素のノードを統合しても、body 内の table 要素を統合しない場合は、table 要素の定義内に exclude プロパティを追加できます。

table 要素をフラット化から除外するには、table 要素の定義に次のプロパティを追加します。

<preventancestorflattening>true|false</preventancestorflattening>

AEM Site 出力での削除済みページのバージョン管理の設定

「既存の出力ページ」設定で 削除および 作成 ​ ​オプションを選択してAEM サイト出力を生成すると、削除するページ\（s\）のバージョンが作成されます。 削除前にバージョンの作成を停止するようにシステムを設定できます。

次の手順を実行して、削除するページ\（s\）のバージョンの作成を停止します。

DITA-OT 経由での出力の公開でのメタデータの使用 id191LF0U0TY4

AEM Guidesには、DITA-OT を使用して出力を公開する際に、カスタムメタデータを渡す方法が用意されています。 管理者および公開者は、次のタスクを実行して、公開された出力にカスタムメタデータを設定して使用する必要があります。

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

すべての DITA マップの「プロパティ」 ページに新しいパラメータが表示されます。

{width="650"}

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

これで、DITA マップコンソールの プロパティ ドロップダウンリストにカスタムメタデータが表示されます。

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

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

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

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

/libs/fmdita/config/elementmapping.xml

定義済みの DITA エレメントマッピングを使用するか、カスタム AEM コンポーネントに DITA エレメントをマッピングできます。 カスタム 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 Guidesには、DITA マップコンソールの機能を柔軟に拡張する機能があります。 例えば、AEM Guidesで使用可能なものとは異なる一連のレポートがある場合、そのようなレポートをマップコンソールに追加できます。 マップコンソールをカスタマイズするには、必要な機能を実行するコードを含むAEM クライアントライブラリ \（または ClientLib \）を作成する必要があります。

AEM Guidesには、マップコンソールをカスタマイズするための apps.fmdita.dashboard-extn カテゴリが用意されています。 マップコンソールが読み込まれると、apps.fmdita.dashboard-extn カテゴリの下に作成された機能が実行されて読み込まれます。

出力生成時の画像レンディションの処理 id177BF0G0VY4

AEMには、アセットの処理に使用するデフォルトのワークフローとメディアハンドルのセットが付属しています。 AEMには、最も一般的な MIME タイプのアセット処理を処理するための事前定義済みワークフローがあります。 通常、アップロードする画像ごとに、AEMによって同じ画像の複数のレンディションがバイナリ形式で作成されます。 これらのレンディションは、サイズ、解像度、透かしの追加、その他の変更された特性が異なる場合があります。 AEMでのアセットの処理方法について詳しくは、AEM ドキュメントの メディアハンドラーとワークフローを使用したAssetsの処理を参照してください。

AEM Guidesでは、ドキュメントの出力を生成する際に使用する画像レンディションを設定できます。 例えば、デフォルトの画像レンディションの 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>

mimetype 要素は、ファイル形式の MIME タイプを指定します。 rendition output 要素は、出力形式のタイプと、指定した出力の公開に使用するレンディションの名前\（例：cq5dam.web.1280.1280.jpeg\）を指定します。 サポートされるすべての出力形式（AEMSITE、PDF、HTML 5、EPUB、カスタム）で使用する画像レンディションを指定できます。

指定したレンディションが存在しない場合、AEM Guides公開プロセスは、指定された画像の web レンディションを最初に検索します。 Web レンディションも見つからない場合は、画像の元のレンディションが使用されます。

出力履歴の自動パージ期間の設定 id19AAI070V8Q

出力を生成すると、出力が出力ログと共に作成されます。 大きな DITA マップの場合、これらのログはリポジトリ内に大量の領域を取る可能性があります。 デフォルトでは、ログはリポジトリ内の次の場所に保存されます。

/var/dxml/metadata/outputHistory/

時間が経つと、すべてのログファイルの全体のサイズが GB に達する可能性があります。 AEM Guidesでは、これらのログファイルをリポジトリに保持する期間を設定できます。 指定した期間が経過すると、ログは出力生成履歴と共にリポジトリから削除されます。

履歴パージ機能を設定すると、リポジトリ内のすべての DITA マップの出力生成に影響します。 DITA マップの「出力」タブでは、履歴は指定した日数が経過した後、設定で指定した時間にパージされます。

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

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

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

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

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

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