Re: [Webwork-user] Documentation?

[Rickard <ri...@jb...>]

Hi!

(Maurice, you have to remember to CC the list ;-)

"Maurice C . Parker" wrote:
> > The only problem I see with it is that the docbook and Xalan parsers
> > needed to convert XML to HTML are *HUGE*. This is no problem if you're
> > developing continuously since you'd get them once and be done with it,
> > but the CVS tar ball will be quite a lot larger.
> 
> Yes, but I wouldn't loose too much sleep over 2MB.

No, true.

> > Any thoughts on this?
> 
> The exolab uses an ant task that not only builds their docs, but builds their website from XML as well.  As far as XLST translations are concerned, it's fairly quick.

I couldn't get it to work with Ant. I saw that there were tasks in there
for the job, but it just wouldn't instantiate the Xalan processor.
*shrug*.

> Docbook has a learning curve, but is something of a standard in the Linux community.IIRC, the XML Apache community uses a simplified version of Docbook for it's docs.  It may be something to consider.

I'm ok with the full DocBook, but I'd prefer to use it with some editor.
I've tried XMLSpy(.com) but it doesn't work with the DocBook DTD
(doesn't even recognize "book" as top element, and crashes on save). Any
other ideas? Doing it by hand is ok, but some tool help to figure out
what elements are available would help.

> I'd like to see some kind of XML format is good, just because you can process it into HTML, PDF, etc...

Yes, that's my thinking too.

regards,
  Rickard

-- 
Rickard Öberg

Email: ri...@jb...