[Doc] openstackdocstheme starlingxdocs theme

Enable starlingxdocs theme support for:

- Documentation
- Release Notes
- API Reference

Add zuul check and gate job:

- build-openstack-api-ref

Change-Id: I0d59eaf777bb0f462db4d436c030a785e61798d2
Signed-off-by: Abraham Arce <abraham.arce.moreno@intel.com>

.zuul.yaml

@@ -4,12 +4,14 @@
       - build-openstack-docs-pti
     check:
       jobs:
+        - build-openstack-api-ref
         - build-openstack-releasenotes
         - openstack-tox-linters
         - openstack-tox-pep8
         - stx-updates-pylint
     gate:
       jobs:
+        - build-openstack-api-ref
         - build-openstack-releasenotes
         - openstack-tox-linters
         - openstack-tox-pep8

api-ref/source/conf.py

@@ -20,7 +20,7 @@ extensions = [
     'os_api_ref',
 ]
 
-html_theme = 'alabaster'
+html_theme = 'starlingxdocs'
 
 html_theme_options = {
     "sidebar_dropdown": "api_ref",

doc/requirements.txt

@@ -1,5 +1,5 @@
 sphinx>=1.6.2
-openstackdocstheme>=1.19.0 # Apache-2.0
+openstackdocstheme>=1.26.0 # Apache-2.0
 
 # Release Notes documentation
 reno>=0.1.1 # Apache2

doc/source/conf.py

@@ -82,7 +82,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 = 'alabaster'
+html_theme = 'starlingxdocs'
 
 # 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

releasenotes/source/conf.py

@@ -93,7 +93,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 = 'alabaster'
+html_theme = 'starlingxdocs'
 
 # 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