Blog

Studio Składam - profesjonalny skład i redakcja książki
Baza wiedzy

Czym jest walidator EpubCheck i dlaczego jest potrzebny?

4 czerwca, 2026

Okładka wpisu: Czym jest walidator EpubCheck i dlaczego jest potrzebny?

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

  1. 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.
  2. 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.
  3. 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).

Studio Składam - profesjonalny skład i redakcja książki
Kamil Potęga
Studio Składam - profesjonalny skład i redakcja książki

Kamil Potęga – od 2018 roku zajmuję się profesjonalnym składem książek i katalogów oraz projektowaniem okładek. Przygotowuję pliki zgodne ze standardem WCAG i wspieram autorów na każdym etapie publikacji.

Zostaw komentarz

Twój adres email nie zostanie opublikowany. Wymagane pola są oznaczone *

Studio Składam - profesjonalny skład i redakcja książki
O autorze
Studio Składam - profesjonalny skład i redakcja książki

Kamil Potęga – od 2018 roku zajmuję się profesjonalnym składem książek i katalogów oraz projektowaniem okładek. Przygotowuję pliki zgodne ze standardem WCAG i wspieram autorów na każdym etapie publikacji.

Studio Składam - profesjonalny skład i redakcja książki

Darmowy e-book

Studio Składam - profesjonalny skład i redakcja książki

Opinie

Studio Składam - profesjonalny skład i redakcja książki

Dowiedz się, co mówią
zadowoleni klienci

Nie musisz wierzyć mi na słowo – sprawdź, co mówią autorzy, z którymi miałem przyjemność pracować
1/0

Pracowałam z kilkoma innymi składaczami, ale odkąd poznałam p. Kamila, nie wyobrażam sobie pracować z nikim innym. Wirtuoz inDesigna oraz kompozytor symfonii rozpisanej na klawiaturę i myszkę. To NIE jest rzemieślnik jak inni składacze, tylko Artysta. Przez „A”. Dokonuje cudów od ręki i nie każe czekać. Nie szuka problemów, tylko rozwiązań, a przy tym jest bardzo miłym młodym człowiekiem. Jak się da to się da, a jak się nie da to i tak się da.

Jednak dla mnie najważniejsze jest, że potrafi korzystać z tego co ma najlepsze (czyli mózgu) i myśli o tym co robi – jeśli schemat nie pasuje do projektu, to nie patrzy na klienta jak na kretyna (co w branży usługowej niestety się zdarza) i choć skład publikacji do druku to techniczna praca opierająca się w dużej mierze na matematyce – jest bardzo elastyczny i dostosowuje schematy do projektu, a nie odwrotnie. Jestem zachwycona współpracą i mam nadzieję, że jeszcze się spotkamy.

Szczerze polecam. Szczególnie, że również działam na rynku wydawniczym i wiem jak wiele aspektów trzeba pogodzić, żeby książka po wydruku nie wyglądała jakby składał ją ósmoklasista w Paintcie.

Inka W
To moja pierwsza przygoda z wydaniem własnej książki i dzięki pomocy Kamila była ona przyjemna. Kamil przeprowadził mnie przez proces, od składu aż po do druk, dbając o każdy szczegół. Każde moje pytanie czy wątpliwość były szybko wyjaśniane. Dzięki jego wsparciu czułam się pewnie na każdym etapie. Polecam współpracę z Kamilem każdemu, ja na pewno jeszcze do niego wrócę z kolejnym projektem.
Beata Regner-Ewere
Serdecznie polecam Kamila, dzięki któremu moja książka jest niesamowita.
Okładka jest przecudowna pod każdym względem.
Kolory, napisy, grafika wszystko zrobione na 100%.
Praca wykonana rzetelnie, każde kroki po kolei wytłumaczone.
Działanie prosto z ❤️.
Serdecznie polecam!!!
Kamila F.

Polecam tę firmę wydawniczą. Jako osoba spoza branży, byłem pod wrażeniem podejścia do klienta. Kamil poświęcił czas, aby zrozumieć moje indywidualne potrzeby i dostosować projekt do moich preferencji. Doceniam też jasną komunikację – cierpliwie tłumaczenie etapów procesu unikając żargonu branżowego.

Efekt współpracy był bardzo dobry, znacznie przekraczający oczekiwania.

Paweł J.
Pracowałem z Panem Kamilem przy składzie mojej książki oraz przy projekcie okładki. Doskonały fachowiec w obu branżach, a przy tym osoba, z którą współpraca układa się naturalnie i bez żadnych przeszkód. Ponadto, otrzymałem wsparcie w procesie druku, co jest dla mnie ogromnym ułatwieniem i zdjęciem z głowy ogromu problemów.
Radosław Jeż
Współpraca z Panem Kamilem, była bardzo sprawna. Szybko wykonał usługę. Komunikacja również na super poziomie. Jestem mega zadowolona ze składu i konwersji plików na inne formaty 🙂
Katarzyna Sawicka

Choć do Kamila trafiłem z polecenia, to i tak jego poziom profesjonalizmu zaskakiwał mnie na każdym kroku.
Skład książki przebiegł sprawnie i bez najmniejszych problemów, a kontakt był nienaganny. Co więcej, chętnie dzielił się swoim doświadczeniem i pomagał również w innych kwestiach wydawniczych, jak wybór drukarni, czy finalne poprawki i przygotowania okładki.
Nie wyobrażam sobie nie skorzystać z jego usług przy kolejnych przedsięwzięciach wydawniczych.
Szczerze polecam.

Allstar Athletics

Polecam współpracę z panem Kamilem. Profesjonalne podejście do klienta, świetny kontakt i bardzo dobrze wykonana praca. Zleciłam skład książki oraz projekt okładki. Jestem bardzo zadowolona i z pewnością skorzystam z usług pana Kamila w przyszłości.

Rita K

Serdecznie polecam współpracę z Kamilem. Pełen profesjonalizm i zaangażowanie. Kamilu, dziękuję za cierpliwość, pomoc i przepiękny projekt okładki.

Magdalena B

Korzystałam z usług Studia Składam, gdzie zamówiłam skład książki i projekt okładki. Skład został wykonany z należytą starannością, terminowo, dokładnie, elegancko. Projekt okładki został dobrany do treści dobrze i bardzo mi się podobał. Cała współpraca była dobrze zorganizowana, szybka, terminowa, elegancka i uprzejma. Gorąco polecam usługi tego Studia. Będę korzystała w przyszłości. Mimo iż wszystko działo się zdalnie, byliśmy w stanie dogadać wszystkie detale. Nigdy wcześniej nie współpracowałam zdalnie na tak profesjonalnym poziomie. Polecam zainteresowanym. Solidna firma.

Agnieszka G

Projekt ebooka z Kamilem to czysta przyjemność. Niezwykła otwartość na różne rozwiązania. Tempo pracy Kamila jest bardzo dobre. Wywiązuje się z założonych terminów, potrafi być również elastyczny w tym zakresie jeżeli zachodzi potrzeba. Miła i przyjemna współpraca

Iweta K

Choć do Kamila trafiłem z polecenia, to i tak jego poziom profesjonalizmu zaskakiwał mnie na każdym kroku.
Skład książki przebiegł sprawnie i bez najmniejszych problemów, a kontakt był nienaganny. Co więcej, chętnie dzielił się swoim doświadczeniem i pomagał również w innych kwestiach wydawniczych, jak wybór drukarni, czy finalne poprawki i przygotowania okładki.
Nie wyobrażam sobie nie skorzystać z jego usług przy kolejnych przedsięwzięciach wydawniczych.
Szczerze polecam.

Allstar Athletics

Może Cię zainteresuje

Studio Składam - profesjonalny skład i redakcja książki