denature version 0.6.5
[ de-na-ture

To change the nature or natural qualities of.
To render unfit to eat or drink without destroying usefulness in other applications, especially to add methanol to (ethyl alcohol). ] http://dictionary.reference.com/search?q=denature

denature is a program to convert HTML files to PDF files. The HTML parsing is done by several perl modules off of cpan. The HTML is then converted into XSL-FO by denature (there is also, possibly, some SVG graphics added into the output file for some input tag elements). denature then calls FOP to render the XSL-FO into a PDF document.

denature was written at TrekLogic Software Solutions because the other programs investigated to do the HTML to PDF transform, did not fit the required parameters. denature grew out of this need. TrekLogic has decided to release denature to the public under the GPL v2 for other people who have similar requirements.

The beginnings of CSS support have been added to denature. It does not handle the contextual stuff, but simple elements are handled. It is currently working case insensitive for the element names, and case sensitive for the classes. This might change in the future to both being insensitive.

Installation

To see the install and execution procedures for denature run:

perldoc denature

Prerequisites

perl >= 5.005
HTML-Tagset
HTML-Parser
HTML-Tree
CSS::Tiny
FOP
JDK >= 1.3.1

Changes

See the file ChangeLog in the distribution for the changes to denature.

Testing

There is a test directory included which contains some simple HTML files which can be used to verify that the install is working correctly. The produced PDF should like similar to the HTML when viewed in a browser.

The tests can all be build from the test directory by executing:

make

or, individual test files can be built (while in the test directory) by:

make out/<test>.pdf

Support

Questions, bug reports, patches, and suggestions for denature should be sent to <dan.sinclair@treklogic.com>

Copyright

All files contained in this archive are licensed as stated in the COPYING file.

Disclaimer

The authors and TrekLogic take no responsibility for any damage this program may cause. This code has no warranty and may contain bugs. Use at your own risk.

References / Resources

FOP                 - http://xml.apache.org/fop
XSL spec            - http://www.w3.org/TR/xsl/
                      (chapter 6 is on XSL-FO)
XSL-FO reference    - http://www.zvon.org/xxl/xslfoReference/Output/index.html
HTML spec           - http://www.w3.org/TR/html4/
SVG spec            - http://www.w3.org/TR/SVG/ 
HTML-Tagset         - http://search.cpan.org/dist/HTML-Tagset/
HTML-Parser         - http://search.cpan.org/dist/HTML-Parser/
HTML-Tree           - http://search.cpan.org/dist/HTML-Tree/
CSS spec            - http://www.w3.org/TR/REC-CSS1

Thanks for downloading and trying denature. If you have any comments feel free to email me.

dan sinclair <dan.sinclair@treklogic.com>