Element-Abfragen

Um diese Schwäche der Textvariablen zu umgehen, sind seit Version 2 der Template-Engine Element-Abfragen möglich.

Element-Abfragen werden über das Attribut @valueOf="element" an einem beliebigen HTML-Element im TPL-Template erzeugt.

Dabei greift die Template-Engine ausschließlich auf die E-Book-Metadaten aus dem Element <titelei_ebook> zu. Einzige Ausnahme ist hier die Print-ISBN aus den "normalen" Metadaten die mit meta_isbn abgefragt werden kann.

Anmerkung

	Anmerkung
Erlaubt sind die folgenden Element-Aufrufe: meta_titel \| meta_untertitel \| meta_e-isbn \| meta_isbn \| meta_doi \| meta_urn \| meta_id \| meta_uebersetzer-abs \| meta_uebersetzer-1 \| meta_uebersetzer-2 \| meta_uebersetzer-3 \| meta_uebersetzer-4 \| meta_uebersetzer-5 \| meta_illustratoren-abs \| meta_illustrator-1 \| meta_illustrator-2 \| meta_illustrator-3 \| meta_illustrator-4 \| meta_illustrator-5 \| meta_gattung \| meta_herausgeber-abs \| meta_herausgeber-1 \| meta_herausgeber-2 \| meta_herausgeber-3 \| meta_herausgeber-4 \| meta_herausgeber-5 \| meta_autoren-abs \| meta_autor-1 \| meta_autorvorname-1 \| meta_autornachname-1 \| meta_autor-2 \| meta_autorvorname-2 \| meta_autornachname-2 \| meta_autor-3 \| meta_autorvorname-3 \| meta_autornachname-3 \| meta_autor-4 \| meta_autorvorname-4 \| meta_autornachname-4 \| meta_autor-5 \| meta_autorvorname-5 \| meta_autornachname-5 \| meta_co-autoren-abs \| meta_co-autor-1 \| meta_co-autorvorname-1 \| meta_co-autornachname-1 \| meta_co-autor-2 \| meta_co-autorvorname-2 \| meta_co-autornachname-2 \| meta_co-autor-3 \| meta_co-autorvorname-3 \| meta_co-autornachname-3 \| meta_co-autor-4 \| meta_co-autorvorname-4 \| meta_co-autornachname-4 \| meta_co-autor-5 \| meta_co-autorvorname-5 \| meta_co-autornachname-5 \| meta_joker-1 \| meta_joker-2 \| meta_joker-3 \| meta_joker-4 \| meta_joker-5 \| meta_copyright \| meta_bio \| meta_kurztext \| meta_dl-name \| meta_datum-sperrfrist \| meta_datum-sperrfrist-freitext \| meta_datum-erscheinungstermin \| meta_datum-erscheinungstermin-freitext

Erlaubt sind die folgenden Element-Aufrufe:

parsX 3.0 - veraltete Element-Aufrufe

	parsX 3.0 - veraltete Element-Aufrufe
Mit parsX 3.0 wurden im Zuge der Metadaten-Überarbeitung einige Element-Aufrufe als "veraltet" markiert. Diese funktionieren auch weiterhin noch, erzeugen im EPUB-Log jedoch eine Warnung. Im folgenden Eine vollständige Liste mit Ersetzungen: `doi` => `meta_doi` `urn` => `meta_urn` `meta_e-copyright` => `meta_copyright` `meta_e-bio` => `meta_bio` `meta_e-kurztext` => `meta_kurztext` `meta_e-joker-1` => `meta_joker-1` `meta_e-joker-2` => `meta_joker-2` `meta_e-joker-3` => `meta_joker-3` `meta_e-joker-4` => `meta_joker-4` `meta_e-joker-5` => `meta_joker-5` `meta_illustrator` => `meta_illustrator-1` `meta_uebersetzer` => `meta_uebersetzer-1` `meta_hrsg-1` => `meta_herausgeber-1` `meta_hrsg-2` => `meta_herausgeber-2` `meta_hrsg-3` => `meta_herausgeber-3` `meta_hrsg-4` => `meta_herausgeber-4` `meta_hrsg-5` => `meta_herausgeber-5`

Mit parsX 3.0 wurden im Zuge der Metadaten-Überarbeitung einige Element-Aufrufe als "veraltet" markiert. Diese funktionieren auch weiterhin noch, erzeugen im EPUB-Log jedoch eine Warnung. Im folgenden Eine vollständige Liste mit Ersetzungen:

doi => meta_doi
urn => meta_urn
meta_e-copyright => meta_copyright
meta_e-bio => meta_bio
meta_e-kurztext => meta_kurztext
meta_e-joker-1 => meta_joker-1
meta_e-joker-2 => meta_joker-2
meta_e-joker-3 => meta_joker-3
meta_e-joker-4 => meta_joker-4
meta_e-joker-5 => meta_joker-5
meta_illustrator => meta_illustrator-1
meta_uebersetzer => meta_uebersetzer-1
meta_hrsg-1 => meta_herausgeber-1
meta_hrsg-2 => meta_herausgeber-2
meta_hrsg-3 => meta_herausgeber-3
meta_hrsg-4 => meta_herausgeber-4
meta_hrsg-5 => meta_herausgeber-5

Beispiel 23. Ausgabe des Titels

<div valueOf="meta_titel"/>

HTML-Ausgabe im EPUB:

<div>Buchtitel</div>

Beispiel 24. Ausgabe des Titels als Überschrift 6. Ebene

<h6>Titel ist: "<span valueOf="meta_titel"/>"</h6>

HTML-Ausgabe im EPUB:

<h6>Titel ist: "<span>Buchtitel</span>"</h6>

Falls eine Element-Abfrage kein Ergebnis liefert, wird das Element welches das @valueOf-Attribut enthält, entfernt.

Beispiel 25. Leere Ergebnis-Elemente werden gelöscht

<div valueOf="meta_joker-5"/>

HTML-Ausgabe im EPUB:

Falls dieses Verhalten nicht erwünscht ist, das Element also trotzdem leer erzeugt werden soll, kann das Attribut @preserveEmptyElement="true" gesetzt werden:

Beispiel 26. Leere Ergebnis-Elemente erhalten

<div valueOf="meta_joker-5" preserveEmptyElement="true"/>

HTML-Ausgabe im EPUB:

<div></div>

@class Attribute am abfragenden Element werden übernommen:

Beispiel 27. Attribute werden übernommen

<div valueOf="meta_untertitel" class="t_untertitel"/>

HTML-Ausgabe im EPUB:

<div class="t_untertitel">Buch-Untertitel</div>

	Achtung
Fehlerhafte Element-Abfragen erzeugen im Oxygen-Logfile UND im EPUB eine rot hinterlegte Fehlermeldung. Beispiel 28. Fehlerhafte Abfrage <div valueOf="keinElement"/> HTML-Ausgabe im EPUB: <div><span style="background-color: red;"><strong>FEHLER!</strong> Es sind nur die folgenden Element-Aufrufe erlaubt: `meta_titel`, `meta_untertitel`, [...]</span></div> Anzeige im EPUB: Liefern Sie niemals ein EPUB aus, welches eine solche Fehlermeldung enthält!

Achtung

Fehlerhafte Element-Abfragen erzeugen im Oxygen-Logfile UND im EPUB eine rot hinterlegte Fehlermeldung.

Beispiel 28. Fehlerhafte Abfrage

<div valueOf="keinElement"/>

HTML-Ausgabe im EPUB:

<div><span style="background-color: red;"><strong>FEHLER!</strong> Es sind nur die folgenden Element-Aufrufe erlaubt: `meta_titel`, `meta_untertitel`, [...]</span></div>

Anzeige im EPUB:

Liefern Sie niemals ein EPUB aus, welches eine solche Fehlermeldung enthält!