Vorlagen

Vorlagen werden von Mibakus benutzt, um die Dokumente in PDF-Dateien zu erzeugen. Diese Vorlagen sind einfache Text-Dateien. Sie enthalten sowohl Textbausteine als auch Angaben über die gewünschten Formatierungen. Für jeden erzeugten Dokumenttyp gibt es eine interne Vorlage, z.B. für das Anschreiben zur Nebenkostenabrechnung, für Mieterbriefe oder Übergabeformulare.

Viele dieser Vorlagen können Sie durch eigene Vorlagen ersetzen, z.B. die Vorlage für die Übergabeformulare. Dabei können Sie beliebig viele eigene Vorlagen erzeugen. Diese werden in einem Unterverzeichnis “Vorlagen” des Verzeichnisses gespeichert, dass auch den “.miba”-File enthält.

Mibakus geht in drei Schritten vor, um aus einer Vorlage einen PDF-File zu erzeugen. Die folgenden Abschnitte enthalten jeweils Verweise auf weiterführende Dokumentation.

1. Velocity

Mibakus benutzt die externe Bibliothek Velocity, um im Text der Vorlage aktuelle Daten aus dem Programm einzutragen. Dazu können im File Variablen benutzt werden, die durch Programmdaten ersetzt werden. Velocity kann auch Textteile wiederholen oder abhängig von Programmdaten auslassen.

2. Markdown

Velocity hat ein Textdokument im sogenannten “Markdown”-Format erzeugt. Zusätzlich können noch Stil-Informationen zur genauen Formatierung enthalten sein. Dieses angereicherte Markdown-Dokument wird mittels der Bibliothek markdown-fo-transformer in ein XSL-FO-Dokument transformiert.

3. Apache-FOP

Apache-FOP erzeugt dann aus dem XSL-FO das eigentliche PDF-Dokument.