slc.publications 1.1.1

A content type to store and parse pdf publications

.. contents::

.. Note!
-----

- code repository
- bug tracker
- questions/comments feedback mail


- Code repository: http://svn.plone.org/svn/collective/slc.publications
- Questions and comments to info (at) syslab (dot) com
- Report bugs at http://plone.org/products/slc.publications/



Change history
**************

osha.policy Changelog
=====================

slc.publications 1.1.1 (2009-06-04)
---------------------------------

- made a release without the svn revision in the tag

slc.publications 1.1 (2009-06-04)
---------------------------------

* added a download time estimation control [pilz]
* removed the hardcoded author from the config file and the schema [pilz]
* Trying to make it work without Linguaplone as well [pilz]
* added link to title and image [pilz]
* Added possibility to add manual relations to other content types. This
includes a language fallback [brand]


slc.publications 1.0 final
--------------------------

* no changes

slc.publications 1.0 beta3
--------------------------

* Added support for slc.xliff
* refactored the adapter.py into adapter/ subdir
* Added an eventhandler to automatically set the suptype on files added to a publication folder
* Added an eventhandler to detect the uploaded language if the filename starts or
ends with a lang abbrev
E.g. XX_filename.pdf or filename_XX.pdf or XX-filename.pdf or filename-XX.pdf.
* Added a patch for linguaplone inserting a new event to allow translating
subtyped objects. Translations need to be subtyped just after the object has
been created and before attributes are edited.

slc.publications 1.0 beta2
--------------------------

* Switch to p4a.subtyper to make publications out of files
* Use Archetypes.schemaextender to marry normal and publication attributes in one interface
* readded cover image generation

slc.publications 1.0 beta1
--------------------------

* Plone 3 compatibility. Removed the PublicationFolder concept and base completely on Linguaplone

slc.publications 0.9 beta
-------------------------

* initial release
Thanks to Alin Voinea for creating a Plone2.5 backport. Please see the svn repository for that.

Detailed Documentation
**********************

Publication Product
===================

The Publication Product can be used to organise printed publications that are available online for download. Such Publications usually have a publication date, order and ISBN numbers, an author and exist in several language versions. Once stored in the Publication Product, they can be displayed using autogenerated overviews.


Installation
------------

* Requires

- On Plone2.5: AdvancedQuery (http://www.dieter.handshake.de/pyprojects/zope/#AdvancedQuery)
(thanks to Alin Voinea for pointing that out)

- xpath that comes with pyxml
(http://sourceforge.net/project/showfiles.php?group_id=6473&package_id=6541&release_id=286213)
(thanks to Alin Voinea for pointing that out)

- p4a.subtyper, p4a.common, p4a.z2utils

- archetypes.schemaextender

- LinguaPlone (the product might run without but I have not bothered to make the calls to LP conditional yet...)


* Put this package in your Zope's Products directory and restart Zope

* use the QuickInstaller to add this product to your Plone site

* Optional: pdfinfo to parse pdf metadata (part of the xpdf package)

* Optional: pdftk and imagemagicks convert to generate a
cover image from a pdf file

Translations
------------
Note that the ATCT file object by default has a languageIndependent file attribute. That means that you can translate the Title and Description of a file object but not change the real file. Publications changes this behaviour for ATCT and Blob files.

LinguaPlone is patched
----------------------

the file linguaplone_addTranslation_patch patches linguaplones addTranslation method.
It simply adds a new event that is thrown after a translation is created but before
its data is set. This is necessary because on translation we need to subtype before we
can set any data, otherwise the schema will not be extended.

Documentation
-------------
See the *doc* directory in this package.



Contributors
************

- Jan-Carel Brand (Syslab.com GmbH)
- Wolfgang Thomas (Syslab.com GmbH)
- Alexander Pilz (Syslab.com GmbH)
- Alin Voinea for Testing and Plone 2.5 backporting