docs: improve RTD

.readthedocs.yaml

@@ -2,10 +2,14 @@
 version: 2
 
 build:
- os: ubuntu-22.04
+ os: ubuntu-lts-latest
  tools:
  # Keep version in sync with tox.ini/docs and ci.yml/docs.
  python: "3.12"
+ jobs:
+ # Need the tags to calculate the version (sometimes).
+ post_checkout:
+ - git fetch --tags
 
 python:
  install:

docs/conf.py

@@ -1,9 +1,19 @@
 # SPDX-License-Identifier: MIT
 
+import os
+
 from importlib import metadata
 from pathlib import Path
 
 
+# Set canonical URL from the Read the Docs Domain
+html_baseurl = os.environ.get("READTHEDOCS_CANONICAL_URL", "")
+
+# Tell Jinja2 templates the build is running on Read the Docs
+if os.environ.get("READTHEDOCS", "") == "True":
+ html_context = {"READTHEDOCS": True}
+
+
 # -- Path setup -----------------------------------------------------------
 
 PROJECT_ROOT_DIR = Path(__file__).parents[1].resolve()