Abbildungsprüfung (<check_image>)

Seit parsX 3.3 kann mit Hilfe des neuen Elements <check_image> im <head>-Element der TPL-Templatedatei geprüft werden, ob eine Abbildung (nicht) existiert.

Beispiel 17. Prüfung ob Abbildung existiert

<head>
    [...]
    <check_image name="tpl-anzeige.jpg" exists="true" />
</head>

Oder in Kurzschreibweise:

<head>
    [...]
    <check_image name="tpl-anzeige.jpg" />
</head>

Beide Beispiele prüfen die Verfügbarkeit der Abbildung tpl-anzeige.jpg im XML-Abbildungsordner UND im ConfigSetting-Image-Ordner.

Wird die Abbildung an einem der beiden Orte gefunden wird das TPL-Template eingebunden, andernfalls nicht.


Beispiel 18. Prüfung ob Abbildung nicht existiert

<head>
    [...]
    <check_image name="tpl-anzeige.jpg" exists="false" />
</head>

Dieses Beispiel prüft die Nicht-Verfügbarkeit der Abbildung tpl-anzeige.jpg sowohl im XML-Abbildungsordner als auch im ConfigSetting-Image-Ordner.

Wenn die Abbildung in beiden Ordnern (also im EPUB) fehlt, dann wird das TPL-Template eingebunden, andernfalls nicht.

Tipp: Ein möglicher Anwendungsfall wäre ein Text-TPL-Template als Fallback für ein Bild-Anzeigen-Template das nur eingebunden wird, wenn die Bild-Anzeige fehlt.