cocoon-users mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Tibi DONDERA" <tibidond...@hotmail.com>
Subject Re: help management system?
Date Tue, 22 Jan 2002 23:37:11 GMT
Thanks for all the ideas...

The main constraint is that it is not I nor the main programmer that will
write the help files (may they be xml, java code, html, or something else),
but a non-technical person. So the interface for writing these files must be
as simple as possible.

That's why I thought cocoon might be a nice alternative, since this person
can easily learn to write xml, but asking him to write Java, or even some
other file types, would be an extremely difficult task...

I also hoped to make this module as expandable as possible, so that it can
be reused...
JavaHelp seems like a good solution, I will propose it. And maybe use cocoon
for the creation of the web pages to be displayed inside, why not... it
seems like a good choice.


----- Original Message -----
From: "David BERNARD" <dwayne@java-fan.com>
To: <cocoon-users@xml.apache.org>
Sent: Tuesday, January 22, 2002 10:29 PM
Subject: Re: help management system?


> > This might be a litte OT, but I really have no other place to go...
> >
> > I have a Java application. Pretty big, actually, and still work in
progress.
> > And I'm required to build the help for it.
> >
> > The requirements:
> >   - modular: very easy to update/create the help files.
> >   - preferably web-based (viewable in a browser)
> >   - callable from the application (the usual F1 key)
>
> JavaHelp is a good tool for help management system (help file can be local
or on remote server).
> JavaHelp provide standard GUI with topic or index (if defined)
>
> > As this is clearly content/presentation separation, is Cocoon suited for
> > this kind of application?
>
> Yes and No. JavaHelp use xml files to define topic, aggregation... and
html 3.2 for contents.
> So you can write doc directly in html or you can use cocoon to provide
dynamicly thoses files (xml + html). You can also use cocoon to generate
staticly JavaHelp files (best choose depends of update time rate).
>
> If you use cocoon you need to define your content language.
>
>
> --
> --------------------------------------------------------------
> David "Dwayne" Bernard             Freelance Developer (Java)
>                                    mailto:dwayne@java-fan.com
>       \|/                          http://dwayne.java-fan.com
> --o0O @.@ O0o-------------------------------------------------
>
> ---------------------------------------------------------------------
> Please check that your question has not already been answered in the
> FAQ before posting. <http://xml.apache.org/cocoon/faqs.html>
>
> To unsubscribe, e-mail: <cocoon-users-unsubscribe@xml.apache.org>
> For additional commands, e-mail: <cocoon-users-help@xml.apache.org>
>
>

---------------------------------------------------------------------
Please check that your question has not already been answered in the
FAQ before posting. <http://xml.apache.org/cocoon/faqs.html>

To unsubscribe, e-mail: <cocoon-users-unsubscribe@xml.apache.org>
For additional commands, e-mail: <cocoon-users-help@xml.apache.org>


Mime
View raw message