[Zope3-dev] Questions about onlinehelp

[Roger Ineichen]

Hi Peter

Behalf Of Peter Koppatz
> Sent: Tuesday, May 10, 2005 9:33 AM
> To: zope3-dev at zope.org
> Subject: [Zope3-dev] Questions about onlinehelp
> 
> Hello All,
> 
> I have created some helppages for my application and want to connect 
> this helppages to the online helpsystem of zope 3.
> 
> 1.
> 
> I do that with:
> 
>    <configure zcml:condition="have onlinehelp">
> 
>      <help:register
> 	id="dictum"
> 	title="My first application"
> 	doc_path="./help/package_intro.rst"
> 	class="zope.app.onlinehelp.onlinehelptopic.RESTOnlineHelpTopic"
> 	/>
> 
>    <help:register
>        id="app.version01"
>        parent="dictum"
>        title="Version I"
>        doc_path="./help/version01/content.rst"
>        class="zope.app.onlinehelp.onlinehelptopic.RESTOnlineHelpTopic"
>        />
>    </configure>
> 
> That works fine.
> 
> If I put the configuration in an extra folder "help" and try 
> to include 
> it as a package:
> 
> <include package=".help" />
> 
> I got the message:
> 
> NameError: name 'helpsystem' is not defined
> 
> What is the missing piece?

Can you post the comfigure.zcml in the "help" folder?


> 2. The content of the online-help says:
> 
> The Online Help supports
> 
>      * plain text documents
>      * structured text documents
>      * restructured text documents
>      * HTML documents
>      * Page template based content
> 
> but HTML and ZPT's are rendered as resturctured text, so there is a 
> difference between reality and online help.
> Will that be changing in the future?

I don't understand this? What's not working? Do you really use 
a ZPT and also use the right class for the help:regsiter directive?

See src\zope\app\onlinehelp\tests\help.zcml this is what we test.

> 3. Ok, I am using resturctured text, but I can't use all german 
> characters. How can I configure other encodings for the online help?

What do you need?

> Regards,
> Peter

Regards
Roger Ineichen