[kde-doc-english]DocBook to HTML

[Lauri Watts]

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

On Wednesday 22 January 2003 04:26, Bob Lockie wrote:
> I use meinproc to convert docbook to HTML but it uses this style sheet:
> <link rel="stylesheet" href="help:/common/kde-default.css" type="text/css">
>
> What should I use to make it suitable to put on a web server like
> http://opensource.bureau-cornavin.com/crash-course/index.html?

"meinproc --stylesheet /path/to/kde-web.xsl index.docbook"

This will make the links ../common/ allowing you to have multiple versions of 
the document on a site, but only one need common directory.  This one uses a 
static copy of the images, and a defined page width, to make it a little more 
browser friendly.  There's also kde-online.xsl, which is the resizeable 
version you see in use on docs.kde.org.

to use xsltproc, you need to set up the SGML_CATALOG_FILES environment 
variable, to contain the KDE catalog (probably in 
$KDEDIR/share/apps/ksgmltools2/catalog) and add --catalogs to the 
commandline.    Xsltproc does work, it's what is used to create the copies on 
docs.kde.org, but it's a little touchy to work with when you're beginning. 
meinproc is only a thin layer around xsltproc which sets up some of these 
variables for you.

kde-web.xsl is from kdelibs and installed to 
$KDEDIR/share/apps/ksgmltools2/customization.

There's a couple of others there too, for differing purposes, I wrote a README 
that you can find here, describing the differences:
http://webcvs.kde.org/cgi-bin/cvsweb.cgi/kdelibs/kdoctools/customization/README

If anyone reading has CVS HEAD, it's in kdelibs/kdoctools/customization, along 
with the stylesheets.

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

iD8DBQE+LoXw/gUyA7PWnacRAjHnAJ40O5jfGjbF6NEdFQV/iIrZ7mEI+ACfe2Lu
6zTDS96EqgAAK9VfMrAH0+8=
=7FSx
-----END PGP SIGNATURE-----