Update version switcher to set 2.0 as preferred version

[melissawm]

Also adds a 'preferred' keyword to the stable version, which is used to select which pages receive a version warning banner from the PyData Sphinx Theme.

This should be merged after the 2.0 documentation is published, so that "stable" points to the right pages.

[melissawm]

@charris can you merge this one?

[seberg]

Well, I didn't expect a silly whitespace fix to cause merge conflicts!? Will look into it, or do you just want to force push @melissawm and then we put it in without things?

[melissawm]

I'll update 👍

[melissawm]

Should be good to go - thanks @seberg

[seberg]

Thanks! I guess it might now only be the preferred thing anymore, but that is good anyway.

Is it correct that it shows "Choose version" for the stable one?

[melissawm]

Hmm this may be pydata/pydata-sphinx-theme#1829? Let me check

[melissawm]

Looking at the console for the stable docs I see

Uncaught ReferenceError: $ is not defined
    <anonymous> https://numpy.org/doc/_static/versionwarning.js:13

Not sure if this is interfering with the PyData version switcher. I'll try to debug

[mattip]

stackoverflow says the script is missing a jquery reference, something like

<script language="JavaScript" type="text/javascript" src="/js/jquery-1.2.6.min.js"></script>

And indeed, when I compare the 2.0 directory to the other versions, I see it is missing a _static/jquery.js

[melissawm]

Not sure if that fixes the switcher but let's try

[mattip]

Something else is wrong, I don't see a call to load the script from the HTML. I will try rebuilding the docs.

[melissawm]

Let me know if you need help, I'll be around.

[mattip]

Something changed with the format of the version string in versions.json, so they no longer match. The generated HTML all needs to be changed

     <script>
         DOCUMENTATION_OPTIONS.theme_version = '0.15.3';
         DOCUMENTATION_OPTIONS.theme_switcher_json_url = 'https://numpy.org/doc/_static/versions.json';
+        DOCUMENTATION_OPTIONS.theme_switcher_version_match = 'doc/2.0';
-        DOCUMENTATION_OPTIONS.theme_switcher_version_match = '2.0';
         DOCUMENTATION_OPTIONS.show_version_warning_banner = false;
         </script>

or the versions.json needs to be changed

     {
         "name": "2.0 (stable)",
-        "version": "doc/2.0",
+        "version": "2.0",
         "url": "https://numpy.org/doc/stable/",
         "preferred": true
     },

[melissawm]

Are you rebuilding @mattip or would you like me to do it?