From 84d05620a866f5e284f77406d52bcdefcc26a7cb Mon Sep 17 00:00:00 2001
From: Daniel McCloy <dan@mccloy.info>
Date: Wed, 28 Jul 2021 10:15:00 -0500
Subject: [PATCH 01/27] add version switcher (cleaner diff this time)

---
 docs/_static/switcher.json                   | 97 ++++++++++++++++++++
 docs/conf.py                                 |  7 +-
 pydata_sphinx_theme/_templates/switcher.html | 50 ++++++++++
 pydata_sphinx_theme/theme.conf               |  4 +-
 4 files changed, 155 insertions(+), 3 deletions(-)
 create mode 100644 docs/_static/switcher.json
 create mode 100644 pydata_sphinx_theme/_templates/switcher.html

diff --git a/docs/_static/switcher.json b/docs/_static/switcher.json
new file mode 100644
index 000000000..252b23ceb
--- /dev/null
+++ b/docs/_static/switcher.json
@@ -0,0 +1,97 @@
+[
+    {
+        "name": "v0.6.3 (latest)",
+        "version": "latest",
+        "language": "en"
+    },
+    {
+        "name": "v0.6.2",
+        "version": "v0.6.2",
+        "language": "en"
+    },
+    {
+        "name": "v0.6.1",
+        "version": "v0.6.1",
+        "language": "en"
+    },
+    {
+        "name": "v0.6.0",
+        "version": "v0.6.0",
+        "language": "en"
+    },
+    {
+        "name": "v0.5.2",
+        "version": "v0.5.2",
+        "language": "en"
+    },
+    {
+        "name": "v0.5.1",
+        "version": "v0.5.1",
+        "language": "en"
+    },
+    {
+        "name": "v0.5.0",
+        "version": "v0.5.0",
+        "language": "en"
+    },
+    {
+        "name": "v0.4.3",
+        "version": "v0.4.3",
+        "language": "en"
+    },
+    {
+        "name": "v0.4.2",
+        "version": "v0.4.2",
+        "language": "en"
+    },
+    {
+        "name": "v0.4.1",
+        "version": "v0.4.1",
+        "language": "en"
+    },
+    {
+        "name": "v0.4.0",
+        "version": "v0.4.0",
+        "language": "en"
+    },
+    {
+        "name": "v0.3.2",
+        "version": "v0.3.2",
+        "language": "en"
+    },
+    {
+        "name": "v0.3.1",
+        "version": "v0.3.1",
+        "language": "en"
+    },
+    {
+        "name": "v0.3.0",
+        "version": "v0.3.0",
+        "language": "en"
+    },
+    {
+        "name": "v0.2.2",
+        "version": "v0.2.2",
+        "language": "en"
+    },
+    {
+        "name": "v0.2.1",
+        "version": "v0.2.1",
+        "language": "en"
+    },
+    {
+        "name": "v0.2.0",
+        "version": "v0.2.0",
+        "language": "en"
+    },
+    {
+        "name": "v0.1.1",
+        "version": "v0.1.1",
+        "language": "en"
+    },
+    {
+        "name": "v0.1.0",
+        "version": "v0.1.0",
+        "language": "en"
+    }
+]
diff --git a/docs/conf.py b/docs/conf.py
index da3335521..df66fab44 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -24,7 +24,8 @@
 
 import pydata_sphinx_theme
 
-version = pydata_sphinx_theme.__version__.replace("dev0", "")
+release = pydata_sphinx_theme.__version__
+version = release.replace("dev0", "")
 
 # -- General configuration ---------------------------------------------------
 
@@ -96,7 +97,7 @@
     # "navbar_align": "left",  # [left, content, right] For testing that the navbar items align properly
     # "navbar_start": ["navbar-logo", "navbar-version"],
     # "navbar_center": ["navbar-nav", "navbar-version"],  # Just for testing
-    # "navbar_end": ["navbar-icon-links", "navbar-version"]  # Just for testing
+    "navbar_end": ["switcher", "navbar-icon-links"],
     # "footer_items": ["copyright", "sphinx-version", ""]
 }
 
@@ -106,6 +107,8 @@
     "github_repo": "pydata-sphinx-theme",
     "github_version": "master",
     "doc_path": "docs",
+    "switcher_json_url": "/_static/switcher.json",
+    "switcher_template_url": "https://pydata-sphinx-theme.readthedocs.io/{language}/{version}/",
 }
 
 # Add any paths that contain custom static files (such as style sheets) here,
diff --git a/pydata_sphinx_theme/_templates/switcher.html b/pydata_sphinx_theme/_templates/switcher.html
new file mode 100644
index 000000000..0d78decd3
--- /dev/null
+++ b/pydata_sphinx_theme/_templates/switcher.html
@@ -0,0 +1,50 @@
+<div class="dropdown">
+    <button type="button" class="btn btn-primary btn-sm navbar-btn dropdown-toggle" id="switcher_button" data-toggle="dropdown">
+        {{ switcher_prefix }}{{ release }}
+        <span class="caret"></span>
+    </button>
+    <div id="switcher" class="dropdown-menu list-group-flush py-0" aria-labelledby="switcher_button">
+    <!-- dropdown will be populated by javascript on page load -->
+    </div>
+</div>
+
+<script type="text/javascript">
+// Function to construct the target URL from the JSON components
+function buildURL(template, entry) {
+    //
+    var parts = template.split(/[\{\}]/);
+    version_ix = parts.indexOf("version");
+    language_ix = parts.indexOf("language");
+    if (version_ix >= 0) {
+        parts[version_ix] = entry.version;
+    }
+    if (language_ix >= 0) {
+        parts[language_ix] = entry.language;
+    }
+    return parts.join("");
+}
+// Function to populate the (release, language) version switcher
+(function () {
+    // get JSON config
+    $.getJSON("{{ switcher_json_url }}", function(data, textStatus, jqXHR) {
+        // create the nodes first (before AJAX calls) to ensure the order is
+        // correct (for now, links will go to doc version homepage)
+        $.each(data, function(index, entry) {
+            entry.url = buildURL("{{ switcher_template_url }}", entry);
+            $("#switcher").append(`<a class="list-group-item list-group-item-action py-1" href="${entry.url}">${entry.name}</a>`);
+        });
+        // see if the current page exists in the other versions of the docs
+        $.each(data, function(index, entry) {
+            let filePath = "{{ pagename }}.html";
+            $.ajax({
+                type: 'HEAD',
+                url: `${entry.url}${filePath}`,
+                // update the target URL if it exists
+                success: function() {
+                    $("#switcher").children()[index].setAttribute("href", `${entry.url}${filePath}`);
+                }
+            });
+        });
+    });
+})();
+</script>
diff --git a/pydata_sphinx_theme/theme.conf b/pydata_sphinx_theme/theme.conf
index aee05fa65..dbffc411c 100644
--- a/pydata_sphinx_theme/theme.conf
+++ b/pydata_sphinx_theme/theme.conf
@@ -31,4 +31,6 @@ navbar_start = navbar-logo.html
 navbar_center = navbar-nav.html
 navbar_end = navbar-icon-links.html
 footer_items = copyright.html, sphinx-version.html
-page_sidebar_items = page-toc.html, edit-this-page.html
\ No newline at end of file
+page_sidebar_items = page-toc.html, edit-this-page.html
+switcher_json_url =
+switcher_template_url =

From 5f4a02379065496f10762c2fc5e50d7a5d7ad11c Mon Sep 17 00:00:00 2001
From: Daniel McCloy <dan@mccloy.info>
Date: Tue, 10 Aug 2021 16:23:29 -0500
Subject: [PATCH 02/27] remove unreachable ancient versions

---
 docs/_static/switcher.json | 25 -------------------------
 1 file changed, 25 deletions(-)

diff --git a/docs/_static/switcher.json b/docs/_static/switcher.json
index 252b23ceb..0c967b9c8 100644
--- a/docs/_static/switcher.json
+++ b/docs/_static/switcher.json
@@ -68,30 +68,5 @@
         "name": "v0.3.0",
         "version": "v0.3.0",
         "language": "en"
-    },
-    {
-        "name": "v0.2.2",
-        "version": "v0.2.2",
-        "language": "en"
-    },
-    {
-        "name": "v0.2.1",
-        "version": "v0.2.1",
-        "language": "en"
-    },
-    {
-        "name": "v0.2.0",
-        "version": "v0.2.0",
-        "language": "en"
-    },
-    {
-        "name": "v0.1.1",
-        "version": "v0.1.1",
-        "language": "en"
-    },
-    {
-        "name": "v0.1.0",
-        "version": "v0.1.0",
-        "language": "en"
     }
 ]

From 93b0aa09526a9802bf06594cd7e70dd932734fed Mon Sep 17 00:00:00 2001
From: Daniel McCloy <dan@mccloy.info>
Date: Tue, 10 Aug 2021 16:41:16 -0500
Subject: [PATCH 03/27] fallback on version if name missing

---
 pydata_sphinx_theme/_templates/switcher.html | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/pydata_sphinx_theme/_templates/switcher.html b/pydata_sphinx_theme/_templates/switcher.html
index 0d78decd3..6df6289e5 100644
--- a/pydata_sphinx_theme/_templates/switcher.html
+++ b/pydata_sphinx_theme/_templates/switcher.html
@@ -31,6 +31,9 @@
         // correct (for now, links will go to doc version homepage)
         $.each(data, function(index, entry) {
             entry.url = buildURL("{{ switcher_template_url }}", entry);
+            if (!("name" in entry)) {
+                entry.name = entry.version;
+            }
             $("#switcher").append(`<a class="list-group-item list-group-item-action py-1" href="${entry.url}">${entry.name}</a>`);
         });
         // see if the current page exists in the other versions of the docs

From e913a4855078f74bacc2f37ea54043b7c58bb0ed Mon Sep 17 00:00:00 2001
From: Daniel McCloy <dan@mccloy.info>
Date: Tue, 10 Aug 2021 17:03:00 -0500
Subject: [PATCH 04/27] simplify redundancies in switcher.json

---
 docs/_static/switcher.json | 15 +--------------
 1 file changed, 1 insertion(+), 14 deletions(-)

diff --git a/docs/_static/switcher.json b/docs/_static/switcher.json
index 0c967b9c8..d696bd660 100644
--- a/docs/_static/switcher.json
+++ b/docs/_static/switcher.json
@@ -1,71 +1,58 @@
 [
     {
         "name": "v0.6.3 (latest)",
-        "version": "latest",
+        "version": "v0.6.3",
         "language": "en"
     },
     {
-        "name": "v0.6.2",
         "version": "v0.6.2",
         "language": "en"
     },
     {
-        "name": "v0.6.1",
         "version": "v0.6.1",
         "language": "en"
     },
     {
-        "name": "v0.6.0",
         "version": "v0.6.0",
         "language": "en"
     },
     {
-        "name": "v0.5.2",
         "version": "v0.5.2",
         "language": "en"
     },
     {
-        "name": "v0.5.1",
         "version": "v0.5.1",
         "language": "en"
     },
     {
-        "name": "v0.5.0",
         "version": "v0.5.0",
         "language": "en"
     },
     {
-        "name": "v0.4.3",
         "version": "v0.4.3",
         "language": "en"
     },
     {
-        "name": "v0.4.2",
         "version": "v0.4.2",
         "language": "en"
     },
     {
-        "name": "v0.4.1",
         "version": "v0.4.1",
         "language": "en"
     },
     {
-        "name": "v0.4.0",
         "version": "v0.4.0",
         "language": "en"
     },
     {
-        "name": "v0.3.2",
         "version": "v0.3.2",
         "language": "en"
     },
     {
-        "name": "v0.3.1",
         "version": "v0.3.1",
         "language": "en"
     },
     {
-        "name": "v0.3.0",
         "version": "v0.3.0",
         "language": "en"
     }

From cefafeb1ae739b7b4e2f626672df23b6339f9843 Mon Sep 17 00:00:00 2001
From: Daniel McCloy <dan@mccloy.info>
Date: Fri, 3 Sep 2021 18:33:51 -0500
Subject: [PATCH 05/27] separate out version switcher

---
 docs/_static/switcher.json                    | 57 +++++++++---
 docs/conf.py                                  |  2 +-
 pydata_sphinx_theme/_templates/switcher.html  | 53 -----------
 .../_templates/version-switcher.html          | 90 +++++++++++++++++++
 4 files changed, 134 insertions(+), 68 deletions(-)
 delete mode 100644 pydata_sphinx_theme/_templates/switcher.html
 create mode 100644 pydata_sphinx_theme/_templates/version-switcher.html

diff --git a/docs/_static/switcher.json b/docs/_static/switcher.json
index d696bd660..a37d7b9ea 100644
--- a/docs/_static/switcher.json
+++ b/docs/_static/switcher.json
@@ -2,58 +2,87 @@
     {
         "name": "v0.6.3 (latest)",
         "version": "v0.6.3",
-        "language": "en"
+        "languages": {
+            "en": "English",
+            "zh": "中文"
+        }
     },
     {
         "version": "v0.6.2",
-        "language": "en"
+        "languages": {
+            "en": "English"
+        }
     },
     {
         "version": "v0.6.1",
-        "language": "en"
+        "languages": {
+            "en": "English"
+        }
     },
     {
         "version": "v0.6.0",
-        "language": "en"
+        "languages": {
+            "en": "English"
+        }
     },
     {
         "version": "v0.5.2",
-        "language": "en"
+        "languages": {
+            "en": "English"
+        }
     },
     {
         "version": "v0.5.1",
-        "language": "en"
+        "languages": {
+            "en": "English"
+        }
     },
     {
         "version": "v0.5.0",
-        "language": "en"
+        "languages": {
+            "en": "English"
+        }
     },
     {
         "version": "v0.4.3",
-        "language": "en"
+        "languages": {
+            "en": "English"
+        }
     },
     {
         "version": "v0.4.2",
-        "language": "en"
+        "languages": {
+            "en": "English"
+        }
     },
     {
         "version": "v0.4.1",
-        "language": "en"
+        "languages": {
+            "en": "English"
+        }
     },
     {
         "version": "v0.4.0",
-        "language": "en"
+        "languages": {
+            "en": "English"
+        }
     },
     {
         "version": "v0.3.2",
-        "language": "en"
+        "languages": {
+            "en": "English"
+        }
     },
     {
         "version": "v0.3.1",
-        "language": "en"
+        "languages": {
+            "en": "English"
+        }
     },
     {
         "version": "v0.3.0",
-        "language": "en"
+        "languages": {
+            "en": "English"
+        }
     }
 ]
diff --git a/docs/conf.py b/docs/conf.py
index df66fab44..32555f683 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -97,7 +97,7 @@
     # "navbar_align": "left",  # [left, content, right] For testing that the navbar items align properly
     # "navbar_start": ["navbar-logo", "navbar-version"],
     # "navbar_center": ["navbar-nav", "navbar-version"],  # Just for testing
-    "navbar_end": ["switcher", "navbar-icon-links"],
+    "navbar_end": ["version-switcher", "navbar-icon-links"],
     # "footer_items": ["copyright", "sphinx-version", ""]
 }
 
diff --git a/pydata_sphinx_theme/_templates/switcher.html b/pydata_sphinx_theme/_templates/switcher.html
deleted file mode 100644
index 6df6289e5..000000000
--- a/pydata_sphinx_theme/_templates/switcher.html
+++ /dev/null
@@ -1,53 +0,0 @@
-<div class="dropdown">
-    <button type="button" class="btn btn-primary btn-sm navbar-btn dropdown-toggle" id="switcher_button" data-toggle="dropdown">
-        {{ switcher_prefix }}{{ release }}
-        <span class="caret"></span>
-    </button>
-    <div id="switcher" class="dropdown-menu list-group-flush py-0" aria-labelledby="switcher_button">
-    <!-- dropdown will be populated by javascript on page load -->
-    </div>
-</div>
-
-<script type="text/javascript">
-// Function to construct the target URL from the JSON components
-function buildURL(template, entry) {
-    //
-    var parts = template.split(/[\{\}]/);
-    version_ix = parts.indexOf("version");
-    language_ix = parts.indexOf("language");
-    if (version_ix >= 0) {
-        parts[version_ix] = entry.version;
-    }
-    if (language_ix >= 0) {
-        parts[language_ix] = entry.language;
-    }
-    return parts.join("");
-}
-// Function to populate the (release, language) version switcher
-(function () {
-    // get JSON config
-    $.getJSON("{{ switcher_json_url }}", function(data, textStatus, jqXHR) {
-        // create the nodes first (before AJAX calls) to ensure the order is
-        // correct (for now, links will go to doc version homepage)
-        $.each(data, function(index, entry) {
-            entry.url = buildURL("{{ switcher_template_url }}", entry);
-            if (!("name" in entry)) {
-                entry.name = entry.version;
-            }
-            $("#switcher").append(`<a class="list-group-item list-group-item-action py-1" href="${entry.url}">${entry.name}</a>`);
-        });
-        // see if the current page exists in the other versions of the docs
-        $.each(data, function(index, entry) {
-            let filePath = "{{ pagename }}.html";
-            $.ajax({
-                type: 'HEAD',
-                url: `${entry.url}${filePath}`,
-                // update the target URL if it exists
-                success: function() {
-                    $("#switcher").children()[index].setAttribute("href", `${entry.url}${filePath}`);
-                }
-            });
-        });
-    });
-})();
-</script>
diff --git a/pydata_sphinx_theme/_templates/version-switcher.html b/pydata_sphinx_theme/_templates/version-switcher.html
new file mode 100644
index 000000000..9c638cd77
--- /dev/null
+++ b/pydata_sphinx_theme/_templates/version-switcher.html
@@ -0,0 +1,90 @@
+<div class="dropdown">
+    <button type="button" class="btn btn-primary btn-sm navbar-btn dropdown-toggle" id="version_switcher_button" data-toggle="dropdown">
+        {{ release }}
+        <span class="caret"></span>
+    </button>
+    <div id="version_switcher" class="dropdown-menu list-group-flush py-0" aria-labelledby="version_switcher_button">
+    <!-- dropdown will be populated by javascript on page load -->
+    </div>
+</div>
+
+<script type="text/javascript">
+// Function to discover the current language from the window URL
+function getLanguage() {
+    var language,
+        url = window.location;
+    const template = "{{ switcher_template_url }}",  // filled in by jinja
+          template_parts = template.split(/[\{\}]/),
+          version_ix = template_parts.indexOf("version"),
+          language_ix = template_parts.indexOf("language");
+    // find corresponding location in current page's URL
+    for (let ix = 0; ix < template_parts.length; ix++) {
+        // remove non-template URL parts
+        if (ix !== language_ix && ix !== version_ix) {
+            url = url.replace(template_parts[ix], "");
+        }
+        // remove the version too, if we encounter it before we find language
+        else if (ix == version_ix) {
+            version = url.substr(0, url.indexOf(template_parts[ix + 1]));
+            url = url.replace(version, "");
+        } else {
+            // we've found the language, extract it and return
+            language = url.substr(0, url.indexOf(template_parts[ix + 1]));
+            break;
+        }
+    }
+    return language;
+}
+
+// Function to construct the target URL from the JSON components
+function buildURL(entry) {
+    var template = "{{ switcher_template_url }}";  // supplied by jinja
+    template = template.replace("{version}", entry.version);
+    template = template.replace("{language}", entry.language);
+    return template;
+}
+
+// Function to populate the version switcher
+(function () {
+    const language = getLanguage();
+    // get JSON config
+    $.getJSON("{{ switcher_json_url }}", function(data, textStatus, jqXHR) {
+        // create the nodes first (before AJAX calls) to ensure the order is
+        // correct (for now, links will go to doc version homepage)
+        $.each(data, function(index, entry) {
+            // only include entries that match the current language
+            if (language.length && "languages" in entry) {
+                if (language in entry.languages) {
+                    entry.language = language;
+                } else {  // this version unavailable in current language
+                    continue;
+                }
+            }
+
+            // if no custom name specified (e.g., "latest"), use version string
+            if (!("name" in entry)) {
+                entry.name = entry.version;
+            }
+
+            // construct the appropriate URL, and add it to the dropdown
+            entry.url = buildURL(entry);
+            $("#version_switcher").append(`<a class="list-group-item list-group-item-action py-1" href="${entry.url}">${entry.name}</a>`);
+        });
+
+        // see if the current page exists in the other versions of the docs
+        const filePath = "{{ pagename }}.html",
+              version_items = $("#version_switcher").children();
+        $.each(version_items, function(index, node) {
+            let newUrl = `${node.href}${filePath}`;
+            $.ajax({
+                type: 'HEAD',
+                url: newUrl,
+                // update the target URL if it exists
+                success: function() {
+                    node.setAttribute("href", newUrl);
+                }
+            });
+        });
+    });
+})();
+</script>

From 0f1275796dbe3236f1b53e3bda003ba87649101a Mon Sep 17 00:00:00 2001
From: Daniel McCloy <dan@mccloy.info>
Date: Mon, 25 Oct 2021 11:48:15 -0500
Subject: [PATCH 06/27] remove language-related stuff

---
 docs/_static/switcher.json                    | 71 ++++---------------
 docs/conf.py                                  |  2 +-
 .../_templates/version-switcher.html          | 40 -----------
 3 files changed, 15 insertions(+), 98 deletions(-)

diff --git a/docs/_static/switcher.json b/docs/_static/switcher.json
index a37d7b9ea..c1d780e74 100644
--- a/docs/_static/switcher.json
+++ b/docs/_static/switcher.json
@@ -1,88 +1,45 @@
 [
     {
         "name": "v0.6.3 (latest)",
-        "version": "v0.6.3",
-        "languages": {
-            "en": "English",
-            "zh": "中文"
-        }
+        "version": "v0.6.3"
     },
     {
-        "version": "v0.6.2",
-        "languages": {
-            "en": "English"
-        }
+        "version": "v0.6.2"
     },
     {
-        "version": "v0.6.1",
-        "languages": {
-            "en": "English"
-        }
+        "version": "v0.6.1"
     },
     {
-        "version": "v0.6.0",
-        "languages": {
-            "en": "English"
-        }
+        "version": "v0.6.0"
     },
     {
-        "version": "v0.5.2",
-        "languages": {
-            "en": "English"
-        }
+        "version": "v0.5.2"
     },
     {
-        "version": "v0.5.1",
-        "languages": {
-            "en": "English"
-        }
+        "version": "v0.5.1"
     },
     {
-        "version": "v0.5.0",
-        "languages": {
-            "en": "English"
-        }
+        "version": "v0.5.0"
     },
     {
-        "version": "v0.4.3",
-        "languages": {
-            "en": "English"
-        }
+        "version": "v0.4.3"
     },
     {
-        "version": "v0.4.2",
-        "languages": {
-            "en": "English"
-        }
+        "version": "v0.4.2"
     },
     {
-        "version": "v0.4.1",
-        "languages": {
-            "en": "English"
-        }
+        "version": "v0.4.1"
     },
     {
-        "version": "v0.4.0",
-        "languages": {
-            "en": "English"
-        }
+        "version": "v0.4.0"
     },
     {
-        "version": "v0.3.2",
-        "languages": {
-            "en": "English"
-        }
+        "version": "v0.3.2"
     },
     {
-        "version": "v0.3.1",
-        "languages": {
-            "en": "English"
-        }
+        "version": "v0.3.1"
     },
     {
-        "version": "v0.3.0",
-        "languages": {
-            "en": "English"
-        }
+        "version": "v0.3.0"
     }
 ]
diff --git a/docs/conf.py b/docs/conf.py
index 32555f683..daaa42c41 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -108,7 +108,7 @@
     "github_version": "master",
     "doc_path": "docs",
     "switcher_json_url": "/_static/switcher.json",
-    "switcher_template_url": "https://pydata-sphinx-theme.readthedocs.io/{language}/{version}/",
+    "switcher_template_url": "https://pydata-sphinx-theme.readthedocs.io/en/{version}/",
 }
 
 # Add any paths that contain custom static files (such as style sheets) here,
diff --git a/pydata_sphinx_theme/_templates/version-switcher.html b/pydata_sphinx_theme/_templates/version-switcher.html
index 9c638cd77..fcb305c52 100644
--- a/pydata_sphinx_theme/_templates/version-switcher.html
+++ b/pydata_sphinx_theme/_templates/version-switcher.html
@@ -9,68 +9,28 @@
 </div>
 
 <script type="text/javascript">
-// Function to discover the current language from the window URL
-function getLanguage() {
-    var language,
-        url = window.location;
-    const template = "{{ switcher_template_url }}",  // filled in by jinja
-          template_parts = template.split(/[\{\}]/),
-          version_ix = template_parts.indexOf("version"),
-          language_ix = template_parts.indexOf("language");
-    // find corresponding location in current page's URL
-    for (let ix = 0; ix < template_parts.length; ix++) {
-        // remove non-template URL parts
-        if (ix !== language_ix && ix !== version_ix) {
-            url = url.replace(template_parts[ix], "");
-        }
-        // remove the version too, if we encounter it before we find language
-        else if (ix == version_ix) {
-            version = url.substr(0, url.indexOf(template_parts[ix + 1]));
-            url = url.replace(version, "");
-        } else {
-            // we've found the language, extract it and return
-            language = url.substr(0, url.indexOf(template_parts[ix + 1]));
-            break;
-        }
-    }
-    return language;
-}
-
 // Function to construct the target URL from the JSON components
 function buildURL(entry) {
     var template = "{{ switcher_template_url }}";  // supplied by jinja
     template = template.replace("{version}", entry.version);
-    template = template.replace("{language}", entry.language);
     return template;
 }
 
 // Function to populate the version switcher
 (function () {
-    const language = getLanguage();
     // get JSON config
     $.getJSON("{{ switcher_json_url }}", function(data, textStatus, jqXHR) {
         // create the nodes first (before AJAX calls) to ensure the order is
         // correct (for now, links will go to doc version homepage)
         $.each(data, function(index, entry) {
-            // only include entries that match the current language
-            if (language.length && "languages" in entry) {
-                if (language in entry.languages) {
-                    entry.language = language;
-                } else {  // this version unavailable in current language
-                    continue;
-                }
-            }
-
             // if no custom name specified (e.g., "latest"), use version string
             if (!("name" in entry)) {
                 entry.name = entry.version;
             }
-
             // construct the appropriate URL, and add it to the dropdown
             entry.url = buildURL(entry);
             $("#version_switcher").append(`<a class="list-group-item list-group-item-action py-1" href="${entry.url}">${entry.name}</a>`);
         });
-
         // see if the current page exists in the other versions of the docs
         const filePath = "{{ pagename }}.html",
               version_items = $("#version_switcher").children();

From 0ff914ee015f48aed3b93bf2a6cea205993d3a01 Mon Sep 17 00:00:00 2001
From: Daniel McCloy <dan@mccloy.info>
Date: Mon, 25 Oct 2021 11:49:10 -0500
Subject: [PATCH 07/27] add recent versions to JSON

---
 docs/_static/switcher.json | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/docs/_static/switcher.json b/docs/_static/switcher.json
index c1d780e74..b4526820d 100644
--- a/docs/_static/switcher.json
+++ b/docs/_static/switcher.json
@@ -1,6 +1,12 @@
 [
     {
-        "name": "v0.6.3 (latest)",
+        "name": "latest",
+        "version": "v0.7.1"
+    },
+    {
+        "version": "v0.7.0"
+    },
+    {
         "version": "v0.6.3"
     },
     {

From 852cc4e0c0c836ebced66eaf3ee7201fd762094e Mon Sep 17 00:00:00 2001
From: Daniel McCloy <dan@mccloy.info>
Date: Mon, 25 Oct 2021 12:16:49 -0500
Subject: [PATCH 08/27] do AJAX onclick, not in advance

---
 .../_templates/version-switcher.html          | 39 ++++++++++++-------
 1 file changed, 24 insertions(+), 15 deletions(-)

diff --git a/pydata_sphinx_theme/_templates/version-switcher.html b/pydata_sphinx_theme/_templates/version-switcher.html
index fcb305c52..f69af31a0 100644
--- a/pydata_sphinx_theme/_templates/version-switcher.html
+++ b/pydata_sphinx_theme/_templates/version-switcher.html
@@ -16,6 +16,24 @@
     return template;
 }
 
+// Function to check if corresponding page path exists in other version of docs
+// and, if so, go there instead of the homepage of the other docs version
+function checkPageExistsAndRedirect(event) {
+    const currentFilePath = "{{ pagename }}.html",
+          otherDocsHomepage = event.target.getAttribute("data-href");
+    let tryUrl = `${otherDocsHomepage}${currentFilePath}`;
+    $.ajax({
+        type: 'HEAD',
+        url: tryUrl,
+        // if the page exists, go there
+        success: function() {
+            location.href = tryUrl;
+        }
+    }).fail(function() {
+        location.href = otherDocsHomepage;
+    });
+}
+
 // Function to populate the version switcher
 (function () {
     // get JSON config
@@ -29,21 +47,12 @@
             }
             // construct the appropriate URL, and add it to the dropdown
             entry.url = buildURL(entry);
-            $("#version_switcher").append(`<a class="list-group-item list-group-item-action py-1" href="${entry.url}">${entry.name}</a>`);
-        });
-        // see if the current page exists in the other versions of the docs
-        const filePath = "{{ pagename }}.html",
-              version_items = $("#version_switcher").children();
-        $.each(version_items, function(index, node) {
-            let newUrl = `${node.href}${filePath}`;
-            $.ajax({
-                type: 'HEAD',
-                url: newUrl,
-                // update the target URL if it exists
-                success: function() {
-                    node.setAttribute("href", newUrl);
-                }
-            });
+            const node = document.createElement("a");
+            node.setAttribute("class", "list-group-item list-group-item-action py-1");
+            node.setAttribute("data-href", `${entry.url}`);
+            node.textContent = `${entry.name}`;
+            node.onclick = checkPageExistsAndRedirect;
+            $("#version_switcher").append(node);
         });
     });
 })();

From ac2a57b5807006f4c1ca77c509bf2f8a380f2d88 Mon Sep 17 00:00:00 2001
From: Daniel McCloy <dan@mccloy.info>
Date: Tue, 26 Oct 2021 11:48:50 -0500
Subject: [PATCH 09/27] use href instead of data-href

---
 pydata_sphinx_theme/_templates/version-switcher.html | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/pydata_sphinx_theme/_templates/version-switcher.html b/pydata_sphinx_theme/_templates/version-switcher.html
index f69af31a0..75b57d785 100644
--- a/pydata_sphinx_theme/_templates/version-switcher.html
+++ b/pydata_sphinx_theme/_templates/version-switcher.html
@@ -20,7 +20,7 @@
 // and, if so, go there instead of the homepage of the other docs version
 function checkPageExistsAndRedirect(event) {
     const currentFilePath = "{{ pagename }}.html",
-          otherDocsHomepage = event.target.getAttribute("data-href");
+          otherDocsHomepage = event.target.getAttribute("href");
     let tryUrl = `${otherDocsHomepage}${currentFilePath}`;
     $.ajax({
         type: 'HEAD',
@@ -32,6 +32,7 @@
     }).fail(function() {
         location.href = otherDocsHomepage;
     });
+    return false;
 }
 
 // Function to populate the version switcher
@@ -49,7 +50,7 @@
             entry.url = buildURL(entry);
             const node = document.createElement("a");
             node.setAttribute("class", "list-group-item list-group-item-action py-1");
-            node.setAttribute("data-href", `${entry.url}`);
+            node.setAttribute("href", `${entry.url}`);
             node.textContent = `${entry.name}`;
             node.onclick = checkPageExistsAndRedirect;
             $("#version_switcher").append(node);

From 26e59883043879ac49575667aa82fe81ebd7f010 Mon Sep 17 00:00:00 2001
From: Daniel McCloy <dan@mccloy.info>
Date: Wed, 27 Oct 2021 10:16:00 -0500
Subject: [PATCH 10/27] better comments

---
 pydata_sphinx_theme/_templates/version-switcher.html | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/pydata_sphinx_theme/_templates/version-switcher.html b/pydata_sphinx_theme/_templates/version-switcher.html
index 75b57d785..04a683954 100644
--- a/pydata_sphinx_theme/_templates/version-switcher.html
+++ b/pydata_sphinx_theme/_templates/version-switcher.html
@@ -32,12 +32,13 @@
     }).fail(function() {
         location.href = otherDocsHomepage;
     });
+    // this prevents the browser from following the href of the clicked node
+    // (which is fine because this function takes care of redirecting)
     return false;
 }
 
-// Function to populate the version switcher
+// Function to populate the version switcher from the JSON config file
 (function () {
-    // get JSON config
     $.getJSON("{{ switcher_json_url }}", function(data, textStatus, jqXHR) {
         // create the nodes first (before AJAX calls) to ensure the order is
         // correct (for now, links will go to doc version homepage)
@@ -52,6 +53,10 @@
             node.setAttribute("class", "list-group-item list-group-item-action py-1");
             node.setAttribute("href", `${entry.url}`);
             node.textContent = `${entry.name}`;
+            // on click, AJAX calls will check if the page corresponding to the
+            // current page exists in the requested other docs version, and if
+            // so, will redirect to that page rather than the "homepage" for
+            // that version of the docs.
             node.onclick = checkPageExistsAndRedirect;
             $("#version_switcher").append(node);
         });

From 0328868d0ef69ed7c51e8f0369ac0b1c054b8243 Mon Sep 17 00:00:00 2001
From: Daniel McCloy <dan@mccloy.info>
Date: Wed, 27 Oct 2021 10:42:00 -0500
Subject: [PATCH 11/27] update the dropdown button text

---
 docs/_static/switcher.json                    | 34 +++++++++----------
 .../_templates/version-switcher.html          |  7 +++-
 2 files changed, 23 insertions(+), 18 deletions(-)

diff --git a/docs/_static/switcher.json b/docs/_static/switcher.json
index b4526820d..fb5011c21 100644
--- a/docs/_static/switcher.json
+++ b/docs/_static/switcher.json
@@ -1,51 +1,51 @@
 [
     {
-        "name": "latest",
-        "version": "v0.7.1"
+        "name": "v0.7.1 (latest)",
+        "version": "0.7.1"
     },
     {
-        "version": "v0.7.0"
+        "version": "0.7.0"
     },
     {
-        "version": "v0.6.3"
+        "version": "0.6.3"
     },
     {
-        "version": "v0.6.2"
+        "version": "0.6.2"
     },
     {
-        "version": "v0.6.1"
+        "version": "0.6.1"
     },
     {
-        "version": "v0.6.0"
+        "version": "0.6.0"
     },
     {
-        "version": "v0.5.2"
+        "version": "0.5.2"
     },
     {
-        "version": "v0.5.1"
+        "version": "0.5.1"
     },
     {
-        "version": "v0.5.0"
+        "version": "0.5.0"
     },
     {
-        "version": "v0.4.3"
+        "version": "0.4.3"
     },
     {
-        "version": "v0.4.2"
+        "version": "0.4.2"
     },
     {
-        "version": "v0.4.1"
+        "version": "0.4.1"
     },
     {
-        "version": "v0.4.0"
+        "version": "0.4.0"
     },
     {
-        "version": "v0.3.2"
+        "version": "0.3.2"
     },
     {
-        "version": "v0.3.1"
+        "version": "0.3.1"
     },
     {
-        "version": "v0.3.0"
+        "version": "0.3.0"
     }
 ]
diff --git a/pydata_sphinx_theme/_templates/version-switcher.html b/pydata_sphinx_theme/_templates/version-switcher.html
index 04a683954..d994d3761 100644
--- a/pydata_sphinx_theme/_templates/version-switcher.html
+++ b/pydata_sphinx_theme/_templates/version-switcher.html
@@ -1,6 +1,6 @@
 <div class="dropdown">
     <button type="button" class="btn btn-primary btn-sm navbar-btn dropdown-toggle" id="version_switcher_button" data-toggle="dropdown">
-        {{ release }}
+        {{ release }}  <!-- this text may get changed later by javascript -->
         <span class="caret"></span>
     </button>
     <div id="version_switcher" class="dropdown-menu list-group-flush py-0" aria-labelledby="version_switcher_button">
@@ -59,6 +59,11 @@
             // that version of the docs.
             node.onclick = checkPageExistsAndRedirect;
             $("#version_switcher").append(node);
+            // replace the dropdown button text with the preferred display name
+            // of this version, rather than using the {{ release }} variable
+            if (entry.version == "{{ release }}") {
+                $("#version_switcher_button").text(entry.name);
+            }
         });
     });
 })();

From 2a38901c6d8ddad693e5dbd8655641af17eb5b15 Mon Sep 17 00:00:00 2001
From: Daniel McCloy <dan@mccloy.info>
Date: Wed, 27 Oct 2021 11:04:20 -0500
Subject: [PATCH 12/27] fix url shown on hover

---
 .../_templates/version-switcher.html          | 23 ++++++++++---------
 1 file changed, 12 insertions(+), 11 deletions(-)

diff --git a/pydata_sphinx_theme/_templates/version-switcher.html b/pydata_sphinx_theme/_templates/version-switcher.html
index d994d3761..f61189dd8 100644
--- a/pydata_sphinx_theme/_templates/version-switcher.html
+++ b/pydata_sphinx_theme/_templates/version-switcher.html
@@ -20,8 +20,8 @@
 // and, if so, go there instead of the homepage of the other docs version
 function checkPageExistsAndRedirect(event) {
     const currentFilePath = "{{ pagename }}.html",
-          otherDocsHomepage = event.target.getAttribute("href");
-    let tryUrl = `${otherDocsHomepage}${currentFilePath}`;
+          tryUrl = event.target.getAttribute("href");
+    let otherDocsHomepage = tryUrl.replace(currentFilePath, "");
     $.ajax({
         type: 'HEAD',
         url: tryUrl,
@@ -40,23 +40,24 @@
 // Function to populate the version switcher from the JSON config file
 (function () {
     $.getJSON("{{ switcher_json_url }}", function(data, textStatus, jqXHR) {
-        // create the nodes first (before AJAX calls) to ensure the order is
-        // correct (for now, links will go to doc version homepage)
+        const currentFilePath = "{{ pagename }}.html";
+        // create links to the corresponding page in the other docs versions
         $.each(data, function(index, entry) {
             // if no custom name specified (e.g., "latest"), use version string
             if (!("name" in entry)) {
                 entry.name = entry.version;
             }
-            // construct the appropriate URL, and add it to the dropdown
-            entry.url = buildURL(entry);
+            // create the node
             const node = document.createElement("a");
             node.setAttribute("class", "list-group-item list-group-item-action py-1");
-            node.setAttribute("href", `${entry.url}`);
             node.textContent = `${entry.name}`;
-            // on click, AJAX calls will check if the page corresponding to the
-            // current page exists in the requested other docs version, and if
-            // so, will redirect to that page rather than the "homepage" for
-            // that version of the docs.
+            // get the base URL for that doc version, add the current page's
+            // path to it, and set as `href`
+            entry.url = buildURL(entry);
+            node.setAttribute("href", `${entry.url}${currentFilePath}`);
+            // on click, AJAX calls will check if the linked page exists before
+            // trying to redirect, and if not, will redirect to the homepage
+            // for that version of the docs.
             node.onclick = checkPageExistsAndRedirect;
             $("#version_switcher").append(node);
             // replace the dropdown button text with the preferred display name

From 768a76e32cc35e2e80c7a3f4b56498464f5a9304 Mon Sep 17 00:00:00 2001
From: Daniel McCloy <dan@mccloy.info>
Date: Wed, 27 Oct 2021 11:05:08 -0500
Subject: [PATCH 13/27] fix template URL

---
 docs/conf.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/conf.py b/docs/conf.py
index daaa42c41..89938915e 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -108,7 +108,7 @@
     "github_version": "master",
     "doc_path": "docs",
     "switcher_json_url": "/_static/switcher.json",
-    "switcher_template_url": "https://pydata-sphinx-theme.readthedocs.io/en/{version}/",
+    "switcher_template_url": "https://pydata-sphinx-theme.readthedocs.io/en/v{version}/",
 }
 
 # Add any paths that contain custom static files (such as style sheets) here,

From 5318996d98c1ca175f9f466b282f7ec232053d9d Mon Sep 17 00:00:00 2001
From: Daniel McCloy <dan@mccloy.info>
Date: Wed, 27 Oct 2021 11:13:41 -0500
Subject: [PATCH 14/27] =?UTF-8?q?change=20display=20name=20"latest"=20?=
 =?UTF-8?q?=E2=86=92=20"stable"?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Joris Van den Bossche <jorisvandenbossche@gmail.com>
---
 docs/_static/switcher.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/_static/switcher.json b/docs/_static/switcher.json
index fb5011c21..e23807a55 100644
--- a/docs/_static/switcher.json
+++ b/docs/_static/switcher.json
@@ -1,6 +1,6 @@
 [
     {
-        "name": "v0.7.1 (latest)",
+        "name": "v0.7.1 (stable)",
         "version": "0.7.1"
     },
     {

From ab261a3d60424bd467e03755717297b577a3a9e4 Mon Sep 17 00:00:00 2001
From: Daniel McCloy <dan@mccloy.info>
Date: Thu, 28 Oct 2021 09:23:06 -0500
Subject: [PATCH 15/27] add ID to div

---
 pydata_sphinx_theme/_templates/version-switcher.html | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/pydata_sphinx_theme/_templates/version-switcher.html b/pydata_sphinx_theme/_templates/version-switcher.html
index f61189dd8..e66fcc89d 100644
--- a/pydata_sphinx_theme/_templates/version-switcher.html
+++ b/pydata_sphinx_theme/_templates/version-switcher.html
@@ -1,9 +1,9 @@
-<div class="dropdown">
+<div class="dropdown" id="version_switcher">
     <button type="button" class="btn btn-primary btn-sm navbar-btn dropdown-toggle" id="version_switcher_button" data-toggle="dropdown">
         {{ release }}  <!-- this text may get changed later by javascript -->
         <span class="caret"></span>
     </button>
-    <div id="version_switcher" class="dropdown-menu list-group-flush py-0" aria-labelledby="version_switcher_button">
+    <div id="version_switcher_menu" class="dropdown-menu list-group-flush py-0" aria-labelledby="version_switcher_button">
     <!-- dropdown will be populated by javascript on page load -->
     </div>
 </div>
@@ -59,7 +59,7 @@
             // trying to redirect, and if not, will redirect to the homepage
             // for that version of the docs.
             node.onclick = checkPageExistsAndRedirect;
-            $("#version_switcher").append(node);
+            $("#version_switcher_menu").append(node);
             // replace the dropdown button text with the preferred display name
             // of this version, rather than using the {{ release }} variable
             if (entry.version == "{{ release }}") {

From def2d67f3d9a95d4f09d6c41a7cbc246a52aea69 Mon Sep 17 00:00:00 2001
From: Daniel McCloy <dan@mccloy.info>
Date: Thu, 28 Oct 2021 10:34:10 -0500
Subject: [PATCH 16/27] document the switcher

---
 docs/user_guide/configuring.rst | 75 +++++++++++++++++++++++++++++++++
 docs/user_guide/sections.rst    |  5 ++-
 2 files changed, 78 insertions(+), 2 deletions(-)

diff --git a/docs/user_guide/configuring.rst b/docs/user_guide/configuring.rst
index d720f7a41..5edac0b5a 100644
--- a/docs/user_guide/configuring.rst
+++ b/docs/user_guide/configuring.rst
@@ -277,6 +277,81 @@ at the bottom. You can hide these buttons with the following configuration:
    }
 
 
+Add a dropdown to switch between docs versions
+==============================================
+
+You can add a button to your site's navbar or sidebars that allows users to
+switch between versions of the documentation. The versions shown in the
+dropdown are populated from a JSON file containing a list of mappings, where
+each mapping contains a key ``"version"`` mapped to a string value representing
+the version number. Each mapping may optionally contain a key ``"name"`` mapped
+to a name for that version (e.g., "latest", "stable", "dev", etc). Here is an
+example:
+
+.. code:: json
+
+    [
+        {
+            "name": "v2.1 (stable)",
+            "version": "2.1"
+        },
+        {
+            "version": "2.0"
+        },
+        {
+            "version": "1.1"
+        },
+    ]
+
+The location of this JSON file should be included in ``conf.py`` as the
+``switcher_json_url`` value within the ``html_context`` dictionary.
+Additionally, you must provide a *template URL* that will yield the correct
+address for the doc versions once the version string is inserted into the
+template in place of the ``{version}`` placeholder. For example:
+
+.. code:: python
+
+    html_context = {
+        "switcher_json_url": "https://mysite.org/en/latest/_static/switcher.json",
+        "switcher_template_url": "https://mysite.org/en/v{version}/",
+    }
+
+.. note::
+    The JSON file must be available at page load time. Best practice is to use
+    a stable URL that is not relative to the sphinx root of the current doc
+    build, so that as new versions are added to the JSON file all the older
+    versions of the docs will gain menu entries linking to the new versions.
+
+    The stable URL could be one that is always associated with the most recent
+    documentation build (as above, where it points to a location in version
+    "latest"); in this case the JSON is versioned alongside the rest of the
+    docs but only the most recent version is ever loaded. Alternatively the
+    JSON could be outside the doc build trees (e.g.,
+    ``https://mysite.org/switcher.json``) and you can add new versions to it as
+    part of your release process.
+
+With those settings in place, all that is left is to tell the theme where you
+want the version switcher to appear. For example, you could add the
+dropdown to the navbar by including the following setting in ``conf.py``:
+
+.. code:: python
+
+   html_theme_options = {
+        "navbar_end": ["version-switcher"]
+    }
+
+
+Switcher behavior
+-----------------
+
+The links in the version switcher will differ depending on which page of the
+docs is being viewed. For example, on the page
+``https://mysite.org/en/v2.0/changelog.html``, the switcher links will go to
+``changelog.html`` in the other versions of the docs. However, when clicked it
+will check for the existence of that page, and if it doesn't exist, redirect to
+the homepage of that doc version instead.
+
+
 Add an Edit this Page button
 ============================
 
diff --git a/docs/user_guide/sections.rst b/docs/user_guide/sections.rst
index accc8a8c5..a4a6e8d47 100644
--- a/docs/user_guide/sections.rst
+++ b/docs/user_guide/sections.rst
@@ -11,7 +11,7 @@ You can choose which templates show up in each section, as well as the order in
 which they appear. This page describes the major areas that you can customize.
 
 .. note::
-    
+
    When configuring templates in each section, you may omit the ``.html``
    suffix after each template if you wish.
 
@@ -118,6 +118,7 @@ will be named accordingly).
 - ``sidebar-ethical-ads.html``
 - ``sidebar-nav-bs.html``
 - ``sphinx-version.html``
+- ``version-switcher.html``
 
 Add your own HTML templates to theme sections
 =============================================
@@ -136,7 +137,7 @@ could do so with the following steps:
       {{ version }}
 
 1. Now add the file to your menu items for one of the sections above. For example:
-   
+
    .. code-block:: python
 
       html_theme_options = {

From d968eef16d2410b9987fa28cc7ac297b658f8bb3 Mon Sep 17 00:00:00 2001
From: Daniel McCloy <dan@mccloy.info>
Date: Thu, 28 Oct 2021 16:34:09 -0500
Subject: [PATCH 17/27] change default button text to be sphinx "version"
 variable

---
 docs/conf.py                                  |  1 +
 docs/user_guide/configuring.rst               | 34 +++++++++++++------
 .../_templates/version-switcher.html          |  8 ++---
 pydata_sphinx_theme/theme.conf                |  1 +
 4 files changed, 29 insertions(+), 15 deletions(-)

diff --git a/docs/conf.py b/docs/conf.py
index 89938915e..f104a1e77 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -109,6 +109,7 @@
     "doc_path": "docs",
     "switcher_json_url": "/_static/switcher.json",
     "switcher_template_url": "https://pydata-sphinx-theme.readthedocs.io/en/v{version}/",
+    "switcher_version_match": version,
 }
 
 # Add any paths that contain custom static files (such as style sheets) here,
diff --git a/docs/user_guide/configuring.rst b/docs/user_guide/configuring.rst
index 5edac0b5a..b13bceb85 100644
--- a/docs/user_guide/configuring.rst
+++ b/docs/user_guide/configuring.rst
@@ -307,28 +307,35 @@ The location of this JSON file should be included in ``conf.py`` as the
 ``switcher_json_url`` value within the ``html_context`` dictionary.
 Additionally, you must provide a *template URL* that will yield the correct
 address for the doc versions once the version string is inserted into the
-template in place of the ``{version}`` placeholder. For example:
+template in place of the ``{version}`` placeholder. Finally, specify in
+``switcher_version_match`` a value that the version entries in the JSON file
+will be matched against (typically this will be the sphinx variable ``version``
+or ``release`` depending on how granular your docs versioning is; see
+`the Sphinx documentation <https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information>`__
+for more info). An example configuration would be:
 
 .. code:: python
 
+    version = my_package_name.__version__.replace("dev0", "")  # may differ
     html_context = {
         "switcher_json_url": "https://mysite.org/en/latest/_static/switcher.json",
         "switcher_template_url": "https://mysite.org/en/v{version}/",
+        "switcher_version_match": version,
     }
 
 .. note::
-    The JSON file must be available at page load time. Best practice is to use
-    a stable URL that is not relative to the sphinx root of the current doc
-    build, so that as new versions are added to the JSON file all the older
-    versions of the docs will gain menu entries linking to the new versions.
+    Best practice for the JSON file is to use a stable URL that is not relative
+    to the sphinx root of the current doc build, so that as new versions are
+    added to the JSON file all the older versions of the docs will gain menu
+    entries linking to the new versions.
 
     The stable URL could be one that is always associated with the most recent
-    documentation build (as above, where it points to a location in version
-    "latest"); in this case the JSON is versioned alongside the rest of the
-    docs but only the most recent version is ever loaded. Alternatively the
-    JSON could be outside the doc build trees (e.g.,
-    ``https://mysite.org/switcher.json``) and you can add new versions to it as
-    part of your release process.
+    documentation build (as above, where it points to a location in the build
+    tree of version "latest"); in this case the JSON is versioned alongside the
+    rest of the docs pages but only the most recent version is ever loaded.
+    Alternatively the JSON could be outside the doc build trees (e.g.,
+    ``https://mysite.org/switcher.json``) and you can add new version entries
+    to it as part of your release process.
 
 With those settings in place, all that is left is to tell the theme where you
 want the version switcher to appear. For example, you could add the
@@ -344,6 +351,11 @@ dropdown to the navbar by including the following setting in ``conf.py``:
 Switcher behavior
 -----------------
 
+The switcher button text is initially set to the value of the
+``switcher_version_match`` variable from ``conf.py`` (see above), but will be
+replaced by the ``name`` value of the JSON entry that matches the current
+version (if ``name`` is defined for that version).
+
 The links in the version switcher will differ depending on which page of the
 docs is being viewed. For example, on the page
 ``https://mysite.org/en/v2.0/changelog.html``, the switcher links will go to
diff --git a/pydata_sphinx_theme/_templates/version-switcher.html b/pydata_sphinx_theme/_templates/version-switcher.html
index e66fcc89d..b35d3a14d 100644
--- a/pydata_sphinx_theme/_templates/version-switcher.html
+++ b/pydata_sphinx_theme/_templates/version-switcher.html
@@ -1,6 +1,6 @@
 <div class="dropdown" id="version_switcher">
     <button type="button" class="btn btn-primary btn-sm navbar-btn dropdown-toggle" id="version_switcher_button" data-toggle="dropdown">
-        {{ release }}  <!-- this text may get changed later by javascript -->
+        {{ switcher_version_match }}  <!-- this text may get changed later by javascript -->
         <span class="caret"></span>
     </button>
     <div id="version_switcher_menu" class="dropdown-menu list-group-flush py-0" aria-labelledby="version_switcher_button">
@@ -60,9 +60,9 @@
             // for that version of the docs.
             node.onclick = checkPageExistsAndRedirect;
             $("#version_switcher_menu").append(node);
-            // replace the dropdown button text with the preferred display name
-            // of this version, rather than using the {{ release }} variable
-            if (entry.version == "{{ release }}") {
+            // replace dropdown button text with the preferred display name of
+            // this version, rather than using sphinx's {{ version }} variable
+            if (entry.version == "{{ switcher_version_match }}") {
                 $("#version_switcher_button").text(entry.name);
             }
         });
diff --git a/pydata_sphinx_theme/theme.conf b/pydata_sphinx_theme/theme.conf
index dbffc411c..0ec728638 100644
--- a/pydata_sphinx_theme/theme.conf
+++ b/pydata_sphinx_theme/theme.conf
@@ -34,3 +34,4 @@ footer_items = copyright.html, sphinx-version.html
 page_sidebar_items = page-toc.html, edit-this-page.html
 switcher_json_url =
 switcher_template_url =
+switcher_version_match =

From fec276ce3773cb603dccb690cdac2b2d4492e94e Mon Sep 17 00:00:00 2001
From: Daniel McCloy <dan@mccloy.info>
Date: Sat, 30 Oct 2021 09:12:10 -0500
Subject: [PATCH 18/27] add comment about JS needing jinja

---
 pydata_sphinx_theme/_templates/version-switcher.html | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/pydata_sphinx_theme/_templates/version-switcher.html b/pydata_sphinx_theme/_templates/version-switcher.html
index b35d3a14d..0c36a9f0f 100644
--- a/pydata_sphinx_theme/_templates/version-switcher.html
+++ b/pydata_sphinx_theme/_templates/version-switcher.html
@@ -8,6 +8,11 @@
     </div>
 </div>
 
+<!-- NOTE: this JS must live here (not in our global JS file) because it relies
+     on being processed by Jinja before it is run (specifically for replacing
+     variables {{ pagename }}, {{ switcher_json_url }},
+     {{ switcher_template_url }}, and {{ switcher_version_match }}. -->
+
 <script type="text/javascript">
 // Function to construct the target URL from the JSON components
 function buildURL(entry) {

From 24da28e90f1a76f35929370f29979d9ff57f68a1 Mon Sep 17 00:00:00 2001
From: Daniel McCloy <dan@mccloy.info>
Date: Mon, 1 Nov 2021 10:56:53 -0500
Subject: [PATCH 19/27] doc rewrite

Co-authored-by: Chris Holdgraf <choldgraf@gmail.com>
---
 docs/user_guide/configuring.rst               | 104 +++++++++---------
 .../_templates/version-switcher.html          |   4 +-
 2 files changed, 56 insertions(+), 52 deletions(-)

diff --git a/docs/user_guide/configuring.rst b/docs/user_guide/configuring.rst
index b13bceb85..d469829cb 100644
--- a/docs/user_guide/configuring.rst
+++ b/docs/user_guide/configuring.rst
@@ -281,12 +281,32 @@ Add a dropdown to switch between docs versions
 ==============================================
 
 You can add a button to your site's navbar or sidebars that allows users to
-switch between versions of the documentation. The versions shown in the
-dropdown are populated from a JSON file containing a list of mappings, where
-each mapping contains a key ``"version"`` mapped to a string value representing
-the version number. Each mapping may optionally contain a key ``"name"`` mapped
-to a name for that version (e.g., "latest", "stable", "dev", etc). Here is an
-example:
+switch between versions of the documentation.
+The links in the version switcher will differ depending on which page of the
+docs is being viewed. For example, on the page
+``https://mysite.org/en/v2.0/changelog.html``, the switcher links will go to
+``changelog.html``. When clicked, the switcher will check for the existence of that page, and if it doesn't exist, redirect to the homepage of that doc version instead.
+
+This is accomplished via the following configuration keys:
+
+- A JSON file that is a list the documentation versions that should be available on each page.
+- A ``json_url`` configuration that defines the persistent location of the file above, so that documentation from older docs versions have their switcher options defined by this single source.
+- A ``template_url`` configuration that defines how your documentation versions should be inserted into URLs to create links to other versions of your documentation.
+- A ``version_match`` configuration that tells the switcher the version of the documentation that is currently being browsed.
+
+Below is a more in-depth description of each of these configuration options, and steps to add a switcher to your documentation.
+
+Add a JSON file to define your switcher's versions
+--------------------------------------------------
+
+First, you must define a JSON file that acts as the single source of truth for what versions should be available to switch between. This file contains a list of entries that have two fields:
+
+- ``version``: a version number, as defined by the ``version_match`` key (see below)
+- ``name``: an optional name to display in the dropdown, instead of the version number. (e.g., "latest", "stable", "dev", etc).
+
+**You must include this file with your documentation's build**. For example, by adding it to a folder that is listed under your site's ``html_static_path`` configuration (see `the Sphinx static path documentation <https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-html_static_path>`_ for more information.
+
+Here is an example of what this file should look like:
 
 .. code:: json
 
@@ -303,16 +323,27 @@ example:
         },
     ]
 
-The location of this JSON file should be included in ``conf.py`` as the
-``switcher_json_url`` value within the ``html_context`` dictionary.
-Additionally, you must provide a *template URL* that will yield the correct
-address for the doc versions once the version string is inserted into the
-template in place of the ``{version}`` placeholder. Finally, specify in
-``switcher_version_match`` a value that the version entries in the JSON file
-will be matched against (typically this will be the sphinx variable ``version``
-or ``release`` depending on how granular your docs versioning is; see
-`the Sphinx documentation <https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information>`__
-for more info). An example configuration would be:
+
+Configure Sphinx to use this file to populate the switcher
+----------------------------------------------------------
+
+You must next configure your documentation to use this file, and to properly create URLs for other documentation versions using the variables stored within it.
+
+To do so, you must add the following configuration variables to the ``html_context`` key in your ``conf.py`` file:
+
+- ``switcher_json_url``:  The **persistent** URL of the switcher configuration that serves as the "source of truth". Each version of your documentation should point to the same value, so that they all have the same database of switcher versions to use. This should be a fully-resolved URL, like ``http://mydocumentation.readthedocs.org/en/latest/_static/switcher.json``.
+
+  .. note::
+
+     As a general rule, a good choice is to use a URL that is always associated with the most 
+     recent documentation build (as above, where it points to a location in the build
+     tree of version "latest").  Alternatively the JSON could be hosted in a persistent place 
+     outside of any one documentation build (e.g., ``https://mysite.org/switcher.json``).
+- ``switcher_template_url``: A *template URL* that has a field where the version value should be inserted. This is used to create the URL that the switcher links will point to. For example, if your ``switcher_template_url`` is ``"https://mysite.org/en/version-{version}/"`` then the switcher link for version ``1.1`` will be ``"https://mysite.org/en/version-1.1/"``
+- ``switcher_version_match``: A string that defines the version of the *current* documentation. This is used to tell the switcher which version of the documentation is currently open. It is best if you make this value match the ``version`` or ``release`` value of your package, by automatically loading it as a variable from your package (see the example below, and see
+`the Sphinx documentation <https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information>`__ for more info).
+
+Below is an example configuration that automatically loads the version from a package, and defines a switcher URL template that follows the ``ReadTheDocs`` pattern.
 
 .. code:: python
 
@@ -323,46 +354,19 @@ for more info). An example configuration would be:
         "switcher_version_match": version,
     }
 
-.. note::
-    Best practice for the JSON file is to use a stable URL that is not relative
-    to the sphinx root of the current doc build, so that as new versions are
-    added to the JSON file all the older versions of the docs will gain menu
-    entries linking to the new versions.
-
-    The stable URL could be one that is always associated with the most recent
-    documentation build (as above, where it points to a location in the build
-    tree of version "latest"); in this case the JSON is versioned alongside the
-    rest of the docs pages but only the most recent version is ever loaded.
-    Alternatively the JSON could be outside the doc build trees (e.g.,
-    ``https://mysite.org/switcher.json``) and you can add new version entries
-    to it as part of your release process.
-
-With those settings in place, all that is left is to tell the theme where you
-want the version switcher to appear. For example, you could add the
-dropdown to the navbar by including the following setting in ``conf.py``:
+Add the switcher template to your sidebar or navbar
+---------------------------------------------------
+
+Finally, you can insert the switcher into either the navigation bar or sidebar of your documentation by including its template in one of your navigation locations.
+For example, you could add the dropdown to the navbar by including the following setting in ``conf.py``:
 
 .. code:: python
 
    html_theme_options = {
         "navbar_end": ["version-switcher"]
     }
-
-
-Switcher behavior
------------------
-
-The switcher button text is initially set to the value of the
-``switcher_version_match`` variable from ``conf.py`` (see above), but will be
-replaced by the ``name`` value of the JSON entry that matches the current
-version (if ``name`` is defined for that version).
-
-The links in the version switcher will differ depending on which page of the
-docs is being viewed. For example, on the page
-``https://mysite.org/en/v2.0/changelog.html``, the switcher links will go to
-``changelog.html`` in the other versions of the docs. However, when clicked it
-will check for the existence of that page, and if it doesn't exist, redirect to
-the homepage of that doc version instead.
-
+    
+See :doc:`sections` for more information.
 
 Add an Edit this Page button
 ============================
diff --git a/pydata_sphinx_theme/_templates/version-switcher.html b/pydata_sphinx_theme/_templates/version-switcher.html
index 0c36a9f0f..c6d32ecd9 100644
--- a/pydata_sphinx_theme/_templates/version-switcher.html
+++ b/pydata_sphinx_theme/_templates/version-switcher.html
@@ -21,7 +21,7 @@
     return template;
 }
 
-// Function to check if corresponding page path exists in other version of docs
+// Check if corresponding page path exists in other version of docs
 // and, if so, go there instead of the homepage of the other docs version
 function checkPageExistsAndRedirect(event) {
     const currentFilePath = "{{ pagename }}.html",
@@ -42,7 +42,7 @@
     return false;
 }
 
-// Function to populate the version switcher from the JSON config file
+// Populate the version switcher from the JSON config file
 (function () {
     $.getJSON("{{ switcher_json_url }}", function(data, textStatus, jqXHR) {
         const currentFilePath = "{{ pagename }}.html";

From 407159dc8c0ce199002e88c9380d38cac6b978f8 Mon Sep 17 00:00:00 2001
From: Daniel McCloy <dan@mccloy.info>
Date: Mon, 1 Nov 2021 13:22:35 -0500
Subject: [PATCH 20/27] better variable name, remove vars from theme.conf,
 style current version in dropdown, improve docs

---
 docs/conf.py                                  |   3 +-
 docs/user_guide/configuring.rst               | 177 +++++++++++++-----
 .../_templates/version-switcher.html          |   5 +-
 pydata_sphinx_theme/theme.conf                |   3 -
 4 files changed, 140 insertions(+), 48 deletions(-)

diff --git a/docs/conf.py b/docs/conf.py
index f104a1e77..0ffcb28d9 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -107,8 +107,9 @@
     "github_repo": "pydata-sphinx-theme",
     "github_version": "master",
     "doc_path": "docs",
+    # "switcher_json_url": "https://pydata-sphinx-theme.readthedocs.io/en/latest/_static/switcher.json",
     "switcher_json_url": "/_static/switcher.json",
-    "switcher_template_url": "https://pydata-sphinx-theme.readthedocs.io/en/v{version}/",
+    "switcher_url_template": "https://pydata-sphinx-theme.readthedocs.io/en/v{version}/",
     "switcher_version_match": version,
 }
 
diff --git a/docs/user_guide/configuring.rst b/docs/user_guide/configuring.rst
index d469829cb..44e8ec2cc 100644
--- a/docs/user_guide/configuring.rst
+++ b/docs/user_guide/configuring.rst
@@ -281,32 +281,49 @@ Add a dropdown to switch between docs versions
 ==============================================
 
 You can add a button to your site's navbar or sidebars that allows users to
-switch between versions of the documentation.
-The links in the version switcher will differ depending on which page of the
-docs is being viewed. For example, on the page
-``https://mysite.org/en/v2.0/changelog.html``, the switcher links will go to
-``changelog.html``. When clicked, the switcher will check for the existence of that page, and if it doesn't exist, redirect to the homepage of that doc version instead.
+switch between versions of your documentation. The links in the version
+switcher will differ depending on which page of the docs is being viewed. For
+example, on the page ``https://mysite.org/en/v2.0/changelog.html``, the
+switcher links will go to ``changelog.html`` in the other versions of your
+docs. When clicked, the switcher will check for the existence of that page, and
+if it doesn't exist, redirect to the homepage of that docs version instead.
 
-This is accomplished via the following configuration keys:
+The switcher requires the following configuration steps:
 
-- A JSON file that is a list the documentation versions that should be available on each page.
-- A ``json_url`` configuration that defines the persistent location of the file above, so that documentation from older docs versions have their switcher options defined by this single source.
-- A ``template_url`` configuration that defines how your documentation versions should be inserted into URLs to create links to other versions of your documentation.
-- A ``version_match`` configuration that tells the switcher the version of the documentation that is currently being browsed.
+1. Add a JSON file containing a list of the documentation versions that the
+   switcher should show on each page.
+
+2. Add three configuration keys to the ``html_context`` dict in ``conf.py``:
+
+   - ``switcher_json_url``: the persistent location of the JSON file described
+     above.
+   - ``switcher_url_template``: a template string used to generate the correct
+     URLs for the different documentation versions.
+   - ``switcher_version_match``: a string stating the version of the
+     documentation that is currently being browsed.
+
+3. Specify where to place the switcher in your page layout. For example, add
+   the ``"version-switcher"`` template to one of the layout lists in
+   ``html_theme_options`` (e.g., ``navbar_end``, ``footer_items``, etc).
+
+Below is a more in-depth description of each of these configuration steps.
 
-Below is a more in-depth description of each of these configuration options, and steps to add a switcher to your documentation.
 
 Add a JSON file to define your switcher's versions
 --------------------------------------------------
 
-First, you must define a JSON file that acts as the single source of truth for what versions should be available to switch between. This file contains a list of entries that have two fields:
-
-- ``version``: a version number, as defined by the ``version_match`` key (see below)
-- ``name``: an optional name to display in the dropdown, instead of the version number. (e.g., "latest", "stable", "dev", etc).
+First, write a JSON file stating which versions of your docs will be listed in
+the switcher's dropdown menu. That file should contain a list of entries that
+each have one or two fields:
 
-**You must include this file with your documentation's build**. For example, by adding it to a folder that is listed under your site's ``html_static_path`` configuration (see `the Sphinx static path documentation <https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-html_static_path>`_ for more information.
+- ``version``: a version string. This will be inserted into the
+  ``switcher_url_template`` to create the links to other docs versions, and
+  also checked against ``switcher_version_match`` to provide styling to the
+  switcher.
+- ``name``: an optional name to display in the switcher dropdown instead of the
+  version string (e.g., "latest", "stable", "dev", etc).
 
-Here is an example of what this file should look like:
+Here is an example JSON file:
 
 .. code:: json
 
@@ -319,54 +336,130 @@ Here is an example of what this file should look like:
             "version": "2.0"
         },
         {
-            "version": "1.1"
+            "version": "1.0"
         },
     ]
 
+See the discussion of ``switcher_json_url`` (below) for options of where to
+save the JSON file.
 
-Configure Sphinx to use this file to populate the switcher
-----------------------------------------------------------
 
-You must next configure your documentation to use this file, and to properly create URLs for other documentation versions using the variables stored within it.
+Configure ``switcher_json_url``
+-------------------------------
 
-To do so, you must add the following configuration variables to the ``html_context`` key in your ``conf.py`` file:
+The JSON file needs to be at a stable, persistent, fully-resolved URL (i.e.,
+not specified as a path relative to the sphinx root of the current doc build).
+Each version of your documentation should point to the same URL, so that as new
+versions are added to the JSON file all the older versions of the docs will
+gain switcher dropdown entries linking to the new versions. This could be done
+a few different ways:
+
+- The location could be one that is always associated with the most recent
+  documentation build (i.e., if your docs server aliases "latest" to the most
+  recent version, it could point to a location in the build tree of version
+  "latest"). For example:
+
+  .. code:: python
+
+      html_context = {
+          ...,
+          "switcher_json_url": "https://mysite.org/en/latest/_static/switcher.json",
+      }
 
-- ``switcher_json_url``:  The **persistent** URL of the switcher configuration that serves as the "source of truth". Each version of your documentation should point to the same value, so that they all have the same database of switcher versions to use. This should be a fully-resolved URL, like ``http://mydocumentation.readthedocs.org/en/latest/_static/switcher.json``.
+  In this case the JSON is versioned alongside the rest of the docs pages but
+  only the most recent version is ever loaded (even by older versions of the
+  docs).
 
-  .. note::
+- The JSON could be saved in a folder that is listed under your site's
+  ``html_static_path`` configuration. See `the Sphinx static path documentation
+  <https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-html_static_path>`_
+  for more information.
 
-     As a general rule, a good choice is to use a URL that is always associated with the most 
-     recent documentation build (as above, where it points to a location in the build
-     tree of version "latest").  Alternatively the JSON could be hosted in a persistent place 
-     outside of any one documentation build (e.g., ``https://mysite.org/switcher.json``).
-- ``switcher_template_url``: A *template URL* that has a field where the version value should be inserted. This is used to create the URL that the switcher links will point to. For example, if your ``switcher_template_url`` is ``"https://mysite.org/en/version-{version}/"`` then the switcher link for version ``1.1`` will be ``"https://mysite.org/en/version-1.1/"``
-- ``switcher_version_match``: A string that defines the version of the *current* documentation. This is used to tell the switcher which version of the documentation is currently open. It is best if you make this value match the ``version`` or ``release`` value of your package, by automatically loading it as a variable from your package (see the example below, and see
-`the Sphinx documentation <https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information>`__ for more info).
+- The JSON could be stored outside the doc build trees. This probably means it
+  would be outside the software repo, and would require you to add new version
+  entries to the JSON file manually as part of your release process. Example:
 
-Below is an example configuration that automatically loads the version from a package, and defines a switcher URL template that follows the ``ReadTheDocs`` pattern.
+  .. code:: python
+
+      html_context = {
+          ...,
+          "switcher_json_url": "https://mysite.org/switcher.json",
+      }
+
+
+Configure ``switcher_url_template``
+-----------------------------------
+
+The switcher's links to other versions of your docs are made by combining the
+*version strings* from the JSON file with a *template string* you provide in
+``switcher_url_template``. The template string must contain a placeholder
+``{version}`` and otherwise be a fully-resolved URL. For example:
+
+.. code:: python
+
+    html_context = {
+        ...,
+        "switcher_url_template": "https://mysite.org/en/version-{version}/",
+    }
+
+The example above will result in a link to
+``"https://mysite.org/en/version-1.0/"`` for the JSON entry for version
+``"1.0"``.
+
+
+Configure ``switcher_version_match``
+------------------------------------
+
+This configuration value tells the switcher what docs version is currently
+being viewed, and is used to style the switcher (i.e., to highlight the current
+docs version in the switcher's dropdown menu, and to change the text displayed
+on the switcher button).
+
+Typically you can re-use one of the sphinx variables ``version``
+or ``release`` as the value of ``switcher_version_match``; which one you use
+depends on how granular your docs versioning is. See
+`the Sphinx "project info" documentation
+<https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information>`__
+for more information). Example:
 
 .. code:: python
 
     version = my_package_name.__version__.replace("dev0", "")  # may differ
     html_context = {
-        "switcher_json_url": "https://mysite.org/en/latest/_static/switcher.json",
-        "switcher_template_url": "https://mysite.org/en/v{version}/",
+        ...,
         "switcher_version_match": version,
     }
 
-Add the switcher template to your sidebar or navbar
----------------------------------------------------
 
-Finally, you can insert the switcher into either the navigation bar or sidebar of your documentation by including its template in one of your navigation locations.
-For example, you could add the dropdown to the navbar by including the following setting in ``conf.py``:
+Specify where to display the switcher
+-------------------------------------
+
+Finally, tell the theme where on your site's pages you want the switcher to
+appear. There are many choices here: you can add ``"version-switcher"`` to one
+of the locations in ``html_theme_options`` (e.g., ``navbar_end``,
+``footer_items``, etc). For example:
 
 .. code:: python
 
    html_theme_options = {
-        "navbar_end": ["version-switcher"]
-    }
-    
-See :doc:`sections` for more information.
+      ...,
+      "navbar_end": ["version-switcher"]
+   }
+
+
+Alternatively, you could override one of the other templates to include the
+version switcher in a sidebar. For example, you could define
+``_templates/sidebar-nav-bs.html`` as:
+
+.. code:: jinja
+
+    {%- include 'homepage.html' -%}
+    {{ super() }}
+
+to insert a version switcher at the top of the left sidebar, while still
+keeping the default navigation below it. See :doc:`sections` for more
+information.
+
 
 Add an Edit this Page button
 ============================
diff --git a/pydata_sphinx_theme/_templates/version-switcher.html b/pydata_sphinx_theme/_templates/version-switcher.html
index c6d32ecd9..34d8d9946 100644
--- a/pydata_sphinx_theme/_templates/version-switcher.html
+++ b/pydata_sphinx_theme/_templates/version-switcher.html
@@ -11,12 +11,12 @@
 <!-- NOTE: this JS must live here (not in our global JS file) because it relies
      on being processed by Jinja before it is run (specifically for replacing
      variables {{ pagename }}, {{ switcher_json_url }},
-     {{ switcher_template_url }}, and {{ switcher_version_match }}. -->
+     {{ switcher_url_template }}, and {{ switcher_version_match }}. -->
 
 <script type="text/javascript">
 // Function to construct the target URL from the JSON components
 function buildURL(entry) {
-    var template = "{{ switcher_template_url }}";  // supplied by jinja
+    var template = "{{ switcher_url_template }}";  // supplied by jinja
     template = template.replace("{version}", entry.version);
     return template;
 }
@@ -68,6 +68,7 @@
             // replace dropdown button text with the preferred display name of
             // this version, rather than using sphinx's {{ version }} variable
             if (entry.version == "{{ switcher_version_match }}") {
+                node.classList.add("active");
                 $("#version_switcher_button").text(entry.name);
             }
         });
diff --git a/pydata_sphinx_theme/theme.conf b/pydata_sphinx_theme/theme.conf
index 0ec728638..c7289afc4 100644
--- a/pydata_sphinx_theme/theme.conf
+++ b/pydata_sphinx_theme/theme.conf
@@ -32,6 +32,3 @@ navbar_center = navbar-nav.html
 navbar_end = navbar-icon-links.html
 footer_items = copyright.html, sphinx-version.html
 page_sidebar_items = page-toc.html, edit-this-page.html
-switcher_json_url =
-switcher_template_url =
-switcher_version_match =

From f009b9d03864966dd5ac881a0766ddb15630b8e1 Mon Sep 17 00:00:00 2001
From: Daniel McCloy <dan@mccloy.info>
Date: Mon, 1 Nov 2021 14:26:43 -0500
Subject: [PATCH 21/27] minor cleanups

---
 docs/user_guide/configuring.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/user_guide/configuring.rst b/docs/user_guide/configuring.rst
index 44e8ec2cc..5644f752d 100644
--- a/docs/user_guide/configuring.rst
+++ b/docs/user_guide/configuring.rst
@@ -280,7 +280,7 @@ at the bottom. You can hide these buttons with the following configuration:
 Add a dropdown to switch between docs versions
 ==============================================
 
-You can add a button to your site's navbar or sidebars that allows users to
+You can add a button to your site that allows users to
 switch between versions of your documentation. The links in the version
 switcher will differ depending on which page of the docs is being viewed. For
 example, on the page ``https://mysite.org/en/v2.0/changelog.html``, the
@@ -403,7 +403,7 @@ The switcher's links to other versions of your docs are made by combining the
     }
 
 The example above will result in a link to
-``"https://mysite.org/en/version-1.0/"`` for the JSON entry for version
+``https://mysite.org/en/version-1.0/`` for the JSON entry for version
 ``"1.0"``.
 
 

From 87c0dc97d0d3c8694005c6efd9990aa20683bf8e Mon Sep 17 00:00:00 2001
From: Daniel McCloy <dan@mccloy.info>
Date: Mon, 1 Nov 2021 15:50:24 -0500
Subject: [PATCH 22/27] use html_theme_options instead of html_context

---
 docs/conf.py                                        |  8 ++++----
 docs/user_guide/configuring.rst                     | 11 ++++++-----
 .../_templates/version-switcher.html                | 13 +++++++------
 pydata_sphinx_theme/theme.conf                      |  3 +++
 4 files changed, 20 insertions(+), 15 deletions(-)

diff --git a/docs/conf.py b/docs/conf.py
index 0ffcb28d9..cfc6ec9b0 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -99,6 +99,10 @@
     # "navbar_center": ["navbar-nav", "navbar-version"],  # Just for testing
     "navbar_end": ["version-switcher", "navbar-icon-links"],
     # "footer_items": ["copyright", "sphinx-version", ""]
+    "switcher_json_url": "/_static/switcher.json",
+    # "switcher_json_url": "https://pydata-sphinx-theme.readthedocs.io/en/latest/_static/switcher.json",
+    "switcher_url_template": "https://pydata-sphinx-theme.readthedocs.io/en/v{version}/",
+    "switcher_version_match": version,
 }
 
 
@@ -107,10 +111,6 @@
     "github_repo": "pydata-sphinx-theme",
     "github_version": "master",
     "doc_path": "docs",
-    # "switcher_json_url": "https://pydata-sphinx-theme.readthedocs.io/en/latest/_static/switcher.json",
-    "switcher_json_url": "/_static/switcher.json",
-    "switcher_url_template": "https://pydata-sphinx-theme.readthedocs.io/en/v{version}/",
-    "switcher_version_match": version,
 }
 
 # Add any paths that contain custom static files (such as style sheets) here,
diff --git a/docs/user_guide/configuring.rst b/docs/user_guide/configuring.rst
index 5644f752d..e436dcee8 100644
--- a/docs/user_guide/configuring.rst
+++ b/docs/user_guide/configuring.rst
@@ -293,7 +293,8 @@ The switcher requires the following configuration steps:
 1. Add a JSON file containing a list of the documentation versions that the
    switcher should show on each page.
 
-2. Add three configuration keys to the ``html_context`` dict in ``conf.py``:
+2. Add three configuration keys to the ``html_theme_options`` dict in
+   ``conf.py``:
 
    - ``switcher_json_url``: the persistent location of the JSON file described
      above.
@@ -361,7 +362,7 @@ a few different ways:
 
   .. code:: python
 
-      html_context = {
+      html_theme_options = {
           ...,
           "switcher_json_url": "https://mysite.org/en/latest/_static/switcher.json",
       }
@@ -381,7 +382,7 @@ a few different ways:
 
   .. code:: python
 
-      html_context = {
+      html_theme_options = {
           ...,
           "switcher_json_url": "https://mysite.org/switcher.json",
       }
@@ -397,7 +398,7 @@ The switcher's links to other versions of your docs are made by combining the
 
 .. code:: python
 
-    html_context = {
+    html_theme_options = {
         ...,
         "switcher_url_template": "https://mysite.org/en/version-{version}/",
     }
@@ -425,7 +426,7 @@ for more information). Example:
 .. code:: python
 
     version = my_package_name.__version__.replace("dev0", "")  # may differ
-    html_context = {
+    html_theme_options = {
         ...,
         "switcher_version_match": version,
     }
diff --git a/pydata_sphinx_theme/_templates/version-switcher.html b/pydata_sphinx_theme/_templates/version-switcher.html
index 34d8d9946..3d8240616 100644
--- a/pydata_sphinx_theme/_templates/version-switcher.html
+++ b/pydata_sphinx_theme/_templates/version-switcher.html
@@ -1,6 +1,6 @@
 <div class="dropdown" id="version_switcher">
     <button type="button" class="btn btn-primary btn-sm navbar-btn dropdown-toggle" id="version_switcher_button" data-toggle="dropdown">
-        {{ switcher_version_match }}  <!-- this text may get changed later by javascript -->
+        {{ theme_switcher_version_match }}  <!-- this text may get changed later by javascript -->
         <span class="caret"></span>
     </button>
     <div id="version_switcher_menu" class="dropdown-menu list-group-flush py-0" aria-labelledby="version_switcher_button">
@@ -10,13 +10,14 @@
 
 <!-- NOTE: this JS must live here (not in our global JS file) because it relies
      on being processed by Jinja before it is run (specifically for replacing
-     variables {{ pagename }}, {{ switcher_json_url }},
-     {{ switcher_url_template }}, and {{ switcher_version_match }}. -->
+     variables {{ pagename }}, {{ theme_switcher_json_url }},
+     {{ theme_switcher_url_template }}, and {{ theme_switcher_version_match }}.
+-->
 
 <script type="text/javascript">
 // Function to construct the target URL from the JSON components
 function buildURL(entry) {
-    var template = "{{ switcher_url_template }}";  // supplied by jinja
+    var template = "{{ theme_switcher_url_template }}";  // supplied by jinja
     template = template.replace("{version}", entry.version);
     return template;
 }
@@ -44,7 +45,7 @@
 
 // Populate the version switcher from the JSON config file
 (function () {
-    $.getJSON("{{ switcher_json_url }}", function(data, textStatus, jqXHR) {
+    $.getJSON("{{ theme_switcher_json_url }}", function(data, textStatus, jqXHR) {
         const currentFilePath = "{{ pagename }}.html";
         // create links to the corresponding page in the other docs versions
         $.each(data, function(index, entry) {
@@ -67,7 +68,7 @@
             $("#version_switcher_menu").append(node);
             // replace dropdown button text with the preferred display name of
             // this version, rather than using sphinx's {{ version }} variable
-            if (entry.version == "{{ switcher_version_match }}") {
+            if (entry.version == "{{ theme_switcher_version_match }}") {
                 node.classList.add("active");
                 $("#version_switcher_button").text(entry.name);
             }
diff --git a/pydata_sphinx_theme/theme.conf b/pydata_sphinx_theme/theme.conf
index c7289afc4..4ad690143 100644
--- a/pydata_sphinx_theme/theme.conf
+++ b/pydata_sphinx_theme/theme.conf
@@ -32,3 +32,6 @@ navbar_center = navbar-nav.html
 navbar_end = navbar-icon-links.html
 footer_items = copyright.html, sphinx-version.html
 page_sidebar_items = page-toc.html, edit-this-page.html
+switcher_json_url =
+switcher_url_template =
+switcher_version_match =

From 191a8472bf96d0f916744135b3337cd90afb2326 Mon Sep 17 00:00:00 2001
From: Daniel McCloy <dan@mccloy.info>
Date: Mon, 1 Nov 2021 15:56:57 -0500
Subject: [PATCH 23/27] fix copy-paste error

---
 docs/user_guide/configuring.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/user_guide/configuring.rst b/docs/user_guide/configuring.rst
index e436dcee8..758afa122 100644
--- a/docs/user_guide/configuring.rst
+++ b/docs/user_guide/configuring.rst
@@ -454,7 +454,7 @@ version switcher in a sidebar. For example, you could define
 
 .. code:: jinja
 
-    {%- include 'homepage.html' -%}
+    {%- include 'version-switcher.html' -%}
     {{ super() }}
 
 to insert a version switcher at the top of the left sidebar, while still

From e683a5042a669200cbe557991d7f0b6a4b400f46 Mon Sep 17 00:00:00 2001
From: Daniel McCloy <dan@mccloy.info>
Date: Mon, 1 Nov 2021 15:57:30 -0500
Subject: [PATCH 24/27] better code comments

---
 pydata_sphinx_theme/_templates/version-switcher.html | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/pydata_sphinx_theme/_templates/version-switcher.html b/pydata_sphinx_theme/_templates/version-switcher.html
index 3d8240616..4c90f644a 100644
--- a/pydata_sphinx_theme/_templates/version-switcher.html
+++ b/pydata_sphinx_theme/_templates/version-switcher.html
@@ -15,7 +15,7 @@
 -->
 
 <script type="text/javascript">
-// Function to construct the target URL from the JSON components
+// Construct the target URL from the JSON components
 function buildURL(entry) {
     var template = "{{ theme_switcher_url_template }}";  // supplied by jinja
     template = template.replace("{version}", entry.version);
@@ -67,7 +67,9 @@
             node.onclick = checkPageExistsAndRedirect;
             $("#version_switcher_menu").append(node);
             // replace dropdown button text with the preferred display name of
-            // this version, rather than using sphinx's {{ version }} variable
+            // this version, rather than using sphinx's {{ version }} variable.
+            // also highlight the dropdown entry for the currently-viewed
+            // version's entry
             if (entry.version == "{{ theme_switcher_version_match }}") {
                 node.classList.add("active");
                 $("#version_switcher_button").text(entry.name);

From 325802892c1f8b06ed8bfa2d03983b6b8340d0d4 Mon Sep 17 00:00:00 2001
From: Daniel McCloy <dan@mccloy.info>
Date: Tue, 2 Nov 2021 13:54:45 -0500
Subject: [PATCH 25/27] make switcher config a single dict

---
 docs/conf.py                                  | 10 ++--
 docs/user_guide/configuring.rst               | 55 +++++++++++--------
 .../_templates/version-switcher.html          | 11 ++--
 pydata_sphinx_theme/theme.conf                |  4 +-
 4 files changed, 43 insertions(+), 37 deletions(-)

diff --git a/docs/conf.py b/docs/conf.py
index cfc6ec9b0..b0db58a80 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -99,10 +99,12 @@
     # "navbar_center": ["navbar-nav", "navbar-version"],  # Just for testing
     "navbar_end": ["version-switcher", "navbar-icon-links"],
     # "footer_items": ["copyright", "sphinx-version", ""]
-    "switcher_json_url": "/_static/switcher.json",
-    # "switcher_json_url": "https://pydata-sphinx-theme.readthedocs.io/en/latest/_static/switcher.json",
-    "switcher_url_template": "https://pydata-sphinx-theme.readthedocs.io/en/v{version}/",
-    "switcher_version_match": version,
+    "switcher": {
+        "json_url": "/_static/switcher.json",
+        # "json_url": "https://pydata-sphinx-theme.readthedocs.io/en/latest/_static/switcher.json",
+        "url_template": "https://pydata-sphinx-theme.readthedocs.io/en/v{version}/",
+        "version_match": version,
+    },
 }
 
 
diff --git a/docs/user_guide/configuring.rst b/docs/user_guide/configuring.rst
index 758afa122..00d544615 100644
--- a/docs/user_guide/configuring.rst
+++ b/docs/user_guide/configuring.rst
@@ -293,15 +293,14 @@ The switcher requires the following configuration steps:
 1. Add a JSON file containing a list of the documentation versions that the
    switcher should show on each page.
 
-2. Add three configuration keys to the ``html_theme_options`` dict in
-   ``conf.py``:
+2. Add a configuration dictionary called ``switcher`` to the
+   ``html_theme_options`` dict in ``conf.py``. ``switcher`` should have 3 keys:
 
-   - ``switcher_json_url``: the persistent location of the JSON file described
-     above.
-   - ``switcher_url_template``: a template string used to generate the correct
-     URLs for the different documentation versions.
-   - ``switcher_version_match``: a string stating the version of the
-     documentation that is currently being browsed.
+   - ``json_url``: the persistent location of the JSON file described above.
+   - ``url_template``: a template string used to generate the correct URLs for
+     the different documentation versions.
+   - ``version_match``: a string stating the version of the documentation that
+     is currently being browsed.
 
 3. Specify where to place the switcher in your page layout. For example, add
    the ``"version-switcher"`` template to one of the layout lists in
@@ -317,9 +316,9 @@ First, write a JSON file stating which versions of your docs will be listed in
 the switcher's dropdown menu. That file should contain a list of entries that
 each have one or two fields:
 
-- ``version``: a version string. This will be inserted into the
-  ``switcher_url_template`` to create the links to other docs versions, and
-  also checked against ``switcher_version_match`` to provide styling to the
+- ``version``: a version string. This will be inserted into
+  ``switcher['url_template']`` to create the links to other docs versions, and
+  also checked against ``switcher['version_match']`` to provide styling to the
   switcher.
 - ``name``: an optional name to display in the switcher dropdown instead of the
   version string (e.g., "latest", "stable", "dev", etc).
@@ -341,12 +340,12 @@ Here is an example JSON file:
         },
     ]
 
-See the discussion of ``switcher_json_url`` (below) for options of where to
+See the discussion of ``switcher['json_url']`` (below) for options of where to
 save the JSON file.
 
 
-Configure ``switcher_json_url``
--------------------------------
+Configure ``switcher['json_url']``
+----------------------------------
 
 The JSON file needs to be at a stable, persistent, fully-resolved URL (i.e.,
 not specified as a path relative to the sphinx root of the current doc build).
@@ -364,7 +363,9 @@ a few different ways:
 
       html_theme_options = {
           ...,
-          "switcher_json_url": "https://mysite.org/en/latest/_static/switcher.json",
+          "switcher": {
+              "json_url": "https://mysite.org/en/latest/_static/switcher.json",
+          }
       }
 
   In this case the JSON is versioned alongside the rest of the docs pages but
@@ -384,23 +385,27 @@ a few different ways:
 
       html_theme_options = {
           ...,
-          "switcher_json_url": "https://mysite.org/switcher.json",
+          "switcher": {
+              "json_url": "https://mysite.org/switcher.json",
+          }
       }
 
 
-Configure ``switcher_url_template``
------------------------------------
+Configure ``switcher['url_template']``
+--------------------------------------
 
 The switcher's links to other versions of your docs are made by combining the
 *version strings* from the JSON file with a *template string* you provide in
-``switcher_url_template``. The template string must contain a placeholder
+``switcher['url_template']``. The template string must contain a placeholder
 ``{version}`` and otherwise be a fully-resolved URL. For example:
 
 .. code:: python
 
     html_theme_options = {
         ...,
-        "switcher_url_template": "https://mysite.org/en/version-{version}/",
+        "switcher": {
+            "url_template": "https://mysite.org/en/version-{version}/",
+        }
     }
 
 The example above will result in a link to
@@ -408,8 +413,8 @@ The example above will result in a link to
 ``"1.0"``.
 
 
-Configure ``switcher_version_match``
-------------------------------------
+Configure ``switcher['version_match']``
+---------------------------------------
 
 This configuration value tells the switcher what docs version is currently
 being viewed, and is used to style the switcher (i.e., to highlight the current
@@ -417,7 +422,7 @@ docs version in the switcher's dropdown menu, and to change the text displayed
 on the switcher button).
 
 Typically you can re-use one of the sphinx variables ``version``
-or ``release`` as the value of ``switcher_version_match``; which one you use
+or ``release`` as the value of ``switcher['version_match']``; which one you use
 depends on how granular your docs versioning is. See
 `the Sphinx "project info" documentation
 <https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information>`__
@@ -428,7 +433,9 @@ for more information). Example:
     version = my_package_name.__version__.replace("dev0", "")  # may differ
     html_theme_options = {
         ...,
-        "switcher_version_match": version,
+        "switcher": {
+            "version_match": version,
+        }
     }
 
 
diff --git a/pydata_sphinx_theme/_templates/version-switcher.html b/pydata_sphinx_theme/_templates/version-switcher.html
index 4c90f644a..10d6b75d5 100644
--- a/pydata_sphinx_theme/_templates/version-switcher.html
+++ b/pydata_sphinx_theme/_templates/version-switcher.html
@@ -1,6 +1,6 @@
 <div class="dropdown" id="version_switcher">
     <button type="button" class="btn btn-primary btn-sm navbar-btn dropdown-toggle" id="version_switcher_button" data-toggle="dropdown">
-        {{ theme_switcher_version_match }}  <!-- this text may get changed later by javascript -->
+        {{ theme_switcher.get('version_match') }}  <!-- this text may get changed later by javascript -->
         <span class="caret"></span>
     </button>
     <div id="version_switcher_menu" class="dropdown-menu list-group-flush py-0" aria-labelledby="version_switcher_button">
@@ -10,14 +10,13 @@
 
 <!-- NOTE: this JS must live here (not in our global JS file) because it relies
      on being processed by Jinja before it is run (specifically for replacing
-     variables {{ pagename }}, {{ theme_switcher_json_url }},
-     {{ theme_switcher_url_template }}, and {{ theme_switcher_version_match }}.
+     variables {{ pagename }} and {{ theme_switcher }}.
 -->
 
 <script type="text/javascript">
 // Construct the target URL from the JSON components
 function buildURL(entry) {
-    var template = "{{ theme_switcher_url_template }}";  // supplied by jinja
+    var template = "{{ theme_switcher.get('url_template') }}";  // supplied by jinja
     template = template.replace("{version}", entry.version);
     return template;
 }
@@ -45,7 +44,7 @@
 
 // Populate the version switcher from the JSON config file
 (function () {
-    $.getJSON("{{ theme_switcher_json_url }}", function(data, textStatus, jqXHR) {
+    $.getJSON("{{ theme_switcher.get('json_url') }}", function(data, textStatus, jqXHR) {
         const currentFilePath = "{{ pagename }}.html";
         // create links to the corresponding page in the other docs versions
         $.each(data, function(index, entry) {
@@ -70,7 +69,7 @@
             // this version, rather than using sphinx's {{ version }} variable.
             // also highlight the dropdown entry for the currently-viewed
             // version's entry
-            if (entry.version == "{{ theme_switcher_version_match }}") {
+            if (entry.version == "{{ theme_switcher.get('version_match') }}") {
                 node.classList.add("active");
                 $("#version_switcher_button").text(entry.name);
             }
diff --git a/pydata_sphinx_theme/theme.conf b/pydata_sphinx_theme/theme.conf
index 4ad690143..5da2839fb 100644
--- a/pydata_sphinx_theme/theme.conf
+++ b/pydata_sphinx_theme/theme.conf
@@ -32,6 +32,4 @@ navbar_center = navbar-nav.html
 navbar_end = navbar-icon-links.html
 footer_items = copyright.html, sphinx-version.html
 page_sidebar_items = page-toc.html, edit-this-page.html
-switcher_json_url =
-switcher_url_template =
-switcher_version_match =
+switcher =

From a010d242ced59c8ca3f614fb3c2e696128a3d622 Mon Sep 17 00:00:00 2001
From: Joris Van den Bossche <jorisvandenbossche@gmail.com>
Date: Fri, 3 Dec 2021 10:31:02 +0100
Subject: [PATCH 26/27] switch url

---
 docs/conf.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/conf.py b/docs/conf.py
index b0db58a80..b7d234e21 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -100,8 +100,8 @@
     "navbar_end": ["version-switcher", "navbar-icon-links"],
     # "footer_items": ["copyright", "sphinx-version", ""]
     "switcher": {
-        "json_url": "/_static/switcher.json",
-        # "json_url": "https://pydata-sphinx-theme.readthedocs.io/en/latest/_static/switcher.json",
+        # "json_url": "/_static/switcher.json",
+        "json_url": "https://pydata-sphinx-theme.readthedocs.io/en/latest/_static/switcher.json",
         "url_template": "https://pydata-sphinx-theme.readthedocs.io/en/v{version}/",
         "version_match": version,
     },

From 865ed64a3f592a5f9045ddd5b66d4520922c6653 Mon Sep 17 00:00:00 2001
From: Joris Van den Bossche <jorisvandenbossche@gmail.com>
Date: Fri, 3 Dec 2021 10:33:28 +0100
Subject: [PATCH 27/27] prettier json

---
 docs/_static/switcher.json | 98 +++++++++++++++++++-------------------
 1 file changed, 49 insertions(+), 49 deletions(-)

diff --git a/docs/_static/switcher.json b/docs/_static/switcher.json
index e23807a55..90a58e18b 100644
--- a/docs/_static/switcher.json
+++ b/docs/_static/switcher.json
@@ -1,51 +1,51 @@
 [
-    {
-        "name": "v0.7.1 (stable)",
-        "version": "0.7.1"
-    },
-    {
-        "version": "0.7.0"
-    },
-    {
-        "version": "0.6.3"
-    },
-    {
-        "version": "0.6.2"
-    },
-    {
-        "version": "0.6.1"
-    },
-    {
-        "version": "0.6.0"
-    },
-    {
-        "version": "0.5.2"
-    },
-    {
-        "version": "0.5.1"
-    },
-    {
-        "version": "0.5.0"
-    },
-    {
-        "version": "0.4.3"
-    },
-    {
-        "version": "0.4.2"
-    },
-    {
-        "version": "0.4.1"
-    },
-    {
-        "version": "0.4.0"
-    },
-    {
-        "version": "0.3.2"
-    },
-    {
-        "version": "0.3.1"
-    },
-    {
-        "version": "0.3.0"
-    }
+  {
+    "name": "v0.7.1 (stable)",
+    "version": "0.7.1"
+  },
+  {
+    "version": "0.7.0"
+  },
+  {
+    "version": "0.6.3"
+  },
+  {
+    "version": "0.6.2"
+  },
+  {
+    "version": "0.6.1"
+  },
+  {
+    "version": "0.6.0"
+  },
+  {
+    "version": "0.5.2"
+  },
+  {
+    "version": "0.5.1"
+  },
+  {
+    "version": "0.5.0"
+  },
+  {
+    "version": "0.4.3"
+  },
+  {
+    "version": "0.4.2"
+  },
+  {
+    "version": "0.4.1"
+  },
+  {
+    "version": "0.4.0"
+  },
+  {
+    "version": "0.3.2"
+  },
+  {
+    "version": "0.3.1"
+  },
+  {
+    "version": "0.3.0"
+  }
 ]