Logo Path Broken (#2)

[michaelweinold]

Similar (but with a different root cause) to this issue from 2022:

• Logo path broken (#1) #59

the logo is rendered correctly on readthedocs, but not in the local build. How that is possible, I don't know - they use the same environment.yml (with pinned versions of the theme and Sphinx).

The local build:

WARNING: Path to dark image logo does not exist: logo/BW_all_white_transparent_landscape.svg
build succeeded, 239 warnings.
[W 230626 21:18:29 web:2344] 404 GET /_static/BW_all_black_transparent_landscape.svg (127.0.0.1) 0.43ms

The current workaround is to place a copy of the logo files into the _static directory, not in a subdirectory like _static/logo. As soon as this has been fixed by the pydata-sphinx-theme team:

• Variable html_theme_options:logo incompatible with Sphinx _static Logic pydata/pydata-sphinx-theme#1385
• Links to static files defined in conf.py are assigned incorrectly after build pydata/pydata-sphinx-theme#1328

we can remove the copies.

[tngTUDOR]

can't reproduce when building with:

sphinx-autobuild source _build/html -a -j auto --open-browser

or with

sphinx-build source _build/html -b singlehtml -a

either

Are you removing the _build folder after a couple of builts?

[michaelweinold]

...could have been resolved with my upgrade of Sphinx:

• Bump sphinx version to 7.x.x #92

I'll check again.

[michaelweinold]

If you start with:

1. A clean (or missing) _build folder
2. Without the logos which I copied to the top level of the _static folder (eg./brightway-documentation/source/_static/BW_all_black_transparent_landscape.svg) as a temporary workaround:

The current workaround is to place a copy of the logo files into the _static directory, not in a subdirectory like _static/logo. As soon as this has been fixed by the pydata-sphinx-theme team:

then the issue persists.

[alyabolowich]

Did a fresh git clone and build following the instructions in the readme and the logo appears.

[michaelweinold]

Neither of the underlying issues pydata/pydata-sphinx-theme#1385 and pydata/pydata-sphinx-theme#1328 were fixed in the latest release of the pydata-sphinx-theme. The current workaround remains to retain a copy of all files in source/_static/logo also in source/_static. Since I implemented this workaround, you are seeing the logo (as you reported).