Spis treści nie działa w ebooku – jak to poprawić?

Gdy czytnik nie pokazuje spisu treści albo linki przenoszą w złe miejsca, przyczyna jest prawie zawsze jedna z pięciu – i wszystkie są naprawialne bez składania książki od nowa. Żeby jednak zrozumieć naprawę, trzeba wiedzieć jedną rzecz: w porządnym EPUB-ie spis treści istnieje w kilku miejscach naraz, i każde odpowiada za co innego.

Jak naprawdę działa nawigacja w EPUB

W dobrze zrobionym ebooku funkcjonują równolegle:

1. Dokument nawigacyjny (toc.xhtml z epub:type="toc") – spis, który czytnik pokazuje w swoim menu („Idź do", panel nawigacji). To wymóg EPUB 3. Oprócz spisu zawiera punkty orientacyjne (landmarks): okładkę, początek treści, spis w treści.
2. Plik NCX – starszy odpowiednik dla kompatybilności z wiekowymi czytnikami; generowany obok, nie zamiast.
3. Spis treści w treści książki (osobny plik HTML) – klikalne strony spisu, które czytelnik przewraca jak w papierze; umieszczany tam, gdzie w wydaniu papierowym (po stronie tytułowej/redakcyjnej), podczas gdy sam dokument nawigacyjny zwyczajowo ląduje na końcu pliku, poza tokiem lektury.

Większość problemów bierze się stąd, że narzędzia eksportujące robią dobrze tylko część z tego – albo ktoś poprawiał książkę, nie wiedząc, że spisy są trzy.

Problem 1: „Czytnik w ogóle nie pokazuje spisu treści"

Przyczyna: brak dokumentu nawigacyjnego, brak epub:type="toc", albo plik nav nie jest zadeklarowany w manifeście z właściwością nav.

Naprawa: utworzenie/naprawienie toc.xhtml z poprawną strukturą (<nav epub:type="toc"> + zagnieżdżone listy <ol>) i deklaracją w OPF. W edytorach EPUB są do tego narzędzia generujące nav i NCX z nagłówków – pod warunkiem, że nagłówki w książce są prawdziwymi <h1>–<h6>, a nie stylowanym tekstem. Jeśli nie są, naprawa spisu zaczyna się od naprawy struktury.

Problem 2: „Linki prowadzą w złe miejsca"

Przyczyna: rozjazd między spisem a treścią – po usuwaniu/scalaniu rozdziałów, zmianie nazw plików albo podziale dużego pliku XHTML na mniejsze linki wskazują stare pliki lub nieistniejące kotwice (#rozdzial-3 którego już nie ma).

Naprawa: przejście wszystkich pozycji spisu i aktualizacja celów. Przy okazji walidacja EPUBCheck wskaże martwe odwołania (RSC-007). Uwaga: poprawić trzeba wszystkie spisy – nav, NCX i spis w treści; naprawienie jednego z trzech to najczęstszy powód „naprawialiśmy, ale dalej nie działa".

Problem 3: „Spis jest płaski – bez części i podrozdziałów"

Przyczyna: eksport wygenerował spis z jednego poziomu nagłówków, albo hierarchia nagłówków w książce jest zepsuta (wszystko jest <h1>).

Naprawa: najpierw poprawna hierarchia nagłówków w treści, potem regeneracja spisu jako zagnieżdżonych list – czytnik pokaże wtedy strukturę część → rozdział → podrozdział. To nie kosmetyka: nawigacja hierarchiczna to element wymogów dostępności, a dla czytelnika z czytnikiem ekranu – podstawowy sposób poruszania się po książce.

Problem 4: „Na Kindle spis działa, w Apple Books nie" (albo odwrotnie)

Przyczyna: platformy czytają różne warstwy nawigacji – nowoczesne aplikacje dokument nav, starsze urządzenia NCX. Jeśli jedna warstwa jest dobra, a druga zepsuta, problem widać tylko na części urządzeń.

Naprawa: spójność wszystkich warstw – nav i NCX generowane z tego samego źródła, testy na kilku platformach. Podobne rozjazdy między czytnikami omawiamy w artykule dlaczego ebook źle wyświetla się na czytniku.

Problem 5: „Spis prowadzi do początku rozdziału, ale ucina tytuł" / „przeskakuje o stronę"

Przyczyna: kotwice wstawione za nagłówkiem zamiast przed nim, albo łamanie plików w złych miejscach (rozdziały nie zaczynają się od nowego pliku XHTML).

Naprawa: podział treści na pliki per rozdział (co przy okazji leczy powolne otwieranie – bardzo duże pojedyncze pliki XHTML warto dzielić także z powodów wydajnościowych) i kotwice na elemencie nagłówka.

Checklist zdrowej nawigacji

• dokument nav (epub:type="toc") – kompletny, hierarchiczny, zadeklarowany w OPF
• NCX zgodny z nav (dla starszych czytników)
• spis treści w treści książki – klikalny, umieszczony jak w wydaniu papierowym
• punkty orientacyjne (landmarks): okładka, spis, początek treści
• wszystkie linki spisów przetestowane, zero martwych celów
• hierarchia = prawdziwa struktura książki
• walidacja EPUBCheck bez błędów + test na 2–3 czytnikach

FAQ

Czy mogę naprawić spis treści w Calibre? Do prostych przypadków – tak. Ale Calibre przy edycji potrafi przepisać strukturę pliku po swojemu; przy książce do sprzedaży bezpieczniejszy jest edytor EPUB (np. Sigil) i świadoma naprawa wszystkich warstw nawigacji.

Wydawca przysłał mi plik „z poprawionym spisem", a problem wrócił po konwersji do MOBI. Czemu? Konwersja formatów generuje nawigację na nowo – jeśli źródłowy EPUB ma zepsutą jedną z warstw, pochodne formaty dziedziczą problem. Naprawia się źródło, nie pochodne. (EPUB vs MOBI vs KPF →)

Ile kosztuje naprawa nawigacji? Jeśli struktura książki jest zdrowa – to szybka praca. Jeśli spis nie działa, bo książka nie ma prawdziwych nagłówków – naprawiamy przyczynę, nie objaw. Wycena w 24 h po obejrzeniu pliku.

---

Spis treści to pierwsza rzecz, którą czytelnik klika – i pierwsza, po której ocenia plik. Naprawiamy istniejące ebooki szybko i z pełną walidacją. Prześlij plik do wyceny → Chcesz najpierw zobaczyć spis treści i strukturę pliku na własne oczy? Otwórz go w darmowym checkerze.