Welcome, guest | Sign In | My Account | Store | Cart

Notice! PyPM is being replaced with the ActiveState Platform, which enhances PyPM’s build and deploy capabilities. Create your free Platform account to download ActivePython or customize Python with the packages you require and get automatic updates.

Download
ActivePython
INSTALL>
pypm install aws.pdfbook

How to install aws.pdfbook

  1. Download and install ActivePython
  2. Open Command Prompt
  3. Type pypm install aws.pdfbook
 Python 2.7Python 3.2Python 3.3
Windows (32-bit)
1.0.1
1.0.3Never BuiltWhy not?
1.0.1 Available View build log
1.0.0 Available View build log
1.0.0b1 Available View build log
Windows (64-bit)
1.0.1
1.0.3Never BuiltWhy not?
1.0.1 Available View build log
1.0.0 Available View build log
1.0.0b1 Available View build log
Mac OS X (10.5+)
1.0.1
1.0.3Never BuiltWhy not?
1.0.1 Available View build log
1.0.0 Available View build log
1.0.0b1 Available View build log
Linux (32-bit)
1.0.1
1.0.3Never BuiltWhy not?
1.0.1 Available View build log
1.0.0 Available View build log
1.0.0b1 Available View build log
Linux (64-bit)
1.0.3 Available View build log
1.0.1 Available View build log
1.0.0 Available View build log
1.0.0b1 Available View build log
 
License
GPL
Dependencies
Lastest release
version 1.0.3 on Jan 9th, 2014

Description

aws.pdfbook is a component for Plone 3 or Plone 4 that enables to download content rendered to PDF. It provides support for default content types. Third party content type authors and integrators may add support to their personal content types through dedicated Zope 3 named views.

When downloading a Folder or a Topic/Collection, all subcontents is included in the PDF document but not recursively.

Warning

htmldoc requires ISO latin 9 encoded HTML. As a consequence, this component is suitable only to site in western european languages. We cannot support Hebrew, Arabic, (...) as long as htmldoc does not support UTF-8.

Requirements

The following softwares should be installed:

  • Tested with Plone 3.x, Plone 4.0, Plone 4.1.
  • htmldoc (required)
  • recode (optional)

Installation

Instance wide

In your buildout.cfg file:

[buildout]
...
eggs =
  ...
  aws.pdfbook

We assume that:

  • The site charset is utf-8
  • The server buffer for downloading has 40000 bytes.

Otherwise you can change these default values in your zope.conf or in buildout.cfg like this:

[instance]
recipe = plone.recipe.zope2instance
...
zope-conf-additional =
  ...
  <product-config aws.pdfbook>
  # Your site charset (default: utf-8)
  site-charset utf-8
  # The download buffer bytes size (default: 40000)
  download-buffer-size 40000
  </product-config>
  ...

Note

Increasing the buffer size may speed up download but at the expense of a bigger memory footprint.

Plone site

In your Plone site go to the 'Site Setup' page and click on the 'Add/Remove Products' link.

Choose aws.pdfbok (check its checkbox) and click the 'Install' button.

The go as soon as possible to the PDF Book configuration panel and configure according to your system settings and your layout preferences.

More particularly, you may change default pdfbook options. See the pdfbook documentation for the various available options.

Other setups

It is strongly recommanded to use linking with UID in your visual editor preferences. Otherwise images may not display in topics prints.

Developers

Customizing default templates in ZMI

Open your Plone site in ZMI, then the portal_view_customization object.

Click on a link printlayout that suits the interface of the content items you want to customize.

Change the template as you prefer...

Add a template for your content types

Assuming you have a personal content type that implements the myproduct.interfaces.IMyContentType interface, You must add a view like this one:

<browser:page
   name="printlayout"
   for="myproduct.interfaces.IMyContentType"
   layer="aws.pdfbook.interfaces.IAWSPDFBookLayer"
   permission="zope.Public"
   template="templates/mycontenttype.pt"
   />

Keep the following attributes as above:

  • name="printlayout"
  • layer="aws.pdfbook.interfaces.IAWSPDFBookLayer"
  • permission="zope.Public"

Examples for standard content types are provided in the browser/transformers.zcml configuration and associated files.

Otherwise aws.pdfbook provides a default template that may or may not fit with paper layout.

Important

Your personal template:

  • must provide a "body" macro that renders the body of your content.
  • the title of your content must be in an <h1> element.
  • must be careful with HTML limitations of htmldoc.

If the default layout for personal or third party content types is somehow awful, you may blacklist such content types in the configuration panel.

Contributors

The subversion repository for this component is https://svn.plone.org/svn/collective/aws.pdfbook .

The development kit comes with a buildout.cfg for the latest Plone stable version.

Please don't forget to file your changes in the docs/HISTORY.txt file.

Support

Please use the tracker at http://plone.org/products/aws.pdfbook/issues

Credits

http://www.materis.com/template/imgs_fr/logo.gif

Changelog

1.0.3 (2013-08-27)
  • Nothing changed yet.
1.0.2 (2013-08-27)
  • Fixed getting image scales. [thomasdesvenain]
  • Plone 4.3 compatibility. [thomasdesvenain]
1.0.1 (2011-12-22)
  • Export FSImage in pdf. [vincentfretin]
  • Fixed recoding of windows apostroph and '...' character. [vincentfretin]
  • Synced atevent.pt with latest event_view.pt template from Products.CMFPlone so the messages are translated properly. [vincentfretin]
  • Avoid site error at conversion when img tag has no src attribute... [thomasdesvenain]
1.0.0 (2011-09-22)
  • Image is not exported if user has not the right to View it. [thomasdesvenain]
  • Image export works with images referenced with a size. Image is printed with the good size. [thomasdesvenain]
  • Disable export link in portal factory. [thomasdesvenain]
  • Avoid failures on viewlet kss updates. [thomasdesvenain]
  • Image export works with image custom types and blob images. So image export now works under Plone 4. [thomasdesvenain]
  • Plone 4.1 compatibility. [thomasdesvenain]
1.0.0b1
  • i18nisation and added french translation [glenfant]
  • Unit tests [glenfant]
  • Cleaned up useless code from Products.PDFBook [glenfant]
1.0.0a1
  • Initial release [glenfant]

Subscribe to package updates

Last updated Jan 9th, 2014

Download Stats

Last month:3

What does the lock icon mean?

Builds marked with a lock icon are only available via PyPM to users with a current ActivePython Business Edition subscription.

Need custom builds or support?

ActivePython Enterprise Edition guarantees priority access to technical support, indemnification, expert consulting and quality-assured language builds.

Plan on re-distributing ActivePython?

Get re-distribution rights and eliminate legal risks with ActivePython OEM Edition.