Exception occurred during documentation build (`make dist-html`)

Issue #3400 closed
Sam Zhang created an issue

Traceback:

reading sources... [ 61%] orm/events
reading sources... [ 62%] orm/examples
The name of the builder is: htmlThe name of the builder is: html
Exception occurred:
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/zzzeeksphinx/viewsource.py", line 61, in _view_source_node
    tok, [pathname] if pathname else None)
ImportError: No module named
The full traceback has been saved in /tmp/sphinx-err-qz9ZgL.log

 /t/sphinx-err-qz9ZgL.log                                                                                                                                                                                 
# Sphinx version: 1.3.1
# Python version: 2.7.6 (CPython)
# Docutils version: 0.12 release
# Jinja2 version: 2.7.3
# Last messages:
#   reading sources... [ 57%] orm/classical
#   reading sources... [ 57%] orm/collections
#   reading sources... [ 58%] orm/composites
#   reading sources... [ 59%] orm/constructors
#   reading sources... [ 60%] orm/contextual
#   reading sources... [ 61%] orm/deprecated
#   reading sources... [ 61%] orm/events
#   reading sources... [ 62%] orm/examples
#   The name of the builder is: html
#   The name of the builder is: html
# Loaded extensions:
#   sphinx.ext.autodoc (1.3.1) from /mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/sphinx/ext/autodoc.pyc
#   sphinx.ext.intersphinx (1.3.1) from /mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/sphinx/ext/intersphinx.pyc
#   changelog (unknown version) from /mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/changelog/__init__.pyc
#   alabaster (0.7.3) from /mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/alabaster/__init__.pyc
#   sphinx_paramlinks (unknown version) from /mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/sphinx_paramlinks/__init__.pyc
#   zzzeeksphinx (unknown version) from /mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/zzzeeksphinx/__init__.pyc
Traceback (most recent call last):
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/sphinx/cmdline.py", line 245, in main
    app.build(opts.force_all, filenames)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/sphinx/application.py", line 264, in build
    self.builder.build_update()
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/sphinx/builders/__init__.py", line 245, in build_update
    'out of date' % len(to_build))
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/sphinx/builders/__init__.py", line 259, in build
    self.doctreedir, self.app))
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/sphinx/environment.py", line 618, in update
    self._read_serial(docnames, app)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/sphinx/environment.py", line 638, in _read_serial
    self.read_doc(docname, app)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/sphinx/environment.py", line 791, in read_doc
    pub.publish()
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/core.py", line 217, in publish
    self.settings)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/sphinx/environment.py", line 126, in read
    self.parse()
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/readers/__init__.py", line 78, in parse
    self.parser.parse(self.input, document)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/parsers/rst/__init__.py", line 172, in parse
    self.statemachine.run(inputlines, document, inliner=self.inliner)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/parsers/rst/states.py", line 170, in run
    input_source=document['source'])
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/statemachine.py", line 239, in run
    context, state, transitions)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/statemachine.py", line 460, in check_line
    return method(match, context, next_state)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/parsers/rst/states.py", line 2961, in text
    self.section(title.lstrip(), source, style, lineno + 1, messages)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/parsers/rst/states.py", line 327, in section
    self.new_subsection(title, lineno, messages)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/parsers/rst/states.py", line 395, in new_subsection
    node=section_node, match_titles=True)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/parsers/rst/states.py", line 282, in nested_parse
    node=node, match_titles=match_titles)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/parsers/rst/states.py", line 195, in run
    results = StateMachineWS.run(self, input_lines, input_offset)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/statemachine.py", line 239, in run
    context, state, transitions)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/statemachine.py", line 460, in check_line
    return method(match, context, next_state)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/parsers/rst/states.py", line 2726, in underline
    self.section(title, source, style, lineno - 1, messages)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/parsers/rst/states.py", line 327, in section
    self.new_subsection(title, lineno, messages)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/parsers/rst/states.py", line 395, in new_subsection
    node=section_node, match_titles=True)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/parsers/rst/states.py", line 282, in nested_parse
    node=node, match_titles=match_titles)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/parsers/rst/states.py", line 195, in run
    results = StateMachineWS.run(self, input_lines, input_offset)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/statemachine.py", line 239, in run
    context, state, transitions)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/statemachine.py", line 460, in check_line
    return method(match, context, next_state)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/parsers/rst/states.py", line 2726, in underline
    self.section(title, source, style, lineno - 1, messages)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/parsers/rst/states.py", line 327, in section
    self.new_subsection(title, lineno, messages)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/parsers/rst/states.py", line 395, in new_subsection
    node=section_node, match_titles=True)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/parsers/rst/states.py", line 282, in nested_parse
    node=node, match_titles=match_titles)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/parsers/rst/states.py", line 195, in run
    results = StateMachineWS.run(self, input_lines, input_offset)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/statemachine.py", line 239, in run
    context, state, transitions)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/statemachine.py", line 460, in check_line
    return method(match, context, next_state)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/parsers/rst/states.py", line 2299, in explicit_markup
    nodelist, blank_finish = self.explicit_construct(match)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/parsers/rst/states.py", line 2311, in explicit_construct
    return method(self, expmatch)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/parsers/rst/states.py", line 2054, in directive
    directive_class, match, type_name, option_presets)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/parsers/rst/states.py", line 2103, in run_directive
    result = directive_instance.run()
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/sphinx/ext/autodoc.py", line 1488, in run
    nested_parse_with_titles(self.state, self.result, node)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/sphinx/util/nodes.py", line 165, in nested_parse_with_titles
    return state.nested_parse(content, 0, node, match_titles=1)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/parsers/rst/states.py", line 282, in nested_parse
    node=node, match_titles=match_titles)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/parsers/rst/states.py", line 195, in run
    results = StateMachineWS.run(self, input_lines, input_offset)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/statemachine.py", line 239, in run
    context, state, transitions)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/statemachine.py", line 460, in check_line
    return method(match, context, next_state)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/parsers/rst/states.py", line 2299, in explicit_markup
    nodelist, blank_finish = self.explicit_construct(match)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/parsers/rst/states.py", line 2311, in explicit_construct
    return method(self, expmatch)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/parsers/rst/states.py", line 2054, in directive
    directive_class, match, type_name, option_presets)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/parsers/rst/states.py", line 2103, in run_directive
    result = directive_instance.run()
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/zzzeeksphinx/viewsource.py", line 200, in run
    link = _view_source_node(env, modname, self.state)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/zzzeeksphinx/viewsource.py", line 61, in _view_source_node
    tok, [pathname] if pathname else None)
ImportError: No module named

Comments (2)

  1. Mike Bayer repo owner

    what's alabaster? custom themes are not supported.

    the docs build fine for me here and also build fine on RTD. have never seen that exception.

    can you please remove the alabaster thing and confirm a plain vanilla build works?

  2. Log in to comment