Marmelator/pdf.js
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Updated Frequently Asked Questions (markdown)

brendandahl 2012-10-18 11:37:36 -07:00
parent 28424658c4
commit 797389d384
1 changed files with 43 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

47
Frequently-Asked-Questions.md

@ -1,5 +1,6 @@
* [Can I load a pdf from another server (cross domain request)?](#faq-xhr)
* [What browsers are supported (and where can I find install procedures)?](#faq-yis)
* [What browsers are supported?](#faq-support)
* [What browsers have extensions (and where can I find install procedures)?](#faq-extensions)
* [I know JavaScript and want to contribute to the project. How do I start?](#faq-contrib)
@ -7,9 +8,47 @@
## Can I load a pdf from another server (cross domain request)?
Not by default, but it is possible. Pdf.js runs with the same permissions as any other javascript, which means it cannot do cross origin requests (see [Same origin policy](http://en.wikipedia.org/wiki/Same_origin_policy) and [example](https://gist.github.com/3452072)). There are some possible ways to get around this such as using [CORS](http://enable-cors.org/) or setting up a proxy on your server that will feed pdf.js the pdf. Both workarounds are out of the scope of the pdf.js project and we will not provide code to do either.
<a name="faq-yis"></a>
## What browsers are supported (and where can I find install procedures)?
FireFox is widely supported and installation procedures are described in the README.md at the PDF.js GitHub landing page [https://github.com/mozilla/pdf.js].
<a name="faq-support"></a>
## What browsers are supported?
The goal is to support all HTML5 compliant browsers, but since feature support varies per browser/version our support for all PDF features varies as well. In general, the support is below:
<table>
<tr><th>Browser</th><th>Supported</th><th>Automated Testing</th><th>Notes</th></tr>
<tr>
<td>Firefox Stable</td>
<td>yes</td>
<td>Windows and Linux</td>
<td></td>
</tr>
<tr>
<td>Chrome Stable</td>
<td>yes</td>
<td>Linux</td>
<td>Missing some minor features such as:...</td>
</tr>
<tr>
<td>Opera Stable</td>
<td>yes</td>
<td>none</td>
<td></td>
</tr>
<tr>
<td>IE9</td>
<td>limited</td>
<td>none</td>
<td>IE9 lacks a number of features and most notably typed arrays which causes subpar performance.</td>
</tr>
<tr>
<td>&lt;=IE8</td>
<td>NO</td>
<td>none</td>
<td>IE8 and below are missing too many features to be supported.</td>
</tr>
</table>
<a name="faq-extensions"></a>
## What browsers have extensions(and where can I find install procedures)?
There is currently a Firefox and Chrome extension. The Firefox extension is well supported and actively worked on. The Chrome extension is less active and more experimental. For installing either see the [readme](https://github.com/mozilla/pdf.js/blob/master/README.md).
<a name="faq-contrib"></a>
## I know JavaScript and want to contribute to the project. How do I start?