Repository navigation
How to deploy 2023.5 for 3.11 branch?聽#134
Description
Activity
On docs.python.org it's all handled by docsbuild-scripts.
See https://github.com/python/docsbuild-scripts/blob/952c9ee85c676ec58a5126fb0d96a98e47f1f373/build_docs.py#L829, it "just" use the requirements.txt found in cpython's
Doc/. Except when it cause trouble we override it here: https://github.com/python/docsbuild-scripts/blob/952c9ee85c676ec58a5126fb0d96a98e47f1f373/build_docs.py#L102The venvs are kept from one build to another, so having
>=in therequirements.txtfile is not enough to have the theme bumped. To "bump" it I oftenrm -fr'ed the venv manually over ssh on the build server to have it fresh on the next build: this is not optimal.One of the way to fix it would be to be more precise about which version of the theme we want in the cpython's
Doc/requirements.txtfile, but in the other hand this means that once a Python version is in security-only and EOL we have no way to bump its theme (except by overwriting it in docsbuild-script, which is already possible).Would the following change help at all?
- [venv_path / "bin" / "python", "-m", "pip", "install"] + [venv_path / "bin" / "python", "-m", "pip", "install", "--upgrade"]
That should do it, yes.
Thanks, please see PR python/docsbuild-scripts#161.
We could also consider removing the venv for each build, it only takes some 5s to recreate it locally with everything already in the pip cache.
I think other hosts such as Read the Docs, Netlify and GitHub Pages deploy to a clean slate.
We have the dark theme (#44) deployed on https://docs.python.org/3.12/ and https://docs.python.org/3.13/ and I think it's ready for https://docs.python.org/3/ 馃殌
@JulienPalard What do we need to deploy on 3.11?
#44 was merged in the latest 2023.5 release.
I checked
requirements.txtin the 3.11 branch, but that haspython-docs-theme>=2022.1which would install the latest, but it mustn't be using this file:https://github.com/python/cpython/blob/4f7c23e4dfb4b932b3916f8f79895e2a1bf3ae43/Doc/requirements.txt#L16-L18
I also checked but didn't find it in https://github.com/python/docsbuild-scripts
Where is the version pinned for each actual docs deploy?
Thanks!