PDF 阅读器——Mozilla pdf.js 集成
pdf.js 简介
Mozilla 的 pdf.js 是最流行的开源 PDF 渲染引擎,用纯 JavaScript 实现。uWeb 把它打包成 HTML5 应用,让你不用装任何独立 PDF App 就能阅读 PDF。
安装方式
从官方文档站 HTML5 应用页面点击安装 pdf 阅读器,它会自动下载到配置目录的 app/ 下,文件名为 pdfviewer.html。
基础使用
方式一:特色服务入口
长按图像按钮 → 特色服务 → 选择 PDF 入口:
pdf:file:///data/.../app/pdfviewer.html?file=%u
其中 %u 被替换为当前页面 URL 或文件路径。如果当前页面是一个 PDF 文件,直接用 PDF 阅读器打开。
方式二:搜索引擎 + URL 直接访问
某些情况下你可以直接在地址栏输入 pdfviewer.html 的 file:// URL 加上 PDF 路径。
方式三:default.filecap 自动打开
配置 default.filecap 让 .pdf 文件自动用 PDF 阅读器打开。需要勾选"文件预处理"并重启。
高级功能
页码跳转
file:///.../app/pdfviewer.html?file=/path/to/document.pdf#page=42
#page=N 直接跳到第 N 页。配合主屏搜索框的"页码快速跳转"可以实现 PDF 内快速导航。
搜索结合
pdf.js 自带搜索功能。结合 uWeb 的多引擎搜索和字典,你可以:
- 在 PDF 里用 Ctrl+F 搜索关键词
- 用主屏 AI 引擎对 PDF 内容做问答
- 用 MDict 字典对 PDF 里的生词做离线释义
配合超级书签
你可以:
- 打开一个 PDF
- 翻到你常看的那一页
- 保存为超级书签
- 下次点书签直接跳到那一页
在线 PDF vs 本地 PDF
在线 PDF
如果网页本身就是一个 PDF(content-type 是 application/pdf),默认情况下浏览器内置 WebView 会直接渲染(如果支持),或者下载后用系统 App 打开。
用 pdf.js 应用可以:
- 在 uWeb 界面里直接显示
- 获得更完善的搜索、目录、书签支持
- 不受系统 PDF 阅读器功能限制
本地 PDF
把文件放在配置目录或符号链接的公共目录里,用 file:// URL 加上路径直接打开。
其他 PDF 相关功能
输出自定义页面大小 PDF
官方文档提到 uWeb 支持"输出自定义页面大小 PDF"——这是浏览器的内置功能之一,不一定需要 pdf.js 应用。具体方法:
- 打开目标网页
- 通过 print-friendly 特色服务或内置功能
- 选择"打印为 PDF"或"另存为 PDF"
- 可以自定义纸张大小
矢量图长截屏
官方文档还提到支持"矢量图长截屏"——可以截取长页面并保持矢量清晰度,比普通位图截屏质量高得多。
配合重定向和镜像
某些 PDF 文件托管在被墙的服务器上。配合重定向:
- 全局重定向会自动代理 PDF 文件请求
- 国内镜像替换(default.redirect)让 PDF 加载更快
- 重定向 URL 末尾需要带
?或/(见重定向章节)