Feilsøke formateringsfeil i EPUB

Symptomer: Du har levert din EPUB-fil via FTP, vår Publisher Portal eller via API, men boken kan ikke behandles og publiseres. Vårt supportteam kan ha henvist deg til denne artikkelen for å løse et problem med en "eksplisitt katalog" (explicit directory) eller "META-INF".

Hvorfor skjer dette?

Problemet skyldes hvordan EPUB-filen din ble pakket. En EPUB er i utgangspunktet et standard ZIP-arkiv hvor filtypen er endret til .epub.

Profesjonelle verktøy for å lage EPUB-filer pakker disse filene i henhold til strenge bransjestandarder. Men hvis en EPUB pakkes manuelt (for eksempel ved å merke filer på datamaskinen, høyreklikke og velge "Komprimer til ZIP"), oppretter operativsystemet det som kalles "eksplisitte katalogoppføringer" (explicit directory entries). Dette betyr at det oppretter tomme, frittstående mappenoder inne i arkivet for kataloger som META-INF og OEBPS. Vårt innlesningssystem krever streng, standardisert EPUB-formatering og kan ikke behandle filer som inneholder disse manuelt opprettede, tomme mappenodene.

Slik sjekker du om EPUB-filen din har dette problemet

Du kan sjekke om EPUB-filen din er feilpakket uten å måtte pakke den ut.

For Windows-brukere:

1. Åpne Kommandoprompt (trykk Windows-tasten, skriv cmd og trykk Enter).

2. Skriv tar -tvf (pass på å inkludere mellomrommet på slutten).

3. Dra og slipp EPUB-filen din direkte inn i Kommandoprompt-vinduet for å fylle inn filbanen automatisk, og trykk Enter.

Hva du skal se etter: Se på utdata-listen. Hvis du ser frittstående oppføringer for META-INF/ eller OEBPS/ med filstørrelse 0, har filen din eksplisitte kataloger og vil feile.   

For Mac-/Linux-brukere:

1. Åpne Terminalen.

2. Skriv unzip -l (inkluder mellomrom på slutten).

3. Dra og slipp EPUB-filen din i Terminal-vinduet og trykk Enter.

Hva du skal se etter: Se på kolonnene "Length" (Lengde) og "Name" (Navn). Hvis du ser en META-INF/-mappe med lengde 0, vil filen din feile under behandling.

Slik fikser du EPUB-filen din

Du trenger ikke å være utvikler for å fikse dette! Du trenger bare å kjøre boken din gjennom en bransjestandard EPUB-redigerer for å bygge opp filstrukturen riktig.

Generelle steg-for-steg-instruksjoner:

1. Åpne EPUB-filen: Importer eller åpne den feilaktige EPUB-filen i en dedikert EPUB-redigeringsprogramvare.

2. Tving en ombygging: For å tvinge programvaren til å pakke boken på nytt, gjør en veldig liten, usynlig endring. Åpne en hvilken som helst tekst- eller HTML-fil i redigereren, fjern en enkelt bokstav eller et mellomrom og skriv det inn igjen nøyaktig som det var.

3. Lagre og eksporter: Lagre prosjektet ditt og eksporter det som en ny EPUB-fil. Denne handlingen bygger vanligvis opp EPUB-filen på nytt i henhold til strenge bransjestandarder og fjerner automatisk de skjulte, problematiske mappene.