KOReader 新手实操指南10 分钟把电子书阅读器装进电纸书把扫描版 PDF 重排成可调大字【免费下载链接】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/koreaderKOReader 是一款开源电子书阅读器跑在 Kindle、Kobo、PocketBook、reMarkable 等电纸书上也支持 Android 和 Linux能打开 EPUB、PDF、DjVu 等十几种格式。它适合想把电纸书折腾出更多玩法的人也适合想把扫描版 PDF 小字救回来的人。全文按 4 个诉求组织每个诉求一节先把第一本书读起来再把小字改可读然后把书源搬上设备最后动手写个小插件。10 分钟把 KOReader 启动器跑进 Kobo 和 Kindle翻开第一本书做完这一节你的设备桌面上会多出一个 KOReader 入口点进去是文件管理器而不是系统菜单。第一步选对与机型匹配的发行包。make/ 下的构建目标文件kindle.mk、kindle-legacy.mk、kobov4.mk、kobov5.mk 等列出了官方为哪些机型做过构建Kindle 分 legacy 与新款两条线Kobo 分 v4 和 v5拿错包是闪退的头号原因。frontend/device/ 下每个子目录对应一个平台的适配代码可用来交叉确认。设备启动入口文件位置Kobov4/v5koreader.sh拷进 Kobo 存储区 /mnt/onboard脚本最后一步是执行根目录的 reader.luaKindlePW、Oasis 等koreader.shplatform/kindle/ 目录附带现成的 Kindlet 扩展PocketBookkoreader.appplatform/pocketbook/ 目录reMarkablekoreader.sh systemd 服务platform/remarkable/ 目录Android直接安装 APKplatform/android/ 目录Linux / 桌面桌面版或模拟器platform/linux/ 目录编译方法见 doc/Building.md第二步把文件放进设备运行启动脚本。Kobo 一侧的启动脚本会顺手接管 CPU 调频、屏幕刷新这些细节Kindle 一侧流程相同。两个脚本都会自动滚动保存 crash.log只留最近 500KB出问题时有据可查。首次启动会弹出一份快速入门指南由 frontend/ui/quickstart.lua 自动生成翻页、回退、弹菜单的手指点位都画在触摸区示意图里。截图也有个隐藏操作——同时点住屏幕两个对角。验证提示成功标志是点入口后进入文件管理器并能打开你拷进设备的任意一本 EPUB。如果一启动就闪退回系统菜单别慌九成卡在这一步发行包和机型不匹配v4 装了 v5 的包、新款 Kindle 拿了 legacy 包。回上面的表核对再翻一下安装目录里的 crash.log。一键把扫描版 PDF 重排成字号可调的流动文本读完这节那本必须怼到脸上才能看清的扫描版 PDF会变成字号、行距、字体都能自己调的流动文本阅读手感不输原生 EPUB。背后是内置的 K2pdfopt 引擎识别页面版式、提取文字再按你选的字号重新排出来。在读者菜单打开重排选项后原本一页只能看几行的扫描件就成了普通书本文本页边距、行距覆盖、连字符断行这些开关就放在旁边重排选项的定义在 frontend/ui/data/koptoptions.lua。字体可以换成你拷进设备的任意字体文件Kobo 一侧去 /mnt/onboard/fonts 找Kindle 一侧去 /mnt/us/fonts 找。阅读器里所有排版项都收在读者排版模块漫画、跨页双栏这类固定版式材料还有专门的阅读方向选项按双页或条漫方式翻就行不用硬拗。验证提示重排后翻两页断行干净、文字不乱序就是成功。如果某页变空白或文字错位多半是那本扫描件的文本层质量差——先关重排回固定版式对比再换一本样张确认功能本身没毛病。打开两个自带插件挂上 WebDAV 云盘、自动下载 RSS 新闻做完这一节不插数据线也能从网盘往设备里加书早上开机时当天的资讯已经躺在电纸书里。KOReader 的扩展都是 plugins/ 目录下的 Lua 插件一个文件夹一个_meta.lua 写名称和描述main.lua 是入口放进目录就会被加载器收编。上手不用写代码——在插件设置菜单里把想用的翻起来即可。插件干什么用目录cloudstorage挂载 Dropbox、WebDAV、FTP 云盘plugins/cloudstorage.koplugin/newsdownloader订阅并下载 RSS 源plugins/newsdownloader.koplugin/calibre无线收书、浏览 Calibre 书库plugins/calibre.koplugin/opds浏览任意 OPDS 在线目录plugins/opds.koplugin/vocabbuilder阅读时自动收集生词plugins/vocabbuilder.koplugin/systemstat查看电池、内存等系统状态plugins/systemstat.koplugin/cloudstorage 里选 webdav 填好地址和账号云盘里的 EPUB 就能直接在电纸书上翻newsdownloader 里加好源资讯更新在设备上直接看。验证提示重启设备后菜单里出现新入口、云盘能列出并打开书就是成功。插件没冒出来的话先看它目录里的 _meta.lua确认文件夹带 .koplugin 后缀、没被标记成禁用。摸熟三层设置文件照抄 hello 模板写一个自己的菜单项出问题时你清楚该打开哪个文件读完这节你能照着官方模板写出点一下菜单就弹提示的插件。设置分三层设备级设置 存字号、语言、翻页方式这类全局项docsettings.lua 记的是这本书的字体、进度和高亮换书自动换回来数据目录定位 决定设备上的数据目录在哪插件数据库、缓存都挂在它下面。改细节时去对应位置找触摸手势看 frontend/device/gesturedetector.lua带键盘的老 Kindle 的按键映射在 frontend/device/kindle/event_map_keyboard.lua首次启动的指南出自 frontend/ui/quickstart.lua。想动手写就照hello 模板插件 抄一份改名。它是官方留的调试插件模板极简_meta.lua 两行main.lua 在 addToMainMenu 里注册菜单项点一下就弹一个 InfoMessage。有个细节别漏仓库里这个 hello 默认被自己禁用了抄完记得把 main.lua 里那段禁用开关删掉不然菜单项不会冒出来。验证提示改动有没有生效打开对应设置文件看键值变了没有。设置文件是活动文件应用运行期间别手工编辑。想弄清某个行为怎么实现的spec/unit/ 里同名的单元测试是最快的参考资料。行动清单马上能做的 3 件事 对照第一节的表按机型下载匹配的发行包今晚把 KOReader 跑进电纸书——以点入口能进文件管理器为完成标志。 把 hello 模板拷进 plugins/ 目录删掉禁用开关做出一个点了弹提示的菜单项用最短的路径跑通插件全流程。⚙️ 按名字打开 luasettings.lua 和 docsettings.lua 各看一遍弄清每类设置落在哪个文件之后出问题就知道翻哪份。【免费下载链接】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），仅供参考