uWeb 中文文档 下载 App

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 的多引擎搜索和字典,你可以:

配合超级书签

你可以:

  1. 打开一个 PDF
  2. 翻到你常看的那一页
  3. 保存为超级书签
  4. 下次点书签直接跳到那一页

在线 PDF vs 本地 PDF

在线 PDF

如果网页本身就是一个 PDF(content-type 是 application/pdf),默认情况下浏览器内置 WebView 会直接渲染(如果支持),或者下载后用系统 App 打开。

用 pdf.js 应用可以:

本地 PDF

把文件放在配置目录或符号链接的公共目录里,用 file:// URL 加上路径直接打开。

其他 PDF 相关功能

输出自定义页面大小 PDF

官方文档提到 uWeb 支持"输出自定义页面大小 PDF"——这是浏览器的内置功能之一,不一定需要 pdf.js 应用。具体方法:

  1. 打开目标网页
  2. 通过 print-friendly 特色服务或内置功能
  3. 选择"打印为 PDF"或"另存为 PDF"
  4. 可以自定义纸张大小

矢量图长截屏

官方文档还提到支持"矢量图长截屏"——可以截取长页面并保持矢量清晰度,比普通位图截屏质量高得多。

配合重定向和镜像

某些 PDF 文件托管在被墙的服务器上。配合重定向:

下一章