Aufbau

Der grundlegende Aufbau und die Konverter-Einstellungen für ein parsX-EPUB werden in einem sog. ConfigSetting gespeichert. Man könnte dieses auch als "Vorlage" oder "Template" bezeichnen (der Begriff "Template" ist jedoch im parsX-EPUB-Konverter bereits anders belegt).

Ein ConfigSetting ist ein Ordner im lokalen Dateisystem oder auf einem Netzlaufwerk, der nach folgendem Muster benannt ist: cfg.XyzABcd

Dieser Ordner enthält eine XML-basierte Konfigurationsdatei und ein Vorlagen-Verzeichnis.

Konfigurationsdatei (ConfigFile)

Die Konfigurationsdatei config.epub.xml (auch ConfigFile) enthält alle ~160 Einstellungsmöglichkeiten für den parsX EPUB-Konverter.

Sie sollte möglichst nicht von Hand, sondern immer über den Online-ConfigFile-Generator erzeugt oder bearbeitet werden.

Die Datei ist mit einem Versions-Attribut versehen welches vom EPUB-Konverter ausgewertet wird. Wird beispielsweise versucht, den EPUB-Konverter 3.1 mit einem ConfigFile der Version 2.4 zu starten, wird ein Fehler ausgegeben mit dem Hinweis, das ConfigFile online zu aktualisieren.

Vorlagen-Verzeichnis

Das Vorlagen-Verzeichnis epub-vorlage/ enthält ein grundlegendes EPUB-Skelett, also mindestens die Ordner META-INF/ und OEBPS/ sowie die Datei mimetype.

Im Ordner META-INF/ muss die Datei container.xml mit einem Verweis auf die OPF-Datei existieren. Optional kann auch die iBooks-Display-Options-XML-Datei dort hinterlegt werden.

Im Ordner OEBPS/ können Unterorder für Schriften (fonts/) und Abbildungen (images/) hinterlegt werden, sowie ein oder mehrere CSS-Stylesheets auf oberster Ebene.

Workflow

Der parsX EPUB-Konverter erstellt aus den XML-Daten und den Inhalten aus dem ConfigSetting das fertige EPUB. Die Struktur des Vorlagen-Ordners findet sich so auch im fertigen EPUB wieder.