企业官网建设流程全解析

3 分钟上手：在浏览器里跑一个网页版 EPUB 阅读器

【免费下载链接】epubjs-readerEpub.js Reader项目地址: https://gitcode.com/gh_mirrors/ep/epubjs-reader

想把书放进网页里，EPUB 是最通用的开放格式，可浏览器并不认识它。EPUB.js Reader 就是干这个的：一个基于 epub.js 构建的网页版 EPUB 阅读器，给它一个书本地址，就能在页面上得到一个完整的阅读体验。

它为什么值得关注：网页打开 EPUB 的痛点

做过阅读类产品的人都知道第一道坎：EPUB 本质是个 zip 压起来的 XHTML 包，浏览器没有原生支持，自己写解析、排版、进度记忆，工作量不小。

EPUB.js Reader 把这条链路包完了——加载、渲染、目录、书签、进度恢复，开箱即用。而且它是个完全开放的实现，控制器一层层拆在src/controllers/里，想读懂一个阅读器怎么工作，它是极好的教材。

五分钟跑起来：从克隆到第一页翻开

🚀 克隆仓库并安装依赖：

git clone https://gitcode.com/gh_mirrors/ep/epubjs-reader cd epubjs-reader && npm install

再启动自带的静态服务器：

npm start

服务器默认起在 8080 端口，浏览器打开http://localhost:8080/，一个带侧边栏的完整阅读页就出来了。想换书读，不用改代码，URL 加个参数即可：?bookPath=后面接你的书本地址。这个参数会在src/reader.js里被自动解析，并覆盖默认书源。

核心能力：目录、书签与进度记忆

🔧目录树与章节跳转

阅读器会解析书籍的导航数据，在左侧自动生成可折叠的目录树，当前章节实时高亮。任何点击背后都是一次rendition.display(url)调用，点了就翻到那一页。

书签与笔记

点顶部书签按钮，触发reader.addBookmark(cfi)，位置被钉进书签面板，再点一次就能跳回原处。笔记同理，addNote()把文字连同 CFI 坐标存下来，可以锚定到任意文字片段。

阅读进度与字号

初始化时传restore: true，关闭页面时它会自动把当前 CFI 位置和字号设置存进 localStorage，下次打开同一本书接着上次的地方读。字号还支持Ctrl +/Ctrl -实时微调，Ctrl 0一键还原。

真实场景：给在线图书馆搭一个阅读页

典型用法就是给在线图书馆做阅读页：用户 URL 通过bookPath传入各自的书籍，restore: true负责进度恢复，同一套代码适配不同用户、不同书、不同设备，你只需要专心做账号和书库。

踩坑提示：自己部署 EPUB 文件时记得开 CORS。tools/serve.js里已经内置了跨域中间件，但换成自己的 nginx 或 express 时，记得补上Access-Control-Allow-Origin响应头，不然加载书籍会静默失败。

进阶技巧：阅读器自带插件机制，往EPUBJS.reader.plugins上挂一个控制器，初始化时会自动装配——src/plugins/search.js里的全文搜索就是这么实现的，加批注、加分享链接都可以照这个路子写。

周边生态与下一步

📦 上游核心库 epub.js 值得单独读一读，分页、布局这些更细的控制都在它那一层。仓库src/plugins/目录下放着 search 和 hypothesis 批注两个现成插件，写自定义功能时可以直接当模板。社区动态可以关注 Epubjs 的邮件列表和 @Epubjs 账号，插件讨论基本都在那边。

现在就把项目拉下来，翻开你的第一页吧。

【免费下载链接】epubjs-readerEpub.js Reader项目地址: https://gitcode.com/gh_mirrors/ep/epubjs-reader