Change docs theming and update styling

Change-Id: Ia38e77cf4a21b05fba9af289f0b4f7c8436cc29f

doc/source/_custom/custom.css

@@ -0,0 +1,112 @@
+@import url("css/theme.css");
+
+
+/* CUSTOM CSS OVERRIDES GO HERE */
+/* ============================ */
+
+
+/* LAYOUT */
+.wy-nav-content-wrap {
+  background: white;
+}
+
+.wy-nav-content {
+  max-width: 100%;
+  box-sizing: border-box;
+}
+
+.rst-content .section ol li p.first:last-child {
+    margin-bottom: 24px;
+}
+
+
+/* TYPOGRAPHY */
+p {
+  margin-bottom: 16px;
+}
+
+p + ul, p + ol.simple {
+  margin-top: -12px;
+}
+
+h1, h2, h3, h4, h5, h6, p.rubric {
+  margin-top: 48px;
+}
+
+h2 {
+  border-bottom: 1px solid rgba(0, 0, 0, 0.2);
+}
+
+footer {
+  font-size: 70%;
+  margin-top: 48px;
+}
+
+footer p {
+  font-size: inherit;
+}
+
+
+/* NOTES, ADMONITTIONS AND TAGS */
+.admonition {
+  font-size: 85%; /* match code size */
+  background: rgb(240, 240, 240);
+  color: rgba(0, 0, 0, 0.55);
+  border: 1px solid rgba(0, 0, 0, 0.1);
+  padding: 0.5em 1em 0.75em 1em;
+  margin-bottom: 24px;
+}
+
+.admonition p {
+  font-size: inherit;
+}
+
+.admonition p.last {
+  margin-bottom: 0;
+}
+
+.admonition p.first.admonition-title {
+  display: inline;
+  background: none;
+  font-weight: bold;
+  color: rgba(0, 0, 0, 0.75);
+}
+
+/* notes */
+.rst-content .note {
+  background: rgb(240, 240, 240);
+}
+.note > p.first.admonition-title {
+  display: inline-block;
+  background: rgba(0, 0, 0, 0.55);
+  color: rgba(255, 255, 255, 0.95);
+}
+
+/* tags */
+.rhel-tag {background: #fee;}
+.centos-tag {background: #fef;}
+.baremetal-tag {background: #eef;}
+.virt-tag {background: #efe;}
+.ceph-tag {background: #eff;}
+
+
+/* LINKS */
+a.external:after {
+  font-family: FontAwesome;
+  content: '';
+  visibility: visible;
+  display: inline-block;
+  font-size: 70%;
+  position: relative;
+  padding-left: 0.5em;
+  top: -0.5em;
+}
+
+
+/* LIST */
+.wy-plain-list-decimal li ul,
+.rst-content .section ol li ul,
+.rst-content ol.arabic li ul,
+article ol li ul {
+    margin-bottom: 24px;
+}

doc/source/conf.py

@@ -12,6 +12,7 @@
 # serve to show the default.
 
 import sys, os
+import sphinx_rtd_theme
 
 # 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
@@ -91,7 +92,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 = 'theme'
+html_theme = 'sphinx_rtd_theme'
 
 # 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
@@ -99,7 +100,7 @@ html_theme = 'theme'
 #html_theme_options = {}
 
 # Add any paths that contain custom themes here, relative to this directory.
-html_theme_path = ['.']
+html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]
 
 # The name for this set of Sphinx documents.  If None, it defaults to
 # "<project> v<release> documentation".
@@ -120,7 +121,9 @@ html_theme_path = ['.']
 # 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 = ['_custom']
+
+html_style = 'custom.css'
 
 # If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
 # using the given strftime format.

doc/source/theme/static/instack.css

@@ -1,11 +0,0 @@
-@import url("default.css");
-
-.rhel-tag {background-color: #fee; border: 1px solid #ccc;}
-
-.centos-tag {background-color: #fef; border: 1px solid #ccc;}
-
-.baremetal-tag {background-color: #eef; border: 1px solid #ccc;}
-
-.virt-tag {background-color: #efe; border: 1px solid #ccc;}
-
-.ceph-tag {background-color: #eff; border: 1px solid #ccc;}

doc/source/theme/theme.conf

@@ -1,3 +0,0 @@
-[theme]
-inherit = default
-stylesheet = instack.css

test-requirements.txt

@@ -1,3 +1,4 @@
 # Doc requirements
 sphinx>=1.1.2,!=1.2.0,!=1.3b1,<1.3
 oslosphinx>=2.2.0  # Apache-2.0
+sphinx_rtd_theme==0.1.7