AEM Sites-Vorgaben im Zuordnungs-Dashboard id205BE3008SW
Sie können AEM Sites-Vorgaben über das Zuordnungs-Dashboard erstellen und sie so konfigurieren, dass sie die AEM Sites-Ausgabe generieren.
Für die AEM Sites-Ausgabe stehen die folgenden Optionen zur Verfügung:
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 zur Verwendung von Variablen finden Sie Verwenden von Variablen zum Festlegen der Optionen Zielpfad, Site-Name oder Dateiname.
Weitere Informationen zur Verwendung benutzerdefinierter Design-Vorlagen zum Generieren von Ausgaben erhalten Sie von Ihrem Veröffentlichungsadministrator.
user-guide und den Zielpfad 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 Zielpfads auch Variablen verwenden. Weitere Informationen zur Verwendung von Variablen finden Sie Verwenden von Variablen zum Festlegen der Optionen Zielpfad, Site-Name oder Dateiname.
Keine angewendet: Wählen Sie diese Option aus, wenn Sie keine Bedingung auf die veröffentlichte Ausgabe anwenden möchten.
DITAVal-Datei: Wählen Sie DITAVal-Datei(en), 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.
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.
Diese Funktion entfernt keine veröffentlichten untergeordneten Zuordnungen. Wenn Ihre übergeordnete Zuordnung beispielsweise eine untergeordnete Zuordnung enthält und Sie die gesamte untergeordnete Zuordnung entfernen, wird der Inhalt der untergeordneten Zuordnung nicht aus der veröffentlichten Ausgabe gelöscht. Wenn Sie jedoch ein Thema aus einer untergeordneten Zuordnung entfernen und erneut veröffentlichen, wird der Inhalt des entfernten Themas aus der Site-Ausgabe gelöscht.
Wenn referenzierte Inhalte vorhanden sind und diese Inhalte vor der erneuten Veröffentlichung entfernt werden, werden die Daten der referenzierten Inhalte nicht entfernt.
Hinweis: Informationen zu gelöschten verwaisten Seiten werden ebenfalls in den Ausgabegenerierungsprotokollen erfasst. Weitere Informationen zum Zugriff auf die Protokolldateien finden Sie unter Protokolldatei anzeigen und überprüfen.
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.
Geben Sie im Feld PDF-Pfad aufteilen den Pfad zum Speichern der für jedes Thema generierten PDF-Dateien an.
Hinweis: AEM Guides verwendet das DITA-OT-Plug-in „pdfx“, um für jedes Thema PDF zu generieren. Dieses Plug-in ist im Lieferumfang des DITA-OT-Pakets enthalten. Sie können dieses Plug-in anpassen, um PDF gemäß Ihren Anforderungen zu generieren. Wenn Sie ein benutzerdefiniertes DITA-OT-Plug-in verwenden, stellen Sie sicher, dass Sie das pdfx-Plug-in integrieren, um PDF-Generierungsfunktionen auf Themenebene zu erhalten.
Wichtig: Wenn Sie eine inkrementelle Ausgabe für die AEM-Site generieren, wird die Ausgabe anhand der aktuellen Dateiversion und nicht anhand der angehängten Baseline erstellt.
Weitere Informationen finden unter „Arbeiten mit".
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. Weitere Informationen finden Sie unter Übergeben der Metadaten an die Ausgabe mithilfe von DITA-OT.
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.Nur Zeichenfolgen-, Datums- oder Lange-Eigenschaften (einzelne und mehrwertige Eigenschaften) können an die AEM Sites-Seiten ü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.Zusätzlicher Hinweis zu AEM Sites
Artikelbasierte Ausgabe über die Zuordnungskonsole generieren
Sie können die AEM Sites-Ausgabe für ein oder mehrere Themen oder die gesamte DITA-Zuordnung über die Zuordnungskonsole generieren. Sie müssen Ausgabevorgaben für Ihre DITA-Zuordnung erstellen und dann können Sie einfach die AEM Sites-Ausgabe für Ihre Zuordnung generieren. Wenn Sie einige Themen in Ihrer Zuordnung aktualisiert haben, können Sie die AEM Sites-Ausgabe auch nur für diese Themen über die Zuordnungskonsole generieren. Weitere Informationen finden Sie unter Generieren von Wissensdatenbankausgaben.
Ausgabe von Verknüpfungsthemen aus anderen Karten generieren
Häufig wird eine umfangreiche Dokumentation in mehreren Ordnern und DITA-Zuordnungen bereitgestellt. Das Veröffentlichen von Inhalten, die von verschiedenen Stellen aus verknüpft sind, wird extrem komplex. Standardmäßig werden alle <xref> Links mit dem local @scope erstellt. Die Veröffentlichung solcher Themen stellt keine Herausforderung dar, da sie einen direkten Link zum Thema verwendet. Falls sich das Thema außerhalb der aktuellen DITA-Zuordnung befindet, wird der verknüpfte Inhalt nicht angezeigt.
Eine andere Möglichkeit, Inhalte zu verknüpfen, besteht darin, einen Link mithilfe der peer-@scope zu erstellen. Für solche Inhalte wird der Link zur Laufzeit aufgelöst, indem der Titel der Datei und der konfigurierte Kontext für das verknüpfte Thema aus dem Veröffentlichungskontext der DITA-Zuordnung ausgewählt werden. Der folgende Screenshot zeigt das Bedienfeld Eigenschaften für einen Link mit dem peer @scope:
Um die Veröffentlichung komplexer Zuordnungen und Themen zu vereinfachen, die mit anderen Themen in anderen Zuordnungen verknüpft sind, können Sie in Adobe Experience Manager Guides den Veröffentlichungskontext für jede Ausgabevorgabe festlegen.
Im Veröffentlichungskontext können Sie angeben, welches Thema aus welcher Zuordnung für die Veröffentlichung einer bestimmten Ausgabe verwendet werden soll. Lassen Sie uns dies anhand eines Beispiels verstehen - nehmen wir an, Sie haben vier Ordner: Beispiel A, Beispiel B, Beispiel C und Beispiel D. Jeder Ordner enthält eine DITA-Karte - DITA-Karte A, DITA-Karte B, DITA-Karte C und DITA-Karte D. Eine Kreuzkartenverknüpfung erfolgt, wenn ein Thema in DITA-Karte A mit einem Thema in DITA-Karte B, C oder D verknüpft ist. Im folgenden Screenshot enthält ein Beispielkonzeptthema Links (oder Verweise) zu Dateien, die Teil anderer DITA-Zuordnungen sind.
Wenn Sie jetzt die AEM Sites-Veröffentlichungseinstellungen für die Zuordnungsdatei konfigurieren, die dieses Thema enthält, können Sie auswählen, welcher Veröffentlichungskontext für den verknüpften Inhalt beim Veröffentlichen verwendet wird. Ein Veröffentlichungskontext ist eine Kombination aus DITA-Zuordnung und Ausgabevorgabe. Die Ausgabevorgabe wiederum enthält eine bestimmte Version des Inhalts und bedingte Vorgaben. Diese gesamte Kombination aus DITA-Zuordnung, Ausgabevorgabe, (Dateien)-Version und Bedingungen definiert den Veröffentlichungskontext für eine verknüpfte Zuordnung.
Führen Sie die folgenden Schritte aus, um den Veröffentlichungskontext für vernetzte Dateien anzugeben:
-
Öffnen Sie die Ausgabevorgaben der DITA-Zuordnung, die Sie veröffentlichen möchten.
-
Wählen Sie die Ausgabevorgabe AEM-Site aus.
Sie erhalten die Registerkarten AEM-Voreinstellungen und Veröffentlichungskontext .
-
Öffnen Sie die Registerkarte Veröffentlichungskontext.
Es wird eine Liste der abhängigen Themen angezeigt. Dies sind die Themen, die von einem Thema in der aktuellen Karte verlinkt sind, aber in einigen anderen DITA-Karten verfügbar sind.
note note NOTE Auf der Registerkarte Veröffentlichungskontext werden Themen angezeigt, die nur über die peer@scopeverknüpft sind. Für Links mitlocal@scopemüssen Sie den Veröffentlichungskontext nicht angeben.Standardmäßig sind für alle verknüpften Themen die neueste Ausgabevorgabe und Zuordnung ausgewählt.
-
Um die Standardauswahl von DITA-Zuordnung und -Vorgabe zu ändern, wählen Sie Bearbeiten (in der Haupt-Symbolleiste) aus.
-
Wenn Sie die zuletzt veröffentlichte Ausgabe jeder abhängigen Datei in der Zuordnung verwenden möchten, wählen Sie Zuletzt generierten Veröffentlichungskontext für alle abhängigen Themen verwenden.
-
Wählen in der Dropdown Liste Übergeordnete Zuordnung die Zuordnungsdatei aus, mit deren Ausgabe Sie die Ausgabe der aktuellen Zuordnung verknüpfen möchten.
Bei Auswahl einer Zuordnungsdatei 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.
-
Wählen Sie in Dropdown-Liste Vorgabe übergeordneten Zuordnung die Ausgabevorgabe aus, mit der Sie die Ausgabe der aktuellen Zuordnung verknüpfen möchten.
-
Wählen Sie die gewünschte Zuordnung und die entsprechende Ausgabevorgabe für alle abhängigen Themen aus und klicken Sie auf Fertig.
Der Kontext für die abhängigen Themen ist jetzt festgelegt. Sie können die Ausgabe für die aktuelle Zuordnung generieren. Weitere Informationen zum Generieren einer Ausgabe finden Sie unter Generieren einer Ausgabe für eine DITA-Zuordnung über die Zuordnungskonsole.
Gemischte Veröffentlichung
AEM Guides unterstützt die Veröffentlichung von DITA-Inhalten auf Ihrer bestehenden AEM-Site. Wenn Sie beispielsweise über eine bereits vorhandene Site verfügen, können Sie die AEM Sites-Ausgabe verwenden, um nur die DITA-Inhalte auf dieser Site zu veröffentlichen. In diesem Prozess wird der vorhandene Nicht-DITA-Inhalt nicht durch den Veröffentlichungsprozess geändert. Weitere Informationen dazu, wie Sie Ihre Site so einrichten, dass nur DITA-Inhalte veröffentlicht werden, erhalten Sie von Ihrem Veröffentlichungsadministrator.
Veröffentlichung conref
Wenn Sie conref in Ihrem Inhalt verwenden, wird dieser als normaler oder eingebetteter Inhalt zusammen mit dem Inhalt im (oder verweisenden) Quellthema veröffentlicht. Der conref Inhalt wird zusammen mit dem Hauptinhalt gerendert, und es wird keine separate Website-Seite für dieselbe erstellt. Wenn Sie nach dem Inhalt suchen, auf den in der conref verwiesen wird, wird nur das Hauptthema oder die Hauptseite mit dem conref Inhalt in den Suchergebnissen angezeigt.
conref Inhalt generiert haben, wird empfohlen, diese Seiten mithilfe der Option Löschen verwaister Site-Seiten zu bereinigen/löschen.Eine Zeichenfolge im Inhalt durchsuchen
Sie können in der AEM Sites-Ausgabe nach einer Zeichenfolge suchen. Standardmäßig können Sie nur in den Titeln nach der Zeichenfolge suchen. Um nach der Zeichenfolge im Inhalt oder im Hauptteil der AEM Sites-Ausgabe zu suchen, wenden Sie sich an Ihren Systemadministrator, um die Flattling.enabled-Eigenschaft zu aktivieren.
Weitere Informationen finden Sie Abschnitt „Reduzieren der Knotenstruktur der AEM-Site konfigurieren im Handbuch zum Installieren und Konfigurieren von Adobe Experience Manager Guides .
Übergeordnetes Thema: Verstehen der Ausgabevorgaben