Docs: prep for upcoming RTD build changes

Read the Docs is changing their build process. Some docs/conf.py
manipulation they used to do automatically now must be manually
included.

https://about.readthedocs.com/blog/2024/07/addons-by-default/

Related changes:

* Drop our version-alert.js. RTD's new "addons" includes
  equivalent warning on unreleased versions.

* Integrate Google Analytics via sphinxcontrib-googleanalytics
  when GOOGLE_ANALYTICS_ID is set in docs build environment.
This commit is contained in:
Mike Edmunds
2024-08-28 13:20:57 -07:00
parent 9d4fb5daf9
commit 397dcf5f8a
4 changed files with 25 additions and 41 deletions

View File

@@ -106,6 +106,7 @@ commands =
basepython = python3.11
passenv =
CONTINUOUS_INTEGRATION
GOOGLE_ANALYTICS_ID
# (but not any of the live test API keys)
setenv =
DOCS_BUILD_DIR={envdir}/_html