Apply OpenStack style to generated docs

Make generated HTML docs look the same as other official
OpenStack docs.

Change-Id: I1064dd7b769f0015fa3d5d8330e8932093af99b1

doc/source/conf.py

@@ -32,6 +32,7 @@ extensions = [
     'rst2pdf.pdfbuilder',
     'sphinx.ext.autodoc',
     'sphinxcontrib.httpdomain',
+    'oslosphinx',
 ]
 
 # Add any paths that contain templates here, relative to this directory.
@@ -105,12 +106,6 @@ on_rtd = os.environ.get('READTHEDOCS', None) == 'True'
 
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
-if not on_rtd:  # only import and set the theme if we're building docs locally
-    import sphinx_rtd_theme
-    html_theme = 'sphinx_rtd_theme'
-    html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]
-else:
-    html_theme = 'default'
 
 # 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

requirements.txt

@@ -1,3 +1,4 @@
+oslosphinx>=2.5.0 # Apache-2.0
 rst2pdf
 six>=1.9.0
 sphinx!=1.2.0,!=1.3b1,<1.3,>=1.1.2