Closed Carreau closed 5 days ago
Just to say I'd really like a version compatible with Sphinx 8 too!
I don't think it's incompatible, did you encounter any specific errors ?
Yes:
ERROR: pip's dependency resolver does not currently take into account all the packages that are installed. This behaviour is the source of the following dependency conflicts. myst-parser 0.17.0 requires docutils<0.18,>=0.15, but you have docutils 0.21.2 which is incompatible. myst-parser 0.17.0 requires sphinx<5,>=3.1, but you have sphinx 8.0.2 which is incompatible.
Please try updating myst parser. Current stable release is 4.0.0 and you seem to have 0.17.0
Indeed, that helped. Now I got other issues probably coming from the fact I am already using a different theme (sphinx-material).
pickling environment... WARNING: cannot cache unpickable configuration value: 'html_context' (because it contains a function, class, or module object) [config.cache]
done
checking consistency... done
preparing documents... done
copying assets...
copying static files... done
copying extra files... done
copying assets: done
writing output... [ 1%]
Extension error (pydata_sphinx_theme):
Handler <function update_and_remove_templates at 0x1131fce50> for event 'html-page-context' threw an exception (exception: 'logo-text.html' not found in ['/Users/elodie/Documents/github/Doc/source/_templates', '/Users/elodie/Library/Python/3.10/lib/python/site-packages/pydata_sphinx_theme/theme/pydata_sphinx_theme/components', '/Users/elodie/Library/Python/3.10/lib/python/site-packages/pydata_sphinx_theme/theme/pydata_sphinx_theme', '/Users/elodie/Library/Python/3.10/lib/python/site-packages/sphinx/themes/basic'])
MetPy's docs are building fine with sphinx 8.0.2 and pydata-sphinx-theme 0.15.4 (myst-parser 4.0.0).
MetPy's docs are building fine with sphinx 8.0.2 and pydata-sphinx-theme 0.15.4 (myst-parser 4.0.0).
The same applies to the French LaTeX FAQ :blush:
@trallard @Carreau seems like we're close to being ready for another release? Only listed blockers are #1982 (which looks to be basically done?) and #1938 (which I think can be closed as completed given the comments above). #1992 made me realize some nice improvements still aren't in the hands of stable users.
We should be able to make a release whenever (https://github.com/pydata/pydata-sphinx-theme/pull/1982 is now merged), and we have been testing against Sphinx 8, and I have not spotted anything amiss. Neither of our CIs has so it is up to you @drammock, shall we cut a pre-release?
shall we cut a pre-release?
Yes I think so. I probably can't do it until next Wednesday so if one of you has time sooner then go for it
I shall be able to do this on Monday.
The pre-release is now out https://pypi.org/project/pydata-sphinx-theme/0.16.0rc0/
This can be installed with pip install pydata-sphinx-theme==0.16.0rc0 --pre
There is also a discussion opened https://github.com/pydata/pydata-sphinx-theme/discussions/1997
There do not seem to be any major issues identified through the release candidate, and the few bugs raised have been addressed. So will target to make a full release early this week 🚀
@12rambau and @Carreau There's still time to adjust the French translation (#2010), isn't it?
When building the NumPy docs I noticed an issue with the search navbar-item:
I am not sure if that comes from the theme or one of our customizations but will check.
SciPy looks good as far as I can tell 👍🏻
@trallard what about #2007 ? It's minor enough that I didn't label as a release blocker, but by the same token it's minor enough that I'd be comfortable rolling it in as a bugfix between RC and release (if you or @gabalafou look and don't notice anything amiss, that is)
@melissawm
When building the NumPy docs I noticed an issue with the search navbar-item:
Already reported and fixed :wink:
@drammock, I think it is okay to include #2007. It is a bug (I just checked the Figma file, and the hover colour change went missing somehow), but it is small enough that I do not expect it to cause any issues. I did leave a comment on the tests, though.
@dbitouze I can definitely get the translations in.
@dbitouze I can definitely get the translations in.
Sorry, I don't see what you mean.
Sorry if I was not clear enough @dbitouze. I meant that if the French translations are updated I should be able to include them in the proper release.
🎉 🚀 I just cut a new release so will go ahead and close this issue 👉🏽 https://pypi.org/project/pydata-sphinx-theme/0.16.0/
I think with the recent sphinx 8 fixes it woudl be good to make a new release potentially dropping older shinx. Here are the list of things to do for a new release.
Double check for quality-control
impact: block-release
labelPrepare the codebase for a new version
__version__
in__init__.py
.json
file with the new versiongit commit -m 'bump: 0.1.9 → 0.2.0'
git push upstream main
Make the release
v0.2.0
Choose a Tag:
dropdown, type in the release name (e.g.,v0.2.0
) and click "Create new tag"Target:
dropdown, pin it to the release commit that you've just pushed.publish
github action job has completed successfully in the actions tab.[^release-refs]: Taken from the release checklist. See the release documentation for an overview of release processes.