building docs with sphinx-1.8.5 fails with existing _static

[Reimundo Heluani]

Hello, I posted this on ask.sagemath.org

https://ask.sagemath.org/question/50925/building-docs-with-sphinx-185/

On my own git branch, after the last pull I hit this error on "sage --docbuild refernce html" even after a "make doc-clean".

This looks like what's described in this ticket https://trac.sagemath.org/ticket/26451 but this is already applied in my branch

The link _static on local/share/doc/sage/html/en/reference/references/_static points to a non-existing directory ../_static

After a "make doc-clean" it gets erased but it is recreated on the run of "sage --docbuild"

This is $ uname -a
Linux rye 5.6.3-arch1-1 #1 SMP PREEMPT Wed, 08 Apr 2020 07:47:16 +0000 x86_64 GNU/Linux

on my own sage git which is very much up to date

sage: version()
'SageMath version 9.1.beta8, Release Date: 2020-03-18'

The log of the error is

# 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'


I appreciate any help.

Thanks,

R.

[Jean-Florent Raymond]

Hello,

A workaround is to run "make" after "make doc-clean".
It worked for me.

Source:
https://groups.google.com/forum/?utm_medium=email&utm_source=footer#!msg/sage-devel/RHMEHCTp_pU/12BWV897AgAJ

Related: https://github.com/sphinx-doc/sphinx/issues/7407

Best regards,

Jean-Florent.

[Reimundo Heluani]

On Apr 23, Jean-Florent Raymond wrote:
>Hello,
>
>A workaround is to run "make" after "make doc-clean".
>It worked for me.
>

Thanks! I should've checked sage-devel as well.

R.

>--
>You received this message because you are subscribed to the Google Groups "sage-support" group.
>To unsubscribe from this group and stop receiving emails from it, send an email to sage-support...@googlegroups.com.
>To view this discussion on the web visit https://groups.google.com/d/msgid/sage-support/ab83973a-c84f-7101-d5dc-3b7b051c891a%40uca.fr.