Re: DOCBOOK: Bug at SGML DTD? Or at DSSSL stylesheets?

[Norman Walsh <ndw@nwalsh.com>]

/ Jorge Godoy <godoy@conectiva.com> was heard to say:
| I think that <para> shouldn't allow elements such as <figure> and
| <table> within it. The same for <mediaobject> and other similar
| elements. 

You can make a customization that is a strict subset of DocBook (and
therefore your instances are DocBook) that prohibits them.

There are three schools of thought on this issue:

1. Figures (and other block-ish) things should appear in paras.
2. Figures should not appear in paras.
3. Figures should appear in paras only if they are part of the paragraph
   from a semantic point of view.

I tend to prefer 3 myself, but I've been authoring toward 2 most of
the time because HTML takes position 2.

| Back to the problem, is this a bug in the DTD or at the DSSSL
| stylesheets (figures not appearing in LoF)? What can I do to correct
| it?

I think the release that I'll make tonight or tomorrow morning fixes
this problem. It's related to the broken ToC issue.

                                        Be seeing you,
                                          norm

-- 
Norman Walsh <ndw@nwalsh.com>      | A man can believe a considerable
http://www.oasis-open.org/docbook/ | deal of rubbish, and yet go about
Chair, DocBook Technical Committee | his daily work in a rational and
                                   | cheerful manner.--Norman Douglas