Se for deg dette: du bruker måneder på å lage e-boken din. Du kjører det gjennomepubcheck, gullstandarden for EPUB-validering. Det går med null feil. Så sender en leser deg en e-post. Boken er "ødelagt" på enheten deres. Høres det kjent ut?

Dette er ikke et hypotetisk mareritt. Det skjer med selvutgivere regelmessig, spesielt når eldre gjengivelsesmotorer likerAdobe RMSDK(motoren som driver mange Kobo-enheter) tolker gyldige EPUB-filer på uventede måter. Problemet er ikke filen din. Problemet er det fragmenterte økosystemet til e-boklesere, hver med sine egne særheter.

Så hva kan du egentlig gjøre med det? Du går utover en enkelt validator. Her er fem verktøy og tilnærminger som gir deg et mye mer fullstendig bilde av kompatibiliteten til EPUB-en din i den virkelige verden før du trykker på publiser.

Hvorfor én validator aldri er nok

DeW3C-standardereksisterer av en grunn. De gir oss et felles språk for digitale dokumenter. Men overholdelse av standarder og gjengivelse i den virkelige verden er to vidt forskjellige ting.

epubcheckvaliderer filen din mot IDPF-spesifikasjonen. Den sjekker manifestet, metadataene dine, HTML-strukturen og CSS-referansene dine. Det den ikke kan gjøre er å simulere hvordan en bestemt enhet faktisk vil gjengi filen din. Det gapet er der de fleste e-bokkompatibilitetsproblemer lever.

Tenk på det som å validere HTML med W3C-validatoren og deretter bli overrasket over at Internet Explorer 8 gjengir det feil. Validatoren hadde rett. Nettleseren var bare gammel og sta. Den samme logikken gjelder her, spesielt med leseapper bygget på tiår gamle gjengivelsesmotorer.

Løsningen er en lagdelt tilnærming. Du bruker epubcheck som grunnlag, så legger du inn enhetsspesifikke forhåndsvisningsverktøy, CSS linters og ekte maskinvaretesting. Hvert lag fanger opp noe de andre savner. La oss gå gjennom hvordan det ser ut i praksis.

1. epubcheck: Start her, men ikke stopp her

epubcheckvedlikeholdes av W3C og er fortsatt det første trinnet som ikke kan forhandles. Hvis filen mislykkes her, betyr ingenting annet ennå. Fiks dette først.

Kjør den fra kommandolinjen for mest mulig detalj. GUI-innpakningen er praktisk, men CLI-utgangen gir deg linjenumre og feilkoder du faktisk kan handle på.

java -jar epubcheck.jar din-bok.epub

Vær oppmerksom på advarsler, ikke bare feil. Mange utgivere avviser advarsler fordi filen teknisk sett passerer fortsatt. Men noen av disse advarslene flagger CSS-egenskaper eller HTML-attributter som eldre gjengivelsesmotorer kveles fullstendig av. En advarsel om en utdatert egenskap i EPUB3 kan være nøyaktig det som forårsaker en stille feil i Adobe Digital Editions.

Ett praktisk tips: kjør epubcheck mot både EPUB2- og EPUB3-versjoner av filen din hvis du planlegger å distribuere begge. Valideringsreglene varierer mellom versjoner, og en fil som består EPUB3-validering kan ha strukturelle problemer som bare dukker opp under EPUB2-regler.

2. Pagina EPUB Checker: A Friendlier Second Opinion

DeSide EPUB Checkerer et stasjonært GUI-verktøy som omslutter epubcheck i et mer lesbart grensesnitt. Det er virkelig nyttig for ikke-tekniske forfattere som synes den rå CLI-utgangen er overveldende.

Det som gjør det verdt å installere sammen med kommandolinje epubcheck er batchbehandlingen. Hvis du distribuerer flere formater (standard, stor skrift, tilgjengelig), kan du validere alle i ett pass. Å fange en metadata-inkonsekvens på tvers av hele katalogen samtidig er en sanntidsbesparelse.

Viktige EPUB-valideringsverktøy

✓

epubcheck
Grunnlag for validering av EPUB-filer.

✓

Enhetsspesifikke forhåndsvisningsverktøy
Simuler gjengivelse på bestemte enheter.

✓

CSS Linters
Sjekk CSS-kompatibilitet på tvers av plattformer.

✓

Ekte maskinvaretesting
Test på faktiske enheter for nøyaktighet.

Ikke hopp over dette trinnet hvis du publiserer forstore detaljhandelsplattformersom har sine egne inntaksvalidatorer. Validatorer på plattformnivå flagger noen ganger problemer som epubcheck ikke gjør, spesielt rundt omslagsbildedimensjoner og erklæringer om innbygging av fonter.

3. Adobe Digital Editions: Den ubehagelige, men nødvendige testen

Ingen likerAdobe Digital Editions. Det er tregt, grensesnittet føles sittende fast i 2011, og feilmeldingene er kjent som lite nyttige. Men hvis du publiserer for Kobo, må du teste i ADE. Full stopp.

Self-publisher testing an EPUB file across multiple validation tools on a laptop

Kobo-enheter bruker Adobes RMSDK-gjengivelsesmotor, som er den samme kjernemotoren som driver ADE. Hvis filen din lastes rent i ADE, vil den nesten helt sikkert lastes inn på Kobo-maskinvaren. Hvis ADE viser en hvit skjerm eller i det stille nekter å åpne filen, har du funnet problemet før leserne dine gjør det.

Feilsøkingsprosessen her er metodisk. Strip din EPUB ned til dens bare bein. Fjern stilarket helt og test. Hvis den laster, inneholder CSS-en din noe RMSDK ikke kan håndtere. Vanlige skyldige inkluderer:

Egendefinerte CSS-egenskaper (variabler) som eldre RMSDK-versjoner ikke støtter
CSS Grid eller Flexbox layout erklæringer
@font-face rules with unusual font format declarations
Mediespørringer som refererer til visningsportenheter somvwellervh
Dypt nestede velgere som overskrider gjengivelsesmotorgrensene

Når du har isolert problemet, legg til CSS-en din tilbake i små biter. Binær søk ditt eget stilark. Det høres kjedelig ut, men det tar vanligvis mindre enn en time når du vet hva du leter etter.

4. Calibres EPUB Editor: Fix Problemer inline

Kaliberer den sveitsiske hærkniven for e-bokadministrasjon, og de fleste selvutgivere har den allerede installert. Det færre bruker er den innebygde EPUB-editoren.

Redigeringsprogrammet lar deg åpne og endre råinnholdet i EPUB-en din direkte, inkludert HTML-filer, CSS, metadata og manifestet. Dette er uvurderlig når du trenger å gjøre kirurgiske rettelser uten å gjenoppbygge hele kildedokumentet. Du kan redigere dincontent.opfmanifestere, fikse ødelagtryggradbestilling, eller fjern problematiske CSS-regler uten å berøre de originale kildefilene.

Caliber inkluderer også sin egen EPUB-sjekkfunksjon separat fra epubcheck. Den fanger opp noen forskjellige problemer, spesielt rundt innholdsfortegnelsesstrukturen og NCX-navigasjonsdokumenter. Å kjøre begge validatorene er ikke overflødig. De fanger forskjellige ting.

En underbrukt funksjon: Calibres "Check Book"-verktøy fremhever ubrukte CSS-regler og manglende manifestelementer. Ubrukt CSS er ufarlig i en nettleser, men kan forvirre enkelte e-bokgjengivelser. Å trimme stilarket til bare det du faktisk bruker er god hygiene for kompatibilitet på tvers av enheter.

En rask Caliber arbeidsflyt for feilsøking

Åpne din EPUB i Calibres editor
Kjør "Sjekkbok" og fiks eventuelle flaggede problemer
Åpne CSS-filen og fjern eventuelle egenskaper som er merket som moderne eller eksperimentelle
Lagre og eksporter en ren EPUB
Kjør epubcheck på nytt på den eksporterte filen
Test resultatet i Adobe Digital Editions

Denne arbeidsflyten fanger opp de fleste RMSDK-kompatibilitetsproblemer før de når leserne.

5. Testing av ekte enheter: trinnet de fleste utgivere hopper over

Her er den ubehagelige sannheten: ingen programvarevalidator erstatter testing på faktisk maskinvare fullt ut. Emulatorer og skrivebordsapper tilnærmer enhetens oppførsel. De gjenskaper det ikke nøyaktig.

Hvis du publiserer regelmessig, er det en verdifull investering å eie ett budsjett Kobo og en Kindle. Test hver ny utgivelse på begge før du sender nedlastingslenker til leserne. Kostnaden for ett returnert salg eller én støtte-e-postkjede overstiger langt kostnadene for en grunnleggende e-leser.

For utgivere som ikke kan forsvare maskinvarekostnadenteknisk fellesskaphar bygget noen løsninger. Kindle Previewer-skrivebordsappen fra Amazon simulerer hvordan filen din vil gjengis på Kindle-maskinvare. Det er gratis og overraskende nøyaktig. For Kobo bruker Kobo-skrivebordsappen på Windows eller macOS den samme gjengivelsesstabelen som nyere Kobo-enheter, men ikke de eldste maskinvaregenerasjonene.

Hold en enkel testsjekkliste for hver utgivelse:

Vises forsidebildet riktig?
Navigerer innholdsfortegnelsen riktig?
Gjenges alle kapitteloverskrifter i riktig størrelse?
Skaleres bildene riktig på mindre skjermer?
Laster skriften, eller faller enheten tilbake til en systemfont?

CSS-problemet ingen snakker om

De fleste EPUB-gjengivelsesfeil kommer ned til CSS. Spesielt kommer de ned til utgivere som skriver CSS for nettlesere og antar at e-boklesere vil håndtere det på samme måte. Det vil de ikke.

RMSDKog lignende eldre motorer har en CSS-støtteprofil nærmere Internet Explorer 9 enn en moderne nettleser. Egenskaper som enhver nettutvikler tar for gitt, somflexbox, rutenett, calc(), og egendefinerte CSS-egenskaper, er enten ikke støttet eller delvis støttet på måter som kan forårsake stille feil.

EPUB-gjengivelsesutfordringer

epubcheck Begrensninger 40 %

Enhetsspesifikke problemer 30 %

CSS-kompatibilitetsproblemer 20 %

Ekte maskinvaretestinghull 10 %

Det sikreste EPUB-stilarket er et konservativt. Hold deg til egenskaper som har vært en del av CSS siden 2010. Brukmargin, polstring, skriftstørrelse, linje-høyde, tekstjustering, og grunnleggende velgere. Brukemenheter i stedet forpxeller viewport-enheter. Test hver dekorative CSS-egenskap du legger til, fordi dekorasjon er akkurat der gjengivelsesmotorer har en tendens til å svikte.

/* Safe EPUB base stilark */
body {
  font-familie: serif;
  skriftstørrelse: 1em;
  linjehøyde: 1,5;
  margin: 0;
  polstring: 0;
}

h1, h2, h3 {
  font-familie: sans-serif;
  font-weight: fet;
  marg-topp: 1,5em;
  marg-bunn: 0,5em;
}

p {
  margin: 0 0 1em 0;
  tekstinnrykk: 0;
}

img {
  maks-bredde: 100 %;
  høyde: auto;
  display: blokk;
}

Dette er ikke spennende CSS. Men den vil gjengis på alle EPUB-kompatible enheter laget i løpet av de siste femten årene. Start her, og legg til kompleksitet først når du har testet at det fungerer.

Beyond Validation: Klargjør e-boken din for distribusjon

Å få EPUB-en til å gjengi riktig er bare en del av publiseringsoppgaven. Når filen din er ren og testet, har du andre avgjørelser å ta.

CSS code being debugged inside a stylesheet for EPUB compatibility

Hvis du planlegger å tilby tilgjengelige formater, bør du vurdere å kjøre manuskriptet ditt gjennom enAI lydbok generatorå lage en fortalt versjon for lesere som foretrekker lyd. Mange selvutgivere overser dette publikummet fullstendig, og det representerer en meningsfull utvidelse av rekkevidden din uten å gjenoppbygge innholdet ditt fra bunnen av.

Før du fullfører en versjon for distribusjon, kjør manuskriptet ditt gjennom enBookProofer manuskriptsjekk. Den fanger opp problemer som tekniske validatorer går glipp av, som varemerkekonflikter, villedende påstander i beskrivelsen din eller eksisterende bøker med identiske titler. Dette er den typen problemer som skaper hodepine etter lansering, ikke før.

Think about your book's discoverability too. En ren EPUB er bare nyttig hvis leserne kan finne den. If you are promoting your release, agratis revisjonsverktøy for sosiale medierkan hjelpe deg med å identifisere hvilke plattformer som faktisk fører trafikk til arbeidet ditt, og hvilke som kaster bort tiden din.

For forfattere som designer sine egne bokomslag eller interiøroppsett, er det viktig å holde merkefargene konsistente. ENhex fargesøkerverktøygjør det enkelt å hente eksakte fargeverdier fra referansebilder og bruke dem konsekvent på omslaget ditt, nettstedet ditt og reklamegrafikken din.

Hva selvutgivere kan lære av nettutviklere

Webutviklere håndterer nettleserkompatibilitet hele tiden. De har bygget hele verktøykjeder rundt problemet:progressive JavaScript-mønstre, CSS-tilbakestilling, funksjonsdeteksjon og fallback-strategier. E-bokforlag vil ha nytte av å låne denne tankegangen.

Kjerneprinsippet er det samme. Skriv for det minst kapable miljøet først, og forbedre deretter for mer kapable. I webutvikling kalles dette progressiv forbedring. I e-bokpublisering betyr det bare å skrive konservativ CSS og teste på gammel maskinvare før du tester på ny maskinvare.

API-dokumentasjonsverktøy somSwaggereksisterer fordi utviklere har lært at en enkelt kilde til sannhet for spesifikasjoner forhindrer kompatibilitetsfeil nedstrøms. EPUB-spesifikasjonen eksisterer av samme grunn. Problemet er at ikke alle leser det, og ikke alle enheter implementerer det fullt ut.

Hvis du ønsker å gå dypere inn på EPUB-innbygget, kan duW3C-standarddokumentasjondekker hele EPUB3-spesifikasjonen. Det er tett lesing, men å forstå hva spesifikasjonen faktisk krever kontra hvilke gjengivelsesmotorer som faktisk støtter, er genuint nyttig kunnskap for enhver seriøs e-bokutgiver.

For forfattere som lager videoinnhold for å markedsføre bøkene sine, agratis video til MP3-konverteringkan hjelpe deg å trekke ut lyd fra innspilte opplesninger eller intervjuer for bruk i podcast-episoder eller reklameklipp. Creation av innhold på tvers av formater er i økende grad hvordan uavhengige forfattere bygger publikum.

Takeawayen

En bestått epubcheck-poengsum er nødvendig. Det er ikke tilstrekkelig. Gapet mellom "spesifikasjonskompatibel" og "fungerer overalt" er reell, og det er stort sett et CSS-problem drevet av gamle gjengivelsesmotorer som ingen har oppdatert på flere år.

Valideringsarbeidsflyten din bør inneholde minst tre lag: epubcheck for spesifikasjonsoverholdelse, Adobe Digital Editions for RMSDK-kompatibilitet og ekte enhetstesting for alt du ikke kan fange i programvare. Legg til Calibres editor for raske kirurgiske rettelser og Pagina for batchbehandling hvis du vedlikeholder en katalog.

Skriv konservativ CSS. Test tidlig. Test på gammel maskinvare. Og når en leser forteller deg at boken deres er ødelagt, motstå trangen til å anta at de tar feil. Noen ganger sier spesifikasjonen at du har det bra. Enheten er uenig. Leseren vil bare lese boken din.

Klar til å stramme opp publiseringsarbeidsflyten din? Start med aBookProofer manuskriptsjekkpå din neste utgivelse og se hva dukker opp før leserne dine gjør det.