Inherit openstackdocstheme for governance.o.o

All governance subwebsites switched from using an old
oslosphinx-based theme to inheriting from openstackdocstheme
instead. Also switch the election website for consistency.

Depends-On: https://review.openstack.org/611761
Change-Id: I3ec2ff2bc2ec6683919ea6541fd657cdc8723df8

doc/source/_themes/governance/sidebartoc_menu.html

@@ -0,0 +1,8 @@
+<button href="#" type="button" data-toggle="dropdown" class="btn docs-sidebar-release-select">OpenStack Governance<i class="fa fa-caret-down"></i></button>
+    <ul class="dropdown-menu docs-sidebar-dropdown" role="menu" aria-labelledby="dLabel">
+      <li role="presentation"><a role="menuitem" tabindex="-1" href="https://wiki.openstack.org/wiki/Governance/Foundation">Board of Directors</a></li>
+      <li role="presentation"><a role="menuitem" tabindex="-1" href="https://governance.openstack.org/tc/">Technical Committee</a></li>
+      <li role="presentation"><a role="menuitem" tabindex="-1" href="https://governance.openstack.org/uc/">User Committee</a></li>
+      <li role="presentation"><a role="menuitem" tabindex="-1" href="https://governance.openstack.org/sigs/">SIGs</a></li>
+      <li role="presentation"><a role="menuitem" tabindex="-1" href="https://governance.openstack.org/election/">Elections</a></li>
+    </ul>

doc/source/_themes/governance/theme.conf

@@ -0,0 +1,2 @@
+[theme]
+inherit = openstackdocs

doc/source/conf.py

@@ -29,7 +29,7 @@ sys.path.insert(0, os.path.join(os.path.abspath('.'), '_exts'))
 # coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
 extensions = [
     'sphinx.ext.extlinks',
-    'oslosphinx',
+    'openstackdocstheme',
     'candidates',
     'events',
     'configuration',
@@ -100,19 +100,22 @@ modindex_common_prefix = []
 
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
-html_theme = 'nature'
+html_theme = 'governance'
 
 # Theme options are theme-specific and customize the look and feel of a theme
 # further.  For a list of options available for each theme, see the
 # documentation.
-#html_theme_options = {}
+html_theme_options = {
+    'display_global_toc_section': False,
+    'root_title': 'OpenStack Governance'
+}
 
 # Add any paths that contain custom themes here, relative to this directory.
-#html_theme_path = []
+html_theme_path = ['_themes']
 
 # The name for this set of Sphinx documents.  If None, it defaults to
 # "<project> v<release> documentation".
-#html_title = None
+html_title = 'OpenStack Governance'
 
 # A shorter title for the navigation bar.  Default is the same as html_title.
 #html_short_title = None

test-requirements.txt

@@ -3,7 +3,7 @@
 # process, which may cause wedges in the gate later.
 # needed for doc build
 sphinx>=1.6.2 # BSD
-oslosphinx>=4.7.0 # Apache-2.0
+openstackdocstheme>=1.25.1  # Apache-2.0
 hacking<0.12,>=0.11.0 # Apache-2.0
 yamllint
 mock>=2.0.0 # BSD