ENH: Use our built version of sphinx_rtd_theme

This has support for choosing which version, so turn this on, with
static configuration for latest and dev docs.

Author: dopplershift

.travis.yml

@@ -60,12 +60,14 @@ matrix:
 before_install:
   # Shapely dependency needed to keep from using Shapely's manylinux wheels
   # which use a different geos that what we build cartopy with on Travis
+  # We hardcode the sphinx_rtd_theme to lock in our build with patch for
+  # version chooser
   - pip install --upgrade pip;
   - pip install --upgrade setuptools;
   - if [[ $TASK == "docs" ]]; then
       if ! git describe --tags; then git fetch --depth=150; fi;
       export EXTRA_INSTALLS="cdm,doc,examples";
-      export EXTRA_PACKAGES="Cython pillow shapely<1.5.17.post1 sphinx_rtd_theme pytest recommonmark";
+      export EXTRA_PACKAGES="Cython pillow shapely<1.5.17.post1 sphinx_rtd_theme==0.2.5b1.post1 pytest recommonmark";
       ls $HOME/local/lib/;
       if [[ ! -f $HOME/local/lib/libproj.so ]]; then
         wget http://download.osgeo.org/proj/proj-4.9.3.tar.gz;

docs/conf.py

@@ -65,7 +65,6 @@
 }
 
 
-
 # Turn off code and image links for embedded mpl plots
 plot_html_show_source_link = False
 plot_html_show_formats = False
@@ -108,7 +107,7 @@
 #
 # The short X.Y version.
 verinfo = metpy.__version__
-version = verinfo.split('+')[0]
+version = verinfo.split('+')[0].rsplit('.', maxsplit=1)[0]
 # The full version, including alpha/beta/rc tags.
 release = verinfo
 
@@ -167,10 +166,12 @@
 def setup(app):
     app.add_stylesheet('theme_override.css')
 
+
 # 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
 # documentation.
-html_theme_options = {'canonical_url': 'https://unidata.github.io/MetPy/latest/'}
+html_theme_options = {'canonical_url': 'https://unidata.github.io/MetPy/latest/',
+                      'versions': {'latest': '../latest', 'dev': '../dev'}}
 
 # Add any paths that contain custom themes here, relative to this directory.
 # html_theme_path = []