Look at Sphinx for providing brilliant access to ReST doc. http://sphinx.pocoo.org/
doing no more than adding a .. module:: <modname> directive to a ReST file causes it to be converted to html, latex or pdf indexed and searchable. placing <modname> in the .. toctree:: directive creates the proper links to the module doc I really think Sphinx can easily add a lot of value to existing Zope doc. >From that starting point, Sphinx offers lots of tools for enhancing access to, and presentation of, ReStructuredText It's being used for the official Python doc, no fly-by-night outfit. Thanks, Kent On Sat, Apr 5, 2008 at 3:10 PM, Paul Carduner <[EMAIL PROTECTED]> wrote: > > On Apr 5, 2008, at 12:11 PM, Martin Aspeli <[EMAIL PROTECTED]> wrote: > > > There's no content that isn't visible to anonymous on the site. > > > > Basically, we originally thought we would have one documentation/"learn" > section for all Zope technologies. However, it seemed to make more sense to > have a folder for each sub-project (zope 2, zope 3, cmf, zodb) and keep > documentation there. > > > > What questions do you have? > > > > Ah now I understand and found the Zope 3 section. One question I have is > how the site might integrate with the apidoc tool. At least with Zope 3, a > lot of good updated documentation lives in the svn repository in the form of > Restructured .txt files. All it would take to make these documents easier to > find and read is to hook them into apidoc and make a nicer skin for the > apidoc book section with the look and feel of the new site. Basically, I > want to write documentation once (in svn) and have it appear nicely > formatted in multiple places: pypi, apidoc, zope.org, and wherever else. > Will this be possible/is it part of the plan? > > -- > > Paul Carduner > http://www.carduner.net > _______________________________________________ > > Zope-Dev maillist - Zope-Dev@zope.org > http://mail.zope.org/mailman/listinfo/zope-dev > ** No cross posts or HTML encoding! ** > (Related lists -http://mail.zope.org/mailman/listinfo/zope-announce > http://mail.zope.org/mailman/listinfo/zope ) > _______________________________________________ Zope-Dev maillist - Zope-Dev@zope.org http://mail.zope.org/mailman/listinfo/zope-dev ** No cross posts or HTML encoding! ** (Related lists - http://mail.zope.org/mailman/listinfo/zope-announce http://mail.zope.org/mailman/listinfo/zope )