plone.opendocument Package Readme
=========================


Introduction
------------

This package provides Opendocument to HTML transformations.

The OpendocumentToXHTML transformations are based on the odf2html style sheet
(http://opendocumentfellowship.org/repos/odf2html, svn r338 2007-02-15).
The improvements and changes to the original one are tracked in 
lib/odf2html/changelog.txt.

Common OpenDocument test files (like thesis.odt, letter.odt, invoice.ods) are 
in lib/odf2html/tests/commonUseCases.


Installing plone.opendocument
-----------------------------

This package requires:

    plone.transforms (https://svn.plone.org/svn/plone/plone.transforms)
    lxml (you can use the plone.recipe.lxml egg)
    PIL
    

Limitations
-----------

This product works well with ODT and  ODS files. Not supported are footer,
header, ole objects and internal links. ODP files are supported in a 
simple way.

Embedded image files are supported except file formats that are unsupported by PIL
(http://www.pythonware.com/library/pil/handbook/). Image formats that are not
supported by common browsers (like tiff) are converted to png.

Working with big files can cause great memory consumption.
Actually ATFile and lxml don't support streaming.
You can find some XML object models in python benchmarks: at 
"XML Matters: Process XML in Python with ElementTree" by David Mertz
http://www.ibm.com/developerworks/library/x-matters28/.