PDF workarounds

[Karsten Wade]

Jeff Fearn, doing some work for Red Hat out of Australia, took a long,
hard look at resolving our problems with the passivetex treatment of FO
in making PDFs.

His conclusion was, use a workaround in the XML.  This from a guy who
hates workarounds to bugs in the tools!  So, that carries extra weight
for me.

I want to hear from anyone who has problems with PDF output and if these
fixes help.  Let's get some repeatable problems together with existing
XML and file or support whatever bug reports we can.

Problem:  Poor Table Output

Reason: passivetex is not generating or passing adjustable column widths
properly.

Workaround:  Set fixed column widths in all your XML tables:

...
<tgroup cols="3">
  <colspec colnum="1" colname="Features" colwidth="3"
  <colspec colnum="2" colname="Features" colwidth="3"
  <colspec colnum="3" colname="Features" colwidth="1"
...

Problem:  Crashes on an image or cuts off the image.

Reason: ?

Workaround:  Set a fixed image size that is not too wide for a page; we
used to set no more than 4" for Red Hat documentation, since we printed
to a 5.5" W x 4.25" H page (iirc).

Does that cover all our current problems?

This current PDF output path is working pretty well.  It even accepts
PNG images for both on-screen and printed output formats. :)

Then we can have _two_ good, solid choices, which would be mighty nice.

- Karsten
-- 
Karsten Wade, RHCE *    Sr. Editor   * http://people.redhat.com/kwade/
gpg fingerprint:  2680 DBFD D968 3141 0115    5F1B D992 0E06 AD0E 0C41   
Fedora Documentation Project http://fedoraproject.org/wiki/DocsProject

Learn. Network. Experience open source.
Red Hat Summit Nashville  |  May 30 - June 2, 2006
Learn more: http://www.redhat.com/promo/summit/
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: This is a digitally signed message part
Url : http://lists.fedoraproject.org/pipermail/docs/attachments/20060323/0f4b362a/attachment.bin