5 分钟把 KOReader 装进电纸书从 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/koreader打开扫描版 PDF字小到怼脸也看不清KOReader 能把这类文档重排成字号可调的流动文本还能在 Kindle、Kobo 等电纸书上跑。这篇带你 5 分钟装好它从开机到读第一本书。KOReader 安装前先确认你的设备在不在支持名单动手前先花 30 秒判断我能不能用。打开仓库里的 frontend/device/ 目录每个子目录就是一个受支持的平台设备类型判断依据说明KindlePW、Oasis 等frontend/device/kindle/含按键映射文件旧款物理键盘机型也能用Kobov4 / v5frontend/device/kobo/注意区分 v4 和 v5后面装包要用对PocketBookfrontend/device/pocketbook/直接装 .app 文件reMarkablefrontend/device/remarkable/额外带一个 systemd 服务文件Androidplatform/android/装 APK不涉及刷写Linux / 桌面platform/linux/桌面包也可跑模拟器make/ 目录下还有 kindle.mk、kobov4.mk、pocketbook.mk 这类构建目标文件能帮你确认官方为哪些具体机型做过构建。各平台的启动脚本统一放在 platform/ 下装完就是靠它们把应用拉起来。你的设备型号在上述目录里能找到对应适配代码基本就稳了一个都找不到就别往下走了。KOReader 安装步骤从拿到包到第一次开机成功走完下面 4 步你的屏幕上应该出现 KOReader 的界面而不是回到系统菜单。拿到对应平台的发行包。想从源码构建的话执行git clone https://gitcode.com/GitHub_Trending/ko/koreader再按 doc/Building.md 搭本机模拟器。把平台启动文件拷进设备Kobo 一般放 /mnt/usKindle 放设备根目录以你下载包里的说明为准。通过设备入口运行 koreader.sh。Kobo 装完后系统桌面会多出一个 KOReader 启动项直接点PocketBook 装 .app 文件后自动出现在书架。Android 直接装 APKLinux 解压桌面包运行。成功信号屏幕停在 KOReader 的欢迎/快速入门画面不再弹回系统菜单。最容易卡住的一步是第 2 步拿错包Kobo 分 v4 和 v5 两代Kindle 分老款legacy和新款固件年代不同走的构建目标不一样。拿错的症状很典型——一启动就闪退回系统菜单。九成是包拿错了回上面那张表按 platform/kindle/、platform/kobo/ 的目录名核对一遍。KOReader 安装后的第一次使用先认清触摸分区装完第一件事是搞懂手指点哪、屏幕发生什么这样不翻菜单也能翻完第一本书。KOReader 首次启动会生成一份内置快速入门指南由 frontend/ui/quickstart.lua 自动生成里面就是下面的分区图加快捷键说明照着点就行默认逻辑点屏幕中央翻下一页点最左一条回上一页点最上边弹顶部菜单最下边是状态栏和底部菜单四个角是独立的角落点按区。带键盘的设备另有按键映射比如 Kindle 旧款的默认行为写在 frontend/device/kindle/event_map_keyboard.lua 里翻页、跳目录都可以按自己习惯改。KOReader PDF 重排把扫描版变成大字⬇️ 这是 KOReader 相对内置阅读器最立竿见影的一招前后对比放这里。用之前扫描版 PDF 是整页图片字小得看不清。你能做的只有放大、拖动一页挤不下十行字设备得怼在脸上。怎么操作打开这本书后从顶部菜单进重排re-typeset。背后是内置的 K2pdfopt 引擎入口代码在 frontend/document/koptinterface.lua识别文档版式 → 提取文字 → 按你选的字号重新排成流动文本。字号、行距、页边距、字体全部在 frontend/apps/reader/modules/readertypography.lua 对应的排版菜单里调字体文件拷进设备即可用加载逻辑在 frontend/ui/font.lua。用之后同一页从只能看几行的图片变成字号可调、行距可调、还能加连字符断行的普通书本文本阅读体验接近原生 EPUB。漫画、双栏这类固定版式不用硬掰阅读方向选项里有双页和条漫翻页模式直接选对应的方向即可。KOReader 插件怎么选高频插件对照表想让设备从阅读器变成随身工具箱看这张表就够了。所有扩展都是 Lua 写的插件统一放在 plugins/ 目录每个插件一个文件夹_meta.lua声明名称和描述main.lua是入口放进去就会被自动加载加载器逻辑在 frontend/pluginloader.lua。插件干什么用位置cloudstorage挂载 Dropbox、WebDAV、FTP 云盘plugins/cloudstorage.koplugin/newsdownloader订阅并下载 RSS 资讯源plugins/newsdownloader.koplugin/calibre无线收书、OPDS 浏览 Calibre 书库plugins/calibre.koplugin/opds浏览任意 OPDS 在线目录plugins/opds.koplugin/vocabbuilder阅读时自动收集生词plugins/vocabbuilder.koplugin/systemstat查看电池、内存等系统状态plugins/systemstat.koplugin/想自己写一个拿 plugins/hello.koplugin/ 当模板最省事总共几十行建一个带_meta.lua和main.lua的文件夹在addToMainMenu里注册一个菜单项点击后弹个 InfoMessage整个流程就通了。KOReader 报错怎么查三个位置和三层设置文件出问题先按这张图找八成能自己定位。症状去哪查一启动就闪退回系统菜单九成是平台包拿错v4/v5、老款/新款对照 make/ 目录的构建目标核包改的设置没生效 / 被重置看下面三层设置文件确认你改的是哪一层手势、按键行为不符合预期手势在 frontend/device/gesturedetector.lua按键映射在各设备目录的 event_map 文件里设置分三层各管各的设备级frontend/luasettings.lua 管全局字号、语言、翻页方式都在这层文档级frontend/docsettings.lua 记住这本书的字体、进度、高亮换本书自动切回来路径层datastorage.lua 定位设备上的数据目录插件数据库、缓存都挂在它下面。想查某个行为到底怎么实现的spec/unit/ 里对应的*_spec.lua单元测试是最好的活文档测试名基本就是功能名。装好之后三件事把收益拿到手最后留三个动作每件都花不了十分钟。拿一本字最小的扫描版 PDF 开重排对比开前开后的阅读体验——这是 KOReader 最直接的收益。从上面表里装 cloudstorage 和 newsdownloader把书源和资讯流都搬进电纸书。翻一遍 doc/Development_guide.md再对着 spec/unit/ 跑一遍你关心的模块测试之后想改源码、提补丁就有路了。【免费下载链接】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），仅供参考