[]{class="badge informative"}
Veröffentlichungsvorlagen publication-templates
Über Veröffentlichungsvorlagen about-publication-templates
Die Publikationsvorlage verweist auf die im Veröffentlichungsprozess verwendeten Ressourcen, d. h.:
- das Datenschema,
- das Formular,
- die Umwandlungsvorlagen für jedes Ausgabedokument.
Identifizierung von Veröffentlichungsvorlagen identification-of-a-publication-template
Eine Veröffentlichungsvorlage wird über ihren Namen und Namespace identifiziert.
Der Identifikationsschlüssel eines Stylesheets ist ein String, der den Namespace und den Namen enthält, getrennt durch einen Doppelpunkt (z. B. cus:newsletter).
Erstellen und Konfigurieren der Vorlage creating-and-configuring-the-template
Standardmäßig werden Veröffentlichungsvorlagen im Knoten Administration > Konfiguration > Veröffentlichungsvorlagen gespeichert. Klicken Sie dort zur Erstellung einer neuen Vorlage auf die Schaltfläche Neu.
Geben Sie den Namen der Vorlage (d. h. den aus Namespace und Namen bestehenden Identifikationsschlüssel), den Titel, das zugeordnete Datenschema sowie das entsprechende Formular an.
Die Option Zur Erstellung des Inhalts Status prüfen stellt sicher, dass die Inhaltsinstanzen den Status „Validiert“ aufweisen, bevor die Datei erzeugt wird. Weitere Informationen hierzu finden Sie im Abschnitt Veröffentlichung.
Für jedes Ausgabedokument muss eine Umwandlungsvorlage hinzugefügt werden. Sie können so viele Umwandlungsvorlagen wie nötig erstellen.
Im Feld Vorlagenname wird ein frei wählbarer Titel angegeben, der das Rendering des Ausgabedokuments beschreibt. Für jede Umwandlungsvorlage sind die Veröffentlichungseinstellungen in den Registerkarten verfügbar.
Rendering rendering
Konfigurieren Sie im Rendering-Tab folgende Parameter:
- den Typ der Umwandlungsvorlage: XSL-Stylesheet oder JavaScript-Template;
- das Format des Ausgabedokuments: HTML, Text, XML oder RTF;
- den Namen der Vorlage, die die Umwandlungsinformationen enthält, d. h. des Stylesheets oder des JavaScript-Templates.
Veröffentlichung publication
Veröffentlichung bezeichnet den Vorgang der Erzeugung des Ausgabedokuments in Form einer Datei. Wählen Sie hierzu im gleichnamigen Tab im Feld Typ die Option Datei.
Des Weiteren können folgende Veröffentlichungsparameter konfiguriert werden:
-
Den Zeichensatz für die Codierung der Ausgabedatei können Sie mithilfe des Felds Codierung erzwingen. Standardmäßig wird der Zeichensatz „Latin 1 (1252)“ verwendet.
-
Mit der Option Multidatei-Erzeugung wird ein spezieller Modus für die Veröffentlichung von Dokumenten aktiviert. Bei dieser Option wird am Anfang jeder Seite des Ausgabedokuments ein Partitionierungs-Tag eingefügt. Durch Generieren des Inhalts wird eine Datei für jedes ausgefüllte Partitionierungs-Tag erstellt. Dieser Modus wird verwendet, um aus einem Inhaltsbaustein Mini-Sites zu generieren. Weitere Informationen hierzu finden Sie im Abschnitt Multidatei-Erzeugung.
-
Das Feld Speicherort enthält den Namen der Ausgabedatei. Sie können den Namen aus Variablen zusammensetzen, um den Dateinamen automatisch zu generieren.
Die Variablen sind wie folgt anzugeben:
$(<xpath>), wobei<xpath>den Pfad eines Felds des der Veröffentlichungsvorlage zugrunde liegenden Datenschemas bezeichnet.Beispielsweise kann der Dateiname auf ein Datumsfeld verweisen. In diesem Fall ist die Funktion $date-format zu verwenden und Feldpfad sowie Ausgabeformat sind anzugeben.
Standardmäßig wird der Dateiname unter Verwendung der Variablen “@name” und “@date” konstruiert:
code language-xml ct_$(@name)_$date-format(@date,'%4Y%2M%2D').htmDer Dateiname nimmt somit folgende Form an: ct_news12_20110901.htm.
note NOTE Weitere Informationen zur Inhaltserstellung finden Sie unter Erstellen einer Inhaltsinstanz.
Versand delivery
In dieser Registerkarte können Sie ein Szenario auswählen, um einen Versand direkt mit dem Inhalt zu starten. Der Inhalt der E-Mail wird automatisch basierend auf dem Ausgabeformat (HTML oder Text) ausgefüllt.
Aggregator aggregator
Sie können das XML-Ausgabedokument durch die Aggregation von Daten mithilfe eines Skripts oder einer Abfrageliste anreichern. Ziel ist es, bestimmte durch Links referenzierte Informationen zu ergänzen oder Elemente aus der Datenbank hinzuzufügen.
Multidatei-Erzeugung multi-file-generation
Um die Generierung mehrerer Dateien zu aktivieren, wählen Sie im Veröffentlichungsmodell die Option Multidatei-Erzeugung aus. Mit dieser Option können Sie im Stylesheet Partitionierungs-Tags für den Beginn jeder Seite des Ausgabedokuments angeben. Bei der Inhaltserstellung wird für jedes vorhandene Partitionierungs-Tag eine Datei erstellt.
Das zu verwendende Trennzeichen stellt sich wie folgt dar:
<xsl:comment> #nl:output_replace(<name_of_file>) </xsl:comment>, wobei <name_of_file> der Dateiname der zu erzeugenden Seite ist.
Beispiel: Multidatei-Erzeugung mit dem Schema „cus:book“.
Ziel ist es, eine Hauptseite zu erzeugen, die die Kapitel auflistet und die Möglichkeit bietet, die Details der Kapitel in einer externen Seite anzuzeigen.
Das entsprechende Stylesheet („cus:book.xsl“) lautet wie folgt:
<?xml version="1.0" encoding="ISO-8859-1" ?>
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
<xsl:output encoding="ISO-8859-1" method="html"/>
<!-- Style sheet entry point -->
<xsl:template match="/book">
<html>
<body>
<h1><xsl:value-of select="@name"/></h1>
<lu>
<xsl:for-each select="chapter">
<li><a target="_blank" href="chapter{@id}.htm"><xsl:value-of select="@name"/></a></li>
</xsl:for-each>
</lu>
</body>
</html>
</xsl:template>
</xsl:stylesheet>
Ein zweites Stylesheet („cus:chapter.xsl“) ist erforderlich, um die Details der Kapitel zu generieren:
<?xml version="1.0" encoding="ISO-8859-1" ?>
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
<xsl:output encoding="ISO-8859-1" method="html"/>
<!-- Detail of a chapter -->
<xsl:template match="chapter">
<!-- Cut tag -->
<xsl:comment> #nl:output_replace($(path)/chapter<xsl:value-of select="@id"/>.htm)</xsl:comment>
<html>
<body>
<h1><xsl:value-of select="@name"/></h1>
<xsl:value-of select="page" disable-output-escaping="yes"/>
</body>
</html>
</xsl:template>
<!-- Style sheet entry point -->
<xsl:template match="/book">
<xsl:apply-templates/>
</xsl:template>
</xsl:stylesheet>
Das Trennzeichen wird zu Beginn jeder Seite angegeben, die in die zu erzeugende Datei einzuschließen ist.
<xsl:comment> #nl:output_replace($(path)/<xsl:value-of select="@id"/>.htm)</xsl:comment>
Der Dateiname wird mit der Variable $(path) konstruiert, welche den Veröffentlichungspfad bezeichnet, ergänzt durch <xsl:value-of select="@id" />, was der Kennung des Kapitels im Quelldokument entspricht.
Das Veröffentlichungsmodell muss mit den beiden Stylesheets „cus:book.xsl“ und „cus:chapter.xsl“ gefüllt werden.
In der Umwandlungsvorlage der Kapitel ist die Option Multidatei-Erzeugung zu aktivieren:
Auch wenn das Feld Speicherort bei der Multidatei-Erzeugung nicht verwendet wird, muss ein Dateiname angegeben werden, um eine Fehlermeldung bei der Veröffentlichung zu vermeiden.