bpo-45729: [doc] Add license_url for python-docs-theme 2022.1.

[JulienPalard]

I also changed issues_url so it serve local pages when using make serve locally.

It'll also works on prod as /license.html redirects to /3/license.html (same for /bugs.html).

https://bugs.python.org/issue45729

[hugovk]

Confirmed fixed:

cd Doc
make clean-venv
make venv
make html
make serve
open http://localhost:8000/

main

PR

note

make clean-venv venv were needed because without it it used an old version of the theme:

$ make html
...
preparing documents... failed

Warning, treated as error:
unsupported theme option 'license_url' given
make: *** [build] Error 2

We could add a lower bound for the theme in Doc/make.bat and Doc/requirements.txt, but if it's always installed in a fresh venv should be okay.

[JulienPalard]

I fixed the minimum version on Docs/requirements.txt to ensure nobody get the error about the theme variable not being known. I'll merge this as it fixes the doc on docs.python.org. I don't think make.bat needs it, but if it need it another PR could be created for it.

[miss-islington]

Thanks @JulienPalard for the PR 🌮🎉.. I'm working now to backport this PR to: 3.9, 3.10.
🐍🍒⛏🤖

[JulienPalard]

Thanks @hugovk for the review and the test!

[bedevere-bot]

GH-30540 is a backport of this pull request to the 3.10 branch.

[bedevere-bot]

GH-30541 is a backport of this pull request to the 3.9 branch.

[merwok]

I fixed the minimum version on Docs/requirements.txt to ensure nobody get the error about the theme variable not being known.

That works for new venvs, but not existing ones. The makefile does not always run pip install -r requirements.txt, and there is no easy file to add as a target dependency to cause automatic update. So people will need to translate the error message into make clean-venv venv or venv/bin/pip install -r requirements.txt.