KOREADER
用户指南
26.11


你当前阅读的是 KOReader 用户指南的英语版本。本指南还有其他语种版本,均由志愿者翻译:


若要查看全部语种的翻译进度并为本指南的翻译做贡献,请访问本项目的 Weblate 页面。

用户指南翻译进度
本用户指南的阅读指南 ☺

本指南主要为彩色屏幕设计。如果你是初次阅读,强烈建议使用电脑、平板或手机浏览,因为本指南会使用不同颜色来高亮 KOReader 软件界面的不同部分,色彩会使各类说明更易理解。当然,你仍可在电子墨水屏上阅读本指南,只是这些未对 e-ink 优化的内容可能体验不佳。

你可以使用浏览器自带的页内搜索功能(快捷键一般是 Ctrl+F)来检索特定话题和关键词。如果你有关于本指南的建议或疑问,请前往本项目的 GitHub 页面提交。


本指南由人工编写
并校对



本指南中不同文字颜色与样式的说明

KOReader 用户界面(灰色底框) 这些条目始终指向 KOReader 的组成部分,可以是屏幕上可点按、选择、设置的项,也可以是软件的某项功能:

状态栏 字重

菜单路径(绿色) 这些是 KOReader 菜单系统中各设置项与菜单项所在的位置:

外部应用与服务(紫色) 这些是可与 KOReader 配合使用的服务或应用程序。之所以用不同颜色标出,是为了强调它们不属于 KOReader 项目,因此不受我们控制:

Calibre、Readwise、KoHighlights 等。

内部链接(青色) 这类链接末尾带有房子图标,可跳转到本指南的其他部分:

手势

外部链接(蓝色) 这些是指向本指南之外的普通链接:

古腾堡计划


本指南还穿插有不同样式的注释栏与标签,用以提供说明或警示信息:

这是一条警告注释栏,用来提醒用户应当额外谨慎操作的事项。
这是一条说明注释栏,用来展示相关背景信息或补充解释。
这是一条提示注释栏,用来展示让 KOReader 更便利的操作小技巧。

我是一个进阶标签。如果它出现在某个标题旁,表示你需要具备一定程度的技术知识,例如操作文件系统、掌握 CSS 知识、安装外部文件等,具体取决于操作步骤。

导航菜单中的这些星标标示出自上次指南更新以来新增的章节。页面角落还有两个带相同星标的按钮,可让你直接在各新增章节之间跳转。请注意,导航菜单中的星标并未覆盖全部新增内容,为避免拥挤,最小的标题不会标出。但通过角落按钮可以查看所有新增内容。


KOReader 由来自全世界的志愿者开发并提供技术支持。你也可以参与到本项目中来:

  • 修正故障及加入新功能
  • 将软件界面译为其它语种,或改善现有的翻译细节
  • 以你的经验帮助论坛上和 GitHub 工单区的其他用户

请查阅联系我们区域寻找对应链接。


近来我们发现网上出现一些「看起来像官方」的 KOReader 页面,它们并不属于本项目。请务必谨慎,仅通过以下官方来源下载 KOReader:
  • koreader.rocks:我们的官方域名,你现在应该能在地址栏中看到它。包括 koreader.com 在内的其他域名都不是我们!
  • KOReader GitHub 页面:可在此下载面向所有操作系统与设备的官方正式版本。
  • F-Droid 版本:由我们提供的 KOReader 安卓版本。KOReader 没有 Play 商店版本!
1 KOReader 能做什么?

尽管界面极简,KOReader 却是一款功能强大且可高度定制的软件。本章节相当于一份以操作为导向的目录,最适合新用户作为上手起点。你可以在这里了解 KOReader 能做什么,并通过链接学习具体操作方法。

KOReader 的名称来自本项目的起点:Kindle/Kobo Open Reader。当然,这款阅读软件经过多年发展已经获得了长足进步,现在更准确的缩写应该类似 KKPRCSALMOReader(Kindle Kobo Pocketbook Remarkable Cervantes Sony Android Linux MacOS Open reader),不过这个读起来不太顺口,所以我们还是决定简单点 :-)
用多种方式导入阅读材料
按照个人偏好调整文本样式
  • 更换字体(包括用户自有的字体)、调整字号、对比度、粗细、字距微调、文字间距、文字扩展、文本对齐方式、行间距、分栏版式及页边距等 格式化电子书
  • 借助 Perception Expander、FastReader (RSVP) 等速读插件加快阅读速度 阅读体验改进
  • 使用功能强大的内置样式微调工具或自行编写样式,可实现对书籍渲染样式的精确控制 样式微调
  • 手动或自动开启夜间模式,翻转屏幕颜色 自动色温与夜间模式
  • 自动调整你的前光色温 自动色温与夜间模式
阅读时做笔记和高亮
随心所欲地导出笔记和高亮
  • 将笔记和高亮标注以纯文本、Markdown、HTML、JSON 或 Kindle 笔记与摘录格式导出 导出高亮
  • 同步至在线服务,例如 Joplin、Readwise、Memos、Flomo 和 XMNote 导出高亮
轻松整理和浏览个人藏书库
  • 强大的文件浏览器,你可在其中复制、移动、重命名、创建、删除文件和文件夹以及执行批量操作 文件浏览器用法
  • 以你喜欢的方式浏览书库,支持多种详情视图与马赛克视图 文件浏览器用法
  • 将书籍添加到收藏以便快速访问,或创建书单对书籍排序和过滤 书单
使用强大的工具快速翻页你的书籍
  • 快速翻页工具可在页面、章节和书签之间快速跳转 快速翻页工具
  • 借助书籍地图功能,可纵览全书鸟瞰图,一览所有笔记与高亮标注 书籍地图
  • 借助页面预览功能,可像翻阅胶片般流畅切换和预览页面 页面预览
  • 书签浏览器可轻松浏览高亮标注及阅读笔记 书签、高亮与笔记
  • 如果不满意书籍自带目录,可自动或手动创建替代性目录进行替代 目录工具
  • 隐藏并排除书籍中的特定部分,例如附录、索引、参考文献等,以获得更准确的页数统计 排除章节:自定义隐藏页
玩转 KOReader
  • 强大的手势系统内置 200 余项操作命令,轻点、滑动即可控制 KOReader 各项功能 手势分类
  • 若配备键盘(内置、有线或蓝牙),你还可为上述操作分配键盘快捷键 快捷键
  • 你可以通过快捷菜单自定义专属菜单,添加常用操作,轻点或滑动即可随时调用 快捷菜单
  • 通过创建配置文件,可全面控制 KOReader 各项功能并实现操作自动化 配置文件
搜索、查阅和翻译工具
  • 通过选中文本或手动输入来检索书籍(支持正则表达式)
  • 在书签、高亮及笔记中检索
  • 长按文本即可在维基百科或已安装词典中查询,并进行翻译
  • 将选中文本或整页内容译为多达 130 种语言
  • 使用在线或本地 AI 模型讨论、翻译或解释文本内容(需先安装相应插件) 插件种类
KOReader 可以控制你的设备
  • KOReader 可自动更新 设备相关技巧
  • 在设定的时间间隔后调暗或关闭屏幕亮度
  • 为不同的阅读场景设置独立的页面刷新频率 调整页面刷新间隔
  • 可用随机图片、书籍封面、阅读进度甚至书中插图的截图等多种选项来设置自己的屏保。
  • 设置电量充电限制提醒,防止深度放电与过度充电 设备相关技巧
  • 设置内存用量提醒或在到达限制时选择性重启 KOReader 程序(这对于内存较小的设备十分有用)设备相关技巧
KOReader 让 PDF 文档在电子墨水屏上阅读体验更佳
面向硬核用户的高阶功能
  • 为书籍添加你自己的 CSS 样式微调 样式微调
  • 用户补丁允许用户改变 KOReader 的系统运行机制 用户补丁
  • 在剪贴板中生成二维码以向其它设备分享文本和链接
  • 查看 EPUB 文档的 HTML 源代码
  • 在阅读设备上创建及编辑文本文件
  • 打开终端模拟器并在阅读设备上执行命令行
  • 查看 CPU、内存和电池的使用数据
2 基本用法
2.1 传输文件

KOReader 支持 PDF/PDB/XPS,EPUB/MOBI/FB2,DJVU,CBR/CBT/CBZ,DOCX/RTF,HTML/HTMLZ,TXT/MD 和 CHM 等格式的文件,还可打开 ZIP 压缩包并显示图片文件。

有许多方法可以将书籍传输到阅读设备。请注意,KOReader 可能需要重启(如果是在 Pocketbook/Android 上则是刷新目录)以完成对新传输文件的索引。

除了以与内置阅读器应用程序相同的方式传输文件外,根据你的设备不同,还有其他选项可供选择:

  1. KOReader 内置的 USB 大容量存储模式:KOBO 及部分 CERVANTES 型号支持该功能。
  2. 云存储(Dropbox/FTP/Webdav):使用该功能前,须通过下方展示的菜单项登录云服务账号。详细操作步骤可在添加账号时点击菜单中的说明按钮查看:
  3. SSH/SFTP 访问:KOReader 可作为 SSH 服务器,以便使用电脑传输文档(该功能支持 Kobo、Kindle、Cervantes 的阅读器)请使用 SFTP 软件(如 Filezilla)或文件浏览器(部分操作系统内置)请查阅维基页了解具体操作流程;另请注意下方的警告注释栏内容。
  4. Calibre 传输:借助 Calibre 插件,可通过 Wi-Fi 直接从 Calibre 书库将书籍发送到 KOReader 中。请查阅维基页了解操作方法。
  5. 新闻下载器:该插件可以 HTML 格式下载 RSS 及 Atom 订阅源提供的文章。请查阅维基页了解操作方法。
  6. OPDS(开放出版发行系统)书目:你可以访问公共书目,或使用自己的服务器访问书库。更多信息见 使用 OPDS 书目
  7. Wallabag:此插件可以从 Wallabag 中拉取文章,这是一款自托管的类 Pocket 稍后阅读软件。请查阅维基页了解更多信息。
在不设置密码的情况下使用 SSH 功能应当额外谨慎,因为这将使阅读设备可被公开访问。不过如果只是临时开启设备 Wi-Fi 且接入的是家庭 Wi-Fi 网络,这个风险是可以忽略的。
打开书籍

可以从下列途径打开导入的书籍:

  • 文件浏览器 - 可点击文件浏览器用法查看详细操作方式
  • 收藏 - 由用户选定书籍组成的列表,可在文件浏览器中长按书籍添加
  • 历史记录 - 曾经打开过的书
  • 书单 - 由用户自行创建的书籍清单。请点击书单详细了解

若要改变书籍呈现方式,请按照如下路径操作:

若想调整这些屏幕上显示的项目数量,请在此处设置:

每个对话框可指定专属呼出手势。例如在阅读过程中可使用手势唤出历史记录或者收藏窗口来打开另一本书,无需打开文件浏览器。

在历史记录界面点击左上角的汉堡状菜单键,可以按照文件名或书籍元数据检索书籍。

还可将收藏或者历史记录窗口设置为 KOReader 首屏,代替默认的文件浏览器。请按如下路径操作:

2.2 点按区域

下方的图片展示了 KOReader 的默认点按区域功能划分;请点击屏幕上的对应区域呼出顶部菜单或者底部菜单。顶部菜单也可通过从屏幕上端下滑来呼出。在非触摸屏阅读设备上(如 Kindle 4),底部菜单可通过按动确认键呼出。

如上图所示,顶部菜单触发区域被划为三部分。当从最左边区域下划时,将直接显示顶部菜单的第一页; 从最右边区域下划时,将直接显示最后一页;当从中间区域下划时,将直接显示上次使用过的顶部菜单页。

若要在点击顶部菜单区域时同时呼出顶部菜单及底部菜单,请按照下方所示菜单项设置:

四角触控区可用于多种手势,如点按、双击、双指点按以及长按。

另外,前一页和后一页触控区还支持双击手势。

在状态栏触控区点按时,若状态栏设置为仅显示一项,则会循环切换各项目;若显示所有项目,点按将使状态栏显示或隐藏。

2.3 更改基本设置

这里只列出几项帮助你快速上手的设置。详细的分步讲解请参阅指南的 格式化电子书 章节。主要用于调整文字的 底部菜单 的更多内容,可参见:底部菜单项


更改字体*
调整字号
加深文字颜色
反转屏幕颜色(显示为黑底白字)
*字体选择功能仅适用于可重排文档(如 EPUB、HTML、DOCX、RTF、TXT);不支持 PDF 和 DJVU 等固定版式文档。
控制背光或前光

此菜单可控制屏幕灯光。若设备配备有暖光灯(普通白色 LED 灯混合橙色 LED 灯而成),可在此处分别控制两种灯光。若要指定呼出本对话框的手势,请按如下路径操作:

变更设备休眠时的屏幕显示
自定义屏保功能仅适用于 Cervantes、Kobo、Kindle 和 Remarkable 设备;在 Pocketbook、Android、Linux 和 MacOS 上不支持此功能。

可通过以下菜单将书籍封面或自定义图片设置为屏保:

可将 JPG/PNG 图片用作壁纸(经过适当抖动处理的灰阶图片效果最佳)。将图片文件从电脑导入阅读设备的任意文件夹,再通过以下菜单将该文件夹指定为屏保壁纸文件夹:

更多关于制作屏保图片的专业信息,请参阅这则Mobileread 论坛主题帖。

2.4 键盘用法

此处仅展示键盘基本用法;若要查看键盘快捷键相关信息,请点击此处前往对应章节。

  • 点按输入框以外的区域关闭键盘;点按输入框再次呼出键盘
  • 对字母按键上划输入对应大写字母(如已按下 Shift 键则为输入对应小写字母)
  • 若要改变键盘样式,请按照下下方路径操作:
  • KOReader 提供多种键盘布局:
  • 点击键盘上的图标即可切换键盘布局
特殊符号的输入

长按键盘按键可输入特殊字符;常用特殊字符如下图所示。长按某个数字键(图上的灰色框)以键入其周围的字符:

除了长按键盘按键弹出的特殊字符窗口外,还可通过在按键上滑动输入特殊字符。如下方图示,在字母 a 按键向其它方向滑动,可输入对应字符(如上划输入大写字母 A)。请注意图中的完整特殊字符窗口仅供演示,在滑动时不必等待窗口弹出即可完成输入。熟悉特殊字符的位置排布之后,滑动输入会让打字非常迅速。

若该功能影响正常键入,可通过取消下列选项来禁用:

另外,快捷键可以让字符修改更加便捷。长按下列按键以执行对应操作:

  • 左方向键 - 将光标移至行首
  • 右方向键 - 将光标移至行末

回退键在划动手势下可执行不同操作:

  • 点按:删除前一个字符
  • 长按:删除整行
  • 左划:删除光标左侧的字
  • 上划:删除光标所在的整个字词

详细信息请查阅对应维基页。

KOReader 亦包含用于输入繁体及简体中文的笔画输入法。请查阅维基页了解更多信息。

2.5 自动色温及夜间模式

该插件适用于支持自然光(黄色光/橘色光)的设备,用于按照时间表自动调整屏幕前光色温及开启夜间模式(屏幕颜色反转为黑底白字)。该功能既可同时设置两者,又可单独开启色温控制或夜间模式以便手动调整另一项。

本插件随 KOReader 安装过程默认启用。若其未列于菜单中,可通过下列路径启用:

若部分 PocketBook 型号在 KOReader 中设置屏幕前光或色温滑块无效,请确保设备原生阅读功能中的智能灯光控制选项设为禁用。

屏幕前光色温自动调整功能提供两种切换模式:

固定时间表:按照用户输入的时间点切换屏幕前光色温。该模式的切换点是固定的,全年保持不变、无视白昼长度的季节变化。

太阳方位:根据用户输入的经纬及海拔信息计算所在地太阳方位,并依照太阳起落数据调整屏幕前光色温。该模式的切换点是动态变化的,随一年四季白昼长短变化而调整。

在使用该模式前,请先浏览下图熟悉插件内的专业术语:

固定时间表模式
  1. 按照下列路径找到插件菜单:
  2. 单击激活菜单项,然后单击按固定计划
  3. 回到上级菜单,点按固定时间表设置
  4. 调整各菜单项以设置色温切换时间表。菜单中的专业词汇含义请参阅上方图片。
太阳方位模式
  1. 按照下列路径找到插件菜单:
  2. 点按启用,然后点按根据太阳方位切换
  3. 返回上级菜单,点按坐标设置。设置当前经纬(必填)及海拔(选填),并为该坐标起个标题。
  4. 返回上级菜单,点按色温及夜间模式设置
  5. 调整各菜单项以设置色温切换时间表。菜单中的专业词汇含义请参阅上方图片。

通过当前生效的计划选项,可查看设备正在使用的时间表。

夜间模式

在为不同的时段设置暖光百分比时,你还可以将该时段设置为夜间模式,这会在该时段开始时反转屏幕颜色。如果你的前光最低亮度仍然太亮,或者如果你喜欢深色页面背景,则可以激活此功能。要启用此功能,请在下面的对话框中,单击夜间模式复选框,然后单击设置。

设置后该时段旁将出现月亮图标。停用则只需取消勾选对应时段的夜间模式选择框。

屏幕前光自动开关

该功能会自动根据当前生效的计划在日落时打开屏幕前光、在日出时关闭。用户也可忽略当前计划,手动开启或关闭屏幕前光;自动调整色温功能仍会在设置的下个时间段自动启动。勾选白天时关闭屏幕前光选项即可启用该功能。

让色温切换更快

若希望屏幕前光色温调节以快速切换而非平滑渐变方式执行,请按下列路径操作:

  1. 参照前文说明将模式改为固定时间表
  2. 并调整下图所示的选项:

按上图所示时间表,色温昼夜切换将在一分钟内完成。这意味着屏幕前光色温将在一分钟内从 0 调节到 100(或反过来)。该用时可单独设置以拉长切换过程。

3 认识本软件用户界面

KOReader 采用简洁的以黑白为主的用户界面,这是因为渐变色和不同深浅的灰色会导致电子墨水屏出现闪屏和残影现象,从而影响阅读体验。

KOReader 有两套核心界面:阅读界面及文件浏览器。接下来将先介绍阅读界面;文件浏览器请前往本指南对应章节了解。

3.1 阅读界面

阅读界面有两套菜单:

  • 顶部菜单包含与 KOReader 使用相关的大部分常见选项。在其中可翻查书籍、调整 KOReader 功能、配置插件等。
  • 底部菜单则整合与书籍排版相关的选项,如字重、字号、行间距等。调整文本样式将主要在底部菜单中操作。

上图展示了可能出现在阅读界面上的各类元素:

  1. 指示图标:这些图标说明某些状态及当前进程,将在特定阶段出现在屏幕左上角。实际显示中这类图标的尺寸会更小,此处仅放大以供识别。接下来的一节详细介绍了各图标对应的功能:指示图标
  2. 状态栏:这是一个高度可配置的区域,你可以在此查看关于书籍和 KOReader 的各种信息。请前往状态栏章节了解详情
  3. 顶部状态栏:除了界面底部的默认状态栏,屏幕顶部还提供顶部状态栏可自行启用。请前往状态栏章节了解详情
  4. 出版方页码:如果出版方提供了印刷版书籍的页码,它们就会这样显示。点击此处可了解有关出版方页码的更多信息:页码编号
  5. 高亮样式:KOReader 提供如图所示的多种高亮样式。若阅读设备配有彩色屏幕,用户还可使用彩色高亮。点击书签、高亮和笔记章节了解详情
  6. 笔记标识:该图标出现在添加了笔记的高亮旁。KOReader 提供多种样式的笔记标识。前往书签、高亮和笔记章节了解详情
3.2 指示图标

KOReader 使用如上图所示的图标指示某些状态或当前进程,它们会在特定阶段出现在屏幕左上角。

分段渲染图标 这组图标指示了分段渲染进程,会比其它图标更常出现。当用户调整了底部菜单中的选项,这组图标就会显示。

该功能通过仅渲染当前章节(而非整本书)以便用户快速预览样式调整效果。得益于此功能,屏幕旋转也会更快生效。该功能默认启用;若要为当前书籍或全部书籍禁用该功能,可点按或长按下列菜单项:

在确认设置变更后,整本书需要重新渲染,因此这是一项分多阶段的过程。下方罗列了各图标对应的渲染阶段:

在此阶段,文档仅有局部渲染。页码计数、页脚信息等受影响数据是不准确的。用户可快速预览设置后的文本样式并进一步调整。在此阶段用户仍可翻页及使用跳转链接跳转阅读位置。

此图标代表后台正在执行全书完整渲染。此时用户仍可翻页、使用跳转链接跳转页面位置及调整设置。

此图标代表已完成全书完整渲染但尚未生效,因为 KOReader 正等待用户空闲(未操作设备)以重新加载书籍的剩余部分。此时用户仍可翻页、使用跳转链接跳转页面位置及调整设置。

用户已空闲一段时间,KOReader 正重新加载整本书。在此阶段,KOReader 会屏蔽一切手势避免干预。

分段渲染只有在 EPUB 由多个文件片段组成时才可用。EPUB 文件本质上是包含 .html 文件的 ZIP 压缩包。有的书籍只有一个 .html 文件,有的则由多个 .html 文件构成,比如每一章都是独立的 .html 文件。如果当前书籍只有一个 .html 文件,分段渲染就无法启用,因为每次更改时 KOReader 仍须重新计算整本书。

高亮模式图标 进入选择与高亮模式时,该图标将会显示。KOReader 拥有独立的高亮模式,以实现跨多页的高亮。请前往书签、高亮和笔记一节了解详情。当开始高亮操作后,该图标将显示于屏幕左上角,提醒用户当前仍处于高亮模式下。当用户选择到文段末尾自动结束高亮操作时或用户取消高亮(通过再次点击高亮的开头或该高亮图标)时,该图标就会消失。

宝可梦球图标 当在某个字上长按(有意或无意)时,该图标将会显示。KOReader 提供包含常用选项的长按菜单,以及在持续长按超过三秒时的拓展菜单。该图标代表用户触发了这款拓展菜单。

翻页模式图标 满足下列条件时,点击屏幕左上角将出现该图标:

  • 当前正在阅读 PDF 文档
  • 并且页面处于放大状态(分栏缩放、行缩放或手动缩放);或者文档处于页面重排模式

在当前图标下,屏幕将暂时显示未经裁切和放大的完整页面,此时用户仍可翻页。再次点击该图标将退出这种显示模式。

3.3 状态栏

KOReader 有两块状态栏,一条是默认启用的底部状态栏;另一条是备选的顶部状态栏,启用后将出现在页面顶部。顶部状态栏仅对 EPUB、HTML、DOCX、RTF、TXT 等可重排文件格式可用。

底部状态栏是新加的,正在持续维护中。顶部状态栏来自 KOReader 早期版本遗留,因此不会再有功能扩展。如有需要,可通过下列路径启用顶部状态栏:

顶部状态栏可通过如下菜单进行配置:

本节接下来的说明将围绕底部状态栏。

章节进度条

状态栏中的阅读进度条默认显示全书进度。但也可设置为显示当前章节进度。该功能适合诸如划分诸多短章节的书籍,此时章节状态栏可能更有用。请通过下列路径启用该功能:

也可通过指定一种手势,在全书进度条和章节进度条间切换。该选项位于:

配置状态栏

此菜单可用于配置底部状态栏。请自行探索设置子菜单,打造自己喜欢的状态栏。

状态栏上可显示多个项目,但默认仅显示一项;点击状态栏可循环显示不同项目。若要同时显示多个项目,请按照下列路径操作:

为状态栏项目排序:

若把阅读进度条与状态栏项目显示在同一行,你会发现阅读进度条的宽度会随其他项目的大小而略有变化。若觉得这样影响观感,可通过其菜单启用锁定宽度为最小值选项,把阅读进度条的宽度固定下来:
更改状态栏字体

你可以在此更改状态栏项目的字体:

你可以把已安装的所有字体用于状态栏。若想容纳更多信息,推荐 DINish Condensed 字体,可从其项目页面下载,并按照此处所述的同一流程安装:使用自己的字体

使用「动态填充器」项调节状态栏对齐

KOReader 的状态栏有一项特殊项目,名为动态填充器。把这个不可见项目加入状态栏后,它会像充了气的气球一样撑满可用空间,把两侧的其他项目推开,如下图所示(动态填充器以蓝色矩形示意):

可以像其他状态栏项目一样,在同一菜单中启用并移动该项目。也可以把它与下文介绍的自定义文本项目搭配使用,进一步调整布局。

使用「自定义文本」项调节状态栏对齐

自定义文本是一项特殊的状态栏项目。该项可用于在状态栏中显示选定文本。可利用该项在状态栏项目之间插入空白间隔,如下图所示:

  • 首先,在下列菜单中短按该选项启用功能
  • 接着,长按该选项打开设置菜单。在第一个输入框中输入空格,然后在第二个输入框中输入重复次数来调整所需的分割宽度。

也可选择其它字符作为分隔符。该项和其它状态栏项目一样可调整次序实现分组。

也可以把这个项目与上文介绍的动态填充器项目搭配使用,进一步调整布局。

状态栏预设

KOReader 允许保存多套状态栏布局并在它们之间切换。借助此功能,可以为下面这类情形分别设置不同的布局:

  • 在较宽的横屏下显示更多项目的布局
  • 阅读特定书籍时,使用包含章节名称项目的布局
  • 阅读大型漫画时,使用包含内存占用项目的布局,以便随时留意内存情况

要创建预设,先按本节前面介绍的方法添加并排序项目,把状态栏调整成自己喜欢的样子,然后选择:

这会以当前状态栏布局创建一个预设。对其他想保存的布局重复此操作即可。之后可以在同一菜单中切换这些新布局。也可以借助手势、配置文件和快捷菜单快速切换状态栏预设。

外部内容项目

外部内容是一项特殊的状态栏项目,可让 KOReader 插件在状态栏中显示内容。例如阅读计时器插件就用它在状态栏显示计时。目前无需手动启用,但可以到这里找到它:

3.4 顶部菜单项

此处仅大致介绍顶部菜单中的选项以便上手。详细信息请查阅后文的相关章节。

  • 定位:本页菜单包含用于在当前阅读书籍中定位文段的选项,如目录、书签、书籍地图等
  • 版面设置:此页菜单包含用于调整书籍版式的选项,如字体设置、样式微调等
  • 设置:此页菜单包含与 KOReader 及当前设备相关的选项,如显示效果、屏幕前光、手势等
  • 工具:此页菜单包含用于拓展 KOReader 功能的各类插件。
  • 搜索:此页菜单包含与搜索和查询相关的功能,如文本搜索,词典,翻译,维基百科等
  • 文件浏览器:此按钮用于打开文件浏览器,这里是管理书库的界面。
  • 主菜单:此页菜单包含查找书籍的工具,如历史记录、收藏、书单等。书籍信息、更新 KOReader 及退出 KOReader 选项也在此页中。
3.5 底部菜单项
长按底部菜单中的选项名称,KOReader 就会显示该选项的说明。

阅读模式:切换到页面连续模式,可以像浏览网页一样滑动阅读书籍。该模式更适合配备非电子墨水屏(LCD、OLED)的阅读设备。在页面连续模式下,页面的顶部和底部页边空白将被裁切,因此首行和末行文本可能会被裁掉。启用页面重叠可以避免这一问题:

渲染模式:该选项决定 KOReader 如何呈现页面。默认设置为网页且通常无需改变。当某本书籍(或缓存的网页)使用了复杂排版(指定了页面宽度或页边距,使用了负边距或浮动元素等),版式出现错乱或内容溢出屏幕时可尝试其它渲染模式。

缩放(dpi):该选项可视为文档全局缩放比例(不会影响字号)。在默认设置 96 dpi 下,书籍中的图片将以原始尺寸呈现。简单来说该选项可以在放大图片的同时保持文字大小不变。


文字间距和文字扩展这两项设置彼此关联,共同决定文字在两端对齐时的样子。文本两端对齐时,词与词之间的空白会被加大,使每行文字的左右边缘都与页边距对齐。由于每行的字数并不总是相同,两端对齐时文字需要被压缩或拉伸以填满一行。

文字间距:为容纳更多文字,一行文字中的空白允许被压缩的程度。该选项不会影响文字,只会改变文字的间隔。

文字扩展:当一行文字中有太多空白时,将这些空白分拆到字母之间而使单词被拉伸的程度。该选项将影响单词的样式。若不希望单词被拉伸,请将该选项设置为无。

请自行探索各种选项组合,让文本呈现自己喜欢的样式,然后在各选项对话框中将所选设置保存为默认值。


对比度和字重影响文字笔画浓淡。这两个选项都可以让文本呈现某种样式,但它们的技术原理不同。当然,这两项可以同时生效。

两个选项间的区别可以这样概括:

对比度

+ 不改变字体宽度,不影响书籍总页数

+ 无需对书籍进行重渲染,调整速度快

- 在 LCD 或低 DPI 屏幕上可能影响观感

字重

+ 如果已安装,将使用适当字重的字体

+ 在 LCD 和低 DPI 屏幕上观感更佳

- 需要重新渲染字体,调整速度慢

字距微调是调节特定字母组合之间的间距以提升视觉效果的功能。默认的最佳选项可能会拖慢书籍打开速度(受阅读设备性能影响),但对连字(如下图所示)、连笔阿拉伯字形及某些书体的支持更好。若阅读设备性能较差可将改为较好选项,在保证拉丁字母书体正确显示的前提下提升设备响应速度。

字体微调是一种排版技术,通过调整字体中的字形来适配低分辨率的像素网格(例如电子墨水屏)。启用后字形会更清晰、更易辨认,代价是原始字体设计会略微变形。

字体微调的差异在标准分辨率屏幕上或使用较小字号时更明显。在分辨率非常高的屏幕上,由于像素足够小,差异要小得多。

下面是更详细的对比:

关闭字体微调

  • KOReader 按字体真实的数学轮廓显示字形,不强制它对齐到像素网格。

开启字体微调

  • 字体会被调整以适配屏幕的像素网格,字形可能与原始字体略有差异。
  • 字体可能显得略微柔和、模糊或不够均匀(例如字母「M」的两条竖线看起来粗细不一)。
  • 字体显得更清晰、更锐利、更扎实,各字母的笔画粗细一致。

在 KOReader 中,字体微调默认启用,并使用 FreeType 库的微调算法,而非字体内置的指令(出于稳妥考虑,字体内置指令可能存在缺陷)。不过也可以改用字体设计师嵌入字体文件中的指令,看看效果是否更好:

  1. 关闭 已禁用字体微调。
  2. 原生 KOReader 使用字体内置的微调指令。
  3. 自动(默认开启)KOReader 使用 FreeType 的微调算法,忽略字体内置的微调指令,对中日韩文字的处理更好。

顶部状态栏是对 EPUB、HTML、DOCX、RTF、TXT 等可重排格式的文档启用一块补充状态栏。启用该功能后,可通过下列路径详细配置顶部状态栏:

内嵌样式及内嵌字体决定 KOReader 是否使用出版方在书籍中内置的排版样式和字体来渲染页面。这些选项通常是开关形式,可通过下列路径更精细地调整页面表现:

图片缩放决定书籍中的插图如何呈现。最佳选项可获得更好的观感,但会拖慢阅读设备。

3.6 用户界面的使用技巧

根据打开的文件格式不同,KOReader 的用户界面及设置选项可能会有所差异。KOReader 支持的文件格式大致可分为两类:

  1. 固定版式文档(PDF、DJVU、图片文件等)
  2. 可重排文档(EPUB、HTML、DOCX、RTF、TXT 等)

KOReader 包含众多功能,因此拥有复杂的菜单系统,可使用搜索菜单功能快速寻找特定设置项。若用户对某项设置的名称有印象却不知道如何找到它,可借助该功能检索:

此外,可为该功能指定唤出手势,或将其添加到快捷菜单以方便使用。

点击底部菜单中的选项标题可以查看其功能介绍。

用户界面的语言可通过下列路径更改:

如果你想改变用户界面的大小,有一个 DPI 设置:

你可以从菜单中选择一个值,或选择自定义 DPI 后输入一个值进行微调:更高的 DPI = 更大的界面。请注意,底部栏中还有一个缩放(DPI)设置。该设置仅与文档相关。你可以在下一节中找到相关说明。

长按某一选项或菜单项(如字重、行间距等)可将其当前设置指定为默认选项,仅对之后开启的书籍生效。之前打开的书籍将保持原设置。菜单中的默认项会带有星号(★)或黑色边框作为识别标记,如下图所示:

可使用下划手势对历史记录、目录、阅读统计等全屏对话框执行关闭操作。(书签是个例外,但可以通过指定其它多指手势来关闭)

有两种手势可以用来进行屏幕截图,一种是沿对角线长划,另外一种是用双指同时点击任意一对屏幕对角。第二种手势可以用于在浏览图片时截图。如果阅读设备配有实体键盘,还可以按下 Alt+Shift+G 组合键来截图。

如果你想随机打开一本书的某一页,我们提供了一个跳转到随机页的操作,你可以将其分配给任何手势。该操作位于阅读器的手势管理器的类别中。

在包含如上图所示的调整箭头按钮的对话框中,你可以点击并按住箭头按钮,以更大的幅度更改值。

你可以通过点击此类对话框(非全屏)窗口之外的位置来关闭它。

你可以通过按住其窗口标题并拖动来移动此类对话框。

你可以通过点击并按住窗口标题(当你想在调整值的同时查看其下方的文本时),使此类对话框半透明。

创建新文件夹——在需要选择位置(云存储、移动到存档插件、导出插件)时,KOReader 会显示一个类似我们的文件浏览器的界面。如果你想在选择时创建新文件夹:

  1. 首先,从文件夹选择器界面导航到该文件夹
  2. 然后长按屏幕左上角的主界面图标

KOReader 支持在 EPUB 和扫描的 PDF/DJVU 文档中进行查词典。要查看词典定义或翻译,只需点击并长按一个字即可。

在文字上长按,弹出对话框可查找该词在当前书籍中的其它出现位置,或者查询维基百科。

查看词典和维基百科结果时,可以在这些窗口里长按词语,继续用词典或维基百科检索。这会另开一个结果窗口,因此不会丢失之前的搜索结果。

如果按上一条技巧打开了多个搜索窗口,想一次性全部关闭它们,长按关闭 X 按钮即可。

如果你想查看当前日期,可以点击顶部菜单中的时钟图标。

滚动类型

KOReader 有三种触摸滚动方式。你可以通过以下方式进入:

要使用滑动浏览,须先启用页面连续模式,该选项位于底部菜单中。
  1. 经典滚动:此模式的工作原理与你的手机/平板电脑滚动完全相同。
  2. 加速滚动:此模式允许你比经典滚动更快地滚动。你还可以在不抬起手指的情况下滚动多页。滚动量与开始滚动后移动手指的距离成正比。
  3. 松手时滚动页面:这种页面滚动方式更适合电子墨水屏设备。与其他页面滚动方式不同,该方式不会在滚动时持续刷新页面。它的工作原理与经典滚动类似,但不会显示中间过程,用手指滑动,松手时页面会直接跳到对应位置。该模式对包含插图或图表的书籍尤其有用,便于改变页面位置及调整视图以完整查看这类元素。
返回前一位置

这个有用的功能类似于浏览器中的后退按钮。当你使用快速翻页工具、书签列表、书籍地图等跳转到书籍的其他部分时。KOReader 会记住你之前的位置。例如,如果你遵循内部链接或参考,这很有用。只需轻轻一点,你就可以回到你原来的地方。你可以从以下位置访问此功能:

在该菜单中还可前转页面。该功能默认被指定给  多指划动手势,用户可另行指定给另外的手势(如点击屏幕一角),或将该功能列入快捷菜单。

防止图片页面和菜单刷新

KOReader 通常会对包含图片的页面进行完全刷新(你可以看到黑色闪烁)。原因是去除上一页的残留和重影。但根据你的设备和个人喜好,这可能不是必需的。你可以在此处禁用此自动刷新行为:

如果用户界面出现黑色闪烁,你也可以从这里禁用:

5 排版你的电子书

在上一节了解了 KOReader 的基本用法后,您大概已经想开始阅读了。不过在此之前,不妨先调整一下书籍的外观,让它看起来更赏心悦目。

在本节中,我们将一步步进行“数字排版”,让电子书看起来更接近印刷书。本教程旨在帮助您熟悉 KOReader 的文字外观设置,以便日后按自己的喜好进行调整。

具体步骤如下:

  1. 挑选一款合适的字体:首先需要为书籍选一款更接近印刷书、同时在电子墨水屏上也清晰易读的字体。如果您已有心仪的字体,直接使用即可;否则可以下载下面推荐的一款。我们准备了两款风格不同的字体:衬线和无衬线(若不清楚二者的区别,点击链接即可查看差异):
    • 如果您喜欢衬线字体,可下载 Lusitana。这是一款典雅的古典衬线字体,专为长文阅读而设计。可点击这里下载。
    • 如果您喜欢无衬线字体,可下载 Red Hat Text。这是一款几何风格的无衬线字体,尤为注重易读性。可点击这里下载。
  2. 把字体传到设备上:如果不清楚操作方法,可先查阅指南中的相关部分,把字体复制到设备后再回到这里:使用自己的字体。传入字体后应重启 KOReader,以便将字体加入字体列表。
  3. 设置新字体:打开书籍,进入下图所示的菜单。新加入的字体应出现在字体列表的开头,选中它即可:
  4. 禁用内嵌字体:现在需要把该选项设为 关闭,让 KOReader 使用我们选定的字体,而不是书籍自带的字体。如果该设置项呈灰色不可更改,说明本书没有内嵌字体,可跳过本步:
  5. 调整字号:现在来调整字号。对 Lusitana 而言,22.0 是个合适的大小;Red Hat Text 则可以小到 20.0。不过这纯属个人偏好,您可以按自己看着最舒服的数值来设。在此处设置字号:
  6. 调整字重:如果在电子墨水屏设备上使用 KOReader,文字看起来会比 LCD/OLED 屏幕偏淡。一般字体并非专为电子墨水屏设计,因此可以通过 字重设置把文字调深来弥补。+1 是不错的起点,某些较细的字体可能需要 +2。点按设置行末尾的 三个点还可以做更精细的调整:
  7. 调整行间距:接下来调整 行间距,它决定行与行之间的垂直距离。该设置因字体而异,取决于字符的字形结构。Lusitana 可设为 135 %;Red Hat Text 字形较为舒展,可以用更紧凑的 120 %。在此处设置:
  8. 调整边距:到这一步,文字看起来应该已经相当不错了。最后再调整 边距(文字四周的留白),完成全部设置。现在打开下列菜单,参照下图进行调整:
    • 左右边距:设置为 级别 7
    • 上边距:设置为 级别 6
    • 下边距:设置为 级别 6

完成上述设置后,书籍看起来应该更接近印刷书了。如果愿意,还可以继续微调这些设置。

5.1 如何保存设置

设置完这些之后,您可能会问:“我的其他书也会变成这样吗?”不会,并不会自动生效。因为所有这些改动只对当前书籍有效。

在其他阅读器应用中,当你更改某项设置(例如书籍所用字体)时,更改会全局生效。也就是说,如果你把默认字体改为 Verdana,此后打开的所有书籍——包括你正在阅读的——都会以这种 Verdana 字体显示。

KOReader 的做法与此不同。外观设置是按书籍分别保存的。这使你可以灵活地更改当前书籍的设置,而不影响其他书籍。例如你有一些奇幻小说,可以只把这些书的字体换成中世纪风格。也可以将某些书籍设为以横屏或双栏模式打开。

KOReader 的机制是这样的:

  1. 字号、行间距等 KOReader 设置都有默认值。
  2. 打开一本新书时,KOReader 会参照这些默认值来设定书籍外观。
  3. 在某本书里所做的改动(例如调整文字大小)只影响这一本书。因为这些改动不会修改默认值,所以新打开的书不受影响。
  4. 不过你也可以把改动保存为默认值,这样一来,新打开的书籍同样会采用这些设置。

来看一个例子:

在刚才的操作中,我们把书籍的 字重调到了 +1.00。现在打开 字重菜单,点按 字重设置行末尾的 三个点。此时会弹出一个对话框,显示 默认值:+0.00。这表示打开另一本书时,其字重仍为 0(默认值),而不是我们之前设定的 +1。

因此,要让某项设置长期生效,必须把它设为默认值。KOReader 提供两种设定默认值的方法:

  1. 将单项设置设为默认值
  2. 一次性将所有设置设为默认值
1. 将单项设置设为默认值

KOReader 中的设置通常都可以通过长按来设为默认值。请看下面的截图:

右侧以蓝色标出的数值可以长按,将其设为默认值。假设想让文字更粗一些:如果普通点按 +1,改动只对本书生效;但长按它,就会看到下面这个对话框:

如果点按 设为默认按钮,本书以及今后打开的书籍都将采用 +1 字重。

这条“长按设为默认值”的规则在菜单中同样适用。例如从顶部菜单更换字体时:

  • 短按 = 仅更改本书字体
  • 长按 = 更改本书及今后所有书籍的字体

在菜单系统中,默认值会带有 星标 (★),或在指示项周围显示 黑色边框,如下图所示:

请记住,已经打开过的书籍仍会保留各自的设置。更改默认值不会影响它们。

2. 一次性将所有设置设为默认值

也可以把当前书籍的全部设置一次性设为默认值,而不必逐项操作。如果你对一本书做了大量改动,并希望所有书籍都呈现出同样的效果,这种做法会很有用。

你可以通过选择以下选项将更改保存为默认值:

这会用当前文档的设置覆盖所有设置。因此,点按该菜单项之后打开的所有书籍,外观都会与当前这本书完全一致。

那么已经打开过的书又该怎么办?如果已经点按了上面的菜单项、设定好新的默认值,现在就能轻松把它们应用到任意书籍:打开想更改的书,进入同一菜单,点按下面这一项:

点按该选项后,当前书籍设定将会回到上次配置的默认值。无需担心,该选项仅改变书籍样式,阅读位置、高亮、笔记和书签会被保留。

使用配置文件应用一组设置

好了,至此你已经知道:

  • 如何更改当前书籍的各项设置
  • 如何把改动设为默认值,让所有书籍都能采用

现在来看另一种使用场景:假设你已经把默认值调成了自己喜欢的样子,于是每次打开新书,外观都正合心意。最近你开始读一套奇幻丛书,为了更投入,特意为这套书装了一款漂亮的中世纪风格字体(如果确实需要,这里有一款不错的)。但由于这款字体风格迥异,你还不得不改动 行间距、字重、边距等许多设置。

要为这些奇幻书籍改动上述全部设置,根据前面所学,你有两种选择:

  1. 可以在打开每本书时逐本修改这些设置。这样做非常繁琐,并不是好办法。
  2. 可以先改好一本书的设置,再用 保存文档设置为默认功能。但这会影响到所有新打开的书籍,并非我们所愿——我们只想把中世纪字体的设置应用到少数这几本中世纪主题的书上。

好在 KOReader 有一个名为配置文件的功能,可以把某本书的设置保存下来并应用到其他书籍(可以把它理解为“复制与粘贴”)。

回到刚才的场景:为中世纪奇幻书籍调好全部设置后,前往下列路径:

它会要求为这个配置文件命名。可以输入类似 “Medieval Fiction” 的名称并保存。这样就创建了一个名为 Medieval Fiction 的配置文件,其中包含当前书籍的设置。现在可以在 配置文件菜单中看到这个新建的配置文件。要使用它,只需打开任意书籍并运行该配置文件,所有已保存的设置便会被应用。

你可以从此处运行该配置文件:

甚至可以为该配置文件设置一个触发条件,例如每当打开 “Medieval Fiction” 目录中的书籍时,就自动应用这个配置文件。详情请参阅配置文件一节。
5.2 使用自有字体
向 KOReader 添加新字体

可以把自己的字体添加到 KOReader,用作文档字体、状态栏字体,甚至(借助用户补丁)用作用户界面字体。

KOReader 支持以下常见字体格式:

  • TrueType - .ttf 扩展名
  • OpenType - .otf 扩展名
  • Web Open Font Format - .woff 和 .woff2 扩展名

带有这些扩展名的字体文件可以直接复制到设备上的 /koreader/fonts/ 文件夹。具体复制方式可能因设备而异,例如:

  • 在 Kobo 设备上,完整路径为 /mnt/onboard/.adds/koreader/fonts
  • 在 PocketBook 设备上,需在 /applications/koreader/fonts/ 目录下为每款字体各建一个目录,再把字体复制进去。
  • 在基于 Android OS 的设备上,可以把字体复制到下列目录:
    1. Internal storage/Fonts - 供所有 Android 应用使用的通用字体目录
    2. Internal storage/koreader/fonts - KOReader 专用字体目录。
  • 在 Desktop 版本中,可以把字体复制到下面菜单项所显示的位置:打开字体文件夹。此外,若在同一菜单中开启 可调用系统字体选项,KOReader 便能使用操作系统中所有可用字体:

KOReader 支持为 Fonts 目录建立子目录,因此可以把各个字体系列作为子目录复制进去。把字体复制到上述目录后,重启 KOReader,新字体应出现在字体列表的开头:

KOReader 可以生成一份文档,用设备上安装的所有字体渲染示例文本。借助它可快速比较各字体的外观与特性,例如希腊语、希伯来语或汉语等非拉丁文字中的连字和字符集。可通过下列路径使用该功能:
更改状态栏与用户界面字体

你可以在此更改状态栏项目的字体:

状态栏可以使用任意已安装的字体。如果需要在保持易读的同时显示大量信息,推荐 DINish Condensed 字体。可点击这里下载,并按上文相同的步骤安装。

如果想更改 KOReader 用户界面(菜单和对话框)的字体,可以借助 用户补丁实现。相关说明见:用户界面字体更换补丁

电子墨水屏字体推荐

这些字体因对比度更高,在电子墨水屏上效果良好:

衬线字体建议

无衬线字体建议

指南中设有特殊字体一节,如果你需要专为提升易读性、或针对阅读障碍(Dyslexia)与注意力缺陷多动障碍(ADHD)设计的字体,这一节或许会有帮助。

此外还推荐看看 WP Fonts 项目。它收录了规模最大的 KOReader 免费/开源字体合集,并附带错误修复及其他改进,例如修正字距微调、启用连字、补全未正确实现的 OpenType 特性等。


等宽字体建议

如果你打算使用自己的等宽字体,可能你已经有一个最喜欢的字体了,所以我们在这里不提供任何例子。但是你可以在programmingfonts.org上找到并比较许多等宽字体

你还可以在Google Fonts网站上发现更多字体。

在一本书籍中套用多种字体

在基于 HTML/CSS 的文档(如 EPUB)中,书籍可以指定使用字体族而不是特定的字体名称。这些字体族可以是衬线体(Serif)、无衬线体(Sans-Serif)、等宽体(Monospace)、草书体(Cursive)、花体(Fantasy)、表情符号体(Emoji)、仿宋体(Fang Song)和数学体(Math)。例如,在一本书中,正常的文本可以用无衬线体显示,而对话则用衬线体显示。KOReader 通常对所有这些字体族使用默认字体,但等宽体(Monospace)和数学体(Math)除外(具体由文本节点的样式决定,例如 'font-family: serif' )。如果你希望这些字体族看起来更具区别性,你可以在这里为它们指定特定的字体:

要更改当前书籍的字体系列,只需点击所需的字体名称。如果你想为所有书籍设置此设置,请长按将其设置为默认设置(★)。如果某本书滥用了此字体系列功能,以至于几乎不使用默认字体,则可以通过取消选中该关联来禁用该字体系列。

快速切换字体

如果你经常在字体之间切换(比如编程书籍用等宽字体,小说用衬线字体),有一个解决方案可以让你比每次都进入菜单更容易。你可以为你的字体和所有字体相关设置(如行间距,对比度,粗体等)创建配置文件,并将这些配置文件添加到快捷菜单中。因此,只需一个手势,你就可以打开字体选择菜单,并更改字体,如下图所示:

查看本指南的快捷菜单与配置文件部分,了解具体操作方法。

等宽字体比例

如果你的书籍包含使用等宽字体的部分(如编程书籍),等宽文本可能看起来不成比例,即使其字号与其他文本在技术上相同。这是由不同的字体指标引起的。KOReader 有一个选项允许你调整等宽字体的相对大小:

在这里,你可以通过调整默认大小的百分比来增加或减少等宽字体的大小。

KOReader 字体系统的技术细节与故障排除

如果在向 KOReader 添加字体时遇到字重方面的问题,本节可帮助你理解 KOReader 的字体处理机制:

  1. 启动时,KOReader 会读取各字体内嵌的字体元数据/信息来整理可用字体,并按字体系列和字重分类。KOReader 会尝试从字体所含元数据中判断字体系列信息,因此把字体复制到设备时字体名称并不重要。
  2. 如果某个字体系列有多个字体文件,KOReader 会尝试把它们归入以下 4 类之一:Regular, Bold, Italic & BoldItalic。理想情况如下:
    • Luciole-Regular.ttf 映射到 字重:0 (Regular 400)
    • Luciole-Bold.ttf 映射到 字重:+3 (Bold 700)
    • Luciole-Regular-Italic.ttf
    • Luciole-Bold-Italic.ttf
    如果某个字体变体不存在,或需要进行小数级的微调,KOReader 会从最接近的可用字重合成得到。
  3. 如果某款字体只提供一个文件、且并非 Bold,KOReader 会把它指定为 (Regular 400) 的 字重:0,并自行合成其余所有字重与变体。换句话说,KOReader 会为这款字体“伪造”斜体和粗体。(如果这唯一的字体文件是 Bold,KOReader 则会由这个粗体合成出 Regular 字重。)

如果在底部菜单中长按 字重标签,就会显示当前字体提供了哪些字重级别。

如果你的字体还有其他变体,情况就可能变得复杂。假设你把一整个字体系列复制到了设备上,启动时 KOReader 读到了该字体的以下变体,顺序为:Light、Thin、Normal、Medium、ExtraBlack、SemiBold、Bold、Black。你可能以为 Normal 变体会被用作文档的正文字体(因为它的名字就叫 Normal),但 KOReader 实际会选用 Light,因为它是列表中第一个不带粗体标记的字体。而 Thin、Normal 和 Medium 变体会被忽略,因为 KOReader 已经为文档找到了一个“非粗体”字体。

同样按这个列表,ExtraBlack 会被用作粗体字体,因为它是列表中第一个带有粗体标记的字体。而 SemiBold, Bold, Black 变体会被 KOReader 忽略,因为它已经找到了所需的“粗体”字体。

小结一下:我们复制了整个字体系列,本以为会选中 Normal 和 Bold 变体,结果 KOReader 却用了 Light 和 ExtraBlack。这是因为字体送入 KOReader 的顺序不受我们控制,只能“先到先得”。

解决办法是只传入你希望使用的字体文件,例如:

  • Thin、Extra Light、Light、Normal、Medium 中只保留一个:它会被用作常规字体(如果你的 Regular 字体太细,且手头有 Medium 字重,换成它即可)。
  • Semi Bold、Bold、Extra Bold、Black、Extra Black 中只保留一个:它会被用作粗体字体。
  • 也可以额外加入同字重的斜体变体(例如 medium/medium-italic)。
5.3 样式微调

KOReader 的样式微调功能允许你修改 KOReader 显示书籍的方式。我们不会在这里进行完整的 CSS 课程。我们只想向你展示一些基本的东西,这样当你看到一个样式微调时,你至少会有一个大致的概念。

什么是样式微调?

我们可以将 EPUB 文档描述为 HTML 文件 + 一些 CSS 规则。这些 CSS 规则决定了书籍的不同部分(标题、粗体文本、引用等)在阅读应用中的显示方式。借助样式微调,你可以通过添加新规则和/或覆盖书籍中嵌入的、由出版方编写的规则,来更改书籍的呈现方式。

让我们看一个样式微调的例子:

img { width: 10px !important; height: 10px !important }

用通俗的语言来说,这条规则是:忽略它们的原始大小,让这本书中的所有图片都有 10 个像素宽,10 个像素高。因此,如果你将此样式微调添加到 KOReader,你书中的所有图片都将显示的很小。

现在让我们逐项解释这个调整:

  • img - 这是一个 CSS 选择器,目标是书籍中的所有 img(图片)元素。
  • { width: 10px !important; height: 10px !important; } - 这是声明块。它包含将应用于所选 img 元素的样式。
  • width: 10px !important; - 第一部分将目标 img 元素的宽度设置为 10 像素。!important 声明是一个覆盖开关,它确保您的宽度值优先于应用于这些图片的任何其他现有 width 声明。
  • height: 10px !important; - 这部分将目标 img 元素的高度设置为 10 像素。同样,!important 是一个覆盖开关,可确保您的高度值优先于应用于这些图片的任何其他现有 height 声明。

总之,这个 CSS 规则旨在将你的书中的所有 img 元素设置固定宽度和高度为 10 像素,并忽略其原始样式。

一些有用的样式微调示例

这些是一些有用的样式微调,你可以直接使用或根据自己的喜好进行修改。下一个标题解释了如何在 KOReader 中使用它们。

  • 在书籍中的每个标题上方添加分隔线:

    H1, H2, H3, H4 { border-top: 2px solid black; }

  • 在标题上方添加一些边距:

    H1, H2, H3, H4 { margin-top: 2em !important; }

  • 或者,如果书的标题上方的边距过多,请将其删除:

    H1, H2, H3, H4 { margin-top: 0 !important; }

  • 在段落之间添加一个小间隙,使文本更具可读性:

    p + p { margin-top: 0.5em !important; margin-bottom: 0.5em !important; }

  • 禁用EPUB中的所有图片:

    img { display: none !important; }

  • 使图片非常小,而不是禁用它们:

    img { width: 10px !important; height: 10px !important }

  • 使计算机科学书籍中的代码块部分更整洁、更易读(在这里你可以看到一个例子):

    pre,code { font-size: 0.6em !important; line-height: 1.8em !important; background-color: #eee !important; margin: 1em 0 !important; padding: 1em 0 !important; }

如何添加样式微调

好的,现在我们已经了解了什么是样式微调。但我们如何使用它们呢?KOReader 中有三种类型的样式微调:

1. 内置样式微调

新建标题,上下截图。还有需要添加的吗?

这些调整都包含在 KOReader 中。它们是最容易使用的,因为你只需从菜单中启用它们即可使用它们。你不需要写任何 CSS 代码:

它们有很多种类。若要仅对当前书籍应用调整,请勾选复选框。如果你想获得更多关于这个调整的信息,或者对所有的书启用它,长按它的名字。将出现一个对话框:

  1. 此区域显示参数的名称和说明
  2. 此框显示了调整的 CSS 代码。你可以点击此区域将代码复制到剪贴板。然后,你可以在你的仅本书调整中粘贴和修改此代码,如下一标题所述。
  3. 显示在操作列表中按钮允许你通过手势切换此调整,或将其添加到快捷菜单中。有关更多信息,请参阅下面的“如何有效使用微调”一节。
  4. 用于所有书籍按钮为所有书籍激活此调整。菜单中其名称旁边将出现一个星号(★),表示此调整将应用于所有书籍。你可以使用相同的步骤禁用此功能。
2.仅本书调整

正如其名,这类微调仅对你创建它们时所在的那本书籍有效。此功能在你需要测试微调效果,或明确只需对当前书籍进行特定修复时更为实用。创建此类微调后,如果你认为其他书籍(例如,来自同一出版方的书籍)也需要此设置,你可以将其转换为用户样式微调,我们将在下面解释。

要创建仅本书调整,请使用你可以在此处找到的集成编辑器:

编辑器底部工具栏有 CSS 菜单,内置多种常用 CSS 语法和特性。在打开该菜单前,请先阅读长按获取信息帮助。另外,长按菜单中的 CSS 项可阅读其功能描述。
3.用户样式微调

这组调整在创建方式上与之前的调整不同。与之前的类型不同,它们也不限于一本书。它们可以在全局范围内应用于你的所有书籍。

程序大致是这样的,我们将详细解释:

  1. 创建用户调整文件
  2. 传输到你的设备
  3. 从菜单中启用

1. 创建用户调整文件:

用户样式微调实际上是一个扩展名为 .css 的普通文本文件。你可以这样创建此文件:

  • 在你的计算机上
  • 在你的设备上,如果它有一个文本编辑器(如基于 Android 操作系统的设备)
  • 在 KOReader 的集成文本编辑器中,你可以在插件中找到

你可以将上面提到的示例复制/粘贴到你的文件中。


2. 将文件传输到你的设备:

创建包含 CSS 规则的文件后,将其保存或传输到 KOReader 安装下的 styletweaks 文件夹中。为文件指定描述性名称,因为文件名将是 KOReader 菜单系统中微调的标题。你可以在文件名中使用下划线"_",它们将在菜单中被视为空格。你需要在传输文件后重新启动 KOReader,以便它可以加载它们。


2. 启用调整:

重新启动后,打开一本书并转到此菜单:

现在你应该在列表中看到你的调整,旁边有一个复选框。要将你的调整仅应用于当前书籍,请勾选复选框。如果你希望对所有书籍启用此调整,请长按其名称。将出现一个对话框。轻按菜单项用于所有书籍。一个星号(★)将出现在菜单中其名称旁边,表示此调整将应用于所有书籍。你可以使用相同的步骤禁用此功能。下面是一个例子:

在上图中,我在 KOReader 安装下的 styletweaks 文件夹中有3个样式微调文件。第一个被禁用,因为复选框为空。第二个选项仅对本书启用,因为复选框已标记,但没有星号。第三个选项适用于所有书籍(★)。

你可能会注意到,在第一个调整旁边还有一个直角三角形图标。这意味着可以使用手势激活此调整。这将在下一个标题中解释。

如何有效地使用微调

在创建用户样式微调时,你可以创建多个调整文件,每个文件都修改了书的某些部分,如上图所示。你可以有一个文件用于标题,其他文件用于修改段落、链接等。这个模块化系统允许你根据文档进行调整。

正如我们上面所说的,你可以从这个菜单位置切换用户样式微调:

此外,我们还有更简单的方法来切换你的样式微调,而不是每次都去菜单。

1. 你可以将手势指定给调整

为此,首先我们必须把我们的用户样式微调添加到手势操作列表中:

  • 转到用户样式微调菜单,长按样式微调
  • 在对话框中,按下按钮显示在操作列表中
  • 菜单中样式微调旁边将出现一个直角三角形图标

你可以在上面的示例图片中看到它,在调整边距样式微调旁边。现在,此样式微调已添加到操作列表中。你可以在手势管理器>可重排文档类别下找到它。它将在列表的末尾。


2. 你可以在快捷菜单中添加微调

要在快捷菜单中添加微调,首先必须将其添加到上述标题中描述的操作列表中。然后,你可以按照本指南快捷菜单部分的说明进行操作。

你甚至可以将这两种方法结合起来,为你的样式微调创建一个特殊的快捷菜单,然后将其分配给一个手势。这样只需一个简单的手势,你就可以访问所有的样式微调,并根据需要激活它们。

查找要修改的元素

请注意,在某些书籍中,标题可能不在 <H1> 或 <H2> 元素中,而是在类似 <p class="tit123"> 的内容中。你可以通过检查源代码来查找用于文本部分的选择器。要实现这一点,请选择你感兴趣的元素周围的文本,然后从对话框中选择查看 HTML。在上面的示例中,你的样式微调看起来像这样:

P.tit123 { border-top: 2px solid black; }

而不是这样:

H1 { border-top: 2px solid black; }

6 标注文档

KOReader 提供了多种选项,可以像印刷书一样做记号。书签页面的多项设定可以在下列路径变更:


阅读位置书签:

可通过点按屏幕右上角来添加(或移除)书签。该操作类似于将印刷书的书页折起一角,并且会显示类似形状的图标。


文段高亮:

有四种不同样式的高亮可用使用。下图展示了一段普通文本及不同样式的高亮:浅色(灰色背景)、下划线、删除线及反色。

你可以同时使用所有这些样式,就像使用不同颜色的荧光笔一样。或者你也可以在此菜单中通过长按来选定你最喜欢的样式并将其设为默认:


另外,如果当前设备配有彩色屏幕,还可使用不同颜色进行高亮:

使用多色高亮时的技巧:

  • 已经划下的高亮段落可以改变用色;点按高亮段落,在弹出菜单中选择颜色选项即可。
  • 你可以将颜色与下划线、删除线等不同的高亮样式结合,可以创建一套强大的高亮系统。例如可以用红色删除线样式标记删除段落,或用橙色下划线样式标记重点等等。
设置默认高亮样式

  1. 在高亮菜单中,可以在某种样式上长按将其设置为默认项(★)
  2. 选择一种颜色后,可通过在菜单中长按颜色名称将所选颜色设为默认项(★)
  3. 将当前样式及颜色应用于全部高亮选项可以将整本书中所有高亮统一为一种样式。请务必谨慎,该操作是不可逆的!

笔记:

还可为高亮添加笔记;只需点按一段高亮,从弹出菜单中选择添加笔记。还可选择一种笔记标记标出包含笔记的高亮。有三种样式可供选择 —— 下划线、批注线和笔记符号(一枚显示文段右侧的铅笔图标,如下图所示):

请按下列路径启用该功能并选择一种笔记标记样式:

你可以对高亮做哪些操作?

对文档中的一部分完成高亮后,点按该高亮即可看到高亮菜单。在此高亮菜单中,点按…(三个点)按钮即可打开另一个扩展菜单,如下图所示:

使用此扩展菜单,你可以:

  • 展开高亮以纳入更多文字
  • 复制文本到剪贴板,以便粘贴到别处
  • 搜索维基百科中的该文本
  • 查询已安装词典中的该文本
  • 翻译文本,使用 Google Translate 服务
  • 查看 HTML可显示被高亮片段的源代码,这在编写样式微调时很有用
  • 生成二维码,其中包含高亮文本,可用另一台带摄像头和二维码扫描应用的设备扫描
  • 搜索书中的该文本
6.1 高亮模式

KOReader 提供两种不同的高亮模式:

普通模式

普通模式与在手机或平板电脑上用手指选择文本类似,适用于高亮文段在同一页内的情况。

  1. 在要高亮文段的首字上长按
  2. 移动手指到要高亮文段的末尾
  3. 抬起手指

当划到页面边界时,KOReader 会自动翻页以保持高亮连贯(仅对 EPUB 和 HTML 文档有效)。该功能可通过下列路径禁用:

当你想长按靠近边角的文字时,边角长按手势可能会造成干扰。我们提供了专门的手势管理器动作,可用来切换或临时禁用边角长按手势。你可以将这些动作指定给某个手势,或放入快捷菜单中使用。可在此处找到它们:
选择并进入高亮模式

选择并进入高亮模式更适合跨页的长段落高亮。在该模式下无需用手指在屏幕上滑动即可完成高亮,因此对阅读设备的触控灵敏度不佳,或用户较难控制手部运动的情况尤为有用。

如果开启查阅词典功能,在长按某个文字时需拖动才能启动该模式。

高亮的方法:

  1. 在要高亮文段的首字上长按(如果启用了查找词典功能则是对首字拖拽)呼出菜单。
  2. 点按多选选项进入高亮模式,此时屏幕左上角将出现一枚图标(可点击该图标获得更多信息)。再次点按高亮起始处可取消高亮。在高亮模式下可使用点按或滑动翻页,并可使用目录或快速翻页工具前往任意页。
  3. 在高亮的末字上长按菜单会再次显示;若启用了查询词典功能,则通过拖拽末字呼出菜单。
  4. 现在点按高亮即可完成对文段的高亮。

通常情况下该对话框将显示在屏幕中间。如果希望对话框显示在高亮位置附近,可以将菜单第二页的中间选项改为手势位置:

若不需要上图所示的文字长按菜单,有更简单的方式进入该模式。在完全禁用长按文字的弹出菜单后,长按将直接进入选择及高亮模式。这种方式更快捷,只需点按两次即可高亮任意长度的文段。启用下列选项来使用该功能:
KOReader 可以高亮包含不同样式的整篇文章。浅色选项将使文段背景变为灰色。受限于 e-ink 技术特性屏幕无法直接从白切换为灰色,所以被高亮的文段将先变黑然后再变灰。要避免这种屏幕闪烁,请选择反色作为高亮样式。该选项将使文段背景变黑所以无需屏幕闪烁。请在下列路径中调整高亮选项:
同一文段可被多次高亮及添加笔记。若多层高亮重叠在一起,点按高亮处会弹出菜单以供选择想要编辑的高亮。
高亮时自动纳入标点

在进行高亮操作时,KOReader 会尝试将与选段相关的标点符号纳入高亮。例如,当从头到尾高亮一个句子时,KOReader 会自动将句子两端的标点符号一并高亮。

但如果从句子中间开始高亮,KOReader 会认为用户只是想高亮句子片段,因此不会自动包含句末标点。若要将标点包含在高亮中,请在选择时选中完整句子。之后也可长按编辑高亮按钮补上标点符号。

6.2 编辑高亮

点按不含笔记的高亮文本,可以看到包含删除及添加笔记选项的弹出菜单。菜单底部的按钮则用于扩展或缩减高亮区域。

该项调整仅对 EPUB 等可重排格式生效。在 PDF 文档中扩展或缩减高亮时,受限于 PDF 格式需要先整段删除再重新高亮。

点按附带笔记的高亮文本,可以看到如下所示的弹出菜单。点按编辑高亮打开上图所示菜单,以便对高亮及附带的笔记进行编辑:

在书签管理界面,点按菜单按钮()可以筛选显示出某一类型的书签;也可按照高亮样式筛选:

编辑被高亮的文段文本

除了添加笔记,KOReader 还支持直接编辑书签列表中显示的高亮文本。在某些情况下,这可能比为高亮添加笔记更实用。比如要标记包含多项日期的句子但其中一项日期有误,而要添加一条笔记来指出错误,得在笔记中明确写明。但如果可以直接编辑被高亮文本,就可以直接在有误的日期后写上「该日期需要再次核对」。

请注意,此编辑操作不会改变页面上显示的被高亮文段,阅读时看到的仍是书籍原文。编辑内容要在书签列表界面查看;在导出高亮时,被导出的文本会是编辑后的版本。

要编辑被高亮的文本,请按如下步骤操作:

  1. 点按高亮文段
  2. 在弹出菜单中点按详情
  3. 在详情对话框中点按编辑文本

你也可以从书签窗口中进行操作:

  1. 通过点按菜单或手势打开书签列表
  2. 长按想要编辑的被高亮文段
  3. 在菜单中点按编辑文本
  4. 在弹出对话框中修改文字,然后点按保存按钮

若要将编辑后的文本撤回到书籍原文,按上方所属步骤操作但在第三步时不要点按编辑被高亮文本,而是点按还原原始文本按钮。

更改添加的笔记在书签列表中的显示方式

通常情况下,书签列表中仅会列出用户对文段的高亮。如果高亮附带笔记,只会在书签列表中显示一枚铅笔图标。可以长按列表中的某一项高亮以查看(并编辑)附带的笔记。若要在书签列表中同时展示笔记,可按照下列路径设置:

有如下几种显示方式可供选择:

  • 仅显示高亮文段(默认设置)
  • 同时显示高亮文字及笔记
  • 存在笔记时仅显示笔记,否则显示高亮文段
通常情况下,书签窗口中的项目是数量固定且均匀分布的。若要使用更加灵活的版式,可在下列菜单中调整每份书签的最大行数选项:
6.3 导出高亮

在读完一本书后,可以将其移到指定文件夹作为存档。启用移至存档插件,指定存档目录路径(设置存档文件夹)。完成设置后,可通过下列方式将书籍移入存档:

  • 移至存档插件菜单
  • 利用指定的手势或者
  • 使用快捷菜单中的入口

KOReader 提供多种导出高亮和笔记的方式:

1、使用导出高亮插件

这款多功能插件可以将高亮导出为本地文档或上传到云服务。


本地导出

高亮可被导出为以下几种文件格式:

  • 纯文本(.txt)
  • HTML 网页(.html)
  • Markdown 文档(.md)
  • Kindle 笔记与摘录(.txt)
  • JSON 文件(.json)

可以在下列菜单中选择想要使用的导出格式:

可以在下列菜单中查看(或修改)导出文件存放目录:


在线服务

还可通过网络将高亮导出到下列服务平台:

  • Joplin - 一款笔记应用程序
  • Readwise - 一款在线书签及高亮软件
  • Memos - 一款自托管的开源备忘录
  • Flomo - 一款在线笔记服务
  • XMNote - 一款安卓平台的中文界面书签管理软件

这些服务的详细操作指南可以在维基页上查阅。


在选择导出格式后,可以在该插件菜单中导出当前书籍或个人书库中全部书籍的笔记。

若想仅导出部分书籍的笔记,可以在文件浏览器中这样操作:

  1. 在文件浏览器中同时选中多本书籍
  2. 点击右上角的菜单按钮(显示为复选标记)
  3. 从菜单中选择导出高亮

仅浅色、下划线、删除线、反色四种高亮样式可被导出。通常情况下 KOReader 会将它们全部导出。也可在下列菜单中选择性导出:

你可以通过插件菜单(设置导出的文件名)自定义导出文件的名称,加入日期/时间信息和其它有用信息。

可以为导出操作指定手势以快速调用。这些选项位于阅读器类目下的手势管理器中。

2、使用 KoHighlights

KoHighlights 是安装于电脑中的外部软件。将阅读设备连接到电脑后,它可以自动读取高亮和笔记。请前往该项目的 GitHub 获取下载链接和使用说明。


三、使用 Calibre

Calibre 安装在电脑上的外部软件。借助 Calibre 的 KOReader 同步插件,可以将高亮导入到 Calibre 数据库中。该插件要在 Calibre 软件内启用。请前往 Calibre 的项目页获取下载链接及使用说明。

在 KOReader 中开启某个文档后,文档所在目录中将生成一个同名文件夹;文件夹内有一个与文档关联的 .lua 文件,包含了全部的高亮、笔记和用户设置项(如文本格式设置)等。用户可手动备份及还原这个文件夹内容。
7 阅读 PDF 文档
7.1 PDF 阅读技巧

KOReader 提供了多种解决方案以提升在小尺寸屏幕上阅读大开本(通常为 A4 规格或信纸开本)的 PDF 和 DJVU 文档的体验:


1. 启用页面重排

重排功能会尝试从你的文档中提取文本部分(如果可用),并将其格式化为单栏显示。效果通常令人满意。你也可以通过点击并按住它将其设置为默认值。


2. 启用页面放大

使用此选项,KOReader 会尝试从文档中裁剪边距,以便文本在屏幕上看起来更大。你可以在同一菜单中设置适配到宽度,该菜单将尝试仅适合页面宽度而不是整个页面,因此你的文本看起来会更大。


3. 将阅读设备设置为横屏模式

这将使你的屏幕更宽,以便你的文档看起来足够大,可以舒适地阅读。


4、以文档原始尺寸浏览,通过滚动屏幕浏览页面的不同部分

这对阅读漫画书尤其有帮助。请先通过该菜单项启用分栏模式:

然后从同一菜单中为文档选择适当的流向:

  • 例如,如果你正在阅读一篇双栏排版的文章,你会向下滚动,先读完左侧栏至本页末尾,然后移至右上方继续阅读右侧栏:

  • 或者,如果你正在阅读漫画书,你将需要以锯齿形模式"右/下左/右":
  • 对于日本漫画书(从右到左的面板顺序),这可能是相反的:

在此模式下,你还可以从同一菜单调整水平/垂直重叠和分栏数,以更好地适应屏幕上的文本。请随意尝试这些设置。

阅读 PDF 文档时,如果你正处于 100% 以外的缩放视图(如分栏、分行或手动缩放)或者开启了页面重排模式,点按屏幕左上角可进入翻页模式。此模式会临时显示未经裁剪的完整页面,并自动缩放以适应屏幕,你可在此模式下翻页。再次点按该图标可从该模式中退出。
7.2 PDF 文档专有菜单项

对比度设置调整文档中的黑色级别。请注意,相同的对比度值适用于文档中的文本和图片。如果你把它设置得很高,你的图片可能会变得太暗。

去水印从呈现的文档中移除水印。它也可以用来删除灰色背景。此功能可以将灰度或彩色文档转换为黑白,提高对比度,以便于阅读。

渲染质量(仅在重排模式下处于活动状态)设置文本和图片提取处理和输出的质量。高质量更令人愉悦,但它可能比默认慢得多(翻页需要几秒钟),具体取决于你的文档。如果你的 PDF/DJVU 文件很慢,这是你应该检查的第一个设置。


文档语言设置 OCR 引擎将使用的语言。

强制 OCR 顾名思义,即使文档具有文本层,也强制使用 OCR。

书写方向(仅在重排模式下有效)设置原始文档的方向。对于阿拉伯语和希伯来语等语言,将其设置为从右到左(RTL)。

文档分栏仅在重排模式下有效用于设置原始文档的文本分栏数。


自动校直功能可以拉直有问题文档的页面,例如倾斜扫描的 PDF 页面。它在 PDF、DJVU、CBZ/CBT 文档和图片文件中可用。要启用此功能,请选择 KOReader 将尝试校正的最大倾斜角度。如果未校正,你可能需要选择一个更大的角度。请注意,此功能可能会减慢你的阅读器速度,具体取决于多个因素。

7.3 保存 PDF 高亮

可以使用前面章节介绍过的导出高亮功能来保存高亮。

当在 PDF 文档上做高亮时,KOReader 还会将高亮直接保存到 PDF 文档中,该功能在某些情况下非常实用。高亮会成为 PDF 文档的一部分,以便在其它软件或其它未安装 KOReader 的系统中查看。例如将包含高亮的 PDF 文档发送给他人后,对方无需安装 KOReader 即可阅读高亮,只需使用兼容高亮功能的 PDF 阅读软件打开即可。

该功能应适用于所有 PDF 阅读软件。我们已测试并确认下列软件可用:Adobe Acrobat Reader、Chrome Browser、Deepin Reader、Evince、Firefox Browser、Foxit Reader、Ghostscript、LibreOffice、Moon Reader、MuPDF、Okular、Xpdf、Zathura。

若进度同步插件被启用,保存 PDF 高亮将会修改文件,进而导致进度同步失败。若希望同时使用这两种功能,请将进度同步插件设置中的文档匹配方法选项从默认的二进制改为文件名:
关于 PDF 文档高亮功能的重要信息

要让高亮兼容其它阅读场景会相当费工夫;如果打算使用该功能,最好详细了解其工作原理以避免发生令人沮丧的情况。

简单总结:若希望 PDF 文档中的高亮还可删除或导出,需要在备份或复制文档到其它设备时连同文档关联的 .sdr 文件夹一并复制。若此文件夹丢失,KOReader 虽仍可查看已保存的高亮,但无法再对高亮进行编辑。请继续阅读下方章节进一步了解。


KOReader 中普通高亮的工作原理

当用户在 KOReader 中高亮文段,不管是在 EPUB 还是 PDF 文档中,这段高亮会被写入一个设置文件。例如在阅读 Alice in Wonderland.epub 时,在书籍文件所在目录会生成一个名为 Alice in Wonderland.sdr 的文件夹。高亮数据会存储到这个 .sdr 文件夹中的文件里。倘若这个与书籍关联的 .sdr 文件夹被删除,书籍中的高亮也会丢失。


KOReader 中 PDF 文档高亮的工作原理

PDF 文档的高亮功能与上述说明有所不同。如前所述,保存 PDF 高亮时,高亮数据会被直接写入到 PDF 文档中,成为文档的一部分。这就是为何该 PDF 被发送给其它用户后对方可使用兼容的 PDF 阅读软件查看高亮。对方无需获得包含了高亮记录的关联 .sdr 文件夹,因为高亮已被直接嵌入 PDF 文档中。

让我们通过一个例子来解释使用此功能时可能出现的问题。想象一下,你正在使用 KOReader 在电子阅读器上阅读 PDF 书籍:

  1. 若将高亮保存到 PDF 文档选项开启,KOReader 会在做下高亮的同时将高亮写入 PDF 文档。
  2. 你想继续用 KOReader 在你的手机上阅读这本书,所以你把这个 PDF 文件从你的电子阅读器复制到你的手机上(但是你没有复制 .sdr 文件夹,只有 PDF 文件)。
  3. 当用手机上的 KOReader 打开书籍,可以看到高亮仍保留在书籍中。

此时两处设备上的情况是一致的,电子书阅读器和手机上的 KOReader 都能查看 PDF 文档中的高亮。但两者仅是看起来一样,实际却有很大不同。

电子书阅读器上的 KOReader 知道此 PDF 文档中的哪些高亮是由 KOReader 添加的,因为它有关联的 .sdr 文件夹。但手机上的 KOReader 则不知道这些信息,它只能读取 PDF 文档。

在尝试删除或导出 PDF 高亮时差异就更大了。电子书阅读器上的 KOReader 即可删除也可导出高亮,但手机上的 KOReader 则不能。如前所述,它缺少文档关联的 .sdr 文件夹,所以它无法区分哪部分是高亮,而只能将高亮视作原文的一部分。

所以简单来说,如果打算之后导出 PDF 高亮,务必在备份或复制 PDF 文档到其它设备时将关联的 .sdr 文件夹一并复制。

7.4 导入 PDF 高亮

KOReader 可以从由其它 PDF 应用程序标注过的 PDF 文件中导入高亮。我们无法列出所有兼容的应用程序,但导入功能通常适用于常见的 PDF 阅读软件。

导入高亮的方法:

  1. 用 KOReader 打开你的 PDF 文件
  2. 从此处打开书签对话框:
  3. 点按左上角的 按钮。
  4. 在打开的对话框中,选择导入内嵌标注。你的高亮将被添加到书签列表中。

导入完成后,PDF 中的高亮将转换为普通的 KOReader 高亮。这意味着,你可以:

  • 为它们添加笔记
  • 更改它们的样式和颜色
  • 删除它们(参见下方说明)
  • 以各种格式导出它们

删除的原理: 导入高亮时,KOReader 不会修改 PDF 中原有的高亮,而是将导入的高亮作为一层叠加在原有高亮之上。因此,删除某条导入的高亮时,只会删除这新增的一层。PDF 文件中的原有高亮不会被删除,用其它阅读软件打开该 PDF 仍可看到原有高亮。

如果启用了将高亮保存到 PDF选项,删除某条导入的高亮时,PDF 文件中嵌入的高亮也会被一并删除。
7.5 使用 OCR

OCR(光学字符识别)是从图片中提取文本的过程。在 KOReader 上下文中,它通常用于从 PDF 文件中的扫描书页中提取文本。KOReader 依赖于 Tesseract 开源 OCR 引擎用于此任务。

要使用此功能,你需要:

  1. 安装 Tesseract 语言数据到你的 KOReader
  2. 将新安装的语言添加到 koreader/defaults.lua 配置文件(仅当你的语言不是英语或中文时才需要)
在 Tesseract 识别引擎的必要文件安装前,OCR 菜单中的各个按钮不会响应。详细的操作过程请前往维基页阅读。
8 阅读漫画
8.1 页面刷新间隔

漫画书一般需要比纯文本内容更频繁的页面刷新。对于普通文本,你可以毫无问题地将页面刷新间隔设置为一个很高的数字。但图片可能会留下更多残留并导致重影,这与你的电子阅读器的屏幕密切相关。

KOReader 允许将手势分配到不同的刷新率。例如,你可以在阅读漫画时设置向上滑动左边缘为每页刷新,并设置向下滑动左边缘为每 x 页刷新纯文本书籍。因此,当你打开漫画时,你可以通过简单的点击或滑动(反之亦然)切换到更频繁的刷新。

此操作位于:

8.2 区块放大

此功能使在较小的屏幕上阅读漫画书更容易。你可以在阅读 PDF、DJVU、CBZ 或 CBT 文档时启用它:

启用此选项后,KOReader 会尝试在屏幕上查找矩形面板的边界。如果长按面板,KOReader 会放大并仅显示该面板。

正如你所猜到的,此功能最适合具有干净窗格边界的漫画。此外,由于这个边界问题,在这种模式下无法翻页跳转到下一个窗格。你必须关闭放大的窗格,然后长按下一个窗格进行放大。要做到这一点,只需向下滑动这个放大的窗格。此外,你还可以使用任何多重滑动手势(上、下、左、右的任意组合)来退出此视图。

过程可以在下面看到:

如果要将此功能用于 EPUB、FB2、HTML 或图片文件等其他文件类型,则应使用其他引擎打开该文件:在文件浏览器中长按文件名,点按打开方式,并选择 MuPDF。

8.3 转到下一文件

当翻到书籍尾页,KOReader 将显示一个对话框,其中的开启下一本书籍操作将打开当前书籍所在目录中名称排序挨着的另一本书。因此将一套丛书放进同个文件夹可以一本接一本顺序阅读,无需返回文件浏览器操作。

打开下一个文件时,KOReader 会跳过标记为已阅读的文件。这个功能是有用的,例如当你有一个文件夹的漫画文件,你已经读了其中的一些。你可以从上面所示的书籍结束对话框中将文件标记为已完成。也可以在文件浏览器上标记它,长按该文件。将它们复制到你的设备后,你可以:

  • 在 KOReader 中打开文件浏览器
  • 长按你已经读完的书,然后点击标记为已读

现在,你只需点击本书末尾的打开下一个文件即可读取所有文件。KOReader 会跳过你已经读过的那些书籍。

8.4 优化漫画

对喜欢在电子墨水屏设备上阅读漫画的用户,下面有一些提升阅读体验的小技巧。若漫画在设备上的呈现方式不尽如人意,对漫画书文件进行预处理是最佳解决方案。

使用哪种文件类型

MOBI 和 EPUB 等文件类型不适合主要处理图片内容(例如漫画/漫画)。KOReader 中的 MOBI 支持几乎为零,而 EPUB 的文本渲染优先级在显示整页图片时可能会导致问题。有关更多技术细节,请访问对应 GitHub 工单。

最好的选择是创建一份在 KOReader 中效果更好的 CBZ 格式文件。.cbz 扩展名的文件本质上是将未压缩处理的图片集打包而成的 ZIP 压缩包,内含通常为 .png 或 .jpeg 格式、按照漫画页码排序的多个图片文件。KOReader 也支持打开 CBT 格式文件,它与 CBZ 相似,区别是使用 TAR 格式打包。

将漫画转换为 CBZ 的最简单方法是从各种网站获得漫画图片,然后使用 Kindle Comic Converter 转换它们。有一些有用的设置,如自动将跨页双页旋转为横向并应用抖动,使墨水屏渲染的渐变平滑抖动,没有锯齿层。

使用哪种分辨率

通过将图片大小调整为电子阅读器屏幕尺寸,可以获得最佳效果。特定于屏幕的 CBZ 针对设备的确切屏幕尺寸,可防止在读取期间重新缩放。KOReader 在阅读时将图片缩放到屏幕尺寸,但不建议这样做,因为 KOReader 在缩放之前添加了抖动通道,这会导致质量损失。

但是,如果你想在多台设备上使用手工制作的 CBZ,或者你想保留高分辨率以备将来使用,那么最好的选择可能是为你的最高分辨率设备制作 CBZ。或者选择可能与源分辨率匹配的"高"分辨率。300 PPI 或更高(450 甚至 600),当然,除非来源较低。我们假设屏幕尺寸为8",1500×2000,这是一个不错的目标分辨率。对于较大的图片,你应该在你的设备上尝试一下,看看它是否可以处理它。例如,内存不足的旧 Kindle 可能会难以处理 3000×4000 等大小。如果你要自动化该过程,则可能需要考虑创建较低和较高质量的两个版本(例如 200/400 或 300/600 DPI)。

KOReader 不会解析书籍的 spine page-progression-direction="rtl" 参数,因此即使书籍指定了从右向左阅读,软件中的翻页方向也不会改变。用户可通过下列路径手动切换:
对漫画书籍进行高阶预处理

以下是处理一个漫画文件的示例过程:

  • 下载 Kindle 漫画转换器(KCC)(链接https://github.com/ciromattia/kcc)
  • 从你选择的来源下载你的漫画(如:HakuNeko)
  • 解压漫画文件。现在,你应该有一个仅包含图片的目录(或包含图片的子目录,没有存档)
  • 使用 KCC 软件处理这个文件夹,每个文件夹将被打包为单个 .cbz 格式文件。若要一次性制作多卷漫画书籍,请同时选中多个文件夹

KCC 的一些有用设置:

跨页分割器:此功能可检测双页,并允许你将其旋转或切成两半。

放大:放大比目标分辨率小的图片。

8.5 漫画相关的其它技巧
消除彩色电子墨水屏上的彩虹纹

受彩色电子墨水屏技术所限,阅读带有细密阴影或网点的黑白漫画时,可能会看到类似彩虹的彩色伪影。如果遇到此问题,可以用一款名为 Derainbowify 的 KOReader 插件解决。详细信息和安装说明见该插件的 GitHub 页面。

KOReader 中的沉浸式模式

如果你想以更身临其境的方式欣赏你的漫画,请确保在创建 CBZ 文件时,你在 KCC 中选择了与设备屏幕分辨率完全相同的分辨率。你还可以在 KOReader 中阅读漫画时隐藏底部进度条。因此,你将获得一个无障碍的沉浸式全屏漫画视图。

让渐变更平滑的额外步骤

使用 KCC 创建 CBZ 文件后,你可以对图片应用额外的抖动。这样,e-ink 渲染的渐变将平滑抖动,没有锯齿层。这一步将制作出在 KOReader 中看起来更好的微调漫画卷。

你可以使用 ImageMagick 来处理你的图片。ImageMagick 是一个功能强大的开源软件套件,用于显示、创建、转换、修改和编辑光栅图片。你可以下载 ImageMagick,并从命令行使用它一次处理多个图片。

  1. 解压缩CBZ文件,即之前用KCC创建并准备好的那份,
  2. 下载以下文件 dither_pack.zip(位于 Yandex Disk 上),其中包含两个批处理文件(.bat)和一个 GIF 颜色模板。
  3. 将这个三个文件放到你要处理的图片旁边
  4. 编辑 _magick_manga_ditherN_resize.bat,并将分辨率更改为你的设备分辨率(在 bat 文件的两个位置)。
    下一项操作将会使目录中的图片被替换为处理后的版本。若想保留原件,请确保这些文件已在别处存有副本。
  5. 运行 _magick_manga_ditherN_resize.bat 调整图片大小和抖动。
  6. 假设你安装了 7-Zip,运行 _batch_archive.bat 将所有处理过的图片打包到 CBZ 文件中。
反转翻页方向以还原正宗日本漫画

你可以让 KOReader 从左向右翻页,这样滑动和点击区域就会互换。要启用此功能,请添加以下行:

["/storage/emulated/0/Books/manga"] = {
["inverse_reading_order"] = true,
["kopt_zoom_direction"] = 0,
},

到此文件:

/koreader/settings/directory_defaults.lua

其中 /storage/memulate/0/Books/manga 是包含漫画的目录的绝对路径。更改后,当你从上述目录打开文件时,你的滑动和点击区域将被交换。

9 管理藏书库
9.1 文件浏览器使用情况

当你第一次运行 KOReader 时,你将看到文件浏览器界面。它是 KOReader 的两个主要窗口之一。你将在此处执行所有文件和文件夹操作。你可以通过以下方式从阅读屏幕访问它:


默认情况下,文件浏览器显示你的首页文件夹,这是你的主库文件夹。你可以通过长按任何文件夹来更改此设置。你可以更改文件浏览器的许多选项,例如通过顶部菜单从屏幕顶部向下滑动书籍的显示或排序方式。

图片中带圆圈的项目说明如下:

重置:该选项可以重置书籍的部分数据,如阅读进度、书签、自定义封面等,具体可在展开的对话框中选择。

使用重置对话框时请务必谨慎操作,认真复核哪些项目已被勾选,否则可能会意外重置书籍全部数据。

打开方式:KOReader 有不同的引擎来渲染不同的文件类型。在某些情况下,你可以在不同的引擎中打开文件以获得其他一些功能。请参阅下面的查看存档文件和查看图片文件部分。

忽略封面:如果由于某种原因你想禁用这本书的封面(它可能有错误的封面或封面在电子墨水屏幕上显示的不清晰),你可以选择这个。

忽略元数据:如果你的书籍元数据不正确,名称字段可能会显示无用的信息。选择此选项可显示文件名而不是元数据。

刷新缓存的书籍信息:KOReader 在将书籍的元数据和书籍封面添加到库中时缓存书籍的元数据和封面。如果你在复制到设备后对书籍进行了一些更改,则可能需要更新此信息。如果你看到错误的封面或元数据,则可以使用此菜单项刷新书籍信息。

在文件浏览器中显示隐藏的文件和目录

通常,KOReader 的文件浏览器不显示以下两类文件和目录:

  1. 隐藏的文件和目录: 指以点号(.)开头的文件和目录,例如 .screensavers。如果想看到这些目录和文件,请启用下列选项:
  2. 不支持的文件类型: 指 KOReader 无法直接打开的文件类型,例如扩展名为 .ttf 的字体文件。KOReader 可直接打开以下文件类型:PDF、EPUB、DJVU、MOBI、CBR、CBZ、CBT、DOCX、RTF、HTML、HTMLZ、TXT、XPS、FB2、PDB、CHM 和 MD 文档类型,以及图片文件和 ZIP/RAR 压缩包,因此 文件浏览器中只显示这些文件。如果也想看到不支持的文件类型,请启用下列选项:
操作多个文档

文件浏览器可同时对大量文件执行诸如复制、移动、删除和导出高亮的多种操作。要使用该功能,首先要选择对应的文件。文件浏览器当前提供了三种进行批量操作的方式:

- 第一种方式:在文件名上长按,从弹出对话框中选择多选。此时将进入连续选择模式。点按其它文件使其被选中,然后点按对勾图标(位于屏幕右上角)。在弹出对话框中可选择要对这些文件执行的操作,或者退出连续选择模式。

- 第二种方式:点按加号图标(位于屏幕右上角),从弹出对话框中选择选择多个文件。此时将进入连续选择模式,接下来的操作与第一种方式相同。

- 第三种方式:通过文件搜索功能筛选书籍。该方式可十分高效地处理分散于多处目录的多本书籍。例如,要将书单中所有作者是托尔金的书籍移至同个文件夹,请按下列步骤操作:

  1. 从顶部菜单按搜索选项卡(带有放大镜图标)并选择文件搜索。
  2. 如果你也想在文件夹中搜索,请选中包含子文件夹选项。如果你想让 KOReader 在搜索书籍的元数据,你可以选择搜索书籍元数据。否则,KOReader 只会搜索文件名。
  3. 你可以通过按相应的按钮从库主文件夹或当前文件夹开始搜索。
  4. 在执行检索后,将列出符合条件的文件列表(若存在关键词匹配的结果)。现在可点按汉堡菜单(位于屏幕左上角),进入连续选择模式。
  5. 点按所有要处理的文件,然后点按对号图标(√)。该图标位于屏幕左上角,点按后会弹出对话框,其中包含在文件浏览器选择选项。选择该选项。
  6. 现在,你将回到文件浏览器,你在搜索对话框中选择的文件也将在此处选择。
  7. 点按对号图标(√),它位于屏幕右上角。现在可从弹出的对话框中选择要对这些文件执行的操作。
文件夹快捷方式

KOReader 允许你将最喜欢的文件夹添加到快速访问的文件夹快捷菜单中。例如,如果你的库中有一个 Archive 文件夹,位于 Home>Articles>Scientific>Archived 下,你可以为这个 Archived 文件夹分配一个文件夹快捷方式,即使在阅读书籍时也可以快速访问它。

添加文件夹快捷方式:

有两种方法可以将文件夹添加到文件夹快捷方式列表中:

  1. 当你在文件浏览器中时,点击右上角的+(附加)菜单按钮,然后点击添加到文件夹快捷方式项,并为此快捷方式输入描述性名称。这将添加你当前所在的文件夹
  2. 在文件浏览器中,长按文件夹名称可打开上下文菜单。点击添加到文件夹快捷方式项,然后为此快捷方式输入一个描述性名称。这将添加你按下的文件夹

文件夹快捷方式列表中的文件夹会显示星号(★)标记,这一标记出现在文件浏览器中。

你可以以相同的方式从快捷方式中删除文件夹,方法是长按文件夹并选择从文件夹中删除快捷方式。


查看文件夹快捷方式:

你可以在阅读书籍时从文件浏览器或阅读屏幕打开文件夹快捷方式。

  • 从文件浏览器:右上角+(附加)菜单,然后选择文件夹快捷方式或指定手势。
  • 从阅读屏幕:通过为其分配手势。

它位于手势管理器的文件浏览器部分。你可以在本指南的相关部分学习如何设置手势。

9.2 浏览其它格式的文件
查看文本文件

如果你有 .txt 格式的书籍(在中文和西里尔文语言中更常见),你可以尝试启用自动检测 txt 文件布局功能。在某些情况下,它可以改善渲染效果,使文本更"像书"。启用后,渲染引擎将使用启发式方法(文本被包裹在一些最大行长下,标记段落的单行或双空行,缩进或被视为标题的居中文本…)来猜测如何更好地渲染文本,并尝试创建一个目录。

你可以在此处启用此功能(仅当你正在读取 .txt 文件时才可见):

请注意,此功能可能会弄乱 ASCII 艺术绘图和基于空格字符的格式。如果你的书籍具有这些功能,最好使用默认模式,在该模式下,文本文件以等宽字体按原样呈现。

查看存档文件

KOReader 可以读取存储/压缩在 ZIP 压缩包中的文件。你可以使用存档查看器打开 ZIP、CBZ 和 EPUB(因为它们也是 ZIP 压缩包)文件以查看包含的文件:

  1. 在文件浏览器长按文件名
  2. 点击打开方式…
  3. 点击存档查看器

ZIP 压缩文件可以包含多种类型的文档,如 HTML、TXT 或图片。只有当你提示 ZIP 压缩包中的文件类型时,KOReader 才能正确打开你的 ZIP 压缩包。如果你只给文件一个 .zip 扩展名,KOReader 将假定该压缩包仅包含图片,并尝试像 CBZ 文件一样打开它。

默认情况:文件名.zip,假定为图片的 ZIP 压缩包(并由 MuPDF 引擎打开)

如果你的 ZIP 压缩包含这些类型之一(而不仅仅是图片),请相应地命名它:

  • FB2格式(FictionBook) - 文件名.fb2.zip
  • HTML - 文件名.htm.zip / 文件名.html.zip
  • 文本日志文件 - 文件名.log.zip
  • Markdown 文件 - 文件名.md.zip
  • 富文本格式 - 文件名.rtf.zip
  • 纯文本 - 文件名.txt.zip

如果文档没有这样命名,则可能使用了错误的读取器/格式引擎,你将看到此文件没有读取器引擎或文件无效消息。你可以按照上述说明重命名此文件,也可以长按文件名,然后选择打开方式…选择正确的引擎。

查看图片

你可以使用图片查看器打开图片文件,而不是作为书籍打开。像这样打开的文件不会出现在你的历史记录中,并且具有更好的缩放和旋转支持。

  1. 在文件浏览器长按文件名
  2. 点击打开方式…
  3. 点击图片查看器
查看 Markdown 文件

KOReader 提供了两种读取 Markdown 文档的选项。

  1. 你可以通过点击它直接打开文档就像一本书。此模式不提供格式设置。所以你的 .md 文件看起来就像在文本编辑器中打开一样。
  2. 你可以将 Markdown 文档转换为 HTML。此操作将呈现具有正确格式的 Markdown 文档中的 HTML 文件,并根据标题创建目录。

要转换 .md 文件,请在文件浏览器中长按该文件,然后从弹出菜单中点击转换按钮。将在同一目录中创建一个同名但扩展名为 HTML 的新文件。请注意,转换可能需要一段时间,具体取决于你的 Markdown 文件和设备速度。

设置文件关联

你还可以为 KOReader 无法自动识别的文件类型设置文件关联。要将文件与 KOReader 提供程序之一相关联,请首先在文件浏览器中长按你的文件,然后选择一个提供程序引擎来处理此文件。你可以选择:

  • 始终对此文件使用此引擎仅将此提供程序与此特定文件相关联
  • 或者选择始终对文件类型使用此引擎,将此提供程序与所有与此提供程序具有相同扩展名的文件相关联
  • 在同一对话框中,你可以通过点击查看默认文件类型来查看所建立的关联
9.3 书单

KOReader 的书单功能可以让个人书库的管理更加高效。简单来说,书单就是由用户创建的书籍清单。例如可以创建标题分别为文学和非文学的书单,将对应的书籍编入其中。当然按文件夹存放书籍也可实现类似目的,但书单用起来更加灵活。

使用书单整理书籍相比文件夹的一些优势:

  • 将书籍编入书单并不会移动书籍文件位置,因此存放在不同文件夹中的多本书籍可以被编入同一份书单。
  • 同一本书可以被编入多份书单,这很难通过文件夹实现。例如,一本书可以同时被编入科幻题材书单和战争文学书单。
  • 配置文件 可以应用于书单。如果对 KOReader 的配置文件功能不熟悉,请查阅下文说明。(当然,配置文件也可应用于文件夹,但书单无需移动书籍文件即可临时套用配置文件。)

用户可创建多份书单来对应各种书籍分类方式,例如:

  • 作品体裁:虚构文学、非虚构文学、报告文学等。
  • 阅读状态:在读、想读、已读、搁置等。
  • 丛书:《指环王》、《哈利·波特》等。
  • 文档类型:书籍、科研论文、网页等。
创建并编辑书单

若要创建书单,请按照下列路径找到书单对话框:

该对话框可在阅读视图或文件浏览器中使用。打开时菜单会列出现有书单。默认情况下将显示一份标题为收藏的书单,其中包含已被添加到收藏列表的书籍。

  • 创建新书单:点按屏幕左上角的汉堡状菜单键 ⇨ 点按创建新书单
  • 删除书单:在书单标题上长按 ⇨ 点按删除该书单
  • 修改书单标题:在书单标题上长按 ⇨ 点按修改书单标题
  • 更改书单顺序:点按屏幕左上角的汉堡状菜单键 ⇨ 点按书单排序
将书籍添加到书单

有三种方式可以将书籍添加到书单中:


一、通过文件浏览器及历史记录视图

可以在文件浏览器或历史记录视图中将书籍添加到书单。历史记录视图下可将书籍逐本添加到书单中。在书籍上长按,选择书单…,然后可以选择将该书添加到一份或多份书单中。

若要一次性添加多本书籍,请在文件浏览器中按照下列方式操作:

  1. 长按某本书
  2. 在弹出菜单中点按多选
  3. 选择其它书籍
  4. 点按右上角的对号(✔️)图标
  5. 点按书单

要添加单本书籍,只需在文件浏览器中长按该书,在弹出菜单中选择添加到书单。


二、通过书单管理菜单

该方法可以将一本或数本书籍添加到书单中。与在文件浏览器中操作不同,这种方法可以将整个文件夹及下层文件夹内的全部书籍一次性添加到书单。如果书籍文档已经按照文件夹分类,该方法将十分高效。例如,如果全部科幻类书籍都在同一个文件夹内,可以创建标题为科幻题材的书单,然后将该文件夹添加进去。

如上图所示,方框 1 标出了添加书籍选项。该菜单可点按当前书单的汉堡状菜单键呼出:

  • 将整个文件夹加入书单:如选项标题所示,该选项可以将所选文件夹中的全部书籍一次性编入当前书单。请注意,所选文件夹的次级文件夹中的书籍不会被添加。例如,用户选中名为虚构作品的文件夹,其中包含名为科幻作品和战争文学的两个次级文件夹,这两个次级文件夹内的书籍不会被添加到当前书单中。
  • 将所选文件夹及次级文件夹中添加到书单:该选项会将所选文件夹的次级文件夹一同加入书单,使用时应当谨慎,因为该功能会遍历所选的文件夹目录。若其中包含多个目录层级,添加的书籍数量可能会远超用户预期。
  • 添加书籍到书单:该选项可以将单本书籍添加到当前书单。
从书单中移除书籍

可以通过文件浏览器、历史记录视图或书单将书籍从书单中移除。在文件浏览器和历史记录视图中长按书籍,选择书单,可以看到书籍所属的书单标题前有勾选标记。点击该标记取消勾选即可将书籍从对应书单中移除。另外在书单界面长按书籍选择从书单中移除也可实现相同操作。

给书单中的书籍排序

书单可能十分冗长,因此 KOReader 提供多种筛选方式以便更容易地找到要读的书籍。如前图所示,方框 2 和方框 3 标出了书籍筛选选项。方框 2 可以按照书籍阅读状态(未读、在读、已读、搁置)筛选;方框 3 可以通过书籍元数据(作者、丛书、语种、关键词)筛选。两种筛选方式还可组合使用,你也可以像这个例子一样组合这两组过滤器:"向我展示这份书单中 Isaac Asimov(按作者 -> Isaac Asimov)编写的我还没有开始阅读的新书(按状态 -> 未读)。"

在文件浏览器中长按某本书,可以更新书籍元数据或查看书籍信息。在弹出的对话框中长按任意项,可以编辑作者或关键词等书籍元数据。该操作也可通过 Calibre 完成,这是一款便捷管理书籍元数据的第三方软件。

请注意,Calibre 会改写书籍内部的元数据,因此将文件从 Calibre 中导出后,修改过的元数据仍然有效;但 KOReader 不会修改书籍文件,而是将自定义的书籍元数据以独立文件的形式存储于与书籍关联的 .sdr 文件夹中,因此这些改动的元数据仅可使用 KOReader 查看。
在书单中检索

在书单中有两种不同的搜索操作:在书名及元数据检索关键词,或者在书籍内文搜索。搜索对话框可通过下列路径呼出:

在检索书籍全文时有以下几点需要注意:

  • 这种搜索仅在通过文件浏览器打开书单时才可用,在阅读视图下不可用。
  • 这种搜索可能非常缓慢(书单中的每本书大约耗时 2 秒),如果书单很长,搜索耗时将会非常久。

搜索功能会因当前所处的书单窗口层级而不同。当处于浏览全部书单的根目录视图下,搜索范围将包含全部书单。若要在特定书单内搜索,请点按进入该书单后再执行搜索操作。如果同时检索了书籍内文,这种区别将十分关键,因为那是一项颇为耗时的操作。

执行一次搜索操作后,搜索结果将自动生成一份新书单。

根据文件夹自动更新书单

在创建书单并添加书籍后,用户可能希望书单可以与文件夹内容保持同步。例如,用户使用科幻文件夹存放所有科幻作品,并用它创建了一份科幻题材书单。如果希望在向该文件夹中添加文件后,科幻题材书单可以自动更新,可以使用书单的关联文件夹功能。

该功能可以将一个或多个文件夹关联到书单,KOReader 将在下列几种情况下重新扫描这些文件夹,以便将书籍文件的变化反应到书单中:

  • 为书单添加关联文件夹后
  • 向关联文件夹中添加了次级文件夹
  • 查看该书单时
  • KOReader 启动时

将文件夹关联到书单的方法:

  1. 前往如上图所示的书单列表界面。
  2. 长按想要关联到文件夹的书单标题①。
  3. 在弹出菜单中选择关联文件夹②。
  4. 此时会显示已关联的文件夹列表。
  5. 点按屏幕左上角的加号图标,在弹出的选择文件夹窗口中选择要添加的文件夹。
  6. 重复最后一步以添加多个文件夹。

如上图所示,关联了文件夹的书单标题右侧有一个文件夹图标③。

为了同步功能的正常执行,最好连同次级文件夹也一并添加。在上面的第四步,在打开已关联的文件夹列表中长按某个文件夹,在弹出菜单中选择包含/排除次级目录。


将书单与文件夹断开关联的方法:

  1. 前往如上图所示的书单列表界面。
  2. 长按想要关联到文件夹的书单标题①。
  3. 在弹出菜单中选择关联文件夹②。
  4. 此时会显示已关联的文件夹列表。
  5. 长按想要断开关联的文件夹,在弹出菜单中选择断开文件夹关联。
将配置文件应用到书单

书单可配合 KOReader 的配置文件功能使用。如果对配置文件功能不了解,下面是取自配置文件一节的介绍:

配置文件本质上是一套操作集合(就像宏命令),可通过单个手势触发。

例如在阅读某种类型的书籍时总会应用如下设置:

  • 将屏幕切换到横向显示模式
  • 增大字号并提高对比度
  • 打开屏幕前光

借助配置文件插件,只需执行单次操作即可完成这些调整。

配置文件可以手动套用,但自动套用特性才是该功能的强大之处。该特性可以在指定情况下自动套用特定配置文件,请点击自动套用配置前往对应章节了解。此处仅介绍在书单中自动套用配置的功能。

简单来说,用户可以创建若干套配置文件,并且在打开特定书单中的书籍时自动套用。一些示例:

  • 将所有漫画书添加到漫画作品书单,创建一套配置文件在打开该书单中的书籍时自动套用,将翻页方向改为从右向左并交换左右两侧的点按和划动翻页操作。
  • 可以将漫画书添加到套用配置的书单,阅读时将页面刷新间隔降低到逐页刷新以避免残影。
  • 可以将有问题的 PDF 文档编成一份书单,在阅读这些文档时套用配置文件触发自动 OCR 或者启动页面重排模式。
9.4 优化文档

KOReader 的设计目标是在电子书阅读器有限的硬件条件下也能高效运行。但总会遇到格式糟糕、拖慢 KOReader 的文档。下面将按文件类型给出一些优化文档的建议。

EPUB 文件
  • EPUB 文件基本上由文本和图片组成,并带有一些规则来确定这些项目在屏幕上的格式。在理想情况下,这是一个相当简单的过程,因此 EPUB 文件在 KOReader 中通常速度很快。但是一些 EPUB 书籍添加了大量格式规则,KOReader 必须进行许多计算才能显示哪怕是一个句子。这将减慢打开书籍、翻页和更改外观属性(如字体粗细或行间距)的速度。
    KOReader 不支持固定版式 EPUB 文档。这类文档仍可在 KOReader 中打开,但会作为可重排 EPUB 渲染,版面可能会错乱或难以阅读。
  • EPUB 文件格式本质上是包含 .html 文件的 ZIP 压缩包。有的书籍仅包含单个 .html 文件,而有的则由多个 .html 文件构成,比如每一章节都被拆分为了独立的 .html 文件。如果当前书籍仅包含单个 .html 文件,分段渲染功能就无法启用,因此样式调整会比章节拆分的书籍更慢,因为每次调整 KOReader 都需要对整本书籍进行处理,而不是仅渲染当前章节。
  • 另一种罕见的缓慢情况是内容被包装在 HTML 表格标签中。KOReader 必须在每次翻页时渲染/绘制每个单元格,因此如果一个单元格(包含许多段落)跨越 50 页,这将使翻页速度非常慢。有关解决方案,请参阅下文。

解决方案:

  • 你可以在底部菜单中将内置样式设置为关闭,看看忽略所有文档样式表是否会使其更快(当然,你可能会丢失任何漂亮的格式,但你会知道罪魁祸首是什么)。
  • 如果你具备 HTML 和 CSS 知识,你可以直接从 KOReader 检查 HTML 和 CSS 文件,并自行判断它们的质量或不必要的复杂性。为此,你可以长按某些文本并在弹出菜单中选择查看 HTML。
  • 如果你有上面问题部分提到的"内容包装在表格中"的问题,你可以将这个 table, tr, td { display:block; } 仅本书样式调整添加到:
  • Calibre 的电子书编辑器可以检查 EPUB 文件是否存在问题,并具有修复某些问题的工具。

    Calibre 可从其项目页面下载。

    书籍检查工具的使用说明可以在 Calibre 的使用指南中查阅。

  • EPUBCheck 软件可用于检查 EPUB 文档的有效性并侦测多种类型的错误。可参阅这条使用 EPUBCheck 检测问题的示例工单。

    命令行版本可通过该链接下载。

    带图形化交互界面(GUI)的版本则可通过此链接下载。

PDF 文件

PDF 文件可能因以下问题而变慢:

  • PDF 文件本身对于你的设备内存来说可能太大。
  • PDF 文档可能内嵌大尺寸图片文件。即使带有正常文本层的文档(可选中并高亮),仍可能叠加了另一个图片层(页面的整体扫描件);这会拖慢文档打开及翻页速度,因为大尺寸图片需要被压缩到屏幕尺寸以供显示,而该过程非常消耗 CPU 算力。
  • PDF 文件可能包含许多需要精确定位的单个元素,例如包含大量图片和文本框的杂志页面。在这种情况下,KOReader 必须计算和绘制所有这些元素,这可能需要时间。
  • 自动校直功能(允许你调整页面的倾斜)也可能会减慢你的阅读器速度。
  • 如果你将渲染质量设置为高质量,而重排是开启,文本将更令人愉悦,但它可能比默认慢得多(每页翻几秒钟),具体取决于你的文档。

不幸的是,对于糟糕的 PDF 文件,没有太多解决方案。通常,处理有问题的 PDF 最好的办法是尝试找到更好的版本。或者,如果有其他文件类型可供下载,例如用 EPUB 代替 PDF(或反过来),也可以尝试该格式。

你也可以尝试把文档转换为更灵活的 EPUB 格式。以下几款软件可在处理 PDF 时提供帮助:

  • Calibre 可以将文档转换为多种格式。它的内置编辑器还可直接修改 EPUB 和 Kindle 等常见电子书格式并修正文档错乱。
  • K2pdfopt 可以为便携阅读设备及手机改善 PDF 和 DJVU 文档。该软件可以对分栏的文档进行编辑,甚至对扫描版 PDF 文件进行文字重排。同时,它可以作为一款通用的 PDF 复制、裁切、调整大小、OCR 等的编辑软件。
  • OCRmyPDF 是一款为扫描版 PDF 文档添加 OCR 文本层的命令行软件,使处理后的文档可以检索及复制粘贴。在阅读扫描版旧书时格外有用。它也可用于压缩图片文件大小。
漫画与漫画书

我们设有专门介绍漫画优化的章节:优化漫画

TEXT 文件

KOReader 拥有非常高效的文本处理引擎,并且会在首次打开书籍时将其缓存,以便下次更快打开。但即便有这些优化,异常庞大的文本文件仍可能耗时更久才能打开。例如,网络上的中文小说动辄数千万字,且通常保存为文本文件。

大型文本文件的问题在于首次渲染书籍以及后续修改文字外观时的延迟。若尝试修改一本非常大的 .txt 书籍的字号,每次调整后都可能明显卡顿,因为整本书都要重新渲染。KOReader 带有分段渲染机制,可大幅缩短此类延迟。但该功能无法用于文本文件,因为这类文件没有按章节拆分(关于分段渲染的更多说明见此处)。

若要享受分段渲染带来的提速,可把大型文本文件转换为 EPUB 格式,方法是使用 Calibre 软件。Calibre 会在转换时自动把文本文件切分为多个较小的独立文件,并打包成标准的 EPUB 文件。转换完成后,更改书籍外观的速度会快得多。可从 Calibre 的页面下载,并查找有关TXT 转 EPUB 操作的在线教程。

网页

SingleFile 是一款适用于 Mozilla Firefox、Google Chrome 及 Microsoft Edge 的浏览器插件。这款插件可以将网页包含的图片、样式表和脚本等打包保存为单个 .html 文件。之后可将这一个文件复制到设备上,用 KOReader 阅读。

9.5 使用 OPDS 书目

OPDS(开放出版发行系统)书目是一种在线信息源,相当于数字图书馆的索引。KOReader 支持 OPDS,因此你可以浏览这些数字图书馆、在其中检索书籍,并把书籍直接下载到设备上。

KOReader 预置了一些大型 OPDS 书目,例如古腾堡计划和Standard Ebooks,你也可以添加其他 OPDS 书目。要打开 OPDS 对话框,请前往:

使用个人 OPDS 服务器

除公共书目外,你还可以用 OPDS 管理自己的书库。借助 Calibre 软件,可以把电脑上的书籍作为 OPDS 书目提供出来,并直接在 KOReader 中浏览。点击此处可查看 Calibre 关于配置 OPDS 服务器的说明。

Kavita 也是一款开源、功能丰富且跨平台的阅读服务器。你可以搭建自己的服务器,与亲友共享藏书。它还为 KOReader 提供 OPDS 和进度同步支持。借助该软件,你可以从阅读设备访问书库,并在不同设备间同步阅读位置,以便从上次中断处继续阅读。项目页面见此处。面向 KOReader 用户的 OPDS 和进度同步文档见此处。

搭建好自己的 OPDS 服务器后,还需将其添加到 KOReader。操作说明见此处。

9.6 同步阅读进度

如果你在电子书阅读器、手机、平板或台式机等多个设备上使用 KOReader,它可以在这些设备之间同步阅读进度。借助进度同步功能,例如从家里的阅读器切换到通勤路上的手机时,也能无缝续读。

该功能由进度同步插件负责。同步的设置包含以下三个步骤,下面逐一说明:

  1. 创建同步账号
  2. 在希望同步的所有设备上登录你的同步账号
  3. 自动或手动同步阅读进度
1. 创建同步账号

要创建同步账号,请先让设备连接网络,然后打开 KOReader 中的进度同步插件:

然后点按注册/登录按钮。

在弹出的窗口中输入用户名和密码,然后点按注册按钮。这会在 KOReader sync server 上创建一个账号,用于保存你的阅读进度。

2. 登录同步账号

在希望同步的设备上打开同一菜单,输入用户名和密码,这次点按登录按钮。之后,这些设备就会连接到你的同步账号。

你可以为设备设置便于辨识的名称。同样在该菜单中,点按设备主机名,为当前设备输入一个名称。

3. 同步阅读进度

全部设置完成后,即可自动或手动同步阅读进度:

  • 自动同步:要自动同步,请启用自动同步文档菜单项。此后每当关闭书籍或休眠/唤醒设备时,KOReader 都会把阅读进度发送到服务器(当然这需要可用的网络连接)。
  • 手动同步:如果设备因省电或网络条件无法持续联网,可选择手动同步。触发同步的方式有很多种:
    1. 通过菜单:在进度同步插件的菜单中,点按立即上传本设备的进度菜单项,可把当前设备的进度发送到服务器;点按立即从其他设备拉取进度菜单项,可获取服务器上的最新进度。
    2. 通过手势:这些操作(推送/拉取进度)可在手势管理器中找到,你可以把它们指定给任意喜欢的手势。
    3. 使用快捷菜单:你可以将这些操作添加到快捷菜单中。
    4. 通过配置文件:你可以把这些操作添加到配置文件中。尤其配合配置文件的自动执行功能,还能用各种筛选条件触发同步。
文档匹配方法选项

要在两台不同设备上同步某个文档的进度,KOReader 首先必须判定这两个文件是「同一个」。有时这并不容易,因此提供两种方法供你根据使用习惯选择。可在文档匹配方法选项中更改,它位于进度同步菜单内。


二进制匹配(默认)

默认情况下,进度同步使用二进制匹配方法来识别文件。此方法会为文件内容生成一段部分 MD5 哈希(形如 0b229176d4e8db7f...)。文件哪怕只有极小的改动,也会彻底改变这段哈希,因此二进制匹配方法只在两个文件完全一致时才有效。

如果你手动把完全相同的文件复制到所有设备,这种方法应该可行。但如果用 Calibre 向设备发送书籍,二进制匹配就会失效。

因为 Calibre 会把自己的信息(如阅读进度)直接写入文件,从而改变文件哈希的计算结果,KOReader 就会把这两个文件(原始文件与经 Calibre 修改的文件)当成两本不同的书。若遇到这种情况,可改用下面介绍的替代方法。


文件名匹配

这是一种「更宽松」的匹配方法,专为那些文件在不同设备间可能略有差异的用户设计——如上文所述,Calibre 等软件对文档的修改会造成这种差异。

在此方法下,KOReader 只检查两份文档的文件名(含扩展名)是否相同,以此判定匹配。因此,如果你使用 Calibre 或其他书库管理软件跨设备管理书库,可以改用文件名匹配。

你也可以查阅本指南的书籍元数据存储选项一节,了解更深入的信息。
同步过程的隐私与安全性
  • KOReader sync server 是负责处理 KOReader 同步流程的软件,属于开源项目。你可在其GitHub 页面查看更多信息及源代码。
  • 同步服务器不存储文件名或文件内容。也就是说,服务器无法知道你在读什么。同步某个文档的进度时,只有以下信息会被传输并保存在服务器上:
    1. 用户名(由你自己选定)
    2. 文档的唯一标识(文件的 MD5 哈希,形如 0b229176...)
    3. 本文档的最远阅读位置
  • 你的密码不会存储在服务器上(仅保留其 MD5 哈希)。
  • KOReader 与同步服务器之间的所有通信均通过 HTTPS 加密保护。
自行托管同步服务器

如果愿意,你也可以自行托管同步服务器。既可使用官方的KOReader sync server,也可选择本页面列出的替代方案。

此外还有 Calibre-Web 等项目,它们是集成了 KOReader sync server 的书库管理方案。

9.7 书籍元数据存档

我们先说明 KOReader 的文件删除行为,以便你更好地理解书籍元数据存档功能:

通常,当你把文档复制到设备并首次打开时,KOReader 会新建一个名称类似 your_document_name.sdr 的目录,用来保存该文档的设置、标注和阅读进度。

当你使用 KOReader 的文件浏览器删除文档时,KOReader 也会一并删除这个 .sdr 目录。这意味着该文档的所有设置、标注和阅读进度都会丢失。如果之后再把这份文档复制到阅读器并用 KOReader 打开,就等同于第一次打开它。

但举个例子:如果你想删掉已读完的书(也许是不想让书库杂乱,或者存储空间不足),却又不想丢失这些书里的高亮,该怎么办?书籍元数据存档功能就能帮你做到。


此功能的工作原理:

  1. 首先需要在下列位置选择一个存档位置以启用该功能:
  2. 此后,当你从文件浏览器删除文档时,确认对话框中会出现已启用的该选项:[ ] 保存书籍元数据以归档
  3. 删除时若勾选该选项,KOReader 会把该文档的设置文件复制到你在第一步所选的存档目录中。
  4. 随后 KOReader 会删除该文档及其关联的 your_document_name.sdr 目录。

文档虽已删除,但其设置仍保存在存档中。如果再次把该文档复制到设备并打开,KOReader 会发现存档中存有它的设置,并提示:「此书曾在本设备上打开过。是否从存档恢复其元数据?」点按恢复按钮即可用这份存档设置为该文档找回设置、标注和阅读进度。

你可以在此处查看已归档文档列表:

在此列表中,点按文档名称即可查看已归档文档的信息/元数据和书签;也可以把该文档从存档中删除。


当关闭书籍时将元数据保存至存档

如果在上述同一菜单中启用该选项,KOReader 会在关闭每份文档时保存一份设置文件的副本。此后即使你在 KOReader 之外(例如通过 Android 的文件应用,或连接电脑时)删除了文档及其 .sdr 文件夹,仍会保留该文档设置的备份。

如果启用了当关闭书籍时将元数据保存至存档选项,却在文件删除对话框中取消了保存书籍元数据以归档选项,KOReader 将删除此前为该文档创建的设置存档文件。

KOReader 通过文件哈希识别被删除的文件。这意味着重新复制回设备的文件必须与被删除的文件完全一致。任何改动(例如写入文件的 Calibre 元数据或添加的 PDF 高亮)都会改变文件哈希。此时 KOReader 无法提供恢复选项,因为它会把该文件视为另一份文件。更详细的信息请参阅本指南的下一节:书籍元数据存储
9.8 书籍元数据存储

KOReader 将与书籍相关的设置和额外信息存储在与书籍文件相同的目录中。我们称之为元数据,它包括:

  • 书籍的显示设置
  • 全书阅读进度
  • 高亮、书签与笔记

在最近的一次更改中,我们添加了存储此元数据的新方法,以解决与设备之间同步相关的某些问题。目前有三种不同的方法来存储元数据,每种方法都有自己的优缺点。

你可以从此菜单更改此设置:

强烈建议在改动任何设置前阅读下面的章节,了解各选项的功能及工作原理。否则可能面临丢失书签、阅读进度及标注的风险。
1.书籍文件旁边的单个元数据文件夹-默认设置

这是 KOReader 新安装时使用的默认方法。在此方法中,当你将 Alice In Wonderland.epub 复制到设备并首次打开时,将在同一目录中创建一个名为 Alice In Wonderland.sdr 的文件夹。此目录包含本书的设置、标注和书籍进度的文件。

好处

  • 你可以手动备份和还原每本书的设置。
  • 当你使用 Syncthing 或 Dropbox 等系统执行目录同步或备份时,你的设置将与你的书籍同步。
  • 你可以重命名书籍所在的父目录,这不会导致 KOReader 混淆。

坏处

  • 如果你在 KOReader 文件浏览器之外通过其他方式移动/重命名书籍文件或其附带的 .sdr 文件夹来重新组织你的库,你将在没有任何警告的情况下丢失这些书籍的元数据。
  • 当你使用其他文件浏览器或从计算机浏览库目录时,这些 .sdr 文件夹将可见,这可能会使你的视图变得混乱。
2.单个 KOReader 目录下的元数据目录

此方法与上面的默认方法基本相同。不同的是,在这种方法中,你的所有书籍的 .sdr 文件夹都将位于 KOReader 主目录结构下的单个目录下,而不是书籍文件旁边的库目录下。

好处

  • 书籍.sdr 文件夹仅对 KOReader 可见并由其使用。当你使用另一个文件浏览器或从计算机浏览库时,它们不会打乱你对库目录的查看。

坏处

  • 如果你通过在 KOReader 文件浏览器之外移动/重命名移动/重命名库目录、书籍文件或其附带的.sdr文件夹来重新组织你的库,你将在没有任何警告的情况下丢失这些书籍的元数据。
  • 由于你的书籍元数据不在库文件夹中,因此库的任何同步或备份都不会包含它们。
3.单个 KOReader 目录下的单个 HASHED 元数据目录

此方法与前一种方法类似,因为 .sdr 文件夹将位于内部目录下。但这种方法是为了解决以前方法的缺点而开发的。因为,通常如果你在 KOReader 之外重命名一本书(使用设备的本机文件浏览器/阅读器或从连接的计算机),其 .sdr 文件夹名称将不再匹配,并且该书的元数据将丢失。如果你只使用 KOReader 文件浏览器进行文件操作,则会自动处理,因此不会产生任何影响。

在这种 HASHED 方法中,.sdr 文件夹不是由书籍的文件路径/文件名标识的。相反,将使用部分 MD5 哈希将书籍链接到其设置。此哈希用作书籍的唯一 ID,并根据书籍文件的内容计算。同样的哈希也用于命名其 .sdr 文件夹。

好处

  • 书籍 .sdr 文件夹仅对 KOReader 可见并由其使用。当你使用另一个文件浏览器或从计算机浏览库目录时,它们不会弄乱你对库目录的视图。
  • 你可以使用其他文件浏览器或从计算机重命名、移动和复制书籍。经过这些操作后,KOReader 仍将识别这些书籍。
  • 在这种方法中,KOReader 将同一个 .sdr 文件夹与书籍的所有副本相关联,即使这些副本位于不同的设备上。例如,如果你正在使用 Syncthing,此方法使你能够在安装了 KOReader 的许多设备上同步你的 /hashdocsettings 文件夹以及你的书籍文件。尽管这些书在每个设备上的相对路径不同,但你仍然可以在设备之间同步标注和进度。这在其他方法中是不可能的。

坏处

  • 任何直接修改文件的操作(如将高亮写入 PDF 文档或从 Calibre 下载高亮)都会使文件发生变化,导致文件的 MD5 校验值发生变化(不过重命名文件或移动文件对此没有影响)。此时 KOReader 无法识别该书籍,因此该书籍的元数据将会丢失。
  • 在浏览较大目录时,计算文件 ID 可能会减慢文件浏览器的导航速度。
10 手势与键盘快捷键

你可以使用许多类型的手势来控制 KOReader。某些手势在屏幕上的使用位置和支持的方向方面存在限制。这些限制如下所示。

10.1 手势的种类
部分设备型号仅支持单点触控,因此多指手势在这些设备上不可用。

点击 / 双击

用一个手指轻敲或双击

作用范围:屏幕上的任何地方

点按

用一个手指轻点并按住

作用范围:只在四个角落

双指点击

用两个手指在同一时间轻轻敲击

作用范围:只在四个角落

张开和捏合

与在手机或平板电脑上放大和缩小相同。

作用范围:屏幕上的任何地方

该手势在部分设备型号上可能无法稳定生效。如果发生这种情况,请选择其他手势类型。

单指滑动

用一个手指轻扫动作

作用范围:屏幕边缘(水平和垂直)除四角(对角线)之外的任何位置

双指滑动

用两个手指在同一时间滑动动作

作用范围:屏幕上的任何地方

多重滑动

在不抬起手指的情况下连续完成多次滑动。例如,比如画字母 U(下-右-上)

作用范围:屏幕上的任何地方

图标由 Econceptive 创作,来自 Noun Project

10.2 内置的手势

本节列出了安装 KOReader 时默认启用的手势。你可以通过以下方式根据自己的喜好更改这些手势:

你可以在这里查看当前已定义的手势概览:


点击边角

左上角>切换翻页

右上角 > 标记/取消书签

同时点击对角>截图


双击

左侧>后翻 10 页

右侧>前翻 10 页


单指滑动

短对角滑动>全屏刷新

长对角滑动>截图


多重滑动

 - 返回上个位置

 - 转到最后的书签

 - 快速翻页

 - 书签

 - 目录

 - 显示前灯对话框

 - 重排

 - 历史记录

 - 书籍状态

 - 转到页面

 - 返回

 - 上一章

 - 下一章

 - 打开上一个文档

 - 收藏

10.3 手势分类

这是你可以使用手势管理器菜单分配给手势的每个操作的列表。你可以使用浏览器的搜索功能(通常为 Ctrl+F)在此处搜索操作。这些操作也可以在你自己的快捷菜单中使用。请查看指南中的相关部分以获取更多信息。

你可以在这里查看当前已定义的手势概览:

在为手势指定对应操作时,可以看到菜单中包含名为忽略的特殊操作项。该选项用于保留当前手势的默认操作定义(如长按屏幕四角进入文本选择模式)。若要禁用某种手势以避免误触,请选择无选项。换句话说,忽略选项等于其他操作可能会使用该手势,而无选项则意味着禁止任何操作使用该手势。
常规
  1. 手势概览
  2. 文件浏览器
  3. 打开之前的文档
  4. 历史记录
  5. 在历史记录中搜索
  6. 收藏
  7. 书单
  8. 在书单中搜索
  9. 书签浏览器
  10. 查词典
  11. 加载词典预设
  12. 循环切换词典预设
  13. 查询维基百科
  14. 呼出菜单
  15. 搜索菜单
  16. 打开当前文件夹中的下一个文件
  17. 打开当前文件夹中的上一个文件
  18. 笔记文件
  19. 屏幕截图
  20. 切换 SSH 服务器
  21. 显示太阳位置
  22. 阅读统计
  23. 阅读统计:切换
  24. 阅读统计:显示阅读进度
  25. 阅读统计:显示时间跨度
  26. 阅读统计:显示日历视图
  27. 阅读统计:显示当天时间轴
  28. 阅读统计:同步
  29. 快速阅读
  30. RSVP 阅读
设备
  1. 退出屏保
  2. 启动 USB 读写模式
  3. 休眠
  4. 重启 KOReader
  5. 重启设备
  6. 关机
  7. 退出 KOReader
  8. 切换边角长按
  9. 忽略边角长按
  10. 启用触摸输入
  11. 禁用触摸输入
  12. 切换触摸输入
  13. 对调翻页按钮
  14. 设置翻页按钮反转
  15. 切换重复按键
  16. 切换重力感应器
  17. 加速计启用 5 秒钟
  18. 切换屏幕自动旋转锁定状态
  19. 锁定自动旋转到当前方向
  20. 屏幕方向
  21. 切换屏幕方向
  22. 屏幕旋转 ⟲ 180°
  23. 顺时针旋转90°
  24. 逆时针旋转90°
  25. 启用 Wi-Fi
  26. 关闭 Wi-Fi
  27. 切换 Wi-Fi 状态
  28. 显示网络信息
  29. 电量统计
  30. 系统统计
屏幕和灯光
  1. 显示前光设置面板
  2. 切换前光
  3. 设置前光亮度
  4. 增加前光亮度
  5. 降低前光亮度
  6. 设置前光色温
  7. 增加前光色温
  8. 降低前光色温
  9. 切换夜间模式
  10. 设置夜间模式
  11. 完全刷新
  12. 完全刷新频率(始终)
  13. 完全刷新频率(非夜间模式)
  14. 完全刷新频率(夜间模式)
  15. 进入新章节时刷新
  16. 切换进入新章节时刷新
  17. 章节第二页永不刷新
  18. 切换章节第二页刷新
  19. 页面带有插图时始终刷新
  20. 切换页面带有插图时刷新
  21. 关闭自动色温
  22. 根据太阳位置自动调整色温
  23. 根据时间表自动调整色温
  24. 接近午夜时自动调整色温
  25. 接近正午时自动调整色温
  26. 按照模式自动切换对应色温设置
文件浏览器
  1. 设置文件视图
  2. 排序依据
  3. 倒序
  4. 混排文件夹与文件
  5. 显示附加菜单
  6. 切换选择模式
  7. 刷新内容
  8. 文件夹快捷方式
  9. 文件搜索
  10. 之前的文件搜索结果
  11. 返回上级文件夹
  12. 前往页面
  13. 返回
  14. 云存储
  15. 导出历史记录中所有书籍的所有笔记
阅读器
  1. 显示底部菜单
  2. 切换状态栏
  3. 切换章节进度条
  4. 加载状态栏预设
  5. 上一章
  6. 下一章
  7. 扉页
  8. 尾页
  9. 随机页
  10. 翻页
  11. 前往页面
  12. 快速翻页
  13. 锁定本页
  14. 转到锁定页
  15. 上一处书签
  16. 下一处书签
  17. 首个书签
  18. 末条书签
  19. 最新书签
  20. 返回
  21. 返回前一位置
  22. 前往后一位置
  23. 跳转到最近的链接
  24. 跳转到最近的内链
  25. 切换点击跳转链接
  26. 将当前位置添加到历史记录中
  27. 清除位置历史记录
  28. 全文搜索
  29. 上次的全文搜索结果
  30. 全文搜索:返回原始页面
  31. 目录
  32. 书籍地图
  33. 书籍地图(预览)
  34. 页面预览
  35. 书签
  36. 书签搜索
  37. 切换书签
  38. 书籍状态
  39. 书籍信息
  40. 书籍简介
  41. 书籍封面
  42. 翻译本页
  43. 反转翻页手势
  44. 切换翻页方向
  45. 切换自定义目录
  46. 切换自定义隐藏页
  47. 设置高亮动作
  48. 轮换高亮动作
  49. 轮换高亮样式
  50. 保存书籍元数据
  51. 导出标注
  52. 导出本书所有笔记
  53. 导出历史记录中所有书籍的所有笔记
  54. 将当前书籍存档
  55. 阅读统计:当前书籍
  56. 设置自动进度同步
  57. 切换自动进度同步
  58. 上传本设备上的阅读进度
  59. 从其他设备拉取阅读进度
可重排文档
  1. 设置排版语言
  2. 切换标点悬挂
  3. 字体
  4. 增大字号
  5. 减小字号
  6. 字号
  7. 文字间距
  8. 文字扩展
  9. 对比度
  10. 字重
  11. 字体微调
  12. 字距微调
  13. 双栏
  14. 左右边距
  15. 上下边距相等
  16. 顶部边距
  17. 底部边距
  18. 视图模式
  19. 渲染模式
  20. 缩放
  21. 行间距
  22. 顶部状态栏
  23. 内嵌样式
  24. 内嵌字体
  25. 图片缩放
  26. 图片反色
  27. 切换样式微调
  28. 编辑仅本书样式调整
  29. 切换本书专属样式微调
固定版式文档
  1. 切换翻页浏览
  2. 切换书签翻阅
  3. 切换页面重排
  4. 缩放模式
  5. 更改缩放比例
  6. 切换区块缩放
  7. 页面裁剪
  8. 边距
  9. 水平重叠
  10. 垂直重叠
  11. 适应
  12. 缩放为
  13. 页面分割的列数/行数
  14. 缩放比例
  15. 翻页方向
  16. 视图模式
  17. 页面间距
  18. 行间距
  19. 对齐方式
  20. 字号
  21. 调整字号
  22. 文字间距
  23. 页面重排
  24. 对比度
  25. 去水印
  26. 渲染质量
  27. 文档语言
  28. 强制 OCR
  29. 文字方向
  30. 反转文档颜色
  31. 文档分栏数
  32. 自动校直
10.4 快捷键

如果你有一个带键盘的设备,比如 Kindle 2 和 Kindle 3,包括蓝牙键盘和模拟器,你可以使用键盘键、设备按钮和快捷键来控制 KOReader。Kindle 4 也受支持,它没有完整的键盘,但仍然有足够的按钮使其在这种情况下正常工作。在这些设备上,KOReader 将启用一个名为键盘快捷键的额外菜单,你可以在此处访问该菜单:

此菜单与手势管理器界面非常相似。在此菜单中:

  • 你可以看到设备上可用的快捷键
  • 你可以看到一些快捷方式的预定义操作
  • 你可以将操作分配给可用的快捷方式

手势管理器中的所有操作也可用于键盘快捷键分配。这意味着你可以通过这些快捷方式控制 KOReader 的几乎所有功能。

在下表中,你可以看到默认的按键和快捷键分配:

通用的屏幕截图快捷键是 Alt + Shift + G。该快捷键在所有屏幕、模式和平台上均有效。在 Kindle 4 上,该快捷键为 Keyboard + Menu。
如果你使用的是 Kindle 4,下表中的 SHIFT 键会映射到设备上的 KEYBOARD 按钮。因此 Shift + (UP/DOWN/LEFT/RIGHT) 快捷键在 Kindle 4 上对应 Keyboard button + (UP/DOWN/LEFT/RIGHT)。
在文件浏览器中
打开顶部菜单 F1
导航到主页 Home
在文件列表中移动 Up / Down
打开所选书籍 Enter
退出应用程序 Esc
在阅读界面中
打开顶部菜单 F1
打开底部菜单 Enter
返回/退出应用程序 Esc
书签 Shift+Left
切换书签 Shift+Right
查词典 Ctrl+D(在 Kindle 上为 Alt+D)
查询维基百科 Ctrl+W
全文搜索 Ctrl+S
文件搜索 Ctrl+F
链接
选择下一页链接 Tab
选择上一页链接 Shift+Tab
打开所选页面链接 Enter
图片查看器(长按图片)
放大 Page Down
缩小 Page Up
高亮
进入高亮模式 H
开始/结束 高亮 Enter
移动高亮光标 Left/Right
Up/Down
增加光标移动速度 Shift+
Left/Right/Up/Down
退出高亮模式 Esc
浏览本书
翻页 Left-Right / Up-Down
Page Up / Page Down
目录 Shift+Up
书籍地图 Shift+Down
转到开头 数字1
转到书籍的11% 数字2
转到书的 22% 数字3
转到书的 33% 数字4
转到书的 44% 数字5
转到书的 55% 数字6
转到书的 66% 数字7
转到书的 77% 数字8
转到书的 88% 数字9
转到结尾 数字0
在快速翻页对话框中
转到开头 Q
转到书籍的11% W
转到书的 22% E
转到书的 33% R
转到书的 44% T
转到书的 55% Y
转到书的 66% U
转到书的 77% I
转到书的 88% O
转到结尾 P
页面缩放

(仅适用于 PDF、DJVU 和图片)

缩放至适合页面 A
缩放以适应页面宽度 S
缩放以适应页面高度 D
缩放以适应内容 Shift+A
缩放以适应内容宽度 Shift+S
缩放以适应内容高度 Shift+D
11 快捷菜单与配置文件
11.1 快捷菜单

快捷菜单是 KOReader 的最新功能,它允许你拥有一个快速访问的个性化菜单,如下图所示。你可以将此菜单分配给一个手势,并通过一次滑动访问它。你甚至可以有一个比你的屏幕更长的菜单,它是可滚动的。

基本上,你可以指定手势的任何操作都可以添加到快捷菜单中。其优点是:

  1. 你不需要为每个动作记住很多手势。
  2. 一些不常见的动作可能不值得一个手势,但在菜单系统中找到它可能太麻烦了。你可以将这种很少使用的操作添加到此菜单中。
  3. 如果你正在为亲戚或朋友安装 KOReader,则可以将他们喜欢的操作添加到此菜单中,以便他们在使用 KOReader 时甚至不需要进入菜单系统。

快捷菜单示例:

创建快捷菜单有两种方法:简单方式和高阶方式。如果你只需要一个菜单,简单方式应该足够你。如果你想用不同的手势显示不同的菜单,你需要使用高阶方式。高阶方式的另一个优点是更容易进行手势重新分配。如果要更改菜单的手势,可以使用高阶方式菜单轻松将其移动到另一个手势。如果你想在使用简单方式时使用其他手势,则必须在新手势下重新创建菜单。

简单方式
  1. 通过以下方式转到手势管理器菜单:
  2. 决定打开菜单的手势并点击它。
  3. 从手势配置菜单中选择要在菜单中显示的动作。当然,你可以一次选择多个操作。
  4. 选择所有动作后,你将告诉 KOReader 将此手势视为菜单。你可以通过在第二页上启用显示为快捷菜单项来实现这一点,如下图中所示。
  5. 你可以使用同一菜单中的排序操作和快捷菜单分隔符选项对菜单项进行排序。

现在,你可以使用所选的手势启动菜单。如果要更改菜单项,可以打开手势页面并添加/删除项目。

高阶方式
如上所述,如果不打算添加多个快捷菜单,则无需阅读本节。

快捷菜单本质上是一套配置文件,只是以菜单形式显示在屏幕上。使用该功能须先对配置文件有所了解。若是如此请继续阅读,否则请转至配置文件一节(即下一节),创建一套包含若干项的配置文件再回来继续阅读。

在继续之前,我们假设你已经按照上一段中的说明创建了配置文件。现在,我们将把配置文件转换为快捷菜单。

(1)转到新创建的配置文件,在下图所示的菜单中启用显示在操作列表中,这将使该配置文件列入手势管理列表中。在同一菜单中启用显示为快捷菜单,这样该配置文件会显示为菜单列表,而不是在后台静默执行。

(2)现在,我们需要一种访问菜单的方法。转到手势管理器,并从列表中选择一个手势以分配给菜单。假设我们想点击屏幕的一角来显示菜单。现在点按在屏幕四角点按,然后选择左下角。现在点击常规并转到第二页。你将发现你的配置文件显示为「配置文件 X」,其中 X 是你为此配置文件指定的标题。点击其复选框,将你的配置文件分配给该手势。

完成所有步骤后,现在当你点击左下角时,应该会看到你的菜单。你可以通过转到其配置文件页面来编辑菜单,你可以在其中添加或删除项目。此外,那里还有一个排序项,因此你可以更改菜单项的顺序。

如前所述,快捷菜单实际上是一套配置文件。这意味着你可以有多个菜单。如果需要,可以创建另一个配置文件,并按照相同的步骤创建另一菜单。

11.2 快捷菜单相关技巧
使用后保持菜单打开

通常快捷菜单会在选择菜单项后从屏幕上消失。有时,你可能希望在选择项目后保持菜单打开。这允许你像以下示例一样调整设置:

  • 增量更改,如亮度增加/减少、较大/较小字号、上一页/下一页或章节等。
  • 你连续激活的一组选项(但不是同时激活),如打开 Wi-Fi,之后启动 SSH 服务器

如果你具有基于手势管理器(简易方法)的快捷菜单,则可以从以下菜单中启用此选项:

若已创建基于配置文件(高阶操作)的快捷菜单,请在下列菜单中选择:

在手势位置打开快捷菜单

通常,快捷菜单在屏幕中间居中打开。如果你用一只手使用电子阅读器,则可以激活一个设置,该设置将在手势位置打开菜单。这样,菜单将更接近你的手指,更容易访问。要使用此功能,请启用此选项:

此选项仅适用于通过手势管理器(即前文的简单方式)创建的快捷菜单。
将配置文件作为菜单项添加到快捷菜单

除了向快捷菜单添加操作外,你还可以将配置文件作为菜单项添加进去。这样,通过这一个菜单项就能一次执行多项操作。

假设你已经有一个可用的快捷菜单和一个想要添加到该菜单的配置文件。准备就绪后,请按以下步骤操作:

  1. 前往要作为「菜单项」使用的配置文件的设置,启用显示在操作列表中。这将使该配置文件显示在手势管理器中。
  2. 现在可以在手势管理器中将该配置文件作为常规操作添加到快捷菜单。该配置文件位于常规子菜单(手势管理器内)的最后一页。

将配置文件添加为菜单项后,你可以打开快捷菜单并点按该项,以执行该配置文件中的所有操作。你也可以将配置文件添加为子菜单,从而形成嵌套菜单。下一节将介绍这一方法。

创建嵌套快捷菜单

你还可以将一个快捷菜单作为菜单项添加到另一个快捷菜单中,从而形成嵌套菜单结构。当你有多个快捷菜单却不想给每个都分配不同手势时,这一功能很有用。

  1. 前往要作为「子菜单」使用的配置文件的设置,启用显示在操作列表中。这将使该配置文件显示在手势管理器中。
  2. 然后进入编辑操作菜单(位于该配置文件的同一设置中),并针对该子菜单配置文件启用位于第二页的显示为快捷菜单选项。这样 KOReader 就会把该配置文件当作另一个可进入的菜单,而不是在点按它时执行其中的所有操作。
  3. 现在可以将该配置文件作为常规操作添加到父级快捷菜单,就像在手势管理器中添加其他操作一样。该子菜单配置文件位于常规选项卡的最后一页。
如果上述第二步中没有为子菜单启用显示为快捷菜单,你仍可在父菜单中长按子菜单的名称来访问其菜单项。这还会在子菜单顶部提供一个全部执行项。
11.3 配置文件

配置文件本质上是一套操作集合(就像宏命令),可通过单个手势触发。

例如在阅读某种类型的书籍时总会应用如下设置:

  • 将屏幕切换到横向显示模式
  • 增大字号并提高对比度
  • 打开屏幕前光

借助配置文件插件,只需执行单次操作即可完成这些调整。

启用另一套配置文件后,前一套配置文件所执行的修改将不可撤销。例如,用户启用了一套配置文件将字号从 20 改为 24,然后又启用了另一套配置文件调整了前光,此时字号将保持为 24。KOReader 没有退出或撤销配置文件的操作选项。

要创建配置文件,首先确保配置文件插件已激活。如果你在下面看不到它:

然后必须从以下位置打开:

创建配置文件

在配置文件菜单中,轻触新建,并为配置文件指定一个描述性标题。现在,你应该可以在菜单中看到新的配置文件。点按后将看到左侧的屏幕。你还可以从此菜单中删除、重命名或复制配置文件。

当你点击编辑操作菜单项时,你将看到右侧的菜单。这与手势选择菜单相同,并且在许多类别中都有动作。这意味着你可以使用配置文件执行任何手势动作。

现在,你可以从所有这些类别中选择多个项目。激活该配置文件时,将执行你在此处选择的操作。

启用一套配置文件

有许多方法可以激活配置文件:

  1. 通过其菜单中的执行操作。
  2. 你可以使用手势激活配置文件。为此,你必须从配置文件的菜单中启用显示在操作列表中。现在,你可以通过以下方式选择它:
  3. 从你的快捷菜单中。
  4. 你还可以根据某些条件自动激活配置文件。请参阅下一个标题以了解如何使用此强大的功能。
11.4 自动套用配置文件

配置文件可依如上所述方式手动套用,但自动套用功能才能真正释放配置文件的潜力。使用此功能可以在满足某些触发条件和次级条件时自动套用配置文件:

触发条件次级条件
仅时间间隔内

此选项不是触发条件,而是限制条件。你可以用它为配置文件的执行定义一个时间段。例如「当我打开某份书单中的书籍时放大字体,但仅限于晚间时段」。

无
KOReader 启动时

每次 KOReader 启动时套用此配置文件。请注意,该条件仅在 KOReader 启动页面设置为文件浏览器或上次阅读的书籍时才会生效。

无
唤醒时

每次设备唤醒时套用此配置文件

无
退出屏保时

每次设备退出屏保时套用此配置文件

无
改变屏幕显示方向时

当屏幕旋转到指定方向时套用此配置文件。

示例:当设备横向时,更改为双栏布局。当设备颠倒时,激活夜间模式。

  • 向左旋转90°(屏幕横向)
  • 0°(默认屏幕方向)
  • 向右旋转90°(屏幕横向)
  • 旋转180°(屏幕方向倒置)
打开文件夹时

在文件浏览器中打开指定文件夹时套用此配置文件。此项还可用于改变文件浏览器的视图。例如当打开某文件夹时,将文件显示视图从平铺改为详情视图。

  • 当目录路径包含特定文字时
  • 当目录路径不包含特定文字时
  • 当目录路径等于特定文件夹时
  • 当目录路径不等于特定文件夹时
打开书籍时

当打开符合特定次级条件的书籍时,此项将会执行。

前四项次级条件是按照或关系匹配,因此满足其中任何一项即可套用该配置文件。

  • 与设备方向条件组合
  • 与书籍元数据条件组合
  • 与书籍文件路径条件组合
  • 与书籍属于指定书单条件组合
  • 与首次打开该书籍条件组合
关闭书籍时

此选项与上述相同,但它会在你关闭书籍时触发。你可以使用此功能,例如在打开某些文档时启用/禁用读取统计信息,以将其从统计信息中排除。

  • 与设备方向条件组合
  • 与书籍元数据条件组合
  • 与书籍文件路径条件组合
  • 与书籍属于指定书单条件组合
阅读计时结束时

每次阅读计时结束时套用此配置文件

无
自动夜间模式激活时

每次切换夜间模式(反色显示)或改变屏幕色温时套用此配置文件

此触发条件会在每次色温变化时激活。你可以启用仅时间间隔内选项来加以限制。



自动套用配置文件示例:

下面是一些由本项目开发者提供的例子,为用户如何使用 KOReader 的强大功能抛砖引玉。示例也包含了自动套用配置文件的触发条件和书单功能:

  • 将设备转为横向时启用双栏模式。
  • 将设备倒置时启用夜间模式。
  • 将所有漫画添加到一份书单,然后创建一套配置文件在打开书单内的漫画时自动套用,将翻页方向改为从右向左并交换左右两侧的翻页点按及滑动手势。
  • 将漫画书添加到套用配置文件的书单,阅读该书单内的书籍时将页面刷新间隔降低到逐页刷新以避免残影。
  • 首次从期刊文件夹打开文件时,套用配置文件以调整字体、字号并设置双栏模式。
  • 将有问题的 PDF 文档编成一份书单,在阅读这些文档时套用配置触发自动 OCR 或者启动页面重排模式。
  • 在文件浏览器中打开特定文件夹时,切换视图为封面显示、详情列表等。
  • 打开《参考类书籍》书单中的书籍时禁用阅读统计,并在关闭书籍时重新启用阅读统计。
  • 在手势管理器中呼出样式微调菜单,可以创建一套配置文件以根据指定条件启用或禁用对应样式。例如,可以创建一套「禁用出版商样式,并应用我的自定义样式调整」的配置文件,根据书籍文件存放目录、被编入的书单或书籍元数据中包含的关键词等条件自动套用。请查阅样式微调一节详细了解。
逐一执行配置文件中的操作

通常执行配置文件时,其中的所有操作会按照你在排序操作菜单中选定的顺序依次执行。

但你也可以选择让它们逐一执行。也就是说,每次调用该配置文件时,只执行其中一项操作(下一项),而非全部执行。

下面举一个实用的例子:

  1. 创建一套包含以下操作的配置文件
    • 转到锁定页
    • 返回前一位置
  2. 为其指定一个简便的手势,例如点按右下角
  3. 从配置文件的编辑操作菜单中启用逐一执行选项

现在,每次点按右下方边角,你都会在锁定页与当前阅读位置之间切换。例如,这可用于快速跳转到参考文献章节再返回。

配置文件问题排查

为避免与 KOReader 的其他操作/事件相互干扰,配置文件在自动执行时会带有极小的延迟。但在某些情况下(例如关闭文档时),配置文件必须立即执行才能完成其操作。

可通过以下路径启用该即时执行选项:

启用此选项后,例如对于触发条件为关闭书籍时的配置文件,该配置文件将在文档关闭之前执行。在这种情况下,这一执行顺序是正确运行所必需的。

每当为配置文件启用自动执行时,建议同时启用立即执行选项。如果发现配置文件工作不正常,可以尝试禁用此选项。

此设置也可能引发(未知的)问题,因为配置文件中的操作组合几乎是无限的,我们无法预知它们会如何相互影响。因此该选项默认不启用。
配置文件与快捷菜单的技术细节

KOReader 有操作组/设置组的概念,这种成套的操作组合可以通过两种方式创建:

  1. 「高阶操作」编制成配置文件(保存于 settings/profiles.lua 中)
  2. 「简单方法」作为指定手势的操作项(保存于 settings/gestures.lua 中)

操作组合也可以通过两种不同的方式执行:

  1. 在触发后按照指定的顺序依次逐项执行(作为配置文件)
  2. 将其显示为快捷菜单

对操作组合进行添加/删除及对快捷菜单项进行启用/排序都是通过相同的操作菜单完成。唯一的区别是,手势管理器中的操作菜单还有两个项目(忽略),导致显示为快捷菜单和排序这两个选项被挤到第二页上。

你可以将配置文件备份并转移到其他设备。详情请参阅备份 KOReader 设置一节。
12 插件与用户补丁
12.1 插件种类

插件是小型 KOReader 程序,类似于扩展基本程序功能的浏览器插件。KOReader 有 3 类插件:

内置插件

内部插件是核心程序的一部分。

  • 它们可以直接从 KOReader 插件菜单访问。
  • 他们不需要安装。你可以从菜单中启用它们。
  • 它们由我们的开发人员检查,因此它们被认为是安全的。
  • 它们会随 KOReader 更新而自动更新。

你可以通过以下方式启用/禁用它们:

贡献插件

该组包含非官方插件,这些插件不属于 KOReader 的核心逻辑。

  • 它们必须手动安装,然后从插件菜单激活。
  • 它们应当被手动更新。
  • 它们在添加到存储库时由我们的开发人员进行检查,因此它们被认为是安全的。

你可以访问这个页面。通常,它们是通过从上面的页面下载插件的目录并将其复制到设备上的 koreader/plugins 文件夹下来安装的。但请检查插件的页面以获取其他可能的说明。

外部插件

这些是独立于 KOReader 团队开发的插件。

  • 它们必须手动安装,然后从插件菜单激活。
  • 它们应当被手动更新。
  • 我们的开发人员不会检查它们,因此请注意使用它们可能存在风险。

这些外部插件的一些著名示例,带有指向其 GitHub 页面的链接:

  • 可借助云端或本地模型与正在阅读的文本交互的 AI 插件:
    1. KOAssistant 插件:一款功能强大且可高度自定义的 AI 插件。你可以通过创建带有额外上下文和指令的自定义操作来翻译/解释文本、比较书籍/文章等。借助 Ollama 兼容性,可支持在你的计算机上运行的本地模型。插件所链接的 GitHub 页面中有非常详细的说明。
    2. Assistant(AI 助手插件):可用此插件简化、解释、讨论文本,或将文本翻译成其他语言。支持多种 AI 服务提供方以及内置/自定义提示词。
  • Anki 插件:KOReader 插件支持在内部词典中查找的文字生成 Anki(一种开源抽认卡软件)卡。
  • Zotero 插件:这款插件可以直接在 KOReader 中访问用户的 Zotero(一款开源的参考引用管理软件)收藏。
  • Syncthing 插件:该插件允许你在 KOReader 上运行 Syncthing 点对点文件同步程序(根据作者的说法,仅在 Kobo 设备上测试,但可能适用于其他设备)。这使得在你的电子阅读器和计算机/手机之间自动同步文件成为可能。
查找更多插件

需要再次强调,这些外部插件不属于 KOReader 项目,因此安装和使用时请务必谨慎。

你可以通过以下链接在 Github 上找到更多插件:

  • 此链接会打开 KOReader 插件项目的搜索结果。
  • 此页面列出带有 koreaderplugin 标签的仓库。

随着 AI 编程的普及,KOReader 插件项目数量大幅增加,选择使用哪个插件也变得更加困难。以下这些经过整理的 KOReader 资源清单在寻找实用插件时非常有用:

12.2 内置插件列表

自动调整屏幕前光 - 根据环境光级别自动切换前灯(仅适用于 Kindle Voyage 和 Oasis)

自动色温和夜间模式 - 允许你在具有自然(黄色/橙色)光线的设备中调整前灯色温,并根据时间表自动设置夜间模式

自动省电 - 在指定的不活动时间后,将设备置于待机,暂停或关闭电源

自动挂起 - 在选定的不活动时间段后挂起设备(适用于除 Android 操作系统之外的所有电子墨水设备)

自动翻页 - 在设置的时间段后自动翻页

电池统计信息 - 收集并显示设备的电池使用统计信息(仅部分设备可用)

书籍快捷方式 - 允许将书籍快捷方式添加到手势

Calibre - 你可以通过 Wi-Fi 连接将文档从 Calibre 库直接发送到 KOReader 设备。查看我们的维基页了解如何操作。

封面浏览器 - 允许文件浏览器和历史记录的封面显示模式

封面图片 - 将当前书籍的封面图片另存为文件(在 Android/PockeBook/reMarkable 设备上可用)

导出高亮 - 将高亮和笔记导出为本地文件或在线服务

手势 - 为 KOReader 提供手势支持

HTTP Inspector - 允许你通过 Wi-Fi 从另一台设备控制你的当前设备,请参阅下文了解更多信息

日语支持 - 对 KOReader 的日语支持,扩展了内置词典和选择系统

保持活动状态 - 使设备保持唤醒状态,以防止自动断开 Wi-Fi 连接

移动到存档 - 将当前文档移至存档文件夹

新闻下载器 - 检索 RSS 和 Atom 的文章并将它们保存为 HTML 文件。查看我们的维基页了解操作方法。(仅部分设备可用)

OPDS - 允许你从在线目录下载书籍

感知扩展器 - 借助周边视觉帮助你读得更快。本指南的这一节有详细说明:快速阅读插件

配置文件 - 将多项设置整合成为一套可切换套用的配置文件

阅读进度同步 - 在多台 KOReader 阅读设备间同步阅读进度。请查阅维基页了解操作方法。

来自剪贴板的QR - 从剪贴板内容生成二维码

阅读计时器 - 在用户定义的时间后显示消息的倒计时计时器

阅读统计 - 计算阅读会话统计数据和阅读速度,用于章节/书籍剩余时间估计

SSH - 允许通过 SSH 协议访问你的设备。你可以通过 FTP 应用程序甚至文件浏览器(如果支持)进行访问。查看我们的维基页了解操作方法。

系统统计 - 你可以通过以下插件通过此插件查看你的CPU/内存/电池信息:

终端模拟器 - 在设备上启动可以运行完整终端应用的 shell(命令提示符)

文本编辑器 - 用于创建和编辑纯文本文件的基本文本编辑器

时间同步 - 将设备时间与 NTP 服务器同步

调整文档设置 - 允许在加载文档之前根据外部因素调整文档的设置(仅部分设备可用)

Wallabag - 从 Wallabag 服务器下载最新文章并生成单独的 EPUB 文件。查看我们的维基页了解更多信息。

从另一台设备控制你的阅读器 - HTTP Inspector 插件

该插件允许你通过 Wi-Fi 从另一台设备控制你的设备。它的工作原理是在设备上运行一个简单的 HTTP 服务器,提供包含 KOReader 控件的页面。你可以通过网络访问该页面并控制阅读器设备。可在 MobileRead 论坛阅读该插件的实际用例。

但使用该插件时请注意以下几点:

  • 这是一个实验性插件,因此使用它需要你自担风险
  • 默认情况下,此插件处于启用状态,但默认情况下服务器不会启动。你可以手动启动它,也可以将其设置为自动启动。
  • 你应该仅在受信任的网络上运行此插件,因为它非常不安全(没有 HTTPS、没有访问限制、没有身份验证)

若要查看通过 HTTP Inspector 插件可以远程控制哪些功能:

  1. 在你的设备上启动 HTTP Inspector 服务器:
  2. 在与阅读器处于同一网络的设备上打开此页面 http://your-ereader-IP:8080/koreader/event

列表内容会根据已安装的插件和用户补丁填充。

Kompanion - KOReader 配套应用

这是一款 Android 应用,可让你通过同一网络中的 Android 设备控制 KOReader。它借助 KOReader HTTP 调试器 插件与 KOReader 通信。你可以远程执行翻页、输入文字、调节屏幕亮度、启用配置文件等多种操作。

可在其项目页面查看使用说明并下载该应用:KOReader Companion App

12.3 用户补丁

用户补丁是用 Lua 语言编写的小文件。他们可以更改 KOReader 的功能,而无需永久修改你的安装。它们可以由开发人员、其他用户编写,也可以自己编写(如果你对 KOReader 内部结构有必要的广泛了解)。

当前可用的用户补丁列表可以在项目的维基页上查阅,或查看 Github 议题列表工单列表中带有 User patch available 标签的工单项,请点击此链接访问。

基本用法 – 将已编写的补丁添加到 KOReader:
  1. 在设备上的 KOReader 目录下创建名为 patches 的目录(在 Android 上,该文件夹位于 SD 卡上)
  2. 下载扩展名为 .lua 的补丁文件并将其放入此 patches 目录中
  3. 重启 KOReader
补丁管理器

按照说明创建补丁目录并重新启动 KOReader 后,在插件菜单中将出现名为补丁管理的新插件。通过使用此插件,你可以查看用户补丁的列表和状态并启用/禁用它们。你可以点击关于补丁管理器菜单项以查看更多信息。

命名补丁

补丁的执行顺序由补丁名称中数字的第一位数字决定。例如:2-TOC-title-patch.lua 如果有多个以同一数字开头的补丁,则执行顺序为自然顺序(1<10<11<12<13<…<109<…<10010)。如果你只是下载已制作的补丁,则无需更改文件名。

名称以:

  • 0 - 最早执行,并且仅在更新后执行一次
  • 1 - 在每次启动 KOReader 时很早执行(但在 0 之后,如果适用)
  • 2 - 在每次启动 KOReader 时 UIManager 准备就绪后执行
  • 3-7 - 保留
  • 8 - 在退出之前和保存设置之前执行
  • 9 - 在退出前执行

如果用户补丁有问题,可以通过删除补丁文件来恢复到以前的配置。

Deepwiki 是一项 AI 驱动的服务,可为 GitHub 代码仓库生成架构概览和流程图。你可以在此访问为 KOReader 生成的文档。请注意,这份文档并非由 KOReader 开发者编写,但我们的开发者认为它很有用。如果你想为项目做贡献,它是理解 KOReader 代码组织方式的良好起点。
13 阅读能力提升

本节先介绍两款可能提高阅读速度的 KOReader 插件,随后列出一些有助于提升阅读速度与理解力的字体。

13.1 快速阅读插件
1. 感知扩展器插件

启用后,该插件会在阅读区域靠近左右边缘处添加两条竖线,如下图所示。阅读一行文字时,这两条线充当眼睛的起止标记。该插件的原理是:你其实不必直视一行的首尾单词,稍加练习就能用周边视觉感知到它们。

  • 灰色竖线:感知扩展器指示线
  • 红线:眼睛正常跟随文字移动
  • 蓝线:眼睛在指示线之间跳动(距离更短)

要使用该插件,需先通过以下路径启用:

启用插件后,此处会新增一个菜单项:

你可以在此菜单中切换扩展线的显示,并根据自己的喜好和周边视觉熟练程度配置指示线。启发这款插件的 Tim Ferriss 视频可在此观看。

2. FastReader 插件

这款插件是一个 RSVP(快速序列视觉呈现) 阅读器。该技术的做法是在屏幕中央快速闪现单词。这样阅读时眼睛无需移动,因此阅读速度可以更快。熟练之后还能一次感知多个单词,进一步提升阅读速度。

要使用该插件,需先通过以下路径启用:

启用插件后,此处会新增一个菜单项:

你可以从此菜单启动该插件,并配置以下设置:

  • RSVP 速度 - 以 WPM(每分钟词数)计的闪现速度
  • 预览字数 - 一次显示多少个词

你可以先用单词模式和低 WPM(较慢)开始,熟练后再逐步提高。

13.2 特殊字体

本节介绍一些可能改善阅读体验的字体。这些字体并非 KOReader 独有功能,但用户常在工单和讨论中问起,故收录于此。

这些字体的安装方式与其他字体相同。若不清楚如何为设备添加字体,可参阅使用自己的字体一节。

本节字体概览(注意,图中所有字体字号相同,均为 11 pt,但宽度、行高和可读性差别很大):

Atkinson Hyperlegible

该字体系列由 Braille Institute 设计,旨在提升低视力人群的易认性与可读性,字母和数字清晰且辨识度高。可从 Braille Institute 查看并下载该字体。


B612

B612 是一款易认性极高的字体系列,最初为空客飞机驾驶舱屏幕设计。其清晰的字形特别适合条件欠佳的阅读环境,可减轻视觉疲劳与认知负担。这些设计原则同样使它适合电子阅读器。可在 Google Fonts 查看并下载该字体。


Lexend

这款字体的设计源自旨在提升学生阅读表现的教育研究结论。可在此了解该字体,并从 Google Fonts 下载。


Luciole

这款字体遵循十余项专门的设计准则,力求为视障人士提供最佳阅读体验。它强调字母的“内部”空间,数字与数学符号极为清晰易辨。可在此查看并下载该字体。


Open Dyslexic

这款字体专为提升阅读障碍读者的可读性而设计。字母底部加重以强调方向,每个字母的独特字形可避免翻转、混淆。可在此下载。


Shantell Sans

这款字体由一位有阅读障碍的设计者打造,易认、易用、便于阅读。得益于较宽的字母和宽松的字距,它在小字号下表现也很好。可从 Google Fonts下载。


Fast Font

这是一种特殊字体,会把单词开头的几个字母替换为粗体变体(字母数量按单词长度计算)。 This bold letters then act as artificial fixation points for the eye to jump on as you can see in this sentence. 理论上这可能提高阅读速度,但当然实际效果因人而异。有趣的是,ADHD 读者普遍反映有所获益。

这款字体依赖 KOReader 支持的特殊 OpenType 特性,因此只需下载字体、复制到设备即可像其他字体一样使用。可在其 GitHub 查看示例并下载该字体及其变体(衬线、等宽和点阵版)。

14 使用技巧
14.1 阅读相关技巧
在文档之间快速切换

如果需要在两个文档之间切换(例如在比较它们时),有一种比使用文件浏览器更快的方法。KOReader 可以使用手势( 多重手势)。如果将手势的动作定义为打开之前的文档,则可以在两个文档之间快速切换,类似于桌面计算机上的 Alt+Tab 功能。你可以在以下位置找到此功能:

此外,你还可以使用历史记录对话框在文档之间快速切换。可以使用  多重手势打开历史记录屏幕。当然,你也可以为此定义任何其他手势。

每页的行数/字数

如果你想知道当前页面上显示了多少行或字,可以在以下位置查看:

更改书籍封面

你可以从以下菜单更改书籍封面:

用文档制作屏保壁纸

有些书没有合适的书籍封面。或者他们的封面可能位于第二页,因此无法正确显示。或者封面可能不适合电子墨水(太亮或太暗)。或者你更喜欢将书中的一些图片设置为封面。

遇到这类情况,可以快速截屏并将其设为当前书籍的封面。根据所处界面,截屏手势有两种:

  1. 默认截屏手势 长对角线滑动,适用于阅读模式和文件浏览器
  2. 另一种截屏手势 双指对角大幅点按边角,适用于图片查看器

在图片查看器中,可在截屏前缩放和平移图片,使其按设备的精确尺寸和宽高比裁剪,而不会被拉伸。

截屏后,可在对话框中选择 设置为书籍封面。

你可以在此处删除此自定义书籍封面:

在书籍信息页面,长按封面图片项,然后选择重置自定义。

你还可以使用重置对话框重置书籍封面,你可以通过在文件浏览器中长按文件名来访问该对话框。

使用该 重置 对话框时务必谨慎,确保仅勾选 自定义封面图片 一项,否则可能意外重置与该书籍相关的全部内容。

如果你的文档有链接,并且你在翻页或使用其他手势时不小心点击了它们,你可以通过以下菜单项关闭 点击时打开链接:

禁用此设置后,要跟踪链接,必须长时间点击它,然后从弹出菜单中选择跟踪链接。如果你有相反的问题,并且希望更容易点击链接,则可以从同一菜单中启用允许链接周围有更大的点击区域。

午夜后统计阅读数据

在读取统计数据时,你可以更改用于计算的一天的开始时间。例如,如果你在午夜之后阅读并希望将阅读时间计为今天而不是第二天,这将非常有用。这仅适用于日时间线视图,并可选择性地应用于日历视图;它不适用于任何其他统计报告。你可以在以下位置设置此时间:

阅读竖排书籍

目前官方 KOReader 尚不支持渲染竖排文字的书籍(tategaki,即日文「縦書き」),但有一位用户做出了可实现该功能的分支。它基本上是 KOReader 的复刻,额外加入了竖排文字渲染。

日文竖排书写是该分支的主要目标。但由于其实现在渲染引擎层面支持 EPUB writing-mode: vertical-rl,它也可能适用于其他竖排书写的语言。据中文用户反馈,它至少也能渲染中文。

请注意,这是一个分支(不是插件,也不是用户补丁),会完全替换你现有的 KOReader。不过普通横排书籍的表现与官方 KOReader 基本一致,因此这种替换在功能上应当是等效的。

无需先卸载当前的 KOReader 即可切换到该分支,只需按照该分支仓库中的说明操作。我们仓库中的开发讨论在此。

若切换到该分支,与竖排文字相关的问题/工单请提交到该分支的仓库,而不要提交到 KOReader 官方仓库。

14.2 设备相关技巧
更新 KOReader

KOReader 可以通过 Wi-Fi 自动更新。用户可通过下列菜单检查新版本:

添加密码锁

我们在 KOReader 中没有直接的选项。但是有一种解决方法可以实现这种锁屏功能。你可以设置 KOReader 以将屏保保留在屏幕上,直到你输入所选手势。为此,请执行以下操作:

  1. 选择任何手势(包括具有自定义多重操作的复杂手势),并通过转到使其成为你的"解锁"手势:
  2. 然后启用此选项:
从另一台设备控制 KOReader

借助一款开源 Android 应用,你可以通过同一网络中的 Android 设备控制 KOReader。它借助 KOReader HTTP 调试器 插件与 KOReader 通信。你可以远程执行翻页、输入文字、调节屏幕亮度、启用配置文件等多种操作。

可在其项目页面查看说明并下载应用:KOReader Page Turner Companion

自动屏幕亮度

如果你的设备闲置一段时间,KOReader 可以调暗你的前灯以节省电池电量。你可以通过以下方式打开和调整此功能:

优化电池健康

锂离子电池过充过放都会极大影响电池寿命。为了最大限度地减少影响并延长电池寿命,你可以将最低电量限制为 20%,将最大充电电量限制为 80%(如电动汽车和一些较新的手机)。这意味着当电池电量降至 20% 时,你需要开始为设备充电,并在电池电量达到 80%(如果你格外小心,则为 30%-70%)时拔下插头。

KOReader 可以在电量达到你定义的限制时显示警报来警告你:

查看电池消耗详细信息

你可以通过此菜单项查看详细的电池使用统计信息:

检查详细的设备统计信息

你可以通过此菜单项查看你的系统信息,例如CPU/磁盘空间/内存使用情况:

密切关注你的内存使用情况

在较旧的 Kindle 设备中,我们的一些用户报告由于内存有限而崩溃。如果在一个会话中打开多个文件,KOReader 内存使用量可能会增加。尤其是 PDF 增加了这个数量。你可以向状态栏添加内存指示器,如果此值变高,则重新启动 KOReader,以避免崩溃或重新启动。

此外,你还可以通过以下方式将 KOReader 配置为在内存使用量达到阈值时自动重启:

15 疑难解答

若无法在本指南中找到问题的解决方案,可在本项目的 GitHub 页面新开工单,或在 Mobileread 论坛的 KOReader 板块发帖询问。详情请参阅本指南的联系我们一节。

电池耗电问题

KOReader 的耗电非常克制。因此,如果在使用 KOReader 时阅读器电池开始异常掉电,通常首先要怀疑的是电池老化。

但如果你确认电池状态良好,且掉电只在使用 KOReader 时发生,原因可能是:

  • 有问题的固件更新
  • 某个第三方插件
  • 一个用户补丁

若遇到掉电问题,可按以下步骤排查:

  1. 将设备更新到最新固件版本。若设备没有可用的固件更新,请跳到下一步。
  2. 若更新固件仍未解决掉电问题,请移除已安装的所有第三方插件和用户补丁,然后重启 KOReader。
  3. 若前两步之后掉电问题依旧,最后的办法是将设备恢复出厂设置并重新安装 KOReader(别忘了备份主书库文件夹)。

如果问题仍然存在,可以在我们的 GitHub 页面新开工单。

我的书很慢

请参阅指南的优化文档一节,获取特定文件运行缓慢时的建议和解决办法。

如果所有书籍都运行缓慢,则问题可能与设备有关:

  • CPU 速度非常慢或 RAM 不足。
  • 你的闪存(你的书籍所在的位置)可能会退化,这通常是由于设备老化造成的。
  • 你的存储空间可能不足。
  • 如果你使用的是基于 Android 的设备,你的 Android 系统可能会干扰 KOReader 的运行,或者某些后台进程可能会使用你的系统资源。

新开工单:

如果你要就这个问题提交一个工单,对我们来说检查有问题的文件非常重要。你可以在将其压缩成 ZIP 压缩包后,直接通过拖放的方式将文件分享到你的 GitHub 消息中。如果你的书是 EPUB,并且由于版权或隐私问题,你不想共享该文件,有一个名为 ScrambleEbook 的 Calibre 插件,你可以从Mobileread 论坛页面访问下载和说明。

此插件将读取未加 DRM 保护的电子书文件(EPUB/KEPUB/AZW3),并创建一本文本被随机字符替换的书的副本。你可以在你的工单中与我们分享这个混乱版本。书中的文本将无法阅读,也不会有任何版权侵犯,但我们仍然可以使用此文件进行诊断目的。

你可以在此处看到这个涉及非常有问题的 EPUB 文件的实际问题的过程。

翻页时的重影

即使 KOReader 设置为在每页完全刷新,你仍然可能在翻页后看到一些重影/残留。这是电子墨水屏幕技术的局限性,可以在最新一代设备上观察到,尤其是在阅读混合内容(文本+图片)文档时。作为解决方法,你可以在翻页后再次手动刷新,以消除这些伪影(默认为短对角线滑动手势)。

屏保上的重影

在某些情况下(取决于书籍内容、屏保图片的明暗、阅读器型号等诸多因素),即便休眠前已刷新,屏保上仍可能出现重影/残留。可通过以下位置增加刷新次数来消除:

进度同步问题

这可能是由于启用了将高亮写入 PDF 文档功能。保存 PDF 高亮会编辑文档数据进而导致同步失败。如果这两项功能都要使用,请在阅读进度同步插件设置中,将文档匹配方式从默认的二进制值匹配改为文件名匹配:

合盖休眠问题

休眠皮套通常使用嵌入在皮套中的磁铁,通过触发设备中的传感器来启动唤醒和休眠事件。该传感器有时可以称为霍尔传感器或霍尔效应传感器。在某些情况下,如未对准或磁性减弱,这种触发可能是有问题的。如果您的设备因皮套而无法唤醒,您可以通过以下菜单禁用此功能:

点按被识别为长按/双击

这可能发生在手抖或设备触摸屏有问题的情况下。如果你有此问题,可以尝试增加点击间隔。通过增加此间隔,你可以告诉 KOReader 忽略同一位置的快速点击。

该选项不会对点按位置间隔了一定距离的两次连续点按生效,因此仍可通过使用两只手指交替点按屏幕来快速翻页。

KOReader 无法写入 SD 卡

在 Android 设备中,由于 Android 系统限制,KOReader 无法写入外部存储。如果你想更改屏幕截图保存位置,请仔细选择设备的内部存储空间。

备份你的 KOReader 设置

在极少数情况下,你想要使用所有设置备份和恢复 KOReader,你可以在 KOReader 安装目录下备份这些文件夹和文件。然后,你可以在全新安装后覆盖它们以恢复你的设置:

文件夹:
  • 设置
  • 样式微调
文件:
  • data/cr3.ini
  • defaults.persistent.lua
  • history.lua
  • settings.reader.lua
  • settings/profiles.lua
  • data/dict/ 和 /data/tessdata/ 目录下的文件 (如果存在)
每本书的设置和高亮保存在与书籍同一目录下、与书籍同名的文件夹中。如有需要,可单独备份这些文件夹。
在 Android 设备上重置 KOReader

在 Android 设备上,KOReader 将设置保存在 Internal Storage/koreader/ 目录下。这是有意设计,与其他 Android 应用不同。该目录用户可直接访问,便于备份和同步 KOReader 设置。

但当你卸载 KOReader,或在 Android 系统设置菜单中清除其数据时,这个 KOReader 设置目录并不会被删除。因此,卸载后重新安装 KOReader,它仍会沿用旧设置启动。

若想把 KOReader 彻底重置为出厂默认状态,需手动删除该目录。删除后再次启动 KOReader 时,它会自动以默认设置重新创建。

在 Amazon Kindle 设备上禁用广告

这在技术上可行,但遗憾的是我们无法更改这些阅读器上默认的屏保行为。因为这可能引发 Amazon 的负面反应,进而封锁 Kindle 生态(Kindle 上将不再能用 KOReader),甚至危及整个项目(KOReader 不复存在)。更多信息可在此查看我们与开发者的讨论。我们的立场与 MobileRead 论坛一致,可在此阅读。

阅读时侧边的小数字

这些小数字称为出版方页码。简而言之,它们是书籍印刷版的真实页码。更多信息请点击页码编号前往相关章节。

我的状态栏消失了

可能你点击了屏幕底部的状态栏。你可以通过轻触同一区域将其恢复。

文本缩进问题

如果标题、小标题或分隔符没有正确居中,或者出现意外的文本缩进,请尝试切换文档的样式,把 epub.css 改成 html5.css。发生这种问题是因为一些出版方认为他们的书只会在基于网络浏览器引擎的阅读器上阅读,因此他们不会费心“重置”样式。

  • 默认 HTML/EPUB (epub.css) 是我们面向书籍的样式表,带有 text-align: justify, text-indent on P。它更适合无样式的书籍,并且可能会使具有样式的书籍更具可读性。
  • 如果您的书籍存在上述缩进问题,您可以尝试切换到 HTML5 (html5.css),这种样式提供了一个基本样式表,就像 Web 浏览器在渲染时所做的那样: text-align: left, no text-indent on P, spacing between P。但是当出版方没有做任何样式时,它看起来并不漂亮。
删除书籍封面缓存数据库

KOReader 会缓存书籍封面以更快地显示。在正常情况下该缓存不会占用过多空间。在删除大量书籍或对文件夹重命名后,可能需要删除书籍封面缓存数据库以回收一些空间。该操作可通过下列菜单中执行:

删除文件缓存

当您阅读 PDF/DJVU 文档时,KOReader 会保留您阅读的最后一页的缓存。所以当你重新打开这本书时,它会更快。但是,如果您长时间使用 KOReader 并阅读许多 PDF/DJVU 文档,则此缓存可能会变大。这些缓存文件保存在 KOReader 安装目录下的缓存文件夹下。要删除此缓存并回收空间,您可以转到:

请仅在确实需要腾出空间时才清除此缓存。若空间充足,清除缓存不会带来任何好处,反而会降低性能,因为阅读器必须重新渲染这些页面。
什么是每夜版?

KOReader 有两个不同的版本分支:

  • 稳定版 该类版本是 GitHub 上 Releases 发布页提供的主力版本,其文件名形如「KOReader 2024.11」,意为该版软件发布于2024年11月。该类版本大致上按月度发布,但有时发布间隔也会更久。
  • 每夜版 该类版本会每天持续编译发布以便及时合并优化和修复。每夜版面向尝鲜者及开发者这类小群体用户,因此软件稳定性可能欠佳。

通常来说,稳定版是适合普通用户的版本。但某些特殊情况下,用户可能需要每夜版:

  • 你的设备非常新(例如最近发布的 Kobo 型号),并且刚刚在最近的一个晚上添加了 KOReader 支持。
  • 存在特定于你的设备的错误或问题,该错误或问题已修复但尚未发布。而且你不想等待稳定版本进行此修复。
  • 更新 KOReader 后,你注意到你正在使用的功能已被删除。你不想丢失此功能,因此你可以安装仍然具有此功能的夜间版本。当然,你也可以返回到以前的稳定版,但每夜版会更新,因此可能会有更多功能和修复。

本节只是对该主题的一般介绍。有关每夜版的详细信息和寻求帮助,你可以访问讨论页面:FAQ: 如何跟踪最新的每夜版

在 Android 设备上使用 KOReader 时,可利用 Android 系统的 Work Profile(工作资料) 功能测试每夜版,而不会影响主力安装的 KOReader。Shelter 和 Island 等开源应用可以帮你实现这一点。
联系我们

KOReader 使用 GitHub 作为项目大本营。只需注册一个免费的 GitHub 账号,即可报告问题或提出建议。点击此处链接访问项目的GitHub 工单列。

点击 Issues 页上的 New Issue 按钮即可提交问题。但建议你先使用搜索栏检索是否已有其他人就相似话题提问,并参考已经提交的工单了解提交工单的流程与操作。

点击 New Issue 按钮后,你将看到两个选项:

点选你需要的选项,然后按照页面上的说明报告你的问题或提出建议。

报告故障时附上详细调试日志将大大有助于明确故障原因。请通过以下方式启用该功能:

在同一对话框处还可找到当前使用的 KOReader 版本号及阅读设备型号,以便更准确地描述故障。

如有任何关于用户手册的建议或疑问,请前往GitHub 工单页提交

其它可以做的事...

前往 MobileRead 论坛与其他 KOReader 用户交流

使用 Gitter 聊天工具与开发组沟通

通过 Liberapay 赞助本开源项目