------------------------------------------------------------------------------
  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>



