Konfiguration
Um das PDF-Plugin zu nutzen, musst du es zuerst konfigurieren.
Kopiere die Datei „settings.conf.dist“ aus dem Verzeichnis „plugins/pdfPlugin/src/main/resources“, speichere sie als „settings.conf“ und passe sie wie folgt an:
Um die Konvertierung zu starten, musst du das Programm wkhtmltopdf auf deinem Betriebssystem installieren. Der Pfad zur ausführbaren Datei von wkhtmltopdf muss in der Datei „settings.conf“ angegeben werden. Außerdem benötigst du zwei Ordner, einen für deine Vorlagen und den anderen für die temporären Daten während der Konvertierung. Du kannst entweder relative oder absolute Pfade für die Ordner verwenden.
Zum Beispiel:
pdfPlugin {
storageDir = "templates"
tempDir = "tmp"
wkhtmltopdf = "C:/Program Files/wkhtmltopdf/bin/wkhtmltopdf.exe"
}
....
HINWEIS:
Wenn du wkhtmltopdf auf einem Linux ohne X11-Server verwendest, kann der Fehler „wkhtmltopdf: cannot connect to X server“ auftreten.
In diesem Fall musst du das Programm „xvfb“ über den Paketmanager installieren, um den X11-Server zu simulieren.
Erstelle einen Wrapper (z. B. /usr/local/bin/wkhtmltopdf-xvfb) für das Programm „wkhtmltopdf“ und trage den Pfad in die PdfPlugin-Konfiguration ein.
<#!/bin/bash> xvfb-run --server-args="-screen 0, 1024x768x24"/usr/bin/wkhtmltopdf$*
Plugin-Ausführung
Das Plugin befindet sich im Verzeichnis: plugins/pdfPlugins. Es kann mit SBT/Activator über einen „run“-Befehl aktiviert werden. Der STDIN-Befehl „stop“ beendet die Plugin-Ausführung.
Du kannst die logback-Konfigurationsdatei „plugins/pdfPlugin/src/main/resources/logback.xml“ anpassen, um die Protokollausgabe zu konfigurieren oder sie in einer anderen Datei anzuzeigen.
