Hi,
one more question on building.
I'm running with latest git sources and I have got an error during docs building with sphinx. I see you have it done in online documentation so " believe the error is on the my side. But may be you have a clue?
Logs:
$ build/bin/ovitos /usr/bin/sphinx-build -b html -a -E -D version=2.8 -D release=2.8.2 . build/share/ovito/doc/manual/html/python
Running Sphinx v1.4.8
building [mo]: all of 0 po files
building [html]: all source files
updating environment: 15 added, 0 changed, 0 removed
reading sources... [100%] modules/ovito_vis
looking for now-outdated files... none found
pickling environment... done
checking consistency... done
preparing documents... done
writing output... [ 40%] introduction/overview
Exception occurred:
File "/usr/lib/python3.5/site-packages/docutils/writers/_html_base.py", line 671, in depart_document
assert not self.context, 'len(context) = %s' % len(self.context)
AssertionError: len(context) = 1
The full traceback has been saved in /tmp/sphinx-err-zg_3qdjq.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.
A bug report can be filed in the tracker at <https://github.com/sphinx-doc/sphinx/issues>. Thanks!
/tmp/sphinx-err-zg_3qdjq.log:
# Python version: 3.5.2 (CPython)
# Docutils version: 0.13.1 release
# Jinja2 version: 2.8.1
# Last messages:
# checking consistency...
# done
# preparing documents...
# done
# writing output... [ 6%] index
# writing output... [ 13%] introduction/custom_modifiers
# writing output... [ 20%] introduction/examples
# writing output... [ 26%] introduction/file_io
# writing output... [ 33%] introduction/modifiers
# writing output... [ 40%] introduction/overview
# Loaded extensions:
# sphinx.ext.autodoc (1.4.8) from /usr/lib/python3.5/site-packages/sphinx/ext/autodoc.py
# alabaster (0.7.9) from /usr/lib/python3.5/site-packages/alabaster/__init__.py
Traceback (most recent call last):
File "/usr/lib/python3.5/site-packages/sphinx/cmdline.py", line 244, in main
app.build(opts.force_all, filenames)
File "/usr/lib/python3.5/site-packages/sphinx/application.py", line 291, in build
self.builder.build_all()
File "/usr/lib/python3.5/site-packages/sphinx/builders/__init__.py", line 211, in build_all
self.build(None, summary='all source files', method='all')
File "/usr/lib/python3.5/site-packages/sphinx/builders/__init__.py", line 322, in build
self.write(docnames, list(updated_docnames), method)
File "/usr/lib/python3.5/site-packages/sphinx/builders/__init__.py", line 360, in write
self._write_serial(sorted(docnames), warnings)
File "/usr/lib/python3.5/site-packages/sphinx/builders/__init__.py", line 368, in _write_serial
self.write_doc(docname, doctree)
File "/usr/lib/python3.5/site-packages/sphinx/builders/html.py", line 448, in write_doc
self.docwriter.write(doctree, destination)
File "/usr/lib/python3.5/site-packages/docutils/writers/__init__.py", line 80, in write
self.translate()
File "/usr/lib/python3.5/site-packages/sphinx/writers/html.py", line 47, in translate
self.document.walkabout(visitor)
File "/usr/lib/python3.5/site-packages/docutils/nodes.py", line 187, in walkabout
visitor.dispatch_departure(self)
File "/usr/lib/python3.5/site-packages/docutils/nodes.py", line 1895, in dispatch_departure
return method(node)
File "/usr/lib/python3.5/site-packages/docutils/writers/_html_base.py", line 671, in depart_document
assert not self.context, 'len(context) = %s' % len(self.context)
AssertionError: len(context) = 1
Thanks!