Go to file

Rob Wu 0ec82d4a50 Allow local PDF files to be viewed in local frames The Chrome extension enforces that local files cannot be embedded in non-local web pages. The previous check was too strict (because the origin of a file:-URL is "null"), and prevented local PDF from being viewed in local files). This patch fixes that problem, by querying the actual tab URL via the background page. Steps to verify: 1. Create a HTML file: `<iframe src=test.pdf width=100% height=100%>` 2. Build and load the extension. 3. Allow file access to the extension at `chrome://extensions` 4. Open the HTML file from a file:// URL. 5. VERIFY: The extension should attempt to load the PDF file. 6. Now open the following (replace ID with the extension ID, which you can find at `chrome://extensions`): `data:text/html,<iframe src="chrome-extension://ID/file:///test.pdf">` 7. VERIFY: The next error should be displayed: "Refused to load a local file in a non-local page for security reasons."		2016-02-10 14:52:54 +01:00
docs	Clean up npm dependencies and add `license` property	2015-10-30 08:49:50 -05:00
examples	Use RequireJS in the viewer, examples and tests.	2015-12-29 09:20:52 -06:00
extensions	Allow local PDF files to be viewed in local frames	2016-02-10 14:52:54 +01:00
external	Adds UMD header to pdf.js and pdf.worker.js files.	2015-12-29 18:15:14 -06:00
l10n	Import l10n.	2015-12-26 22:37:07 -06:00
src	Merge pull request #6921 from Snuffleupagus/mandatory-deprecated	2016-01-29 12:12:08 +01:00
test	[api-minor] Change `getPageLabels` to always return the pageLabels, even if they are identical to standard page numbering	2016-01-27 13:36:03 +01:00
web	Allow local PDF files to be viewed in local frames	2016-02-10 14:52:54 +01:00
.editorconfig	Uses editorconfig to maintain consistent coding styles	2015-11-14 07:32:18 +05:30
.gitattributes	Fixing C++,PHP and Pascal presence in the repo	2015-10-29 13:03:51 -05:00
.gitignore	Added svg export tool	2014-08-14 23:18:19 +05:30
.gitmodules	Update fonttools location and version (issue 6223)	2015-07-17 12:51:09 +02:00
.jshintignore	Remove mozcentral test files.	2015-11-11 15:54:17 -06:00
.jshintrc	Adds UMD headers to core, display and shared files.	2015-12-15 13:24:39 -06:00
.travis.yml	Update the Node.js version used by Travis, to prevent deprecation warnings in the output	2015-12-10 13:15:32 +01:00
AUTHORS	Adding to authors	2015-11-06 18:52:27 -07:00
CONTRIBUTING.md	Clarify bug reporting with regards to providing a pdf	2015-04-25 14:42:37 +02:00
LICENSE	cleaned whitespace	2015-02-17 11:07:37 -05:00
make.js	Adds pdfjs/main_loader module to better mirror pdfjs-dist/build/pdf.	2015-12-30 13:28:57 -06:00
package.json	Use RequireJS in the viewer, examples and tests.	2015-12-29 09:20:52 -06:00
pdfjs.config	Publish 1.4.20	2016-01-27 10:32:58 -06:00
README.md	Update README.md to add Seamonkey compatibility	2015-11-19 23:08:28 +01:00

README.md

PDF.js

PDF.js is a Portable Document Format (PDF) viewer that is built with HTML5.

PDF.js is community-driven and supported by Mozilla Labs. Our goal is to create a general-purpose, web standards-based platform for parsing and rendering PDFs.

Contributing

PDF.js is an open source project and always looking for more contributors. To get involved checkout:

For further questions or guidance feel free to stop by #pdfjs on irc.mozilla.org.

Getting Started

Online demo

http://mozilla.github.io/pdf.js/web/viewer.html

Browser Extensions

Firefox and Seamonkey

PDF.js is built into version 19+ of Firefox, however the extension is still available:

Development Version - This version is updated every time new code is merged into the PDF.js codebase. This should be quite stable but still might break from time to time. This version is also reported to work when installed as extension in Seamonkey 2.39.

Chrome and Opera

The official extension for Chrome can be installed from the Chrome Web Store. This extension is maintained by @Rob--W.
Opera has also published an extension for their browser at the Opera add-ons catalog.
Build Your Own - Get the code as explained below and issue node make chromium. Then open Chrome, go to Tools > Extension and load the (unpackaged) extension from the directory build/chromium.

Getting the Code

To get a local copy of the current code, clone it using git:

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

Next, install Node.js via the official package or via nvm. If everything worked out, run

$ npm install

to install all dependencies for PDF.js.

Finally you need to start a local web server as some browsers do not allow opening PDF files using a file:// URL. Run

$ node make server

and then you can open

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

It is also possible to view all test PDF files on the right side by opening

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

Building PDF.js

In order to bundle all src/ files into two productions scripts and build the generic viewer, issue:

$ node make generic

This will generate pdf.js and pdf.worker.js in the build/generic/build/ directory. Both scripts are needed but only pdf.js needs to be included since pdf.worker.js will be loaded by pdf.js. If you want to support more browsers than Firefox you'll also need to include compatibility.js from build/generic/web/. The PDF.js files are large and should be minified for production.