[kde-doc-english]Print output revisited

[Lauri Watts]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

At Coolo's prompting, took another try with passivetex. 

Results:
Short document, no images, no tables, nothing fancy in the markup:
	http://www.fruitsalad.org/kde/ksame.pdf (nearly perfect)
Short document, with images:
	http://www.fruitsalad.org/kde/kpat.pdf (with some twaking to the xsl, I 
managed to get the images in, but it seems to think it's finished after only 
a few pages.)
and, really impressive, long document, with very complex markup in many places 
(but no images):
	http://www.fruitsalad.org/kde/kmail.pdf (240 kb, 60+ pages)

Things that work well:
meinproc can use the standard DocBook XSL stylesheets to create FO files (it 
always could, just, the results weren't great before, they're apparently 
pretty good now.)

The output is really nice (other than the list of things that don't work well, 
below.)

It's going to be very simple to generate different paper formats, so we could 
offer A4 and US Letter without any trouble.

Things that worked not so well:
Page numbers/TOC references: I have an older version of pdftex, and to resolve 
these, you need to run pdftex twice on the same file.  Unfortunately, mine 
doesn't like to do that, so I'll try this again after I've upgraded.  

Images.  Look at the KPat doc, you'll see the quality is not terrific, but 
worse, it cuts off the document.  This could be due to interaction between my 
specific versions of pdftex/XSL stylesheets/libxslt.

Tables - there is a table on page 11 and I think page 39 of the kmail doc, and 
both are really broken.  I hope this will be just a tweak to a custom XSLT 
stylesheet, just mentioning it anyway, so that you know I'm aware it's 
broken.

I think this is still far to complex for general use, or to have the 
documentation generation by default on the end users systems, that will 
probably be some time away.  It is pretty clear though, we're getting closer 
to being able to create a set of pdf files that we could host on 
docs.kde.org, or distribute as a tarball for those who want them.

Regards,
- -- 
Lauri Watts
KDE Documentation: http://i18n.kde.org/doc/
KDE on FreeBSD: http://freebsd.kde.org/
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.0.7 (FreeBSD)

iD4DBQE9XOdg/gUyA7PWnacRApi+AJjNk61ywL8mqbbxfFwftYFdNLBGAJ4lTxnk
3w4B7dEGqXfKdcT0oAEOOw==
=BzSE
-----END PGP SIGNATURE-----