AEM bietet Ihnen die Möglichkeit, eine Seite als vollständige Webseite einschließlich aller Grafiken, JS- und CSS-Dateien zu exportieren.
Wenn Sie den Export konfiguriert haben, können Sie einfach eine Seite im Browser anfordern. Ersetzen Sie dafür in der URL html
durch export.zip
. So erzeugen Sie den Download einer ZIP-Datei, in der die gerenderte Seite im HTML-Format und die referenzierten Assets enthalten sind. Alle in der Seite enthaltenen Pfade, z. B. Pfade zu Grafiken, werden umgeschrieben und verweisen entweder auf die in der ZIP-Datei enthaltenen Dateien oder auf die Ressourcen auf dem Server.
Die folgenden Schritte beschreiben, wie Sie eine Seite exportieren können. Vorausgesetzt wird, dass für Ihre Website eine Vorlage für die Exportkonfiguration vorliegt: Eine Konfigurationsvorlage legt fest, wie eine Seite exportiert wird, und gilt speziell für Ihre Website. Informationen zum Erstellen einer Konfigurationsvorlage finden Sie im Abschnitt Erstellen einer Seiten-Exporter-Konfiguration für Ihre Site Abschnitt.
So exportieren Sie eine Seite:
Öffnen Sie die Seite im Browser. Beispiel:
http://localhost:4502/content/geometrixx/en/products/triangle.html
Öffnen Sie das Dialogfeld „Seiteneigenschaften“, wählen Sie die Registerkarte Erweitert und erweitern Sie das Feld Exportieren.
Klicken Sie auf das Lupensymbol und wählen Sie eine Konfigurationsvorlage aus. Wählen Sie die geometrixx-Vorlage aus; sie ist die standardmäßige Vorlage für die Geometrixx-Website. Klicken Sie auf OK.
Klicken Sie auf OK, um das Dialogfeld „Seiteneigenschaften“ zu schließen.
Anfordern der Seite durch Ersetzen html
mit export.zip
in der URL.
Laden Sie die <page-name>.export.zip
in Ihr Dateisystem.
Entpacken Sie in Ihrem Dateisystem die Datei:
<page-name>.html
) ist unten verfügbar <unzip-dir>/<page-path>
<unzip-dir>/etc
, einige unten <unzip-dir>/<page-path>
.Öffnen Sie die HTML-Datei der Seite ( <unzip-dir>/<page-path>.html
), um das Rendering zu überprüfen.
Das Seiten-Exporttool basiert auf dem Inhaltssynchronisierungs-Framework. Die Konfigurationen, die im Dialogfeld "Seiteneigenschaften"verfügbar sind, sind Konfigurationsvorlagen. Sie definieren alle erforderlichen Abhängigkeiten einer Seite. Wenn ein Seitenexport ausgelöst wird, wird die Konfigurationsvorlage verwendet und sowohl der Seitenpfad als auch der Designpfad werden dynamisch auf die Konfiguration angewendet. Anschließend wird die ZIP-Datei erstellt, indem die Standardfunktion zur Inhaltssynchronisierung genutzt wird.
AEM bettet einige Vorlagen ein, darunter eine:
Eine Standardeinstellung unter /etc/contentsync/templates/default
. Diese Vorlage:
Eine für die Geometrixx Site, /etc/contentsync/templates/geometrixx
. Diese Vorlage kann als Beispiel verwendet werden, um eine neue zu erstellen.
So erstellen Sie eine Konfigurationsvorlage für das Seiten-Exporttool:
In CRXDE Lite, erstellen Sie einen Knoten unter /etc/contentsync/templates
:
mysite
. Der Name wird im Dialogfeld "Seiteneigenschaften"angezeigt, wenn Sie die Vorlage "Seitenexporteur"auswählen.nt:unstructured
Erstellen Sie unter dem Vorlagenknoten (in diesem Beispiel: mysite
) eine Knotenstruktur mit den unten beschriebenen Konfigurationsknoten.
Die Konfigurationsvorlage besteht aus einer Knotenstruktur. Jeder Knoten verfügt über die Eigenschaft type
, die eine spezifische Aktion beim Erstellungsprozess der ZIP-Datei definiert. Weitere Informationen zur type-Eigenschaft finden Sie im Abschnitt Übersicht über Konfigurationstypen auf der Framework-Seite zur Inhaltssynchronisierung .
Mit den folgenden Knoten können Sie eine Export-Konfigurationsvorlage erstellen:
Seitenknoten Der Seitenknoten wird zum Kopieren des Seiten-HTML-Codes in die ZIP-Datei verwendet. Er weist die folgenden Eigenschaften auf:
/etc/contentsync/templates/<sitename>
.page
.nt:unstructured
Der Knoten page
hat folgende Eigenschaften:
A type
-Eigenschaft mit dem Wert pages
.
Er verfügt nicht über die Eigenschaft path
, da der aktuelle Seitenpfad dynamisch in die Konfiguration kopiert wird.
Die anderen Eigenschaften werden im Abschnitt Übersicht der Konfigurationstypen des Content Sync-Frameworks beschrieben.
rewrite-Knoten Der Knoten rewrite definiert, wie die Links auf der exportierten Seite neu geschrieben werden. Die neu geschriebenen Links können entweder auf die Dateien in der ZIP-Datei oder auf die Ressourcen auf dem Server verweisen.
Auf der Seite Inhaltssynchronisierung finden Sie eine vollständige Beschreibung des Knotens rewrite
.
design node Der Knoten "design"wird zum Kopieren des für die exportierte Seite verwendeten Designs verwendet. Er weist die folgenden Eigenschaften auf:
/etc/contentsync/templates/<sitename>
.design
.nt:unstructured
.Der Knoten design
hat folgende Eigenschaften:
A type
Eigenschaft auf den Wert eingestellt copy
.
Er verfügt nicht über die Eigenschaft path
, da der aktuelle Seitenpfad dynamisch in die Konfiguration kopiert wird.
generic Knoten Ein generischer Knoten wird verwendet, um Ressourcen wie .js- oder .css-Dateien clientlibs in die ZIP-Datei zu kopieren. Er weist die folgenden Eigenschaften auf:
/etc/contentsync/templates/<sitename>
.nt:unstructured
.type
-Eigenschaft und type
verwandte Eigenschaften, wie im Abschnitt Übersicht über Konfigurationstypen des Content Sync-Frameworks definiert.Beispielsweise kopiert der folgende Konfigurationsknoten die JS-Dateien der Geometrixx-Clientlibs in die ZIP-Datei:
"geometrixx.clientlibs.js": {
"extension": "js",
"type": "clientlib",
"path": "/etc/designs/geometrixx/clientlibs",
"jcr:primaryType": "nt:unstructured"
}
Die Geometrixx-Konfigurationsvorlage für das Seiten-Exporttool zeigt, wie Sie einen Seitenexport konfigurieren können. Um die Knotenstruktur der Vorlage in Ihrem Browser im JSON-Format anzuzeigen, fordern Sie die folgenden URL an:
http://localhost:4502/etc/contentsync/templates/geometrixx.-1.json
Implementieren einer benutzerdefinierten Konfiguration
Wie Sie vielleicht bei der Knotenstruktur bemerkt haben, verfügt die Geometrixx-Konfigurationsvorlage für das Seiten-Exporttool über den Knoten logo
, bei dem die Eigenschaft type
auf image
festgelegt ist. Das ist ein spezieller Konfigurationstyp, der erstellt wurde, um das Grafiklogo in die ZIP-Datei zu kopieren. Um bestimmte Anforderungen zu erfüllen, müssen Sie möglicherweise eine benutzerdefinierte Eigenschaft type
implementieren. Informationen hierzu finden Sie im Abschnitt Implementieren eines benutzerdefinierten Aktualisierungshandlers auf der Seite „Inhaltssynchronisierung“.
Um eine Seite programmatisch zu exportieren, können Sie den OSGi-Dienst PageExporter nutzen. Mit diesem Dienst können Sie:
Das Servlet, das an die export
und zip
-Erweiterung verwendet den PageExporter-Dienst.
Wenn beim Herunterladen der ZIP-Datei Probleme auftreten, können Sie die /var/contentsync
-Knoten im Repository und senden Sie die Exportanfrage erneut.