Requirements

• Java 1.5.0 or higher (FOP 0.94 requires Java 1.6 or higher)
• csstoxslfo (included)

• XFC-4.0 (XMLMind) for ODT, RTF, DOCX and WML support (if needed)

• XINC 2.0 (Lunasil) for PDF support (commercial)

• or FOP 0.94 (Apache project) for PDF support (free)

• BeautifulSoup (will be installed automatically through easy_install. See Installation.)

• ElementTree (will be installed automatically through easy_install. See Installation.)

Installation

• install zopyx.convert either using easy_install or by downloading the sources from the Python Cheeseshop. This will install automatically the Beautifulsoup and Elementree modules if necessary.
• the environment variable $XFC_DIR must be set and point to the root of your XFC installation directory
• the environment variable $XINC_HOME must be set and to point to the root of your XINC installation directory
• the environment variable $FOP_HOME must be set and point to the root of your FOP installation directory

Supported platforms

Windows, Unix

Subversion repository

• http://svn-public.zopyx.com/viewvc/python-projects/zopyx.convert/trunk/

Usage

Some examples from the Python command-line:

from zopyx.convert import Converter
C = Converter('/path/to/some/file.html')
pdf_filename = C('pdf')         # using XINC
pdf2_filename = C('pdf2')       # using FOP
rtf_filename = C('rtf')
pdt_filename = C('odt')
wml_filename = C('wml')
docx_filename = C('docx')

A very simple command-line converter is also available:

xslfo-convert --format rtf --output foo.rtf sample.html

xslfo-convert has a --test option that will convert some sample HTML. If everything is ok then you should see something like that:

>xslfo-convert --test
Entering testmode
pdf: /tmp/tmpuOb37m.html -> /tmp/tmpuOb37m.pdf
rtf: /tmp/tmpuOb37m.html -> /tmp/tmpuOb37m.rtf
docx: /tmp/tmpuOb37m.html -> /tmp/tmpuOb37m.docx
odt: /tmp/tmpuOb37m.html -> /tmp/tmpuOb37m.odt
wml: /tmp/tmpuOb37m.html -> /tmp/tmpuOb37m.wml
pdf: /tmp/tmpZ6PGo9.html -> /tmp/tmpZ6PGo9.pdf
rtf: /tmp/tmpZ6PGo9.html -> /tmp/tmpZ6PGo9.rtf
docx: /tmp/tmpZ6PGo9.html -> /tmp/tmpZ6PGo9.docx
odt: /tmp/tmpZ6PGo9.html -> /tmp/tmpZ6PGo9.odt
wml: /tmp/tmpZ6PGo9.html -> /tmp/tmpZ6PGo9.wml

How zopyx.convert works internally

• The source HTML file is converted to XHTML using mxTidy
• the XHTML file is converted to FO using the great "csstoxslfo" converter written by Werner Donne.
• the FO file is passed either to the external XINC or XFC converter to generated the desired output format
• all converters are based on Java technology make the conversion solution highly portable across operating system (including Windows)

Known issues

If you are using zopyx.convert together with FOP: use the latest FOP 0.94 only. Don't use any packaged FOP version like the one from MacPorts which is known to be broken.

Author

zopyx.convert was written by Andreas Jung for ZOPYX Ltd. & Co. KG, Tuebingen, Germany.

License

zopyx.convert is published under the Lesser GNU Public License V 2.1 (LGPL 2.1). See LICENSE.txt.

Contact

Changes: