EPUB有正文目錄卻不能跳章：區分頁面目錄與導航目錄

開始前先確認

這種現象的核心原因在於：正文中的“頁面目錄”與閱讀器依賴的“系統導航目錄”，是兩個需要分別驗證的用途；EPUB 3 的同一導航 XHTML 也可以加入閱讀順序，兼作可見目錄頁。前者只是讀者在版面上看到的普通 HTML 文本與超鏈接，而後者是由獨立結構化文件驅動的閱讀器系統指令。因此，看到可點擊的目錄頁，仍不足以確認閱讀器能識別導航結構。

核心機制：頁面目錄（Inline TOC）與導航目錄（Nav TOC）

要徹底排查該問題，首先需要理解電子書閱讀器解析目錄的底層邏輯。

+-------------------------------------------------------------+
|                     EPUB 电子书容器                          |
|                                                             |
|  [ 正文页面目录 Inline TOC ]       [ 系统导航目录 Nav TOC ]     |
|  - 表现：排版在正文内的章节列表   - 表现：阅读器侧边栏/系统菜单 |
|  - 载体：普通 XHTML 页面          - 载体：专用导航文档 / NCX    |
|  - 机制：HTML 内部锚点超链接      - 机制：语义化层级数据结构    |
|  - 作用：仅供当前页面翻阅点击     - 作用：全局跨章节快速定位    |
+-------------------------------------------------------------+

1. 頁面目錄（Inline TOC）

頁面目錄是排版人員直接寫在正文內容文檔中的章節清單。它可以是一個 XHTML 文件（例如 toc.xhtml 或正文開篇頁面），使用普通的 HTML 列表標籤（如 <ul>、<li>）配合 <a href="chapter1.xhtml"> 錨點鏈接組成。

• 特點：只有翻頁閱讀到該頁時才能看到；其跳轉行爲與普通網頁超鏈接一致。
• 侷限：主流電子書閱讀軟件不會主動掃描正文內的超鏈接來拼湊系統目錄樹。如果只有頁面目錄，閱讀器的側邊欄目錄面板就無法獲取數據。

2. 系統導航目錄（Nav TOC）

系統導航目錄是專門提供給閱讀軟件解析的全局結構化數據。

• 根據 W3C EPUB 3.3 規範，EPUB 3 要求在導航文檔中包含帶有 epub:type="toc" 屬性的 <nav> 元素，專門用於向閱讀系統聲明書籍的層級結構。這一導航文檔獨立於正文展示邏輯，閱讀器正是通過它在界面側邊欄生成可隨時展開、摺疊並跳章的目錄樹。
• 需要注意的是，不要將 EPUB 3 的規則套用到所有舊格式上。在較早的 EPUB 2 規範中，系統導航依賴的是獨立的 toc.ncx（XML 格式）文件。兩者的語法與聲明方式不同，但目的都是服務於閱讀器的系統級交互。

若製作工具僅生成了正文 HTML 超鏈接，而未生成或未正確註冊規範的導航文檔，就會出現“正文可見目錄，但閱讀器側邊欄空空如也”的現象。

交付前排查排錯的具體步驟

在將 EPUB 文件正式交付給客戶或分發前，建議按照以下步驟進行標準化檢查：

步驟一：雙閱讀器交叉比對合法原文件

不要僅依賴單一閱讀軟件進行驗收。不同閱讀軟件（如 Apple Books、Kobo、微信讀書或各類多平臺桌面閱讀器）對於缺少部分規範標籤的容錯機制各不相同。

• 取未修改的合法原始文件，在至少兩款獨立的標準閱讀軟件中打開測試。
• 分別測試：① 翻至正文目錄頁點擊文字是否跳轉；② 呼出閱讀器頂欄或底欄菜單，查看系統目錄面板是否正常加載章節層級。
• 合規與版權邊界：所有排查工作必須基於擁有合法編輯權限的原稿或無版權保護的文件。對於受數字版權管理（DRM）加密的書籍，禁止嘗試繞過或破壞版權保護機制。

步驟二：檢查文件內是否存在專用導航聲明

使用解壓工具（EPUB 本質上爲 ZIP 壓縮包）或專業電子書編輯軟件解開包體，檢查內部文件結構：

1. 先從 `META-INF/container.xml` 的 `rootfile` 定位包文檔（文件名不一定是 `content.opf`）：查看 <manifest> 節點中是否正確註冊了導航文件。

* EPUB 3 標準：應包含類似 <item id="nav" href="nav.xhtml" media-type="application/xhtml+xml" properties="nav"/> 的聲明。 * EPUB 2 標準：應包含類似 <item id="ncx" href="toc.ncx" media-type="application/x-dtbncx+xml"/>，且 <spine toc="ncx"> 屬性已正確綁定。

1. 覈驗文件內容：打開對應的導航文件，確認內部各章節的引用路徑是否真實存在。

步驟三：驗證目標文件名與錨點路徑大小寫

包內鏈接的路徑和錨點應精確匹配，不能依賴某臺電腦對大小寫的寬容行爲：

• 檢查導航文件中的鏈接目標（如 Chapter01.xhtml#section1）與實際正文文件名、內部 id 屬性是否完全一致。
• 若正文文件名修改爲小寫但導航文件中仍爲大寫，會導致側邊欄點擊後無響應或報錯跳出。

判定對照表與交付檢查清單

目錄機制判定對照表

交付前核驗清單（Checklist）

• [ ] 原稿完整備份：在調整任何配置前，已將初始工程與文件另存備份。
• [ ] 閱讀器雙端驗證：已在兩款不同內核的標準閱讀軟件中測試側邊欄目錄呼出功能。
• [ ] 導航屬性完整：EPUB 3 的導航 XHTML 文件已在 OPF 中添加 properties="nav"，或 EPUB 2 正確綁定了 toc.ncx。
• [ ] 錨點路徑校對：系統導航條目鏈接的目標文檔與錨點 ID 均能精確定位，無大小寫錯位。
• [ ] 範圍邊界清晰：本次檢查僅針對章節導航跳轉，若遇到版面內排版錯落，可參閱關於 EPUB圖片缺失排查 以及 EPUB動態頁碼與翻頁機制 的專門說明。

場景示例：一份交付文件的排查過程（假設案例）

以下爲一個典型的排錯與修復推演，用於說明兩者的邊界關係：

• 背景設定（假設）：排版人員通過寫作軟件將一份《企業操作規程》導出爲 EPUB 交付給測試團隊。
• 發現問題：測試人員在電腦端閱讀軟件打開時，翻到第 2 頁能夠看到完整的目錄文字，點擊“第一章”也能跳轉到正文；但將文件發送到墨水屏閱讀器後，點擊系統底欄的“目錄”圖標，屏幕提示“本書無目錄”。
• 排查定位：

1. 打開導出工程的源文件設置，發現排版人員僅在正文最前方插入了“文檔內目錄（TOC Bookmark）”，該功能僅在 Markdown 導出 HTML 時批量生成了內部錨點鏈接。 2. 檢查生成的 EPUB 包體結構，發現 content.opf 的 manifest 清單中並沒有任何帶有 properties="nav" 屬性的文件，閱讀系統自然無法捕捉到全局導航。

• 解決驗證：排版人員回到製作軟件的導出配置中，使用該工具提供的導航生成或修復功能（菜單名稱隨工具而異），重新構建後，EPUB 包內正確生成了包含 <nav epub:type="toc"> 的導航文檔。再次測試時，側邊欄目錄樹恢復正常層級展示。若原始稿件基於標記語言編排，也可參考 Markdown導出規範 檢查標題層級結構。

常見認知誤區與平臺能力邊界

在日常處理與交付電子書時，需要注意以下常見誤區與工具侷限：

1. 誤區：能點擊正文藍字就等於做好了電子書目錄

普通鏈接清單若未滿足導航語義和包聲明，就不能替代系統目錄；符合要求的 EPUB 3 導航文檔可以同時在正文顯示。交付標準必須以側邊欄能否呼出分級目錄爲準。

1. 誤區：EPUB 3 與 EPUB 2 目錄文件可以任意互換

直接將 EPUB 2 的 toc.ncx 強行塞入未作適配的 EPUB 3 流程，部分嚴格遵循規範的新一代閱讀器會直接忽略，導致導航缺失。必須根據書籍的目標版本選擇對應的標準。

1. 回到製作工具修復：AI Lab 的 EPUB 閱讀功能可用於預覽，不能據此認定它會重建導航。完成修復後還應運行 EPUBCheck，並在目標閱讀器實測。

下一步行動建議

當確認手頭的 EPUB 存在“僅有頁面目錄、缺少導航目錄”的現象時：

1. 先保留原稿：切勿直接在成品文件上強行改動壓縮包內容，避免導致壓縮打包方式錯誤使得 EPUB 無法解包。
2. 追溯源頭工具：返回原排版軟件（如 Sigil、Calibre 轉換器、Indesign 或 Markdown 導出引擎），檢查導出設置中的“生成目錄 / NCX / Navigation”選項是否勾選完整。
3. 完成雙端覈驗：重新導出後，使用兩款不同閱讀器完成“側邊欄跳章”與“正文跳章”的雙重驗證，確認無誤後再進行最終交付。