Merge pull request #293 from huard/rtd_theme

Read the docs theme

Author: nilshempelmann

docs/source/_static/style.css

@@ -0,0 +1,24 @@
+@import url("theme.css");
+
+.wy-side-nav-search>a img.logo,
+.wy-side-nav-search .wy-dropdown>a img.logo {
+  width: 12rem;
+}
+
+/* Logo and search background color */
+.wy-side-nav-search {
+  background-color: #eee;
+}
+
+/* The color of the Flyingpigeon text above the logo. */
+.wy-side-nav-search>a{
+  color: #2f3974;
+}
+
+.wy-side-nav-search>div.version {
+  display: none;
+}
+
+.wy-nav-top {
+  background-color: #555;
+}

docs/source/_templates/layout.html

@@ -0,0 +1,2 @@
+{% extends "!layout.html" %}
+{% set css_files = css_files + ["_static/style.css"] %}

docs/source/conf.py

@@ -87,7 +87,15 @@
 
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
-html_theme = 'alabaster'
+# html_theme = 'alabaster'
+on_rtd = os.environ.get('READTHEDOCS', None) == 'True'
+
+if on_rtd:
+    html_theme = 'default'
+else:  # only import and set the theme if we're building docs locally
+    import sphinx_rtd_theme
+    html_theme = 'sphinx_rtd_theme'
+    html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]
 
 # 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

environment.yml

@@ -33,3 +33,4 @@ dependencies:
   - -e git+https://github.com/bird-house/eggshell.git#egg=eggshell
   - -e git+https://github.com/NCPP/ocgis#egg=owslib
   - -e git+https://github.com/geopython/pywps.git#egg=pywps
+  - sphinx_rtd_theme