DOC: Tweaks to banner handling

Allow controlling theming in the renamed banner.html file. Also tweak
the theme for the notice about the version.

Author: dopplershift

docs/_static/doc_shared.js

@@ -1,4 +1,4 @@
-const proj = "MetPy";
+const project = "MetPy";
 
 $(document).ready(function() {
     cur_ver = DOCUMENTATION_OPTIONS.VERSION;
@@ -8,15 +8,15 @@ $(document).ready(function() {
     }
     console.log('cur_ver: ' + cur_ver);
 
-    $.getJSON('/' + proj + '/versions.json', function(data) {
+    $.getJSON('/' + project + '/versions.json', function(data) {
         if (cur_ver !== data.latest) {
             let msg;
             if (cur_ver.includes('dev') || data.prereleases.indexOf(cur_ver) > -1) {
                 msg = 'development / pre-release';
             } else {
                 msg = 'previous';
             }
-            content = $('<div class="alert alert-warning alert-version" role="alert">This documentation page is for a ' + msg +
+            content = $('<div class="alert alert-secondary alert-version" role="alert">This documentation page is for a ' + msg +
                         ' version. For the latest release version, go to <a class="alert-link" href="https://unidata.github.io/MetPy/latest/">https://unidata.github.io/MetPy/latest/</a>');
             $('#banner').append(content);
         }
@@ -31,13 +31,13 @@ $(document).ready(function() {
     });
 });
 
-// Borrowed from Bokeh docs to look for an alert.html at the base of the
-// docs repo and add that to the banner if present.
+// Borrowed from Bokeh docs to look for a banner.html at the base of the docs repo and add that
+// to the banner if present.
 $(document).ready(function () {
-    $.get('/' + proj + '/alert.html', function (data) {
-       if (data.length > 0) {
-         content = $('<div class="alert alert-primary alert-news" role="alert">' + data + '</div>')
-         $('#banner').prepend(content);
-       }
+    $.get('/' + project + '/banner.html', function (data) {
+        if (data.length > 0) {
+            console.log(data);
+            $('#banner').prepend(data);
+        }
     })
  })

docs/doc-server.py

@@ -20,8 +20,8 @@ class Server(http.server.SimpleHTTPRequestHandler):
 
     def translate_path(self, path):
         """Translate a request path to the proper path into the built docs."""
-        if path == '/MetPy/alert.html':
-            return str(TEST_FILES_DIR / 'alert.html')
+        if path == '/MetPy/banner.html':
+            return str(TEST_FILES_DIR / 'banner.html')
         elif path == '/MetPy/versions.json':
             return str(TEST_FILES_DIR / 'versions.json')
         elif path.startswith('/MetPy/'):

docs/test-server/alert.html

@@ -0,0 +1,4 @@
+<div class="alert alert-warning alert-news" role="alert">
+    MetPy 1.0 changed how some functions behave and might require updating your code. See the
+    <a  class="alert-link" href="userguide/upgradeguide.html">1.0 Upgrade Guide</a> for more information.
+</div>