Yes, a new HAT for AGS would be perfect.
And by HAT, I don't mean a head accessory, but a Help Authoring Tool.
At the moment, AGS is relying on the .CHM format, and it's fine, but it is becoming risky to rely on this any longer, because the very very old tool "hhc.exe" used to produce it is a bit unstable on Windows 7. Calin suggested to move forward in this thread
.Which of these HATs do you recommend?
Pick one here: http://en.wikipedia.org/wiki/List_of_help_authoring_toolsThe requirements are :
1) Preferably the output should be produced from one big text file containing just a few markers (at the moment the original help file is a .tex file)
2) It must offer those 3 functions : a "contents
" section (where we can put selected articles on display, grouped by theme), an index
(a list of all the important keywords) and a search
Actually, Precision Helper
looks perfect. It has the freeware
license (see the details here
) and can work directly from the .hhp file...
Here are my first results with Precision Helper:
That's good enough except for the fact that the index is not sorted alphabetically. That's annoying but I'm pretty sure it can be fixed. I'll have a look at it later.
Oh, and the buttons are in French, but that's probably just a setting.
Test it on your own machine :
- html-based help version 0.9
- html-based help version 1.0 (fixes: menus in English, images no longer broken, Index in alphabetical order)
- html-based help version 1.1 (fixes: buttons "prev", "next" and "home" have their icons back)