HelpSystem (was Documentation Team)

Previous Topic Next Topic
 
classic Classic list List threaded Threaded
1 message Options
Reply | Threaded
Open this post in threaded view
|

HelpSystem (was Documentation Team)

Torsten Bergmann
If you want to evaluate directly use:

  Installer squeaksource
     project: 'HelpSystem';
     install: 'HelpSystem-Core';
     install: 'HelpSystem-Tests';
     install: 'Metacello-Help';
     install: 'Pharo-Project-Help';
     install: 'Squeak-Project-Help';
     install: 'Linux-10Minutes'.
(Smalltalk at: #HelpBrowser) open.

Now with a 10 minutes guide on Linux ;)

>Does this tool support easy export of the model to other formats (e.g., text
>files on disk?) If not, how hard would this be to add?

The model = simple instances of HelpTopic. Look at this class
or check instances:

   Integer asHelpTopic inspect.  
   HelpOnHelp asHelpTopic inspect.  

Should be easy to recursively traverse the topic and
subtopics to write to disk. Original idea was to maintain
them in-image but you can have them external if you like.

You can even create them from external files (XML, ...)
if you want. There is no "authoring" mode/support yet - you
have to use the usual Smalltalk tools.

>Are the model objects happily storeString-able?

Yes:

 (HelpTopic title: 'Hello' contents: 'World') storeString

but if you serialize/deserialize you will get many Form
instances since a help topic can have an icon. These are
by default shared in a cache to save space by reusing
the same form. See class HelpIcon. This class can be
extended by your own packages or you provide own icons.

Bye
T.


--
GRATIS für alle GMX-Mitglieder: Die maxdome Movie-FLAT!
Jetzt freischalten unter http://portal.gmx.net/de/go/maxdome01



HelpBrowser.png (28K) Download Attachment