forrest-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "ycdtosa" <>
Subject Re: Where is Docbook support going?
Date Thu, 06 Nov 2003 22:53:02 GMT
Hello, first post here... mind my poor English!

> From: "Juan Jose Pablos" <>
> > David,
> >
> > I do not think that we need to remove that stuff, but if you feel that
> > it needs to be done, well, just ensure that Norm Walsh style sheets
> > offers the same funtionality.

Well, it may help others to find their way to custom docbook processing..
anyway nwalsh stylesheets DO offer the same functionality,
however, mention of the partial DocBook support as a feature
may disapoint many people with higher expectations about it.

> > David Crossley wrote:
> > > I just started removing mention of the partial DocBook support.
> > > Then i stopped because i was not sure that we had reached consensus
> > > on this. Nobody spoke up about it after the below email, so does
> > > that mean that nobody is interested in the partial support idea?
> > > --David

I think the stuff should stay (as an example) and the notes about the
support should be rewritten so people dont feel fooled later.

and long ago he (david) also wrote:
> >>I think that we should dump that and concentrate on better
> >>documentation to describe how to configure full DocBook rendering.

Better doc is needed i agree on that too.

> > > On 2003-10-09 David Crossley wrote:
> > >
> > >>Jeff Turner wrote:
> > >>>Currently, our Docbook 'support' consists of a stylesheet called
> > >>>docbook2document.xsl, and a mass of DTDs.  I'd like to know where
this is
> > >>>all going.
> > >>>
> > >>>Firstly, is our aim to support all of Docbook, or even simplified
> > >>>Docbook?

i hope so..

> > >>>If no, we should define our supported subset in a DTD, so hapless
> > >>>don't try to use the full thing, only to discover Forrest doesn't
> > >>>it.  There's nothing more frustrating than not knowing a tool's
> > >>>limitations.

> > >>>If yes, we should turf out docbook2document.xsl right now, because
> > >>>to 'evolve' it to fully support Docbook is extremely foolhardy.  Norm
> > >>>Walsh has spent years working on his XSLTs.  We can't possibly
> > >>>
> > >>>What do people think?

IMO we should embrace the stylesheets from the's
i agree, we can not compete; those stylesheets are a beautiful work
and very modular.

work should be done on some css files to style/skin the output (on

> > >>
> > >>There are two aspects to DocBook support.
> > >>
> > >>One is the ability to validate DocBook xml source documents during
> >>the build. For that we need to provide DTDs (we do have some), or
> >>documentation about how to configure their own (we do have that), or
> >>a mechanism to download them if they are not on the user's system
> >>(we do have a proposal for that capability).
> >>
> >>The other aspect is rendering the DocBook documents. We have some
> >>documentation describing how to configure the full DocBook XSLTs.
> >>The problematic piece is the alternative (yet minimal)
> >>docbook2document.xsl which is not being enhanced or maintained.
> >>I think that we should dump that and concentrate on better
> >>documentation to describe how to configure full DocBook rendering.
> >>
> >>--David

On some other thread the option of "extending document v12 dtd"
its being discussed...

i want to point a fact here:
- Docbook is a very rich and powerful 'format'
- Document v12 (so does v20 as far as i know) is not that powerful as
and if u go from docbook to document you have to discard a lot of info in
the way

i did try to get some docbook document render with the dbk2doc aproach
and i got stock in the middle... there is no way to get a 'decent' support
without extending the document vx.x DTD... and then
    whats the point of extending it???
    we do have docbook.
    we do even have simplified docbook.!
    should we extend the document DTD in the Docbook direction?

I dont think thats the way to go.

PD.- one again sorry for my english.
and thanks!
ycdtosa - the present day composer refuses to die. (varese).
Ignacio Martinez

View raw message