Re: -1 to Anakia

[Berin Loritsch]

Jason van Zyl wrote:
> 
> On 7/16/01 12:03 PM, "Davanum Srinivas" <[EMAIL PROTECTED]> wrote:
> 
> > Jason,
> >
> > In the long run am ok to using anything to do the docs and site. In the short
> > term, let us at
> > least stick to the Stylebook DTD's since every other project in the xml family
> > are already in this
> > format. When we decide to move forward, let us push all the projects to move
> > forward.
> 
> I would rather wait until c2 is done, I would rather not use another
> format. I am used to the tags of Anakia, but I fully agree with using
> standard DocBook tags. I would rather use DocBook tags myself anyway. This
> is what c2 will accept, yes? If so I would rather go that route. Stylebook
> is in the past for me and I don't want to use it again.
> 
> I think that using DocBook as the input is very wise, and I would like
> to get Anakia using DocBook as there are so many tools for DocBook than
> at least two apache projects would be using the same format. Geir has
> wanted to do this for a while but no time. But if we all used DocBook
> than it doesn't really matter what produces the final output. xml.apache.org
> can eat its own dogfood, and jakarta.apache.org can do the same.
> 
> I would be happy to try c2 using DocBook.

Take a look at http://jakarta.apache.org/avalon/developing/index.xml

The whole "Developing with Avalon" book is written in DocBook 4.1 format--
and uses Cocoon to style the site.  It is possible.  The only shortcomming
is autogenerating the Table of Contents (ToC).  The approach I used is to
embed XInclude statements that link to the different Chapters.  Every linked
page is an entry for the ToC.  Getting the title from the other files was
a bit more difficult.  I will attempt to try a different approach soon.

It is amazing what Apache products can do right now.  I haven't created the
PDF generation portion yet--but it is only a matter of time.

S/MIME Cryptographic Signature