From d3e3d1b8a92dfdc4517942b7addaefdac45a63c2 Mon Sep 17 00:00:00 2001
From: Goutham Pacha Ravi <gouthampravi@gmail.com>
Date: Fri, 27 Apr 2018 13:27:29 -0700
Subject: [PATCH] Switch to openstackdocstheme

Provides consistency across other specifications
on specs.openstack.org.

Change-Id: Ibcdba4fe820193b1594f36cef6c31c24005bd464
---
 doc/source/conf.py | 12 ++++++++++--
 requirements.txt   |  2 +-
 tox.ini            |  2 +-
 3 files changed, 12 insertions(+), 4 deletions(-)

diff --git a/doc/source/conf.py b/doc/source/conf.py
index a347c6c..8055de6 100755
--- a/doc/source/conf.py
+++ b/doc/source/conf.py
@@ -28,7 +28,7 @@ extensions = [
     'sphinxcontrib.actdiag',
     'sphinxcontrib.seqdiag',
     'sphinxcontrib.nwdiag',
-    'oslosphinx',
+    'openstackdocstheme',
     # TODO(tbarron): re-enable yasfb after
     # https://github.com/sphinxcontrib/yasfb/commit/62d18c66835320af4a71fb088cb502041478fb16
     # is released; it currently breaks with python 3.5
@@ -72,12 +72,16 @@ pygments_style = 'sphinx'
 # The theme to use for HTML and HTML Help pages.  Major themes that come with
 # Sphinx are currently 'default' and 'sphinxdoc'.
 # html_theme_path = ["."]
-# html_theme = '_theme'
+html_theme = 'openstackdocs'
 # html_static_path = ['static']
 
 # Output file base name for HTML help builder.
 htmlhelp_basename = '%sdoc' % project
 
+# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
+# using the given strftime format.
+html_last_updated_fmt = '%Y-%m-%d %H:%M'
+
 # Grouping the document tree into LaTeX files. List of tuples
 # (source start file, target name, title, author, documentclass
 # [howto/manual]).
@@ -90,3 +94,7 @@ latex_documents = [
 
 # Example configuration for intersphinx: refer to the Python standard library.
 # intersphinx_mapping = {'http://docs.python.org/': None}
+
+repository_name = 'openstack/manila-specs'
+bug_project = 'manila'
+bug_tag = ''
diff --git a/requirements.txt b/requirements.txt
index e05596b..f6c01b5 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -3,7 +3,7 @@ pbr>=2.0.0
 actdiag
 blockdiag
 nwdiag
-oslosphinx>=4.7.0
+openstackdocstheme>=1.18.1 # Apache-2.0
 seqdiag
 sphinx>=1.5.1,!=1.6.1  # BSD
 sphinxcontrib-actdiag
diff --git a/tox.ini b/tox.ini
index 12cb5ca..d7276ea 100644
--- a/tox.ini
+++ b/tox.ini
@@ -24,6 +24,6 @@ commands = {posargs}
 whitelist_externals = rm
 commands =
   rm -rf doc/build
-  python setup.py build_sphinx
+  sphinx-build -b html doc/source doc/build/html
   # Ignore D001 since we allow lines in excess of 79 characters.
   doc8 --ignore D001 --ignore-path .tox --ignore-path .eggs --ignore-path doc/build --ignore-path manila_specs.egg-info -e txt -e rst