Can't build the documentation under Win/Cygwin

[m.strehl@…]

Hi,

I tried to build the docs (fresh SVN checkout as well as 1.1 and 1.2 docs) without success under Cygwin/WinVista and Python 2.6:

$ svn co http://code.djangoproject.com/svn/django/trunk/docs/ django-docs
$ cd django-docs
$ make html

sphinx-build dies with an AttributeError:

  File "/home/Manuel/winhome/htdocs/manuals/django-docs/_ext/djangodocs.py", line 103, in parse_version_directive
    env.note_versionchange(node['type'], node['version'], node, lineno)
AttributeError: BuildEnvironment instance has no attribute 'note_versionchange'


The full resulting traceback:

# Sphinx version: 1.0b2
# Docutils version: 0.7 release
# Jinja2 version: 2.5
Traceback (most recent call last):
  File "/usr/lib/python2.6/site-packages/Sphinx-1.0b2-py2.6.egg/sphinx/cmdline.py", line 173, in main
    app.build(force_all, filenames)
  File "/usr/lib/python2.6/site-packages/Sphinx-1.0b2-py2.6.egg/sphinx/application.py", line 205, in build
    self.builder.build_update()
  File "/usr/lib/python2.6/site-packages/Sphinx-1.0b2-py2.6.egg/sphinx/builders/__init__.py", line 198, in build_update
    'out of date' % len(to_build))
  File "/usr/lib/python2.6/site-packages/Sphinx-1.0b2-py2.6.egg/sphinx/builders/__init__.py", line 218, in build
    purple, length):
  File "/usr/lib/python2.6/site-packages/Sphinx-1.0b2-py2.6.egg/sphinx/builders/__init__.py", line 120, in status_iterator
    for item in iterable:
  File "/usr/lib/python2.6/site-packages/Sphinx-1.0b2-py2.6.egg/sphinx/environment.py", line 502, in update_generator
    self.read_doc(docname, app=app)
  File "/usr/lib/python2.6/site-packages/Sphinx-1.0b2-py2.6.egg/sphinx/environment.py", line 642, in read_doc
    pub.publish()
  File "/usr/lib/python2.6/site-packages/docutils-0.7-py2.6.egg/docutils/core.py", line 203, in publish
    self.settings)
  File "/usr/lib/python2.6/site-packages/docutils-0.7-py2.6.egg/docutils/readers/__init__.py", line 69, in read
    self.parse()
  File "/usr/lib/python2.6/site-packages/docutils-0.7-py2.6.egg/docutils/readers/__init__.py", line 75, in parse
    self.parser.parse(self.input, document)
  File "/usr/lib/python2.6/site-packages/docutils-0.7-py2.6.egg/docutils/parsers/rst/__init__.py", line 157, in parse
    self.statemachine.run(inputlines, document, inliner=self.inliner)
  File "/usr/lib/python2.6/site-packages/docutils-0.7-py2.6.egg/docutils/parsers/rst/states.py", line 170, in run
    input_source=document['source'])
  File "/usr/lib/python2.6/site-packages/docutils-0.7-py2.6.egg/docutils/statemachine.py", line 233, in run
    context, state, transitions)
  File "/usr/lib/python2.6/site-packages/docutils-0.7-py2.6.egg/docutils/statemachine.py", line 454, in check_line
    return method(match, context, next_state)
  File "/usr/lib/python2.6/site-packages/docutils-0.7-py2.6.egg/docutils/parsers/rst/states.py", line 2706, in underline
    self.section(title, source, style, lineno - 1, messages)
  File "/usr/lib/python2.6/site-packages/docutils-0.7-py2.6.egg/docutils/parsers/rst/states.py", line 329, in section
    self.new_subsection(title, lineno, messages)
  File "/usr/lib/python2.6/site-packages/docutils-0.7-py2.6.egg/docutils/parsers/rst/states.py", line 398, in new_subsection
    node=section_node, match_titles=1)
  File "/usr/lib/python2.6/site-packages/docutils-0.7-py2.6.egg/docutils/parsers/rst/states.py", line 284, in nested_parse
    node=node, match_titles=match_titles)
  File "/usr/lib/python2.6/site-packages/docutils-0.7-py2.6.egg/docutils/parsers/rst/states.py", line 195, in run
    results = StateMachineWS.run(self, input_lines, input_offset)
  File "/usr/lib/python2.6/site-packages/docutils-0.7-py2.6.egg/docutils/statemachine.py", line 233, in run
    context, state, transitions)
  File "/usr/lib/python2.6/site-packages/docutils-0.7-py2.6.egg/docutils/statemachine.py", line 454, in check_line
    return method(match, context, next_state)
  File "/usr/lib/python2.6/site-packages/docutils-0.7-py2.6.egg/docutils/parsers/rst/states.py", line 2706, in underline
    self.section(title, source, style, lineno - 1, messages)
  File "/usr/lib/python2.6/site-packages/docutils-0.7-py2.6.egg/docutils/parsers/rst/states.py", line 329, in section
    self.new_subsection(title, lineno, messages)
  File "/usr/lib/python2.6/site-packages/docutils-0.7-py2.6.egg/docutils/parsers/rst/states.py", line 398, in new_subsection
    node=section_node, match_titles=1)
  File "/usr/lib/python2.6/site-packages/docutils-0.7-py2.6.egg/docutils/parsers/rst/states.py", line 284, in nested_parse
    node=node, match_titles=match_titles)
  File "/usr/lib/python2.6/site-packages/docutils-0.7-py2.6.egg/docutils/parsers/rst/states.py", line 195, in run
    results = StateMachineWS.run(self, input_lines, input_offset)
  File "/usr/lib/python2.6/site-packages/docutils-0.7-py2.6.egg/docutils/statemachine.py", line 233, in run
    context, state, transitions)
  File "/usr/lib/python2.6/site-packages/docutils-0.7-py2.6.egg/docutils/statemachine.py", line 454, in check_line
    return method(match, context, next_state)
  File "/usr/lib/python2.6/site-packages/docutils-0.7-py2.6.egg/docutils/parsers/rst/states.py", line 2281, in explicit_markup
    nodelist, blank_finish = self.explicit_construct(match)
  File "/usr/lib/python2.6/site-packages/docutils-0.7-py2.6.egg/docutils/parsers/rst/states.py", line 2293, in explicit_construct
    return method(self, expmatch)
  File "/usr/lib/python2.6/site-packages/docutils-0.7-py2.6.egg/docutils/parsers/rst/states.py", line 2035, in directive
    directive_class, match, type_name, option_presets)
  File "/usr/lib/python2.6/site-packages/docutils-0.7-py2.6.egg/docutils/parsers/rst/states.py", line 2086, in run_directive
    result = directive_instance.run()
  File "/usr/lib/python2.6/site-packages/docutils-0.7-py2.6.egg/docutils/parsers/rst/__init__.py", line 370, in run
    self.state, self.state_machine)
  File "/home/Manuel/winhome/htdocs/manuals/django-docs/_ext/djangodocs.py", line 103, in parse_version_directive
    env.note_versionchange(node['type'], node['version'], node, lineno)
AttributeError: BuildEnvironment instance has no attribute 'note_versionchange'

[Ramiro Morales]

Re-formatted, please use WikiFormatting and the Preview button before postinmg a ticket.

[Ramiro Morales]

Yo seem to be using non released versions of Sphinx (1.0b2) and docutils 0.7). Try agian using stable releases.

Also, if you still experience the problems I'd ask on the Sphinx user support channels, because I'm not sure Cygwin is a platform supported by Sphinx.

Closing as invalid for now, please reopen if you check what's suggested above and can is a problem of the Django docs with a production level documentation toolchain.

[m.strehl@…]

1.0b2 was the version comming via pip/easy_install. I'll retry with the last stable and reopen the ticket, if the problem still occurs.

[m.strehl@…]

Building works fine with Sphinx 0.6.7, so it's a problem with Sphinx 1.0b2.

Thanks for the response!