[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: If47613fb6afa4e25b62360a4e3441a93296f4570
Signed-off-by: Abraham Arce <abraham.arce.moreno@intel.com>

.zuul.yaml

@@ -4,6 +4,7 @@
       - build-openstack-docs-pti
     check:
       jobs:
+        - build-openstack-api-ref
         - build-openstack-releasenotes
         - openstack-tox-linters
         - nfv-tox-pep8
@@ -13,6 +14,7 @@
         - nova-api-proxy-tox-pylint
     gate:
       jobs:
+        - build-openstack-api-ref
         - build-openstack-releasenotes
         - openstack-tox-linters
         - nfv-tox-pep8

api-ref/source/conf.py

@@ -20,7 +20,7 @@ extensions = [
     'os_api_ref',
 ]
 
-html_theme = 'openstackdocs'
+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