At 15:07 07.09.2001 +1000, Jeff Turner wrote:
>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.
Hi Jeff,
The problem we are facing is different. We would like to generate printable user
documentation. The output does not need to resemble the jakarta site. I would be nice
to have a Java based tool to generate printable user documentation from Docbook.
However, the unavailability of a such a tool written in java is not IMO a show stopper.
If anyone wants to play around with Cocoon or any other java baased tool to parse
Docbook input is welcome to do so. I have been using jade (written C) to generate
documentation from Docbook SGML so far with reasonable results.
>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.
Yes, please. I would be very interested. If I understand correctly
you still need jade to render the Docbook generated by Coocon right?
Regards, Ceki
ps: A google search on "docbook coocon" returned only two hits. I conclude that Coocon
is not made to parse Docbook input.
>--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]
--
Ceki Gülcü - http://qos.ch
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
