Adds build information for using new openstackdocs theme

oslosphinx must remain because the Hot template guide uses it.

Depends-On: I19ac7e4caab879217cb3024157e3ddd231f5189d

Change-Id: Ib5e68c17aba85823bca74387ee144fd961da15ff

doc/playground-user-guide/source/conf.py

@@ -12,6 +12,8 @@
 import sys
 import os
 
+import openstackdocstheme
+
 # 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.
@@ -25,10 +27,10 @@ import os
 # Add any Sphinx extension module names here, as strings. They can be
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
 # ones.
-extensions = ['oslosphinx']
+extensions = []
 
 # Add any paths that contain templates here, relative to this directory.
-templates_path = ['_templates']
+#templates_path = ['_templates']
 
 # The suffix of source filenames.
 source_suffix = '.rst'
@@ -95,7 +97,7 @@ pygments_style = 'sphinx'
 
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
-html_theme = 'default'
+html_theme = 'openstackdocs'
 
 # 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
@@ -103,7 +105,7 @@ html_theme = 'default'
 #html_theme_options = {}
 
 # Add any paths that contain custom themes here, relative to this directory.
-#html_theme_path = []
+html_theme_path = [openstackdocstheme.get_html_theme_path()]
 
 # The name for this set of Sphinx documents.  If None, it defaults to
 # "<project> v<release> documentation".
@@ -124,7 +126,7 @@ html_theme = 'default'
 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,
 # so a file named "default.css" will overwrite the builtin "default.css".
-html_static_path = ['_static']
+#html_static_path = []
 
 # Add any extra paths that contain custom files (such as robots.txt or
 # .htaccess) here, relative to this directory. These files are copied

test-requirements.txt

@@ -6,4 +6,5 @@ Jinja2>=2.6  # BSD License (3 clause)
 doc8  # Apache-2.0
 openstack-doc-tools>=0.21.1
 sphinx>=1.1.2,!=1.2.0,!=1.3b1,<1.3
+openstackdocstheme>=1.0.2
 oslosphinx>=2.2.0  # Apache-2.0

tox.ini

@@ -49,6 +49,9 @@ commands =
   rsync -a doc/playground-user-guide/build/html/ publish-docs/playground-user-guide/content/
   openstack-doc-test --check-build {posargs}
 
+[testenv:docs]
+commands = sphinx-build doc/playground-user-guide/source/ doc/playground-user-guide/build/html
+
 [testenv:publishdocs]
 # Prepare all documents (except www subdir) so that they can get
 # published on docs.openstack.org with just copying publish-docs/*