On Thu, Sep 06, 2001 at 10:28:15PM +0200, Bernard D'Have wrote:
> I think that jakarta Avalon project use cocoon dor Html generation from
> Docbook
Avalon does this. But it's not as simple as "hooray, let's use docbook",
because it needs to generate a *jakarta* site, not any random HTML.
Avalon converts docbook to the existing "stylebook" XML, and then uses
the standard XSLs to render that into a jakarta website.
It actually uses Cocoon 2 in "offline mode" to do the rendering. This
allows the whole "website" to be planned in the sitemap, which is
wonderfully flexible. The problem with using Cocoon is that it's an
addition 2.4mb of jars to download, and it's probably using a
sledgehammer to crack a nut.
I have a self-contained example of Cocoon-generated, Docbook-based docs
if anyone wants.
--Jeff
> Bernard
>
> > -----Original Message-----
> > From: Ceki Gülcü [mailto:[EMAIL PROTECTED]]
> > Sent: 06 September, 2001 8:57
> > To: LOG4J Developers Mailing List
> > Subject: RE: [POLL] Documentation in Docbook
> >
> >
> > At 07:07 06.09.2001 +0100, Jon Skeet wrote:
> > >> I have started migrating log4j documentation to Docbook. Many
> > >> Linux documents
> > >> are written using DocBook which can export to many different
> > >> formats including
> > >> html, tex, rtf, pdf and ps. I am not a Docbook expert but it
> > >> seemed reasonably
> > >> easy to learn particularly given that it is such a powerful tool.
> > >>
> > >> Does anyone object or has better ideas? Thanks, Ceki
> > >
> > >Are there any Java DocBook exporters? It would be nice to keep
> > the docs build platform-independent as well as the source building.
> >
> > Not to my knowledge, there are no Java exporters. Jade (the
> > Docbook) exporter exists on linux and Windows. It should be
> > possible to compile jade (written in C) on other platforms as well.
> >
> > I am not worried about platform independence for doc building.
> > The vast majority of people just read the documentation. Only
> > very few people write it, let alone build it. Cheers, Ceki
> >
> >
> > --
> > Ceki Gülcü - http://qos.ch
> >
> >
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: [EMAIL PROTECTED]
> > For additional commands, e-mail: [EMAIL PROTECTED]
> >
> >
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: [EMAIL PROTECTED]
> For additional commands, e-mail: [EMAIL PROTECTED]
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
