Return-Path: Delivered-To: apmail-xml-cocoon-users-archive@xml.apache.org Received: (qmail 44104 invoked by uid 500); 22 Jan 2002 23:31:11 -0000 Mailing-List: contact cocoon-users-help@xml.apache.org; run by ezmlm Precedence: bulk list-help: list-unsubscribe: list-post: Reply-To: cocoon-users@xml.apache.org Delivered-To: mailing list cocoon-users@xml.apache.org Received: (qmail 44093 invoked from network); 22 Jan 2002 23:31:10 -0000 X-Originating-IP: [195.202.221.210] From: "Tibi DONDERA" To: References: <3C4DAAF0.5070500@rainyday.de> <20020122222917.21d46dc0.dwayne@java-fan.com> Subject: Re: help management system? Date: Wed, 23 Jan 2002 00:37:11 +0100 MIME-Version: 1.0 Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: 7bit X-Priority: 3 X-MSMail-Priority: Normal X-Mailer: Microsoft Outlook Express 5.00.2919.6700 X-MimeOLE: Produced By Microsoft MimeOLE V5.00.2919.6700 Message-ID: X-OriginalArrivalTime: 22 Jan 2002 23:31:17.0892 (UTC) FILETIME=[E4062C40:01C1A39C] X-Spam-Rating: daedalus.apache.org 1.6.2 0/1000/N 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" To: 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. > > To unsubscribe, e-mail: > For additional commands, e-mail: > > --------------------------------------------------------------------- Please check that your question has not already been answered in the FAQ before posting. To unsubscribe, e-mail: For additional commands, e-mail: