doc: update to sphinx_rtd_theme 1.0

The sphinx_rtd_theme 1.0 includes simplified configuration for Google
analytics, along with general fixes and improvements.

Anyone publishing project documentation to projectacrn.github.io must be
using this updated sphinx_rtd_theme for Google Analytics data to be
properly collected.

* Switch to use this new theme version, and clean up the previous method
  of collecting analytics data.
* Update requirements.txt to use this new theme version. Update the
  show-versions.py script (used to report on installed doc building tools)
  to also report if there's a mismatch on which version is expected (in
  requirements.txt) and what's currently installed.

Signed-off-by: David B. Kinder <david.b.kinder@intel.com>
This commit is contained in:
David B. Kinder
2021-10-19 11:35:37 -07:00
committed by David Kinder
parent 3bbab125b1
commit e2e33f76b9
4 changed files with 5 additions and 8 deletions

View File

@@ -1,5 +1,5 @@
breathe==4.23.0
sphinx==3.2.1
docutils==0.16
sphinx_rtd_theme==0.5.0
sphinx_rtd_theme==1.0
sphinx-tabs==1.3.0

View File

@@ -32,6 +32,9 @@ for reqs in pkg_resources.parse_requirements(rf):
try:
ver = pkg_resources.get_distribution(reqs.project_name).version
print (" " + reqs.project_name.ljust(25," ") + " version: " + ver)
if not reqs.__contains__(ver):
print (color.RED + color.BOLD + " >>> Warning: Expected version " +
reqs.__str__() + " Python module from scripts/requirements.text." + color.END)
except:
print (color.RED + color.BOLD + reqs.project_name + " is missing." + color.END +
" (Hint: install all dependencies with " + color.YELLOW +