企业官网建设流程全解析

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/koreader

KOReader 是一款开源电子书阅读器，跑在 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/ 下每个子目录对应一个平台的适配代码，可用来交叉确认。

第二步，把文件放进设备，运行启动脚本。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 里选 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 件事

1. 📥 对照第一节的表，按机型下载匹配的发行包，今晚把 KOReader 跑进电纸书——以"点入口能进文件管理器"为完成标志。
2. 📖 把 hello 模板拷进 plugins/ 目录，删掉禁用开关，做出一个点了弹提示的菜单项，用最短的路径跑通插件全流程。
3. ⚙️ 按名字打开 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