collective.pdfjs - Plone integration for Mozilla's JavaScript PDF reader
========================================================================
Introduction
------------
This product adds pdf.js support for Plone.
Pdf.js is a JavaScript library for rendering PDF documents in the canvas,
without using external plugins; only JavaScript is needed.
.. _PDF.js Repository: https://github.com/mozilla/pdf.js
.. _collective.pdfjs Repository: https://github.com/collective/collective.pdfjs
This product will make the JavaScript library available as a resource, and
add a new view for the File content type.
Please note that pdf.js is still under heavy development; as such:
- a modern browser is required;
- not all PDFs may be rendered correctly, or at all;
Installation
------------
Using zc.buildout add ``collective.pdfjs`` to the list of eggs to install::
[instance]
recipe = plone.recipe.zope2instance
...
eggs =
...
collective.pdfjs
Re-run buildout, e.g. with::
$ ./bin/buildout
Restart your plone instance and install this addon.
Usage
-----
If the view detects a PDF file, it will attempt to render it inline using
pdf.js. If the user browser doesn't have JavaScript enabled, it will embed
any available PDF reader plugin (Acrobat's, Google Chrome native, etc) instead.
Additional information
----------------------
Currently, the whole document is downloaded and each page rendered
incrementally inside the canvas. This means that big files on slow connections
will take a while before displaying; you might want to switch to the standard
view in this case.
Source Code and Contributions
=============================
If you want to help with the development (improvement, update, bug-fixing, ...)
of ``collective.pdfjs`` this is a great idea!
The code is located in the
`github collective <https://github.com/collective/collective.pdfjs>`_.
You can clone it or `get access to the github-collective
<http://collective.github.com/>`_ and work directly on the project.
Contributors
------------
- Rigel Di Scala <zedr@zedr.com> <http://github.com/zedr>
- Marcel
- Jens Klein
- Benjamin Stefaner
- Maik Derstappen <md@derico.de> <http://github.com/MrTango>
Changelog
=========
1.0.5 (2024-07-26)
------------------
- Better CSS scoping for toolbar styles, to reduce side effects on other layout elements.
1.0.4 (2023-02-27)
------------------
- Add missing dependency on plone.app.upgrade
[MrTango]
1.0.3 (2023-02-27)
------------------
- Depend only on Products.CMFPlone not on Plone package
[MrTango]
1.0.2 (2022-11-04)
------------------
- Fix manifest file
1.0.1 (2022-11-04)
------------------
- hide upgrade steps in quickinstaller
[MrTango]
1.0 (2022-11-04)
----------------
- Overhaul to the most recent pdfjs release including its recent viewer.js
[jensens, benniboy]
- make it compatiple with Plone 6
[MrTango]
0.4.2
-----
- Tests: added a test on availableLayouts
This fails because the view is not present,
no idea why. Must recheck.
- Added human name for the view, after a suggestion by
Marcel
0.4.0
-----
- Tests: basic code coverage
- Reasonably minified pdf.js
0.3.6
-----
- Minified pdf.min.js
- Tested on Chrome and Firefox
0.2.2
-----
- Renders the Tracemonkey PDF
Raw data
{
"_id": null,
"home_page": "http://pypi.python.org/pypi/collective.pdfjs",
"name": "collective.pdfjs",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "plone zope pdf JavaScript",
"author": "zedr",
"author_email": "zedr@zedr.com",
"download_url": "https://files.pythonhosted.org/packages/1b/42/6efc58c889ca077c63f70c6fc5acfc7052d7912e5a6a4cfda66fad0b61e2/collective.pdfjs-1.0.5.tar.gz",
"platform": null,
"description": "collective.pdfjs - Plone integration for Mozilla's JavaScript PDF reader\n========================================================================\n\n\n\nIntroduction\n------------\n\nThis product adds pdf.js support for Plone.\n\nPdf.js is a JavaScript library for rendering PDF documents in the canvas,\nwithout using external plugins; only JavaScript is needed.\n\n.. _PDF.js Repository: https://github.com/mozilla/pdf.js\n.. _collective.pdfjs Repository: https://github.com/collective/collective.pdfjs\n\nThis product will make the JavaScript library available as a resource, and\nadd a new view for the File content type.\n\nPlease note that pdf.js is still under heavy development; as such:\n\n - a modern browser is required;\n - not all PDFs may be rendered correctly, or at all;\n\n\nInstallation\n------------\n\nUsing zc.buildout add ``collective.pdfjs`` to the list of eggs to install::\n\n [instance]\n recipe = plone.recipe.zope2instance\n ...\n eggs =\n ...\n collective.pdfjs\n\nRe-run buildout, e.g. with::\n\n $ ./bin/buildout\n\nRestart your plone instance and install this addon.\n\nUsage\n-----\n\nIf the view detects a PDF file, it will attempt to render it inline using\npdf.js. If the user browser doesn't have JavaScript enabled, it will embed\nany available PDF reader plugin (Acrobat's, Google Chrome native, etc) instead.\n\n\nAdditional information\n----------------------\n\nCurrently, the whole document is downloaded and each page rendered\nincrementally inside the canvas. This means that big files on slow connections\nwill take a while before displaying; you might want to switch to the standard\nview in this case.\n\nSource Code and Contributions\n=============================\n\nIf you want to help with the development (improvement, update, bug-fixing, ...)\nof ``collective.pdfjs`` this is a great idea!\n\nThe code is located in the\n`github collective <https://github.com/collective/collective.pdfjs>`_.\n\nYou can clone it or `get access to the github-collective\n<http://collective.github.com/>`_ and work directly on the project.\n\nContributors\n------------\n\n- Rigel Di Scala <zedr@zedr.com> <http://github.com/zedr>\n\n- Marcel\n\n- Jens Klein\n\n- Benjamin Stefaner\n\n- Maik Derstappen <md@derico.de> <http://github.com/MrTango>\n\nChangelog\n=========\n\n1.0.5 (2024-07-26)\n------------------\n\n- Better CSS scoping for toolbar styles, to reduce side effects on other layout elements.\n\n\n1.0.4 (2023-02-27)\n------------------\n\n- Add missing dependency on plone.app.upgrade\n [MrTango]\n\n\n1.0.3 (2023-02-27)\n------------------\n\n- Depend only on Products.CMFPlone not on Plone package\n [MrTango]\n\n\n1.0.2 (2022-11-04)\n------------------\n\n- Fix manifest file\n\n\n1.0.1 (2022-11-04)\n------------------\n\n- hide upgrade steps in quickinstaller\n [MrTango]\n\n\n1.0 (2022-11-04)\n----------------\n\n- Overhaul to the most recent pdfjs release including its recent viewer.js\n [jensens, benniboy]\n\n- make it compatiple with Plone 6\n [MrTango]\n\n0.4.2\n-----\n\n- Tests: added a test on availableLayouts\n This fails because the view is not present,\n no idea why. Must recheck.\n\n- Added human name for the view, after a suggestion by\n Marcel\n\n0.4.0\n-----\n\n- Tests: basic code coverage\n- Reasonably minified pdf.js\n\n0.3.6\n-----\n\n- Minified pdf.min.js\n- Tested on Chrome and Firefox\n\n0.2.2\n-----\n\n- Renders the Tracemonkey PDF\n\n\n",
"bugtrack_url": null,
"license": "GPL",
"summary": "pdf.js integration for Plone",
"version": "1.0.5",
"project_urls": {
"Homepage": "http://pypi.python.org/pypi/collective.pdfjs"
},
"split_keywords": [
"plone",
"zope",
"pdf",
"javascript"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "1b426efc58c889ca077c63f70c6fc5acfc7052d7912e5a6a4cfda66fad0b61e2",
"md5": "57d9aa36715bb0eccba5d5ffe02b912b",
"sha256": "71eb996c7b38cec851019d28bd3c877cdf7d7b9c3e5b43721d2fb86b29458324"
},
"downloads": -1,
"filename": "collective.pdfjs-1.0.5.tar.gz",
"has_sig": false,
"md5_digest": "57d9aa36715bb0eccba5d5ffe02b912b",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 485959,
"upload_time": "2024-07-26T07:49:05",
"upload_time_iso_8601": "2024-07-26T07:49:05.384101Z",
"url": "https://files.pythonhosted.org/packages/1b/42/6efc58c889ca077c63f70c6fc5acfc7052d7912e5a6a4cfda66fad0b61e2/collective.pdfjs-1.0.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-07-26 07:49:05",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "collective.pdfjs"
}