building docs with sphinx-1.8.5
Hi I'll try this site before asking the developers mailing list. Please let me know if this is the wrong place for this sort of questions.
On my own git branch, after the last pull which happened after arch linux upgraded to sphinx-1.8.5 I hit this error on sage --docbuild refernce html
even after a make doc-clean
.
EDIT: this does not have to do with arch's sphinx, even after removing it and using the one shipped with Sage it still fails.
This looks like what's described in this ticket https://trac.sagemath.org/ticket/26451 but this is already applied in my branch
# Sphinx version: 1.8.5
# Python version: 3.7.3 (CPython)
# Docutils version: 0.14
# Jinja2 version: 2.10
# Last messages:
# linking _static directory.
# copying extra files...
# done
# dumping search index in English (code: en) ...
# done
# dumping object inventory...
# done
# build succeeded, 1295 warnings.
#
# The HTML pages are in local/share/doc/sage/html/en/reference/references.
# Loaded extensions:
# sphinx.ext.mathjax (1.8.5) from /home/user/Documents/code/sage/sage/local/lib/python3.7/site-packages/sphinx/ext/mathjax.py
# alabaster (0.7.12) from /home/user/Documents/code/sage/sage/local/lib/python3.7/site-packages/alabaster/__init__.py
# inventory_builder (unknown version) from /home/user/Documents/code/sage/sage/src/sage_setup/docbuild/ext/inventory_builder.py
# multidocs (unknown version) from /home/user/Documents/code/sage/sage/src/sage_setup/docbuild/ext/multidocs.py
# sage_autodoc (1.8.5) from /home/user/Documents/code/sage/sage/src/sage_setup/docbuild/ext/sage_autodoc.py
# sphinx.ext.graphviz (1.8.5) from /home/user/Documents/code/sage/sage/local/lib/python3.7/site-packages/sphinx/ext/graphviz.py
# sphinx.ext.inheritance_diagram (1.8.5) from /home/user/Documents/code/sage/sage/local/lib/python3.7/site-packages/sphinx/ext/inheritance_diagram.py
# sphinx.ext.todo (1.8.5) from /home/user/Documents/code/sage/sage/local/lib/python3.7/site-packages/sphinx/ext/todo.py
# sphinx.ext.extlinks (1.8.5) from /home/user/Documents/code/sage/sage/local/lib/python3.7/site-packages/sphinx/ext/extlinks.py
# IPython.sphinxext.ipython_directive (unknown version) from /home/user/Documents/code/sage/sage/local/lib/python3.7/site-packages/IPython/sphinxext/ipython_directive.py
# matplotlib.sphinxext.plot_directive (unknown version) from /home/user/Documents/code/sage/sage/local/lib/python3.7/site-packages/matplotlib/sphinxext/plot_directive.py
Traceback (most recent call last):
File "/home/user/Documents/code/sage/sage/local/lib/python3.7/site-packages/sphinx/cmd/build.py", line 304, in build_main
app.build(args.force_all, filenames)
File "/home/user/Documents/code/sage/sage/local/lib/python3.7/site-packages/sphinx/application.py", line 369, in build
self.emit('build-finished', None)
File "/home/user/Documents/code/sage/sage/local/lib/python3.7/site-packages/sphinx/application.py", line 510, in emit
return self.events.emit(event, self, *args)
File "/home/user/Documents/code/sage/sage/local/lib/python3.7/site-packages/sphinx/events.py", line 80, in emit
results.append(callback(*args))
File "/home/user/Documents/code/sage/sage/local/lib/python3.7/site-packages/sphinx/ext/graphviz.py", line 414, in on_build_finished
copy_asset(src, dst)
File "/home/user/Documents/code/sage/sage/local/lib/python3.7/site-packages/sphinx/util/fileutil.py", line 81, in copy_asset
ensuredir(destination)
File "/home/user/Documents/code/sage/sage/local/lib/python3.7/site-packages/sphinx/util/osutil.py", line 90, in ensuredir
os.makedirs(path)
File "/home/user/Documents/code/sage/sage/local/lib/python3.7/os.py", line 221, in makedirs
mkdir(name, mode)
FileExistsError: [Errno 17] File exists: '/home/user/Documents/code/sage/sage/local/share/doc/sage/html/en/reference/references/_static'
Try deleting
/home/user/Documents/code/sage/sage/local/share/doc/sage/html/en/reference/references/_static
and try again.Tried that and fails again with a
[Errno 2] No such file or directory: ...en/reference/objects.inv
. It looks exactly as was reported in that trac. _static is a symlink to an nonexistent directory. Amake doc-clean
does remove the link. But it gets created during the run ofsage --docbuild reference html