Seitenvorlagen – statisch page-templates-static

Eine Vorlage wird verwendet, um eine Seite zu erstellen. Sie definiert, welche Komponenten im ausgewählten Umfang genutzt werden können. Eine Vorlage ist eine Hierarchie von Knoten, die dieselbe Struktur aufweist wie die zu erstellende Seite, aber keine Inhalte.

Jede Vorlage stellt Ihnen eine Auswahl an Komponenten bereit, die Sie verwenden können.

Eigenschaften und untergeordnete Knoten einer Vorlage properties-and-child-nodes-of-a-template

Eine Komponente ist ein Knoten vom Typ „cq:Template“ mit den folgenden Eigenschaften und untergeordneten Knoten:

Eine Vorlage ist die Basis einer Seite.

Um eine Seite zu erstellen, müssen Sie die Vorlage (Knotenbaumstruktur /apps/<myapp>/template/<mytemplate>) an die entsprechende Stelle in der Website-Baumstruktur kopieren: Dies geschieht, wenn eine Seite über die Registerkarte Websites erstellt wird.

Über diesen Kopiervorgang erhält die Seite auch ihren anfänglichen Inhalt (in der Regel nur den Inhalt der obersten Ebene) und die Eigenschaft „sling:resourceType“, den Pfad zur Seitenkomponente, die zum Rendern der Seite verwendet wird (alles im untergeordneten Knoten „jcr:content“).

Strukturieren von Vorlagen how-templates-are-structured

Zwei Aspekte müssen berücksichtigt werden:

Die Struktur einer Vorlage the-structure-of-a-template

Eine Vorlage wird unter einem Knoten vom Typ cq:Template erstellt.

Verschiedene Eigenschaften können festgelegt werden, insbesondere:

Dieser Knoten enthält einen Knoten „jcr:content“ (cq:PageContent), der als Basis für den Inhaltsknoten der erzeugten Seiten genutzt wird. Dabei wird mit sling:resourceType auf die Komponenten verwiesen, die für das Rendern des tatsächlichen Inhalts einer neuen Seite verwendet werden sollen.

Mit dieser Komponente wird die Struktur und das Design des Inhalts definiert, wenn eine neue Seite erstellt wird.

Der von einer Vorlage erstellte Inhalt the-content-produced-by-a-template

Mit Vorlagen werden Seiten des Typs cq:Page erstellt (wie bereits erwähnt, ist eine Seite eine besondere Art der Komponente). Jede AEM-Seite weist den strukturierten Knoten jcr:content auf. Dies:

Standardvorlagen default-templates

AEM bietet verschiedene Standardvorlagen, die standardmäßig verfügbar sind. Mitunter können Sie die Vorlagen unverändert nutzen. In diesem Fall müssen Sie sicherstellen, dass die Vorlage für Ihre Website verfügbar ist.

AEM enthält beispielsweise verschiedene Vorlagen, darunter eine Inhaltsseite und eine Homepage.

Anzeigen von Standardvorlagen displaying-default-templates

Eine Liste aller Vorlagen im Repository können Sie wie folgt anzeigen:

Normalerweise können Sie eine vorhandene Vorlage verwenden und auf dieser Basis eine neue Vorlage zur eigenen Verwendung entwickeln. Weitere Informationen finden Sie unter Entwickeln von Seitenvorlagen.

Damit eine vorhandene Vorlage für Ihre Website aktiviert und im Dialogfeld Seite erstellen angezeigt wird, wenn Sie eine Seite direkt unter Websites in der Websites-Konsole erstellen, legen Sie für die Eigenschaft „allowedPaths“ des Vorlagenknotens folgenden Wert fest:  /content(https://experienceleague.adobe.com/.&?lang=de#42;)?

Anwenden von Vorlagendesigns how-template-designs-are-applied

Wenn Stile in der Benutzeroberfläche im Designmodus definiert werden, wird das Design am genauen Pfad des Inhaltsknotens, für den der Stil definiert wird, beibehalten.

Wenn Entwürfe nur im Designmodus angewendet werden, sind die folgenden Abschnitte, Auflösung des Designpfads, Entscheidungsbaum und das Beispiel, nicht anwendbar.

Auflösung des Designpfads design-path-resolution

Beim Rendern von Inhalten, die auf einer statischen Vorlage basieren, versucht AEM, das relevanteste Design und die relevantesten Stile auf den Inhalt anzuwenden. Hierzu erfolgt zunächst ein Durchlauf der Inhaltshierarchie.

AEM bestimmt den relevantesten Stil für einen Inhaltsknoten in der folgenden Reihenfolge:

Wenn es in den letzten beiden Fällen mehr als ein geeignetes Design gibt, verwende das Design, das dem Inhaltsknoten am nächsten ist.

Entscheidungsbaum decision-tree

Dies ist eine grafische Darstellung der Logik der Auflösung des Designpfads.

Beispiel example

Denken Sie an eine einfache Inhaltsstruktur wie die folgende, bei der ein Design auf jeden der Knoten angewendet werden könnte:

/root/branch/leaf

In der folgenden Tabelle wird beschrieben, wie AEM ein Design auswählt.

Entwickeln von Seitenvorlagen developing-page-templates

AEM-Seitenvorlagen sind schlicht Modelle, die zum Erstellen von Seiten verwendet werden. Sie können anfänglich so wenig oder viel Inhalt enthalten, wie erforderlich ist. Ihre Aufgabe besteht darin, die korrekten anfänglichen Knotenstrukturen zu erstellen, wobei die benötigten Eigenschaften (v. a. „sling:resourceType“) so eingestellt werden, dass sie Bearbeitungs- und Render-Vorgänge zulassen.

Erstellen einer Vorlage (basierend auf einer vorhandenen Vorlage) creating-a-new-template-based-on-an-existing-template

Eine neue Vorlage kann komplett neu erstellt werden. Um Zeit und Aufwand zu reduzieren, können Sie stattdessen aber auch eine vorhandene Vorlage kopieren und aktualisieren. So können Sie z. B. zum Einstieg die Vorlagen von Geometrixx nutzen.

So erstellen Sie eine Vorlage basierend auf einer vorhandenen Vorlage:

Bereitstellen einer vorhandenen Vorlage making-an-existing-template-available

Dieses Beispiel zeigt, wie Sie zulassen können, dass eine Vorlage für bestimmte Inhaltspfade genutzt werden kann. Die Vorlagen, die Autorinnen und Autoren bei der Erstellung von Seiten zur Verfügung stehen, werden durch die unter Vorlagenverfügbarkeit definierte Logik bestimmt.