Kiedy wysyłasz książkę do dystrybucji, skanuje ją surowy **walidator epubcheck**. ![Czym jest walidator EpubCheck
Wysyłając swój e-book do czołowych e-księgarń takich jak Legimi, Apple Books, Google Play Books czy Amazon KDP, musisz liczyć się z automatyczną weryfikacją pliku. Bramki dystrybutorów nie bazują na estetyce – interesuje ich wyłącznie kod. Większość światowych platform używa do tego celu oficjalnego oprogramowania – walidatora EpubCheck opracowanego przez konsorcjum W3C.
Dlaczego to narzędzie jest tak ważne dla wydawców, a jednocześnie spędza sen z powiek początkującym twórcom?
Strażnik jakości: Dlaczego pliki są weryfikowane?
Platformy sprzedażowe nie mogą ryzykować wpuszczenia do swojego zamkniętego ekosystemu uszkodzonych plików. E-book to w rzeczywistości mała „strona internetowa” (HTML + CSS) spakowana w archiwum ZIP. Źle zakodowana publikacja z pętlami w nawigacji lub przeładowanymi skryptami mogłaby zawiesić urządzenie czytelnika, spowolnić działanie aplikacji sklepowej, a w skrajnych przypadkach doprowadzić do luki bezpieczeństwa.
EpubCheck skanuje e-book pod kątem 100% zgodności ze standardami języka XML i HTML5. Narzędzie jest bezwzględne: jeśli brakuje choćby jednego technicznego znacznika zamykającego akapit, książka zostaje w całości odrzucona ze statusem „Fatal Error”.
Zrozumienie błędu z walidatora (Przykład z życia)
Załóżmy, że użyłeś darmowego konwertera online, który źle przerobił Twój spis treści, albo w programie Sigil ręcznie usunąłeś jeden nawias. Walidator wypluje kod błędu, który dla laika wygląda jak „czarna magia”:
FATAL(RSC-016): my_book.epub/OEBPS/chapter1.xhtml(45,12):
Element type "div" must be followed by either attribute specifications, ">" or "/>".
Jak to czytać? Narzędzie daje nam dokładną instrukcję ratunkową:
1. FATAL – Błąd krytyczny uniemożliwiający publikację.
2. my_book.epub/OEBPS/chapter1.xhtml – Skonkretyzowana nazwa pliku wewnątrz naszego archiwum, w którym wystąpił błąd.
3. (45,12) – Precyzyjne koordynaty w kodzie! Problem zaczyna się w linijce 45 na 12 znaku.
4. Treść komunikatu – Informacja o uszkodzonym tagu <div>, który nie został poprawnie zamknięty trójkątnym nawiasem >.
Dwa oblicza walidatora: Command Line vs GUI
EpubCheck w środowisku profesjonalnych programistów i składaczy DTP jest zazwyczaj uruchamiany bezpośrednio z terminala (wiersza poleceń) za pomocą Javy.
Jeśli jednak nie masz doświadczenia w pracy z wierszem poleceń (np. Windows PowerShell), niemieccy programiści stworzyli wspaniałą, w pełni darmową nakładkę graficzną o nazwie Pagina EPUB-Checker. Aplikacja ta posiada przejrzysty interfejs okienkowy (GUI), w którym metodą „przeciągnij i upuść” (Drag & Drop) wrzucasz plik .epub, a system w czytelny sposób wyświetla błędy, oznaczając je odpowiednimi kolorami.
Najczęstsze techniczne powody odrzucenia przez Empik / Legimi
- Niedeklarowane grafiki: Usunięcie pliku obrazka w kodzie tekstowym, bez usunięcia jego wpisu w centralnym rejestrze (pliku
content.opf). System weryfikujący głupieje, szukając obrazka widmo. - Błędne ścieżki odniesień: Konwertery często „na sztywno” wklejają ścieżki z komputera autora, np.
file:///C:/Users/Kamil/Documents/Zdjecie.jpg. Dystrybutor odrzuci plik, ponieważ na urządzeniu klienta nie ma dysku C. - Brak metadanych strukturalnych: Nieprzypisanie głównego języka w kodzie nagłówkowym
<html lang="pl">lub brak zdefiniowanego Tytułu w znaczniku<title>.
Rozwiązaniem 99% tych problemów jest interwencja eksperta w kod źródłowy XHTML. Nigdy nie polegaj w 100% na „magicznych” przyciskach eksportu z popularnych programów.
Chcesz poznać pełny proces profesjonalnego przygotowania e-booka? Przeczytaj nasz Kompletny przewodnik po konwersji EPUB (Word do EPUB).