Fehlermeldungen bei der ePub-Validierung

Damit Dein E-Book auf allen Endgeräten angezeigt wird, muss es „valide“ sein (mehr zum Thema „Validität“ im dritten Teil unserer Serie „ePub Erstellung leicht gemacht“). In diesem Artikel sammeln wir die häufigsten Fehlermeldungen, die bei einer ePub-Validierung auftauchen können – und geben die Lösung.

Die Fehlermeldungen werden stetig erweitert und in alphabetischer Reihenfolge sortiert.

Bild ‚OEBPS/Images/xxx.tiff‘ vom Typ ‚image/tiff‘ ist laut OPF-Standard nicht erlaubt

Problem: Das tiff-Format wird nicht akzeptiert.
Lösung: Speichere das Bild als .png oder .jpg und ersetzte das .tiff im epub. Achte auch auf die Verlinkung des Bildes in der Datei, wo es im eBook eingebettet ist.
Beispiel:
<img src=“../Images/xxx.png“ />

 

Das Attribut „XXX“ ist an diesem Element nicht erlaubt.
(attribute ‚XXX‘ is not declared for element ‚YYY‘)

Bei eingebetteten Bildern z.B.:
Das Attribut „border“/“hspace“/“vspace“ ist an diesem Element nicht erlaubt. Erlaubte Attribute sind: „class“, „dir“, „height“, „id“, „ismap“, „longdesc“, „src“, „style“, „title“, „usemap“, „width“ oder „xml:lang“
(attribute ‚border‘ is not declared for element ‚img‘)

Problem: Ein Attribut wurde angegeben, das für eingebettete Bilder nicht erlaubt ist.
Lösung: Die genannten Attribute sind aus dem HTML zu tilgen.
Beispiel:
<p class=“abbildung“><img alt=““ border=“0″ class=“bild_zentriert“ hspace=“11″ id=“Grafik1″ src=“../Images/bildname.jpg“ vspace=“6″ /></p>

Bei weichen Umbrüchen:
Das Attribut „clear“ ist an diesem Element nicht erlaubt. Erlaubte Attribute sind: „id“, „style“ oder „title“
(attribute ‚clear‘ is not declared for element ‚br‘)

Problem: Ein Attribut wurde angegeben, das für einen weichen Umbruch nicht erlaubt ist. Das gilt auch für clear=“right“ oder clear=“all“.
Lösung: Das Attribut ist aus dem HTML zu tilgen.
Beispiel:
<br class=“umbruch1″ clear=“left“ />

Bei Hyperlinks:
attribute ‚target‘ is not declared for element ‚a‘

Problem: Bei Verlinkungen dürfen keine zusätzlichen Attribute wie „target“ definiert werden.
Lösung: Das Attribut ist zu tilgen.
Beispiel:
<a class=“anker“ href=“http://www.xinxii.com“ target=“_blank“>www.xinxii.com</a>

Das Element „blockquote“ ist nicht vollständig.

Problem: Leere Blockelemente werden nicht zugelassen.
Lösung: Leere Blockelemente löschen.
Beispiel:
<blockquote class=“block-4″></blockquote>
<blockquote class=“block-4″></blockquote>

Die verlinkte Datei ‚OEBPS/Text/css/stylesheet.css‘ wurde im EPUB nicht gefunden.

Problem: Der Link zur Datei ist nicht korrekt. In diesem Beispiel liegt die CSS-Datei nicht im Ordner CSS sonder Styles.
Lösung: Korrigiere Links in den Text-Dateien.
Beispiel:
href=“css/stylesheet.css“
href=“../Styles/stylesheet.css“

Kann ‚OEBPS/Text/kapitelname.html: duplicate id‘ nicht parsen id-name_0
(ID value ‚id-name_0‘ is not unique)

Problem: Im HTML taucht die ID id=“id-name_0″ mehr als einmal auf und ist daher nicht eindeutig.
Lösung: Überzählige Vorkommen der ID sind zu tilgen oder ggf. umzubenennen, damit Eindeutigkeit sichergestellt ist.
Beispiel:
<p id=“id-name_0″>Der Titel des Buches</p>
<p id=“id-name_0″>von Maxi Muster</p>

The <item> element’s „media-type“ attribute has value „application/x-font-truetype“, but the file’s media type is „application/x-font-ttf“.

Problem: Es wurden unterschiedliche Dateitypen für die Fonts angegeben
Lösung: Die Font-Dateien müssen mit denen in der opf-Datei übereinstimmen
Beispiel:
media-type=“application/x-font-truetype“ ist zu ersetzen durch
media-type=“application/x-font-ttf“

value of attribute „preserveAspectRatio“ is invalid; must be a string matching the regular expression „\s*(none|xMinYMin|xMidYMin|xMaxYMin|xMinYMid|xMidYMid|xMaxYMid|xMinYMax|xMidYMax|xMaxYMax)\s+(meet|slice)?\s*“

Beispiel:
Der zu bearbeitende Bereich sieht so aus (wir haben die konkrete Problemstelle rot markiert):
<div>
<svg xmlns=“http://www.w3.org/2000/svg“ height=“100%“ preserveAspectRatio=“none“ version=“1.1″ viewBox=“0 0 492 385″ width=“100%“ xmlns:xlink=“http://www.w3.org/1999/xlink“><image height=“385″ width=“492″ xlink:href=“../Images/cover.jpeg“></image></svg>
</div>
Lösung: Hier ist „none“ zu ersetzen durch „xMidYMid meet“

value of attribute „xml:lang“ is invalid; must be an RFC 3066 language identifier

Problem: Angaben wie xml:lang=““ im Header sind nicht erlaubt.
Lösung: Entferne xml:lang=““ oder ersetze es durch xml:lang=“de“
Beispiel:
xml:lang=““ ersetzen mit
xml:lang=“de“

WARNUNG in „xxx.epub/OEBPS/Text/index split 005.html“:
Dieser Dateiname enthält Leerzeichen! Leerzeichen sollten vermieden werden

Problem: Die Dateien des ePubs dürfen keine Leerzeichen oder Sonderzeichen enthalten. Dies gilt für die Text-, Bild- und Fontdateien
Lösung: Entferne Leerzeichen und Sonderzeichen.
Beispiel:
index split 005.html
index_split_005.html

 

Deine Fehlermeldung ist nicht dabei? Poste sie als Kommentar und wir versuchen sie für Dich zu lösen!

Über  ⁄ Patricia Gentner

Patricia ist im Distributions-Team von XinXii und damit zuständig für die Konvertierung, Validierung und Auslieferung von E-Books. Seit dem Studium der Vergleichenden Literaturwissenschaft beschäftigt sie sich intensiv mit E-Books und digitalen Medien.

2 Kommentare

  • Antworten
    Heribert
    14. Dezember 2014

    Habe ein Dokument mit LibreOffice erstellt und mit writer2epub umgewandelt. Eingebettete Bilder werden dabei verschoben, nebeneinander Bilder untereinander angelegt (manchmal auch nicht).
    Umwandlung mit Calibre bringt merkwürdige Einrückungsstrukturen alle mit 1 als Kapitelnummer (bis zu 10 Einrückungen. Bilder hier ebenfalls meist untereinander statt wie im Text nebeneinander.
    Bei Betrachtung mit Calibre ist manchmal der Text teilweise über das Bild (je nach angezeigter Schriftgröße)

    Das wichtigste ist das Fotohandling.
    Gibt es da Anleitungen. Müssen da im Originaltext Markups eingefügt werden?
    Danke im Voraus