PDF- und XML-Vorlagen
Eine PDF-Vorlage legt fest, wie das Programmheft aussieht. Eine XML-Vorlage liefert dieselben Angaben als Daten, etwa für ein Satzprogramm.
Beide Arten schreiben Sie im Editor der Exportvorlagen in Twig, einer Sprache für Vorlagen. Was für alle Vorlagen gilt, steht dort.
Was fepli aus der Vorlage macht
- In der Vorlage heißen die Angebote
items. - Schreibt HTML, die Sprache von Webseiten, einen Abschnitt je Angebot.
- fepli macht daraus Seiten, mit Seitenformat, Rändern und Grundschrift der Vorlage.
- In der Vorlage heißen die Angebote
offers. - Schreibt XML, einen Eintrag je Angebot.
- fepli gibt es aus, wie es dasteht, sobald jedes Element richtig geöffnet und geschlossen ist.
Eine PDF-Vorlage schreibt HTML, die Sprache von Webseiten. fepli setzt daraus mit dem Programm mPDF die Seiten des PDF. Eine XML-Vorlage wird so ausgegeben, wie sie geschrieben ist. fepli schreibt die Datei aber erst, wenn das XML wohlgeformt ist, also jedes Element richtig geöffnet und geschlossen.
Seite und Schrift
Diese Einstellungen hat nur eine PDF-Vorlage.
| Feld | Bedeutung | Werte | Standard |
|---|---|---|---|
| Seitenformat | Größe der Seite | A4, A5, A6 | A4 |
| Hoch, Quer | Ausrichtung der Seite | Hoch, Quer | Hoch |
| Ränder in mm | Abstand zum Seitenrand: Oben, Rechts, Unten, Links | 0 bis 40 | 15 |
| Grundschrift | Schrift des ganzen Dokuments, aus den mitgelieferten und den hochgeladenen Schriften | Name einer Schrift | Geist |
| Schriftgröße | Größe der Grundschrift in Punkt (pt) | 6 bis 24, in Schritten von 0,5 | 11 |
Quelltext und Vorschau
In der Mitte steht der Quelltext der Vorlage mit Zeilennummern. Darunter steht in der Statuszeile „Keine Fehler“ oder „Zeile {Zeile}: {Meldung}“; die fehlerhafte Zeile ist rot markiert.
Rechts wechseln Sie zwischen zwei Ansichten:
| Ansicht | Inhalt |
|---|---|
| Vorschau | Das Ergebnis mit den ersten Angeboten der Saison, die gerade eine Bearbeitungsphase hat. Hat sie keine Angebote, nimmt fepli Beispielangebote. Ein PDF erscheint mit seinen Seiten, ein XML als Text. |
| Variablen | Die Angaben, die sich einfügen lassen (Variablen). Ein Eintrag fügt seinen Text an der Schreibmarke ein. |
Hat die Vorlage einen Fehler, zeigt die Vorschau „Vorschau nicht möglich“ mit der Meldung und dem Link Zur Zeile {Zeile}.
Variablen
Eine Variable ist ein Platzhalter, an dessen Stelle fepli eine Angabe des Angebots setzt. Die PDF-Vorlage erhält die Angebote als items, die XML-Vorlage als offers. In der Tabelle steht list für diese Liste.
| Variable | Inhalt | Gilt in |
|---|---|---|
list | Die Angebote des Exports. Der Eintrag fügt eine Schleife for offer in … ein, die sich je Angebot wiederholt. | PDF, XML |
offer.name | Titel | PDF, XML |
offer.number | Angebotsnummer | PDF, XML |
offer.teaser | Kurzbeschreibung | PDF, XML |
offer.description | Beschreibung, aufbereitet wie auf der Website. Eingebettetes HTML und unsichere Links entfallen. | PDF, XML |
offer.dates | Termine mit begin und end | PDF, XML |
offer.minAge, offer.maxAge | Alter von, Alter bis | PDF, XML |
offer.fee | Beitrag in Euro oder Franken, wie eingestellt | PDF, XML |
offer.meetingPoint | Treffpunkt | PDF, XML |
offer.bring | Mitbringen | PDF, XML |
offer.applyText | Hinweis zur Anmeldung, wenn sie nicht über fepli läuft | PDF, XML |
offer.hosts | Veranstalter:innen mit name | PDF, XML |
offer.categories | Kategorien mit name | PDF, XML |
offer.properties | Eigene Merkmale mit Im Heft ausgeben, mit label und value (Einstellungen) | PDF, XML |
edition.name | Saison | PDF, XML |
today | Datum des Exports | PDF, XML |
images | Logos der Veranstalter:innen mit path und dimensions | XML |
<pagebreak /> | Neue Seite | |
{PAGENO} / {nbpg} | Seitenzahl in Kopf- oder Fußzeile | |
<htmlpagefooter> | Fußzeile auf jeder Seite | |
var:tenantLogo | Logo der Instanz, z. B. <img src="var:tenantLogo" height="18mm" /> | |
loop.index, loop.last | Zähler in Schleifen | PDF, XML |
date | Formatiert ein Datum, z. B. date('d.m.Y') | XML |
<![CDATA[ … ]]> | Text mit Sonderzeichen | XML |
Regeln
| Regel | Inhalt |
|---|---|
| Erlaubtes Twig | Eine Vorlage darf nur eine Auswahl der Befehle von Twig nutzen. Eine Variable, die es nicht gibt, ist ein Fehler. |
| Bilder und Links im PDF | Ihre Adressen müssen mit var:, data: oder # beginnen. fepli entfernt jede andere Adresse. Dateien des Servers kommen nie ins PDF. |
| Schriften im PDF | font-family nennt den Namen einer Schrift aus den Schriften. |
| Farben für den Druck | cmyk(C, M, Y, K) mit Werten von 0 bis 100, z. B. color: cmyk(0, 85, 90, 0). Das PDF enthält sie in CMYK, Vorschau und PDF-Studio zeigen sie angenähert. Bilder behalten ihre Farben. |
| PDF-Studio | Das PDF-Studio findet die Seiten der Angebote, wenn die Vorlage sie in einer Schleife über items schreibt, ein Abschnitt je Angebot. |
| Anpassungen aus dem PDF-Studio | Gelten für diese Vorlage und dieses Angebot, bis sich eins von beiden ändert (Herkunft). |
Meldungen
| Meldung | Bedeutung |
|---|---|
| „Variable „{Name}“ gibt es hier nicht.“ | Die Vorlage nutzt eine Variable, die es nicht gibt. Die Liste Variablen zeigt die richtigen Namen. |
| „Ein Feld „{Name}“ gibt es hier nicht.“ | Das Angebot hat kein Feld dieses Namens. |
| „Filter „{Name}“ gibt es nicht.“, „Funktion „{Name}“ gibt es nicht.“ | Twig kennt keinen Befehl dieses Namens. |
| „Tag „{Name}“ ist in Exportvorlagen nicht erlaubt.“, auch für Filter und Funktionen | Den Befehl gibt es, aber Exportvorlagen dürfen ihn nicht nutzen. |
| „Ein Block ist nicht geschlossen – fehlt endfor oder endif?“ | Ein for oder if hat kein Ende. |
| „Ausgabe ist kein gültiges XML: {Meldung}“ | Das Ergebnis einer XML-Vorlage ist nicht wohlgeformt. fepli schreibt die Datei nicht. |