Changeset 5332

Timestamp:

29 Jul 2010, 13:24:20 (14 years ago)

Author:

uli

Message:

Replace the old sphinxbuilder recipe by something that only creates scripts
for calling sphinx directly.

This way we can maintain docs in an own directory where we can also
finetune the configuration, layout, etc.

I think it is also more obvious to see, how documentation generation
works, as it is not hidden away in parts/ any more.

Instead we now have docs/sources and docs/build where things get
generated. Please do not checkin files in build (except the makefiles
already there), as stuff in there will be regenerated each time we
create new documentation.

File:

• main/waeup.sirp/trunk/buildout.cfg (modified) (3 diffs)

main/waeup.sirp/trunk/buildout.cfg

@@ -2 +2 @@
 develop = .
 parts = app data zopectl i18n test waeupdocs coverage-detect coverage-report
-find-links = http://download.zope.org/distribution/
+#find-links = http://download.zope.org/distribution/
 #newest = false
 #extends= http://grok.zope.org/releaseinfo/grok-1.0.cfg
@@ -19 +19 @@
 #hurry.zoperesource = 0.4
 megrok.layout = 1.0.2
-Sphinx = 0.6.4
 hurry.resource = 0.4.1  # We need to pin this as hurry.resource 0.9
                         # requires extra packages (WebOb) we don't
@@ -108 +107 @@
 
 [waeupdocs]
-recipe = z3c.recipe.sphinxdoc
-eggs = waeup.sirp [docs]
-default.css =
-layout.html = 
-extensions = sphinx.ext.autodoc
+recipe = collective.recipe.sphinxbuilder
+eggs = waeup.sirp
+source = ${buildout:directory}/docs/source
+build = ${buildout:directory}/docs/build