denature[ 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). ] dictionary.com |
|
[ What ] |
denature is a perl program that attempts to convert an HTML page into XSL-FO which it
then passes off to the FOP (Formatted Objects Formatter)
to produce a PDF document. denature was originally developed at
TrekLogic Software Solutions, but it was decided to release denature back to the community
in the hopes that other people would find it useful.
denature trys to use any included CSS stylesheets to figure out the properties used in the document. The CSS processing in denature is not very mature and only handles a limited amount of the available CSS markup. The CSS support does not handle the contextual entries in a CSS document, and the CSS::Tiny module requires that all the :'s in a document have a space after them. The HTML processing in denature is done by several perl modules: While the CSS processing is done by the CSS::Tiny module (cpan). denature can add page breaks into the output pdf file. The placement of the page breaks is controlled by comments inside the HTML file. When a page break is desired place a <!-- PAGEBREAK --> command and a new page will be started before the next block of text. This can have funny consequences if the pagebreak is place inside a table data cell, so be careful where the break is placed. The drawing of the checkboxes and radio buttons is handled through the use of simple SVG (scalable vector graphics). Of the other <form> elements, only text and textarea are handled, these are both just printed as normal text. <option> tags are ignored. |
|
[ Installation / Execution ] |
SYNOPSIS denature [-i dir] [-c dir] [-l] [-f] [-e] [-w] [-d] [-h] input output OPTIONS -i dir -- image directory. Directory where images used in the HTML document are located. -c dir -- css file directory. Directory where the CSS file used is located, if needed. -l -- landscape mode. Will attempt to print the PDF as a landscape page (EXPERIMENTAL). -f -- footer. Will print a footer on the bottom of each page. The footer is of the format: p. |
|
[ Contact info ] |
If you have any questions or comments about the denature program, you can either
email me directly at the address below, or send a message to the mailing list (Available through
the Sourceforge project page, see Resources section).
|
|
[ License ] |
denature has been released under the GPL v2. Which can be viewed online
here. As the program is GPL, the authors
take no responsability for any problems with the program. Use it at your own risk.
|
|
[ Resources ] |
|
|
This page copyright 2003, Dan Sinclair |