[Grok-dev] Setting up apidoc with Grok

[Wichert Akkerman]

Previously Sebastian Ware wrote:
> I am trying to enable the APIdoc magic of Zope 3.
> 
> I have added "devmode on" to zope.conf. But it chokes on the zcml  
> directives I have added to my project configure.zcml file. Any ideas  
> what is wrong?
> 
> <configure xmlns="http://namespaces.zope.org/grok"
>            xmlns:browser="http://namespaces.zope.org/browser"
>            i18n_domain="protoncms">
>   <grok package="." />
> 
>   <browser:addMenuItem
>     class=".app.ProtonCMS"
>     title="ProtonCMS"
>     description="A simple CMS"
>     permission="zope.ManageContent"
>     />
> 
> </configure>
> 
> <configure xmlns:apidoc="http://namespaces.zope.org/apidoc"
>            xmlns:zcml="http://namespaces.zope.org/zcml"
>            zcml:condition="have apidoc">
> 
> 	    <apidoc:rootModule module="protoncms" />
> 
> 	    <apidoc:bookchapter
> 	        id="protoncms"
> 	        title="ProtonCMS"
> 	        />
> </configure>

You can not have two root elements in an XML file. Just put the apidoc
statements in the first <configure> block.

Wichert.

-- 
Wichert Akkerman <wichert at wiggy.net>    It is simple to make things.
http://www.wiggy.net/                   It is hard to make things simple.