Element-Abfragen

Um diese Schwäche der Textvariablen zu umgehen, sind seit parsX 3 sog. "Element-Abfragen" möglich.

Element-Abfragen werden über das Attribut @tpl: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 kennung-isbn abgefragt werden kann.

[Anmerkung]Anmerkung

Erlaubt sind die folgenden Element-Aufrufe:

titel, untertitel, gattung, id, kennung-isbn, kennung-isbn-print, kennung-doi, kennung-urn, uebersetzer-abs, uebersetzer-1, uebersetzer-2, uebersetzer-3, uebersetzer-4, uebersetzer-5, illustratoren-abs, illustrator-1, illustrator-2, illustrator-3, illustrator-4, illustrator-5, herausgeber-abs, herausgeber-1, herausgeber-2, herausgeber-3, herausgeber-4, herausgeber-5, autor-1, autorvorname-1, autornachname-1, autor-2, autorvorname-2, autornachname-2, autor-3, autorvorname-3, autornachname-3, autor-4, autorvorname-4, autornachname-4, autor-5, autorvorname-5, autornachname-5, co-autor-1, co-autorvorname-1, co-autornachname-1, co-autor-2, co-autorvorname-2, co-autornachname-2, co-autor-3, co-autorvorname-3, co-autornachname-3, co-autor-4, co-autorvorname-4, co-autornachname-4, co-autor-5, co-autorvorname-5, co-autornachname-5, autoren-abs, co-autoren-abs, blocktext_def-1, blocktext_def-2, blocktext_def-3, blocktext_def-4, blocktext_def-5, copyright, bio, kurztext, dienstleister-name, datum-sperrfrist, datum-sperrfrist-normiert, datum-erscheinungstermin, datum-erscheinungstermin-normiert, barrierefreiheit, bio-autor-1, bio-autor-2, bio-autor-3, bio-autor-4, bio-autor-5, bio-co-autor-1, bio-co-autor-2, bio-co-autor-3, bio-co-autor-4, bio-co-autor-5, bio-uebersetzer-1, bio-uebersetzer-2, bio-uebersetzer-3, bio-uebersetzer-4, bio-uebersetzer-5, bio-illustrator-1, bio-illustrator-2, bio-illustrator-3, bio-illustrator-4, bio-illustrator-5, bio-herausgeber-1, bio-herausgeber-2, bio-herausgeber-3, bio-herausgeber-4, bio-herausgeber-5,

[Anmerkung]parsX 3.0 + 4.0 - veraltete Element-Aufrufe

Mit parsX 3.0 und 4.0 wurden im Zuge der Metadaten-Überarbeitung einige Element-Aufrufe als "veraltet" markiert und der EPUB-Konverter erzeugt eine WARNUNG bei der Verwendung.

Mit folgender Mapping-Liste können Sie die veralteten Werte manuell aktualisieren – oder Sie verwenden das neue TPL-Migrationsskript.

Ab parsX 3.0:

  • 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

Ab parsX 4.0:

  • meta_titel => titel

  • meta_untertitel => untertitel

  • meta_isbn => kennung-isbn-print

  • meta_e-isbn => kennung-isbn

  • meta_doi => kennung-doi

  • meta_urn => kennung-urn

  • meta_gattung => gattung

  • meta_id => id

  • meta_uebersetzer-abs => uebersetzer-abs

  • meta_uebersetzer-1 => uebersetzer-1

  • meta_uebersetzer-2 => uebersetzer-2

  • meta_uebersetzer-3 => uebersetzer-3

  • meta_uebersetzer-4 => uebersetzer-4

  • meta_uebersetzer-5 => uebersetzer-5

  • meta_illustratoren-abs => illustratoren-abs

  • meta_illustrator-1 => illustrator-1

  • meta_illustrator-2 => illustrator-2

  • meta_illustrator-3 => illustrator-3

  • meta_illustrator-4 => illustrator-4

  • meta_illustrator-5 => illustrator-5

  • meta_herausgeber-abs => herausgeber-abs

  • meta_herausgeber-1 => herausgeber-1

  • meta_herausgeber-2 => herausgeber-2

  • meta_herausgeber-3 => herausgeber-3

  • meta_herausgeber-4 => herausgeber-4

  • meta_herausgeber-5 => herausgeber-5

  • meta_autor-1 => autor-1

  • meta_autorvorname-1 => autorvorname-1

  • meta_autornachname-1 => autornachname-1

  • meta_autor-2 => autor-2

  • meta_autorvorname-2 => autorvorname-2

  • meta_autornachname-2 => autornachname-2

  • meta_autor-3 => autor-3

  • meta_autorvorname-3 => autorvorname-3

  • meta_autornachname-3 => autornachname-3

  • meta_autor-4 => autor-4

  • meta_autorvorname-4 => autorvorname-4

  • meta_autornachname-4 => autornachname-4

  • meta_autor-5 => autor-5

  • meta_autorvorname-5 => autorvorname-5

  • meta_autornachname-5 => autornachname-5

  • meta_co-autor-1 => co-autor-1

  • meta_co-autorvorname-1 => co-autorvorname-1

  • meta_co-autornachname-1 => co-autornachname-1

  • meta_co-autor-2 => co-autor-2

  • meta_co-autorvorname-2 => co-autorvorname-2

  • meta_co-autornachname-2 => co-autornachname-2

  • meta_co-autor-3 => co-autor-3

  • meta_co-autorvorname-3 => co-autorvorname-3

  • meta_co-autornachname-3 => co-autornachname-3

  • meta_co-autor-4 => co-autor-4

  • meta_co-autorvorname-4 => co-autorvorname-4

  • meta_co-autornachname-4 => co-autornachname-4

  • meta_co-autor-5 => co-autor-5

  • meta_co-autorvorname-5 => co-autorvorname-5

  • meta_co-autornachname-5 => co-autornachname-5

  • meta_autoren-abs => autoren-abs

  • meta_co-autoren-abs => co-autoren-abs

  • meta_joker-1 => blocktext_def-1

  • meta_joker-2 => blocktext_def-2

  • meta_joker-3 => blocktext_def-3

  • meta_joker-4 => blocktext_def-4

  • meta_joker-5 => blocktext_def-5

  • meta_copyright => copyright

  • meta_bio => bio

  • meta_kurztext => kurztext

  • meta_dl-name => dienstleister-name

  • meta_datum-sperrfrist => datum-sperrfrist-normiert

  • meta_datum-sperrfrist-freitext => datum-sperrfrist

  • meta_datum-erscheinungstermin => datum-erscheinungstermin-normiert

  • meta_datum-erscheinungstermin-freitext => datum-erscheinungstermin

Beispiel 23. Ausgabe des Titels

<div tpl:valueOf="titel"/>

HTML-Ausgabe im EPUB:

<div>Buchtitel</div>

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

<h6>Titel ist: "<span tpl:valueOf="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 @tpl:valueOf-Attribut enthält, entfernt.

Beispiel 25. Leere Ergebnis-Elemente werden gelöscht

<div tpl:valueOf="blocktext_def-5"/>

HTML-Ausgabe im EPUB:

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

Beispiel 26. Leere Ergebnis-Elemente erhalten

<div tpl:valueOf="blocktext_def-5" tpl:preserveEmptyElement="true"/>

HTML-Ausgabe im EPUB:

<div></div>

@class Attribute am abfragenden Element werden übernommen:

Beispiel 27. Attribute werden übernommen

<div tpl:valueOf="untertitel" class="t_untertitel"/>

HTML-Ausgabe im EPUB:

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

[Achtung]Achtung

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

Beispiel 28. Fehlerhafte Abfrage

<div tpl:valueOf="keinElement"/>

HTML-Ausgabe im EPUB:

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

Anzeige im EPUB:


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

WebHelp-Output erzeugt durchXML Editor