[Zope] Creating help files for Python Products

Jens Vagelpohl jens@zope.com
Thu, 13 Sep 2001 07:57:09 -0400


gitte,

here is an example for creating a help screen::

- in __init__.py in the initialize method call "context.registerHelp()"

- write a help file (can be either structured text or HTML) for your 
management screen tab and put it in a directory named "help" inside your 
product

- "connect" it to the specific management screen tab by adding it to the 
manage_options dictionary for the given tab, like...

manage_options = (
     {'label' : 'Configure', 'action' : 'manage_main',
       'help'  : ('MyProductName','HelpFileName.stx')},
     ...
     )

the first element in the tuple value for the "help" key is the name of 
your product and tells the help system under which "chapter" (the topmost 
list of items in the left-hand frame of a help screen) to put the screen 
designated by the filename in the second tuple element.

jens



On Thursday, September 13, 2001, at 07:27 , Gitte Wange wrote:

> Hello,
>
> I am working on a product for Zope and I was wondering: How do I create 
> help
> files that will turn up in the online help ??
>
> TIA,
> Gitte Wange
>