Code

Opened 4 years ago

Closed 4 years ago

Last modified 4 years ago

#13931 closed (invalid)

Can't build the documentation under Win/Cygwin

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

Description (last modified by ramiro)

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'

Attachments (0)

Change History (4)

comment:1 Changed 4 years ago by ramiro

  • Description modified (diff)
  • Needs documentation unset
  • Needs tests unset
  • Patch needs improvement unset

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

comment:2 Changed 4 years ago by ramiro

  • Resolution set to invalid
  • Status changed from new to closed

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 Changed 4 years ago by 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.

comment:4 Changed 4 years ago by m.strehl@…

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

Thanks for the response!

Add Comment

Modify Ticket

Change Properties
<Author field>
Action
as closed
as The resolution will be set. Next status will be 'closed'
The resolution will be deleted. Next status will be 'new'
Author


E-mail address and user name can be saved in the Preferences.

 
Note: See TracTickets for help on using tickets.