OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

docbook-apps message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]

Subject: Re: [docbook-apps] newbie help with DSSSL

On Wed, Mar 31, 2004 at 08:58:17PM +1200, Thomas Clive Richards wrote:
> the following lines are used:
> (define ($page-number-format$ #!optional (gi (gi)))
>         "1")
> Apart from not knowing what it does, it's not listed *anywhere* in the DSSSL 
> documentation... I know, I've just been through the entire reference.

This is an overload of a function defined in the docbook-dsssl, which
defines the style of page numbering.  This one avoids to get roman
numbers in the ToC.

> Furthermore, in the extensions.dsl file, there are a few lines like:
> (define color-red (color rgb-color-space 1 0 0))
> I'm assuming that this defines the keyword "color-red" to a valid RGB color, 
> correct?


> why is this done? I can't see it being used anywhere else, in any of 
> the other files....

It's used in further, non-publicized customizations above these
stylesheets.  An example is:

      (make display-group
        color: color-red

> Where can I find this information?

I wrote this one solely using the DSSSL draft as documentation.  In
cas you don't have it, you can get it from

> in refcard.dsl, a similar line defines "bg-color". THis makes some more 
> sense.. is "bg-color" something the system looks for, when generating PDF's?

bg-color here is just a variable holding a color definition, like
color-red above.  It is used in refcard.dsl as a value for a
background-color: attribute.  This one is later used by pdfjadetex.

> ummm.. now I'm completely lost. I'm using docbook2x, and have read the man 
> page, but can't see anything about page numbers, or references...

Do you see docbook2pdf run pdfjadetex multiple times ?  Do you see any
message at the end of the run saying you must run pdfjadetex again ?

> I've looked through these, and I'm afraid I still don't understand... why are 
> some items defined in the DSSSL docs (I'm using these:
> http://docbook.sourceforge.net/release/dsssl/current/doc/print/index.html ), 
> but not others?

This is the documentation of the docbook-dsssl stylesheets, see URL
above for the doc of he DSSSL language.

> > 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).
> >
> Are you saying that the values I can modify in the stylesheet are dependant on 
> which converter I use? If so, which converter should I be using? 

No, I just mean that each of those scripts (docbook2x, sgml2x) can do
different operations aside from just applying the stylesheet.

> > 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.
> >
> Actually, I'm 99% sure that my markup could be XML or SGML, I'd just have to 
> change the filename.... I can't remember why I chose to use a .xml extension 
> on the files....

Well, it's the DOCTYPE line in your file which says which one you're using :)

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

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]