Get ready for os-api-ref sphinx theme change

Change-Id: Ib4aa4a26814273efafa3453237d18acf8cc966cb

api-ref/source/conf.py

@@ -29,6 +29,36 @@ import subprocess
 import sys
 import warnings
 
+# TODO(Graham Hayes): Remove the following block of code when os-api-ref is
+# using openstackdocstheme
+
+import os_api_ref
+
+if getattr(os_api_ref, 'THEME', 'olsosphinx') == 'openstackdocstheme':
+    # We are on the new version with openstackdocstheme support
+
+    extensions = [
+        'os_api_ref',
+    ]
+
+    import openstackdocstheme  # noqa
+
+    html_theme = 'openstackdocs'
+    html_theme_path = [openstackdocstheme.get_html_theme_path()]
+    html_theme_options = {
+        "sidebar_mode": "toc",
+    }
+
+else:
+    # We are on the old version without openstackdocstheme support
+
+    extensions = [
+        'os_api_ref',
+        'oslosphinx',
+    ]
+
+# End temporary block
+
 # If extensions (or modules to document with autodoc) are in another directory,
 # add these directories to sys.path here. If the directory is relative to the
 # documentation root, use os.path.abspath to make it absolute, like shown here.
@@ -41,11 +71,6 @@ sys.path.insert(0, os.path.abspath('./'))
 # Add any Sphinx extension module names here, as strings. They can be
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
 
-extensions = [
-    'os_api_ref',
-    'oslosphinx',
-]
-
 # The suffix of source filenames.
 source_suffix = '.rst'