enable pydata_sphinx_theme version banner

[mosc9575]

This PR activates the version banner from pydata-sphinx-theme, removes the old version banner (js and css). The switcher.json in also adapted to silence a warning.

• issues: fixes activate pydata-sphinx-theme version banner #13824

After running make clean html serve on my local machine this is the result.

For the older versions

• https://docs.bokeh.org/en/3.2.2/
• https://docs.bokeh.org/en/3.3.0/
• https://docs.bokeh.org/en/3.4.0/

it is suggested to add the code below to all existing html pages to enable the banner.

<div style="background-color: rgb(248, 215, 218); color: rgb(114, 28, 36); text-align: center;">
  <div>
    <div>This is documentation for <strong>an old version</strong>.
      <a href="https://docs.bokeh.org/en/latest/index.html" style="background-color: rgb(220, 53, 69); color: rgb(255, 255, 255); margin: 1rem; padding: 0.375rem 0.75rem; border-radius: 4px; display: inline-block; text-align: center;">Switch to stable version</a>
    </div>
  </div>
</div>

I don't know how to do this.

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 93.15%. Comparing base (e61219b) to head (29d0e3a).
Report is 40 commits behind head on branch-3.5.

Additional details and impacted files

@@              Coverage Diff               @@
##           branch-3.5   #13901      +/-   ##
==============================================
+ Coverage       91.57%   93.15%   +1.58%     
==============================================
  Files             326      282      -44     
  Lines           20737    20031     -706     
==============================================
- Hits            18990    18660     -330     
+ Misses           1747     1371     -376     

[bryevdv]

it is suggested to add the code below to all existing html pages to enable the banner.

Unfortunately that would be an enormous ordeal and undertaking. Also potentially costly, as well, as the pages are stored on s3 and we would have to exfiltrate many tens of thousands to update. We would also have to issue very large Cloudfront cache invalidations. I think we will just have to live with old pages being as they are until they are retired from the switcher list.

Edit: Unless you mean just the top-level index.html pages and not anything else. Then sure, we can update a handful of pages manually.

[mosc9575]

Edit: Unless you mean just the top-level index.html pages and not anything else. Then sure, we can update a handful of pages manually.

I haven't thought about updating only the start page but I think that would be a good compromise. It is not sufficent to show the version banner on all pages but it is much better than nothing and the start page should have this information.

[bryevdv]

@bokeh/core after this is merged it would be advised to test a dev build release.

[bryevdv]

Thanks @mosc9575 FYI I am about to be "out of the office" for a few weeks, maybe make a separate issue regarding updating the old index.html pages manually so it doesn't get lost in the shuffle. If you happen to be able to update all the pages locally and store them off somewhere or in a zip file, etc., that I can access, that will definitely speed things up when I get back.

[mosc9575]

@bryevdv Below is a zip folder with the adapted index pages. I adapted th current latest version, too. I hope this will work for you.

bokeh_start_pages.zip