EPUB 使用指南

EPUB 無法匯入閱讀器，通常是哪裡出了問題？

有些 EPUB 在電腦上看起來可以開啟，卻被電子紙閱讀器或書庫軟體拒絕。問題不一定在書籍內容，很多時候是 EPUB 外層容器沒有按照規則封裝。

EPUB 為什麼會變成資料夾？

EPUB 本質上是一個有特殊規則的 ZIP 容器。副檔名是 .epub，不代表檔案內容一定是合格的 EPUB。有些解壓縮工具會把它展開成資料夾，重新壓縮時也可能多包一層目錄，讓閱讀器找不到真正的 EPUB root。

最常見的三個容器問題

• mimetype 不正確：內容必須精確是 application/epub+zip，不可有 BOM、換行或多餘空格。
• mimetype 不在 ZIP 第一項：相容性較嚴格的閱讀器會要求它是第一個 entry，且使用不壓縮的 Stored 方法。
• 多餘的 macOS 檔案：.DS_Store、__MACOSX 與 ._* 不屬於書籍內容，可能造成匯入器判斷異常。

container.xml 與 content.opf 的角色

合格 EPUB 至少需要 META-INF/container.xml。這個 XML 會指向實際的 Package Document，例如 OEBPS/content.opf。修復工具不應只看到任意一個 .opf 就猜測它是正確檔案，而應該先解析 container.xml，再確認它指向的 OPF 存在且可以讀取。

安全修復 EPUB 的方式

低風險的修復只處理容器層級：重建 mimetype、整理 EPUB root、移除系統垃圾檔，再重新驗證 ZIP、container.xml 與 OPF。書籍文字、圖片、CSS、字型與 metadata 不應被任意改寫。

EPUB Daemon 會在瀏覽器記憶體中處理檔案，不會把書籍上傳到伺服器。瀏覽器版會產生下載檔案；如果需要保留原始路徑並執行交易式原地替換，請使用開源專案提供的 Python 本機版。