KOReader智能目录生成实战3步给无章节的长文档补上可点击目录【免费下载链接】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 的智能目录功能就是冲着这个问题来的它会解析文档里的章节标题和层级自动生成一份能点击跳转、能展开折叠的目录让你直接落到想看的章节。功能速览 一句话概括KOReader 把藏在正文里的章节结构变成一份可交互的目录同时联动底部的章节进度条和上下章跳转。你不需要手动标记任何内容打开文档就能用如果原书没有目录它还能从文档自身的标题HTML 的 H1~H6 标签临时构建一份替代目录。整个过程由阅读界面的目录管理模块负责代码在 readertoc.lua后面会简单拆解。打开并使用目录4个步骤打开文档在文件管理器里点开任意一本书进入阅读界面。点顶部菜单区用手指点一下屏幕顶部的菜单区域见下方示意唤出顶部菜单。选择Table of contents中文界面下是目录。进入后点条目左侧的三角图标可展开/折叠子章节点条目本身直接跳到对应页。顺手调一下显示在目录界面打开右下角的Settings可以调每页条目数、字号等下一节细说。它是怎么认出章节的机制速览不用关心全部实现知道下面这几步就够了取数每次打开目录模块先调用fillToc()从文档引擎取目录数据。如果这本书是 EPUB 这类 CRE 文档且你开启了替代目录它会先从 H1~H6 标题重建一份再取数、再校验function ReaderToc:fillToc() if self.toc then return end if self.ui.document:canHaveAlternativeToc() then -- 替代目录启用时先基于文档标题重建 self.ui.document:buildAlternativeToc() end self.toc self.ui.document:getToc() self:validateAndFixToc() end修复validateAndFixToc()会先快速扫一遍检查条目是否有序、页码是否递增。一旦发现有页码跳回前面常见于文档本身有 bug 或 ID 重复它会挑出错误条目用前后正常条目的页码把它拉正然后重算层级深度和序号。补全校验通过后还会补上每个章节的页数供目录里章节长度显示和底部进度条使用。这套先扫、再修、再补的流程就是目录看起来总是虽然歪过但能用的原因。细节与进阶配置项和扩展能力目录界面的显示参数都走全局设置常用项如下每页条目数toc_items_per_page6~24条目多的大书可以调小省翻页。条目字号toc_items_font_size10~72小屏设备可调大方便点选。显示章节长度每个条目右侧标出章节页数默认开。点线引导toc_items_with_dots条目和页码之间的点线样式可开可关。进度条刻度瘦身目录层级复杂时底部进度条会挤成一团可以在Settings → Progress bars里按层级关掉不需要的刻度另有章节导航只绑定刻度章节标题只取刻度两个开关控制底部标题和上下章跳转的粒度。扩展能力方面有两点值得知道替代目录对 EPUB 等 CRE 文档菜单里的Alternative table of contents开关会用 H1~H6 标题重建目录没标题时退化为按 EPUB 内部每个 HTML 文件分段。想换回原目录再选一次同一开关确认即可文档会重载。手工目录readerhandmade.lua 支持你手动增删目录项并改名一旦启用会优先于原书目录和替代目录适合文档目录彻底烂掉时的兜底方案。常见坑与解法目录顺序乱、点了跳到错的页先确认validateAndFixToc()已经跑过正常打开目录都会触发。如果修不好多半是文档本身目录数据损坏直接启用手工地目录手工重建关键章节。替代目录用腻了想退回原目录再次选择Alternative table of contents在确认框里选回原目录文档会重载恢复。底部进度条密密麻麻在Progress bars子菜单里按深度隐藏部分层级刻度只保留你关心的大章节。章节标题显示成空白或乱码模块会对标题做清理cleanUpTocTitle空标题会被替换成短横线如果还有异常字符属于文档编码问题建议换一份转码后的源文件。这个功能适合谁如果你手头经常处理扫描版 PDF、无目录的技术手册或章节结构散乱的 EPUB这套智能目录基本是打开就能用的不用任何预处理识别、修复、补全一次完成配合替代目录和手工地目录两个兜底绝大多数文档都能拿到一份可点击、可跳转、能显示章节进度的导航。把它当成阅读长文档前的第一个操作翻页的次数会少很多。【免费下载链接】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），仅供参考 
长河君 · 2026/10/16 7:14:16 · 阅读 1.2k KOReader智能目录生成实战：3步给无章节的长文档补上可点击目录
KOReader智能目录生成实战3步给无章节的长文档补上可点击目录【免费下载链接】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 的智能目录功能就是冲着这个问题来的它会解析文档里的章节标题和层级自动生成一份能点击跳转、能展开折叠的目录让你直接落到想看的章节。功能速览 一句话概括KOReader 把藏在正文里的章节结构变成一份可交互的目录同时联动底部的章节进度条和上下章跳转。你不需要手动标记任何内容打开文档就能用如果原书没有目录它还能从文档自身的标题HTML 的 H1~H6 标签临时构建一份替代目录。整个过程由阅读界面的目录管理模块负责代码在 readertoc.lua后面会简单拆解。打开并使用目录4个步骤打开文档在文件管理器里点开任意一本书进入阅读界面。点顶部菜单区用手指点一下屏幕顶部的菜单区域见下方示意唤出顶部菜单。选择Table of contents中文界面下是目录。进入后点条目左侧的三角图标可展开/折叠子章节点条目本身直接跳到对应页。顺手调一下显示在目录界面打开右下角的Settings可以调每页条目数、字号等下一节细说。它是怎么认出章节的机制速览不用关心全部实现知道下面这几步就够了取数每次打开目录模块先调用fillToc()从文档引擎取目录数据。如果这本书是 EPUB 这类 CRE 文档且你开启了替代目录它会先从 H1~H6 标题重建一份再取数、再校验function ReaderToc:fillToc() if self.toc then return end if self.ui.document:canHaveAlternativeToc() then -- 替代目录启用时先基于文档标题重建 self.ui.document:buildAlternativeToc() end self.toc self.ui.document:getToc() self:validateAndFixToc() end修复validateAndFixToc()会先快速扫一遍检查条目是否有序、页码是否递增。一旦发现有页码跳回前面常见于文档本身有 bug 或 ID 重复它会挑出错误条目用前后正常条目的页码把它拉正然后重算层级深度和序号。补全校验通过后还会补上每个章节的页数供目录里章节长度显示和底部进度条使用。这套先扫、再修、再补的流程就是目录看起来总是虽然歪过但能用的原因。细节与进阶配置项和扩展能力目录界面的显示参数都走全局设置常用项如下每页条目数toc_items_per_page6~24条目多的大书可以调小省翻页。条目字号toc_items_font_size10~72小屏设备可调大方便点选。显示章节长度每个条目右侧标出章节页数默认开。点线引导toc_items_with_dots条目和页码之间的点线样式可开可关。进度条刻度瘦身目录层级复杂时底部进度条会挤成一团可以在Settings → Progress bars里按层级关掉不需要的刻度另有章节导航只绑定刻度章节标题只取刻度两个开关控制底部标题和上下章跳转的粒度。扩展能力方面有两点值得知道替代目录对 EPUB 等 CRE 文档菜单里的Alternative table of contents开关会用 H1~H6 标题重建目录没标题时退化为按 EPUB 内部每个 HTML 文件分段。想换回原目录再选一次同一开关确认即可文档会重载。手工目录readerhandmade.lua 支持你手动增删目录项并改名一旦启用会优先于原书目录和替代目录适合文档目录彻底烂掉时的兜底方案。常见坑与解法目录顺序乱、点了跳到错的页先确认validateAndFixToc()已经跑过正常打开目录都会触发。如果修不好多半是文档本身目录数据损坏直接启用手工地目录手工重建关键章节。替代目录用腻了想退回原目录再次选择Alternative table of contents在确认框里选回原目录文档会重载恢复。底部进度条密密麻麻在Progress bars子菜单里按深度隐藏部分层级刻度只保留你关心的大章节。章节标题显示成空白或乱码模块会对标题做清理cleanUpTocTitle空标题会被替换成短横线如果还有异常字符属于文档编码问题建议换一份转码后的源文件。这个功能适合谁如果你手头经常处理扫描版 PDF、无目录的技术手册或章节结构散乱的 EPUB这套智能目录基本是打开就能用的不用任何预处理识别、修复、补全一次完成配合替代目录和手工地目录两个兜底绝大多数文档都能拿到一份可点击、可跳转、能显示章节进度的导航。把它当成阅读长文档前的第一个操作翻页的次数会少很多。【免费下载链接】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），仅供参考