Package: aws.pdfbook
Descriptionaws.pdfbookis 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.Warninghtmldocrequires 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.RequirementsThe following softwares should be installed:Tested with Plone 3.x, Plone 4.0, Plone 4.1.htmldoc (required)recode (optional)InstallationInstance wideIn yourbuildout.cfgfile:[buildout]
...
eggs =
  ...
  aws.pdfbookWe assume that:The site charset isutf-8The server buffer for downloading has 40000 bytes.Otherwise you can change these default values in yourzope.confor inbuildout.cfglike 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>
  ...NoteIncreasing the buffer size may speed up download but at the expense of a
bigger memory footprint.Plone siteIn your Plone site go to the ‘Site Setup’ page and click on the ‘Add/Remove
Products’ link.Chooseaws.pdfbok(check its checkbox) and click the ‘Install’ button.The goas soon as possibleto thePDF Bookconfiguration panel and
configure according to your system settings and your layout preferences.More particularly, you may change defaultpdfbookoptions. See thepdfbook
documentationfor the
various available options.If you want to use logo in headers, you just have to setup the path to get the
logo on Logo path field.Don’tset –logo option in htmldoc options,
this is done by the system. But you may use –webpage option.Other setupsIt is strongly recommanded to use linking with UID in your visual editor
preferences. Otherwise images may not display in topics prints.DevelopersCustomizing default templates in ZMIOpen your Plone site in ZMI, then theportal_view_customizationobject.Click on a linkprintlayoutthat suits the interface of the content items
you want to customize.Change the template as you prefer…Add a template for your content typesAssuming you have a personal content type that implements themyproduct.interfaces.IMyContentTypeinterface, 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 thebrowser/transformers.zcmlconfiguration and associated files.Otherwiseaws.pdfbookprovides a default template that may or may not fit
with paper layout.ImportantYour 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.ContributorsThe github repository for this component isgit@github.com:collective/aws.pdfbook.git .The development kit comes with abuildout.cfgfor the latest Plone stable
version.Please don’t forget to file your changes in thedocs/HISTORY.txtfile.SupportPlease use the tracker athttp://plone.org/products/aws.pdfbook/issuesCreditsOriginal version for Plone 2.x byJohn DoePlone 3.x support byGilles LenfantforAlter Way SolutionsSponsored byMaterisMaintained byThomas DesvenainChangelog1.1 (2014-02-26)Keep &, < and > characters in pdf.
[vincentfretin]Replace unicode mdash by simple ascii dash.
The mdash character was replaced by ‘?’ in pdf before.
[vincentfretin]Added a ‘logo’ property to allow us to use htmldoc logo options in headers.
[thomasdesvenain]Brazilian translations.
[lepri]1.0.3 (2013-08-27)Fixed release.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.0b1i18nisation and added french translation
[glenfant]Unit tests
[glenfant]Cleaned up useless code from Products.PDFBook
[glenfant]1.0.0a1Initial release
[glenfant]