Clean-up documentation theme

docs/conf.py

@@ -185,6 +185,8 @@
     # 'canonical_url': "https://docs.ansible.com/ansible/latest/",
     "vcs_pageview_mode": "edit",
     "navigation_depth": 3,
+    "display_version": False,
+    "logo_only": True,
 }
 
 html_context = {
@@ -195,10 +197,10 @@
     "current_version": version,
     "latest_version": "latest",
     # list specifically out of order to make latest work
-    "available_versions": ("latest", "stable"),
-    "css_files": (),  # overrides to the standard theme
+    "available_versions": ("latest",),
 }
 
+# This appears on the left side of the page, in the header bar
 html_short_title = "Ansible Lint Documentation"
 
 # The style sheet to use for HTML and HTML Help pages. A file of that name
@@ -273,7 +275,7 @@
 # table width fix via: https://rackerlabs.github.io/docs-rackspace/tools/rtd-tables.html
 html_static_path = ["_static"]
 
-html_css_files = [
+html_css_files = [  # relaticve to html_static_path
     "theme_overrides.css",  # override wide tables in RTD theme
     "ansi.css",
 ]

docs/_static/theme_overrides.css → docs/css/theme_overrides.css

@@ -12,3 +12,7 @@
     overflow: visible !important;
   }
 }
+
+.icon-home {
+  display: none !important;
+}

requirements.txt

@@ -22,7 +22,7 @@ coverage==6.4.4
 coverage-enable-subprocess==1.0
 cryptography==38.0.1
 dill==0.3.5.1
-docutils==0.16
+docutils==0.17.1
 enrich==1.2.7
 execnet==1.9.0
 filelock==3.8.0
@@ -75,7 +75,7 @@ ruamel-yaml-clib==0.2.6
 snowballstemmer==2.2.0
 sphinx==5.1.1
 sphinx-ansible-theme==0.9.1
-sphinx-rtd-theme==0.5.2
+sphinx-rtd-theme==1.0.0
 sphinxcontrib-apidoc==0.3.0
 sphinxcontrib-applehelp==1.0.2
 sphinxcontrib-devhelp==1.0.2

setup.cfg

@@ -92,7 +92,7 @@ docs =
   pipdeptree >= 2.2.1
   sphinx >= 4.4.0
   sphinx-ansible-theme >= 0.9.1
-  sphinx-rtd-theme >= 0.5.2, < 1.0.0   # 1.0.0 broke rendering
+  sphinx-rtd-theme >= 1.0.0, < 2.0.0   # 1.0.0 broke rendering
   sphinxcontrib-apidoc >= 0.3.0
   sphinxcontrib-programoutput2 >= 2.0a1
   yamllint >= 1.26.3