
Niezależni autorzy często popełniają te same, typowe **błędy epub**.
Wgrywasz swój wypieszczony, gotowy plik EPUB na serwer Legimi, Empiku lub Apple Books i czekasz na podsumowanie wgrywania. Zamiast informacji o pozytywnej dystrybucji, otrzymujesz z powrotem wielką czerwoną ścianę pełną logów błędów. Twój plik został zablokowany. To sytuacja, z którą spotyka się zdecydowana większość autorów publikujących e-booki na własną rękę, jeśli bazowali na darmowych kreatorach online.
Księgarnie nie weryfikują Twojego tekstu pod kątem literówek czy walorów artystycznych – interesuje ich wyłącznie zgodność strukturalna ze standardami weryfikowanymi przez EpubCheck. Muszą mieć pewność, że plik nie spowolni ich sklepu i nie zawiesi urządzeń klientów.
1. Uszkodzony manifest: Gdzie są zagubione pliki?
E-book nie jest pojedynczym plikiem – to maleńka witryna internetowa zarchiwizowana w paczkę zip. Sercem tego ekosystemu jest tzw. Manifest (zlokalizowany w pliku centralnym content.opf). Jest to ścisła, matematyczna „lista obecności”. Wyjaśnia ona urządzeniu dokładnie, ile plików ma się spodziewać w e-booku.
<!-- Przykład z pliku content.opf -->
<manifest>
<item id="okladka" href="Images/okladka.jpg" media-type="image/jpeg"/>
<item id="wstep" href="Text/wstep.xhtml" media-type="application/xhtml+xml"/>
<item id="logo" href="Images/mojelogo.png" media-type="image/png"/>
</manifest>
Co robi większość autorów? W programie Sigil usuwają przypadkowo obrazek z treści pliku HTML (bo nie pasował). Jednak zapominają całkowicie wyrzucić go z pliku manifestu (lub odwrotnie – dogrywają zdjęcie bez zgłoszenia tego w manifeście). Oprogramowanie sprawdzające w e-księgarni widzi, że manifest żąda pliku, którego de facto nie ma i odrzuca projekt raportując błędy o zaginionych elementach (item is undeclared lub not found in archive).
Kolejna pułapka (Błędne ścieżki): Amatorskie programy potrafią „zaszyć” w kodzie ścieżki pochodzące z dysku twardego twórcy – wstawiając w kod np. file:///C:/Users/Kamil/Documents/logo.png. Klient po otwarciu takiej książki w Empik Go nie zobaczy logo, lecz tzw. pusty kwadrat błędnego linkowania (Broken Link), ponieważ system szuka na swoim urządzeniu lokalnego dysku „C”.
2. Błędy logicznej nawigacji (Outline Hierarchy)
Z roku na rok automaty weryfikujące są udoskonalane i kładą coraz większy nacisk na zgodność z zasadami dostępności cyfrowej. Jednym z najczęstszych powodów anulowania paczki w sklepach zagranicznych jest złamanie logiki strukturalnej.
Autorzy uwielbiają używać nagłówków nie do logicznego uporządkowania treści, lecz ze względów estetycznych. Jeśli twórca użył znacznika <h1> do tytułu książki, a w następnej linii podtytuł oznaczył od razu tagiem <h4> (aby uzyskać w edytorze mniejszą wizualnie literę), walidator odrzuci to jako błąd hierarchii. Pominęliśmy bowiem po drodze nagłówki poziomu drugiego i trzeciego! Zmian w wielkości należy dokonywać z poziomu kaskadowych arkuszy stylów (CSS) oraz klasy przypisanej do klasycznego tekstu akapitowego <p>, a nagłówki zostawić wyłącznie do definiowania prawdziwych rozdziałów.
Do audytu jakości polecamy z całego serca darmowy skaner ACE by DAISY, który nie omieszka brutalnie wytykać wszystkich niedociągnięć kodu.
Chcesz poznać pełny proces profesjonalnego przygotowania e-booka? Przeczytaj nasz Kompletny przewodnik po konwersji EPUB (Word do EPUB).