AEM Sites-Vorgabe in der Zuordnungskonsole
Sie können die AEM Sites-Vorgabe über die Zuordnungskonsole erstellen und sie so konfigurieren, dass sie die AEM Sites-Ausgabe generiert. Es gibt zwei Möglichkeiten, die AEM Sites-Ausgabe zu erstellen:
Verwenden der Zuordnung von zusammengesetzten Komponenten
Die Zuordnung zusammengesetzter Komponenten bietet eine schnellere und skalierbare Veröffentlichung in AEM Sites im Vergleich zur bisherigen Komponentenzuordnung. Sie enthält im Lieferumfang enthaltene bearbeitbare Vorlagen, die mithilfe des AEM-Vorlageneditors Ihren Anforderungen entsprechend angepasst werden können. Die Vorlagen verwenden eine Mischung aus WCM-Kernkomponenten und spezialisierten guides-components, um sicherzustellen, dass Ihre Endbenutzer das beste Erlebnis auf Ihren AEM Sites-Seiten erhalten. Sie können Ihre vorhandenen Vorlagen auch mithilfe der Zuordnungsmethode für zusammengesetzte Komponenten anpassen.
Experience Manager Guides bietet vordefinierte Vorlagen zum Erstellen von AEM Sites. Mit diesen Vorlagen können Sie Konsistenz im Inhaltslayout und in der Inhaltsstruktur sicherstellen.
- Erstellen Sie Startseiten basierend auf diesen vordefinierten Vorlagen.
- Sie können Themenvorlagen bearbeiten und Stile Ihren Anforderungen entsprechend anwenden.
- Sie können auch vorhandene AEM Sites-Vorlagen anpassen.
AEM Sites-Voreinstellung erstellen
Führen Sie die folgenden Schritte aus, um die AEM Sites-Vorgabe mithilfe der Zuordnung zusammengesetzter Komponenten zu erstellen:
-
Öffnen Sie die DITA-Zuordnungsdatei in der Zuordnungskonsole.
-
Wählen Sie Bedienfeld "" das Symbol + , um eine Ausgabevorgabe zu erstellen.
-
Wählen Sie AEM Sites aus der Dropdown Liste „Typ im Dialogfeld Neue) aus.
-
Deaktivieren Sie die Option Veraltete Komponentenzuordnung verwenden.
-
Wählen Sie die Zum aktuellen Ordnerprofil hinzufügen, um eine Ausgabevorgabe innerhalb des aktuellen Ordnerprofils zu erstellen. Das
gibt eine Vorgabe auf Ordnerprofilebene an.Weitere Informationen zu Verwalten globaler und Ordnerprofil-Ausgabevorgaben.
-
Wählen Sie Hinzufügen aus.
Die Voreinstellung für AEM Sites wird erstellt.
{width="300"}
AEM Sites-Vorgabenkonfiguration für die Zuordnung von zusammengesetzten Komponenten
- 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 darüber, wie Sie AEM Sites-Vorlagen herunterladen und installieren für Cloud Service.
In der Zuordnungskonsole sind die voreingestellten Konfigurationsoptionen für die Zuordnung zusammengesetzter Komponenten auf den folgenden Registerkarten organisiert:
- Allgemein
- Inhalt
- Themenliste
- Querverweise auf Zuordnungen
Allgemein
Die Allgemein enthält die folgenden Konfigurationsoptionen:
Sie können beim Festlegen des Site-Pfads auch Variablen verwenden. Weitere Informationen finden Sie unter Verwenden von Variablen zum Festlegen der Optionen Zielpfad, Site-Name oder Dateiname
Wählen Sie Aktualisieren
AEMG-Docs und den Veröffentlichungspfad als aemg-docs-en/docs/product-abc. angeben, wird die AEM Sites-Ausgabe unter dem aemg-docs-en/docs/product-abc/ in crx/de generiert.Thementitel: Verwendet den Titel des DITA-Themas zum Erstellen der Experience Manager-Site-Namen.
Angenommen, Sie haben eine DITA-Karte veröffentlicht, die die Themen a.dita, b.dita und c.dita enthält. Bevor Sie die Karte erneut veröffentlichen, haben Sie das Thema b.dita aus der Karte entfernt. Wenn Sie diese Option jetzt ausgewählt haben, wird der gesamte Inhalt, der mit b.dita zusammenhängt, aus der AEM Sites-Ausgabe entfernt und nur a.dita und c.dita werden veröffentlicht.
Hinweis: Informationen zu gelöschten Seiten werden ebenfalls in den Ausgabegenerierungsprotokollen erfasst. Weitere Informationen zum Zugriff auf die Protokolldateien finden Sie Anzeigen und Überprüfen der Protokolldatei.
Achtung: Beim Löschen der Themen sind die Seiten dann nicht mehr auf der veröffentlichten Site verfügbar. Bevor die Themen gelöscht werden, wird eine Warnung angezeigt. Sie müssen das Löschen bestätigen.
- Löschen Sie alle Seiten, die von anderen Quellen unter diesem Pfad erstellt wurden: Wenn Sie diese Option auswählen, werden alle Seiten, die unter diesem Pfad aus anderen Karten, einzelnen Themen oder einer anderen Quelle veröffentlicht wurden, gelöscht. Die Seiten werden auch auf der veröffentlichten Site nicht mehr verfügbar sein. Bevor die Themen gelöscht werden, wird eine Warnung angezeigt. Sie müssen das Löschen bestätigen.
Inhalt
Die Inhalt-Registerkarte enthält die folgenden Konfigurationsoptionen:
Weitere Informationen finden Sie „Arbeiten mit ".
None: Wählen Sie diese Option aus, wenn Sie keine Bedingung auf die veröffentlichte Ausgabe anwenden möchten.
Verwenden von DITAVAL: Wählen Sie DITAVal-Datei(en) aus, um bedingte Inhalte zu generieren. Sie können mehrere DITAVal-Dateien über das Dialogfeld „Durchsuchen“ oder durch Eingabe des Dateipfads auswählen. Verwenden Sie das Kreuz-Symbol 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 übereinstimmenden Bedingungen haben. Sie können die Dateireihenfolge durch Hinzufügen oder Löschen von Dateien beibehalten. Wenn die DITAVal-Datei an einen anderen Speicherort verschoben oder gelöscht wird, wird sie nicht automatisch aus dem Zuordnungs-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. Wenn Sie einen anderen Dateityp auswählen, wird ein Fehler angezeigt.
Bedingungsvorgabe: Wählen Sie in der Dropdown-Liste eine Bedingungsvorgabe aus, um eine Bedingung beim Veröffentlichen der Ausgabe anzuwenden. Diese Option ist sichtbar, wenn Sie eine Bedingung für die DITA-Zuordnungsdatei hinzugefügt haben. Die bedingten Einstellungen sind auf der Registerkarte „Bedingungsvorgaben“ der DITA-Zuordnungskonsole verfügbar. Weitere Informationen zu Bedingungsvorgaben finden Sie unter Verwenden von Bedingungsvorgaben.
Dateieigenschaften (Assets)
Hinweis: Bei den Metadateneigenschaften wird zwischen Groß- und Kleinschreibung unterschieden.
Wenn Sie eine Baseline ausgewählt haben, basieren die Werte für die Eigenschaften auf der Version der ausgewählten Baseline. Wenn Sie keine Baseline ausgewählt haben, basieren die Werte für die Eigenschaften auf der neuesten Version.
Sie können die Metadaten auch mithilfe von DITA-OT-Publishing an die Ausgabe übergeben. Für eine weitere Detailansicht ( Sie die Metadaten mithilfe von DITA-OT an die Ausgabe .
Hinweis: Wenn Sie die
cq:tags nicht in der Option Eigenschaften definiert haben, werden die Werte für cq:tags aus der aktuellen Arbeitskopie ausgewählt, selbst wenn Sie eine Baseline für die Veröffentlichung ausgewählt haben.Verwenden von Zuordnungseigenschaften als Fallback
Nur Zeichenfolgen-, Datums- oder Lange-Eigenschaften (einzelne und mehrwertige Eigenschaften) können an die Seiten der AEM-Site übergeben werden. Die Metadatenwerte für eine Eigenschaft vom Typ Zeichenfolge unterstützen keine Sonderzeichen (z. B.
@, #, " ").* Diese Option sollte zusammen mit der Option
Properties verwendet werden.Themenliste
Auf Registerkarte Themenliste) wird die Liste der Themen angezeigt, die in der aktuellen Arbeitskopie der DITA-Zuordnung vorhanden sind. Standardmäßig sind alle Themen enthalten. Sie können bestimmte Themen auswählen und die AEM Sites-Ausgabe nur für sie generieren. Sie haben beispielsweise einige Themen aktualisiert, sodass Sie nur diese Themen veröffentlichen können, anstatt die gesamte DITA-Karte zu veröffentlichen.
Querverweise auf Zuordnungen
Diese Liste enthält Themen mit Querverweisen auf scope ="peer". Sie können den Veröffentlichungskontext für eine Liste von Querverweiskarten mit scope="peer" zu Themen angeben, die in anderen DITA-Zuordnungen verfügbar sind. Diese Registerkarte wird angezeigt, wenn Sie die Experience Manager Guides-Version (UUID) verwenden.
Weitere Informationen finden Sie im Abschnitt Arbeiten mit verknüpften Themen unten.
Speichern Sie nach der Konfiguration die vorgenommenen Änderungen an der Voreinstellung und wählen Sie Generieren aus, um AEM Sites für die entsprechende Zuordnung zu generieren.
Verwenden der Zuordnung veralteter Komponenten
Die Schritte zum Erstellen der AEM Sites-Vorgabe mit der Zuordnung veralteter Komponenten sind mit denen identisch, die im Abschnitt Zuordnung zusammengesetzten Komponenten“ oben beschrieben wurden. Stellen Sie jedoch beim Erstellen der Vorgabe sicher, dass Sie die Option Alte Komponentenzuordnung verwenden im Dialogfeld Neue" auswählen.
In der Zuordnungskonsole sind die voreingestellten Konfigurationsoptionen für die Zuordnung veralteter Komponenten auf den folgenden Registerkarten organisiert:
- Allgemein
- Inhalt
- Querverweise auf Zuordnungen
Allgemein
Die Allgemein enthält die folgenden Konfigurationsoptionen:
Ein Knoten im AEM-Repository wird mit dem hier angegebenen Namen erstellt. Wenn Sie den Site-Namen nicht angeben, wird der Site-Knoten mit dem DITA-Map-Dateinamen erstellt.
Der hier angegebene Site-Name wird auch als Titel auf der Browser-Registerkarte verwendet.
Sie können beim Festlegen des Site-Namens auch Variablen verwenden. Weitere Informationen finden Sie unter Verwenden von Variablen zum Festlegen der Optionen Zielpfad, Site-Name oder Dateiname
user-guide und den Ausgabepfad als /content/output/aem-guides angeben, wird die endgültige Ausgabe unter dem /content/output/aem-guides/user-guide-Knoten generiert.Sie können beim Festlegen des Ausgabepfads auch Variablen verwenden. Weitere Informationen finden Sie unter Verwenden von Variablen zum Festlegen der Optionen Zielpfad, Site-Name oder Dateiname
Wählen Sie die Option Löschen und Erstellen, um das Löschen vorhandener Seiten während der Veröffentlichung zu erzwingen. Diese Option löscht den Seitenknoten sowie den Inhalt und alle untergeordneten Seiten. Verwenden Sie diese Option, wenn Sie die Design-Vorlage Ihrer Ausgabevorgabe geändert haben oder wenn Sie möchten, dass zusätzliche Seiten, die bereits im Ziel vorhanden sind, entfernt werden.
Angenommen, Sie haben eine DITA-Karte veröffentlicht, die die Themen a.dita, b.dita und c.dita enthält. Bevor Sie die Karte erneut veröffentlichen, haben Sie das Thema b.dita aus der Karte entfernt. Wenn Sie diese Option jetzt ausgewählt haben, wird der gesamte Inhalt, der mit b.dita zusammenhängt, aus der AEM Sites-Ausgabe entfernt und nur a.dita und c.dita werden veröffentlicht.
Hinweis: Informationen zu gelöschten Seiten werden ebenfalls in den Ausgabegenerierungsprotokollen erfasst. Weitere Informationen zum Zugriff auf die Protokolldateien finden Sie Anzeigen und Überprüfen der Protokolldatei.
Achtung: Beim Löschen der Themen sind die Seiten dann nicht mehr auf der veröffentlichten Site verfügbar. Bevor die Themen gelöscht werden, wird eine Warnung angezeigt. Sie müssen das Löschen bestätigen.
Weitere Informationen zur Verwendung benutzerdefinierter Design-Vorlagen zum Generieren von Ausgaben erhalten Sie von Ihrem Veröffentlichungsadministrator.
Klicken Sie nach dem Generieren der Ausgabe auf 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.
Inhalt
Die Inhalt-Registerkarte enthält die folgenden Konfigurationsoptionen:
Weitere Informationen finden Sie „Arbeiten mit ".
None: Wählen Sie diese Option aus, wenn Sie keine Bedingung auf die veröffentlichte Ausgabe anwenden möchten.
Verwenden von DITAVAL: Wählen Sie DITAVal-Datei(en) aus, um bedingte Inhalte zu generieren. Sie können mehrere DITAVal-Dateien über das Dialogfeld „Durchsuchen“ oder durch Eingabe des Dateipfads auswählen. Verwenden Sie das Kreuz-Symbol 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 übereinstimmenden Bedingungen haben. Sie können die Dateireihenfolge durch Hinzufügen oder Löschen von Dateien beibehalten. Wenn die DITAVal-Datei an einen anderen Speicherort verschoben oder gelöscht wird, wird sie nicht automatisch aus dem Zuordnungs-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. Wenn Sie einen anderen Dateityp auswählen, wird ein Fehler angezeigt.
Bedingungsvorgabe: Wählen Sie in der Dropdown-Liste eine Bedingungsvorgabe aus, um eine Bedingung beim Veröffentlichen der Ausgabe anzuwenden. Diese Option ist sichtbar, wenn Sie eine Bedingung für die DITA-Zuordnungsdatei hinzugefügt haben. Die bedingten Einstellungen sind auf der Registerkarte „Bedingungsvorgaben“ der DITA-Zuordnungskonsole verfügbar. Weitere Informationen zu Bedingungsvorgaben finden Sie unter Verwenden von Bedingungsvorgaben.
Dateieigenschaften (Assets)
Hinweis: Bei den Metadateneigenschaften wird zwischen Groß- und Kleinschreibung unterschieden.
Wenn Sie eine Baseline ausgewählt haben, basieren die Werte für die Eigenschaften auf der Version der ausgewählten Baseline. Wenn Sie keine Baseline ausgewählt haben, basieren die Werte für die Eigenschaften auf der neuesten Version.
Sie können die Metadaten auch mithilfe von DITA-OT-Publishing an die Ausgabe übergeben. Für eine weitere Detailansicht ( Sie die Metadaten mithilfe von DITA-OT an die Ausgabe .
Hinweis: Wenn Sie die
cq:tags nicht in der Option Eigenschaften definiert haben, werden die Werte für cq:tags aus der aktuellen Arbeitskopie ausgewählt, selbst wenn Sie eine Baseline für die Veröffentlichung ausgewählt haben.Verwenden von Zuordnungseigenschaften als Fallback
Nur Zeichenfolgen-, Datums- oder Lange-Eigenschaften (einzelne und mehrwertige Eigenschaften) können an die Seiten der AEM-Site übergeben werden. Die Metadatenwerte für eine Eigenschaft vom Typ Zeichenfolge unterstützen keine Sonderzeichen (z. B.
@, #, " ").* Diese Option sollte zusammen mit der Option
Properties verwendet werden.Querverweise auf Zuordnungen
Diese Liste enthält Themen mit Querverweisen auf scope ="peer". Sie können den Veröffentlichungskontext für eine Liste von Querverweiskarten mit scope="peer" zu Themen angeben, die in anderen DITA-Zuordnungen verfügbar sind. Diese Registerkarte wird angezeigt, wenn Sie die Experience Manager Guides-Version (UUID) verwenden.
Weitere Informationen finden Sie im Abschnitt Arbeiten mit verknüpften Themen unten.
Arbeiten mit verknüpften Themen
Mit Experience Manager Guides können Sie Themenreferenzen mithilfe der peer @scope erstellen. Anschließend können Sie den Veröffentlichungskontext dieser Verweise über die AEM Sites-Vorgaben definieren und schließlich die Ausgabe der verknüpften Themen generieren.
Weitere Informationen finden Sie unter Generieren einer Ausgabe von verknüpfenden Themen aus anderen Karten.
Führen Sie die folgenden Schritte aus, um den Veröffentlichungskontext für vernetzte Dateien anzugeben:
-
Öffnen Sie Registerkarte Querverweise“. Um diese Registerkarte anzuzeigen, stellen Sie sicher, dass die
<xrefs>eindeutige IDs haben. Beim Bearbeiten/Speichern des älteren Inhalts werden automatisch eindeutige IDs für<xrefs>generiert, wenn die ID nicht vorhanden ist.In den folgenden Fällen können Sie die Kreuzkartenverknüpfung nicht anzeigen:
- Für die Voreinstellungen, die vor Version 4.6 erstellt wurden, ist die Registerkarte Querverweise deaktiviert und es wird eine QuickInfo siehe Karten-Dashboard angezeigt.
- Für Vorgaben, die über das Zuordnungs-Dashboard erstellt wurden, wird siehe Zuordnungs-Dashboard QuickInfo angezeigt.
- Für vordefinierte Vorgaben wird siehe Zuordnungs-Dashboard QuickInfo angezeigt.
- Erstellen Sie für globale Vorgaben eine lokale Kopie dieser globalen Vorgabe, um Querverweise auf Zuordnungen festzulegen.
-
Eine Liste der Themen und der zugehörigen Referenzen wird angezeigt
note note NOTE Die Registerkarte Querverweise zeigt Themen an, die nur über die scope="peer"verknüpft sind. Für Links mitscope="local"müssen Sie den Veröffentlichungskontext nicht angeben.Für alle verknüpften Themen ist die neueste Ausgabevorgabe und Zuordnung standardmäßig ausgewählt. Der Veröffentlichungskontext für alle verknüpften Themen ist standardmäßig auf
<Most recently generated>Zuordnung festgelegt.
-
Wenn Sie die zuletzt veröffentlichte Ausgabe jeder abhängigen Datei in der Zuordnung verwenden möchten, wählen Sie Zuletzt generierte verwenden Veröffentlichungskontext für alle abhängigen Themen verwenden.
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, werden die Links in der AEM Sites-Ausgabe als normaler Text anstelle von Hyperlinks angezeigt.
Sie sollten denselben Typ von AEM Sites-Vorgabe für das verknüpfte Thema auswählen. Wenn die aktuelle AEM Sites-Vorgabe beispielsweise die Zuordnung veralteter 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 UUID der Zuordnung angezeigt. Die mit der ausgewählten Zuordnung verknüpften Ausgabevorgaben werden in der Liste der Voreinstellungen der übergeordneten Zuordnung aufgeführt. Beispielsweise enthält Thema 1 in Karte A einen Verweis auf Thema 2. Thema 2 kann in einzelnen oder mehreren Karten 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 mehrmals 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 ihre Inhalte. Beispielsweise 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 Zuordnung B als übergeordnete Zuordnung für den ersten Link und Zuordnung C als übergeordnete Zuordnung für den zweiten Link auswählen.
-
Wählen Sie in der Dropdown-Liste Vorgabe 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 Zuordnung werden in der Dropdown-Liste angezeigt. Wenn Sie keine Vorgabe auswählen, wird ein Warnsymbol angezeigt, und die Ausgabegenerierung schlägt fehl. -
Wählen Sie die erforderliche Zuordnung und die Ausgabevorgabe für alle Quellthemen aus und klicken Sie auf Generieren.
Übergeordnetes Thema: Verstehen der Ausgabevorgaben