id summary reporter owner description type status component version severity resolution keywords cc stage has_patch needs_docs needs_tests needs_better_patch easy ui_ux
20851 Couldn't build the docs with the latest docutils (0.11) bruno@… nobody "Hi there,
Today I've tried to build the django docs using a fresh virtualenv with only one installed package: Sphinx.
Here is the pip freeze output:
{{{
Jinja2==2.7
MarkupSafe==0.18
Pygments==1.6
Sphinx==1.2b1
distribute==0.6.34
docutils==0.11
}}}
the `make html` command threw me this error output:
{{{
$ make html
sphinx-build -b djangohtml -n -d _build/doctrees . _build/html
Running Sphinx v1.2b1
loading pickled environment... failed: env version not current
loading intersphinx inventory from http://docs.python.org/2.7/objects.inv...
loading intersphinx inventory from http://packages.python.org/six/objects.inv...
loading intersphinx inventory from http://sphinx.pocoo.org/objects.inv...
loading intersphinx inventory from http://simplejson.readthedocs.org/en/latest/objects.inv...
building [djangohtml]: targets for 264 source files that are out of date
updating environment: 264 added, 0 changed, 0 removed
reading sources... [100%] topics/testing/overview
looking for now-outdated files... none found
pickling environment... done
checking consistency... done
preparing documents... done
writing output... [ 2%] faq/install
Exception occurred:
File ""/home/novapost/.virtualenvs/DOCS/local/lib/python2.7/site-packages/docutils/writers/html4css1/__init__.py"", line 1559, in depart_table
self.compact_p = self.context.pop()
IndexError: pop from empty list
The full traceback has been saved in /tmp/sphinx-err-AXWeLA.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 ,
or report them in the tracker at . Thanks!
make: *** [html] Erreur 1
}}}
After questionning the IRC django channel on Freenode, it happened to be solved using this ""trick""
{{{
pip uninstall docutils
pip install docutils==0.10
}}}
So far, I could build another Sphinx documentation with the previous setup (including docutils==0.11), but I couldn't do it for Django docs.
Looks like Django documentation is incompatible with the latest docutils version. Maybe it has something to do with docutils itself, but I thought it would be valuable to mention it here, in order to give user instructions about this (i.e. install `docutils==0.10` in the `docs/README` file)
Regards." Bug closed Documentation 1.5 Normal fixed Unreviewed 0 0 0 0 0 0