Template-Sprache

Beitragsmuster und ihre Attribute verwenden

Beitragsmuster in einem Newsletter-Template können typisiert und mit verschiedenen Eigenschaften versehen werden. So lassen sich beim Erstellen eines Newsletters einfach und schnell vordefinierte Inhaltsbausteine platzieren, die ganz unterschiedliche Aufgaben erfüllen. Dabei wird die Arbeit der Autoren erleichtert, indem Beiträgen eindeutige Bezeichnungen und Symbole zugewiesen werden.

Ein Muster wird üblicherweise von einem div-Tag umschlossen. Alle darin enthaltenen HTML-Elemente werden im Newsletter ausgegeben - entweder unverändert oder angereichtert um die in der Bearbeitungsmaske erfassten Inhalte. Der div-Tag selbst wird vom Template-System aus dem Quellcode herausgefiltert. Er sollte also keine Formatierungs- oder CSS-Eigenschaften erhalten.

Beispiel

<div sipa:type="entry" sipa:id="teaser" sipa:title="Aufmacher" sipa:icon="teaser">
...
</div>

Folgende Attribute lassen sich für ein Beitragsmuster verwenden.

Attribut sipa:type

Über dieses Attribut wird ein Beitragstyp vergeben, an den systemspezifische Funktionen gebunden sind. Beispielsweise bestimmt der Typ, ob ein Autor überhaupt Inhalte erfassen kann oder ob es sich um einen statischen, also nicht zu verändernden Beitrag handelt. sipa:type kann folgende Werte annehmen:

Wert Beschreibung
toc Inhaltsverzeichnis (englisch: Table of Contents)
entry Beitrag mit erfassten Inhalten, z.B. Bilder und Texte
static Unveränderlicher Beitrag, z.B. ein Trennelement
custom Benutzerdefinierter Beitrag

Attribut sipa:id

Jedes Beitragsmuster muss über dieses Attribut einen eindeutigen Identifikator erhalten. Der Wert von sipa:id kann aus Buchstaben und Ziffern bestehen und darf nur einmal im Newsletter-Template vergeben werden.

Attribut sipa:title

Um einem Beitragsmuster eine sprechende Bezeichnung zu geben, die in der Benutzeroberfläche verwendet wird, kann man mit diesem Attribut einen Titel definieren. Sonderzeichen und Umlaute müssen in sipa:title als sogenannte HTML-Entities gesetzt werden.

Attribut sipa:icon

Um die Auswahl von Beiträgen visuell zu unterstützen hält sitepackage:// einige Symbole bereit, die über dieses Attribut angesprochen werden können. Das deklarierte Symbol erscheint dann neben dem Beitragstitel in der Benutzeroberfläche. sipa:icon kann folgende Werte annehmen:

Wert Beschreibung Symbol
header Kopfzeile Kopfzeile
toc Inhaltsverzeichnis Verzeichnis
teaser Aufmacher Aufmacher
editorial Editorial Editorial
image-text Bild-Text Bild-Text
text-image Text-Bild Text-Bild
2-column Zweispaltig Zweispaltig
3-column Dreispaltig Dreispaltig
static Statisches Element
Trennung
custom Benutzerdefiniert Benutzerdefiniert