Re: [docbook-apps] glossary missing from xhtml output

["Bob Stayton" <bobs@sagehill.net>]

This is a bug in the stylesheet that only appears with DocBook5.   A 
glossary can contain any number of preamble elements like paragraphs and 
lists before the glossary entries.  The glosslist element was included in 
the preamble set, although it probably doesn't make much sense in that 
context, but it is permitted.  In DocBook4, at least one glossdiv or 
glossentry was required after any preamble.  The stylesheet relied on that 
content model to select the preceding siblings preamble material.

In DocBook5, an empty glossary is permitted, because a glossary can be 
built automatically from glossterms in the document.  In effect, your 
glossary had a preamble (the glosslist) but was otherwise empty, and the 
stylesheet wasn't expecting that.  So the stylesheet needs to be updated to 
handle the new content model.

Can you please file a bug report on the SourceForge site so this doesn't 
get lost?  Thanks.

Bob Stayton
Sagehill Enterprises
DocBook Consulting
bobs@sagehill.net


----- Original Message ----- 
From: "Brett Leber" <bleber+@cs.cmu.edu>
To: "Mauritz Jeanson" <mj@johanneberg.com>
Cc: <docbook-apps@lists.oasis-open.org>; "Dennison, Cheri" 
<cherid@amazon.com>
Sent: Thursday, August 16, 2007 1:04 PM
Subject: Re: [docbook-apps] glossary missing from xhtml output


> On 8/11/2007 7:27 AM, Mauritz Jeanson wrote:
>> I can't reproduce this. When I use your customization + 1.73.0 (or 
>> 1.72.0)
>> to process the following file (with xsltproc),
> ...
>> The glossary chunk looks fine.
>
> Investigated this further.
>
> In my document (this one happens to be an article and not a book, but I 
> had the same problem), I had the glossentry elements wrapped in a 
> glosslist. When I simply added a single glossentry *after* the glosslist, 
> all of the items (both in glosslist and outside) appeared in the XHTML 
> output. I then removed the glosslist wrapper, and all of the entries 
> appeared in the output.
>
> The glosslist wasn't serving any purpose, so I don't need it. But TDG v5 
> says that glossary can contain glosslist:
>
> http://docbook.org/tdg5/en/html/glosslist.html
> http://docbook.org/tdg5/en/html/glossary.html
>
> Is this a bug?
>
> Thanks again,
>
> Brett
>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
> For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org
>
>
>