PDF.js开源文档

PDF.js是一个使用HTML5构建的可移植文档格式（PDF）查看器。

PDF.js是社区驱动的，由Mozilla支持。我们的目标是创建一个基于web标准的通用平台，用于解析和呈现PDF。

贡献

PDF.js是一个开源项目，一直在寻找更多的贡献者。要参与其中，请访问：

问题报告指南

代码贡献指南

常见问题解答

好的初学者bug

项目

欢迎来到我们的矩阵室，寻求问题或指导。

入门

在线演示

请注意，“现代浏览器”版本假定本机支持最新的JavaScript功能；请参见此wiki页面。

现代浏览器：https://mozilla.github.io/pdf.js/web/viewer.html

较旧的浏览器：https://mozilla.github.io/pdf.js/legacy/web/viewer.html

扩充套件

Firefox浏览器

PDF.js内置于Firefox的19+版本中。

铬

构建自己的代码-获取如下所述的代码，并发出一口铬。然后打开Chrome，转到“工具”>“扩展”，从build/Chrome目录加载（未打包）扩展。

获取代码

要获取当前代码的本地副本，请使用git：

$git clone https://github.com/mozilla/pdf.js.git

$cd pdf.js

接下来，通过官方软件包或nvm安装Node.js。您需要在全球范围内安装gulp包（另请参阅gulp的入门）：

$npm install -g gulf cli

如果一切顺利，请安装PDF.js的所有依赖项：

$npm install

最后，您需要启动本地web服务器，因为某些浏览器不允许使用file://URL打开PDF文件。运行：

$gulp server

然后您可以打开：

http://localhost:8888/web/viewer.html

请记住，这需要一个现代化的、最新的浏览器；有关PDF.js库的非开发用途，请参阅构建PDF.js。

也可以通过打开以下文件在右侧查看所有测试PDF文件：

http://localhost:8888/test/pdfs/?frame

Building PDF.js

要将所有src/文件捆绑到两个生产脚本中并构建通用查看器，请运行：

$gulf generic

如果需要支持较旧的浏览器，请运行：

$gulp generic-legacy

这将在build/general/build/目录中生成pdf.js和pdf.worker.js（分别为build/genericlegacy/build/）。这两个脚本都是需要的，但只需要包含pdf.js，因为pdf.worker.js将由pdf.jss加载。pdf.js文件很大，应该缩小以用于生产。

在web应用程序中使用PDF.js

要在web应用程序中使用PDF.js，您可以选择使用预先构建的库版本或从源代码构建它。我们以pdfjs dist名称为NPM和Bower提供预构建版本。有关更多信息和示例，请参阅有关此主题的wiki页面。

包括通过CDN

PDF.js托管在几个免费CDN上：

https://www.jsdelivr.com/package/npm/pdfjs-dist

https://cdnjs.com/libraries/pdf.js

https://unpkg.com/pdfjs-dist/

学习

您可以使用以下实时演示直接从浏览器中使用PDF.js API：

交互式示例

更多示例可在示例文件夹中找到。其中一些使用pdfjs-dist包，可以通过gulp-dist-install命令在这个repo目录中构建和安装该包。

有关PDF.js代码的介绍，请查看我们的撰稿人Julian Viereck的演示：

https://www.youtube.com/watch?v=Iv15UY-4Fg8

更多学习资源请访问：

https://github.com/mozilla/pdf.js/wiki/Additional-Learning-Resources

API文档位于：

https://mozilla.github.io/pdf.js/api/

问题

查看我们的常见问题解答并获得常见问题的答案：

https://github.com/mozilla/pdf.js/wiki/Frequently-Asked-Questions

在Matrix上与我们交谈：

https://chat.mozilla.org/#/room/#pdfjs:mozilla.org

提交问题：

https://github.com/mozilla/pdf.js/issues/new

在Twitter上关注我们：@pdfjs

https://twitter.com/pdfjs