views:

254

answers:

3

I need to write on-line help (Eclipse help format) for an Eclipse plugin. I tried out the evaluation of Help Composer that comes as part of RCP Developer from Instantiations and it pretty much does what I am looking for. However at $500 per license it's way overkill and over budget for my needs.

Surely there must be some other tool for managing the help project, assembling the various files, table of contents, and editing the html documents using WYSIWYG.

Does anybody have any suggestions for what plugin(s) I should add to a basic Eclipse 3.5 install to give me full authoring capability?

Thanks in advance!

A: 

I don't think it exists in eclipse, but try the MS one (free): Here is the info: http://msdn.microsoft.com/en-us/library/ms670169%28VS.85%29.aspx

Here is the download: http://www.microsoft.com/downloads/details.aspx?displaylang=en&FamilyID=00535334-c8a6-452f-9aa0-d597d16580cc

Then you can convert to eclipse format: http://home.amnet.net.au/~ghannington/hh2e/hh2e-readme.html

waqasahmed
Thanks for the suggestion. However, I already created a bunch of content using the Eclipse Help format. I was hoping that I could just continue with the help project in native Eclipse format.
Dan C
+1  A: 

I know that my solution is not entirely what you need, but you should have a look at Mylyn Wikitext .

It uses a simple markup with good editor support and is also capable of exporting to Eclipse Help format.

Zoltán Ujhelyi
Thanks for this suggestion. However, it sounds like I would have to use different markup, which looks like it would break my existing content. I want to try to stay native format as much as possible, meaning straight HTML. If I have to, I will settle for a good HTML editor in Eclipse and manually edit the TOC.XML files as long as I have a way to actually run and test the project (which I don't know how to do without RCP Developer yet).
Dan C
A: 

I gave up looking for free since all the available tools have a lot of shortcomings.

I decided to use Adobe RoboHelp 8 since it has one of the nicest editors that I found. However, the main benefit for me has been that it automatically updates links in all pages if I rename or move a topic (which I do a lot).

When I want to generate the Eclipse Help file, I use the script that they provide.

Dan C