Re: [docbook] Re: docbook 'role' attribute leakage

[Bob Stayton <bobs at sco dot com>]

On Tue, Mar 18, 2003 at 12:36:38PM -0500, Stefan Seefeld wrote:
> Bob Stayton wrote:
> 
> > Actually, there are only a few elements that propagate
> > the role attribute to the HTML class attribute.
> > Most do not.  You will have to write some customizations
> > to make more use of role for your purposes.
> 
> ouch !
> 
> > There is the generic inline container <phrase>,
> > but there is no generic structural container.
> > Adding a generic structural container would make
> > the structural rules a bit fuzzy, wouldn't it?
> 
> Indeed.
> 
> > Exactly what could be contained in what?
> 
> Well, right now I'm looking at artifacts ('templates') used
> when documenting software architecture, or high level design.
> And yes, may be something like 'role' would be good enough,
> but as you state, it's not even preserved in all cases.
> 
> And then, I was hoping to get some stylesheet support for
> automatically generating indexes for specific kinds of these
> elements.
> 
> > I guess I'm not clear why role with suitable customization
> > doesn't meet this need.
> 
> yes, it appears customization is the way to go, though I
> can't find much documentation about how the current stylesheet
> layout supports this. Any suggestions ?

There isn't much documentation on the stylesheet code.
You pretty much have to read it and figure out where
to make changes.

-- 

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 at sco dot com