Opened 14 years ago

Closed 14 years ago

Last modified 14 years ago

#13931 closed (invalid)

Can't build the documentation under Win/Cygwin

Reported by: m.strehl@… Owned by: nobody
Component: Documentation Version: dev
Severity: Keywords:
Cc: Triage Stage: Unreviewed
Has patch: no Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: no UI/UX: no

Description (last modified by Ramiro Morales)

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'

Change History (4)

comment:1 by Ramiro Morales, 14 years ago

Description: modified (diff)

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

comment:2 by Ramiro Morales, 14 years ago

Resolution: invalid
Status: newclosed

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.

comment:3 by m.strehl@…, 14 years ago

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.

comment:4 by m.strehl@…, 14 years ago

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

Thanks for the response!

Note: See TracTickets for help on using tickets.
Back to Top