I'm not familiar with your process of implementing new features, but
the attached patch adds such option to z3c.recipe.sphinxdoc, comments
welcome.

Markus
Index: CHANGES.txt
===================================================================
--- CHANGES.txt	(Revision 99557)
+++ CHANGES.txt	(Arbeitskopie)
@@ -10,8 +10,11 @@
 
 - Feature: Changed building behavior so that the documentation for each
   package is built in it sown sub-directory.
+  
+- Feature: Added new option `extensions` which takes a whitespace
+  seperated list of sphinx extension modules. This extensions can be
+  used to build the documentation.
 
-
 0.0.7 (2009-02-15)
 ------------------
 
Index: src/z3c/recipe/sphinxdoc/index.txt
===================================================================
--- src/z3c/recipe/sphinxdoc/index.txt	(Revision 99557)
+++ src/z3c/recipe/sphinxdoc/index.txt	(Arbeitskopie)
@@ -105,4 +105,16 @@
   layout.html = /path/to/layout.html
 
 Note that you can either specify a path on the local file system or a
-url to an external css file.
\ No newline at end of file
+url to an external css file.
+  
+Use sphinx extension modules
+............................
+
+Sphinx provides a set of extensions, for example `sphinx.ext.autodoc`
+or `sphinx.ext.doctest`. To use such an extension change your
+configuration like::
+
+  [docs]
+  recipe = z3c.recipe.sphinxdoc
+  eggs = z3c.form [docs]
+  extensions = sphinx.ext.autodoc sphinx.ext.doctest
Index: src/z3c/recipe/sphinxdoc/__init__.py
===================================================================
--- src/z3c/recipe/sphinxdoc/__init__.py	(Revision 99557)
+++ src/z3c/recipe/sphinxdoc/__init__.py	(Arbeitskopie)
@@ -36,6 +36,7 @@
 html_style = 'default.css'
 html_static_path = ['%(staticDir)s']
 html_last_updated_fmt = '%%b %%d, %%Y'
+extensions = %(extensions)r
 """
 
 class ZopeOrgSetup(object):
@@ -122,7 +123,8 @@
                 release=metadata.get('Version', doc.version),
                 staticDir=staticDir,
                 templatesDir=templatesDir,
-                indexDoc=self.options.get('index-doc','index')
+                indexDoc=self.options.get('index-doc','index'),
+                extensions=self.options.get('extensions','').split()
                 ))
             confPy.close()
             installed.append(confPyPath)
_______________________________________________
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 )

Reply via email to