Re: TOOLS: Convert HTML to PDF, maybe with HTMLDOC?

Subject: Re: TOOLS: Convert HTML to PDF, maybe with HTMLDOC?
From: Sandy Harris <pashley -at- storm -dot- ca>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Tue, 25 Jun 2002 12:19:57 -0400


Joyce Fetterman wrote:
>
> I need to convert HTML docs to PDF to provide users a printable manual.
>
> I'd like to hear from any HTMLDOC users about your experiences with the
> product. There are no recent entries in the list archive. I'm concerned
> about the loss of CSS formatting in the conversion, and I want to hear about
> any other issues that may crop up!

I used it for batch conversion on the FreeS/WAN docs:
http://www.freeswan.org/doc.html

The batch stuff ran on a Linux server. I had the Windows version on a 98
machine, used it for some testing. Both worked fine, with no obvious
differences in output.

With one version on Linux, large files would cause it to run out of
memory and crash. Changing a #define in the source code and
recompiling fixed this. Neither the Windows version nor later Linux
versions exhibited the problem with my files. However, my total doc
set was 25,000 lines, 1.1 M bytes, largest file 2200 lines and 122 K
bytes. I don't know if the problem might re-appear for larger files.

There were various minor format oddities, many of which went away
when I switched from editing the HTML with a text editor to using
Amaya (free from w3c.org), an editor that enforces HTML standards.
If you're not using Amaya, I'd suggest running your HTML through
HTMLtidy (also w3c.org) before giving it to htmldoc.

The only user complaint I had was that htmldoc, in HTML-to-HTML
re-formatting, was adding font tags which some users disliked.
You can fix that with a one-line script. Mine is on the above
server, in doc/utils, called from doc/Makefile.

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Your monthly sponsorship message here reaches more than
5000 technical writers, providing 2,500,000+ monthly impressions.
Contact Eric (ejray -at- raycomm -dot- com) for details and availability.

Check out RoboDemo for tutorials! It makes creating full-motion software
demonstrations and other onscreen support materials easy and intuitive.
Need RoboHelp? Save $100 on RoboHelp Office in May with our mail-in rebate.
Go to http://www.ehelp.com/techwr-l
---
You are currently subscribed to techwr-l as: archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit
http://www.raycomm.com/techwhirl/ for more resources and info.



References:
TOOLS: Convert HTML to PDF, maybe with HTMLDOC?: From: Joyce Fetterman

Previous by Author: Re: SLAVE labor? Just a darn minute...
Next by Author: Re: Measurements in the UK
Previous by Thread: Re: TOOLS: Convert HTML to PDF, maybe with HTMLDOC?
Next by Thread: TOOLS: Convert HTML to PDF, maybe with HTMLDOC?


What this post helpful? Share it with friends and colleagues:


Sponsored Ads