Sphinx failed making Django docs

[shimizukawa]

I just installed Sphinx in Python 2.5.1 on Mac OS X 10.4.11 using 'easy_install -U Sphinx' and tried to use it to build html version of Django 1.2.1 docs. It raised an exception:

----------
~/Applications/Django-1.2.1/docs xxx$ make html
sphinx-build -b djangohtml -d _build/doctrees   . _build/html
Making output directory...
Running Sphinx v1.0.3
loading pickled environment... not yet created
building [djangohtml]: targets for 187 source files that are out of date
updating environment: 187 added, 0 changed, 0 removed
/Users/xxx/Applications/Django-1.2.1/docs/_ext/djangodocs.py:91: DeprecationWarning: xfileref_role is deprecated, use XRefRole
  xrefs = sphinx.roles.xfileref_role('ref', linktext, linktext, lineno, state)
reading sources... [ 39%] ref/contrib/gis/commands                              
Exception occurred:
  File "/Users/xxx/Applications/Django-1.2.1/docs/_ext/djangodocs.py", line 215, in parse_django_adminopt_node
    from sphinx.directives.desc import option_desc_re
ImportError: No module named desc
The full traceback has been saved in /tmp/sphinx-err-JN15dx.log, if you want to report the issue to the developers.
Please also report this if it was a user error, so that a better error message can be provided next time.
Either send bugs to the mailing list at <http://groups.google.com/group/sphinx-dev/>,
or report them in the tracker at <https://bitbucket.org/birkenfeld/sphinx/issues/>. Thanks!
make: *** [html] Error 1
----------

"/tmp/sphinx-err-JN15dx.log" is attached.

---

• Bitbucket: https://bitbucket.org/birkenfeld/sphinx/issue/514
• Originally reported by: BethG
• Originally created at: 2010-08-26T07:04:37.451

[shimizukawa]

From Georg Brandl on 2010-08-26 11:57:53+00:00

Depending on the Django version, you have to you Sphinx 0.6.x or 1.0.x to successfully build the documentation.

[shimizukawa]

From Georg Brandl on 2014-10-18 07:30:09+00:00

Removing version: 1.0.3 (automated comment)