osdir.com
mailing list archive F.A.Q. -since 2001!



Subject: Re: Can't build Django documentation - msg#00907

List: DjangoUsers

Mail Archive Navigation:
by Date: Prev Next Date Index by Thread: Prev Next Thread Index

On Sat, Aug 14, 2010 at 12:11 AM, Kevin <hekevintran@xxxxxxxxx> 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-users@xxxxxxxxxxxxxxxxx
To unsubscribe from this group, send email to
django-users+unsubscribe@xxxxxxxxxxxxxxxxx
For more options, visit this group at
http://groups.google.com/group/django-users?hl=en.

Thread at a glance:

Previous Message by Date:

Re: Can't build Django documentation

On Fri, Aug 13, 2010 at 11:11 PM, Kevin <hekevintran@xxxxxxxxx> 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 > loading pickled environment... not yet created > building [djangohtml]: targets for 427 source files that are out of > date > updating environment: 427 added, 0 changed, 0 removed > /Users/haitran/Desktop/obnob_project/src/django_docs/_ext/ > djangodocs.py:91: DeprecationWarning: xfileref_role is deprecated, use > XRefRole >  xrefs = sphinx.roles.xfileref_role('ref', linktext, linktext, > lineno, state) > reading sources... [ 73%] ref/contrib/gis/ > commands > 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 The docs [0] mention an incompatibility with the currently released Sphinx. I can't build right now either, and I'm too lazy to install Sphinx from source. [0] http://docs.djangoproject.com/en/dev/intro/whatsnext/#as-html-locally -- You received this message because you are subscribed to the Google Groups "Django users" group. To post to this group, send email to django-users@xxxxxxxxxxxxxxxxx To unsubscribe from this group, send email to django-users+unsubscribe@xxxxxxxxxxxxxxxxx For more options, visit this group at http://groups.google.com/group/django-users?hl=en.

Next Message by Date:

django queryset get only one result for one column pair

I have a field 'submission' which has a 'user' and a 'problem'. How can i get a django queryset search result which will give a list of only one result per user-problem pair. -- You received this message because you are subscribed to the Google Groups "Django users" group. To post to this group, send email to django-users@xxxxxxxxxxxxxxxxx To unsubscribe from this group, send email to django-users+unsubscribe@xxxxxxxxxxxxxxxxx For more options, visit this group at http://groups.google.com/group/django-users?hl=en.

Previous Message by Thread:

Re: Can't build Django documentation

Thanks for that info. I downgraded to Sphinx 0.6.6 and all is well. On Aug 14, 11:14 am, Ramiro Morales <cra...@xxxxxxxxx> wrote: > On Sat, Aug 14, 2010 at 9:07 AM, DrBloodmoney <drbloodmo...@xxxxxxxxx> wrote: > > > The docs [0] mention an incompatibility with the currently released > > Sphinx. I can't build right now either, and I'm too lazy to install > > Sphinx from source. > > > [0]http://docs.djangoproject.com/en/dev/intro/whatsnext/#as-html-locally > > That's and outdated and misleading note. Thanks for pointing it. I' ve > opened ticket 14111 to get rid of it. > > -- > Ramiro Morales  | http://rmorales.net -- You received this message because you are subscribed to the Google Groups "Django users" group. To post to this group, send email to django-users@xxxxxxxxxxxxxxxxx To unsubscribe from this group, send email to django-users+unsubscribe@xxxxxxxxxxxxxxxxx For more options, visit this group at http://groups.google.com/group/django-users?hl=en.

Next Message by Thread:

Re: Can't build Django documentation

Dnia 14-08-2010 o 05:11:25 Kevin <hekevintran@xxxxxxxxx> napisaÅ(a): 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 loading pickled environment... not yet created building [djangohtml]: targets for 427 source files that are out of date updating environment: 427 added, 0 changed, 0 removed /Users/haitran/Desktop/obnob_project/src/django_docs/_ext/ djangodocs.py:91: DeprecationWarning: xfileref_role is deprecated, use XRefRole xrefs = sphinx.roles.xfileref_role('ref', linktext, linktext, lineno, state) reading sources... [ 73%] ref/contrib/gis/ commands 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 I had a same problem while ago, when i needed offline docs. So i just used wget to mirror http://docs.djangoproject.com/en/1.2/ http://www.devarticles.com/c/a/Web-Services/Website-Mirroring-With-wget/1/ -- Linux user -- You received this message because you are subscribed to the Google Groups "Django users" group. To post to this group, send email to django-users@xxxxxxxxxxxxxxxxx To unsubscribe from this group, send email to django-users+unsubscribe@xxxxxxxxxxxxxxxxx For more options, visit this group at http://groups.google.com/group/django-users?hl=en.
blog comments powered by Disqus

Home | News | Sitemap | FAQ | advertise | OSDir is an Inevitable website. GBiz is too!