AEM Site id205BE3008SW

Die folgenden Optionen sind für die Ausgabe der AEM Site verfügbar:

Sie können die Vorgabe für die AEM Website auf zwei Arten erstellen:

Öffnen Sie im Web Editor: Öffnen Sie im Bereich "Repository"die DITA-Map-Datei in der Kartenansicht. Wählen Sie dann auf der Registerkarte "Ausgabe"das Symbol + , um eine Ausgabevorgabe zu erstellen, und wählen Sie dann AEM Site aus der Dropdown-Liste Typ im Dialogfeld Vorgabe hinzufügen aus. Im Web-Editor wurden die Konfigurationen unter den Registerkarten Allgemein und Erweitert organisiert:

Allgemein

Die Registerkarte Allgemein enthält die folgenden Konfigurationen:

Erweitert

Die Registerkarte Erweitert enthält die folgenden Konfigurationen:

Weitere Informationen finden Sie unter AEM Site-Konfiguration.

Aus dem Landkarten-Dashboard

Um Ausgabevorgaben für AEM Site zu öffnen, klicken Sie in der Assets-Benutzeroberfläche auf eine DITA-Zuordnungsdatei, klicken Sie dann auf Ausgabevorgaben und dann auf die Ausgabeoption AEM Site . Klicken Sie im Zuordnungs-Dashboard oben auf Bearbeiten , um die verschiedenen Konfigurationen zu aktualisieren, und klicken Sie dann auf Speichern.

AEM Site-Konfiguration id_aem_site_config

Die folgenden Optionen sind für die Ausgabe der AEM Site verfügbar:

AEM Site-Optionen

Beschreibung

Ausgabetyp

Der Typ der Ausgabe, die Sie generieren möchten. Wählen Sie die Option Website AEM , um eine responsive AEM-Site-Ausgabe zu generieren.

Einstellungsname

Geben Sie einen beschreibenden Namen für die AEM Site-Einstellungen ein, die Sie erstellen. Sie können beispielsweise die Ausgabe Interne Kunden oder die Ausgabe der Endbenutzer angeben.

Site-Name

Ein Site-Name, in dem die Ausgabe in Ihrem AEM-Repository gespeichert wird.

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 Registerkarte "Browser"verwendet.

Sie können auch Variablen beim Festlegen des Site-Namens verwenden. Weitere Informationen zur Verwendung von Variablen finden Sie unter Verwenden von Variablen zum Festlegen der Optionen "Zielpfad", "Site-Name"oder "Dateiname".

Design

Wählen Sie die Designvorlage aus, die Sie zum Generieren der Ausgabe verwenden möchten.

Wenden Sie sich an Ihren Publishing-Administrator, um weitere Informationen zur Verwendung benutzerdefinierter Designvorlagen zum Generieren der Ausgabe zu erhalten.

Zielpfad

Der Pfad in Ihrem AEM-Repository, in dem die Ausgabe gespeichert wird. Beim Generieren der endgültigen Ausgabe werden der Site-Name und der Zielpfad kombiniert. Wenn Sie beispielsweise den Site-Namen als user-guide und den Ziel-Pfad als /content/output/aem-guides angeben, wird die endgültige Ausgabe unter dem Knoten /content/output/aem-guides/user-guide generiert.

Sie können auch Variablen beim Festlegen des Zielpfads verwenden. Weitere Informationen zur Verwendung von Variablen finden Sie unter Verwenden von Variablen zum Festlegen der Optionen "Zielpfad", "Site-Name"oder "Dateiname".

Bedingungen anwenden mithilfe von

Wählen Sie eine der folgenden Optionen aus:

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-Dateien aus, um konditionalisierten Inhalt 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.

Vorhandene Ausgabeseiten

Wählen Sie die Option Inhalt überschreiben aus, um Inhalte auf den vorhandenen Seiten zu überschreiben. Diese Option überschreibt nur Inhalte, die unter den Inhalts- und Kopfknoten der Seite vorhanden sind. Diese Option ermöglicht die gemischte Veröffentlichung von Inhalten. Wenn Sie diese Option auswählen, können Sie das Löschen verwaister Seiten aus der veröffentlichten Ausgabe auswählen. Dies ist auch die Option default zum Erstellen der AEM Site-Ausgabe.

Wählen Sie die Option Löschen und Erstellen aus, um das Löschen vorhandener Seiten während der Veröffentlichung zu erzwingen. Mit dieser Option wird der Seitenknoten zusammen mit seinem Inhalt und allen untergeordneten Seiten darunter gelöscht. Verwenden Sie diese Option, wenn Sie die Designvorlage Ihrer Ausgabevorgabe geändert haben oder möchten, dass alle zusätzlichen Seiten, die bereits im Ziel vorhanden sind, entfernt werden.

Löschen von verwaisten Site-Seiten

Wenn Sie die Einstellung Inhalt überschreiben in der Einstellung Vorhandene Ausgabeseiten auswählen, wird diese Option angezeigt. Wenn Sie diese Option auswählen, werden alle verwaisten Seiten von der veröffentlichten AEM Site gelöscht. Damit diese Funktion erfolgreich ausgeführt werden kann, müssen Sie die gesamte DITA-Zuordnung veröffentlichen und nicht die inkrementelle Veröffentlichung verwenden.

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 Site-Ausgabe entfernt und nur a.dita und c.dita werden veröffentlicht.

Mit dieser Funktion werden keine veröffentlichten untergeordneten Maps entfernt. 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 referenzierter Inhalt vorhanden ist und dieser Inhalt vor der erneuten Veröffentlichung entfernt wird, werden die Daten des referenzierten Inhalts nicht entfernt.

Hinweis: Informationen zu gelöschten verwaisten Seiten werden auch in den Ausgabegenerierungslogs erfasst. Weitere Informationen zum Zugriff auf die Protokolldateien finden Sie unter Protokolldatei anzeigen und überprüfen.

Herunterladen temporärer Dateien

Wählen Sie diese Option, um die von DITA-OT generierten temporären Dateien herunterzuladen. Der Speicherort, an dem DITA-OT temporäre Dateien speichert, finden Sie im Ausgabegenerierungsprotokoll. Wenn beim Generieren der Ausgabe über DITA-OT Fehler auftreten, wählen Sie diese Option, um die temporären Dateien beizubehalten. Sie können diese Dateien dann verwenden, um Fehler bei der Ausgabenerstellung zu beheben.

Nachdem Sie die Ausgabe generiert haben, wählen Sie das Symbol Temporäre Dateien herunterladen aus, um den ZIP-Ordner mit den temporären Dateien herunterzuladen.

Hinweis: Wenn Sie einige Dateieigenschaften auswählen und dann die temporären Dateien herunterladen, erhalten Sie auch die Datei metadata.xml im ZIP-Ordner.

Separate PDF für jedes Thema generieren

Wenn diese Option aktiviert ist, wird auch für jedes Thema in der DITA-Map eine PDF erstellt. Wenn Sie diese Option wählen, wird eine neue Option PDF-Pfad teilen angezeigt.

Geben Sie im Feld PDF-Pfad teilen den Pfad an, unter dem die für jedes Thema generierten PDF gespeichert werden sollen.

Hinweis: AEM Guides verwendet das DITA-OT-Plug-in namens pdfx, um PDF für jedes Thema zu generieren. Dieses Plug-in ist mit dem standardmäßig bereitgestellten DITA-OT-Paket integriert. 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 die PDF-Generierungsfunktion auf Themenebene zu nutzen.

Workflow zur Post-Generierung ausführen

Wenn Sie diese Option wählen, wird eine neue Dropdown-Liste für den Post-Arbeitsablauf angezeigt, die alle in AEM konfigurierten Workflows enthält. Sie müssen einen Workflow auswählen, der nach Abschluss des Workflows zur Generierung der Ausgabe ausgeführt werden soll.

Grundlinie verwenden

Wenn Sie eine Grundlinie für die ausgewählte DITA-Zuordnung erstellt haben, wählen Sie diese Option, um die Version anzugeben, die Sie veröffentlichen 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.

Weitere Informationen finden Sie unter Arbeiten mit Grundlinie .

Dateieigenschaften

Wählen Sie die Eigenschaften aus, die Sie als Metadaten verarbeiten möchten. Diese Eigenschaften werden auf der Seite "Eigenschaften"der DITA-Map- oder Bookmap-Datei festgelegt. Die Eigenschaften, die Sie aus der Dropdown-Liste auswählen, werden unter dem Feld Dateieigenschaften angezeigt. Wählen Sie das Kreuzsymbol neben der Eigenschaft aus, um sie zu entfernen.

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. Weitere Informationen finden Sie unter Übergeben der Metadaten an die Ausgabe mithilfe von DITA-OT.

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 die Zuordnungseigenschaften, wenn das Thema fehlt.

Wenn diese Option aktiviert ist, werden die für die Zuordnungsdatei definierten Eigenschaften auch in die Themen kopiert, in denen solche Eigenschaften nicht definiert sind. Beachten Sie bei der Verwendung dieser Option die folgenden Punkte:

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.

Zusätzlicher Hinweis auf AEM Site

Artikelbasierte Ausgabe aus dem Web-Editor generieren

Sie können die AEM Site-Ausgabe für ein oder mehrere Themen oder die gesamte DITA-Zuordnung aus dem Web Editor generieren. Sie müssen Ausgabevorgaben für Ihre DITA-Zuordnung erstellen und können dann einfach die AEM Site-Ausgabe für Ihre Karte generieren. Wenn Sie einige Themen in Ihrer Zuordnung aktualisiert haben, können Sie auch die AEM Site-Ausgabe nur für diese Themen aus dem Web Editor generieren. Weitere Informationen finden Sie unter Artikelbasierte Veröffentlichung im Web-Editor.

Generieren von Themen für die Ausgabenverknüpfung aus anderen Maps

Es ist ein sehr häufiges Szenario, dass eine große Menge von Dokumentation über mehrere Ordner und DITA-Maps verteilt ist. Es wird äußerst komplex, Inhalte zu veröffentlichen, die von verschiedenen Orten aus verknüpft sind. Standardmäßig werden alle Links <xref> mit dem Wert local @scope erstellt. Das Veröffentlichen solcher Themen stellt keine Herausforderung dar, da es einen direkten Link zum Thema verwendet. Wenn das Thema außerhalb der aktuellen DITA-Zuordnung liegt, zeigt der Link den verknüpften Inhalt nicht an.

Eine andere Möglichkeit, Inhalte zu verknüpfen, besteht darin, einen Link mit dem peer @scope zu erstellen. Für solche Inhalte wird der Link zur Laufzeit aufgelöst, indem der Dateiname und der konfigurierte Kontext für das verknüpfte Thema aus dem Veröffentlichungskontext der DITA-Map ausgewählt werden. Der folgende Screenshot zeigt den Bereich Eigenschaften für einen Link mit dem Wert peer @scope:

Um die Veröffentlichung komplexer Karten und Themen zu vereinfachen, die mit anderen Themen in anderen Maps verknüpft sind, können Sie mit AEM Guides den Veröffentlichungskontext für jede Ausgabevorgabe festlegen.

Im Veröffentlichungskontext können Sie festlegen, welches Thema für die Veröffentlichung einer bestimmten Ausgabe verwendet werden soll. Nehmen wir an, Sie haben vier Ordner: Beispiel a, Beispiel b, Beispiel c und Beispiel d. Jeder Ordner enthält eine DITA-Zuordnung - DITA-Zuordnung A, DITA-Zuordnung B, DITA-Zuordnung C und DITA-Zuordnung D. Die Querzuordnungsverknüpfung erfolgt, wenn ein Thema in DITA Map A auf ein Thema in DITA Map B, C oder D verlinkt. Im folgenden Screenshot enthält ein Beispielkonzept-Thema Verknüpfungen (oder Verweise) zu Dateien, die Teil anderer DITA-Maps sind.

Wenn Sie jetzt die Veröffentlichungseinstellungen der AEM Site 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 Map und der zugehörigen 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 verknüpfte Dateien anzugeben:

Überblendung Veröffentlichung

AEM Guides unterstützt die Veröffentlichung von DITA-Inhalten auf Ihrer bestehenden AEM-Site. Wenn Sie beispielsweise über eine vorhandene Site verfügen, können Sie die Ausgabe der AEM Site verwenden, um nur den DITA-Inhalt auf dieser Site zu veröffentlichen. In diesem Prozess wird der vorhandene Nicht-DITA-Inhalt durch den Veröffentlichungsprozess nicht geändert. Weitere Informationen zum Einrichten Ihrer Site für die Veröffentlichung von DITA-Inhalten finden Sie bei Ihrem Publishing-Administrator.

Veröffentlichung conref

Wenn Sie conref in Ihrem Inhalt verwenden, wird dieser als normaler oder eingebetteter Inhalt zusammen mit dem Inhalt im Thema Quelle (oder Referrer) veröffentlicht. Der Inhalt von conref wird zusammen mit dem Hauptinhalt gerendert und es wird keine separate Site-Seite für denselben erstellt. Wenn Sie nach dem Inhalt suchen, auf den in conref verwiesen wird, wird in den Suchergebnissen nur das Hauptthema oder die Seite mit dem Inhalt conref angezeigt.

Suchen einer Zeichenfolge im Inhalt

Sie können in der Ausgabe der AEM Site nach einer Zeichenfolge suchen. Standardmäßig können Sie nur in den Titeln nach der Zeichenfolge suchen. Wenden Sie sich an Ihren Systemadministrator, um die Eigenschaft flattening.enabled zu aktivieren, um im Inhalt oder im Hauptteil der AEM-Site nach der Zeichenfolge zu suchen.

Weitere Informationen finden Sie im Abschnitt Reduzieren AEM Site-Knotenstruktur konfigurieren im Handbuch "Installieren und Konfigurieren von Adobe Experience Manager Guides".

Übergeordnetes Thema: ​ Grundlegendes zu den Ausgabevorgaben