A-Read
一个极简的 VS Code 本地 EPUB 阅读器。
当前能力
- Activity Bar 入口:使用与 VS Code 默认插件图标视觉尺寸一致的 A-Read PNG 图标;阅读视图会根据所在区域自适应布局。窄侧栏显示阅读内容,宽面板会显示可收起的 30% 目录栏。
- 配置页书库:递归扫描并列出
.epub 文件;书籍较多时列表可独立滚动,点击书名即可开始阅读。
- 阅读进度:记忆当前章节和页内位置,在章节边界继续翻页会流畅进入相邻章节,不显示重新分页的中间状态。
- 翻页操作:在正文区域向上/向下滚动鼠标滚轮可翻到上一页/下一页;也可在底部 40% 内点击左、右半区翻页。
- 响应式分页:正文按当前视图宽高计算页数并预留上下安全间距;图片、字体加载或视图尺寸变化后会重新分页。
- EPUB 内容:支持 Spine 中的 XHTML/HTML/XML 章节、常见文档编码及 EPUB 内嵌图片。
- EPUB 标注:识别
epub:type="noteref" 与 epub:type="footnote",入口统一显示为小号、加粗、蓝色的“【注】”;点击后弹出详情,点击弹窗外部或按 Esc 关闭。
- 常用排版:字号、行距、段落间距、字体预设、自定义系统字体栈,以及自动/浅色/羊皮纸/深色主题。
- 快捷键:
Ctrl+Shift+Alt+R 打开配置,Ctrl+Alt+R 打开编辑器区阅读器(macOS 使用对应 Cmd)。也可以直接在配置页书库点击书名。
完整版本记录见 CHANGELOG.md。
开发
npm install
npm run build
按 F5 启动扩展开发宿主。首次使用执行 A-Read: 打开配置 选择 EPUB 图书目录。
设计取舍
扩展在本地解析 EPUB ZIP、OPF、XHTML 与书内图片,不上传书籍内容,也不依赖远程阅读服务。为保证 Webview 安全,脚本、表单、外部资源和交互式 EPUB 内容会被过滤。
| |