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
学习
您可以使用以下实时演示直接从浏览器中使用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