Stuck on an issue?

Lightrun Answers was designed to reduce the constant googling that comes with debugging 3rd party libraries. It collects links to all the places you might be looking at while hunting down a tough bug.

And, if you’re still stuck at the end, we’re happy to hop on a call to see how we can help out.

BUG: Offline documentation build fails with Sphinx 4.5

See original GitHub issue

Describe your issue.

After upgrading Sphinx from version 4.2.0 to 4.5.0, the SciPy documentation can no longer be built, failing with error:

Sphinx parallel build error:
AttributeError: can't set attribute
make: *** [Makefile:122: html-build] Error 2
error: in phase 'install-doc': uncaught exception:
%exception #<&invoke-error program: "make" arguments: ("html" "SPHINXOPTS=-j24") exit-status: 2 term-signal: #f stop-signal: #f>
phase `install-doc' failed after 55.8 seconds
command "make" "html" "SPHINXOPTS=-j24" failed with status 2

Reproducing Code Example

Bumping the sphinx dependency to latest should trigger the problem.

Error message

Full build log attached, GZip-compressed. *EDIT: removed for security reasons*

SciPy/NumPy/Python version information

1.8.0/1.21.6/3.9.9

Issue Analytics

State:
Created a year ago
Comments:19 (11 by maintainers)

Top GitHub Comments

1reaction

tupuicommented, Apr 22, 2022

No worries thanks for following up. Be sure to check the version we use for 1.8. For the theme we update quite often as we use the latest features and don’t maintain backward compatibility here.

Good Friday to you as well 😃

1reaction

tupuicommented, Apr 22, 2022

Ok but IMO it’s an issue on Sphinx. Good that there are warnings, but it could still go on with the build.

Top Results From Across the Web

Changelog - Sphinx documentation

#10596: Build failure if Docutils version is 0.18 (not 0.18.1) due to missing Node.findall(). #10506: LaTeX: build error if highlighting inline code role...

Error when building sphinx documentation in azure pipeline

I am trying to build sphinx documentation using an Azure pipeline, but I am running into an issue I do not understand.

Troubleshooting | ScyllaDB Docs - Scylla Sphinx Theme

First, you need to install this package manager. Then, install Make with the command choco install make . Tip. If you get an...

sphinx.pdf - Read the Docs

Building your documentation in other formats . ... 4.5. Extensions . ... Admonitions: attention103, caution104, danger105, error106, ...

sphinx-toolbox

https://www.sphinx-doc.org/en/master/usage/extensions#third-party ... If the file can't be found an error will be shown in the build output:.