Seitenvorlagen – statisch page-templates-static

Eine Vorlage wird verwendet, um eine Seite zu erstellen, und definiert, welche Komponenten im ausgewählten Bereich verwendet werden können. Eine Vorlage ist eine Hierarchie von Knoten, die dieselbe Struktur wie die zu erstellende Seite aufweisen, jedoch keinen tatsächlichen Inhalt haben.

Jede Vorlage stellt Ihnen eine Auswahl an Komponenten zur Verfügung, die Sie verwenden können.

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

Eine Vorlage ist ein Knoten des Typs cq:Template und hat die 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.

Durch diese Kopieraktion erhält die Seite auch ihren anfänglichen Inhalt (normalerweise nur Inhalte 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).

Strukturierung von Vorlagen how-templates-are-structured

Zwei Aspekte sind zu berücksichtigen:

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

Eine Vorlage wird unter einem Knoten des Typs cq:Template.

Verschiedene Eigenschaften können festgelegt werden, insbesondere:

Dieser Knoten enthält einen Knoten jcr:content (cq:PageContent) , der als Grundlage für den Inhaltsknoten der resultierenden Seiten verwendet wird. Dadurch wird mithilfe von sling:resourceType die Komponente referenziert, die zum Rendern des tatsächlichen Inhalts einer neuen Seite verwendet werden soll.

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 enthält eine Reihe von Standardvorlagen, die standardmäßig verfügbar sind. In einigen Fällen können Sie die Vorlagen unverändert verwenden. In diesem Fall müssen Sie sicherstellen, dass die Vorlage für Ihre Website verfügbar ist.

Beispielsweise enthält AEM mehrere Vorlagen, darunter eine Inhaltsseite und eine Homepage.

Anzeigen von Standardvorlagen displaying-default-templates

Um eine Liste aller Vorlagen im Repository anzuzeigen, gehen Sie wie folgt vor:

In den meisten Fällen nehmen Sie eine vorhandene Vorlage und entwickeln eine neue für Ihre eigene Verwendung. Siehe Entwickeln von Seitenvorlagen für weitere Informationen.

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)?

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, basierend auf einer Umkehrung 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 einfach Modelle, die zum Erstellen neuer Seiten verwendet werden. Sie können so wenig oder so viel anfänglichen Inhalt wie nötig enthalten. Ihre Rolle besteht darin, die richtigen anfänglichen Knotenstrukturen zu erstellen, wobei die erforderlichen Eigenschaften (hauptsächlich sling:resourceType) so eingestellt sind, dass sie die Bearbeitung und Wiedergabe ermöglichen.

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

Selbstverständlich kann eine neue Vorlage komplett neu erstellt werden. Oft wird jedoch eine vorhandene Vorlage kopiert und aktualisiert, um Ihnen Zeit und Mühe zu sparen. Beispielsweise können die Vorlagen in Geometrixx für die ersten Schritte verwendet werden.

So erstellen Sie eine neue Vorlage basierend auf einer vorhandenen Vorlage:

Verfügbarmachen einer vorhandenen Vorlage making-an-existing-template-available

Dieses Beispiel zeigt, wie eine Vorlage für bestimmte Inhaltspfade verwendet werden kann. Die Vorlagen, die Autoren bei der Erstellung neuer Seiten zur Verfügung stehen, werden durch die in Vorlagenverfügbarkeit definierten Logik bestimmt.