Comments on: FlashDevelop HelpPanel 1.4 Beta

By: slene

slene — Fri, 27 Mar 2009 14:37:54 +0000

this plugin is exactly what I was looking for!

too bad it doesn’t work with fd3…

By: Josh Tynjala

Josh Tynjala — Thu, 02 Nov 2006 01:23:35 +0000

You don’t need to put the source anywhere. I believe in providing source code whenever I can, so it’s there to allow you to learn from it or to extend the plugin if you wish.

By: Angus

Angus — Thu, 02 Nov 2006 01:08:50 +0000

Cheers, but maybe a note in the readme to say how to install the thing cos it’s really not all that clear. The dll is obvious enough, with the other dll’s in the plugins folder but the source folder? I mean I’ll work it out eventually but, gies a clue 🙂

By: Marcelo de Moraes Serpa

Marcelo de Moraes Serpa — Fri, 21 Apr 2006 14:10:16 +0000

Great work dude… I donÂ´t have FD installed here at work, but I canÂ´t wait to get home and put my hands on this new release, now things are getting really interesting! Once I test it I will get back here and express my opinions and sugestions.

Keep up the good work 😉

By: Igor

Igor — Thu, 13 Apr 2006 12:34:03 +0000

Unfortunately there is no complete solution for AS/component documenatation yet. But 2 of documentation generators can export Flash Help Panel compatible docs:
http://www.as2doc.com/
http://www.blinex.com/products/bldoc/

By: bruno

bruno — Wed, 12 Apr 2006 20:47:47 +0000

Wow that’s fast !
Thanks Josh. now we (at least you should) can paraphrase that famous osflash developper “no more coffe break while searching for help!” 😉
I do agree with Igor help inside flashdevelop would be cool but still it’s really cool as it is. (the livedocs search is faster than the call for the help panel in the flash IDE !!! maybe fasterfox helps it a tiny bit). Regarding the first time indexing message thingy, from my point of view don’t bother adding a new box, people playing around with FD know what indexing means (i hope so…).

Thanks again and continue good work.

By: Josh Tynjala

Josh Tynjala — Wed, 12 Apr 2006 16:39:39 +0000

If anyone else is interested, I found an article from Adobe about Extending Flash Help Panel Content. It gives information about the file formats used by Flash's help system. I should be able to write some code to generate similar xml files to be used with user-defined help sources. Since Lucene does some pretty heavy-duty analysis of the files, creating the xml files instead should be faster because I'll just be stripping html and storing the text. Hopefully search performance will be tolerable. Obviously, Flash uses this system, and so does the Flash Resource Manager, so it should be good. I'd like to hear additional thoughts as well.

By: Josh Tynjala

Josh Tynjala — Wed, 12 Apr 2006 15:41:01 +0000

Igor,

Thanks for your input. I plan to make use of the internal xmls for a help Contents panel eventually. This will allow the user to view the help without searching. I was not aware that there were tools that would generate these files for other help sources. I might be willing to look into using such a solution if the HelpPanel searches will be as fast as they are now. Can you point me to an example of one of these tools? Are there any open source tools like this? I quick Google search didn’t give me much hope.

I too would like to open help files directly inside FlashDevelop (as an option). However, the Internet Explorer control will not behave correctly. There seems to be a problem loading it from a plugin dll because I can modify FlashDevelop’s internal code and get it to work correctly. Phillipe and Mika would prefer not to include browser support, and I agree with their reasons. I may try to support an internal browser again at some point, but it’s not a priority.

By: Igor

Igor — Wed, 12 Apr 2006 13:35:00 +0000

That is really fast!
But I am not sure why you are not using standard help_toc.xml and help_search_index.xml files yet? There are already tools that create those automatically and existing documentation is based on that. Neglecting them is like not confirming to standards. Parsing could be faster and it could be easy to create browsable documentation. Another thing is that you rely on html title when building the index, instead of using name defined in help_toc.xml
Also, if documentation files could open directly inside FlashDevelop that would be great.
Flash Resource Manager does all of the above mentioned. It would just be much better having everything inside FlashDevelop.

Thanks.