Re: [boost] Re: Reference documentation: one approach

From: Douglas Gregor (gregod_at_[hidden])
Date: 2002-11-02 16:18:47

On Saturday 02 November 2002 01:10 am, David Bergman wrote:
> So, we should extend DocBook, *but* with your preprocessing XSLs, so we
> can still enjoy the DocBook stylesheets and tools from the next node.

After a bit more reading, it seems that XSLT 1.0 doesn't directly support this 
model. That is, we can't transform an XML tree twice (C++ XML --> DocBook, 
DocBook->target format) without using either the not-yet-standardized XSLT 
2.0 or extensions in certain processors. Neither of these sounds like a good 
idea...

However, we can do it if we just separate the two steps: let Boost documents 
be in DocBook format, with the extra C++ XML declarations strewn throughout. 
The first stage will conver the C++ XML into DocBook markup without 
disturbing anything outside of the top-level C++ XML <header> tag. Then we'll 
have a well-formed DocBook document that can be run through the normal XSL or 
DSSSL processors to get useful HTML/PDF/whatever.

It's implemented now in the sandbox.

        Doug