On Sat, Aug 14, 2010 at 12:11 AM, Kevin <hekevint...@gmail.com> wrote: > I tried to build the Django docs and got an error. > > $ cd django/docs/ > $ make html > sphinx-build -b djangohtml -d _build/doctrees . _build/html > Running Sphinx v1.0.1 > [...] > Exception occurred: > File "/Users/src/django_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 /var/folders/od/ > odl44I41FT0yZPHQw8kT8E+++TM/-Tmp-/sphinx-err-RgDvku.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 <http://bitbucket.org/birkenfeld/ > sphinx/issues/>. Thanks! > make: *** [html] Error 1 > > The process fails when it tries to do an import: > > from sphinx.directives.desc import option_desc_re > > Why is there no module named desc? > > I am using: > Python 2.6 > Sphinx 1.0.1 > Django 1.2.1 > Mac OS X 10.5.8 >
That compatibility problem (Sphinx 1.0 and 1.0.1 were releases after Django 1.2) wea fixed on Django trunk and on the 1.2.x branch so the fix will be included with the 1.2.2 release. Meanwhile I think you can fix you problem in two ways, either 1. Overwrite you docs/_ext/djangodocs.py with this file http://code.djangoproject.com/svn/django/branches/releases/1.2.X/docs/_ext/djangodocs.py 2. or downgrade your Sphinx installation to 0.6.x (0.6.6 is the latest ATM). ...an retry building the docs. We still have some incompatibility details when using Sphinx 1.0.x (one because of further fixes needed on the Django docs and one that are waiting for some fixes on Sphinx once the 1.0 dust settles, neither of them prevents you building the docs like the problem you are experimenting now but they cripple a bit the links between documents), see Django tickets [1]14033 and [2]14085. So you might prefer to use option 2 for now. -- Ramiro Morales | http://rmorales.net 1. http://code.djangoproject.com/ticket/14033 2. http://code.djangoproject.com/ticket/14085 -- You received this message because you are subscribed to the Google Groups "Django users" group. To post to this group, send email to django-us...@googlegroups.com. To unsubscribe from this group, send email to django-users+unsubscr...@googlegroups.com. For more options, visit this group at http://groups.google.com/group/django-users?hl=en.
