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 200+ 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 4.X mit einem ConfigFile der Version 3.X zu starten, wird ein Fehler ausgegeben mit dem Hinweis, dass das ConfigFile online aktualisiert werden muss.

Die Versionszählung des ConfigFiles ist nicht identisch mit der parsX-Version. Mit parsX 4.3.12 wird ein ConfigFile der Version 4.4 verwendet.

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.