cocoon-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Stefano Mazzocchi <stef...@apache.org>
Subject Re: Offer to help on Cocoon documentation
Date Sun, 04 Jun 2000 15:21:30 GMT
Gerard van Enk wrote:
> 
> Stefano Mazzocchi wrote:
> >
> > Giacomo Pati wrote:
> > >
> > > Pete Farmer wrote:
> > > >
> > > > [deletion happens]
> > > > >
> 
> <snip>
> 
> > > > 3) Stefano seems keen to get the stuff in DocBook - meaning
> > > > standard DocBook v4.0, which has just been released.
> > >
> > > A question to Stefano: Do we replace Stylebook with DocBook?
> >
> > What to you mean? Stylebook is a program, DocBook is a DTD.
> >
> > If you mean: replace current DTDs with DocBook, yes, that's the plan.
> >
> > Why? Well, mostly because:
> >
> > 1) it's a very complete DTD and documentation is free and very good
> > 2) almost all projects are converging to use DocBook for documentation
> > 3) we have HTML and FO stylesheets (Norman's)
> > 4) allows us to generate a "book" out of "article"'s (a full PDF, like
> > the Xerces folks did)
> 
> Will there be a stylesheet with which we can convert all the existing
> documentation using the Stylebook dtd's to DocBook dtd?

No, but shouldn't be hard to outline a simple one.

On the other hand, docbook is _more_ structured than our DTDs, so you
can't simply stylesheet it, you have to human edit them in some
locations.... but the first pass will be made with a stylesheet, I
agree.

-- 
Stefano Mazzocchi      One must still have chaos in oneself to be
                          able to give birth to a dancing star.
<stefano@apache.org>                             Friedrich Nietzsche
--------------------------------------------------------------------
 Missed us in Orlando? Make it up with ApacheCON Europe in London!
------------------------- http://ApacheCon.Com ---------------------


Mime
View raw message