xml-general mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Robert Koberg" <...@koberg.com>
Subject Re: +1 to Docbook ( was: Re: -1 to Anakia )
Date Mon, 16 Jul 2001 19:41:09 GMT
When this discussion started I thought it was about producing documentation
content that people could resuse when they ship their apps. In other words,
if the content was in docbook (even if it wasn't I suppose but its an extra
step), people could package the documentation for xalan, xerces, cocoon with
their own look and feel.

I would like to have that option for what I am doing.



----- Original Message -----
From: <cmanolache@yahoo.com>
To: <general@xml.apache.org>
Sent: Monday, July 16, 2001 12:36 PM
Subject: +1 to Docbook ( was: Re: -1 to Anakia )


> +1 for docbook
>
> It seems we have "old" stylebook, "new" stylebook, "jakarta-site" style
> ( or however the DTD is called ). AFAIK none of those are clearly
> documented or defined - and we have quite a few variations already.
>
> Everyone outside apache is using either DocBook or plain HTML - for the
> simple reason that those are the standards. We like to use XML because
> it's "standard", but when it comes to the DTDs and tag sets - we invent
> our own format(s).
>
> The result of this is visible in the current mess of tag styles and site
> generation.
>
> The idea that each project can invent it's own set of tags for
> documentations doesn't seem to work very well.
>
> Costin
>
>
> > > On 7/16/01 12:03 PM, "Davanum Srinivas" <dims@yahoo.com> 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.
>
>
> ---------------------------------------------------------------------
> In case of troubles, e-mail:     webmaster@xml.apache.org
> To unsubscribe, e-mail:          general-unsubscribe@xml.apache.org
> For additional commands, e-mail: general-help@xml.apache.org
>


---------------------------------------------------------------------
In case of troubles, e-mail:     webmaster@xml.apache.org
To unsubscribe, e-mail:          general-unsubscribe@xml.apache.org
For additional commands, e-mail: general-help@xml.apache.org


Mime
View raw message