Blog

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

Najczęstsze błędy EPUB: odrzucenia W3C i WCAG przy publikacji

13 czerwca, 2026

Okładka wpisu: Najczęstsze błędy W3C i WCAG przy publikacji e-booka
Najczęstsze błędy W3C i WCAG przy publikacji e-booka

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).

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