Konfiguration des Publishers
Der Publisher ist auf verschiedene Weisen zu konfigurieren:
Die Datei
publisher.cfg
in/etc/speedata/
, im Homeverzeichnis (mit Punkt davor) und im aktuellen Verzeichnis (Linux, Mac)Die Datei
%APPDATA%\speedata\publisher.cfg
und im aktuellen Verzeichnis (Windows)Die Parameter auf der Kommandozeile
Die Angaben in der Layoutdatei
Die Konfigurationsdatei publisher.cfg
Die Datei publisher.cfg
ist eine Datei, die beim Starten des Publishers eingelesen wird.
Es ist eine einfache Textdatei, die den Aufbau Schlüssel = Wert
hat.
data = data.xml
layout = layout.xml
# Das ist ein Kommentar
Das Format muss eingehalten werden, sonst wird die Datei nicht richtig erkannt. Folgende Optionen werden unterstützt:
autoopen
wenn hier
true
anstelle vonfalse
steht, wird das PDF nach dem Publisher Durchlauf automatisch geöffnet. Derselbe Effekt lässt sich über die Kommandozeile mit--autoopen
erreichen.cache
Caching-Strategie für http(s) Dateien. Entweder
fast
, dann wird nur geschaut, ob die Datei im Dateisystem vorhanden ist oderoptimal
, dann wird bei jedem Zugriff auf die Datei geprüft, ob sie aktualisiert werden muss.data
Name der XML-Daten. Wenn nicht vorhanden, wird die Datei
daten.xml
geladen.dummy
Wenn
true
, dann wird die Datendatei nicht eingelesen. Anstatt dessen wird wird der folgende Inhalt angenommen:<data />
. Das dient zum einfachen Testen von Layoutregelwerken.extra-dir
Ein Verzeichnis im Dateisystem, das Dateien für den Publisherlauf enthält. Dazu gehören die Schriftdateien, die XML-Dateien (Daten und Layoutregelwerk) sowie die einzubindenden Bilddateien. Sollen mehrere Verzeichnisse hinzugefügt werden, müssen diese mit
:
oder;
getrennt werden, je nach Betriebssystem (Windows:;
, alle anderen::
). Das aktuelle Verzeichnis wird automatisch eingebunden. Beispiel unter Windows:extra-dir=c:\myfonts
.extraxml
Diese XML-Dateien zu den Layoutanweisungen hinzufügen. Kommaseparierte Liste (
extraxml=datei1.xml,datei2.xml
).prependxml
Diese XML-Dateien vor den Layoutanweisungen hinzufügen. Kommaseparierte Liste (
prependxml=datei1.xml,datei2.xml
).filter
Führt die angegebene Datei als Lua-Filter aus. Siehe Abschnitt Lua-Filter / Datenvorverarbeitung.
fontpath
Setzt den systemweiten Pfad für Fonts. Unter Windows ist dies
%WINDIR%\Fonts
, unter Mac OS X/Library/Fonts:/System/Library/Fonts
. Funktioniert derzeit nicht unter Windows XP.grid
Bestimmt, ob das Raster angezeigt wird.
imagecache
Ordner für zwischengespeicherte Dateien (nur
file="http://..."
). Voreinstellung:$TMPDIR/sp/images
.ignore-case
Ignoriere die Groß- und Kleinschreibung für Dateizugriff.
inkscape
Pfad zum Inkscape-Programm.
jobname
Name der Ausgabedatei ohne Dateiendung. Voreinstellung ist
publisher
.layout
Name des Layoutregelwerks.
layout.xml
ist der voreingestellte Name.opencommand
Kommando für das automatische Öffnen der Dokumentation bzw. PDF-Datei. Für MacOS X sollte das
open
sein, für Linuxxdg-open
oderexo-open
(xfce).pathrewrite
Kommaseparierte Liste der Form Pfadteil=Pfadteil. Beispiel:
/media/=%(projectdir)s/myfiles/
. Das würde absolute Pfadangaben wiefile:///media/XYZ
infile:///Pfad/zum/Projekt/myfiles/XYZ
ändern.runs
Setzt die Anzahl der Durchläufe fest.
startpage
Nummer der ersten Seite.
tempdir
Name des temporären Verzeichnisses. Voreinstellung ist die des Systems.
timeout
Maximale Dauer des Publishing-Laufs. Wenn dieser Wert überschritten wird, bricht der Lauf mit Fehler 1 ab.
vars
Kommaseparierte Liste der Form
var=wert
um Variablen in der Konfigurationsdatei festzulegen.
In der Konfigurationsdatei kann mit %(projectdir)s
auf das Verzeichnis
zugegriffen werden, in dem die Datei publisher.cfg
liegt.
Alle Angaben in dieser Konfigurationsdatei sind optional.
Alle folgenden Konfigurationsdateien werden in dieser Reihenfolge eingelesen: /etc/speedata/publisher.cfg
, ~/.publisher.cfg
und im aktuellen Verzeichnis publisher.cfg
.
Das aktuelle Verzeichnis kann beim Aufruf des Publishers mittels --wd=...
geändert werden.
Parameter auf der Kommandozeile
Die erlaubten Parameter auf der Kommandozeile werden im Abschnitt über die Kommandozeile aufgeführt.
Angaben in der Layoutdatei
Das Layoutregelwerk erlaubt manche Parameter zu setzen. Dazu gehören die Angaben, die im Element Options gesetzt werden.