Re: [docbook-apps] newbie help with DSSSL

[Yann Dirson <ydirson@fr.alcove.com>]

On Tue, Mar 30, 2004 at 09:23:34PM +1200, Thomas Clive Richards wrote:
> For example, the page numbers in the TOC are wrong.. they don't count the 
> pages the title page, and table of contnets take up.. this menas that the 
> page numbers in gv or kghostview don't match the page numbers in the TOC. Is 
> there a way to change this? I can't see any nice tag to do it...

This not a markup issue.  It is a consequence of how jadetex works:
you have to run (pdf)jadetex multiple times, until it does not
complain any more that "references have changes".

Some scripts can do that for you.  For example, sgml2x can do that
automatically (you can fetch it from savannah CVS -
https://savannah.nongnu.org/projects/alcovebook/ - or from
http://ftp.debian.org/debian/pool/main/s/sgml2x/ - if you install from
source, some fixes in the Debian diff may be useful).

I suppose docbook2x does as well.


> Also, things like changing text colours, specifying an image for the title 
> page, an image for *all* the page backgrounds.... little fine tunging 
> changes...

Except for background images, which are not supported by (open)jade as
of now, you can find examples in the AlcoveBook stylesheets at
http://savannah.nongnu.org/cgi-bin/viewcvs/alcovebook/alcovebook-sgml/stylesheet/dsssl/docbook/print/


> At the moment, I have a file called "stylesheet", and I'm converting the 
> docbook file like so:
> 
> docbook2pdf -d stylesheet booc.xml
> 
> Can someone please explain this? or point out the resources I'm missing ;)

Your xml file contains only "content" information, as opposed to
"presentation", which is defined by the stylesheet.  docbook2pdf is
part of the docbook2x package, and takes care of the details of
applying the stylesheet (as does docbook-2-html from sgml2x, with
different features).

Note that, if you're using XML for the markup, you may want to look at
XSL stylesheets, although I don't know what the current states of the
available toolchains are, wrt PDF generation.

HTH,
-- 
Yann Dirson <Yann.Dirson@fr.alcove.com>                 http://www.alcove.com/
Senior Free-Software Consultant          Consultant senior en Logiciels Libres
Debian developer (dirson@debian.org)                        Développeur Debian