Kategorie:Papaya-Formatierungsobjekt

Aus PapayaCMS

Mit dem PDF-Template erzeugen Sie ein papaya-Formatierungsobjekt, dass durch den PDF-Prozessor von papaya CMS in ein PDF-Dokument übersetzt wird. Wenn Sie ein eigenes PDF-Template schreiben, müssen Sie also die XML-Struktur der Modulausgabe kennen:

• Sie können die XML-Ausgabe von Seiten aktivieren und anzeigen lassen, siehe XML-Ausgabe aktivieren und anzeigen lassen.
• Die Dokumentation der XML-Seitenausgabe finden Sie in Struktur der XML-Seitenausgabe.

Um das papaya-Formatierungsobjekt schreiben zu können, müssen Sie wissen, wie es aufgebaut ist. Beim papaya-Formatierungsobjekt handelt es sich um ein XML-Dokument, das aus einem Layoutbereich und mehreren Inhaltsbereichen besteht. Im Layoutbereich wird das Layout der Inhalte bestimmt, die in das PDF gesetzt werden. Im Inhaltsbereich werden die Inhalte aus dem aktuellen Seitenmodul gesetzt. Diese Aufteilung in Layoutbereich und Inhaltsbereich ist bewußt an XSL-FO angelehnt.

Im Inhaltsbereich können Sie zudem HTML-Elemente benutzen, um die Inhalte zu formatieren. Es handelt sich hierbei lediglich um eine Untermenge aller HTML-Elemente. Es werden also nicht alle Elemente aus dem HTML-Standard (Version 4.01) und ihre jeweiligen Attribute unterstützt. Zudem müssen die Elemente so benutzt werden, dass sie mit den XML-Syntaxregeln konform sind. Zu den HTML-Elementen im Inhaltsbereich gehören zwei Gruppen von Elementen:

• Block-Level-Elemente, siehe Block-Level-Elemente.
• Inline-Elemente, siehe Inline-Elemente.

Die Struktur des papaya-Formatierungsobjektes ist in der folgenden Illustration dargestellt:

Grundstruktur des Papaya-Formatierungsobjektes

Das Wurzelelement <article> enthält den Layoutbereich im Element <layout>, während der Inhaltsbereich auf die Elemente <cover>, <content>, <footer> und <final> aufgeteilt ist. In den folgenden Unterabschnitten werden diese Elemente näher beschrieben.