Re: patterns for using sphinx with the Zope Toolkit?

On Tue, Jan 12, 2010 at 12:35 PM, Chris Withers <[email protected]> wrote:
> Martijn Faassen wrote:
>> I am interested in creating sphinx-driven documentation for Zope Toolkit
>> packages. I'd like to maintain the documentation for a package (say,
>> zope.component) in that package, in a 'doc' directory.
>
> I have a couple of packages that make good use of the my current
> pattern-that-I'm-aiming-for-with-all-my-packages:
>
> http://packages.python.org/testfixtures/
>
> http://packages.python.org/checker/

I would support adding documentation to packages.python.org
It's very easy as Chris show.  I am also using a similar pattern
for BlueBream.

This is how I am uploading documentation for BlueBream:

./bin/sphinxbuilder;./bin/buildout setup . upload_sphinx

You can see the Buildout here:
http://svn.zope.org/bluebream/trunk/

In "setup.cfg", we can mention the "upload-dir" option like this:

  [upload_sphinx]
  upload-dir = docs/output/html

BTW, to upload docs, no need to make a new release.
Anyone who is having ownership can upload docs.

Regards,
Baiju M
_______________________________________________
Zope-Dev maillist  -  [email protected]
https://mail.zope.org/mailman/listinfo/zope-dev
**  No cross posts or HTML encoding!  **
(Related lists - 
 https://mail.zope.org/mailman/listinfo/zope-announce
 https://mail.zope.org/mailman/listinfo/zope )