AEM Sites-Vorgaben im Web-Editor
Sie können AEM Sites-Vorgaben im Web Editor erstellen und so konfigurieren, dass die AEM Sites-Ausgabe generiert wird. Die AEM Sites-Ausgabe basiert auf dem Mapping der zusammengesetzten Komponenten zusammen mit dem Tag "guides-components", was die effiziente Erstellung und Verwaltung von Inhalten erleichtert.
Experience Manager Guides stellt vordefinierte Vorlagen zum Erstellen von AEM Sites bereit. Mithilfe dieser Vorgaben können Sie ein konsistentes Inhaltslayout und eine konsistente Inhaltsstruktur gewährleisten.
- Erstellen Sie Startseiten anhand dieser vordefinierten Vorlagen.
- Sie können Themenvorlagen bearbeiten und Stile entsprechend Ihren Anforderungen anwenden.
- Sie können auch vorhandene AEM Sites-Vorlagen anpassen.
Erstellen von AEM Sites-Vorgaben
Führen Sie die folgenden Schritte aus, um die AEM Sites-Vorgaben im Web Editor zu erstellen:
- Öffnen Sie im Bereich "Repository"die DITA-Map-Datei in der Kartenansicht.
- Wählen Sie auf der Registerkarte Ausgabe das Symbol + aus, um eine Ausgabevorgabe zu erstellen.
- Wählen Sie AEM Sites aus der Dropdown-Liste Typ im Dialogfeld Neue Ausgabevorgabe aus.
- Deaktivieren Sie im Dialogfeld Neue Ausgabevorgabe die Option Legacy-Komponentenzuordnung verwenden .
- On-Premise-Software: Erfahren Sie mehr über das Herunterladen und Installieren von AEM Sites-Vorlagen für On-Premise-Software.
- Cloud Service: Erfahren Sie mehr über das Herunterladen und Installieren von AEM Sites-Vorlagen für den Cloud Service.
Hinzufügen von Vorgaben zum aktuellen Ordnerprofil
Als Administrator können Sie mit Experience Manager Guides Ausgabevorgaben für die globalen und Ordnerprofile erstellen und verwalten. Wählen Sie im Dialogfeld Neue Ausgabevorgabe die Option Zum aktuellen Ordnerprofil hinzufügen aus, um eine Ausgabevorgabe für das aktuelle Ordnerprofil zu erstellen. Das Symbol "
AEM Sites-Vorgaben basierend auf der alten Komponentenzuordnung
Sie können die AEM Sites-Vorgaben auch mit der alten Komponentenzuordnung erstellen. Um die AEM Sites-Vorgaben basierend auf der alten Komponentenzuordnung zu erstellen, wählen Sie im Dialogfeld Neue Ausgabevorgabe die Option Alte Komponentenzuordnung verwenden aus.
Einige Optionen unterscheiden sich möglicherweise für die Vorgaben, die die ältere Komponentenzuordnung verwenden.
Konfigurieren der AEM Sites-Vorgaben
Die Konfigurationen befinden sich auf den Registerkarten Allgemein, Inhalt, Themenliste und Querverweise.
Allgemein
Die Registerkarte Allgemein enthält die folgenden Konfigurationen zur Generierung von Ausgaben:
-
Verwenden des Site-Pfads
-
Site-Pfad
-
Site
-
Publish-Pfad
-
Themenseitenvorlage
-
Generieren von Seitennamen basierend auf
- Themendateiname
- Thementitel
-
Zuvor generierte Seiten bereinigen
- Löschen zuvor generierter Seiten für Themen, die aus der Zuordnung entfernt wurden
- Löschen Sie alle Seiten, die von anderen Quellen unter diesem Pfad erstellt wurden:
-
Workflow nach der Erstellung
Inhalt
Die Registerkarte Inhalt enthält die folgenden Konfigurationen:
-
Grundlinie verwenden
-
Bedingungsfilterung
-
Zusätzliche DITA-OT-Befehlszeilenargumente
-
Metadaten
- Dateieigenschaften (Assets)
- Verwenden von Zuordnungseigenschaften als Fallback
Weitere Informationen finden Sie unter AEM Sites-Konfiguration.
Themenliste
Die Themenliste zeigt die Liste der Themen an, die in der aktuellen Arbeitskopie der DITA-Zuordnung vorhanden sind. Standardmäßig sind alle Themen eingeschlossen. Sie können bestimmte Themen auswählen und die AEM Sites-Ausgabe nur für sie generieren. Beispielsweise haben Sie einige Themen aktualisiert, sodass Sie nur diese Themen veröffentlichen können, anstatt die gesamte DITA-Map zu veröffentlichen.
Die Registerkarte Themenliste ist in den AEM Vorgaben vorhanden, die nicht basierend auf der alten Zuordnung erstellt werden.
Querverweise
Diese Liste enthält Themen, die Querverweise mit scope =”peer” enthalten. Sie können den Veröffentlichungskontext für eine Liste von Querverweisen mit scope=”peer” zu Themen angeben, die in anderen DITA-Maps verfügbar sind. Diese Registerkarte wird angezeigt, wenn Sie die Experience Manager Guides-Version (UUID) verwenden.
Erfahren Sie mehr über das Veröffentlichen von verknüpften Themen.
AEM Sites-Konfiguration aem_sites_config
Die folgenden Optionen sind für die AEM Sites-Ausgabe verfügbar:
Wählen Sie das Aktualisierungssymbol Aktualisieren
AEMG-Docs und den Publish-Pfad als aemg-docs-en/docs/product-abc. angeben, wird die AEM Sites-Ausgabe unter dem Knoten aemg-docs-en/docs/product-abc/ in crx/de generiert.Thementitel: Verwendet den DITA-Thementitel, um die Experience Manager-Site-Namen zu erstellen.
Angenommen, Sie haben eine DITA-Zuordnung veröffentlicht, die die Themen a.dita, b.dita und c.dita enthält. Bevor Sie die Zuordnung erneut veröffentlichen, haben Sie das Thema b.dita aus der Zuordnung entfernt. Wenn Sie jetzt diese Option ausgewählt haben, werden alle Inhalte, die sich auf b.dita beziehen, aus der AEM Sites-Ausgabe entfernt und nur a.dita und c.dita werden veröffentlicht.
Hinweis: Informationen zu gelöschten Seiten werden auch in den Ausgabegenerierungsprotokollen erfasst. Weitere Informationen zum Zugriff auf die Protokolldateien finden Sie unter Anzeigen und Überprüfen der Protokolldatei.
Vorsicht: Beim Löschen der Themen stehen die Seiten nicht mehr auf der veröffentlichten Site zur Verfügung. Bevor die Themen gelöscht werden, wird also eine Warnung angezeigt. Sie müssen bestätigen, dass Sie sie löschen möchten.
- Löschen aller Seiten, die von anderen Quellen in diesem Pfad erstellt wurden: Wenn Sie diese Option auswählen, werden alle Seiten, die auf diesem Pfad aus anderen Maps, einzelnen Themen oder einer anderen Quelle veröffentlicht wurden, gelöscht. Die Seiten stehen auch nicht mehr auf der veröffentlichten Site zur Verfügung. Bevor die Themen gelöscht werden, wird also eine Warnung angezeigt. Sie müssen bestätigen, dass Sie sie löschen möchten.
Wichtig: Wenn Sie eine inkrementelle Ausgabe für die AEM Site generieren, wird die Ausgabe mit der aktuellen Version der Dateien und nicht mit der angehängten Grundlinie erstellt.
Anzeigen Arbeiten mit Grundlinie für weitere Details.
None: Wählen Sie diese Option aus, wenn Sie keine Bedingung auf die veröffentlichte Ausgabe anwenden möchten.
DITAVAL verwenden: Wählen Sie DITAVal-Dateien aus, um konditionalisierte Inhalte zu generieren. Sie können mehrere DITAVal-Dateien über das Dialogfeld "Durchsuchen"oder durch Eingabe des Dateipfads auswählen. Verwenden Sie das Kreuzsymbol neben dem Dateinamen, um ihn zu entfernen. DITAVal-Dateien werden in der angegebenen Reihenfolge ausgewertet, sodass die in der ersten Datei angegebenen Bedingungen Vorrang vor den in späteren Dateien angegebenen Bedingungen haben. Sie können die Dateireihenfolge beibehalten, indem Sie Dateien hinzufügen oder löschen. Wenn die DITAVal-Datei an einen anderen Speicherort verschoben oder gelöscht wird, wird sie nicht automatisch aus dem Mapping-Dashboard gelöscht. Sie müssen den Speicherort aktualisieren, falls Dateien verschoben oder gelöscht werden. Sie können den Mauszeiger über den Dateinamen bewegen, um den Pfad im AEM Repository anzuzeigen, in dem die Datei gespeichert ist. Sie können nur DITAVal-Dateien auswählen. Ein Fehler wird angezeigt, wenn Sie einen anderen Dateityp auswählen.
Bedingungsvorgabe: Wählen Sie aus der Dropdown-Liste eine Bedingungsvorgabe aus, um beim Veröffentlichen der Ausgabe eine Bedingung anzuwenden. Diese Option ist sichtbar, wenn Sie eine Bedingung für die DITA-Map-Datei hinzugefügt haben. Die bedingten Einstellungen sind auf der Registerkarte Bedingungsvorgaben der DITA-Zuordnungskonsole verfügbar. Weitere Informationen zur Bedingungsvorgabe finden Sie unter Bedingungsvorgaben verwenden.
Dateieigenschaften (Assets)
Hinweis: Bei den Metadateneigenschaften wird zwischen Groß- und Kleinschreibung unterschieden.
Wenn Sie eine Grundlinie ausgewählt haben, basieren die Werte für die Eigenschaften auf der Version der ausgewählten Grundlinie. Wenn Sie keine Grundlinie ausgewählt haben, basieren die Werte für die Eigenschaften auf der neuesten Version.
Sie können die Metadaten auch mithilfe der DITA-OT-Veröffentlichung an die Ausgabe übergeben. Für weitere Details übergeben Sie die Metadaten mithilfe von DITA-OT🔗 an die Ausgabe.
Hinweis: Wenn Sie die
cq:tags in der Option "Eigenschaften"nicht definiert haben, werden die Werte für cq:tags aus der aktuellen Arbeitskopie ausgewählt, selbst wenn Sie eine Grundlinie für die Veröffentlichung ausgewählt haben.Verwenden Sie Zuordnungseigenschaften als Fallback
Nur String-, Datum- oder Long-Eigenschaften (einzelne und mehrere Werte) können an die AEM Site-Seiten übergeben werden. Die Metadatenwerte für eine Eigenschaft vom Typ String unterstützen keine Sonderzeichen (z. B.
@, #, " ").* Diese Option sollte zusammen mit der
Properties -Option verwendet werden.Nachdem Sie die Ausgabe generiert haben, wählen Sie das Symbol Temporäre Dateien herunterladen
Hinweis: Wenn Dateieigenschaften während der Generierung hinzugefügt werden, enthalten die temporären Ausgabedateien auch eine metadata.xml -Datei, die diese Eigenschaften enthält.
Generieren der AEM Sites-Ausgabe mithilfe der Vorlagen
Mit Experience Manager Guides können Sie die vordefinierten Vorlagen verwenden oder eigene AEM Sites-Vorlagen hinzufügen.
Bevor Sie die AEM Sites-Vorgaben konfigurieren, stellen Sie sicher, dass Sie eine AEM Sites-Struktur mithilfe der Vorlagen erstellen.
Weitere Informationen finden Sie unter Herunterladen und Installieren von AEM Sites-Vorlagen.
Führen Sie die folgenden Schritte aus, um eine AEM Sites-Vorgabe zu erstellen und zu konfigurieren:
-
Öffnen Sie die Registerkarte Ausgabevorgaben der DITA-Map, die Sie veröffentlichen möchten.
-
Wählen Sie die Ausgabevorgabe AEM Sites aus.
-
(Optional) Deaktivieren Sie die Option Legacy component mapping , um eine nicht ältere AEM Sites-Vorgabe zu erstellen.
-
Klicken Sie auf Hinzufügen. Die Vorgabe für AEM Sites wird erstellt.
-
Sie können die Vorlage für native Sites auf zwei Arten konfigurieren:
-
Wählen Sie Site und dann den Veröffentlichungspfad und die Themenseitenvorlagen aus den ausgefüllten Optionen aus:
- Wählen Sie die Site aus.
- Wählen Sie Site aus. Zum Beispiel:
AEMG Docs. - Die Optionen Publish-Pfad und Themenseitenvorlage werden automatisch in der Dropdown-Liste festgelegt. Sie können auch die Optionen auswählen. Beispielsweise werden
AEMG-Docs-Site/en/docs/product1undTopic pageeingestellt.
-
Wählen Sie den vollständigen Site-Pfad aus:
- Wählen Sie die Option Site-Pfad verwenden aus.
- Wählen Sie den vollständigen Site-Pfad aus. Zum Beispiel:
/content/AEMG-Docs-Site/en/docs/product1. - Die "Topic page template"wird automatisch auf
Topic Pagegesetzt.
-
-
Speichern Sie die an der Vorgabe vorgenommenen Änderungen.
-
Wählen Sie die Option Erzeugen aus.
-
Generieren Sie AEM Sites für die entsprechende Zuordnung. Zum Beispiel:
/content/AEMG-Docs-Site/en/docs/product.note note NOTE Wenn Sie zum ersten Mal Inhalte auf einer AEM Site veröffentlichen, wird empfohlen, die Seiten auf Site-Ebene zu veröffentlichen. Dadurch wird sichergestellt, dass die Ausgabe auf der Instanz Publish ohne CSS-Unterbrechung korrekt angezeigt wird.
Verknüpfte Publish-Themen
Experience Manager Guides vereinfacht die Veröffentlichung komplexer Dokumente, indem es Ihnen ermöglicht, Themenverweise mit dem peer @scope zu erstellen. Anschließend können Sie den Veröffentlichungskontext dieser Verweise aus den AEM Sites-Vorgaben definieren und schließlich die Ausgabe der verknüpften Themen generieren.
Weitere Informationen finden Sie unter Generate output of linking topics from other maps.
Führen Sie die folgenden Schritte aus, um den Veröffentlichungskontext für verknüpfte Dateien anzugeben:
-
Öffnen Sie die Registerkarte Ausgabevorgaben der DITA-Map, die Sie veröffentlichen möchten.
-
Wählen Sie die Ausgabevorgabe AEM Sites aus.
Sie können die Registerkarten "Allgemein", "Inhalt", "Themenliste"und "Querverweise"anzeigen. Die Registerkarte "Querverweise"wird angezeigt, wenn Sie die Experience Manager Guides-Version (UUID) verwenden.
In den folgenden Fällen können Sie die Querverlinkung nicht anzeigen:
- Für die Vorgaben, die vor Version 4.6 erstellt wurden. Die Registerkarte Querverweise ist deaktiviert und es wird eine QuickInfo angezeigt, siehe Dashboard zuordnen .
- Für Vorgaben, die über das Mapping-Dashboard erstellt wurden. Weitere Informationen finden Sie in der QuickInfo zum Dashboard zuordnen .
- Informationen zu OOTB-Vorgaben finden Sie in der QuickInfo zum Zuordnen des Dashboard-Tools .
- Erstellen Sie für globale Vorgaben eine lokale Kopie dieser globalen Vorgabe, um Querverweise für die Zuordnung festzulegen.
Wenn Sie AEM Sites-Vorgaben aus dem Web Editor verwenden möchten, erstellen Sie entweder eine neue Vorgabe oder duplizieren Sie die vorhandene.
-
Öffnen Sie die Registerkarte Querverweise.
Ihnen wird eine Liste der Themen und ihrer Verweise angezeigt. Sie können den Veröffentlichungskontext für eine Liste von Querverweisen zu Themen angeben, die in anderen DITA-Maps mit
scope=”peer”verfügbar sind.Um das Querverweisbedienfeld vom Web Editor verwenden zu können, muss
<xrefs>über eindeutige IDs verfügen. Eindeutige IDs für<xrefs>werden beim Bearbeiten/Speichern des älteren Inhalts automatisch generiert, wenn die ID nicht vorhanden ist.note note NOTE Auf der Registerkarte Querverweise werden Themen angezeigt, die nur mit dem Wert scope=”peer”verknüpft sind. Für Links mitscope=”local”müssen Sie den Veröffentlichungskontext nicht angeben.Bei allen verknüpften Themen ist standardmäßig die neueste Ausgabevorgabe und Zuordnung ausgewählt. Der Veröffentlichungskontext für alle verknüpften Themen ist standardmäßig auf
<Most recently generated>map festgelegt.
-
Wenn Sie die zuletzt veröffentlichte Ausgabe jeder abhängigen Datei in der Zuordnung verwenden möchten, wählen Sie Zuletzt generierten Veröffentlichungskontext verwenden für alle abhängigen Themen aus.
Sie sollten die als übergeordnete Zuordnung ausgewählte Zuordnung veröffentlichen, bevor Sie die Zuordnung mit verknüpften Themen veröffentlichen. Wenn die Zuordnung mit verknüpften Themen nicht veröffentlicht wird, erscheinen die Links in der AEM Sites-Ausgabe als normaler Text anstelle von Hyperlinks.
Sie sollten denselben Typ der AEM Sites-Vorgabe für das verknüpfte Thema auswählen. Wenn die aktuelle AEM Sites-Vorgabe beispielsweise die Zuordnung älterer Komponenten verwendet, wählen Sie eine ähnliche AEM Sites-Vorgabe des verknüpften Themas aus. -
Wählen Sie in der Dropdown-Liste "Übergeordnete Zuordnung"die Zuordnungsdatei aus, mit deren Ausgabe Sie die Ausgabe der aktuellen Zuordnung verknüpfen möchten.
Wenn Sie eine Zuordnungsdatei auswählen, wird die UUID der Zuordnung in der Spalte "Übergeordnete Map-UUID"angezeigt. Die mit der ausgewählten Zuordnung verknüpften Ausgabevorgaben werden in der Liste Voreinstellungen der übergeordneten Zuordnung aufgeführt. Beispielsweise enthält Thema 1 in Karte A einen Verweis auf Thema 2. Thema 2 kann in einer oder mehreren Maps vorhanden sein. Sie können für jeden Link die übergeordnete Zuordnung und eine bestimmte Vorgabe oder die zuletzt veröffentlichte Ausgabe auswählen. -
Wenn dasselbe Thema mehr als einmal in einer Datei referenziert wird, können Sie für jede Instanz einen anderen Veröffentlichungskontext hinzufügen. Dies bietet mehr Flexibilität und Kontrolle über den Inhalt. Zum Beispiel ist Thema 3 sowohl in Karte B als auch in Karte C vorhanden. Thema 1 enthält zwei Verweise auf Thema 3. Sie können Map B als übergeordnete Zuordnung für den ersten Link und Map C als übergeordnete Zuordnung für den zweiten Link auswählen.
-
Wählen Sie in der Dropdown-Liste Voreinstellung der übergeordneten Zuordnung die Ausgabevorgabe aus, mit der Sie die Ausgabe der aktuellen Zuordnung verknüpfen möchten.
note note NOTE Die verschiedenen AEM Sites-Vorgaben der aktuellen Karte werden in der Dropdown-Liste angezeigt. Wenn Sie keine Vorgabe auswählen, wird ein Warnsymbol angezeigt und die Ausgabegenerierung schlägt fehl. 1. Wählen Sie die erforderliche Zuordnung und deren Ausgabevorgabe für alle Quellthemen und dann **Erzeugen** aus.
Übergeordnetes Thema: Grundlegendes zu den Ausgabevorgaben