Use sphinxcontrib extension for google analytics

RTD theme has deprecated their support for it

Author: rogerbinns

Makefile

@@ -87,7 +87,7 @@ doc/renames.rstgen: tools/names.py tools/renames.json
 	env PYTHONPATH=. $(PYTHON) tools/names.py rst-gen > doc/renames.rstgen
 
 doc-depends: ## pip installs packages needed to build doc
-	$(PYTHON) -m pip install -U --upgrade-strategy eager sphinx sphinx_rtd_theme
+	$(PYTHON) -m pip install -U --upgrade-strategy eager sphinx sphinx_rtd_theme sphinxcontrib-googleanalytics
 
 dev-depends: ## pip installs packages useful for development (none are necessary except setuptools)
 	$(PYTHON) -m pip install -U --upgrade-strategy eager build wheel setuptools pip

doc/conf.py

@@ -25,6 +25,11 @@ def split(self, input):
     "sphinx.ext.autosummary",
 ]
 
+if not os.getenv("APSW_NO_GA"):
+    extensions.append("sphinxcontrib.googleanalytics")
+    googleanalytics_id = "G-2NR9GDCQLT"
+
+
 # this shows shorter names like Buffer instead of collections.abc.Buffer
 python_use_unqualified_type_names = True
 # less verbose Literal [ "one", "two"] -> "one" : "two"
@@ -81,13 +86,10 @@ def split(self, input):
 html_title = f"{ project } { version } documentation"
 html_theme = "sphinx_rtd_theme"
 html_theme_options = {
-    "analytics_id": "G-2NR9GDCQLT",
     "prev_next_buttons_location": "both",
 }
 html_css_files = ["apsw.css"]
-
-if os.getenv("APSW_NO_GA"):
-    del html_theme_options["analytics_id"]
+html_baseurl = "https://rogerbinns.github.io/apsw/"
 
 html_favicon = "favicon.ico"