DOC: Add an option to disable Google Analytics.

QuLogic · QuLogic · commit 1370be89c54c · 2020-09-24T19:06:21.000-04:00
Fixes #5823.
diff --git a/doc/_templates/layout.html b/doc/_templates/layout.html
@@ -96,6 +96,7 @@
 {%- endif %}
     </div>
 </footer>
+{%- if include_analytics %}
 <script>
         (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
         (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
@@ -106,4 +107,5 @@
         ga('send', 'pageview');
 
 </script>
+{%- endif %}
 {%- endblock %}
diff --git a/doc/conf.py b/doc/conf.py
@@ -183,7 +183,12 @@ def _check_dependencies():
 except (subprocess.CalledProcessError, FileNotFoundError):
     SHA = matplotlib.__version__
 
-html_context = {'sha': SHA}
+html_context = {
+    'sha': SHA,
+    # This will disable any analytics in the HTML templates (currently Google
+    # Analytics.)
+    'include_analytics': False,
+}
 
 project = 'Matplotlib'
 copyright = ('2002 - 2012 John Hunter, Darren Dale, Eric Firing, '
diff --git a/doc/devel/release_guide.rst b/doc/devel/release_guide.rst
@@ -313,7 +313,7 @@ build the docs from the ``ver-doc`` branch.  An easy way to arrange this is::
   pip install -r requirements/doc/doc-requirements.txt
   git checkout v2.0.0-doc
   git clean -xfd
-  make -Cdoc O=-j$(nproc) html latexpdf LATEXMKOPTS="-silent -f"
+  make -Cdoc O="-Ainclude_analytics=True -j$(nproc)" html latexpdf LATEXMKOPTS="-silent -f"
 
 which will build both the html and pdf version of the documentation.
 
