Re: DOCBOOK-APPS: <variablelist><abstract>

[Bob Stayton <bobs@caldera.com>]

On Tue, Feb 04, 2003 at 08:16:04AM -0800, Bob Stayton wrote:
> On Tue, Feb 04, 2003 at 03:35:37PM +0100, Michael Wiedmann wrote:
> > For the following piece of DocBook XML the DocBook XSL 1.60.1
> > stylesheets don't generate HTML output for <variablelist><abstract>
> > (the same for <variablelist><para>, <variablelist><simpara>).
> > 
> > Is there an easy way to change this?
> > 
> > <variablelist>
> >   <title>Some Title</title>
> > 
> >   <abstract><para>variablelist abstract</para></abstract>
> > 
> >   <varlistentry>
> >      <term>...
> >   ...
> > </variablelist>
> 
> No easy way.  Variablelist's content model was changed
> in going from DocBook 4.1.2 to DocBook 4.2 DTD to permit
> "stuff" before the first varlistentry.  But the XSL
> stylesheets have not caught up with the change.
> You could file a bug report on the DocBook SourceForge
> project to get it fixed.

If you can't wait for a bug fix, you would need to copy
a template to your stylesheet customization layer
and fix it.  The template is 
<xsl:template match="variablelist"> in html/lists.xsl.

You would need to change two things.

Change:

    <xsl:choose>
      <xsl:when test="$presentation = 'table'">
        <table border="0">

to:

    <xsl:choose>
      <xsl:when test="$presentation = 'table'">
        <xsl:apply-templates select="*[not(local-name(.) = 'varlistentry')]"/>
        <table border="0">

and change:

  <dl>
    <xsl:apply-templates select="varlistentry"/>
  </dl>

to:

  <xsl:apply-templates select="*[not(local-name(.) = 'varlistentry')]"/>
  <dl>
    <xsl:apply-templates select="varlistentry"/>
  </dl>

The reason you need to fix it in two places is because
variablelists can be formatted using an HTML table (the
first change) if the parameter 'variablelist.as.table' is
set. Or they will be formatted using an HTML <dl> list (the
second change) if the parameter is not set.

I'll check these changes into CVS and take a look
at the fo side as well.


Bob Stayton                                 400 Encinal Street
Publications Architect                      Santa Cruz, CA  95060
Technical Publications                      voice: (831) 427-7796
The SCO Group                               fax:   (831) 429-1887
                                            email: bobs@sco.com


Bob Stayton                                 400 Encinal Street
Publications Architect                      Santa Cruz, CA  95060
Technical Publications                      voice: (831) 427-7796
The SCO Group                               fax:   (831) 429-1887
                                            email: bobs@sco.com