Einstellungen für die Ausgabegenerierung konfigurieren id181AI0B0E30

AEM Guides bietet viele Konfigurationsoptionen, mit denen Sie den Prozess der Ausgabenerstellung anpassen können. In diesem Abschnitt werden alle Konfigurationen und Anpassungen behandelt, die Ihnen beim Einrichten des Prozesses der Ausgabenerstellung helfen.

Konfigurieren der Registerkarte „Baseline“ im Dashboard „DITA-Zuordnung“ id223MD0D0YRM

Führen Sie die folgenden Schritte aus, um die Registerkarte „Baseline“ im DITA-Zuordnungs-Dashboard auszublenden:

Konfigurieren von gemischten Veröffentlichungen innerhalb einer bestehenden AEM-Site id1691I0V0MGR

Wenn Sie über eine AEM-Site verfügen, die DITA-Inhalte enthält, können Sie die Ausgabe Ihrer AEM-Site so konfigurieren, dass DITA-Inhalte an einem vordefinierten Speicherort innerhalb Ihrer Site veröffentlicht werden. Im folgenden Screenshot einer AEM Site-Seite ist beispielsweise der Knoten ditacontent für das Speichern von DITA-Inhalten reserviert:

Die verbleibenden Knoten auf der Seite werden direkt aus dem AEM-Website-Editor erstellt. Das Konfigurieren der Veröffentlichungseinstellung zum Veröffentlichen von DITA-Inhalten an einem vordefinierten Speicherort stellt sicher, dass keiner Ihrer vorhandenen Nicht-DITA-Inhalte durch den AEM Guides-Veröffentlichungsprozess geändert wird.

Sie müssen die folgenden Konfigurationen auf Ihrer vorhandenen Site durchführen, um die Veröffentlichung von DITA-Inhalten in einem vordefinierten Knoten zu ermöglichen:

Führen Sie die folgenden Schritte aus, um die Vorlageneigenschaften Ihrer vorhandenen Site zu konfigurieren:

Wenn Sie das nächste Mal DITA-Inhalte mithilfe der Vorlagenkonfigurationen Ihrer Site veröffentlichen, werden die Inhalte in den Knoten veröffentlicht, die in den topicContentNode- und topicHeadNode angegeben sind.

Anpassen der AEM-Site-Ausgabe id166TG0B30WR

AEM Guides unterstützt das Erstellen von Ausgaben in folgenden Formaten:

Für die Ausgabe der AEM-Site können Sie verschiedene Design-Vorlagen mit verschiedenen Ausgabeaufgaben zuweisen. Diese Design-Vorlagen können den DITA-Inhalt in verschiedenen Layouts rendern. Sie können beispielsweise verschiedene Design-Vorlagen für interne und externe Zielgruppen angeben.

Mit dem AEM Guides können Sie auch benutzerdefinierte DITA Open Toolkit (DITA-OT)-Plug-ins verwenden. Sie können diese benutzerdefinierten DITA-OT-Plug-ins hochladen, um die PDF-Ausgabe auf eine bestimmte Weise zu generieren.

Anpassen der Design-Vorlage für die Generierung von Ausgaben customize_xml-add-on

Der AEM Guides verwendet einen Satz vordefinierter Design-Vorlagen , um die Ausgabe der AEM-Site zu generieren. Sie können die AEM Guides-Design-Vorlagen anpassen, um die Ausgabe zu generieren, die Ihrem Unternehmensbranding entspricht. Eine Design-Vorlage ist eine Sammlung verschiedener Stile (CSS), Skripte (Server- und Client-seitig), Ressourcen (Bilder, Logos und andere Assets) und JCR-Knoten, die alle diese Ressourcen miteinander verbinden. Eine Design-Vorlage kann so einfach sein wie ein einzelnes Server-seitiges Skript mit nur einigen JCR-Knoten oder eine komplexe Kombination aus Stilen, Ressourcen und JCR-Knoten. Design-Vorlagen werden vom AEM Guides-Veröffentlichungs-Subsystem beim Generieren der AEM-Site-Ausgabe verwendet und steuern die Struktur, das Erscheinungsbild der generierten Ausgabe.

Es gibt keine Einschränkung bezüglich des Speicherorts der Ressourcen der Design-Vorlage auf dem Server, sie sind jedoch in der Regel gemäß ihrer Funktion logisch organisiert. Beispielsweise werden bei der Standardvorlage alle JavaScript- und CSS-Dateien im Ordner /etc/designs/fmdita/clientlibs/siteoutput/default gespeichert. Wo auch immer sich diese Dateien befinden, sie sind durch eine Sammlung von JCR-Knoten miteinander verknüpft. Zusammen bilden diese JCR-Knoten und die Dateien die gesamte Design-Vorlage.

Die mit der AEM Guides ausgelieferte Standard-Design-Vorlage ermöglicht die Anpassung der Komponenten der Landingpage, des Themas und der Suchseite. Sie können eine Kopie des Standarddesigns und der entsprechenden Referenzvorlagen erstellen und verschiedene Komponenten angeben, um die gewünschte Ausgabe zu generieren.

Führen Sie die folgenden Schritte aus, um Ihre eigene Design-Vorlage anzugeben, die für die Generierung der AEM-Site-Ausgabe verwendet werden soll:

Weitere Informationen finden Sie unter Erstellen der ersten Adobe Experience Manager-Website und Grundlagen Entwicklung einer eigenen Website in AEM.

Verwenden des Dokumenttitels zum Generieren der AEM-Site-Ausgabe

Beim Generieren der AEM-Site-Ausgabe spielt die Art und Weise, wie URLs generiert werden, eine wichtige Rolle für die Auffindbarkeit Ihrer Inhalte. Wenn Sie UUID-basierte Dateinamen verwenden, ist das Generieren von URLs, die auf der UUID Ihrer Dateien basieren, nicht suchfreundlich. Als Administrator oder Publisher haben Sie die Kontrolle darüber, wie Sie die URLs für die Ausgabe Ihrer AEM-Site generieren möchten. AEM Guides bietet eine Konfiguration, mit der Sie die URLs der AEM-Site-Ausgabe anhand des Dateinamens und nicht anhand der UUID-basierten Dateinamen generieren können. Standardmäßig ist diese Option für UUID-basierte Dateisysteme aktiviert. Dies bedeutet, dass beim Generieren der AEM-Site-Ausgabe für UUID-basierte Dateisysteme die Dateititel zum Generieren der URLs und nicht die UUIDs der Dateien verwendet werden.

Verwenden Sie die Anweisungen unter Konfigurationsüberschreibungen, um die Konfigurationsdatei zu erstellen. Geben Sie in der Konfigurationsdatei die folgenden (property)-Details an, um die URL-Generierung in der AEM-Site-Ausgabe zu konfigurieren:

Konfigurieren Sie die URL der Ausgabe der AEM-Site, um den Dokumenttitel zu verwenden

Sie können die Dokumenttitel in der URL der Ausgabe der AEM-Site verwenden. Wenn der Dateiname nicht vorhanden ist oder alle Sonderzeichen enthält, können Sie das System so konfigurieren, dass die Sonderzeichen durch ein Trennzeichen in der URL der AEM-Site-Ausgabe ersetzt werden. Sie können auch so konfigurieren, dass sie durch den Namen des ersten untergeordneten Themas ersetzt werden.

Um die Seitennamen zu konfigurieren, führen Sie die folgenden Schritte aus:

Wenn beispielsweise @navtitle in <topichead> alle Sonderzeichen enthält und Sie die aemsite.pagetitle-Eigenschaft auf „true“ setzen, wird standardmäßig ein Trennzeichen verwendet. Wenn Sie die nodename.systemDefinedPageName-Eigenschaft auf „true“ setzen, wird der Name des ersten untergeordneten Themas angezeigt.

Konfigurieren von Regeln zur Bereinigung von Dateinamen zum Erstellen von Themen und Veröffentlichen von Ausgaben in AEM Sites und anderen Formaten id2164D0KD0XA

Als Admin können Sie eine Liste gültiger Sonderzeichen definieren, die in Dateinamen zulässig sind, welche schließlich die URL einer AEM Site-Ausgabe bilden. In früheren Versionen durften Benutzende Dateinamen definieren, die Sonderzeichen wie @, $, > und mehr enthalten. Diese Sonderzeichen führten zu einer kodierten URL bei der Erstellung von AEM Site-Seiten.

Ab Version 3.8 wurden Konfigurationen hinzugefügt, um eine Liste von Sonderzeichen zu definieren, die in den Dateinamen zulässig sind. Standardmäßig enthält die gültige Dateinamenkonfiguration "a-z A-Z 0-9 - _". Dies bedeutet, dass Sie beim Erstellen einer Datei jedes Sonderzeichen im Titel der Datei haben können, aber intern wird es durch einen Bindestrich (-) im Dateinamen ersetzt. Beispielsweise können Sie den Titel der Datei als Einführung 1 oder Introduction@1 haben. Der entsprechende Dateiname, der für diese beiden Fälle generiert wird, wäre Einführung-1.

Beachten Sie beim Definieren einer Liste gültiger Zeichen, dass diese Zeichen "*/:[\]|#%{}?&<>"/+" und a space immer durch einen Bindestrich (-) ersetzt werden.

Verwenden Sie die Anweisungen unter Konfigurationsüberschreibungen, um die Konfigurationsdatei zu erstellen. Geben Sie in der Konfigurationsdatei die folgenden (property)-Details an, um die gültigen Sonderzeichen in Dateinamen und AEM Site-Ausgaben zu konfigurieren:

Sie können auch die anderen Eigenschaften konfigurieren, z. B. Kleinbuchstaben in Dateinamen, Trennzeichen zur Verarbeitung ungültiger Zeichen und die maximale Anzahl von in den Dateinamen zulässigen Zeichen. Um diese Eigenschaften zu konfigurieren, fügen Sie die folgenden Schlüsselwertpaare in der Konfigurationsdatei hinzu:

Konfigurieren des Reduzierens der Knotenstruktur der AEM-Site

Wenn Sie die Ausgabe der AEM-Site generieren, wird intern ein Knoten für jedes Element in den Themen erstellt. Bei einer DITA-Zuordnung mit Tausenden von Themen kann diese Knotenstruktur zu tief werden. Dieser Typ einer tief verschachtelten Knotenstruktur kann bei größeren Sites zu Leistungsproblemen führen. Der folgende Schnappschuss zeigt eine tief verschachtelte Knotenstruktur für eine AEM Site-Ausgabe:

Beachten Sie, dass im obigen Schnappschuss für jedes p Element und seine nachfolgenden Unterelemente ein Knoten erstellt wird und für jedes andere Element, das im Thema verwendet wird, eine ähnliche Struktur erstellt wird.

Mit AEM Guides können Sie konfigurieren, wie die Knotenstruktur der AEM-Site-Ausgabe intern erstellt wird. Sie können die Knotenstruktur an bestimmten Elementen reduzieren, was bedeutet, dass Sie ein Element definieren können, das als Hauptelement betrachtet wird, und alle darin enthaltenen Unterelemente mit dem Hauptelement zusammengeführt werden. Wenn Sie sich beispielsweise entscheiden, das p zu reduzieren, werden alle Elemente, die im p Element erscheinen, mit dem p zusammengeführt. Für kein Unterelement im p wird eine separate Anmerkung erstellt. Die folgende Momentaufnahme zeigt die an p Element reduzierte Knotenstruktur:

Führen Sie die folgenden Schritte aus, um die Knotenstruktur der AEM-Site zu reduzieren:

Wenn Sie jetzt die Ausgabe der AEM-Site generieren, werden die Knoten im p reduziert und im p selbst gespeichert. Sie finden die neuen Reduzierungseigenschaften für das p in CRXDE.

Suchen einer Zeichenfolge innerhalb des Inhalts in der Ausgabe der AEM-Site

Standardmäßig können Sie in den Titeln nur innerhalb der AEM-Site-Ausgabe nach einer Zeichenfolge suchen. Sie können das System so konfigurieren, dass sowohl in den Titeln als auch im Inhalt oder Hauptteil der AEM-Site-Ausgabe nach einer Zeichenfolge gesucht wird.

Um die Suche zu aktivieren, sollten Sie die Reduzierung der Knotenstruktur der AEM-Site konfigurieren.

VORSICHT:

Sie können bis zu 1 MB reduzierten Inhalt durchsuchen. Beispielsweise können Sie im vorherigen Screenshot suchen, ob der Inhalt unter dem Tag <p> <= 1 MB beträgt.

Reduzieren der Knotenstruktur der AEM-Site verhindern

Ähnlich wie bei Angabe des Knotens, der in der AEM-Site-Ausgabe reduziert werden soll, können Sie auch ein Element angeben, das Sie aus dieser Konfiguration ausschließen möchten. Wenn Sie beispielsweise Knoten an body Element reduzieren möchten, aber kein table Element in body reduzieren möchten, können Sie die Eigenschaft „exclude“ zur Definition des table hinzufügen.

Um das table-Element von der Reduzierung auszuschließen, fügen Sie die folgende Eigenschaft zur Definition des table-Elements hinzu:

<preventancestorflattening>true|false</preventancestorflattening>

Konfigurieren der Versionierung für gelöschte Seiten in der AEM Site-Ausgabe

Beim Generieren der AEM-Site Ausgabe mit der Option Löschen und ​ ​Erstellen) für die Einstellung Vorhandene Ausgabeseiten wird eine Version für die zu löschenden Seiten erstellt. Sie können das System so konfigurieren, dass die Erstellung einer Version vor dem Löschen gestoppt wird.

Führen Sie die folgenden Schritte aus, um die Erstellung einer Version für die zu löschenden Seiten zu stoppen:

Einrichten eines benutzerdefinierten Rewriters mit Experience Manager Guides custom-rewriter

Experience Manager Guides verfügt über ein benutzerdefiniertes Sling Rewriter-Modul für die Verarbeitung der Links, die bei Kreuzzuordnungen (Verknüpfungen zwischen den Themen zweier verschiedener Zuordnungen) generiert werden. Diese Rewriter-Konfiguration wird unter dem folgenden Pfad installiert:
/apps/fmdita/config/rewriter/fmdita-crossmap-link-patcher.

Wenn Sie einen anderen benutzerdefinierten Sling Rewriter in Ihrer Codebasis haben, verwenden Sie einen 'order' Wert größer als 50, da der Experience Manager Guides Sling Rewriter 'order' 50 verwendet. Um dies zu überschreiben, benötigen Sie einen Wert >50 . Weitere Informationen finden Sie unter Output-Umschreibungs-Pipelines.

Verwenden von Metadaten in der Veröffentlichungsausgabe über DITA-OT id191LF0U0TY4

AEM Guides bietet die Möglichkeit, benutzerdefinierte Metadaten beim Veröffentlichen von Ausgaben mit DITA-OT zu übergeben. Als Administrator und Publisher müssen Sie die folgenden Aufgaben ausführen, um benutzerdefinierte Metadaten in der veröffentlichten Ausgabe zu konfigurieren und zu verwenden:

Um die erforderlichen Metadaten im System hinzuzufügen, führen Sie die folgenden Schritte aus:

Der neue Parameter wird jetzt auf der Seite Eigenschaften für alle DITA-Zuordnungen angezeigt.

Als Nächstes müssen Sie die benutzerdefinierten Metadaten in der DITA-Zuordnungskonsole verfügbar machen. Führen Sie die folgenden Schritte aus, um die benutzerdefinierten Metadaten auf dem DITA Map-Dashboard verfügbar zu machen:

Jetzt werden die benutzerdefinierten Metadaten in der Dropdown-Liste Eigenschaften“ der DITA- angezeigt.

Als Publisher müssen Sie schließlich die benutzerdefinierten Metadaten in die veröffentlichte Ausgabe einbeziehen. Um die benutzerdefinierten Metadaten beim Generieren der Ausgabe zu verarbeiten, führen Sie die folgenden Schritte aus:

Die ausgewählten Eigenschaften/Metadaten werden an den Veröffentlichungsprozess übergeben und in der endgültigen Ausgabe verfügbar gemacht.

Validieren von Metadaten, die zur Verarbeitung an das DITA-OT übergeben werden

Um die an das DITA-OT übergebenen Metadatenwerte zu überprüfen, kann die lokale Umgebung mit einem Cloud-fähigen JAR verwendet werden. Da wir auf das lokale Dateisystem in der Cloud nicht zugreifen können, ist die einzige Möglichkeit, die Metadatendatei zu validieren, über ein Cloud-fähiges JAR.

Konfigurieren Sie das Befehlszeilenargumentfeld DITA-OT so, dass es Stammzuordnungsmetadaten akzeptiert

Um das DITA-OT-Befehlszeilenargumentfeld zum Übergeben von Stammzuordnungs-Metadaten zu verwenden, führen Sie die folgenden Schritte aus:

Anpassen der DITA-Elementzuordnung mit AEM-Komponenten id1679J600HEL

DITA-Elemente in AEM Guides werden den entsprechenden AEM-Komponenten zugeordnet. AEM Guides verwendet diese Zuordnung in Workflows wie Veröffentlichung und Überprüfung, um ein DITA-Element in eine entsprechende AEM-Komponente zu konvertieren. Die Zuordnung wird in der elementmapping.xml definiert, auf die über den Package Manager zugegriffen werden kann.

Sie können die vordefinierten DITA-Elementzuordnungen verwenden oder DITA-Elemente Ihren benutzerdefinierten AEM-Komponenten zuordnen. Um Ihre benutzerdefinierten AEM-Komponenten verwenden zu können, müssen Sie mit der Struktur der elementmapping.xml-Datei vertraut sein.

Struktur ElementMapping.xml

Im Folgenden wird ein allgemeiner Überblick über die elementmapping.xml-Struktur gegeben:

DITA-Element-Schema

Im Folgenden finden Sie ein Beispiel für das DITA-Elementschema in elementmapping.xml Datei :

<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>

In der folgenden Tabelle werden die Elemente im DITA-Elementschema beschrieben:

Zusätzliche Hinweise

Anpassen der DITA-Zuordnungskonsole id188HC08M0CZ

AEM Guides bietet Ihnen die Flexibilität, die Funktionen der DITA-Zuordnungskonsole zu erweitern. Wenn Sie beispielsweise über einen Berichtssatz verfügen, der sich von dem unterscheidet, der in der AEM Guides verfügbar ist, können Sie solche Berichte zur Zuordnungskonsole hinzufügen. Um die Zuordnungskonsole anzupassen, müssen Sie eine AEM-Client-Bibliothek (oder clientLib) erstellen, die den Code zur Durchführung der benötigten Funktionen enthält.

AEM Guides stellt die apps.fmdita.dashboard-extn zum Anpassen der Zuordnungskonsole bereit. Wenn die Zuordnungskonsole geladen wird, wird die unter der Kategorie apps.fmdita.dashboard-extn erstellte Funktion ausgeführt und geladen.

Verarbeiten der Bildausgabedarstellung während der Ausgabegenerierung id177BF0G0VY4

AEM enthält einen Satz von standardmäßigen Workflows und Medien-Handles zur Verarbeitung von Assets. In AEM gibt es vordefinierte Workflows für die Asset-Verarbeitung für die gängigsten MIME-Typen. Normalerweise erstellt AEM für jedes Bild, das Sie hochladen, mehrere Ausgabedarstellungen desselben Bilds im Binärformat. Diese Ausgabedarstellungen können unterschiedlich groß sein, eine andere Auflösung, ein hinzugefügtes Wasserzeichen oder eine andere geänderte Eigenschaft aufweisen. Weitere Informationen zum Verarbeiten von Assets durch AEM finden Sie unter Verarbeiten von Assets mit Medien-Handlern und Workflows in der Dokumentation zu AEM.

Mit AEM Guides können Sie konfigurieren, welche Bildausgabe zum Zeitpunkt der Generierung der Ausgabe für Ihre Dokumente verwendet werden soll. Sie können beispielsweise aus einer der standardmäßigen Bildausgabedarstellungen auswählen oder eine erstellen und dieselbe zum Veröffentlichen Ihrer Dokumente verwenden. Die Bildausgabedarstellungszuordnung zum Veröffentlichen Ihrer Dokumente wird in der /libs/fmdita/config/ **renditionmap.xml**-Datei gespeichert. Ein Ausschnitt renditionmap.xml Datei lautet wie folgt:

<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>

Das mimetype gibt den MIME-Typ des Dateiformats an. Das rendition output-Element gibt den Typ des Ausgabeformats und den Namen der Ausgabedarstellung (z. B. cq5dam.web.1280.1280.jpeg) an, die zum Veröffentlichen der angegebenen Ausgabe verwendet werden soll. Sie können die Bildausgabedarstellungen angeben, die für alle unterstützten Ausgabeformate verwendet werden sollen - AEMSITE, PDF, HTML5, EPUB und CUSTOM.

Wenn die angegebene Ausgabedarstellung nicht vorhanden ist, sucht der AEM Guides-Veröffentlichungsprozess zunächst nach der Web-Ausgabedarstellung des angegebenen Bildes. Wenn selbst die Web-Ausgabedarstellung nicht gefunden wird, wird die ursprüngliche Ausgabedarstellung des Bildes verwendet.

Automatische Bereinigungsperiode für den Ausgabegeschverlauf konfigurieren id19AAI070V8Q

Wenn Sie eine Ausgabe generieren, wird die Ausgabe zusammen mit den Ausgabeprotokollen erstellt. Bei großen DITA-Zuordnungen können diese Protokolle eine große Menge an Speicherplatz in Ihrem Repository beanspruchen. Standardmäßig werden die Protokolle an folgendem Speicherort im Repository gespeichert:

/var/dxml/metadata/outputHistory

Über einen bestimmten Zeitraum hinweg konnte die Gesamtgröße aller Protokolldateien GB erreichen. Mit AEM Guides können Sie einen Zeitraum konfigurieren, während dessen diese Protokolldateien im Repository gespeichert werden. Nach dem angegebenen Zeitraum werden die Protokolle zusammen mit dem Verlauf der Ausgabegenerierung aus dem Repository gelöscht.

Die Konfiguration der Verlaufsbereinigung wirkt sich auf die Ausgabegenerierung für alle DITA-Zuordnungen im Repository aus. Auf der Registerkarte Ausgaben einer DITA-Zuordnung wird der Verlauf nach der angegebenen Anzahl von Tagen und zu dem in der Einstellung angegebenen Zeitpunkt gelöscht.

Verwenden Sie die Anweisungen unter Konfigurationsüberschreibungen, um die Konfigurationsdatei zu erstellen. Geben Sie in der Konfigurationsdatei die folgenden (property)-Details an, um einen Tag und eine Uhrzeit für die Bereinigung des Ausgabegeschichtverlaufs und der Protokolle festzulegen:

Ändern des Listenlimits für zuletzt generierte Ausgaben id1679JH0H0O2

Sie können die maximale Anzahl generierter Ausgaben ändern, die auf der Registerkarte Ausgaben für eine DITA-Zuordnung angezeigt werden.

Verwenden Sie die Anweisungen unter Konfigurationsüberschreibungen, um die Konfigurationsdatei zu erstellen. Geben Sie in der Konfigurationsdatei die folgenden (Eigenschaft)-Details ein, um die Anzahl der in der Liste anzuzeigenden Ausgaben zu ändern: