给扫描版 PDF 补上目录：3 步用上 KOReader 智能目录生成
【免费下载链接】koreaderAn ebook reader application supporting PDF, DjVu, EPUB, FB2 and many more formats, running on Cervantes, Kindle, Kobo, PocketBook and Android devices项目地址: https://gitcode.com/GitHub_Trending/ko/koreader
三百页的扫描版 PDF，想读中间某章只能一页页翻。KOReader 智能目录生成就是为这类问题准备的：它自动分析文档内容、挑出候选章节标题，把原本没有导航结构的文件变成可以点按跳转的目录。
没有目录的 PDF 如何一键生成章节：3 步给文档装上目录
- 打开书：在阅读界面打开一本没有目录的书，扫描版 PDF、老 EPUB 都可以。
- 调出目录：轻触屏幕顶部唤起主菜单，点“目录”，系统随即分析文档并展示结果。
- 微调：在菜单的“设置”里调整每页目录条目数（6–24 条）、条目字号（10–72），以及是否显示“章节长度”“引导点线”。
如果文档自带目录但不理想，同一菜单里还有“替代目录”选项，会改用文档自身的标题层级重新构建。
目录错乱时怎么办：KOReader 目录修复自动检出并修正 🩹
- 修复优先：目录载入后，
validateAndFixToc()会做一次全量体检——按顺序核对条目页码，一旦发现有跳序的（多半是文档内部 ID 重复造成），就近取上一项或下一项的正常条目做锚点拉回。适合场景：老书目录点下去跳错页。 - 多级结构：目录是树不是平铺清单，目录视图里可以逐级展开、折叠，底部进度条还能选择只保留某一层级。适合场景：手册有三四层标题，进度条挤到没法看。
- 自动章节扫描：文档完全没有目录时，它就扫描正文内容挑出候选标题生成一份；“上一章 / 下一章”快捷键、底部“本章还剩几页”都依赖它。适合场景：扫描论文毫无目录，却想按章跳读。
论文、手册、小说：不同文档类型的实用技巧
- 扫描版论文：扫描质量决定扫描版 PDF 识别章节的上限。先用前先确认文字清晰、页面完整；生成的条目若和实际章节起点有出入，靠自动修复配合“上一章/下一章”逐条核对。
- 技术手册：层级往往很深，打开“显示章节长度”核对每节页数；进度条太密时，用“忽略某层级刻度”只留一级章节。
- 小说：章节条目短，把“每页条目数”调高到 24 可以一屏看全；开启引导点线，页码对位更直观。
它是怎么认出章节标题的 🔍
流程可以浓缩成三句话，功能实现在 readertoc.lua：
- 内容扫描：遍历文档，挑出“看起来像标题”的条目，字号、版式、格式都是线索。
- 层级构建：把条目间的从属关系排好，形成多级目录，并顺手算出每章页数。
- 状态维护：哪个节点展开、进度条保留哪几层都记下来，下次打开还是上次的样子。
常见问题
- 问：生成的目录识别错了怎么办？修复是自动的：每次加载都会核对页码顺序，发现异常就用相邻正常条目做锚点修正。仍不满意就配合上一章/下一章边翻边核对，同时调整显示设置。
- 问：扫描质量差、识别不好用？识别效果取决于标题在文档里写得有多清楚，模糊页面和装饰性字体会直接拉低准确率，稳妥做法是生成后把目录过一遍核对。
- 问：生成的目录会保存吗？替代方式构建的目录随文档缓存保存，下次打开直接复用，不用重新生成。
下次打开没有目录的 PDF，先点顶部菜单里的“目录”试试——KOReader 自动生成目录能省下的，是一页页翻找的时间。
【免费下载链接】koreaderAn ebook reader application supporting PDF, DjVu, EPUB, FB2 and many more formats, running on Cervantes, Kindle, Kobo, PocketBook and Android devices项目地址: https://gitcode.com/GitHub_Trending/ko/koreader
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
