EPUBCheck · XHTML innehållsdokument

EPUBCheck HTM-001: XML-version är inte 1.0

Uppdaterad: 4 november 2026

EPUBCheck HTM-001 är ett felmeddelande: "Any publication resource that is an XML-based media type must be a valid XML 1.0 document. XML version found: …." En XML-fil i EPUB deklarerar en XML-version som inte är 1.0. EPUB kräver att varje XML-baserad resurs (XHTML kapitel, paketdokumentet, NCX, SVG-bilder) ska vara ett giltigt XML 1.0 dokument, och EPUBCheck namnger den version den fann.

Det officiella meddelandet

Any publication resource that is an XML-based media type must be a valid XML 1.0 document. XML version found: %1$s.

Standardsvårighetsgrad: Fel. EPUB bryter mot en regel i specifikationen och är ogiltig. Butiker och Skicka till Kindle kan avvisa den, och EPUBCheck avslutas med status 1.
EPUBCheck version: 5.4.0

%1$s, %2$s… fylls med filen, värdet eller elementet EPUBCheck som hittades.

Typiska orsaker

En XML-deklaration som säger version="1.1", skriven av en redigerare eller ett exportverktyg som standardiserar till det.
En mall kopierad från ett annat XML-projekt och återanvänd för varje kapitel.

Hur man åtgärdar det

Öppna filen EPUBCheck-namn (meddelandet ger sökvägen, raden och kolumnen) i en text- eller EPUB-redigerare som Sigil, eller packa upp EPUB och öppna den där.
Ändra den första raden till <?xml version="1.0" encoding="UTF-8"?>, eller ta bort XML-deklarationen: utan en, antas XML 1.0 och UTF-8.
Om verktyget som skapade boken skriver 1.1 i varje fil, åtgärda dess mall så nästa export blir rätt.
Bygg om EPUB och kör EPUBCheck igen för att bekräfta att meddelandet har försvunnit.

När det inte är detta

Om deklarationen säger 1.0 men filen är sparad i UTF-16, så är det HTM_058, inte HTM-001.

Villkor som används här

Vad är XHTML i EPUB?

Andra HTM meddelanden

HTM-003 External entities are not allowed in EPUB v3 documents. External entity declaration found: ….
HTM-004 Irregular DOCTYPE: found "…", expected "…".
HTM-007 Empty or whitespace-only value of attribute ssml:ph.
HTM-009 The DOCTYPE provided is obsolete or irregular and can be removed.
HTM-010 Namespace "…" is unusual for the prefix "epub".
HTM-011 Entity is undeclared.

Källor

EPUB 3.3, §3.9 XML conformance · läs 4 november 2026

Meddelandetext och allvarlighetsgrad från EPUBCheck 5.4.0 (W3C, BSD-3-Clause). Förklaring av EpubCC.

FAQ

Vad betyder EPUBCheck HTM-001?

Är HTM-001 ett fel?

HTM-001 rapporteras som fel som standard. EPUB bryter en regel i specifikationen och är ogiltig. Butiker och Skicka till Kindle kan avvisa det, och EPUBCheck avslutas med status 1.