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

[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 part
3. run ./bin/sphinx-quickstart (use all the defaults - no make file though)
4. run ./bin/sphinx-build -b html -d .build/doctrees . docs/html

Regards,
David


[buildout]
versions = versions
parts = sphinx
log-level = DEBUG

[versions]
Sphinx = 0.1.61950
Pygments = 0.9

[sphinx]
recipe = zc.recipe.egg
scripts = sphinx-quickstart
           sphinx-web
           sphinx-build
eggs = Sphinx
        docutils
        Pygments




David Pratt wrote:
> 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 <fairwinds at eastlink.ca> 
>> 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 
>>> should
>>> accommodate this with the template_bridge but have yet to investigate 
>>> this
>>> further.
>>
>> I agree with you that using zpt would be more preferable.  At this
>> point though I don't think we have an immediate need for it.  The only
>> change I made to the sphinx default template was adding some static
>> html for the zope branding.  Eventually though, if we want to build a
>> more robust documentation build tool with direct zope integration, zpt
>> would be absolutely necessary.  But if you are volunteering to
>> research using the template bridge, I'd be happy to use whatever you
>> come up with.
>>
>> - Paul
>>
>> -- 
>> Paul Carduner
>> http://www.carduner.net
>>
> _______________________________________________
> Zope-Dev maillist  -  Zope-Dev at 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 )
>