Re: [Zope-dev] Re: new zope.org, sphinx, and documentation management

2008-04-26 Thread David Pratt
Hi Paul. For what it's worth, here's what I am doing which seems to work without a new recipe at this point. The rest should be just the overrides for the templates I believe but not what else you are doing with your docs. 1. Create a docs/html folder in my buildout 2. Add the following sphinx

Re: [Zope-dev] Re: new zope.org, sphinx, and documentation management

2008-04-26 Thread David Pratt
Hey Paul. It's definitely something I want, so will examining this further and let you know if I come up with something. Regards, David Paul Carduner wrote: On Fri, Apr 25, 2008 at 5:48 AM, David Pratt <[EMAIL PROTECTED]> wrote: Hi Paul. Good work. Personally, I am interested in switching out

Re: [Zope-dev] Re: new zope.org, sphinx, and documentation management

2008-04-25 Thread Paul Carduner
On Fri, Apr 25, 2008 at 5:48 AM, David Pratt <[EMAIL PROTECTED]> wrote: > Hi Paul. Good work. Personally, I am interested in switching out the jinja > templates for zpt or ctal since am not that keen about mixing template > languages for myself. It looks like the more recent changes to sphinx shoul

Re: [Zope-dev] Re: new zope.org, sphinx, and documentation management

2008-04-25 Thread David Pratt
Hi Paul. Good work. Personally, I am interested in switching out the jinja templates for zpt or ctal since am not that keen about mixing template languages for myself. It looks like the more recent changes to sphinx should accommodate this with the template_bridge but have yet to investigate th

Re: [Zope-dev] Re: new zope.org, sphinx, and documentation management

2008-04-25 Thread Paul Carduner
After a fair amount of work figuring out Sphinx, I modified the default css and template to produce something that could be more or less seemlessly integrated into the new zope.org. Anyhow, I encourage everyone to take a look at http://docs.carduner.net/z3c.form/ for a working example. This weeke

Re: [Zope-dev] Re: new zope.org, sphinx, and documentation management

2008-04-24 Thread David Pratt
Hi Paul. This is beautiful. A recipe is what we need now. Send me a mail off list if you want some help with this. Regards, David Kent Tenney wrote: On Thu, Apr 24, 2008 at 2:09 AM, Paul Carduner <[EMAIL PROTECTED]> wrote: On Wed, Apr 23, 2008 at 10:48 PM, Paul Carduner <[EMAIL PROTECTED]> wr

Re: [Zope-dev] Re: new zope.org, sphinx, and documentation management

2008-04-24 Thread Kent Tenney
On Thu, Apr 24, 2008 at 2:09 AM, Paul Carduner <[EMAIL PROTECTED]> wrote: > On Wed, Apr 23, 2008 at 10:48 PM, Paul Carduner <[EMAIL PROTECTED]> wrote: > > On Wed, Apr 23, 2008 at 12:01 PM, Martin Aspeli <[EMAIL PROTECTED]> wrote: > > > > I would start with the simple HTML approach, personally. I

Re: [Zope-dev] Re: new zope.org, sphinx, and documentation management

2008-04-24 Thread Paul Carduner
On Wed, Apr 23, 2008 at 10:48 PM, Paul Carduner <[EMAIL PROTECTED]> wrote: > On Wed, Apr 23, 2008 at 12:01 PM, Martin Aspeli <[EMAIL PROTECTED]> wrote: > > I would start with the simple HTML approach, personally. It may be all we > > need. > > Hopefully there will be a first sample of this in t

Re: [Zope-dev] Re: new zope.org, sphinx, and documentation management

2008-04-23 Thread Paul Carduner
On Wed, Apr 23, 2008 at 12:01 PM, Martin Aspeli <[EMAIL PROTECTED]> wrote: > Hi Paul, > > I've tried to sum up my understanding of how Zope 3 fits in with the Zope > universe here: > > http://zode01.lovelysystems.com/projects > > Beyond that, I think Zope 3 is becoming more and more a collection

[Zope-dev] Re: new zope.org, sphinx, and documentation management

2008-04-23 Thread Simon Michael
Paul Carduner wrote: consumption than others). Few people know about this because the documentation is not aggregated anywhere (except for some bits on apidoc.zope.org). Not so! I recently did this at http://wiki.zope.org/zope3 . I hope it helps you.

[Zope-dev] Re: new zope.org, sphinx, and documentation management

2008-04-23 Thread Martin Aspeli
Hi Paul, I guess I have officially volunteered to write content for the new zope.org site in the zope 3 section. Part of that involves describing what zope 3 is in a concise manner. I realize there are probably a lot of different opinions about what zope 3 is, so I would like to solicit the co